@kienmatu/inkos-core 0.1.0

package/dist/interactive-film/tool-schemas.js

@@ -0,0 +1,125 @@
+import { Type } from "@sinclair/typebox";
+const VarValueToolSchema = Type.Union([Type.Number(), Type.String(), Type.Boolean()]);
+const ConditionToolSchema = Type.Object({
+    var: Type.String({ minLength: 1 }),
+    op: Type.Union([
+        Type.Literal(">="),
+        Type.Literal("<="),
+        Type.Literal(">"),
+        Type.Literal("<"),
+        Type.Literal("=="),
+        Type.Literal("!="),
+    ]),
+    value: VarValueToolSchema,
+}, { additionalProperties: false });
+const EffectToolSchema = Type.Object({
+    var: Type.String({ minLength: 1 }),
+    op: Type.Union([Type.Literal("set"), Type.Literal("add"), Type.Literal("sub")]),
+    value: VarValueToolSchema,
+}, { additionalProperties: false });
+const ChoiceToolSchema = Type.Object({
+    id: Type.String({ minLength: 1 }),
+    text: Type.String(),
+    targetNodeId: Type.String({ minLength: 1 }),
+    condition: Type.Optional(ConditionToolSchema),
+    effects: Type.Optional(Type.Array(EffectToolSchema)),
+    weight: Type.Optional(Type.Union([
+        Type.Literal("light"),
+        Type.Literal("heavy"),
+        Type.Literal("critical"),
+    ])),
+}, { additionalProperties: false });
+const DialogueLineToolSchema = Type.Object({
+    speaker: Type.String(),
+    text: Type.String(),
+    emotion: Type.Optional(Type.String()),
+}, { additionalProperties: false });
+const ImageSlotToolSchema = Type.Object({
+    prompt: Type.Optional(Type.String()),
+    assetRef: Type.Optional(Type.String()),
+}, { additionalProperties: false });
+const NodeTypeToolSchema = Type.Union([
+    Type.Literal("start"),
+    Type.Literal("normal"),
+    Type.Literal("branch"),
+    Type.Literal("merge"),
+    Type.Literal("ending"),
+    Type.Literal("explore"),
+]);
+const StoryNodeFields = {
+    title: Type.Optional(Type.String()),
+    type: NodeTypeToolSchema,
+    sceneDesc: Type.Optional(Type.String()),
+    dialogue: Type.Optional(Type.Array(DialogueLineToolSchema)),
+    choices: Type.Optional(Type.Array(ChoiceToolSchema)),
+    imageSlot: Type.Optional(ImageSlotToolSchema),
+    act: Type.Optional(Type.String()),
+    position: Type.Optional(Type.Object({
+        x: Type.Number(),
+        y: Type.Number(),
+    }, { additionalProperties: false })),
+};
+export const StoryNodeContentToolSchema = Type.Object(StoryNodeFields, {
+    additionalProperties: false,
+});
+export const StoryNodeToolSchema = Type.Object({
+    id: Type.String({ minLength: 1 }),
+    ...StoryNodeFields,
+}, { additionalProperties: false });
+const WorldAnchorToolSchema = Type.Object({
+    storyCore: Type.Optional(Type.String()),
+    theme: Type.Optional(Type.String()),
+    genre: Type.Optional(Type.String()),
+    worldRules: Type.Optional(Type.String()),
+    durationMinutes: Type.Optional(Type.Number({ minimum: 0 })),
+}, { additionalProperties: false });
+const CharacterToolSchema = Type.Object({
+    id: Type.String({ minLength: 1 }),
+    name: Type.String(),
+    role: Type.Optional(Type.Union([
+        Type.Literal("protagonist"),
+        Type.Literal("antagonist"),
+        Type.Literal("support"),
+        Type.Literal("other"),
+    ])),
+    motivation: Type.Optional(Type.String()),
+    voiceProfile: Type.Optional(Type.Object({
+        speakingRhythm: Type.Optional(Type.String()),
+        vocabulary: Type.Optional(Type.String()),
+        sampleLines: Type.Optional(Type.Array(Type.String())),
+    }, { additionalProperties: false })),
+}, { additionalProperties: false });
+const VariableToolSchema = Type.Object({
+    name: Type.String({ minLength: 1 }),
+    type: Type.Union([
+        Type.Literal("flag"),
+        Type.Literal("counter"),
+        Type.Literal("relationship"),
+        Type.Literal("item"),
+    ]),
+    default: VarValueToolSchema,
+    desc: Type.Optional(Type.String()),
+}, { additionalProperties: false });
+const EndingToolSchema = Type.Object({
+    id: Type.String({ minLength: 1 }),
+    nodeId: Type.String({ minLength: 1 }),
+    title: Type.String(),
+    type: Type.Union([
+        Type.Literal("good"),
+        Type.Literal("bad"),
+        Type.Literal("neutral"),
+        Type.Literal("secret"),
+    ]),
+    description: Type.Optional(Type.String()),
+}, { additionalProperties: false });
+export const StoryGraphContentToolSchema = Type.Object({
+    worldAnchor: Type.Optional(WorldAnchorToolSchema),
+    characters: Type.Optional(Type.Array(CharacterToolSchema)),
+    variables: Type.Optional(Type.Array(VariableToolSchema)),
+    nodes: Type.Array(StoryNodeToolSchema, { minItems: 5 }),
+    endings: Type.Array(EndingToolSchema, { minItems: 2 }),
+}, { additionalProperties: false });
+export const StoryStructureToolSchema = Type.Object({
+    nodes: Type.Array(StoryNodeToolSchema, { minItems: 1 }),
+}, { additionalProperties: false });
+//# sourceMappingURL=tool-schemas.js.map

