@neutrome/lilsdk

High-level TypeScript SDK for transport-neutral model authoring on top of @neutrome/lil-engine.

import type { Executor } from "@neutrome/lilsdk";
import { fallback, retry } from "@neutrome/lilsdk/loops";
import { createToolsExecutor } from "@neutrome/lilsdk/tools";
import { observeExecutionStream, writeThinking } from "@neutrome/lilsdk/stream";
import { prependSystemPrompt } from "@neutrome/lil-engine";

Every symbol has exactly one import path. The root export is intentionally small — SDK contracts only — and each subpath owns one concern:

• root: Executor, ExecutorContext, ExecutorInput, Tool, ProgramTransform, RuntimeContext, Cache, ExecutionEvent, OutputSink, and createExecutionEvent
• @neutrome/lilsdk/loops: retry, fallback, and createGoalExecutor
• @neutrome/lilsdk/tools: createToolsExecutor tool-call loop
• @neutrome/lilsdk/managed: createCapabilitiesExecutor, createAttachmentToTextExecutor, and createCollapsedReasoner(reasoner, summarizer, options) for safe reasoning updates
• @neutrome/lilsdk/stream: observeExecutionStream, streamStage, and writeThinking
• @neutrome/lilsdk/primitives: structural program helpers — walk, map, filter, reduce, has, find, indexOf, all, and any

Executor factories are named create*Executor, except retry and fallback, which read better as bare verbs.

Building programs — messages, tool calls, attachments, streaming chunks — is @neutrome/lil-engine's job, so prependSystemPrompt and friends are imported from there. HTTP routing, provider credentials, target resolution and provider JSON conversion live in @neutrome/open-ai-router and @neutrome/lil-engine.