@kvman/kvcoder 0.1.0

package/dist/register-settings.d.ts

@@ -0,0 +1,142 @@
+import { z, type Ctx } from '@kvman/sdk';
+export declare const settingSchemas: {
+    model: z.ZodNullable<z.ZodString>;
+    thinking: z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>;
+    maxSteps: z.ZodNumber;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    shellPath: z.ZodNullable<z.ZodString>;
+    compactAt: z.ZodNumber;
+    compactKeep: z.ZodNumber;
+    connectors: z.ZodArray<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>>;
+    disabledConnectors: z.ZodArray<z.ZodString>;
+    mcpServers: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodArray<z.ZodString>;
+        env: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        url: z.ZodString;
+        headers: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>]>>;
+    workers: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"subagent">;
+        connectors: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        model: z.ZodNullable<z.ZodString>;
+        thinking: z.ZodNullable<z.ZodEnum<{
+            off: "off";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        name: z.ZodString;
+        description: z.ZodString;
+        enabled: z.ZodBoolean;
+        instructions: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"opencode">;
+        model: z.ZodNullable<z.ZodString>;
+        agent: z.ZodNullable<z.ZodString>;
+        autoApprove: z.ZodBoolean;
+        approval: z.ZodEnum<{
+            ask: "ask";
+            auto: "auto";
+        }>;
+        timeoutMs: z.ZodNumber;
+        name: z.ZodString;
+        description: z.ZodString;
+        enabled: z.ZodBoolean;
+        instructions: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"pi">;
+        model: z.ZodNullable<z.ZodString>;
+        thinking: z.ZodNullable<z.ZodEnum<{
+            off: "off";
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+        }>>;
+        tools: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        approval: z.ZodEnum<{
+            ask: "ask";
+            auto: "auto";
+        }>;
+        timeoutMs: z.ZodNumber;
+        name: z.ZodString;
+        description: z.ZodString;
+        enabled: z.ZodBoolean;
+        instructions: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"claude">;
+        model: z.ZodNullable<z.ZodString>;
+        effort: z.ZodNullable<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+            max: "max";
+        }>>;
+        permissionMode: z.ZodEnum<{
+            auto: "auto";
+            bypassPermissions: "bypassPermissions";
+            dontAsk: "dontAsk";
+            acceptEdits: "acceptEdits";
+            plan: "plan";
+        }>;
+        approval: z.ZodEnum<{
+            ask: "ask";
+            auto: "auto";
+        }>;
+        timeoutMs: z.ZodNumber;
+        name: z.ZodString;
+        description: z.ZodString;
+        enabled: z.ZodBoolean;
+        instructions: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+    keep: z.ZodNumber;
+};
+export declare function registerSettings(ctx: Ctx): void;
+/** The names of the connectors that are turned off in the job's workspace (ADR 0014, 7). */
+export declare function disabledConnectors(ctx: Ctx): Promise<Set<string>>;
+/** The settings a step reads, parsed. */
+export declare function readSettings(ctx: Ctx): Promise<{
+    maxSteps: number;
+    approval: "ask" | "auto";
+    shellPath: string | null;
+    compactAt: number;
+    compactKeep: number;
+    connectors: {
+        name: string;
+        description: string;
+        binary: {
+            check: string;
+            install?: string;
+            help?: string;
+        };
+    }[];
+}>;
+export type StepSettings = Awaited<ReturnType<typeof readSettings>>;
+//# sourceMappingURL=register-settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-settings.d.ts","sourceRoot":"","sources":["../src/register-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAOzC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAa1B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAa/C;AAED,4FAA4F;AAC5F,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAEvE;AAED,yCAAyC;AACzC,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG;;;;;;;;;;;;;;;GAU1C;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC"}

package/dist/register-settings.js

