@kvman/kvcoder 0.1.0

package/dist/registry/session-points.js

@@ -0,0 +1,89 @@
+import { z } from '@kvman/sdk';
+import { sessionPointSchema } from "../schemas/registry.js";
+import { invalid } from "../problems.js";
+import { records, txRecords } from "../store/collections.js";
+import { callerExtension, loadedOwners, ownsPublicCommand, registrations } from "./loaded.js";
+// Session points (plan 08 §8.4): an extension has one of its public commands queued when something happens to a
+// session. Each runs inside kvcoder's own job, `kvcoder.handler.run`, which records its id before the command runs, so
+// a message the command injects (its `rootId` is that id) is always recognized and starts no turn.
+const week = 7 * 24 * 3_600_000;
+/** Queues one job per handler registered for `point`, and remembers their ids. */
+export async function firePoint(ctx, point, input) {
+    const store = records(ctx.store);
+    const handlers = await store.handlers.find({ point }, { limit: 1000 });
+    if (handlers.length === 0)
+        return;
+    const loaded = await loadedOwners(ctx, handlers.map((entry) => entry.owner));
+    for (const handler of handlers.filter((entry) => loaded.has(entry.owner)))
+        await ctx.execAsync('kvcoder.handler.run', { command: handler.command, input });
+}
+/** Whether the running job descends from a handler job kvcoder queued. */
+export async function fromSessionHandler(ctx) {
+    return (await records(ctx.store).handlerJobs.count({ jobId: ctx.job.rootId })) > 0;
+}
+export function registerSessionPoints(ctx) {
+    ctx.registerCommand('kvcoder.handler.run', {
+        description: "Runs a session handler's command, remembering its job so the handler's injections start no turn.",
+        input: z.object({ command: z.string(), input: z.record(z.string(), z.json()) }),
+        output: z.object({}),
+        handle: async ({ command, input }) => {
+            await records(ctx.store).handlerJobs.insert({ jobId: ctx.job.id, at: Date.now() });
+            await ctx.exec(command, input);
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.handler.register', {
+        description: "Registers one of the caller's public commands to be queued at a session point.",
+        input: z.object({ point: z.string(), command: z.string().min(1) }),
+        output: z.object({}),
+        public: true,
+        handle: async ({ point, command }) => {
+            const owner = callerExtension(ctx, 'session handlers');
+            const known = sessionPointSchema.safeParse(point);
+            if (!known.success)
+                throw invalid(`There is no session point ${point}.`, { point });
+            if (!ownsPublicCommand(await registrations(ctx), owner, command))
+                throw invalid(`${command} isn't a public command of ${owner}.`, { command });
+            await ctx.store.transaction((tx) => {
+                const { handlers } = txRecords(tx);
+                for (const old of handlers.find({ point: known.data, owner }, { limit: 1 }))
+                    handlers.delete(old.id);
+                handlers.insert({ owner, point: known.data, command });
+            });
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.handler.unregister', {
+        description: "Removes the caller's handler of a session point; each extension has its own.",
+        input: z.object({ point: sessionPointSchema }),
+        output: z.object({}),
+        public: true,
+        handle: async ({ point }) => {
+            const owner = callerExtension(ctx, 'session handlers');
+            const { handlers } = records(ctx.store);
+            for (const own of await handlers.find({ point, owner }, { limit: 1 }))
+                await handlers.delete(own.id);
+            return {};
+        },
+    });
+    ctx.registerQuery('kvcoder.handler.list', {
+        description: 'Lists the session handlers.',
+        input: z.object({}),
+        output: z.array(z.object({ point: sessionPointSchema, command: z.string(), owner: z.string() })),
+        public: true,
+        handle: async () => (await records(ctx.store).handlers.find({}, { limit: 1000 })).map(({ point, command, owner }) => ({ point, command, owner })),
+    });
+}
+/** Clears the handlers at kvcoder's start, and forgets handler-job ids older than a week (ADR 0009, 103). */
+export async function clearSessionPoints(ctx) {
+    const store = records(ctx.store);
+    for (let found = await store.handlers.find({}, { limit: 1000 }); found.length > 0; found = await store.handlers.find({}, { limit: 1000 })) {
+        for (const handler of found)
+            await store.handlers.delete(handler.id);
+    }
+    const cutoff = Date.now() - week;
+    for (const job of await store.handlerJobs.find({}, { limit: 1000 }))
+        if (job.at < cutoff)
+            await store.handlerJobs.delete(job.id);
+}
+//# sourceMappingURL=session-points.js.map

package/dist/registry/session-points.js.map

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

package/dist/result-text.d.ts

@@ -0,0 +1,11 @@
+/** Output over this many bytes is cut. */
+export declare const outputLimit: number;
+/** The bytes kept at each end of cut output. */
+export declare const outputKept: number;
+/** The first and last bytes of cut output around the marker. */
+export declare function cutOutput(head: Buffer, omitted: number, tail: Buffer): string;
+/** Cuts text over 30 KB to its first and last 15 KB around an explicit marker. */
+export declare function truncate(text: string): string;
+/** The text a line in the shell returns to the model: the output (already cut, trailing newlines dropped), then any notes, then its exit code (ADR 0009, 93). */
+export declare function resultLines(output: string, exitCode: number, notes?: readonly string[]): string;
+//# sourceMappingURL=result-text.d.ts.map

package/dist/result-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-text.d.ts","sourceRoot":"","sources":["../src/result-text.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,eAAO,MAAM,WAAW,QAAY,CAAC;AACrC,gDAAgD;AAChD,eAAO,MAAM,UAAU,QAAY,CAAC;AAEpC,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,iKAAiK;AACjK,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,CAEnG"}

package/dist/result-text.js

@@ -0,0 +1,21 @@
+// What a call returns to the model, and how long output is cut (plan 08 §8.3, ADR 0009, 93).
+/** Output over this many bytes is cut. */
+export const outputLimit = 30 * 1024;
+/** The bytes kept at each end of cut output. */
+export const outputKept = 15 * 1024;
+/** The first and last bytes of cut output around the marker. */
+export function cutOutput(head, omitted, tail) {
+    return `${head.toString('utf8')}\n[… ${omitted} bytes omitted …]\n${tail.toString('utf8')}`;
+}
+/** Cuts text over 30 KB to its first and last 15 KB around an explicit marker. */
+export function truncate(text) {
+    const bytes = Buffer.from(text, 'utf8');
+    if (bytes.length <= outputLimit)
+        return text;
+    return cutOutput(bytes.subarray(0, outputKept), bytes.length - 2 * outputKept, bytes.subarray(bytes.length - outputKept));
+}
+/** The text a line in the shell returns to the model: the output (already cut, trailing newlines dropped), then any notes, then its exit code (ADR 0009, 93). */
+export function resultLines(output, exitCode, notes = []) {
+    return [output.replace(/[\r\n]+$/, ''), ...notes, `[exit code ${exitCode}]`].filter((part) => part !== '').join('\n');
+}
+//# sourceMappingURL=result-text.js.map

package/dist/result-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-text.js","sourceRoot":"","sources":["../src/result-text.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAE7F,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC;AACrC,gDAAgD;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAEpC,gEAAgE;AAChE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,IAAY;IACnE,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,OAAO,sBAAsB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;AAC9F,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,IAAI,WAAW;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;AAC5H,CAAC;AAED,iKAAiK;AACjK,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,QAAgB,EAAE,QAA2B,EAAE;IACzF,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,cAAc,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxH,CAAC"}

package/dist/schemas/records.d.ts

@@ -0,0 +1,357 @@
+import { z } from '@kvman/sdk';
+import type { JsonValue } from '../connector-call.ts';
+export type { JsonValue };
+/** How hard the model thinks, as kvai takes it. */
+export declare const thinkingSchema: z.ZodEnum<{
+    off: "off";
+    minimal: "minimal";
+    low: "low";
+    medium: "medium";
+    high: "high";
+}>;
+/** Tokens and cost, summed. */
+export declare const usageSchema: z.ZodObject<{
+    input: z.ZodNumber;
+    output: z.ZodNumber;
+    cacheRead: z.ZodNumber;
+    cacheWrite: z.ZodNumber;
+    cost: z.ZodNumber;
+}, z.core.$strip>;
+/** A session title: a string, or a translation key. */
+export declare const titleSchema: z.ZodString;
+/** A session's status. */
+export declare const statusSchema: z.ZodEnum<{
+    idle: "idle";
+    running: "running";
+    waiting: "waiting";
+}>;
+/** A binary connector's check result, stored in the session at its first step. */
+export declare const checkSchema: z.ZodObject<{
+    name: z.ZodString;
+    passed: z.ZodBoolean;
+}, z.core.$strip>;
+/** How a turn ended. */
+export declare const outcomeSchema: z.ZodEnum<{
+    done: "done";
+    cancelled: "cancelled";
+    failed: "failed";
+    interrupted: "interrupted";
+    maxSteps: "maxSteps";
+}>;
+/** Where a message came from. */
+export declare const sourceSchema: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"user">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"extension">;
+    name: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"subagent">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"job">;
+    jobId: z.ZodString;
+}, z.core.$strip>]>;
+/** A message's kind. */
+export declare const messageKindSchema: z.ZodEnum<{
+    user: "user";
+    assistant: "assistant";
+    toolResult: "toolResult";
+    notice: "notice";
+    note: "note";
+    summary: "summary";
+}>;
+export declare const sessionDocSchema: z.ZodObject<{
+    title: z.ZodString;
+    autoTitle: z.ZodBoolean;
+    status: z.ZodEnum<{
+        idle: "idle";
+        running: "running";
+        waiting: "waiting";
+    }>;
+    parentId: z.ZodNullable<z.ZodString>;
+    worker: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        name: z.ZodString;
+        instructions: z.ZodString;
+    }, z.core.$strip>>>;
+    model: z.ZodNullable<z.ZodString>;
+    thinking: z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>;
+    stepJobId: z.ZodNullable<z.ZodString>;
+    turnId: z.ZodNullable<z.ZodString>;
+    endedTurns: z.ZodNumber;
+    nextSeq: z.ZodNumber;
+    usage: z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+        cacheRead: z.ZodNumber;
+        cacheWrite: z.ZodNumber;
+        cost: z.ZodNumber;
+    }, z.core.$strip>;
+    durationMs: z.ZodNumber;
+    checks: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        passed: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    connectors: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const messageDocSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    turnId: z.ZodNullable<z.ZodString>;
+    seq: z.ZodNumber;
+    block: z.ZodNumber;
+    kind: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+        toolResult: "toolResult";
+        notice: "notice";
+        note: "note";
+        summary: "summary";
+    }>;
+    source: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"user">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"extension">;
+        name: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"subagent">;
+        sessionId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"job">;
+        jobId: z.ZodString;
+    }, z.core.$strip>]>>;
+    content: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    fileIds: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    fileNames: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    model: z.ZodNullable<z.ZodString>;
+    usage: z.ZodNullable<z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+        cacheRead: z.ZodNumber;
+        cacheWrite: z.ZodNumber;
+        cost: z.ZodNumber;
+    }, z.core.$strip>>;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export declare const queuedDocSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    source: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"user">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"extension">;
+        name: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"subagent">;
+        sessionId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"job">;
+        jobId: z.ZodString;
+    }, z.core.$strip>]>;
+    text: z.ZodString;
+    fileIds: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    fileNames: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+/** What a pending call waits on. */
+export declare const pendingSchema: z.ZodObject<{
+    toolCallId: z.ZodString;
+    kind: z.ZodEnum<{
+        subagent: "subagent";
+        worker: "worker";
+        question: "question";
+        approval: "approval";
+    }>;
+    questionId: z.ZodNullable<z.ZodString>;
+    question: z.ZodNullable<z.ZodJSONSchema>;
+    childSessionId: z.ZodNullable<z.ZodString>;
+    runId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/** A call the person approves before it runs: what the model said it does, and the connector command with its payload. */
+export declare const runCallSchema: z.ZodObject<{
+    description: z.ZodString;
+    connector: z.ZodString;
+    command: z.ZodString;
+    payload: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+}, z.core.$strict>;
+export declare const heldResultSchema: z.ZodObject<{
+    toolCallId: z.ZodString;
+    text: z.ZodString;
+    details: z.ZodNullable<z.ZodJSONSchema>;
+    isError: z.ZodBoolean;
+    run: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+        description: z.ZodString;
+        connector: z.ZodString;
+        command: z.ZodString;
+        payload: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodString;
+        timeoutMs: z.ZodNumber;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+export declare const turnDocSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    startedAt: z.ZodString;
+    endedAt: z.ZodNullable<z.ZodString>;
+    durationMs: z.ZodNumber;
+    steps: z.ZodNumber;
+    lost: z.ZodDefault<z.ZodNumber>;
+    usage: z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+        cacheRead: z.ZodNumber;
+        cacheWrite: z.ZodNumber;
+        cost: z.ZodNumber;
+    }, z.core.$strip>;
+    outcome: z.ZodNullable<z.ZodEnum<{
+        done: "done";
+        cancelled: "cancelled";
+        failed: "failed";
+        interrupted: "interrupted";
+        maxSteps: "maxSteps";
+    }>>;
+    calls: z.ZodArray<z.ZodObject<{
+        toolCallId: z.ZodString;
+        toolName: z.ZodString;
+    }, z.core.$strip>>;
+    pending: z.ZodArray<z.ZodObject<{
+        toolCallId: z.ZodString;
+        kind: z.ZodEnum<{
+            subagent: "subagent";
+            worker: "worker";
+            question: "question";
+            approval: "approval";
+        }>;
+        questionId: z.ZodNullable<z.ZodString>;
+        question: z.ZodNullable<z.ZodJSONSchema>;
+        childSessionId: z.ZodNullable<z.ZodString>;
+        runId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    results: z.ZodArray<z.ZodObject<{
+        toolCallId: z.ZodString;
+        text: z.ZodString;
+        details: z.ZodNullable<z.ZodJSONSchema>;
+        isError: z.ZodBoolean;
+        run: z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+            description: z.ZodString;
+            connector: z.ZodString;
+            command: z.ZodString;
+            payload: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodString;
+            timeoutMs: z.ZodNumber;
+        }, z.core.$strip>]>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const questionDocSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    rootSessionId: z.ZodString;
+    turnId: z.ZodString;
+    toolCallId: z.ZodString;
+    kind: z.ZodEnum<{
+        text: "text";
+        approval: "approval";
+        choice: "choice";
+        confirm: "confirm";
+    }>;
+    question: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+}, z.core.$strip>;
+export declare const backgroundDocSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    ref: z.ZodString;
+    kind: z.ZodEnum<{
+        connector: "connector";
+        subagent: "subagent";
+    }>;
+    call: z.ZodString;
+    startedAt: z.ZodString;
+}, z.core.$strip>;
+/** How a program worker's run stands. */
+export declare const runStatusSchema: z.ZodEnum<{
+    running: "running";
+    cancelled: "cancelled";
+    failed: "failed";
+    interrupted: "interrupted";
+    succeeded: "succeeded";
+}>;
+export declare const runDocSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    toolCallId: z.ZodNullable<z.ZodString>;
+    worker: z.ZodString;
+    kind: z.ZodEnum<{
+        opencode: "opencode";
+        pi: "pi";
+        claude: "claude";
+    }>;
+    call: z.ZodString;
+    command: z.ZodString;
+    args: z.ZodArray<z.ZodString>;
+    timeoutMs: z.ZodNumber;
+    jobId: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        running: "running";
+        cancelled: "cancelled";
+        failed: "failed";
+        interrupted: "interrupted";
+        succeeded: "succeeded";
+    }>;
+    startedAt: z.ZodString;
+    endedAt: z.ZodNullable<z.ZodString>;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    output: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const processDocSchema: z.ZodObject<{
+    workspaceId: z.ZodString;
+    sessionId: z.ZodString;
+    title: z.ZodString;
+    call: z.ZodString;
+    startedAt: z.ZodString;
+    endedAt: z.ZodExactOptional<z.ZodString>;
+    end: z.ZodExactOptional<z.ZodEnum<{
+        interrupted: "interrupted";
+        exited: "exited";
+        agent: "agent";
+        person: "person";
+    }>>;
+    exitCode: z.ZodExactOptional<z.ZodNullable<z.ZodNumber>>;
+    signal: z.ZodExactOptional<z.ZodNullable<z.ZodString>>;
+    reported: z.ZodBoolean;
+    starting: z.ZodExactOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const artifactDocSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    artifactId: z.ZodString;
+    title: z.ZodString;
+    format: z.ZodEnum<{
+        markdown: "markdown";
+        html: "html";
+        url: "url";
+    }>;
+    content: z.ZodString;
+    version: z.ZodNumber;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type SessionDoc = z.output<typeof sessionDocSchema>;
+export type MessageDoc = z.output<typeof messageDocSchema>;
+export type QueuedDoc = z.output<typeof queuedDocSchema>;
+export type TurnDoc = z.output<typeof turnDocSchema>;
+export type Pending = z.output<typeof pendingSchema>;
+export type HeldResult = z.output<typeof heldResultSchema>;
+export type RunCallDoc = z.output<typeof runCallSchema>;
+export type QuestionDoc = z.output<typeof questionDocSchema>;
+export type BackgroundDoc = z.output<typeof backgroundDocSchema>;
+export type ArtifactDoc = z.output<typeof artifactDocSchema>;
+export type ProcessDoc = z.output<typeof processDocSchema>;
+export type RunDoc = z.output<typeof runDocSchema>;
+export type Usage = z.output<typeof usageSchema>;
+export type Outcome = z.output<typeof outcomeSchema>;
+export type Source = z.output<typeof sourceSchema>;
+export type Title = z.output<typeof titleSchema>;
+//# sourceMappingURL=records.d.ts.map

package/dist/schemas/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/schemas/records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,YAAY,EAAE,SAAS,EAAE,CAAC;AAI1B,mDAAmD;AACnD,eAAO,MAAM,cAAc;;;;;;EAAsD,CAAC;AAIlF,+BAA+B;AAC/B,eAAO,MAAM,WAAW;;;;;;iBAAqH,CAAC;AAE9I,uDAAuD;AACvD,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,0BAA0B;AAC1B,eAAO,MAAM,YAAY;;;;EAAyC,CAAC;AAEnE,kFAAkF;AAClF,eAAO,MAAM,WAAW;;;iBAAsD,CAAC;AAE/E,wBAAwB;AACxB,eAAO,MAAM,aAAa;;;;;;EAAqE,CAAC;AAEhG,iCAAiC;AACjC,eAAO,MAAM,YAAY;;;;;;;;;;;mBAKvB,CAAC;AAEH,wBAAwB;AACxB,eAAO,MAAM,iBAAiB;;;;;;;EAA2E,CAAC;AAE1G,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmB3B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAc3B,CAAC;AAGH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;iBAAyL,CAAC;AAEtN,oCAAoC;AACpC,eAAO,MAAM,aAAa;;;;;;;;;;;;iBAQxB,CAAC;AAEH,0HAA0H;AAC1H,eAAO,MAAM,aAAa;;;;;kBAAmI,CAAC;AAQ9J,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;iBAM3B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYxB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;iBAO5B,CAAC;AAIH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAAyI,CAAC;AAE1K,yCAAyC;AACzC,eAAO,MAAM,eAAe;;;;;;EAAyE,CAAC;AAItG,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;iBAevB,CAAC;AAKH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;iBAY3B,CAAC;AAIH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAS5B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC3D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AACzD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AACrD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AACxD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACjE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC7D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC3D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AACnD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;AACjD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AACrD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AACnD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/schemas/records.js

@@ -0,0 +1,159 @@
+import { z } from '@kvman/sdk';
+import { artifactFormats } from "../artifacts/artifact-format.js";
+// kvcoder's records (plan 08 §8.1): sessions, messages, turns, and what waits on the person.
+/** How hard the model thinks, as kvai takes it. */
+export const thinkingSchema = z.enum(['off', 'minimal', 'low', 'medium', 'high']);
+const tokens = z.number().int().nonnegative();
+/** Tokens and cost, summed. */
+export const usageSchema = z.object({ input: tokens, output: tokens, cacheRead: tokens, cacheWrite: tokens, cost: z.number().nonnegative() });
+/** A session title: a string, or a translation key. */
+export const titleSchema = z.string();
+/** A session's status. */
+export const statusSchema = z.enum(['idle', 'running', 'waiting']);
+/** A binary connector's check result, stored in the session at its first step. */
+export const checkSchema = z.object({ name: z.string(), passed: z.boolean() });
+/** How a turn ended. */
+export const outcomeSchema = z.enum(['done', 'cancelled', 'failed', 'interrupted', 'maxSteps']);
+/** Where a message came from. */
+export const sourceSchema = z.union([
+    z.object({ kind: z.literal('user') }),
+    z.object({ kind: z.literal('extension'), name: z.string() }),
+    z.object({ kind: z.literal('subagent'), sessionId: z.string() }),
+    z.object({ kind: z.literal('job'), jobId: z.string() }),
+]);
+/** A message's kind. */
+export const messageKindSchema = z.enum(['user', 'assistant', 'toolResult', 'notice', 'note', 'summary']);
+export const sessionDocSchema = z.object({
+    title: titleSchema,
+    autoTitle: z.boolean(),
+    status: statusSchema,
+    parentId: z.string().nullable(),
+    // The worker a child session runs for, with the instructions it started with (ADR 0021, 29).
+    worker: z.object({ name: z.string(), instructions: z.string() }).nullable().default(null),
+    model: z.string().nullable(),
+    thinking: thinkingSchema,
+    stepJobId: z.string().nullable(),
+    turnId: z.string().nullable(),
+    endedTurns: z.number().int().nonnegative(),
+    nextSeq: z.number().int().nonnegative(),
+    usage: usageSchema,
+    durationMs: z.number().nonnegative(),
+    checks: z.array(checkSchema).nullable(),
+    connectors: z.array(z.string()).nullable(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+export const messageDocSchema = z.object({
+    sessionId: z.string(),
+    turnId: z.string().nullable(),
+    seq: z.number().int().nonnegative(),
+    block: z.number().int().nonnegative(),
+    kind: messageKindSchema,
+    source: sourceSchema.nullable(),
+    content: z.record(z.string(), z.json()),
+    fileIds: z.array(z.string()).nullable(),
+    fileNames: z.array(z.string()).nullable(),
+    model: z.string().nullable(),
+    usage: usageSchema.nullable(),
+    durationMs: z.number().nonnegative().nullable(),
+    createdAt: z.string(),
+});
+// A message waiting for the running step to append its results (ADR 0009, 102).
+export const queuedDocSchema = z.object({ sessionId: z.string(), source: sourceSchema, text: z.string(), fileIds: z.array(z.string()).nullable(), fileNames: z.array(z.string()).nullable(), createdAt: z.string() });
+/** What a pending call waits on. */
+export const pendingSchema = z.object({
+    toolCallId: z.string(),
+    kind: z.enum(['question', 'subagent', 'approval', 'worker']),
+    questionId: z.string().nullable(),
+    question: z.json().nullable(),
+    childSessionId: z.string().nullable(),
+    // The run of a program worker the call waits on (ADR 0021, 23).
+    runId: z.string().nullable().default(null),
+});
+/** A call the person approves before it runs: what the model said it does, and the connector command with its payload. */
+export const runCallSchema = z.strictObject({ description: z.string(), connector: z.string(), command: z.string(), payload: z.record(z.string(), z.json()) });
+// An approved call of the old shell tool. It is kept only so a turn stored before `run` still parses; it is never run
+// (ADR 0011, 12).
+const oldShellRunSchema = z.object({ command: z.string(), timeoutMs: z.number().int().positive() });
+// A call's result kept in the turn until the step's calls all resolve; `run` is an approved call the next step runs
+// before it appends the results.
+export const heldResultSchema = z.object({
+    toolCallId: z.string(),
+    text: z.string(),
+    details: z.json().nullable(),
+    isError: z.boolean(),
+    run: z.union([runCallSchema, oldShellRunSchema]).nullable(),
+});
+export const turnDocSchema = z.object({
+    sessionId: z.string(),
+    startedAt: z.string(),
+    endedAt: z.string().nullable(),
+    durationMs: z.number().nonnegative(),
+    steps: z.number().int().nonnegative(),
+    lost: z.number().int().nonnegative().default(0),
+    usage: usageSchema,
+    outcome: outcomeSchema.nullable(),
+    calls: z.array(z.object({ toolCallId: z.string(), toolName: z.string() })),
+    pending: z.array(pendingSchema),
+    results: z.array(heldResultSchema),
+});
+export const questionDocSchema = z.object({
+    sessionId: z.string(),
+    rootSessionId: z.string(),
+    turnId: z.string(),
+    toolCallId: z.string(),
+    kind: z.enum(['text', 'choice', 'confirm', 'approval']),
+    question: z.record(z.string(), z.json()),
+});
+// A subagent a session started with `background: true` (ADR 0009, 88), by its child session id. `connector` is the kind
+// of a job started with the old `--async`; such a stored row still parses and is never listed (ADR 0011, 6).
+export const backgroundDocSchema = z.object({ sessionId: z.string(), ref: z.string(), kind: z.enum(['connector', 'subagent']), call: z.string(), startedAt: z.string() });
+/** How a program worker's run stands. */
+export const runStatusSchema = z.enum(['running', 'succeeded', 'failed', 'cancelled', 'interrupted']);
+// A run of a program worker (ADR 0021, 33): the command line it started with, the job that runs it, and what it
+// returned. `toolCallId` is the call a turn waits on, and `null` for a background run.
+export const runDocSchema = z.object({
+    sessionId: z.string(),
+    toolCallId: z.string().nullable(),
+    worker: z.string(),
+    kind: z.enum(['opencode', 'pi', 'claude']),
+    call: z.string(),
+    command: z.string(),
+    args: z.array(z.string()),
+    timeoutMs: z.number().int().positive(),
+    jobId: z.string().nullable(),
+    status: runStatusSchema,
+    startedAt: z.string(),
+    endedAt: z.string().nullable(),
+    exitCode: z.number().int().nullable(),
+    output: z.string().nullable(),
+});
+// A background process a session started with `background: true` (ADR 0009, 150). It lives in the global store, since the
+// handlers for kvman stopping and starting run in Home. It is running until `end` is set; `reported` says whether the
+// session has been told how it ended.
+export const processDocSchema = z.object({
+    workspaceId: z.string(),
+    sessionId: z.string(),
+    title: z.string(),
+    call: z.string(),
+    startedAt: z.string(),
+    endedAt: z.string().exactOptional(),
+    end: z.enum(['exited', 'agent', 'person', 'interrupted']).exactOptional(),
+    exitCode: z.number().int().nullable().exactOptional(),
+    signal: z.string().nullable().exactOptional(),
+    reported: z.boolean(),
+    starting: z.boolean().exactOptional(),
+});
+// A document shown beside the chat (plan 08 §8.5, ADR 0009, 175): `sessionId` is the chat's own id, `artifactId`
+// names it within the chat, and only the latest content is kept.
+export const artifactDocSchema = z.object({
+    sessionId: z.string(),
+    artifactId: z.string(),
+    title: z.string(),
+    format: z.enum(artifactFormats),
+    content: z.string(),
+    version: z.number().int().min(1),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+//# sourceMappingURL=records.js.map