@neutrome/lilsdk 0.6.2 → 0.6.3

package/README.md

@@ -20,7 +20,8 @@ small — SDK contracts only — and each subpath owns one concern:
 - `@neutrome/lilsdk/tools`: `createToolsExecutor` tool-call loop
 - `@neutrome/lilsdk/managed`: `createCapabilitiesExecutor`,
   `createAttachmentToTextExecutor`, and
-  `collapsedReasoner(reasoner, summarizer, options)` for safe reasoning updates
+  `createCollapsedReasoner(reasoner, summarizer, options)` for safe reasoning
+  updates
 - `@neutrome/lilsdk/stream`: `observeExecutionStream`, `streamStage`, and
   `writeThinking`
 - `@neutrome/lilsdk/primitives`: structural program helpers — `walk`, `map`,

package/etc/api/managed.api.md

@@ -39,11 +39,6 @@ export type CapabilitiesExecutorOptions = {
     skipPrefixes?: readonly string[];
 };
 
-// Warning: (ae-forgotten-export) The symbol "Executor" needs to be exported by the entry point index.d.ts
-//
-// @public
-export function collapsedReasoner(reasoner: ExecutorInput, summarizer: ExecutorInput, options?: CollapsedReasonerOptions): Executor;
-
 // @public
 export type CollapsedReasonerOptions = {
     prompt?: string;
@@ -52,12 +47,17 @@ export type CollapsedReasonerOptions = {
     forcedInterval?: number;
 };
 
+// Warning: (ae-forgotten-export) The symbol "Executor" needs to be exported by the entry point index.d.ts
+//
 // @public
 export function createAttachmentToTextExecutor(inner: ExecutorInput, rules: readonly AttachmentReaderRule[], options?: AttachmentToTextOptions): Executor;
 
 // @public
 export function createCapabilitiesExecutor(inner: ExecutorInput, options?: CapabilitiesExecutorOptions): Executor;
 
+// @public
+export function createCollapsedReasoner(reasoner: ExecutorInput, summarizer: ExecutorInput, options?: CollapsedReasonerOptions): Executor;
+
 // @public
 type ExecutionEvent = {
     kind: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neutrome/lilsdk",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",

package/src/managed/collapsed-reasoner.ts

@@ -20,7 +20,7 @@ const DEFAULT_PROMPT =
 const DEFAULT_FORCED_PROMPT =
   "Give a concise user-facing progress update based only on the reasoning below. Return an empty response when no update is useful.";
 
-/** Options accepted by {@link collapsedReasoner}. */
+/** Options accepted by {@link createCollapsedReasoner}. */
 export type CollapsedReasonerOptions = {
   /** Prompt used for periodic progress updates. */
   prompt?: string;
@@ -40,7 +40,7 @@ export type CollapsedReasonerOptions = {
  * @param summarizer - Executor or model id that summarizes unexposed reasoning.
  * @param options - Prompts and wall-clock update cadence.
  */
-export function collapsedReasoner(
+export function createCollapsedReasoner(
   reasoner: ExecutorInput,
   summarizer: ExecutorInput,
   options: CollapsedReasonerOptions = {},

package/src/managed/index.ts

@@ -1,6 +1,6 @@
 export { createCapabilitiesExecutor } from "./capabilities.ts";
 export type { CapabilitiesExecutorOptions } from "./capabilities.ts";
-export { collapsedReasoner } from "./collapsed-reasoner.ts";
+export { createCollapsedReasoner } from "./collapsed-reasoner.ts";
 export type { CollapsedReasonerOptions } from "./collapsed-reasoner.ts";
 export { createAttachmentToTextExecutor } from "./attachment-to-text.ts";
 export type {

package/test/collapsed-reasoner.test.ts

@@ -11,13 +11,13 @@ import {
   type Program,
 } from "@neutrome/lil-engine";
 import { describe, expect, it, vi } from "vitest";
-import { collapsedReasoner } from "../src/managed/collapsed-reasoner.ts";
+import { createCollapsedReasoner } from "../src/managed/collapsed-reasoner.ts";
 import type { Executor, ExecutorContext } from "../src/types.ts";
 
-describe("collapsedReasoner", () => {
+describe("createCollapsedReasoner", () => {
   it("replaces completed raw reasoning with a forced summary", async () => {
     let summaryRequest: Program | undefined;
-    const executor = collapsedReasoner(
+    const executor = createCollapsedReasoner(
       fromExecute(async () => withThinking("answer", "private reasoning")),
       fromExecute(async (request) => {
         summaryRequest = request;
@@ -33,7 +33,7 @@ describe("collapsedReasoner", () => {
   });
 
   it("suppresses raw stream deltas, preserves visible chunks, and flushes before the end", async () => {
-    const executor = collapsedReasoner(
+    const executor = createCollapsedReasoner(
       streaming(async function* () {
         yield delta.start();
         yield delta.thinking("private reasoning");
@@ -57,7 +57,7 @@ describe("collapsedReasoner", () => {
   it("uses elapsed time for periodic summaries and gives a forced tick priority", async () => {
     vi.useFakeTimers();
     let release: (() => void) | undefined;
-    const executor = collapsedReasoner(
+    const executor = createCollapsedReasoner(
       streaming(async function* () {
         yield delta.thinking("first");
         await new Promise<void>((resolve) => {
@@ -84,12 +84,12 @@ describe("collapsedReasoner", () => {
   });
 
   it("validates its timing options and never emits blank summaries", async () => {
-    expect(() => collapsedReasoner("reasoner", "summarizer", { interval: 0 })).toThrow(RangeError);
+    expect(() => createCollapsedReasoner("reasoner", "summarizer", { interval: 0 })).toThrow(RangeError);
     expect(() =>
-      collapsedReasoner("reasoner", "summarizer", { interval: 10, forcedInterval: 9 }),
+      createCollapsedReasoner("reasoner", "summarizer", { interval: 10, forcedInterval: 9 }),
     ).toThrow(RangeError);
 
-    const executor = collapsedReasoner(
+    const executor = createCollapsedReasoner(
       streaming(async function* () {
         yield delta.thinking("private");
         yield delta.end();
@@ -103,7 +103,7 @@ describe("collapsedReasoner", () => {
 
   it("propagates source and summarizer failures without exposing reasoning", async () => {
     const sourceFailure = new Error("source failed");
-    const brokenSource = collapsedReasoner(
+    const brokenSource = createCollapsedReasoner(
       streaming(async function* () {
         throw sourceFailure;
       }),
@@ -112,7 +112,7 @@ describe("collapsedReasoner", () => {
     await expect(collect(brokenSource.stream(createProgram(), context()))).rejects.toBe(sourceFailure);
 
     const summaryFailure = new Error("summary failed");
-    const brokenSummary = collapsedReasoner(
+    const brokenSummary = createCollapsedReasoner(
       streaming(async function* () {
         yield delta.thinking("private");
         yield delta.end();