@@ -0,0 +1,51 @@
+import { z } from '@kvman/sdk';
+import { shippedWorkers, workersSchema } from "./delegate/workers.js";
+import { mcpServersSchema } from "./mcp/servers.js";
+import { thinkingSchema } from "./schemas/records.js";
+import { binaryConnectorSchema, wordSchema } from "./schemas/registry.js";
+// kvcoder's settings (plan 08 §8.7).
+export const settingSchemas = {
+    model: z.string().min(1).nullable(),
+    thinking: thinkingSchema,
+    maxSteps: z.number().int().positive(),
+    approval: z.enum(['ask', 'auto']),
+    shellPath: z.string().min(1).nullable(),
+    compactAt: z.number().gt(0).max(1),
+    compactKeep: z.number().int().min(1).max(100),
+    connectors: z.array(binaryConnectorSchema),
+    disabledConnectors: z.array(wordSchema),
+    mcpServers: mcpServersSchema,
+    workers: workersSchema,
+    keep: z.number().int().nonnegative(),
+};
+export function registerSettings(ctx) {
+    ctx.registerSetting('kvcoder.model', { description: 'The model a new session starts with; null uses kvai.defaultModel.', schema: settingSchemas.model, default: null });
+    ctx.registerSetting('kvcoder.thinking', { description: 'How hard the model thinks in a new session.', schema: settingSchemas.thinking, default: 'medium' });
+    ctx.registerSetting('kvcoder.maxSteps', { description: 'The most steps a turn takes before it stops.', schema: settingSchemas.maxSteps, default: 50 });
+    ctx.registerSetting('kvcoder.shell.approval', { description: 'Whether shell and file calls ask the person first: only the ones the model marks risky (auto), or every one (ask).', schema: settingSchemas.approval, default: 'auto' });
+    ctx.registerSetting('kvcoder.shell.path', { description: 'The shell program to run; null finds bash, or pwsh then powershell.exe on Windows.', schema: settingSchemas.shellPath, default: null });
+    ctx.registerSetting('kvcoder.compactAt', { description: "The share of the model's context window above which older messages are summarized.", schema: settingSchemas.compactAt, default: 0.8 });
+    ctx.registerSetting('kvcoder.compactKeep', { description: 'How many of the newest messages stay whole when older messages are summarized.', schema: settingSchemas.compactKeep, default: 10 });
+    ctx.registerSetting('kvcoder.connectors', { description: 'Binary connectors to add: programs the agent runs in the real shell.', schema: settingSchemas.connectors, default: [] });
+    ctx.registerSetting('kvcoder.connectors.disabled', { description: 'The names of the connectors that are turned off: the agent neither sees nor calls them.', schema: settingSchemas.disabledConnectors, default: [] });
+    ctx.registerSetting('kvcoder.mcp.servers', { description: "The MCP servers the mcp connector reaches: a command or an address each, with the names of its secret variables or headers.", schema: settingSchemas.mcpServers, default: [] });
+    ctx.registerSetting('kvcoder.delegate.workers', { description: 'The workers the delegate connector hands tasks to: each with its instructions, connectors, model, and whether it is turned on.', schema: settingSchemas.workers, default: shippedWorkers });
+    ctx.registerSetting('kvcoder.sessions.keep', { description: 'How many top-level sessions to keep per workspace; 0 keeps every session.', schema: settingSchemas.keep, default: 0 });
+}
+/** The names of the connectors that are turned off in the job's workspace (ADR 0014, 7). */
+export async function disabledConnectors(ctx) {
+    return new Set(settingSchemas.disabledConnectors.parse(await ctx.settings.get('kvcoder.connectors.disabled')));
+}
+/** The settings a step reads, parsed. */
+export async function readSettings(ctx) {
+    const read = async (key, schema) => schema.parse(await ctx.settings.get(key));
+    return {
+        maxSteps: await read('kvcoder.maxSteps', settingSchemas.maxSteps),
+        approval: await read('kvcoder.shell.approval', settingSchemas.approval),
+        shellPath: await read('kvcoder.shell.path', settingSchemas.shellPath),
+        compactAt: await read('kvcoder.compactAt', settingSchemas.compactAt),
+        compactKeep: await read('kvcoder.compactKeep', settingSchemas.compactKeep),
+        connectors: await read('kvcoder.connectors', settingSchemas.connectors),
+    };
+}
+//# sourceMappingURL=register-settings.js.map

package/dist/register-settings.js.map

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

package/dist/registry/loaded.d.ts

