@kvman/kvcoder 0.1.0

package/dist/store/collections.d.ts

@@ -0,0 +1,471 @@
+import type { Store, Transaction } from '@kvman/sdk';
+/** The collections through the store's Promise calls. */
+export declare function records(store: Store): {
+    sessions: import("@kvman/sdk").Collection<{
+        title: string;
+        autoTitle: boolean;
+        status: "idle" | "running" | "waiting";
+        parentId: string | null;
+        worker: {
+            name: string;
+            instructions: string;
+        } | null;
+        model: string | null;
+        thinking: "off" | "minimal" | "low" | "medium" | "high";
+        stepJobId: string | null;
+        turnId: string | null;
+        endedTurns: number;
+        nextSeq: number;
+        usage: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+            cost: number;
+        };
+        durationMs: number;
+        checks: {
+            name: string;
+            passed: boolean;
+        }[] | null;
+        connectors: string[] | null;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    messages: import("@kvman/sdk").Collection<{
+        sessionId: string;
+        turnId: string | null;
+        seq: number;
+        block: number;
+        kind: "user" | "assistant" | "toolResult" | "notice" | "note" | "summary";
+        source: {
+            kind: "user";
+        } | {
+            kind: "extension";
+            name: string;
+        } | {
+            kind: "subagent";
+            sessionId: string;
+        } | {
+            kind: "job";
+            jobId: string;
+        } | null;
+        content: Record<string, import("zod").JSONType>;
+        fileIds: string[] | null;
+        fileNames: string[] | null;
+        model: string | null;
+        usage: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+            cost: number;
+        } | null;
+        durationMs: number | null;
+        createdAt: string;
+    }>;
+    queued: import("@kvman/sdk").Collection<{
+        sessionId: string;
+        source: {
+            kind: "user";
+        } | {
+            kind: "extension";
+            name: string;
+        } | {
+            kind: "subagent";
+            sessionId: string;
+        } | {
+            kind: "job";
+            jobId: string;
+        };
+        text: string;
+        fileIds: string[] | null;
+        fileNames: string[] | null;
+        createdAt: string;
+    }>;
+    turns: import("@kvman/sdk").Collection<{
+        sessionId: string;
+        startedAt: string;
+        endedAt: string | null;
+        durationMs: number;
+        steps: number;
+        lost: number;
+        usage: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+            cost: number;
+        };
+        outcome: "done" | "cancelled" | "failed" | "interrupted" | "maxSteps" | null;
+        calls: {
+            toolCallId: string;
+            toolName: string;
+        }[];
+        pending: {
+            toolCallId: string;
+            kind: "subagent" | "worker" | "question" | "approval";
+            questionId: string | null;
+            question: import("zod").JSONType;
+            childSessionId: string | null;
+            runId: string | null;
+        }[];
+        results: {
+            toolCallId: string;
+            text: string;
+            details: import("zod").JSONType;
+            isError: boolean;
+            run: {
+                description: string;
+                connector: string;
+                command: string;
+                payload: Record<string, import("zod").JSONType>;
+            } | {
+                command: string;
+                timeoutMs: number;
+            } | null;
+        }[];
+    }>;
+    questions: import("@kvman/sdk").Collection<{
+        sessionId: string;
+        rootSessionId: string;
+        turnId: string;
+        toolCallId: string;
+        kind: "text" | "approval" | "choice" | "confirm";
+        question: Record<string, import("zod").JSONType>;
+    }>;
+    artifacts: import("@kvman/sdk").Collection<{
+        sessionId: string;
+        artifactId: string;
+        title: string;
+        format: "markdown" | "html" | "url";
+        content: string;
+        version: number;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    background: import("@kvman/sdk").Collection<{
+        sessionId: string;
+        ref: string;
+        kind: "connector" | "subagent";
+        call: string;
+        startedAt: string;
+    }>;
+    runs: import("@kvman/sdk").Collection<{
+        sessionId: string;
+        toolCallId: string | null;
+        worker: string;
+        kind: "opencode" | "pi" | "claude";
+        call: string;
+        command: string;
+        args: string[];
+        timeoutMs: number;
+        jobId: string | null;
+        status: "running" | "cancelled" | "failed" | "interrupted" | "succeeded";
+        startedAt: string;
+        endedAt: string | null;
+        exitCode: number | null;
+        output: string | null;
+    }>;
+    sections: import("@kvman/sdk").Collection<{
+        owner: string;
+        sectionId: string;
+        title: string;
+        order: number;
+        content: string;
+        sessionId: string | null;
+    }>;
+    globalSections: import("@kvman/sdk").Collection<{
+        owner: string;
+        sectionId: string;
+        title: string;
+        order: number;
+        content: string;
+        sessionId: string | null;
+    }>;
+    processes: import("@kvman/sdk").Collection<{
+        workspaceId: string;
+        sessionId: string;
+        title: string;
+        call: string;
+        startedAt: string;
+        reported: boolean;
+        endedAt?: string;
+        end?: "interrupted" | "exited" | "agent" | "person";
+        exitCode?: number | null;
+        signal?: string | null;
+        starting?: boolean;
+    }>;
+    connectors: import("@kvman/sdk").Collection<{
+        owner: string;
+        name: string;
+        description: string;
+        kind: "commands" | "binary";
+        commands: {
+            name: string;
+            command: string;
+            examples: {
+                description: string;
+                input: import("zod").JSONType;
+            }[];
+            asks: boolean;
+        }[] | null;
+        binary: {
+            check: string;
+            install: string | null;
+            help: string | null;
+        } | null;
+    }>;
+    handlers: import("@kvman/sdk").Collection<{
+        owner: string;
+        point: "kvcoder.session.created" | "kvcoder.session.deleted" | "kvcoder.session.forked" | "kvcoder.turn.started" | "kvcoder.turn.ended" | "kvcoder.session.waiting";
+        command: string;
+    }>;
+    handlerJobs: import("@kvman/sdk").Collection<{
+        jobId: string;
+        at: number;
+    }>;
+    signIns: import("@kvman/sdk").Collection<{
+        state: string;
+        server: string;
+        url: string;
+        redirectUrl: string;
+        at: number;
+    }>;
+};
+/** The same collections inside a transaction. */
+export declare function txRecords(tx: Transaction): {
+    sessions: import("@kvman/sdk").TransactionCollection<{
+        title: string;
+        autoTitle: boolean;
+        status: "idle" | "running" | "waiting";
+        parentId: string | null;
+        worker: {
+            name: string;
+            instructions: string;
+        } | null;
+        model: string | null;
+        thinking: "off" | "minimal" | "low" | "medium" | "high";
+        stepJobId: string | null;
+        turnId: string | null;
+        endedTurns: number;
+        nextSeq: number;
+        usage: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+            cost: number;
+        };
+        durationMs: number;
+        checks: {
+            name: string;
+            passed: boolean;
+        }[] | null;
+        connectors: string[] | null;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    messages: import("@kvman/sdk").TransactionCollection<{
+        sessionId: string;
+        turnId: string | null;
+        seq: number;
+        block: number;
+        kind: "user" | "assistant" | "toolResult" | "notice" | "note" | "summary";
+        source: {
+            kind: "user";
+        } | {
+            kind: "extension";
+            name: string;
+        } | {
+            kind: "subagent";
+            sessionId: string;
+        } | {
+            kind: "job";
+            jobId: string;
+        } | null;
+        content: Record<string, import("zod").JSONType>;
+        fileIds: string[] | null;
+        fileNames: string[] | null;
+        model: string | null;
+        usage: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+            cost: number;
+        } | null;
+        durationMs: number | null;
+        createdAt: string;
+    }>;
+    queued: import("@kvman/sdk").TransactionCollection<{
+        sessionId: string;
+        source: {
+            kind: "user";
+        } | {
+            kind: "extension";
+            name: string;
+        } | {
+            kind: "subagent";
+            sessionId: string;
+        } | {
+            kind: "job";
+            jobId: string;
+        };
+        text: string;
+        fileIds: string[] | null;
+        fileNames: string[] | null;
+        createdAt: string;
+    }>;
+    turns: import("@kvman/sdk").TransactionCollection<{
+        sessionId: string;
+        startedAt: string;
+        endedAt: string | null;
+        durationMs: number;
+        steps: number;
+        lost: number;
+        usage: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+            cost: number;
+        };
+        outcome: "done" | "cancelled" | "failed" | "interrupted" | "maxSteps" | null;
+        calls: {
+            toolCallId: string;
+            toolName: string;
+        }[];
+        pending: {
+            toolCallId: string;
+            kind: "subagent" | "worker" | "question" | "approval";
+            questionId: string | null;
+            question: import("zod").JSONType;
+            childSessionId: string | null;
+            runId: string | null;
+        }[];
+        results: {
+            toolCallId: string;
+            text: string;
+            details: import("zod").JSONType;
+            isError: boolean;
+            run: {
+                description: string;
+                connector: string;
+                command: string;
+                payload: Record<string, import("zod").JSONType>;
+            } | {
+                command: string;
+                timeoutMs: number;
+            } | null;
+        }[];
+    }>;
+    questions: import("@kvman/sdk").TransactionCollection<{
+        sessionId: string;
+        rootSessionId: string;
+        turnId: string;
+        toolCallId: string;
+        kind: "text" | "approval" | "choice" | "confirm";
+        question: Record<string, import("zod").JSONType>;
+    }>;
+    artifacts: import("@kvman/sdk").TransactionCollection<{
+        sessionId: string;
+        artifactId: string;
+        title: string;
+        format: "markdown" | "html" | "url";
+        content: string;
+        version: number;
+        createdAt: string;
+        updatedAt: string;
+    }>;
+    background: import("@kvman/sdk").TransactionCollection<{
+        sessionId: string;
+        ref: string;
+        kind: "connector" | "subagent";
+        call: string;
+        startedAt: string;
+    }>;
+    runs: import("@kvman/sdk").TransactionCollection<{
+        sessionId: string;
+        toolCallId: string | null;
+        worker: string;
+        kind: "opencode" | "pi" | "claude";
+        call: string;
+        command: string;
+        args: string[];
+        timeoutMs: number;
+        jobId: string | null;
+        status: "running" | "cancelled" | "failed" | "interrupted" | "succeeded";
+        startedAt: string;
+        endedAt: string | null;
+        exitCode: number | null;
+        output: string | null;
+    }>;
+    sections: import("@kvman/sdk").TransactionCollection<{
+        owner: string;
+        sectionId: string;
+        title: string;
+        order: number;
+        content: string;
+        sessionId: string | null;
+    }>;
+    globalSections: import("@kvman/sdk").TransactionCollection<{
+        owner: string;
+        sectionId: string;
+        title: string;
+        order: number;
+        content: string;
+        sessionId: string | null;
+    }>;
+    processes: import("@kvman/sdk").TransactionCollection<{
+        workspaceId: string;
+        sessionId: string;
+        title: string;
+        call: string;
+        startedAt: string;
+        reported: boolean;
+        endedAt?: string;
+        end?: "interrupted" | "exited" | "agent" | "person";
+        exitCode?: number | null;
+        signal?: string | null;
+        starting?: boolean;
+    }>;
+    connectors: import("@kvman/sdk").TransactionCollection<{
+        owner: string;
+        name: string;
+        description: string;
+        kind: "commands" | "binary";
+        commands: {
+            name: string;
+            command: string;
+            examples: {
+                description: string;
+                input: import("zod").JSONType;
+            }[];
+            asks: boolean;
+        }[] | null;
+        binary: {
+            check: string;
+            install: string | null;
+            help: string | null;
+        } | null;
+    }>;
+    handlers: import("@kvman/sdk").TransactionCollection<{
+        owner: string;
+        point: "kvcoder.session.created" | "kvcoder.session.deleted" | "kvcoder.session.forked" | "kvcoder.turn.started" | "kvcoder.turn.ended" | "kvcoder.session.waiting";
+        command: string;
+    }>;
+    handlerJobs: import("@kvman/sdk").TransactionCollection<{
+        jobId: string;
+        at: number;
+    }>;
+    signIns: import("@kvman/sdk").TransactionCollection<{
+        state: string;
+        server: string;
+        url: string;
+        redirectUrl: string;
+        at: number;
+    }>;
+};
+export type TxRecords = ReturnType<typeof txRecords>;
+//# sourceMappingURL=collections.d.ts.map

