@kvman/kvcoder 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ahmed Deif
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# @kvman/kvcoder
+
+The [kvman](https://github.com/ibndeif/kvman) app-building harness: an agent with one `run` tool over connectors, sections, and its conversation UI. It is bundled with kvman, and needs `@kvman/kvai` and `@kvman/kvwebui`.
+
+See [its guides](https://github.com/ibndeif/kvman/tree/main/extensions/kvcoder/docs).
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,386 @@
+import type { Json } from '@kvman/sdk';
+import type { Worker } from './delegate/workers.ts';
+import type { Message, Session, Turn } from './sessions/session-view.ts';
+type Empty = Record<string, never>;
+type Thinking = 'off' | 'minimal' | 'low' | 'medium' | 'high';
+type Status = 'idle' | 'running' | 'waiting';
+type SessionId = {
+    sessionId: string;
+};
+type Example = {
+    description: string;
+    input: Json;
+};
+type Binary = {
+    check: string;
+    install?: string;
+    help?: string;
+};
+type Connector = {
+    name: string;
+    description: string;
+    commands: {
+        name: string;
+        command: string;
+        examples?: Example[];
+        asks?: true;
+    }[];
+} | {
+    name: string;
+    description: string;
+    binary: Binary;
+};
+type ConnectorRow = {
+    name: string;
+    description: string;
+    owner: string;
+    kind: 'commands' | 'binary';
+    commands?: {
+        name: string;
+        command: string;
+        examples: Example[];
+        asks: boolean;
+    }[];
+    binary?: Binary;
+};
+type Point = 'kvcoder.session.created' | 'kvcoder.session.deleted' | 'kvcoder.session.forked' | 'kvcoder.turn.started' | 'kvcoder.turn.ended' | 'kvcoder.session.waiting';
+type Place = {
+    global?: boolean;
+    sessionId?: string;
+};
+type JobRow = {
+    id: string;
+    kind: 'process' | 'subagent' | 'worker';
+    title: string;
+    call: string;
+    status: string;
+    startedAt: string;
+    endedAt?: string;
+    exitCode?: number;
+    links: string[];
+};
+type Send = {
+    sessionId: string;
+    text: string;
+    fileIds?: string[];
+};
+type McpServer = {
+    name: string;
+    description: string;
+    command: string;
+    args: string[];
+    env: string[];
+} | {
+    name: string;
+    description: string;
+    url: string;
+    headers: string[];
+};
+type McpCheck = {
+    status: 'ready';
+    tools: number;
+} | {
+    status: 'signInNeeded';
+} | {
+    status: 'failed';
+    problem: {
+        code: string;
+        message: string;
+        params?: Record<string, Json>;
+    };
+};
+declare module '@kvman/sdk' {
+    interface Commands {
+        'kvcoder.session.create': {
+            input: {
+                title?: string;
+            };
+            output: Session;
+        };
+        'kvcoder.session.rename': {
+            input: {
+                sessionId: string;
+                title: string;
+            };
+            output: Empty;
+        };
+        'kvcoder.session.configure': {
+            input: {
+                sessionId: string;
+                model?: string;
+                thinking?: Thinking;
+            };
+            output: Empty;
+        };
+        'kvcoder.session.delete': {
+            input: SessionId;
+            output: Empty;
+        };
+        'kvcoder.session.compact': {
+            input: SessionId;
+            output: {
+                summarized: boolean;
+            };
+        };
+        'kvcoder.mcp.server.check': {
+            input: {
+                name: string;
+            };
+            output: McpCheck;
+        };
+        'kvcoder.delegate.worker.check': {
+            input: {
+                name: string;
+            };
+            output: {
+                status: 'ready' | 'notFound';
+            };
+        };
+        'kvcoder.mcp.sign-in.start': {
+            input: {
+                name: string;
+                redirectUrl: string;
+            };
+            output: {
+                url: string;
+            };
+        };
+        'kvcoder.mcp.sign-in.finish': {
+            input: {
+                state: string;
+                code: string;
+            };
+            output: {
+                name: string;
+            };
+        };
+        'kvcoder.session.export': {
+            input: SessionId;
+            output: {
+                fileId: string;
+            };
+        };
+        'kvcoder.session.fork': {
+            input: {
+                sessionId: string;
+                throughSeq?: number;
+            };
+            output: Session;
+        };
+        'kvcoder.message.send': {
+            input: Send;
+            output: Empty;
+        };
+        'kvcoder.message.inject': {
+            input: Send;
+            output: Empty;
+        };
+        'kvcoder.note.add': {
+            input: {
+                sessionId: string;
+                key: string;
+                params?: Record<string, Json>;
+            };
+            output: Empty;
+        };
+        'kvcoder.turn.cancel': {
+            input: SessionId;
+            output: Empty;
+        };
+        'kvcoder.job.cancel': {
+            input: {
+                sessionId: string;
+                id: string;
+            };
+            output: Empty;
+        };
+        'kvcoder.question.answer': {
+            input: {
+                questionId: string;
+                answer: Json;
+            };
+            output: {
+                jobId: string | null;
+            };
+        };
+        'kvcoder.connector.register': {
+            input: Connector | {
+                connectors: Connector[];
+            };
+            output: Empty;
+        };
+        'kvcoder.connector.unregister': {
+            input: {
+                name: string;
+            };
+            output: Empty;
+        };
+        'kvcoder.section.set': {
+            input: {
+                id: string;
+                title: string;
+                order: number;
+                content: string;
+            } & Place;
+            output: Empty;
+        };
+        'kvcoder.section.remove': {
+            input: {
+                id: string;
+            } & Place;
+            output: Empty;
+        };
+        'kvcoder.handler.register': {
+            input: {
+                point: Point;
+                command: string;
+            };
+            output: Empty;
+        };
+        'kvcoder.handler.unregister': {
+            input: {
+                point: Point;
+            };
+            output: Empty;
+        };
+    }
+    interface Queries {
+        'kvcoder.session.list': {
+            input: {
+                limit: number;
+            };
+            output: Session[];
+        };
+        'kvcoder.session.get': {
+            input: SessionId;
+            output: Session;
+        };
+        'kvcoder.session.count': {
+            input: {
+                status?: Status;
+            };
+            output: {
+                count: number;
+            };
+        };
+        'kvcoder.message.list': {
+            input: {
+                sessionId: string;
+                limit: number;
+            };
+            output: {
+                messages: Message[];
+                omitted: number;
+            };
+        };
+        'kvcoder.job.list': {
+            input: SessionId;
+            output: JobRow[];
+        };
+        'kvcoder.job.get': {
+            input: {
+                sessionId: string;
+                id: string;
+            };
+            output: JobRow & {
+                output?: Json;
+                problem?: Json;
+            };
+        };
+        'kvcoder.turn.list': {
+            input: {
+                sessionId: string;
+                limit: number;
+            };
+            output: Turn[];
+        };
+        'kvcoder.prompt.get': {
+            input: SessionId;
+            output: {
+                prompt: string;
+                sections: {
+                    id: string;
+                    title: string;
+                    owner: string;
+                    reach: 'global' | 'workspace' | 'session';
+                    size: number;
+                    included: boolean;
+                }[];
+            };
+        };
+        'kvcoder.connector.list': {
+            input: Empty;
+            output: (ConnectorRow & {
+                enabled: boolean;
+            })[];
+        };
+        'kvcoder.section.list': {
+            input: {
+                sessionId?: string;
+            };
+            output: {
+                id: string;
+                title: string;
+                order: number;
+                owner: string;
+                global: boolean;
+                sessionId?: string;
+                size: number;
+            }[];
+        };
+        'kvcoder.handler.list': {
+            input: Empty;
+            output: {
+                point: Point;
+                command: string;
+                owner: string;
+            }[];
+        };
+        'kvcoder.artifact.list': {
+            input: SessionId;
+            output: {
+                id: string;
+                title: string;
+                format: 'markdown' | 'html' | 'url';
+                version: number;
+                size: number;
+                updatedAt: string;
+            }[];
+        };
+        'kvcoder.artifact.get': {
+            input: {
+                sessionId: string;
+                id: string;
+            };
+            output: {
+                id: string;
+                title: string;
+                format: 'markdown' | 'html' | 'url';
+                version: number;
+                content: string;
+                createdAt: string;
+                updatedAt: string;
+            };
+        };
+    }
+    interface Settings {
+        'kvcoder.model': string | null;
+        'kvcoder.thinking': Thinking;
+        'kvcoder.maxSteps': number;
+        'kvcoder.shell.approval': 'ask' | 'auto';
+        'kvcoder.shell.path': string | null;
+        'kvcoder.compactAt': number;
+        'kvcoder.compactKeep': number;
+        'kvcoder.connectors': {
+            name: string;
+            description: string;
+            binary: Binary;
+        }[];
+        'kvcoder.connectors.disabled': string[];
+        'kvcoder.mcp.servers': McpServer[];
+        'kvcoder.delegate.workers': Worker[];
+        'kvcoder.sessions.keep': number;
+    }
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":""}

package/dist/artifacts/artifact-format.d.ts

@@ -0,0 +1,9 @@
+export declare const artifactFormats: readonly ["markdown", "html", "url"];
+export type ArtifactFormat = (typeof artifactFormats)[number];
+/** The URL a `url` artifact holds: one http or https address on `localhost` or `127.0.0.1`, with no credentials, or `undefined`. */
+export declare function localUrl(content: string): string | undefined;
+/** What a format left out is: `html` for a page that starts like one, `url` for a lone local address, else `markdown`. */
+export declare function detectFormat(content: string): ArtifactFormat;
+/** The content to store for `format`: a `url` artifact's address, trimmed, or a Problem to throw when it isn't one. */
+export declare function contentFor(format: ArtifactFormat, content: string): string;
+//# sourceMappingURL=artifact-format.d.ts.map

package/dist/artifacts/artifact-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-format.d.ts","sourceRoot":"","sources":["../../src/artifacts/artifact-format.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,sCAAuC,CAAC;AAEpE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAM9D,oIAAoI;AACpI,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM5D;AAED,0HAA0H;AAC1H,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAG5D;AAED,uHAAuH;AACvH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK1E"}

package/dist/artifacts/artifact-format.js

@@ -0,0 +1,32 @@
+import { invalid } from "../problems.js";
+// The formats of an artifact (plan 08 §8.5, ADR 0009, 215 and 216): Markdown, an HTML page, or the URL of a page running on
+// this machine. A format the agent leaves out is read from the content.
+export const artifactFormats = ['markdown', 'html', 'url'];
+const htmlStart = /^\s*(?:<!doctype\s+html|<html[\s>])/i;
+const localHosts = new Set(['localhost', '127.0.0.1']);
+const urlLimit = 2048;
+/** The URL a `url` artifact holds: one http or https address on `localhost` or `127.0.0.1`, with no credentials, or `undefined`. */
+export function localUrl(content) {
+    const text = content.trim();
+    if (text === '' || text.length > urlLimit || /\s/.test(text) || !URL.canParse(text))
+        return undefined;
+    const url = new URL(text);
+    const local = (url.protocol === 'http:' || url.protocol === 'https:') && localHosts.has(url.hostname) && url.username === '' && url.password === '';
+    return local ? text : undefined;
+}
+/** What a format left out is: `html` for a page that starts like one, `url` for a lone local address, else `markdown`. */
+export function detectFormat(content) {
+    if (htmlStart.test(content))
+        return 'html';
+    return localUrl(content) === undefined ? 'markdown' : 'url';
+}
+/** The content to store for `format`: a `url` artifact's address, trimmed, or a Problem to throw when it isn't one. */
+export function contentFor(format, content) {
+    if (format !== 'url')
+        return content;
+    const url = localUrl(content);
+    if (url === undefined)
+        throw invalid('A url artifact holds one http or https address on localhost or 127.0.0.1, with no credentials, such as http://localhost:8080.');
+    return url;
+}
+//# sourceMappingURL=artifact-format.js.map

package/dist/artifacts/artifact-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-format.js","sourceRoot":"","sources":["../../src/artifacts/artifact-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,4HAA4H;AAC5H,wEAAwE;AAExE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC;AAIpE,MAAM,SAAS,GAAG,sCAAsC,CAAC;AACzD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AACvD,MAAM,QAAQ,GAAG,IAAI,CAAC;AAEtB,oIAAoI;AACpI,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACtG,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC;IACpJ,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAClC,CAAC;AAED,0HAA0H;AAC1H,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9D,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,UAAU,CAAC,MAAsB,EAAE,OAAe;IAChE,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,OAAO,CAAC;IACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC,+HAA+H,CAAC,CAAC;IACtK,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/artifacts/artifact-records.d.ts

@@ -0,0 +1,12 @@
+import type { SessionDoc } from '../schemas/records.ts';
+/** The bytes of content one artifact holds at most. */
+export declare const artifactContentLimit = 65536;
+/** The artifacts one chat holds at most. */
+export declare const artifactCountLimit = 20;
+/** The chat an artifact belongs to: the session's own id, or its parent's for a subagent. */
+export declare function chatIdOf(session: Pick<SessionDoc, 'parentId'> & {
+    id: string;
+}): string;
+/** Fails `TOO_LARGE` when an artifact's content passes the limit. */
+export declare function assertWithinLimit(id: string, content: string): void;
+//# sourceMappingURL=artifact-records.d.ts.map

package/dist/artifacts/artifact-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-records.d.ts","sourceRoot":"","sources":["../../src/artifacts/artifact-records.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEvF;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEnE"}

package/dist/artifacts/artifact-records.js

@@ -0,0 +1,17 @@
+import { tooLarge } from "../problems.js";
+// The `artifact` connector's store (plan 08 §8.5, ADR 0009, 173 to 176): an artifact belongs to its chat, so a
+// subagent's belongs to the chat at its root. Depth is 1, so the parent is the chat itself.
+/** The bytes of content one artifact holds at most. */
+export const artifactContentLimit = 65536;
+/** The artifacts one chat holds at most. */
+export const artifactCountLimit = 20;
+/** The chat an artifact belongs to: the session's own id, or its parent's for a subagent. */
+export function chatIdOf(session) {
+    return session.parentId ?? session.id;
+}
+/** Fails `TOO_LARGE` when an artifact's content passes the limit. */
+export function assertWithinLimit(id, content) {
+    if (Buffer.byteLength(content) > artifactContentLimit)
+        throw tooLarge(`The artifact ${id} is over ${artifactContentLimit} bytes.`, artifactContentLimit);
+}
+//# sourceMappingURL=artifact-records.js.map

package/dist/artifacts/artifact-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-records.js","sourceRoot":"","sources":["../../src/artifacts/artifact-records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,+GAA+G;AAC/G,4FAA4F;AAE5F,uDAAuD;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,6FAA6F;AAC7F,MAAM,UAAU,QAAQ,CAAC,OAAsD;IAC7E,OAAO,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,iBAAiB,CAAC,EAAU,EAAE,OAAe;IAC3D,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,oBAAoB;QAAE,MAAM,QAAQ,CAAC,gBAAgB,EAAE,YAAY,oBAAoB,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAC3J,CAAC"}

package/dist/artifacts/register-artifacts.d.ts

@@ -0,0 +1,3 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function registerArtifacts(ctx: Ctx): void;
+//# sourceMappingURL=register-artifacts.d.ts.map

package/dist/artifacts/register-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-artifacts.d.ts","sourceRoot":"","sources":["../../src/artifacts/register-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAYzC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAyBhD"}

package/dist/artifacts/register-artifacts.js

@@ -0,0 +1,37 @@
+import { z } from '@kvman/sdk';
+import { notFound } from "../problems.js";
+import { findSession } from "../sessions/session-lookup.js";
+import { records } from "../store/collections.js";
+import { artifactFormats } from "./artifact-format.js";
+import { chatIdOf } from "./artifact-records.js";
+// The person's view of a chat's artifacts (plan 08 §8.6, ADR 0009, 176): list and read. Only the agent writes, and a
+// subagent session answers with the artifacts of the chat at its root.
+const formatSchema = z.enum(artifactFormats);
+export function registerArtifacts(ctx) {
+    ctx.registerQuery('kvcoder.artifact.list', {
+        description: 'Lists the artifacts of a chat, newest change first.',
+        input: z.object({ sessionId: z.string() }),
+        output: z.array(z.object({ id: z.string(), title: z.string(), format: formatSchema, version: z.number().int(), size: z.number().int(), updatedAt: z.string() })),
+        public: true,
+        handle: async ({ sessionId }) => {
+            const chatId = chatIdOf(await findSession(ctx, sessionId));
+            return (await records(ctx.store).artifacts.find({ sessionId: chatId }, { limit: 1000 }))
+                .sort((first, second) => second.updatedAt.localeCompare(first.updatedAt) || first.artifactId.localeCompare(second.artifactId))
+                .map((doc) => ({ id: doc.artifactId, title: doc.title, format: doc.format, version: doc.version, size: Buffer.byteLength(doc.content), updatedAt: doc.updatedAt }));
+        },
+    });
+    ctx.registerQuery('kvcoder.artifact.get', {
+        description: 'Gives one artifact of a chat with its content.',
+        input: z.object({ sessionId: z.string(), id: z.string().min(1) }),
+        output: z.object({ id: z.string(), title: z.string(), format: formatSchema, version: z.number().int(), content: z.string(), createdAt: z.string(), updatedAt: z.string() }),
+        public: true,
+        handle: async ({ sessionId, id }) => {
+            const chatId = chatIdOf(await findSession(ctx, sessionId));
+            const found = (await records(ctx.store).artifacts.find({ sessionId: chatId, artifactId: id }, { limit: 1 }))[0];
+            if (found === undefined)
+                throw notFound(`The artifact ${id} doesn't exist.`, { id });
+            return { id: found.artifactId, title: found.title, format: found.format, version: found.version, content: found.content, createdAt: found.createdAt, updatedAt: found.updatedAt };
+        },
+    });
+}
+//# sourceMappingURL=register-artifacts.js.map

package/dist/artifacts/register-artifacts.js.map

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

package/dist/calls/binary-checks.d.ts

@@ -0,0 +1,8 @@
+import type { Ctx } from '@kvman/sdk';
+import type { ConnectorRow } from '../registry/register-connectors.ts';
+import type { ShellCommand } from './shell-command.ts';
+export declare function runBinaryChecks(ctx: Ctx, shell: ShellCommand, connectors: readonly ConnectorRow[]): Promise<{
+    name: string;
+    passed: boolean;
+}[]>;
+//# sourceMappingURL=binary-checks.d.ts.map

package/dist/calls/binary-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-checks.d.ts","sourceRoot":"","sources":["../../src/calls/binary-checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAAE,CAAC,CAQtJ"}

package/dist/calls/binary-checks.js

@@ -0,0 +1,12 @@
+import { runShell } from "./run-shell.js";
+// Binary checks (plan 08 §8.4, ADR 0009, 101): at a session's first step, each binary connector's `check` runs in the
+// real shell, without approval, for at most 5 s; exit 0 passes.
+const checkTimeoutMs = 5_000;
+export async function runBinaryChecks(ctx, shell, connectors) {
+    const binaries = connectors.flatMap((connector) => (connector.binary === undefined ? [] : [{ name: connector.name, check: connector.binary.check }]));
+    return Promise.all(binaries.map(async ({ name, check }) => {
+        const run = await runShell(shell, check, ctx.job.workspace.path, checkTimeoutMs, ctx.job.signal);
+        return { name, passed: run.exitCode === 0 && !run.timedOut };
+    }));
+}
+//# sourceMappingURL=binary-checks.js.map

package/dist/calls/binary-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-checks.js","sourceRoot":"","sources":["../../src/calls/binary-checks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,sHAAsH;AACtH,gEAAgE;AAEhE,MAAM,cAAc,GAAG,KAAK,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAQ,EAAE,KAAmB,EAAE,UAAmC;IACtG,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACtJ,OAAO,OAAO,CAAC,GAAG,CAChB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC/D,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/calls/connector-help.d.ts

@@ -0,0 +1,3 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function registerConnectorHelp(ctx: Ctx): void;
+//# sourceMappingURL=connector-help.d.ts.map

package/dist/calls/connector-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-help.d.ts","sourceRoot":"","sources":["../../src/calls/connector-help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAkEzC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAOpD"}