package/dist/interactive-film/tool-schemas.js.map

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

package/dist/interactive-film/validation.d.ts

@@ -0,0 +1,14 @@
+import type { StoryGraph } from "./graph-schema.js";
+export interface ValidationIssue {
+    readonly code: "DEAD_END" | "BROKEN_LINK" | "UNREACHABLE" | "NO_PATH_TO_ENDING" | "VARIABLE_UNWRITTEN" | "VARIABLE_UNUSED" | "ENDING_VARIETY" | "IMAGE_MISSING" | "GATED_UNREACHABLE" | "ENDING_UNREACHABLE" | "ILLUSORY_BRANCH" | "LINEAR_GRAPH" | "ISOLATED_NODE" | "LONG_LINEAR_CHAIN";
+    readonly level: "error" | "warning" | "info";
+    readonly message: string;
+    readonly nodeIds: readonly string[];
+}
+export interface ValidationReport {
+    readonly ok: boolean;
+    readonly issues: readonly ValidationIssue[];
+}
+export declare function validateStoryGraph(graph: StoryGraph): ValidationReport;
+export declare function reviewStoryGraph(graph: StoryGraph): ValidationReport;
+//# sourceMappingURL=validation.d.ts.map

package/dist/interactive-film/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/interactive-film/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,mBAAmB,CAAC;AAG/D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,eAAe,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,iBAAiB,GAAG,cAAc,GAAG,eAAe,GAAG,mBAAmB,CAAC;IAC1R,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAMD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CA+EtE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,gBAAgB,CAwJpE"}

package/dist/interactive-film/validation.js