package/dist/store/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/store/collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQrD,yDAAyD;AACzD,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBnC;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,EAAE,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBxC;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/store/collections.js

@@ -0,0 +1,46 @@
+import { artifactDocSchema, backgroundDocSchema, messageDocSchema, processDocSchema, questionDocSchema, queuedDocSchema, runDocSchema, sessionDocSchema, turnDocSchema } from "../schemas/records.js";
+import { signInDocSchema } from "../mcp/sign-in-record.js";
+import { connectorDocSchema, handlerDocSchema, handlerJobDocSchema, sectionDocSchema } from "../schemas/registry.js";
+// kvcoder's collections (plan 08 §8.4 "Where entries live"): sessions and their records, and workspace sections, in
+// the workspace store; connectors, session handlers, handler-job ids, global sections, background processes, and started MCP sign-ins in the global store.
+/** The collections through the store's Promise calls. */
+export function records(store) {
+    return {
+        sessions: store.collection('sessions', sessionDocSchema),
+        messages: store.collection('messages', messageDocSchema),
+        queued: store.collection('queued', queuedDocSchema),
+        turns: store.collection('turns', turnDocSchema),
+        questions: store.collection('questions', questionDocSchema),
+        artifacts: store.collection('artifacts', artifactDocSchema),
+        background: store.collection('background', backgroundDocSchema),
+        runs: store.collection('runs', runDocSchema),
+        sections: store.collection('sections', sectionDocSchema),
+        globalSections: store.global.collection('sections', sectionDocSchema),
+        processes: store.global.collection('processes', processDocSchema),
+        connectors: store.global.collection('connectors', connectorDocSchema),
+        handlers: store.global.collection('handlers', handlerDocSchema),
+        handlerJobs: store.global.collection('handler-jobs', handlerJobDocSchema),
+        signIns: store.global.collection('mcp-sign-ins', signInDocSchema),
+    };
+}
+/** The same collections inside a transaction. */
+export function txRecords(tx) {
+    return {
+        sessions: tx.collection('sessions', sessionDocSchema),
+        messages: tx.collection('messages', messageDocSchema),
+        queued: tx.collection('queued', queuedDocSchema),
+        turns: tx.collection('turns', turnDocSchema),
+        questions: tx.collection('questions', questionDocSchema),
+        artifacts: tx.collection('artifacts', artifactDocSchema),
+        background: tx.collection('background', backgroundDocSchema),
+        runs: tx.collection('runs', runDocSchema),
+        sections: tx.collection('sections', sectionDocSchema),
+        globalSections: tx.global.collection('sections', sectionDocSchema),
+        processes: tx.global.collection('processes', processDocSchema),
+        connectors: tx.global.collection('connectors', connectorDocSchema),
+        handlers: tx.global.collection('handlers', handlerDocSchema),
+        handlerJobs: tx.global.collection('handler-jobs', handlerJobDocSchema),
+        signIns: tx.global.collection('mcp-sign-ins', signInDocSchema),
+    };
+}
+//# sourceMappingURL=collections.js.map

