@kvman/kvcoder 0.1.0

package/dist/schemas/records.js.map

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

package/dist/schemas/registry.d.ts

@@ -0,0 +1,160 @@
+import { z } from '@kvman/sdk';
+export declare const kebab: RegExp;
+/** A connector or connector command name: lowercase kebab case (ADR 0009, 100). */
+export declare const wordSchema: z.ZodString;
+/** A binary connector: a program the agent runs in the real shell; `help` is the line that prints its help, when that isn't `--help`. */
+export declare const binarySchema: z.ZodObject<{
+    check: z.ZodString;
+    install: z.ZodExactOptional<z.ZodString>;
+    help: z.ZodExactOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const exampleSchema: z.ZodObject<{
+    description: z.ZodString;
+    input: z.ZodJSONSchema;
+}, z.core.$strip>;
+/** A commands connector's command: its name, the registering extension's public command, and examples. `asks: true` makes the person approve each call first (ADR 0022, 5). `help` is every connector's own. */
+export declare const connectorCommandSchema: z.ZodObject<{
+    name: z.ZodString;
+    command: z.ZodString;
+    examples: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        input: z.ZodJSONSchema;
+    }, z.core.$strip>>>;
+    asks: z.ZodExactOptional<z.ZodLiteral<true>>;
+}, z.core.$strip>;
+/** One connector as an extension registers it: its own commands, or a program. */
+export declare const connectorSchema: z.ZodUnion<readonly [z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    commands: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        examples: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+            input: z.ZodJSONSchema;
+        }, z.core.$strip>>>;
+        asks: z.ZodExactOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    binary: z.ZodObject<{
+        check: z.ZodString;
+        install: z.ZodExactOptional<z.ZodString>;
+        help: z.ZodExactOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strict>]>;
+/** What `kvcoder.connector.register` takes: one connector, or several that are registered together or not at all (ADR 0011, 26). */
+export declare const connectorRegisterSchema: z.ZodUnion<readonly [z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    commands: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        examples: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+            input: z.ZodJSONSchema;
+        }, z.core.$strip>>>;
+        asks: z.ZodExactOptional<z.ZodLiteral<true>>;
+    }, z.core.$strip>>;
+}, z.core.$strict>, z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    binary: z.ZodObject<{
+        check: z.ZodString;
+        install: z.ZodExactOptional<z.ZodString>;
+        help: z.ZodExactOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strict>, z.ZodObject<{
+    connectors: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        commands: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            command: z.ZodString;
+            examples: z.ZodExactOptional<z.ZodArray<z.ZodObject<{
+                description: z.ZodString;
+                input: z.ZodJSONSchema;
+            }, z.core.$strip>>>;
+            asks: z.ZodExactOptional<z.ZodLiteral<true>>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        binary: z.ZodObject<{
+            check: z.ZodString;
+            install: z.ZodExactOptional<z.ZodString>;
+            help: z.ZodExactOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, z.core.$strict>]>>;
+}, z.core.$strict>]>;
+/** A binary connector from the `kvcoder.connectors` setting. */
+export declare const binaryConnectorSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    binary: z.ZodObject<{
+        check: z.ZodString;
+        install: z.ZodExactOptional<z.ZodString>;
+        help: z.ZodExactOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const connectorDocSchema: z.ZodObject<{
+    owner: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    kind: z.ZodEnum<{
+        commands: "commands";
+        binary: "binary";
+    }>;
+    commands: z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        examples: z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+            input: z.ZodJSONSchema;
+        }, z.core.$strip>>;
+        asks: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    binary: z.ZodNullable<z.ZodObject<{
+        check: z.ZodString;
+        install: z.ZodNullable<z.ZodString>;
+        help: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** The session points (plan 08 §8.4). */
+export declare const sessionPointSchema: z.ZodEnum<{
+    "kvcoder.session.created": "kvcoder.session.created";
+    "kvcoder.session.deleted": "kvcoder.session.deleted";
+    "kvcoder.session.forked": "kvcoder.session.forked";
+    "kvcoder.turn.started": "kvcoder.turn.started";
+    "kvcoder.turn.ended": "kvcoder.turn.ended";
+    "kvcoder.session.waiting": "kvcoder.session.waiting";
+}>;
+export declare const handlerDocSchema: z.ZodObject<{
+    owner: z.ZodString;
+    point: z.ZodEnum<{
+        "kvcoder.session.created": "kvcoder.session.created";
+        "kvcoder.session.deleted": "kvcoder.session.deleted";
+        "kvcoder.session.forked": "kvcoder.session.forked";
+        "kvcoder.turn.started": "kvcoder.turn.started";
+        "kvcoder.turn.ended": "kvcoder.turn.ended";
+        "kvcoder.session.waiting": "kvcoder.session.waiting";
+    }>;
+    command: z.ZodString;
+}, z.core.$strip>;
+export declare const handlerJobDocSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    at: z.ZodNumber;
+}, z.core.$strip>;
+export declare const sectionDocSchema: z.ZodObject<{
+    owner: z.ZodString;
+    sectionId: z.ZodString;
+    title: z.ZodString;
+    order: z.ZodNumber;
+    content: z.ZodString;
+    sessionId: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ConnectorDoc = z.output<typeof connectorDocSchema>;
+export type SectionDoc = z.output<typeof sectionDocSchema>;
+export type SessionPoint = z.output<typeof sessionPointSchema>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/schemas/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAI/B,eAAO,MAAM,KAAK,QAAkC,CAAC;AAErD,mFAAmF;AACnF,eAAO,MAAM,UAAU,aAAmF,CAAC;AAE3G,yIAAyI;AACzI,eAAO,MAAM,YAAY;;;;iBAA8H,CAAC;AAExJ,eAAO,MAAM,aAAa;;;iBAAgE,CAAC;AAE3F,gNAAgN;AAChN,eAAO,MAAM,sBAAsB;;;;;;;;iBAKjC,CAAC;AAKH,kFAAkF;AAClF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;oBAA6D,CAAC;AAE1F,oIAAoI;AACpI,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAA8H,CAAC;AAEnK,gEAAgE;AAChE,eAAO,MAAM,qBAAqB;;;;;;;;iBAAuF,CAAC;AAE1H,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;iBAO7B,CAAC;AAEH,yCAAyC;AACzC,eAAO,MAAM,kBAAkB;;;;;;;EAAoK,CAAC;AAEpM,eAAO,MAAM,gBAAgB;;;;;;;;;;;iBAAkF,CAAC;AAEhH,eAAO,MAAM,mBAAmB;;;iBAAkD,CAAC;AAEnF,eAAO,MAAM,gBAAgB;;;;;;;iBAAsJ,CAAC;AAEpL,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schemas/registry.js

@@ -0,0 +1,37 @@
+import { z } from '@kvman/sdk';
+// What other extensions register with kvcoder (plan 08 §8.4), kept in its own store.
+export const kebab = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+/** A connector or connector command name: lowercase kebab case (ADR 0009, 100). */
+export const wordSchema = z.string().regex(kebab, 'Use lowercase kebab case, such as todo or open-items.');
+/** A binary connector: a program the agent runs in the real shell; `help` is the line that prints its help, when that isn't `--help`. */
+export const binarySchema = z.object({ check: z.string().min(1), install: z.string().min(1).exactOptional(), help: z.string().min(1).exactOptional() });
+export const exampleSchema = z.object({ description: z.string().min(1), input: z.json() });
+/** A commands connector's command: its name, the registering extension's public command, and examples. `asks: true` makes the person approve each call first (ADR 0022, 5). `help` is every connector's own. */
+export const connectorCommandSchema = z.object({
+    name: wordSchema.refine((name) => name !== 'help', "help is every connector's own command; name this one differently."),
+    command: z.string().min(1),
+    examples: z.array(exampleSchema).exactOptional(),
+    asks: z.literal(true, 'asks takes only true; leave it out for a command that runs at once.').exactOptional(),
+});
+const commandsConnectorSchema = z.strictObject({ name: wordSchema, description: z.string().min(1), commands: z.array(connectorCommandSchema).min(1) });
+const programConnectorSchema = z.strictObject({ name: wordSchema, description: z.string().min(1), binary: binarySchema });
+/** One connector as an extension registers it: its own commands, or a program. */
+export const connectorSchema = z.union([commandsConnectorSchema, programConnectorSchema]);
+/** What `kvcoder.connector.register` takes: one connector, or several that are registered together or not at all (ADR 0011, 26). */
+export const connectorRegisterSchema = z.union([commandsConnectorSchema, programConnectorSchema, z.strictObject({ connectors: z.array(connectorSchema).min(1) })]);
+/** A binary connector from the `kvcoder.connectors` setting. */
+export const binaryConnectorSchema = z.object({ name: wordSchema, description: z.string().min(1), binary: binarySchema });
+export const connectorDocSchema = z.object({
+    owner: z.string(),
+    name: z.string(),
+    description: z.string(),
+    kind: z.enum(['commands', 'binary']),
+    commands: z.array(z.object({ name: z.string(), command: z.string(), examples: z.array(exampleSchema), asks: z.boolean().default(false) })).nullable(),
+    binary: z.object({ check: z.string(), install: z.string().nullable(), help: z.string().nullable().default(null) }).nullable(),
+});
+/** The session points (plan 08 §8.4). */
+export const sessionPointSchema = z.enum(['kvcoder.session.created', 'kvcoder.session.deleted', 'kvcoder.session.forked', 'kvcoder.turn.started', 'kvcoder.turn.ended', 'kvcoder.session.waiting']);
+export const handlerDocSchema = z.object({ owner: z.string(), point: sessionPointSchema, command: z.string() });
+export const handlerJobDocSchema = z.object({ jobId: z.string(), at: z.number() });
+export const sectionDocSchema = z.object({ owner: z.string(), sectionId: z.string(), title: z.string(), order: z.number(), content: z.string(), sessionId: z.string().nullable() });
+//# sourceMappingURL=registry.js.map

package/dist/schemas/registry.js.map

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

package/dist/sessions/new-session.d.ts

@@ -0,0 +1,6 @@
+import { type Ctx, type Stored } from '@kvman/sdk';
+import type { SessionDoc, Title } from '../schemas/records.ts';
+export declare function newSession(ctx: Ctx, title: Title | undefined): Promise<Stored<SessionDoc>>;
+/** Deletes a session's records, and its subagent sessions' (plan 08 §8.1). */
+export declare function deleteSessionTree(ctx: Ctx, sessionId: string): Promise<void>;
+//# sourceMappingURL=new-session.d.ts.map

package/dist/sessions/new-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-session.d.ts","sourceRoot":"","sources":["../../src/sessions/new-session.ts"],"names":[],"mappings":"AACA,OAAO,EAAK,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAItD,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAQ/D,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAyBhG;AAED,8EAA8E;AAC9E,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlF"}

package/dist/sessions/new-session.js

@@ -0,0 +1,52 @@
+import { dropRuns } from "../delegate/runs.js";
+import { z } from '@kvman/sdk';
+import { dropProcesses } from "../jobs/process-run.js";
+import { firePoint } from "../registry/session-points.js";
+import { settingSchemas } from "../register-settings.js";
+import { records } from "../store/collections.js";
+import { noUsage } from "../turns/history.js";
+import { now } from "./session-lookup.js";
+// A new top-level session (plan 08 §8.1): `kvcoder.model` (or `kvai.defaultModel`) and `kvcoder.thinking`. Creating one
+// schedules the daily retention job, keyed so it never piles up (ADR 0009, 103).
+export async function newSession(ctx, title) {
+    const model = settingSchemas.model.parse(await ctx.settings.get('kvcoder.model')) ?? z.string().nullable().parse(await ctx.settings.get('kvai.defaultModel'));
+    const stamp = now();
+    const session = await records(ctx.store).sessions.insert({
+        title: title ?? '',
+        autoTitle: title === undefined,
+        status: 'idle',
+        parentId: null,
+        worker: null,
+        model,
+        thinking: settingSchemas.thinking.parse(await ctx.settings.get('kvcoder.thinking')),
+        stepJobId: null,
+        turnId: null,
+        endedTurns: 0,
+        nextSeq: 0,
+        usage: noUsage(),
+        durationMs: 0,
+        checks: null,
+        connectors: null,
+        createdAt: stamp,
+        updatedAt: stamp,
+    });
+    await ctx.schedule('kvcoder.session.prune', {}, { cron: '0 3 * * *', key: 'session-prune' });
+    await firePoint(ctx, 'kvcoder.session.created', { sessionId: session.id });
+    return session;
+}
+/** Deletes a session's records, and its subagent sessions' (plan 08 §8.1). */
+export async function deleteSessionTree(ctx, sessionId) {
+    const store = records(ctx.store);
+    await dropProcesses(ctx, sessionId);
+    await dropRuns(ctx, sessionId);
+    for (const child of await store.sessions.find({ parentId: sessionId }, { limit: 1000 }))
+        await deleteSessionTree(ctx, child.id);
+    for (const collection of [store.messages, store.queued, store.turns, store.questions, store.background, store.sections, store.artifacts]) {
+        for (let found = await collection.find({ sessionId }, { limit: 1000 }); found.length > 0; found = await collection.find({ sessionId }, { limit: 1000 })) {
+            for (const document of found)
+                await collection.delete(document.id);
+        }
+    }
+    await store.sessions.delete(sessionId);
+}
+//# sourceMappingURL=new-session.js.map

package/dist/sessions/new-session.js.map

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

package/dist/sessions/register-fork-export.d.ts

@@ -0,0 +1,5 @@
+import { type Ctx } from '@kvman/sdk';
+/** An export file's name: the title with characters files can't hold replaced, or the id for a chat with no title. */
+export declare function exportName(title: string, sessionId: string): string;
+export declare function registerForkExport(ctx: Ctx): void;
+//# sourceMappingURL=register-fork-export.d.ts.map

package/dist/sessions/register-fork-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-fork-export.d.ts","sourceRoot":"","sources":["../../src/sessions/register-fork-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAa,MAAM,YAAY,CAAC;AAmBpD,sHAAsH;AACtH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAoCjD"}

package/dist/sessions/register-fork-export.js

@@ -0,0 +1,62 @@
+import { z } from '@kvman/sdk';
+import { firePoint } from "../registry/session-points.js";
+import { records, txRecords } from "../store/collections.js";
+import { messagesFrom } from "../turns/message-blocks.js";
+import { newSession } from "./new-session.js";
+import { ownSession } from "./session-lookup.js";
+import { messageView, sessionSchema, sessionView, turnView } from "./session-view.js";
+// Fork and export (plan 08 §8.6, ADR 0009, 103).
+async function sessionExport(ctx, sessionId) {
+    const store = records(ctx.store);
+    const session = await store.sessions.get(sessionId);
+    if (session === undefined)
+        return {};
+    const turns = (await store.turns.find({ sessionId }, { limit: 1000 })).map(turnView);
+    const messages = (await messagesFrom(ctx, sessionId, 0, session.nextSeq)).map(messageView);
+    return { session: sessionView(session), turns, messages };
+}
+/** An export file's name: the title with characters files can't hold replaced, or the id for a chat with no title. */
+export function exportName(title, sessionId) {
+    if (title === '')
+        return `${sessionId}.json`;
+    return `${title.replace(/[/\\:*?"<>|]/g, '-').slice(0, 100)}.json`;
+}
+export function registerForkExport(ctx) {
+    ctx.registerCommand('kvcoder.session.fork', {
+        description: "Copies a session's messages, and its summary, through a seq into a new session.",
+        input: z.object({ sessionId: z.string(), throughSeq: z.number().int().nonnegative().exactOptional() }),
+        output: sessionSchema,
+        public: true,
+        handle: async ({ sessionId, throughSeq }) => {
+            const source = await ownSession(ctx, sessionId);
+            const last = throughSeq ?? source.nextSeq - 1;
+            const copied = await messagesFrom(ctx, sessionId, 0, Math.min(last + 1, source.nextSeq));
+            const fork = await newSession(ctx, source.title === '' ? undefined : source.title);
+            const updated = await ctx.store.transaction((tx) => {
+                const store = txRecords(tx);
+                for (const { id: _id, ...message } of copied)
+                    store.messages.insert({ ...message, sessionId: fork.id, turnId: null });
+                return store.sessions.update(fork.id, { model: source.model, thinking: source.thinking, nextSeq: (copied.at(-1)?.seq ?? -1) + 1 });
+            });
+            await firePoint(ctx, 'kvcoder.session.forked', { fromSessionId: sessionId, toSessionId: fork.id, throughSeq: last });
+            return sessionView(updated);
+        },
+    });
+    ctx.registerCommand('kvcoder.session.export', {
+        description: 'Writes a session, its turns and messages, and its subagent sessions to a JSON file.',
+        input: z.object({ sessionId: z.string() }),
+        output: z.object({ fileId: z.string() }),
+        public: true,
+        handle: async ({ sessionId }) => {
+            const session = await ownSession(ctx, sessionId);
+            const children = await records(ctx.store).sessions.find({ parentId: sessionId }, { limit: 1000 });
+            const artifacts = (await records(ctx.store).artifacts.find({ sessionId }, { limit: 1000 }))
+                .sort((first, second) => first.createdAt.localeCompare(second.createdAt) || first.artifactId.localeCompare(second.artifactId))
+                .map((doc) => ({ id: doc.artifactId, title: doc.title, format: doc.format, version: doc.version, content: doc.content, createdAt: doc.createdAt, updatedAt: doc.updatedAt }));
+            const data = { ...(await sessionExport(ctx, sessionId)), artifacts, subagents: await Promise.all(children.map((child) => sessionExport(ctx, child.id))) };
+            const file = await ctx.files.write(exportName(session.title, sessionId), JSON.stringify(data, null, 2), 'application/json');
+            return { fileId: file.id };
+        },
+    });
+}
+//# sourceMappingURL=register-fork-export.js.map

package/dist/sessions/register-fork-export.js.map

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

package/dist/sessions/register-lifecycle.d.ts

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

package/dist/sessions/register-lifecycle.d.ts.map

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

package/dist/sessions/register-lifecycle.js

@@ -0,0 +1,59 @@
+import { ProblemError, z } from '@kvman/sdk';
+import { settingSchemas } from "../register-settings.js";
+import { records } from "../store/collections.js";
+import { messagesFrom } from "../turns/message-blocks.js";
+import { textOf } from "../turns/model-context.js";
+import { deleteSessionTree } from "./new-session.js";
+// A session's life around its turns (plan 08 §8.1): the title kvai writes after the first turn, and daily retention.
+const titler = 'Write a title of 3 to 6 words for the conversation below, in the language it is written in. Reply with the title only.';
+async function writeTitle(ctx, sessionId) {
+    const store = records(ctx.store);
+    const session = await store.sessions.get(sessionId);
+    if (session === undefined || !session.autoTitle)
+        return;
+    const opening = (await messagesFrom(ctx, sessionId, 0, Math.min(session.nextSeq, 20))).filter((message) => message.kind === 'user' || message.kind === 'assistant');
+    const transcript = opening.map((message) => `${message.kind === 'user' ? 'User' : 'Assistant'}: ${textOf(message.content['content'])}`).join('\n\n');
+    try {
+        const answer = await ctx.exec('kvai.complete', { ...(session.model === null ? {} : { model: session.model }), sessionId, systemPrompt: titler, messages: [{ role: 'user', content: transcript, timestamp: Date.now() }], maxTokens: 30 });
+        const title = textOf(answer.message.content).trim().replace(/^["'“”]+|["'“”.]+$/g, '').slice(0, 100);
+        const fresh = await store.sessions.get(sessionId);
+        if (title !== '' && fresh?.autoTitle === true)
+            await store.sessions.update(sessionId, { title, autoTitle: false });
+    }
+    catch (error) {
+        if (!(error instanceof ProblemError))
+            throw error;
+        ctx.log.info('A session title could not be written; the placeholder stays.', { code: error.problem.code });
+    }
+}
+async function prune(ctx) {
+    const keep = settingSchemas.keep.parse(await ctx.settings.get('kvcoder.sessions.keep'));
+    if (keep === 0)
+        return;
+    const sessions = await records(ctx.store).sessions.find({ parentId: null }, { limit: 1000, order: 'desc' });
+    for (const session of sessions.slice(keep))
+        if (session.status === 'idle')
+            await deleteSessionTree(ctx, session.id);
+}
+export function registerLifecycle(ctx) {
+    ctx.registerCommand('kvcoder.session.title', {
+        description: "Writes a session's title from its first turn.",
+        input: z.object({ sessionId: z.string() }),
+        output: z.object({}),
+        retries: 0,
+        handle: async ({ sessionId }) => {
+            await writeTitle(ctx, sessionId);
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.session.prune', {
+        description: 'Deletes the oldest idle top-level sessions beyond kvcoder.sessions.keep.',
+        input: z.object({}),
+        output: z.object({}),
+        handle: async () => {
+            await prune(ctx);
+            return {};
+        },
+    });
+}
+//# sourceMappingURL=register-lifecycle.js.map

package/dist/sessions/register-lifecycle.js.map

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

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

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

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

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

package/dist/sessions/register-sessions.js

@@ -0,0 +1,93 @@
+import { z } from '@kvman/sdk';
+import { sessionTools } from "../prompt/session-prompt.js";
+import { firePoint } from "../registry/session-points.js";
+import { readSettings } from "../register-settings.js";
+import { statusSchema, thinkingSchema } from "../schemas/records.js";
+import { records } from "../store/collections.js";
+import { cancelTurn } from "../turns/cancel-turn.js";
+import { compact } from "../turns/compaction.js";
+import { deleteSessionTree, newSession } from "./new-session.js";
+import { findSession, now, ownSession } from "./session-lookup.js";
+import { sessionSchema, sessionView } from "./session-view.js";
+// Sessions (plan 08 §8.6). A subagent session is for reading: commands that change one fail (ADR 0009, 102).
+const sessionIdSchema = z.object({ sessionId: z.string() });
+export function registerSessions(ctx) {
+    ctx.registerCommand('kvcoder.session.create', {
+        description: 'Creates a session in this workspace.',
+        input: z.object({ title: z.string().min(1).exactOptional() }),
+        output: sessionSchema,
+        public: true,
+        handle: async ({ title }) => sessionView(await newSession(ctx, title)),
+    });
+    ctx.registerQuery('kvcoder.session.list', {
+        description: "Lists this workspace's top-level sessions, newest first.",
+        input: z.object({ limit: z.number().int().positive().max(1000) }),
+        output: z.array(sessionSchema),
+        public: true,
+        handle: async ({ limit }) => (await records(ctx.store).sessions.find({ parentId: null }, { limit, order: 'desc' })).map(sessionView),
+    });
+    ctx.registerQuery('kvcoder.session.count', {
+        description: "Counts this workspace's top-level sessions, of one status or all.",
+        input: z.object({ status: statusSchema.exactOptional() }),
+        output: z.object({ count: z.number().int() }),
+        public: true,
+        handle: async ({ status }) => ({ count: await records(ctx.store).sessions.count(status === undefined ? { parentId: null } : { parentId: null, status }) }),
+    });
+    ctx.registerQuery('kvcoder.session.get', {
+        description: 'Gives a session.',
+        input: sessionIdSchema,
+        output: sessionSchema,
+        public: true,
+        handle: async ({ sessionId }) => sessionView(await findSession(ctx, sessionId)),
+    });
+    ctx.registerCommand('kvcoder.session.rename', {
+        description: 'Renames a session; kvcoder never retitles it after that.',
+        input: z.object({ sessionId: z.string(), title: z.string().min(1) }),
+        output: z.object({}),
+        public: true,
+        handle: async ({ sessionId, title }) => {
+            await ownSession(ctx, sessionId);
+            await records(ctx.store).sessions.update(sessionId, { title, autoTitle: false, updatedAt: now() });
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.session.configure', {
+        description: "Changes a session's model or thinking level, from its next step.",
+        input: z.object({ sessionId: z.string(), model: z.string().min(1).exactOptional(), thinking: thinkingSchema.exactOptional() }),
+        output: z.object({}),
+        public: true,
+        handle: async ({ sessionId, model, thinking }) => {
+            await ownSession(ctx, sessionId);
+            await records(ctx.store).sessions.update(sessionId, { ...(model === undefined ? {} : { model }), ...(thinking === undefined ? {} : { thinking }), updatedAt: now() });
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.session.delete', {
+        description: 'Deletes a session: cancels its turn and deletes its subagent sessions.',
+        input: sessionIdSchema,
+        output: z.object({}),
+        public: true,
+        handle: async ({ sessionId }) => {
+            await ownSession(ctx, sessionId);
+            await cancelTurn(ctx, sessionId, false);
+            await deleteSessionTree(ctx, sessionId);
+            await firePoint(ctx, 'kvcoder.session.deleted', { sessionId });
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.session.compact', {
+        description: "Summarizes a session's older messages now; the newest kvcoder.compactKeep stay whole. Says whether a summary was made.",
+        input: sessionIdSchema,
+        output: z.object({ summarized: z.boolean() }),
+        public: true,
+        handle: async ({ sessionId }) => {
+            const session = await ownSession(ctx, sessionId);
+            if (session.status === 'running')
+                throw ctx.problem('kvcoder/SESSION_BUSY', { sessionId });
+            const tools = await sessionTools(ctx, session);
+            const settings = await readSettings(ctx);
+            return { summarized: await compact(ctx, session, { force: true, compactAt: settings.compactAt, keep: settings.compactKeep, prompt: tools.built.prompt, turnId: null }) };
+        },
+    });
+}
+//# sourceMappingURL=register-sessions.js.map

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

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

package/dist/sessions/session-lookup.d.ts

@@ -0,0 +1,10 @@
+import { type Ctx, type Stored } from '@kvman/sdk';
+import type { SessionDoc } from '../schemas/records.ts';
+/** The current time as kvcoder's records keep it. */
+export declare const now: () => string;
+export declare function findSession(ctx: Ctx, sessionId: string): Promise<Stored<SessionDoc>>;
+/** A session a command may change: a subagent session is for reading only. */
+export declare function ownSession(ctx: Ctx, sessionId: string): Promise<Stored<SessionDoc>>;
+/** Fails `NOT_PUBLIC` unless the person called (ADR 0009, 105). */
+export declare function userOnly(ctx: Ctx, name: string): void;
+//# sourceMappingURL=session-lookup.d.ts.map

package/dist/sessions/session-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lookup.d.ts","sourceRoot":"","sources":["../../src/sessions/session-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD,qDAAqD;AACrD,eAAO,MAAM,GAAG,QAAO,MAAkC,CAAC;AAE1D,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAI1F;AAED,8EAA8E;AAC9E,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAMzF;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD"}

package/dist/sessions/session-lookup.js

@@ -0,0 +1,25 @@
+import { ProblemError } from '@kvman/sdk';
+import { records } from "../store/collections.js";
+// Finding a session of the job's workspace (ADR 0009, 92 and 102).
+/** The current time as kvcoder's records keep it. */
+export const now = () => new Date().toISOString();
+export async function findSession(ctx, sessionId) {
+    const session = await records(ctx.store).sessions.get(sessionId);
+    if (session === undefined)
+        throw ctx.problem('kvcoder/SESSION_NOT_FOUND', { sessionId });
+    return session;
+}
+/** A session a command may change: a subagent session is for reading only. */
+export async function ownSession(ctx, sessionId) {
+    const session = await findSession(ctx, sessionId);
+    if (session.parentId !== null) {
+        throw new ProblemError({ code: 'VALIDATION_FAILED', message: `The session ${sessionId} is a subagent's; it is read, cancelled, and deleted through its parent.`, params: { sessionId } });
+    }
+    return session;
+}
+/** Fails `NOT_PUBLIC` unless the person called (ADR 0009, 105). */
+export function userOnly(ctx, name) {
+    if (ctx.job.caller.kind !== 'user')
+        throw new ProblemError({ code: 'NOT_PUBLIC', message: `${name} is for the person only.`, params: { name } });
+}
+//# sourceMappingURL=session-lookup.js.map