@@ -0,0 +1,292 @@
+import { enumerateRuntimePaths } from "./paths.js";
+function label(node) {
+    return node.title || node.id;
+}
+export function validateStoryGraph(graph) {
+    const issues = [];
+    const ids = new Set(graph.nodes.map((n) => n.id));
+    const nodeMap = new Map(graph.nodes.map((n) => [n.id, n]));
+    // BROKEN_LINK
+    for (const node of graph.nodes) {
+        for (const c of node.choices) {
+            if (!ids.has(c.targetNodeId)) {
+                issues.push({
+                    code: "BROKEN_LINK",
+                    level: "error",
+                    message: `节点「${label(node)}」的选项「${c.text}」指向不存在的节点 ${c.targetNodeId}`,
+                    nodeIds: [node.id],
+                });
+            }
+        }
+    }
+    // DEAD_END：非结局节点没有任何指向存在节点的出口
+    for (const node of graph.nodes) {
+        if (node.type === "ending")
+            continue;
+        const hasExit = node.choices.some((c) => ids.has(c.targetNodeId));
+        if (!hasExit) {
+            issues.push({
+                code: "DEAD_END",
+                level: "error",
+                message: `节点「${label(node)}」是死路：没有任何有效出口`,
+                nodeIds: [node.id],
+            });
+        }
+    }
+    // 可达性 BFS
+    const start = graph.nodes.find((n) => n.type === "start") ?? graph.nodes[0];
+    const reachable = new Set();
+    if (start) {
+        const queue = [start.id];
+        while (queue.length > 0) {
+            const cur = queue.shift();
+            if (reachable.has(cur))
+                continue;
+            reachable.add(cur);
+            const n = nodeMap.get(cur);
+            if (!n)
+                continue;
+            for (const c of n.choices) {
+                if (ids.has(c.targetNodeId) && !reachable.has(c.targetNodeId))
+                    queue.push(c.targetNodeId);
+            }
+        }
+    }
+    // UNREACHABLE
+    for (const node of graph.nodes) {
+        if (graph.nodes.length > 1 && !reachable.has(node.id)) {
+            issues.push({
+                code: "UNREACHABLE",
+                level: "warning",
+                message: `节点「${label(node)}」从开场无法到达`,
+                nodeIds: [node.id],
+            });
+        }
+    }
+    // NO_PATH_TO_ENDING
+    if (start) {
+        let canEnd = false;
+        for (const id of reachable) {
+            if (nodeMap.get(id)?.type === "ending") {
+                canEnd = true;
+                break;
+            }
+        }
+        if (!canEnd) {
+            issues.push({
+                code: "NO_PATH_TO_ENDING",
+                level: "error",
+                message: `从开场节点「${label(start)}」出发无法到达任何结局`,
+                nodeIds: [start.id],
+            });
+        }
+    }
+    return { ok: issues.every((i) => i.level !== "error"), issues };
+}
+export function reviewStoryGraph(graph) {
+    const issues = [...validateStoryGraph(graph).issues];
+    const reads = new Set();
+    const writes = new Set();
+    for (const node of graph.nodes) {
+        for (const choice of node.choices) {
+            if (choice.condition)
+                reads.add(choice.condition.var);
+            for (const effect of choice.effects)
+                writes.add(effect.var);
+        }
+    }
+    for (const v of reads) {
+        if (!writes.has(v)) {
+            issues.push({
+                code: "VARIABLE_UNWRITTEN",
+                level: "warning",
+                message: `变量「${v}」被选项条件读取，但没有任何选项写入它——该条件门除默认值外永远不会改变`,
+                nodeIds: [],
+            });
+        }
+    }
+    for (const v of graph.variables.map((vv) => vv.name)) {
+        if (!reads.has(v) && !writes.has(v)) {
+            issues.push({
+                code: "VARIABLE_UNUSED",
+                level: "info",
+                message: `变量「${v}」声明了但没有任何选项写入、也没有任何条件读取它——这是个多余的声明`,
+                nodeIds: [],
+            });
+        }
+    }
+    if (graph.endings.length >= 2) {
+        const types = new Set(graph.endings.map((e) => e.type));
+        if (types.size === 1) {
+            issues.push({
+                code: "ENDING_VARIETY",
+                level: "info",
+                message: `${graph.endings.length} 个结局都是同一类型（${[...types][0]}），重玩价值低——考虑设计不同基调的结局`,
+                nodeIds: graph.endings.map((e) => e.nodeId),
+            });
+        }
+    }
+    for (const node of graph.nodes) {
+        if (node.type !== "ending" && !node.imageSlot?.assetRef) {
+            issues.push({
+                code: "IMAGE_MISSING",
+                level: "info",
+                message: `节点「${node.title || node.id}」还没有配图`,
+                nodeIds: [node.id],
+            });
+        }
+    }
+    // --- P6 new rules ---
+    const { paths, truncated } = enumerateRuntimePaths(graph);
+    const reachedNodeIds = new Set();
+    for (const p of paths) {
+        for (const id of p.nodeIds)
+            reachedNodeIds.add(id);
+    }
+    const edgeReachable = computeEdgeReachable(graph);
+    // GATED_UNREACHABLE and ENDING_UNREACHABLE rely on a complete path enumeration.
+    // When enumeration is truncated (>200 paths), the reached-node set is incomplete,
+    // so asserting unreachability would be unsound. Skip both loops in that case.
+    if (!truncated) {
+        // GATED_UNREACHABLE: edge-reachable but not runtime-reachable (endings are reported by ENDING_UNREACHABLE)
+        for (const node of graph.nodes) {
+            if (node.type === "start")
+                continue;
+            if (node.type === "ending")
+                continue;
+            if (edgeReachable.has(node.id) && !reachedNodeIds.has(node.id)) {
+                issues.push({
+                    code: "GATED_UNREACHABLE",
+                    level: "warning",
+                    message: `节点「${node.title || node.id}」连边可达，但没有任何满足变量条件的路径能到达——它被一个永远不成立的条件挡住了`,
+                    nodeIds: [node.id],
+                });
+            }
+        }
+        // ENDING_UNREACHABLE: check by ending.nodeId presence in reached nodes (handles multiple endings sharing the same node)
+        for (const ending of graph.endings) {
+            if (!reachedNodeIds.has(ending.nodeId)) {
+                issues.push({
+                    code: "ENDING_UNREACHABLE",
+                    level: "warning",
+                    message: `结局「${ending.title}」没有任何真实路径能到达`,
+                    nodeIds: [ending.nodeId],
+                });
+            }
+        }
+    }
+    // LINEAR_GRAPH: only meaningful when there are intermediate normal nodes (a pure start→ending stub is not a drama)
+    const hasBranch = graph.nodes.some((n) => n.choices.length >= 2);
+    const hasNormalNode = graph.nodes.some((n) => n.type === "normal");
+    if (graph.nodes.some((n) => n.type === "start") && graph.endings.length > 0 && hasNormalNode && !hasBranch) {
+        issues.push({
+            code: "LINEAR_GRAPH",
+            level: "info",
+            message: `整个故事没有任何分叉选择——更像线性剧本而非互动影游，考虑加入分支`,
+            nodeIds: [],
+        });
+    }
+    // ISOLATED_NODE (endings are reported by ENDING_UNREACHABLE, not as generic isolated nodes)
+    // Skip nodes that already carry an UNREACHABLE issue from validateStoryGraph — that report
+    // is more informative (BFS-based, not just topology), so the duplicate is noise.
+    const incoming = new Set();
+    for (const n of graph.nodes)
+        for (const c of n.choices)
+            incoming.add(c.targetNodeId);
+    for (const node of graph.nodes) {
+        if (node.type !== "start" && node.type !== "ending" && !incoming.has(node.id)) {
+            if (issues.some((i) => i.code === "UNREACHABLE" && i.nodeIds.includes(node.id)))
+                continue;
+            issues.push({
+                code: "ISOLATED_NODE",
+                level: "info",
+                message: `节点「${node.title || node.id}」没有任何选项指向它——孤立节点`,
+                nodeIds: [node.id],
+            });
+        }
+    }
+    // ILLUSORY_BRANCH: a branch where all choices share the same target and have no effects
+    for (const node of graph.nodes) {
+        if (node.choices.length >= 2) {
+            const targets = new Set(node.choices.map((c) => c.targetNodeId));
+            const allNoEffect = node.choices.every((c) => (c.effects?.length ?? 0) === 0);
+            if (targets.size === 1 && allNoEffect) {
+                issues.push({
+                    code: "ILLUSORY_BRANCH",
+                    level: "info",
+                    message: `节点「${node.title || node.id}」的所有选项都通向同一个节点且没有不同效果——这是个假分支`,
+                    nodeIds: [node.id],
+                });
+            }
+        }
+    }
+    // LONG_LINEAR_CHAIN: >=5 consecutive single-choice normal nodes
+    const CHAIN_THRESHOLD = 5;
+    const longChainHeads = findLongLinearChainHeads(graph, CHAIN_THRESHOLD);
+    for (const id of longChainHeads) {
+        issues.push({
+            code: "LONG_LINEAR_CHAIN",
+            level: "info",
+            message: `从节点「${id}」开始有一段较长的无分支直链（≥${CHAIN_THRESHOLD} 个单选项节点）——节奏可能偏拖，考虑插入分支或事件`,
+            nodeIds: [id],
+        });
+    }
+    return { ok: issues.every((i) => i.level !== "error"), issues };
+}
+function computeEdgeReachable(graph) {
+    const start = graph.nodes.find((n) => n.type === "start");
+    const reachable = new Set();
+    if (!start)
+        return reachable;
+    const nodeById = new Map(graph.nodes.map((n) => [n.id, n]));
+    const queue = [start.id];
+    while (queue.length > 0) {
+        const cur = queue.shift();
+        if (reachable.has(cur))
+            continue;
+        reachable.add(cur);
+        const node = nodeById.get(cur);
+        if (!node)
+            continue;
+        for (const choice of node.choices) {
+            if (!reachable.has(choice.targetNodeId))
+                queue.push(choice.targetNodeId);
+        }
+    }
+    return reachable;
+}
+function findLongLinearChainHeads(graph, threshold) {
+    const nodeById = new Map(graph.nodes.map((n) => [n.id, n]));
+    const isChainNode = (id) => {
+        const n = nodeById.get(id);
+        return n !== undefined && n.type === "normal" && n.choices.length === 1;
+    };
+    const incomingIsChainNode = new Map();
+    for (const n of graph.nodes) {
+        for (const c of n.choices) {
+            if (isChainNode(n.id)) {
+                incomingIsChainNode.set(c.targetNodeId, true);
+            }
+        }
+    }
+    const heads = [];
+    for (const node of graph.nodes) {
+        if (!isChainNode(node.id))
+            continue;
+        if (incomingIsChainNode.get(node.id))
+            continue;
+        let length = 0;
+        let cur = node.id;
+        const visited = new Set();
+        while (cur !== undefined && isChainNode(cur) && !visited.has(cur)) {
+            visited.add(cur);
+            length++;
+            const chainNode = nodeById.get(cur);
+            cur = chainNode.choices[0].targetNodeId;
+        }
+        if (length >= threshold)
+            heads.push(node.id);
+    }
+    return heads;
+}
+//# sourceMappingURL=validation.js.map