package/dist/store/collections.js.map

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

package/dist/turns/background.d.ts

@@ -0,0 +1,6 @@
+import type { Ctx } from '@kvman/sdk';
+import type { Source } from '../schemas/records.ts';
+/** The text a background result reaches the model with. */
+export declare function backgroundText(call: string, ref: string, result: string): string;
+export declare function appendBackground(ctx: Ctx, sessionId: string, source: Source, text: string, startTurn: boolean): Promise<void>;
+//# sourceMappingURL=background.d.ts.map

package/dist/turns/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/turns/background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AASpD,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAanI"}

package/dist/turns/background.js

@@ -0,0 +1,27 @@
+import { now } from "../sessions/session-lookup.js";
+import { txRecords } from "../store/collections.js";
+import { appendMessage, userContent } from "./history.js";
+import { beginTurn, openTurn } from "./start-turn.js";
+// Background results (ADR 0009, 89): a `user` message the next step reads. It starts a turn only when the session is
+// idle and `startTurn` allows; while a step runs or the session waits, it is queued and dismisses nothing.
+/** The text a background result reaches the model with. */
+export function backgroundText(call, ref, result) {
+    return `The background call \`${call}\` (job ${ref}) finished:\n${result}`;
+}
+export async function appendBackground(ctx, sessionId, source, text, startTurn) {
+    const turnId = await ctx.store.transaction((tx) => {
+        const store = txRecords(tx);
+        const session = store.sessions.get(sessionId);
+        if (session === undefined)
+            return undefined;
+        if (session.status !== 'idle') {
+            store.queued.insert({ sessionId, source, text, fileIds: null, fileNames: null, createdAt: now() });
+            return undefined;
+        }
+        appendMessage(store, session, { kind: 'user', content: userContent(text), source });
+        return startTurn ? openTurn(store, session) : undefined;
+    });
+    if (turnId !== undefined)
+        await beginTurn(ctx, sessionId, turnId, true);
+}
+//# sourceMappingURL=background.js.map