@@ -0,0 +1,32 @@
+import { z, type Ctx } from '@kvman/sdk';
+declare const rowSchema: z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodEnum<{
+        command: "command";
+        query: "query";
+    }>;
+    extension: z.ZodString;
+    public: z.ZodBoolean;
+}, z.core.$strip>;
+export type Registrations = z.output<typeof rowSchema>[];
+/** Every command and query of the run, with its owner. */
+export declare function registrations(ctx: Ctx): Promise<Registrations>;
+/** Whether `command` is a public command of the extension `owner`. */
+export declare function ownsPublicCommand(rows: Registrations, owner: string, command: string): boolean;
+/** Whether `name` is a public command or query of the extension `owner`: what a connector command may run (ADR 0009, 129). */
+export declare function ownsPublicCall(rows: Registrations, owner: string, name: string): boolean;
+/** Those of `owners` that are loaded. An owner with no command or query isn't in the registrations, so only then is the list of extensions read. */
+export declare function loadedOwners(ctx: Ctx, owners: readonly string[]): Promise<Set<string>>;
+declare const callInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    input: z.ZodJSONSchema;
+    output: z.ZodJSONSchema;
+}, z.core.$strip>;
+export type CallInfo = z.output<typeof callInfoSchema>;
+/** Every command and query of the run with its schemas, as connector help reads them. */
+export declare function callInfos(ctx: Ctx): Promise<CallInfo[]>;
+/** The caller's package name; only an extension registers with kvcoder. */
+export declare function callerExtension(ctx: Ctx, what: string): string;
+export {};
+//# sourceMappingURL=loaded.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loaded.d.ts","sourceRoot":"","sources":["../../src/registry/loaded.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAOzC,QAAA,MAAM,SAAS;;;;;;;;iBAAiH,CAAC;AAEjI,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,SAAS,CAAC,EAAE,CAAC;AAEzD,0DAA0D;AAC1D,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,CAEpE;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE9F;AAED,8HAA8H;AAC9H,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAExF;AAID,oJAAoJ;AACpJ,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAK5F;AAED,QAAA,MAAM,cAAc;;;;;iBAA6F,CAAC;AAGlH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAEvD,yFAAyF;AACzF,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAE7D;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9D"}

package/dist/registry/loaded.js

@@ -0,0 +1,41 @@
+import { z } from '@kvman/sdk';
+import { invalid } from "../problems.js";
+// What the run has loaded. Who owns a name comes from `kernel.registrations.list`, which carries no schema
+// (ADR 0011, 25); the schemas of `help` and of an invalid payload come from `kernel.extensions.list`. Entries whose
+// owner isn't loaded are ignored (plan 08 §8.4).
+const rowSchema = z.object({ name: z.string(), kind: z.enum(['command', 'query']), extension: z.string(), public: z.boolean() });
+/** Every command and query of the run, with its owner. */
+export async function registrations(ctx) {
+    return z.array(rowSchema).parse(await ctx.exec('kernel.registrations.list', {}));
+}
+/** Whether `command` is a public command of the extension `owner`. */
+export function ownsPublicCommand(rows, owner, command) {
+    return rows.some((row) => row.name === command && row.extension === owner && row.kind === 'command' && row.public);
+}
+/** Whether `name` is a public command or query of the extension `owner`: what a connector command may run (ADR 0009, 129). */
+export function ownsPublicCall(rows, owner, name) {
+    return rows.some((row) => row.name === name && row.extension === owner && row.public);
+}
+const extensionNamesSchema = z.array(z.object({ name: z.string() }));
+/** Those of `owners` that are loaded. An owner with no command or query isn't in the registrations, so only then is the list of extensions read. */
+export async function loadedOwners(ctx, owners) {
+    const registered = new Set((await registrations(ctx)).map((row) => row.extension));
+    if (owners.every((owner) => registered.has(owner)))
+        return new Set(owners);
+    const loaded = new Set(extensionNamesSchema.parse(await ctx.exec('kernel.extensions.list', {})).map((extension) => extension.name));
+    return new Set(owners.filter((owner) => loaded.has(owner)));
+}
+const callInfoSchema = z.object({ name: z.string(), description: z.string(), input: z.json(), output: z.json() });
+const extensionCallsSchema = z.array(z.object({ commands: z.array(callInfoSchema), queries: z.array(callInfoSchema) }));
+/** Every command and query of the run with its schemas, as connector help reads them. */
+export async function callInfos(ctx) {
+    return extensionCallsSchema.parse(await ctx.exec('kernel.extensions.list', {})).flatMap((extension) => [...extension.commands, ...extension.queries]);
+}
+/** The caller's package name; only an extension registers with kvcoder. */
+export function callerExtension(ctx, what) {
+    const caller = ctx.job.caller;
+    if (caller.kind !== 'extension')
+        throw invalid(`Only an extension registers ${what}.`);
+    return caller.name;
+}
+//# sourceMappingURL=loaded.js.map