package/dist/interactive-film/validation.js.map

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

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

@@ -0,0 +1,27 @@
+export type AgentTrajectoryRole = "main" | "subagent" | "workflow";
+export interface AgentTrajectoryScopeInput {
+    readonly conversationId: string;
+    readonly runId: string;
+    readonly agentRole: AgentTrajectoryRole;
+    readonly parentToolCallId?: string;
+}
+export interface AgentModelCallTrace {
+    readonly conversationId: string;
+    readonly runId: string;
+    readonly modelCallId: string;
+    readonly agentRole: AgentTrajectoryRole;
+    readonly piTurnIndex: number;
+    readonly parentToolCallId?: string;
+}
+export interface ThinkingTrace {
+    readonly effort: string;
+    readonly budgetTokens?: number;
+}
+export declare function opaqueConversationId(sessionId: string): string;
+export declare function runWithAgentTrajectory<T>(input: AgentTrajectoryScopeInput, task: () => T): T;
+export declare function runWithAgentTrajectoryRole<T>(agentRole: AgentTrajectoryRole, task: () => T, parentToolCallId?: string): T;
+export declare function runAsWorkflowTrajectory<T>(task: () => T): T;
+export declare function beginAgentModelCall(): AgentModelCallTrace | undefined;
+export declare function isKkaiapiEndpoint(baseUrl: string | undefined): boolean;
+export declare function agentTrajectoryHeaders(baseUrl: string | undefined, trace: AgentModelCallTrace | undefined, clientAttempt: number, thinking: ThinkingTrace): Record<string, string>;
+//# sourceMappingURL=agent-trajectory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-trajectory.d.ts","sourceRoot":"","sources":["../../src/llm/agent-trajectory.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAQD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,yBAAyB,EAChC,IAAI,EAAE,MAAM,CAAC,GACZ,CAAC,CAEH;AAED,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,SAAS,EAAE,mBAAmB,EAC9B,IAAI,EAAE,MAAM,CAAC,EACb,gBAAgB,CAAC,EAAE,MAAM,GACxB,CAAC,CAQH;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAI3D;AAED,wBAAgB,mBAAmB,IAAI,mBAAmB,GAAG,SAAS,CAcrE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAQtE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,mBAAmB,GAAG,SAAS,EACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,aAAa,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBxB"}