package/dist/turns/background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.js","sourceRoot":"","sources":["../../src/turns/background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEtD,qHAAqH;AACrH,2GAA2G;AAE3G,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW,EAAE,MAAc;IACtE,OAAO,yBAAyB,IAAI,WAAW,GAAG,gBAAgB,MAAM,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAQ,EAAE,SAAiB,EAAE,MAAc,EAAE,IAAY,EAAE,SAAkB;IAClH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE;QAChD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACnG,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACpF,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC"}

package/dist/turns/cancel-turn.d.ts

@@ -0,0 +1,3 @@
+import type { Ctx } from '@kvman/sdk';
+export declare function cancelTurn(ctx: Ctx, sessionId: string, notice: boolean): Promise<boolean>;
+//# sourceMappingURL=cancel-turn.d.ts.map

package/dist/turns/cancel-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-turn.d.ts","sourceRoot":"","sources":["../../src/turns/cancel-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAOtC,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAmB/F"}

package/dist/turns/cancel-turn.js

@@ -0,0 +1,31 @@
+import { dropRun } from "../delegate/runs.js";
+import { records, txRecords } from "../store/collections.js";
+import { endTurn } from "./end-turn.js";
+// Cancel (plan 08 §8.1): the running step, the subagents and program workers' runs the turn waits on, and the pending questions; then the
+// session is idle. Background work goes on and still reports back. Resolves whether a turn was cancelled.
+export async function cancelTurn(ctx, sessionId, notice) {
+    const found = await ctx.store.transaction((tx) => {
+        const store = txRecords(tx);
+        const session = store.sessions.get(sessionId);
+        if (session === undefined || session.turnId === null)
+            return undefined;
+        const turn = store.turns.get(session.turnId);
+        const children = (turn?.pending ?? []).flatMap((item) => (item.childSessionId === null ? [] : [item.childSessionId]));
+        const runs = (turn?.pending ?? []).flatMap((item) => (item.runId === null ? [] : [item.runId]));
+        return { turnId: session.turnId, stepJobId: session.stepJobId, children, runs };
+    });
+    if (found === undefined)
+        return false;
+    const ended = await endTurn(ctx, sessionId, found.turnId, 'cancelled', 'cancel', notice ? { code: 'CANCELLED' } : undefined);
+    if (found.stepJobId !== null)
+        await ctx.cancel(found.stepJobId);
+    for (const child of found.children)
+        await cancelTurn(ctx, child, false);
+    for (const runId of found.runs) {
+        const run = await records(ctx.store).runs.get(runId);
+        if (run !== undefined)
+            await dropRun(ctx, run);
+    }
+    return ended;
+}
+//# sourceMappingURL=cancel-turn.js.map

package/dist/turns/cancel-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-turn.js","sourceRoot":"","sources":["../../src/turns/cancel-turn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,0IAA0I;AAC1I,0GAA0G;AAC1G,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAQ,EAAE,SAAiB,EAAE,MAAe;IAC3E,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACvE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACtH,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChG,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAClF,CAAC,CAAC,CAAC;IACH,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7H,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI;QAAE,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChE,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ;QAAE,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACxE,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/turns/compaction.d.ts

@@ -0,0 +1,12 @@
+import { type Ctx, type Stored } from '@kvman/sdk';
+import type { SessionDoc } from '../schemas/records.ts';
+export type CompactOptions = {
+    force: boolean;
+    compactAt: number;
+    keep: number;
+    prompt: string;
+    turnId: string | null;
+};
+/** Summarizes the session's older messages when they pass the threshold, or with `force` whatever the threshold; says whether a summary was stored. */
+export declare function compact(ctx: Ctx, session: Stored<SessionDoc>, options: CompactOptions): Promise<boolean>;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/turns/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/turns/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAiCpE,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAExH,uJAAuJ;AACvJ,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB9G"}