package/dist/registry/loaded.js.map

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

package/dist/registry/register-connectors.d.ts

@@ -0,0 +1,32 @@
+import { z, type Ctx } from '@kvman/sdk';
+declare const connectorRowSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    owner: z.ZodString;
+    kind: z.ZodEnum<{
+        commands: "commands";
+        binary: "binary";
+    }>;
+    commands: z.ZodExactOptional<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.ZodBoolean;
+    }, z.core.$strip>>>;
+    binary: z.ZodExactOptional<z.ZodObject<{
+        check: z.ZodString;
+        install: z.ZodExactOptional<z.ZodString>;
+        help: z.ZodExactOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ConnectorRow = z.output<typeof connectorRowSchema>;
+/** Every connector the agent may use: registered ones whose owner is loaded, then the setting's binary connectors. */
+export declare function activeConnectors(ctx: Ctx): Promise<ConnectorRow[]>;
+export declare function registerConnectors(ctx: Ctx): void;
+/** Clears the connectors at kvcoder's start; extensions register theirs again in their own handlers. */
+export declare function clearConnectors(ctx: Ctx): Promise<void>;
+export {};
+//# sourceMappingURL=register-connectors.d.ts.map

package/dist/registry/register-connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-connectors.d.ts","sourceRoot":"","sources":["../../src/registry/register-connectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAWzC,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;iBAOtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAa/D,sHAAsH;AACtH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAcxE;AAmCD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAmCjD;AAED,wGAAwG;AACxG,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7D"}

package/dist/registry/register-connectors.js

@@ -0,0 +1,126 @@
+import { z } from '@kvman/sdk';
+import { builtinConnectors } from "../connector-call.js";
+import { invalid } from "../problems.js";
+import { disabledConnectors, readSettings } from "../register-settings.js";
+import { connectorRegisterSchema, connectorSchema, exampleSchema } from "../schemas/registry.js";
+import { records, txRecords } from "../store/collections.js";
+import { callerExtension, loadedOwners, ownsPublicCall, registrations } from "./loaded.js";
+// Connectors (plan 08 §8.4): named sets of commands the agent runs with `run`, registered by other extensions, kept in
+// kvcoder's global store for one run, and owned by their registering extension.
+const connectorRowSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    owner: 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() })).exactOptional(),
+    binary: z.object({ check: z.string(), install: z.string().exactOptional(), help: z.string().exactOptional() }).exactOptional(),
+});
+function rowOf(doc) {
+    return {
+        name: doc.name,
+        description: doc.description,
+        owner: doc.owner,
+        kind: doc.kind,
+        ...(doc.commands === null ? {} : { commands: doc.commands }),
+        ...(doc.binary === null ? {} : { binary: { check: doc.binary.check, ...(doc.binary.install === null ? {} : { install: doc.binary.install }), ...(doc.binary.help === null ? {} : { help: doc.binary.help }) } }),
+    };
+}
+/** Every connector the agent may use: registered ones whose owner is loaded, then the setting's binary connectors. */
+export async function activeConnectors(ctx) {
+    const stored = await records(ctx.store).connectors.find({}, { limit: 1000 });
+    const loaded = await loadedOwners(ctx, stored.map((doc) => doc.owner));
+    const registered = stored.filter((doc) => loaded.has(doc.owner)).map(rowOf);
+    const names = new Set(registered.map((connector) => connector.name));
+    const fromSetting = [];
+    for (const entry of (await readSettings(ctx)).connectors) {
+        if (names.has(entry.name) || builtinConnectors.some((name) => name === entry.name)) {
+            ctx.log.warn('A binary connector from kvcoder.connectors has a registered name and is ignored.', { name: entry.name });
+            continue;
+        }
+        fromSetting.push({ name: entry.name, description: entry.description, owner: 'kvcoder.connectors', kind: 'binary', binary: entry.binary });
+    }
+    return [...registered, ...fromSetting];
+}
+const docOf = (input) => 'commands' in input
+    ? { name: input.name, description: input.description, kind: 'commands', commands: input.commands.map((command) => ({ name: command.name, command: command.command, examples: command.examples ?? [], asks: command.asks === true })), binary: null }
+    : { name: input.name, description: input.description, kind: 'binary', commands: null, binary: { check: input.binary.check, install: input.binary.install ?? null, help: input.binary.help ?? null } };
+// Every connector of a call is checked before any is stored, and they are stored in one transaction, so a call
+// registers all of its connectors or none (ADR 0011, 26).
+async function register(ctx, connectors) {
+    const owner = callerExtension(ctx, 'connectors');
+    const builtin = connectors.find((connector) => builtinConnectors.some((name) => name === connector.name));
+    if (builtin !== undefined)
+        throw ctx.problem('kvcoder/NAME_TAKEN', { name: builtin.name, owner: '@kvman/kvcoder' });
+    const repeated = connectors.find((connector, index) => connectors.findIndex((other) => other.name === connector.name) !== index);
+    if (repeated !== undefined)
+        throw invalid(`The connector ${repeated.name} is given twice.`, { name: repeated.name });
+    const commands = connectors.flatMap((connector) => ('commands' in connector ? connector.commands : []));
+    if (commands.length > 0) {
+        const rows = await registrations(ctx);
+        const foreign = commands.find((command) => !ownsPublicCall(rows, owner, command.command));
+        if (foreign !== undefined)
+            throw invalid(`${foreign.command} isn't a public command or query of ${owner}.`, { command: foreign.command });
+    }
+    const taken = await ctx.store.transaction((tx) => {
+        const stored = txRecords(tx).connectors;
+        const existing = connectors.map((connector) => stored.find({ name: connector.name }, { limit: 1 })[0]);
+        const other = existing.find((doc) => doc !== undefined && doc.owner !== owner);
+        if (other !== undefined)
+            return { name: other.name, owner: other.owner };
+        for (const doc of existing)
+            if (doc !== undefined)
+                stored.delete(doc.id);
+        for (const connector of connectors)
+            stored.insert({ ...docOf(connector), owner });
+        return undefined;
+    });
+    if (taken !== undefined)
+        throw ctx.problem('kvcoder/NAME_TAKEN', taken);
+}
+export function registerConnectors(ctx) {
+    ctx.registerCommand('kvcoder.connector.register', {
+        description: "Registers a connector the agent calls with its run tool, or several at once: the caller's public commands, or a program run in the shell.",
+        input: connectorRegisterSchema,
+        output: z.object({}),
+        public: true,
+        handle: async (input) => {
+            await register(ctx, 'connectors' in input ? input.connectors : [input]);
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.connector.unregister', {
+        description: "Removes one of the caller's connectors.",
+        input: z.object({ name: z.string().min(1) }),
+        output: z.object({}),
+        public: true,
+        handle: async ({ name }) => {
+            const owner = callerExtension(ctx, 'connectors');
+            const { connectors } = records(ctx.store);
+            const [existing] = await connectors.find({ name }, { limit: 1 });
+            if (existing !== undefined && existing.owner !== owner)
+                throw ctx.problem('kvcoder/NAME_TAKEN', { name, owner: existing.owner });
+            if (existing !== undefined)
+                await connectors.delete(existing.id);
+            return {};
+        },
+    });
+    ctx.registerQuery('kvcoder.connector.list', {
+        description: 'Lists the connectors the agent may use.',
+        input: z.object({}),
+        output: z.array(connectorRowSchema.extend({ enabled: z.boolean() })),
+        public: true,
+        handle: async () => {
+            const disabled = await disabledConnectors(ctx);
+            return (await activeConnectors(ctx)).map((connector) => ({ ...connector, enabled: !disabled.has(connector.name) }));
+        },
+    });
+}
+/** Clears the connectors at kvcoder's start; extensions register theirs again in their own handlers. */
+export async function clearConnectors(ctx) {
+    const { connectors } = records(ctx.store);
+    for (let found = await connectors.find({}, { limit: 1000 }); found.length > 0; found = await connectors.find({}, { limit: 1000 })) {
+        for (const connector of found)
+            await connectors.delete(connector.id);
+    }
+}
+//# sourceMappingURL=register-connectors.js.map

package/dist/registry/register-connectors.js.map

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

package/dist/registry/register-sections.d.ts

@@ -0,0 +1,18 @@
+import { type Ctx } from '@kvman/sdk';
+export declare const sectionLimit: number;
+export declare const sectionsLimit: number;
+/** A section as a prompt sees it. */
+export type Section = {
+    id: string;
+    title: string;
+    order: number;
+    owner: string;
+    global: boolean;
+    sessionId: string | null;
+    content: string;
+    size: number;
+};
+/** The sections a session's prompt reaches, by `order`, with entries of unloaded owners left out. */
+export declare function sectionsFor(ctx: Ctx, sessionId: string | null): Promise<Section[]>;
+export declare function registerSections(ctx: Ctx): void;
+//# sourceMappingURL=register-sections.d.ts.map

package/dist/registry/register-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-sections.d.ts","sourceRoot":"","sources":["../../src/registry/register-sections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAe,MAAM,YAAY,CAAC;AAUtD,eAAO,MAAM,YAAY,QAAY,CAAC;AACtC,eAAO,MAAM,aAAa,QAAY,CAAC;AAEvC,qCAAqC;AACrC,MAAM,MAAM,OAAO,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAQ5J,qGAAqG;AACrG,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAUxF;AA0BD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA+C/C"}

package/dist/registry/register-sections.js

@@ -0,0 +1,99 @@
+import { z } from '@kvman/sdk';
+import { invalid, tooLarge } from "../problems.js";
+import { findSession } from "../sessions/session-lookup.js";
+import { records, txRecords } from "../store/collections.js";
+import { callerExtension, loadedOwners } from "./loaded.js";
+// Sections (plan 08 §8.4, ADR 0009, 94): text in the system prompt, pushed by their owner. A global section is in every
+// workspace's prompts, a session's only in that session's, and any other in its workspace's. Ids belong to their owner.
+export const sectionLimit = 16 * 1024;
+export const sectionsLimit = 64 * 1024;
+const size = (content) => Buffer.byteLength(content, 'utf8');
+function sectionOf(doc, global) {
+    return { id: doc.sectionId, title: doc.title, order: doc.order, owner: doc.owner, global, sessionId: doc.sessionId, content: doc.content, size: size(doc.content) };
+}
+/** The sections a session's prompt reaches, by `order`, with entries of unloaded owners left out. */
+export async function sectionsFor(ctx, sessionId) {
+    const store = records(ctx.store);
+    const global = (await store.globalSections.find({}, { limit: 1000 })).map((doc) => sectionOf(doc, true));
+    const local = (await store.sections.find({ sessionId: null }, { limit: 1000 })).map((doc) => sectionOf(doc, false));
+    const own = sessionId === null ? [] : (await store.sections.find({ sessionId }, { limit: 1000 })).map((doc) => sectionOf(doc, false));
+    const sections = [...global, ...local, ...own];
+    const loaded = await loadedOwners(ctx, sections.map((section) => section.owner));
+    return sections
+        .filter((section) => loaded.has(section.owner))
+        .sort((first, second) => first.order - second.order || first.owner.localeCompare(second.owner) || first.id.localeCompare(second.id));
+}
+function collectionFor(tx, place) {
+    return place.global ? tx.globalSections : tx.sections;
+}
+function findOwn(tx, owner, id, place) {
+    return collectionFor(tx, place).find({ owner, sectionId: id, sessionId: place.sessionId }, { limit: 1 })[0];
+}
+// The sections that would share a prompt with one at `place`: global, the workspace's, and the session's (ADR 0009, 94).
+function sharedTotal(tx, place, replaced) {
+    const docs = [...tx.globalSections.find({}, { limit: 1000 }), ...tx.sections.find({ sessionId: null }, { limit: 1000 }), ...(place.sessionId === null ? [] : tx.sections.find({ sessionId: place.sessionId }, { limit: 1000 }))];
+    return docs.filter((doc) => doc.id !== replaced?.id).reduce((total, doc) => total + size(doc.content), 0);
+}
+const placeSchema = { global: z.boolean().exactOptional(), sessionId: z.string().min(1).exactOptional() };
+async function placeOf(ctx, input) {
+    if (input.global === true && input.sessionId !== undefined)
+        throw invalid('A section is global or a session\'s, not both.');
+    if (input.sessionId !== undefined)
+        await findSession(ctx, input.sessionId);
+    return { global: input.global === true, sessionId: input.sessionId ?? null };
+}
+export function registerSections(ctx) {
+    ctx.registerCommand('kvcoder.section.set', {
+        description: "Sets one of the caller's sections of the system prompt.",
+        input: z.object({ id: z.string().min(1), title: z.string().min(1), order: z.number(), content: z.string(), ...placeSchema }),
+        output: z.object({}),
+        public: true,
+        handle: async (input) => {
+            const owner = callerExtension(ctx, 'sections');
+            const place = await placeOf(ctx, input);
+            if (size(input.content) > sectionLimit)
+                throw tooLarge(`The section ${input.id} is over ${sectionLimit} bytes.`, sectionLimit);
+            await ctx.store.transaction((tx) => {
+                const store = txRecords(tx);
+                const existing = findOwn(store, owner, input.id, place);
+                if (sharedTotal(store, place, existing) + size(input.content) > sectionsLimit)
+                    throw tooLarge(`The sections of a prompt would pass ${sectionsLimit} bytes.`, sectionsLimit);
+                const doc = { owner, sectionId: input.id, title: input.title, order: input.order, content: input.content, sessionId: place.sessionId };
+                if (existing === undefined)
+                    collectionFor(store, place).insert(doc);
+                else
+                    collectionFor(store, place).update(existing.id, doc);
+            });
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.section.remove', {
+        description: "Removes one of the caller's sections; a missing one does nothing.",
+        input: z.object({ id: z.string().min(1), ...placeSchema }),
+        output: z.object({}),
+        public: true,
+        handle: async (input) => {
+            const owner = callerExtension(ctx, 'sections');
+            const place = await placeOf(ctx, input);
+            await ctx.store.transaction((tx) => {
+                const store = txRecords(tx);
+                const existing = findOwn(store, owner, input.id, place);
+                if (existing !== undefined)
+                    collectionFor(store, place).delete(existing.id);
+            });
+            return {};
+        },
+    });
+    ctx.registerQuery('kvcoder.section.list', {
+        description: "Lists the sections a session's prompt reaches, or the workspace's without a session.",
+        input: z.object({ sessionId: z.string().min(1).exactOptional() }),
+        output: z.array(z.object({ id: z.string(), title: z.string(), order: z.number(), owner: z.string(), global: z.boolean(), sessionId: z.string().exactOptional(), size: z.number() })),
+        public: true,
+        handle: async ({ sessionId }) => {
+            if (sessionId !== undefined)
+                await findSession(ctx, sessionId);
+            return (await sectionsFor(ctx, sessionId ?? null)).map(({ id, title, order, owner, global, sessionId: own, size: bytes }) => ({ id, title, order, owner, global, ...(own === null ? {} : { sessionId: own }), size: bytes }));
+        },
+    });
+}
+//# sourceMappingURL=register-sections.js.map

package/dist/registry/register-sections.js.map

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

package/dist/registry/session-points.d.ts

@@ -0,0 +1,11 @@
+import { type Ctx } from '@kvman/sdk';
+import type { JsonValue } from '../connector-call.ts';
+import { type SessionPoint } from '../schemas/registry.ts';
+/** Queues one job per handler registered for `point`, and remembers their ids. */
+export declare function firePoint(ctx: Ctx, point: SessionPoint, input: Record<string, JsonValue>): Promise<void>;
+/** Whether the running job descends from a handler job kvcoder queued. */
+export declare function fromSessionHandler(ctx: Ctx): Promise<boolean>;
+export declare function registerSessionPoints(ctx: Ctx): void;
+/** Clears the handlers at kvcoder's start, and forgets handler-job ids older than a week (ADR 0009, 103). */
+export declare function clearSessionPoints(ctx: Ctx): Promise<void>;
+//# sourceMappingURL=session-points.d.ts.map

package/dist/registry/session-points.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-points.d.ts","sourceRoot":"","sources":["../../src/registry/session-points.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAW/E,kFAAkF;AAClF,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9G;AAED,0EAA0E;AAC1E,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAgDpD;AAED,6GAA6G;AAC7G,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhE"}