package/dist/llm/agent-trajectory.js

@@ -0,0 +1,74 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createHash, randomUUID } from "node:crypto";
+const trajectoryStorage = new AsyncLocalStorage();
+export function opaqueConversationId(sessionId) {
+    return `inkos-${createHash("sha256").update(sessionId).digest("hex").slice(0, 32)}`;
+}
+export function runWithAgentTrajectory(input, task) {
+    return trajectoryStorage.run({ ...input, counter: { piTurn: 0 } }, task);
+}
+export function runWithAgentTrajectoryRole(agentRole, task, parentToolCallId) {
+    const current = trajectoryStorage.getStore();
+    if (!current)
+        return task();
+    return trajectoryStorage.run({
+        ...current,
+        agentRole,
+        ...(parentToolCallId ? { parentToolCallId } : {}),
+    }, task);
+}
+export function runAsWorkflowTrajectory(task) {
+    const current = trajectoryStorage.getStore();
+    if (!current || current.agentRole !== "main")
+        return task();
+    return runWithAgentTrajectoryRole("workflow", task);
+}
+export function beginAgentModelCall() {
+    const current = trajectoryStorage.getStore();
+    if (!current)
+        return undefined;
+    if (current.agentRole === "main") {
+        current.counter.piTurn += 1;
+    }
+    return {
+        conversationId: current.conversationId,
+        runId: current.runId,
+        modelCallId: randomUUID(),
+        agentRole: current.agentRole,
+        piTurnIndex: Math.max(current.counter.piTurn, 1),
+        ...(current.parentToolCallId ? { parentToolCallId: current.parentToolCallId } : {}),
+    };
+}
+export function isKkaiapiEndpoint(baseUrl) {
+    if (!baseUrl)
+        return false;
+    try {
+        const hostname = new URL(baseUrl).hostname.toLowerCase();
+        return hostname === "kkaiapi.com" || hostname.endsWith(".kkaiapi.com");
+    }
+    catch {
+        return false;
+    }
+}
+export function agentTrajectoryHeaders(baseUrl, trace, clientAttempt, thinking) {
+    if (!trace || !isKkaiapiEndpoint(baseUrl))
+        return {};
+    return {
+        "X-InkOS-Trace-Version": "1",
+        "X-InkOS-Scaffold": "pi-inkos",
+        "X-InkOS-Conversation-ID": trace.conversationId,
+        "X-InkOS-Run-ID": trace.runId,
+        "X-InkOS-Model-Call-ID": trace.modelCallId,
+        "X-InkOS-Agent-Role": trace.agentRole,
+        "X-InkOS-Pi-Turn-Index": String(trace.piTurnIndex),
+        "X-InkOS-Client-Attempt": String(clientAttempt),
+        "X-InkOS-Thinking-Effort": thinking.effort,
+        ...(thinking.budgetTokens !== undefined
+            ? { "X-InkOS-Thinking-Budget-Tokens": String(thinking.budgetTokens) }
+            : {}),
+        ...(trace.parentToolCallId
+            ? { "X-InkOS-Parent-Tool-Call-ID": trace.parentToolCallId }
+            : {}),
+    };
+}
+//# sourceMappingURL=agent-trajectory.js.map

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

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

