@kienmatu/inkos-core 0.1.0

package/dist/agent/forecast-tools.js

@@ -0,0 +1,153 @@
+import { Type } from "@mariozechner/pi-ai";
+import { createNarrativeForecast, getNarrativeForecast, selectNarrativeBranch, } from "../forecast/runner.js";
+import { assertSafeBookId } from "../utils/book-id.js";
+function textResult(text, details) {
+    return { content: [{ type: "text", text }], details: details };
+}
+function resolveForecastBookId(toolName, paramsBookId, activeBookId) {
+    const resolvedBookId = paramsBookId ?? activeBookId ?? undefined;
+    if (!resolvedBookId) {
+        throw new Error(`${toolName} requires bookId when there is no active book.`);
+    }
+    const safeBookId = assertSafeBookId(resolvedBookId, `${toolName}.bookId`);
+    if (paramsBookId && activeBookId && safeBookId !== activeBookId) {
+        throw new Error(`${toolName}.bookId must match the active book.`);
+    }
+    return safeBookId;
+}
+function describeBranch(branch) {
+    return `${branch.branchId} "${branch.title}" — intent fit ${branch.intentAlignment.score}/100, `
+        + `${branch.risks.length} risk(s), premise: ${branch.premise}`;
+}
+function describeForecast(forecast, stale) {
+    return [
+        `Forecast ${forecast.forecastId} (book ${forecast.bookId}) — status: ${stale ? "stale" : forecast.status}.`,
+        `Divergence: ${forecast.divergence}`,
+        `Base chapter: ${forecast.baseChapter}, horizon: ~${forecast.horizon} chapters.`,
+        ...(stale
+            ? ["WARNING: canonical chapters or state changed after this forecast was generated; regenerate before relying on it."]
+            : []),
+        "Branches:",
+        ...forecast.branches.map((branch) => `- ${describeBranch(branch)}`),
+    ];
+}
+// ---------------------------------------------------------------------------
+// create_narrative_forecast
+// ---------------------------------------------------------------------------
+const ForecastCreateParams = Type.Object({
+    bookId: Type.Optional(Type.String({
+        description: "All forecast tools: book id to forecast. Defaults to the active book; must match it when both are present.",
+    })),
+    divergence: Type.String({
+        description: "Required divergence point: the open decision or fork the author wants to compare, e.g. 主角接受还是拒绝对手的合作提议. Include the competing options when known.",
+    }),
+    branchCount: Type.Optional(Type.Number({
+        description: "create_narrative_forecast only: number of mutually isolated candidate branches, integer 2-5. Default 3.",
+    })),
+    horizon: Type.Optional(Type.Number({
+        description: "create_narrative_forecast only: how many future chapters each branch should cover, integer 1-10. Default 5.",
+    })),
+});
+export function createNarrativeForecastCreateTool(pipeline, activeBookId, projectRoot) {
+    return {
+        name: "create_narrative_forecast",
+        description: "Create a non-canonical narrative forecast for the current long-form book: reads the canonical context "
+            + "(structured state, author intent, current focus, outline, hooks, recent summaries, characters) and projects "
+            + "2-5 mutually isolated candidate futures from a divergence point. Writes forecast.json and comparison.md under "
+            + "story/runtime/narrative-forecasts/<forecastId>/ and never modifies canonical chapters or state.",
+        label: "Narrative Forecast",
+        parameters: ForecastCreateParams,
+        async execute(_toolCallId, params, _signal, onUpdate) {
+            const bookId = resolveForecastBookId("create_narrative_forecast", params.bookId, activeBookId);
+            const baseRuntime = pipeline.createAgentContext("forecast", bookId);
+            const result = await createNarrativeForecast({
+                projectRoot,
+                bookId,
+                divergence: params.divergence,
+                branchCount: params.branchCount,
+                horizon: params.horizon,
+                runtime: _signal ? { ...baseRuntime, signal: _signal } : baseRuntime,
+                onProgress: (message) => onUpdate?.(textResult(message)),
+            });
+            return textResult([
+                `Narrative forecast ${result.forecast.forecastId} created with ${result.forecast.branches.length} isolated branches.`,
+                ...result.forecast.branches.map((branch) => `- ${describeBranch(branch)}`),
+                `Comparison: ${result.comparisonPath}`,
+                `Forecast data: ${result.forecastJsonPath}`,
+                "These branches are non-canonical planning material. Use select_narrative_branch with the forecastId and a branchId "
+                    + "to write selected-branch-plan.md, or get_narrative_forecast to re-check staleness later.",
+            ].join("\n"), { kind: "narrative_forecast_created", forecastId: result.forecast.forecastId, ...result });
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// get_narrative_forecast
+// ---------------------------------------------------------------------------
+const ForecastGetParams = Type.Object({
+    bookId: Type.Optional(Type.String({
+        description: "All forecast tools: book id. Defaults to the active book; must match it when both are present.",
+    })),
+    forecastId: Type.String({
+        description: "get_narrative_forecast only: forecast id returned by create_narrative_forecast, e.g. fc-20260715-080910.",
+    }),
+});
+export function createNarrativeForecastGetTool(activeBookId, projectRoot) {
+    return {
+        name: "get_narrative_forecast",
+        description: "Read an existing narrative forecast, re-check it against the current canonical context, and mark it stale when "
+            + "canonical chapters, structured state, or control documents changed after it was generated. Read-only apart from "
+            + "persisting the stale marker inside the forecast's own directory.",
+        label: "Get Narrative Forecast",
+        parameters: ForecastGetParams,
+        async execute(_toolCallId, params) {
+            const bookId = resolveForecastBookId("get_narrative_forecast", params.bookId, activeBookId);
+            const result = await getNarrativeForecast({ projectRoot, bookId, forecastId: params.forecastId });
+            return textResult([
+                ...describeForecast(result.forecast, result.stale),
+                `Comparison: ${result.comparisonPath}`,
+            ].join("\n"), { kind: "narrative_forecast", stale: result.stale, forecast: result.forecast });
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// select_narrative_branch
+// ---------------------------------------------------------------------------
+const ForecastSelectParams = Type.Object({
+    bookId: Type.Optional(Type.String({
+        description: "All forecast tools: book id. Defaults to the active book; must match it when both are present.",
+    })),
+    forecastId: Type.String({
+        description: "select_narrative_branch only: forecast id containing the branch to select.",
+    }),
+    branchId: Type.String({
+        description: "select_narrative_branch only: branch id to select, e.g. branch-2. Must exist in the forecast.",
+    }),
+});
+export function createNarrativeForecastSelectTool(activeBookId, projectRoot) {
+    return {
+        name: "select_narrative_branch",
+        description: "Select one branch of a narrative forecast. Writes only selected-branch-plan.md inside the forecast directory — "
+            + "it does NOT apply the plan to the outline, chapter intents, or canonical state; that is a separate, "
+            + "user-confirmed operation.",
+        label: "Select Narrative Branch",
+        parameters: ForecastSelectParams,
+        async execute(_toolCallId, params) {
+            const bookId = resolveForecastBookId("select_narrative_branch", params.bookId, activeBookId);
+            const result = await selectNarrativeBranch({
+                projectRoot,
+                bookId,
+                forecastId: params.forecastId,
+                branchId: params.branchId,
+            });
+            return textResult([
+                `Selected ${result.branch.branchId} "${result.branch.title}" from forecast ${result.forecast.forecastId}.`,
+                ...(result.stale
+                    ? ["WARNING: this forecast is stale — canon changed after it was generated. The plan includes a stale warning; verify before applying."]
+                    : []),
+                `Plan written: ${result.planPath}`,
+                "Canonical files were not modified. Applying this plan to the outline or chapter intents requires explicit user confirmation.",
+            ].join("\n"), { kind: "narrative_branch_selected", stale: result.stale, planPath: result.planPath, branchId: result.branch.branchId });
+        },
+    };
+}
+//# sourceMappingURL=forecast-tools.js.map

package/dist/agent/forecast-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forecast-tools.js","sourceRoot":"","sources":["../../src/agent/forecast-tools.ts"],"names":[],"mappings":"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"}

package/dist/agent/index.d.ts

@@ -0,0 +1,8 @@
+export { buildAgentSystemPrompt } from "./agent-system-prompt.js";
+export { createSubAgentTool, createReadTool, createWriteTruthFileTool, createRenameEntityTool, createPatchChapterTextTool, createEditTool, createWriteFileTool, createShortFictionRunTool, createScriptCreationTool, createStoryboardCreationTool, createInteractiveFilmCreationTool, createTranslationCreateTool, createFanficBookTool, createContinuationImportTool, createSpinoffBookTool, createImitationBookTool, createResearchWebTool, createIngestMaterialTool, createManageBookReferenceTool, createImportChaptersTool, createGenerateCoverTool, createPlayStartTool, createPlayReviseTool, createPlayStepTool, createGrepTool, createLsTool, } from "./agent-tools.js";
+export { abortAgentSession, runAgentSession, evictAgentCache, type AgentSessionAttachment, type AgentSessionConfig, type AgentSessionResult, } from "./agent-session.js";
+export { createBookContextTransform, createInteractiveFilmContextTransform, } from "./context-transform.js";
+export { createUseSkillTool, type CreateUseSkillToolOptions } from "./skill-tool.js";
+export { createSetWorldAnchorTool, createUpsertCharactersTool, createAddVariableTool, createDefineEndingTool, createFillNodeTool, createReviseNodeTool, createGenerateNodeImageTool, createDraftStructureTool, createConnectChoiceTool, createRemoveNodeTool, filmLLMDepsFromClient, buildFilmAuthoringToolNames, createFilmAuthoringTools, type FilmLLMDeps, } from "./film-authoring-tools.js";
+export { createNarrativeForecastCreateTool, createNarrativeForecastGetTool, createNarrativeForecastSelectTool, } from "./forecast-tools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,iCAAiC,EACjC,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,0BAA0B,EAC1B,qCAAqC,GACtC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,WAAW,GACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,iCAAiC,GAClC,MAAM,qBAAqB,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,8 @@
+export { buildAgentSystemPrompt } from "./agent-system-prompt.js";
+export { createSubAgentTool, createReadTool, createWriteTruthFileTool, createRenameEntityTool, createPatchChapterTextTool, createEditTool, createWriteFileTool, createShortFictionRunTool, createScriptCreationTool, createStoryboardCreationTool, createInteractiveFilmCreationTool, createTranslationCreateTool, createFanficBookTool, createContinuationImportTool, createSpinoffBookTool, createImitationBookTool, createResearchWebTool, createIngestMaterialTool, createManageBookReferenceTool, createImportChaptersTool, createGenerateCoverTool, createPlayStartTool, createPlayReviseTool, createPlayStepTool, createGrepTool, createLsTool, } from "./agent-tools.js";
+export { abortAgentSession, runAgentSession, evictAgentCache, } from "./agent-session.js";
+export { createBookContextTransform, createInteractiveFilmContextTransform, } from "./context-transform.js";
+export { createUseSkillTool } from "./skill-tool.js";
+export { createSetWorldAnchorTool, createUpsertCharactersTool, createAddVariableTool, createDefineEndingTool, createFillNodeTool, createReviseNodeTool, createGenerateNodeImageTool, createDraftStructureTool, createConnectChoiceTool, createRemoveNodeTool, filmLLMDepsFromClient, buildFilmAuthoringToolNames, createFilmAuthoringTools, } from "./film-authoring-tools.js";
+export { createNarrativeForecastCreateTool, createNarrativeForecastGetTool, createNarrativeForecastSelectTool, } from "./forecast-tools.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,iCAAiC,EACjC,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,GAIhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,0BAA0B,EAC1B,qCAAqC,GACtC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAkC,MAAM,iBAAiB,CAAC;AACrF,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iCAAiC,EACjC,8BAA8B,EAC9B,iCAAiC,GAClC,MAAM,qBAAqB,CAAC"}

package/dist/agent/llm-stub.d.ts

@@ -0,0 +1,19 @@
+import type { AssistantMessageEventStream, Model, Api } from "@mariozechner/pi-ai";
+import type { LLMMessage, LLMResponse } from "../llm/provider.js";
+export declare function isLlmStubEnabled(): boolean;
+/**
+ * Returns a deterministic AssistantMessageEventStream that either emits a
+ * propose_action toolCall (when the latest user text mentions "结构/骨架/structure"
+ * and propose_action hasn't run yet) or a plain "好的。" text reply.
+ *
+ * Mirrors localAssistantStopStream in agent-session.ts exactly — same
+ * createAssistantMessageEventStream() + queueMicrotask pattern.
+ */
+export declare function stubAgentStream(model: Model<Api>, context: unknown): AssistantMessageEventStream;
+/**
+ * Deterministic replacement for the chatCompletion network call.
+ * Returns STRUCTURE_JSON when the prompt mentions structure/骨架/nodes,
+ * otherwise a single node JSON.
+ */
+export declare function stubChatCompletion(messages: ReadonlyArray<LLMMessage>, _model: string): LLMResponse;
+//# sourceMappingURL=llm-stub.d.ts.map

package/dist/agent/llm-stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-stub.d.ts","sourceRoot":"","sources":["../../src/agent/llm-stub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,2BAA2B,EAC3B,KAAK,EACL,GAAG,EACJ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAElE,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAmDD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,2BAA2B,CA4ChG;AAkCD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EACnC,MAAM,EAAE,MAAM,GACb,WAAW,CAOb"}

package/dist/agent/llm-stub.js

@@ -0,0 +1,134 @@
+import { createAssistantMessageEventStream } from "@mariozechner/pi-ai";
+export function isLlmStubEnabled() {
+    return Boolean(process.env.INKOS_AGENT_LLM_STUB);
+}
+// Mirrors EMPTY_USAGE in agent-session.ts exactly.
+const EMPTY_USAGE = {
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    totalTokens: 0,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+};
+function lastUserText(context) {
+    const msgs = context.messages ?? [];
+    for (let i = msgs.length - 1; i >= 0; i--) {
+        const m = msgs[i];
+        if (m.role === "user") {
+            return typeof m.content === "string" ? m.content : JSON.stringify(m.content);
+        }
+    }
+    return "";
+}
+function alreadyProposed(context) {
+    return (context.messages ?? []).some((m) => {
+        // Agent format (non-openai-completions): role="toolResult" with toolName
+        if (m.role === "toolResult" && m.toolName === "propose_action") {
+            return true;
+        }
+        // LLM format (openai-completions): assistant message with toolCall content
+        if (m.role === "assistant" && Array.isArray(m.content)) {
+            if (m.content.some((c) => c.type === "toolCall" && c.name === "propose_action")) {
+                return true;
+            }
+        }
+        // LLM format (openai-completions folded): tool result folded into user message string
+        if (m.role === "user" && typeof m.content === "string") {
+            if (/- propose_action \(/.test(m.content)) {
+                return true;
+            }
+        }
+        return false;
+    });
+}
+/**
+ * Returns a deterministic AssistantMessageEventStream that either emits a
+ * propose_action toolCall (when the latest user text mentions "结构/骨架/structure"
+ * and propose_action hasn't run yet) or a plain "好的。" text reply.
+ *
+ * Mirrors localAssistantStopStream in agent-session.ts exactly — same
+ * createAssistantMessageEventStream() + queueMicrotask pattern.
+ */
+export function stubAgentStream(model, context) {
+    const stream = createAssistantMessageEventStream();
+    const text = lastUserText(context);
+    const proposed = alreadyProposed(context);
+    const wantStructure = !proposed && /结构|骨架|structure/i.test(text);
+    const content = wantStructure
+        ? [
+            {
+                type: "toolCall",
+                id: "stub-draft",
+                name: "propose_action",
+                arguments: {
+                    action: "draft_structure",
+                    title: "搭建结构",
+                    summary: "确认后生成三幕骨架",
+                    instruction: "搭建一个三幕分支结构",
+                    draftStructure: { instruction: "三幕分支结构" },
+                },
+            },
+        ]
+        : [{ type: "text", text: "好的。" }];
+    const stopReason = wantStructure ? "toolUse" : "stop";
+    const message = {
+        role: "assistant",
+        content: content,
+        api: model.api,
+        provider: model.provider,
+        model: model.id,
+        usage: EMPTY_USAGE,
+        stopReason,
+        timestamp: Date.now(),
+    };
+    queueMicrotask(() => {
+        stream.push({ type: "done", reason: stopReason, message });
+        stream.end(message);
+    });
+    return stream;
+}
+const STRUCTURE_JSON = JSON.stringify({
+    nodes: [
+        {
+            id: "s",
+            type: "start",
+            title: "开场",
+            sceneDesc: "宫门前",
+            choices: [{ id: "c1", text: "查账", targetNodeId: "b" }],
+        },
+        {
+            id: "b",
+            type: "branch",
+            title: "抉择",
+            sceneDesc: "账房",
+            choices: [
+                { id: "c2", text: "公开", targetNodeId: "e1" },
+                { id: "c3", text: "隐瞒", targetNodeId: "e2" },
+            ],
+        },
+        { id: "e1", type: "ending", title: "真相", choices: [] },
+        { id: "e2", type: "ending", title: "沉沦", choices: [] },
+    ],
+});
+const NODE_JSON = JSON.stringify({
+    type: "branch",
+    title: "新场景",
+    sceneDesc: "夜色",
+    dialogue: [{ speaker: "阿梅", text: "账不能错", emotion: "坚定" }],
+    choices: [],
+});
+/**
+ * Deterministic replacement for the chatCompletion network call.
+ * Returns STRUCTURE_JSON when the prompt mentions structure/骨架/nodes,
+ * otherwise a single node JSON.
+ */
+export function stubChatCompletion(messages, _model) {
+    const joined = messages.map((m) => m.content).join("\n");
+    const content = /骨架|nodes|结构/i.test(joined) ? STRUCTURE_JSON : NODE_JSON;
+    return {
+        content,
+        usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+    };
+}
+//# sourceMappingURL=llm-stub.js.map

package/dist/agent/llm-stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-stub.js","sourceRoot":"","sources":["../../src/agent/llm-stub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AASxE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACnD,CAAC;AAED,mDAAmD;AACnD,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC;IACd,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;CACrE,CAAC;AAEF,SAAS,YAAY,CAAC,OAAiE;IACrF,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CACtB,OAAoF;IAEpF,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACzC,yEAAyE;QACzE,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAK,CAA2B,CAAC,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YAC1F,OAAO,IAAI,CAAC;QACd,CAAC;QACD,2EAA2E;QAC3E,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,IACG,CAAC,CAAC,OAAkD,CAAC,IAAI,CACxD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAC5D,EACD,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,sFAAsF;QACtF,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvD,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAiB,CAAC,EAAE,CAAC;gBACpD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB,EAAE,OAAgB;IACjE,MAAM,MAAM,GAAG,iCAAiC,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAmE,CAAC,CAAC;IAC/F,MAAM,QAAQ,GAAG,eAAe,CAC9B,OAAsF,CACvF,CAAC;IACF,MAAM,aAAa,GAAG,CAAC,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjE,MAAM,OAAO,GAAG,aAAa;QAC3B,CAAC,CAAC;YACE;gBACE,IAAI,EAAE,UAAmB;gBACzB,EAAE,EAAE,YAAY;gBAChB,IAAI,EAAE,gBAAgB;gBACtB,SAAS,EAAE;oBACT,MAAM,EAAE,iBAAiB;oBACzB,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,WAAW;oBACpB,WAAW,EAAE,YAAY;oBACzB,cAAc,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE;iBAC1C;aACF;SACF;QACH,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE7C,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAE,SAAmB,CAAC,CAAC,CAAE,MAAgB,CAAC;IAE5E,MAAM,OAAO,GAAqB;QAChC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAsC;QAC/C,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,KAAK,EAAE,WAAwC;QAC/C,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,cAAc,CAAC,GAAG,EAAE;QAClB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;IACpC,KAAK,EAAE;QACL;YACE,EAAE,EAAE,GAAG;YACP,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC;SACvD;QACD;YACE,EAAE,EAAE,GAAG;YACP,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAI;YACX,SAAS,EAAE,IAAI;YACf,OAAO,EAAE;gBACP,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;gBAC5C,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE;aAC7C;SACF;QACD,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QACtD,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;KACvD;CACF,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/B,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1D,OAAO,EAAE,EAAE;CACZ,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAmC,EACnC,MAAc;IAEd,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,OAAO;QACL,OAAO;QACP,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;KAChE,CAAC;AACJ,CAAC"}

package/dist/agent/pi-stream.d.ts

@@ -0,0 +1,8 @@
+import type { Api, AssistantMessageEventStream, Context, Model, SimpleStreamOptions } from "@mariozechner/pi-ai";
+/**
+ * The single Pi transport boundary used by both conversational and worker
+ * agents. Pi keeps native tool calls; InkOS adds context guards, trajectory
+ * headers, cancellation, and stream deadlines around the request.
+ */
+export declare function guardedPiStream<TApi extends Api>(model: Model<TApi>, context: Context, options?: SimpleStreamOptions): AssistantMessageEventStream;
+//# sourceMappingURL=pi-stream.d.ts.map

package/dist/agent/pi-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-stream.d.ts","sourceRoot":"","sources":["../../src/agent/pi-stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,GAAG,EACH,2BAA2B,EAC3B,OAAO,EACP,KAAK,EACL,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAW7B;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAS,GAAG,EAC9C,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,2BAA2B,CAyB7B"}

package/dist/agent/pi-stream.js

@@ -0,0 +1,31 @@
+import { streamSimple } from "@mariozechner/pi-ai";
+import { assertWithinContextWindow, estimatePiContextTokens, guardAssistantMessageStream, } from "../llm/provider.js";
+import { agentTrajectoryHeaders, beginAgentModelCall, } from "../llm/agent-trajectory.js";
+/**
+ * The single Pi transport boundary used by both conversational and worker
+ * agents. Pi keeps native tool calls; InkOS adds context guards, trajectory
+ * headers, cancellation, and stream deadlines around the request.
+ */
+export function guardedPiStream(model, context, options) {
+    const reservedOutputTokens = Number.isFinite(options?.maxTokens)
+        ? options.maxTokens
+        : Number.isFinite(model.maxTokens)
+            ? model.maxTokens
+            : 4096;
+    assertWithinContextWindow({
+        piModel: model,
+        model: model.id,
+        estimatedInputTokens: estimatePiContextTokens(context),
+        reservedOutputTokens,
+    });
+    const modelCall = beginAgentModelCall();
+    const traceHeaders = agentTrajectoryHeaders(model.baseUrl, modelCall, 1, {
+        effort: String(options?.reasoning ?? (model.reasoning ? "enabled" : "disabled")),
+    });
+    return guardAssistantMessageStream(model, (signal) => streamSimple(model, context, {
+        ...options,
+        headers: { ...(options?.headers ?? {}), ...traceHeaders },
+        signal,
+    }), options?.signal);
+}
+//# sourceMappingURL=pi-stream.js.map

package/dist/agent/pi-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-stream.js","sourceRoot":"","sources":["../../src/agent/pi-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQnD,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAkB,EAClB,OAAgB,EAChB,OAA6B;IAE7B,MAAM,oBAAoB,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;QAC9D,CAAC,CAAC,OAAQ,CAAC,SAAU;QACrB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;YAChC,CAAC,CAAC,KAAK,CAAC,SAAS;YACjB,CAAC,CAAC,IAAI,CAAC;IACX,yBAAyB,CAAC;QACxB,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,oBAAoB,EAAE,uBAAuB,CAAC,OAAO,CAAC;QACtD,oBAAoB;KACrB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE;QACvE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;KACjF,CAAC,CAAC;IACH,OAAO,2BAA2B,CAChC,KAAK,EACL,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE;QACvC,GAAG,OAAO;QACV,OAAO,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,YAAY,EAAE;QACzD,MAAM;KACP,CAAC,EACF,OAAO,EAAE,MAAM,CAChB,CAAC;AACJ,CAAC"}

package/dist/agent/skill-tool.d.ts

@@ -0,0 +1,42 @@
+import type { AgentMessage, AgentTool } from "@mariozechner/pi-agent-core";
+import type { AgentSkill, SkillRegistry } from "../skills/index.js";
+declare const UseSkillParams: import("@sinclair/typebox").TObject<{
+    skillId: import("@sinclair/typebox").TString;
+    resourcePath: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    query: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export interface CreateUseSkillToolOptions {
+    readonly registry: SkillRegistry;
+    readonly disabledSkillIds?: ReadonlyArray<string>;
+    readonly onActivate?: (activation: ActivatedSkillGuidance) => void;
+}
+export interface ActivatedSkillResource {
+    readonly path: string;
+    readonly heading?: string;
+    readonly body: string;
+    readonly charStart: number;
+    readonly charEnd: number;
+}
+export interface ActivatedSkillGuidance {
+    readonly skill: AgentSkill;
+    readonly resources: ReadonlyArray<ActivatedSkillResource>;
+}
+export declare function createUseSkillTool(options: CreateUseSkillToolOptions): AgentTool<typeof UseSkillParams>;
+export declare function retrieveSkillResources(skillId: string, baseDir: string, query: string, limit?: number): Promise<{
+    path: string;
+    heading: string;
+    body: string;
+    charStart: number;
+    charEnd: number;
+    score: number;
+}[]>;
+/**
+ * Production workers receive the skill itself from the host. Resolve the
+ * relevant static reference sections from the actual task text just before a
+ * model call, instead of copying large craft prompts into every pipeline.
+ */
+export declare function hydrateActivatedSkillGuidance(activations: ReadonlyArray<ActivatedSkillGuidance> | undefined, query: string): Promise<ReadonlyArray<ActivatedSkillGuidance> | undefined>;
+export declare function assistantInvokesSkill(message: AgentMessage): boolean;
+export declare function sanitizeSkillTurnMessage(message: AgentMessage, stripThinking: boolean): AgentMessage;
+export {};
+//# sourceMappingURL=skill-tool.d.ts.map

package/dist/agent/skill-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tool.d.ts","sourceRoot":"","sources":["../../src/agent/skill-tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAmB,MAAM,6BAA6B,CAAC;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYpE,QAAA,MAAM,cAAc;;;;EAUlB,CAAC;AAIH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;CAC3D;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,SAAS,CAAC,OAAO,cAAc,CAAC,CA+GlC;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,SAAI;;;;;;;KA2CV;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,SAAS,EAC9D,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,sBAAsB,CAAC,GAAG,SAAS,CAAC,CAoB5D;AA4DD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAepE;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,OAAO,GACrB,YAAY,CAsBd"}