package/dist/llm/config-migration.d.ts

@@ -0,0 +1,5 @@
+export interface MigrationResult {
+    migrated: boolean;
+}
+export declare function migrateConfig(projectRoot: string): Promise<MigrationResult>;
+//# sourceMappingURL=config-migration.d.ts.map

package/dist/llm/config-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-migration.d.ts","sourceRoot":"","sources":["../../src/llm/config-migration.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAgDjF"}

package/dist/llm/config-migration.js

@@ -0,0 +1,51 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { saveSecrets, loadSecrets } from "./secrets.js";
+import { guessServiceFromBaseUrl } from "./service-presets.js";
+export async function migrateConfig(projectRoot) {
+    const configPath = join(projectRoot, "inkos.json");
+    let raw;
+    try {
+        raw = await readFile(configPath, "utf-8");
+    }
+    catch {
+        return { migrated: false };
+    }
+    const config = JSON.parse(raw);
+    const llm = config.llm;
+    if (!llm)
+        return { migrated: false };
+    // Already new format
+    if (Array.isArray(llm.services))
+        return { migrated: false };
+    // Old format: llm.provider, llm.model, llm.baseUrl, llm.apiKey
+    const { provider, model, baseUrl, apiKey, ...restLlm } = llm;
+    if (!model && !provider)
+        return { migrated: false };
+    // Determine service from baseUrl
+    const guessedService = baseUrl ? guessServiceFromBaseUrl(baseUrl) : null;
+    const service = guessedService ?? "custom";
+    // Build new service entry
+    const serviceEntry = { service };
+    if (service === "custom") {
+        serviceEntry.name = "Custom";
+        if (baseUrl)
+            serviceEntry.baseUrl = baseUrl;
+    }
+    // Write new config (no apiKey)
+    config.llm = {
+        ...restLlm,
+        services: [serviceEntry],
+        defaultModel: model,
+    };
+    await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+    // Move apiKey to secrets
+    if (apiKey) {
+        const secrets = await loadSecrets(projectRoot);
+        const secretKey = service === "custom" ? `custom:${serviceEntry.name}` : service;
+        secrets.services[secretKey] = { apiKey };
+        await saveSecrets(projectRoot, secrets);
+    }
+    return { migrated: true };
+}
+//# sourceMappingURL=config-migration.js.map

package/dist/llm/config-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-migration.js","sourceRoot":"","sources":["../../src/llm/config-migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAM/D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACnD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAErC,qBAAqB;IACrB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAE5D,+DAA+D;IAC/D,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,GAAG,CAAC;IAC7D,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAEpD,iCAAiC;IACjC,MAAM,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,MAAM,OAAO,GAAG,cAAc,IAAI,QAAQ,CAAC;IAE3C,0BAA0B;IAC1B,MAAM,YAAY,GAA2B,EAAE,OAAO,EAAE,CAAC;IACzD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,YAAY,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC7B,IAAI,OAAO;YAAE,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC;IAC9C,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,GAAG,GAAG;QACX,GAAG,OAAO;QACV,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,YAAY,EAAE,KAAK;KACpB,CAAC;IACF,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAEtE,yBAAyB;IACzB,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACjF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QACzC,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC"}