@kvman/kvbuilder 0.2.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/kvbuilder
+
+The [kvman](https://github.com/ibndeif/kvman) extension that builds kvman from a chat: it develops extensions and presets, and manages the running app. It is bundled with kvman, and needs `@kvman/kvai` and `@kvman/kvcoder`.
+
+See [its guides](https://github.com/ibndeif/kvman/tree/main/extensions/kvbuilder/docs).
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,271 @@
+import type { KernelQueries } from '@kvman/sdk';
+type Empty = Record<string, never>;
+type Finding = {
+    file?: string;
+    message: string;
+    hint: string;
+};
+type Folder = {
+    folder: string;
+};
+type Guide = {
+    extension: string;
+    topic: string;
+    title: string;
+};
+type Page = {
+    topic: string;
+    title: string;
+    markdown: string;
+};
+type PreviewCall = {
+    name: string;
+    input?: Record<string, unknown>;
+};
+type PreviewAnswer = {
+    ok: true;
+    output: unknown;
+} | {
+    ok: false;
+    problem: {
+        code: string;
+        message: string;
+        params?: Record<string, unknown>;
+    };
+};
+type PreviewStatus = {
+    running: false;
+} | {
+    running: true;
+    url: string;
+    extensions: string[];
+    startedAt: string;
+};
+declare module '@kvman/sdk' {
+    interface Commands {
+        'kvbuilder.ext.new': {
+            input: {
+                name: string;
+                namespace: string;
+                folder: string;
+                web?: boolean;
+            };
+            output: {
+                folder: string;
+                name: string;
+                namespace: string;
+                web: boolean;
+            };
+        };
+        'kvbuilder.ext.check': {
+            input: Folder;
+            output: Finding[];
+        };
+        'kvbuilder.ext.test': {
+            input: Folder;
+            output: {
+                passed: boolean;
+                exitCode: number;
+                output: string;
+            };
+        };
+        'kvbuilder.preset.new': {
+            input: {
+                name: string;
+                file: string;
+            };
+            output: {
+                file: string;
+            };
+        };
+        'kvbuilder.preset.check': {
+            input: {
+                file: string;
+            };
+            output: {
+                file: string;
+                message: string;
+                hint: string;
+            }[];
+        };
+        'kvbuilder.preview.start': {
+            input: {
+                extensions: string[];
+                preset?: string;
+            };
+            output: {
+                url: string;
+            };
+        };
+        'kvbuilder.preview.stop': {
+            input: Empty;
+            output: Empty;
+        };
+        'kvbuilder.preview.command.run': {
+            input: PreviewCall;
+            output: PreviewAnswer;
+        };
+        'kvbuilder.app.model.set': {
+            input: {
+                model: string;
+            };
+            output: Empty;
+        };
+        'kvbuilder.app.settings.set': {
+            input: {
+                key: string;
+                value: unknown;
+                scope: 'global' | 'workspace';
+            };
+            output: Empty;
+        };
+        'kvbuilder.app.settings.reset': {
+            input: {
+                key: string;
+                scope: 'global' | 'workspace';
+            };
+            output: Empty;
+        };
+        'kvbuilder.app.extensions.install': {
+            input: {
+                source: string;
+            };
+            output: {
+                file: string;
+                restartRequired: true;
+            };
+        };
+        'kvbuilder.app.restart': {
+            input: Empty;
+            output: {
+                restarting: true;
+            };
+        };
+        'kvbuilder.build.start': {
+            input: {
+                sessionId: string;
+                argument: string;
+            };
+            output: Empty;
+        };
+        'kvbuilder.app.extensions.uninstall': {
+            input: {
+                name: string;
+            };
+            output: {
+                file: string;
+                restartRequired: true;
+            };
+        };
+    }
+    interface Queries {
+        'kvbuilder.ext.list': {
+            input: Empty;
+            output: {
+                folder: string;
+                name: string;
+                namespace: string;
+                version: string;
+            }[];
+        };
+        'kvbuilder.preview.status': {
+            input: Empty;
+            output: PreviewStatus;
+        };
+        'kvbuilder.preview.query.get': {
+            input: PreviewCall;
+            output: PreviewAnswer;
+        };
+        'kvbuilder.app.model.list': {
+            input: Empty;
+            output: {
+                id: string;
+                name: string;
+                provider: string;
+                isDefault: boolean;
+            }[];
+        };
+        'kvbuilder.app.settings.list': {
+            input: Empty;
+            output: {
+                key: string;
+                description: string;
+                scopes: ('global' | 'workspace')[];
+                value: unknown;
+                source: string;
+            }[];
+        };
+        'kvbuilder.app.extensions.list': {
+            input: Empty;
+            output: {
+                name: string;
+                version: string;
+                source: string;
+                namespace: string;
+                commands: string[];
+                queries: string[];
+                settings: string[];
+            }[];
+        };
+        'kvbuilder.app.preset.get': {
+            input: Empty;
+            output: {
+                name: string;
+                origin: 'bundled' | 'home' | 'file';
+                file?: string;
+                extensions: Record<string, string>;
+                settings?: Record<string, unknown>;
+            };
+        };
+        'kvbuilder.app.workspaces.list': KernelQueries['kernel.workspace.list'];
+        'kvbuilder.app.jobs.list': KernelQueries['kernel.jobs.list'];
+        'kvbuilder.app.jobs.get': KernelQueries['kernel.jobs.get'];
+        'kvbuilder.app.processes.list': KernelQueries['kernel.processes.list'];
+        'kvbuilder.app.health.get': KernelQueries['kernel.health.get'];
+        'kvbuilder.app.query.get': {
+            input: {
+                name: string;
+                input?: Record<string, unknown>;
+            };
+            output: unknown;
+        };
+        'kvbuilder.guides.list': {
+            input: Empty;
+            output: {
+                pages: Guide[];
+                problems: {
+                    extension: string;
+                    problem: {
+                        code: string;
+                        message: string;
+                        params?: Record<string, unknown>;
+                    };
+                }[];
+            };
+        };
+        'kvbuilder.guides.get': {
+            input: {
+                extension?: string;
+                topic: string;
+            };
+            output: Guide & {
+                markdown: string;
+            };
+        };
+        'kvbuilder.docs.list': {
+            input: Empty;
+            output: {
+                topic: string;
+                title: string;
+            }[];
+        };
+        'kvbuilder.docs.get': {
+            input: {
+                topic: string;
+            };
+            output: Page;
+        };
+    }
+}
+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/app/install-source.d.ts

@@ -0,0 +1,3 @@
+import type { InstallSource } from '@kvman/sdk';
+export declare function installSource(workspaceFolder: string, source: InstallSource): InstallSource;
+//# sourceMappingURL=install-source.d.ts.map

package/dist/app/install-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-source.d.ts","sourceRoot":"","sources":["../../src/app/install-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAShD,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,aAAa,CAG3F"}

package/dist/app/install-source.js

@@ -0,0 +1,11 @@
+import { projectAt } from "../folders.js";
+// The source `kvman extensions-install` sends (plan 09 §9.1, ADR 0022, 6, ADR 0025). The kernel resolves a `path:` folder
+// against the preset file, and a project the agent built is in the workspace, so the folder is resolved here against
+// the workspace folder, checked to be a project, and sent absolute. Other sources pass as they are.
+const pathPrefix = 'path:';
+export function installSource(workspaceFolder, source) {
+    if (!source.startsWith(pathPrefix))
+        return source;
+    return `${pathPrefix}${projectAt(workspaceFolder, source.slice(pathPrefix.length)).folder}`;
+}
+//# sourceMappingURL=install-source.js.map

package/dist/app/install-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-source.js","sourceRoot":"","sources":["../../src/app/install-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,0HAA0H;AAC1H,qHAAqH;AACrH,oGAAoG;AAEpG,MAAM,UAAU,GAAG,OAAO,CAAC;AAE3B,MAAM,UAAU,aAAa,CAAC,eAAuB,EAAE,MAAqB;IAC1E,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,MAAM,CAAC;IAClD,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AAC9F,CAAC"}

package/dist/app/register-app-reads.d.ts

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

package/dist/app/register-app-reads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-app-reads.d.ts","sourceRoot":"","sources":["../../src/app/register-app-reads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAK1D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA+B/C"}

package/dist/app/register-app-reads.js

@@ -0,0 +1,36 @@
+import { kernelQuerySchemas } from '@kvman/sdk';
+// The `kvman` connector's reads of the app's state (plan 09 §9.1, ADR 0022, 7): the open workspaces, the jobs of the
+// chat's workspace, the long-lived processes, and the app's health. Each wraps the kernel query of the same name.
+export function registerAppReads(ctx) {
+    ctx.registerQuery('kvbuilder.app.workspaces.list', {
+        description: 'Lists the open workspaces, Home first.',
+        public: true,
+        ...kernelQuerySchemas['kernel.workspace.list'],
+        handle: () => ctx.exec('kernel.workspace.list', {}),
+    });
+    ctx.registerQuery('kvbuilder.app.jobs.list', {
+        description: "Lists this workspace's async and scheduled jobs, newest first, with their status and, for a failed one, its Problem.",
+        public: true,
+        ...kernelQuerySchemas['kernel.jobs.list'],
+        handle: (input) => ctx.exec('kernel.jobs.list', input),
+    });
+    ctx.registerQuery('kvbuilder.app.jobs.get', {
+        description: 'Gives one job of any workspace by its id.',
+        public: true,
+        ...kernelQuerySchemas['kernel.jobs.get'],
+        handle: (input) => ctx.exec('kernel.jobs.get', input),
+    });
+    ctx.registerQuery('kvbuilder.app.processes.list', {
+        description: 'Lists the long-lived processes that extensions keep running.',
+        public: true,
+        ...kernelQuerySchemas['kernel.processes.list'],
+        handle: () => ctx.exec('kernel.processes.list', {}),
+    });
+    ctx.registerQuery('kvbuilder.app.health.get', {
+        description: "Gives kvman's version, preset, mode, pool size, uptime, and languages.",
+        public: true,
+        ...kernelQuerySchemas['kernel.health.get'],
+        handle: () => ctx.exec('kernel.health.get', {}),
+    });
+}
+//# sourceMappingURL=register-app-reads.js.map

package/dist/app/register-app-reads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-app-reads.js","sourceRoot":"","sources":["../../src/app/register-app-reads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAY,MAAM,YAAY,CAAC;AAE1D,qHAAqH;AACrH,kHAAkH;AAElH,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,GAAG,CAAC,aAAa,CAAC,+BAA+B,EAAE;QACjD,WAAW,EAAE,wCAAwC;QACrD,MAAM,EAAE,IAAI;QACZ,GAAG,kBAAkB,CAAC,uBAAuB,CAAC;QAC9C,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;KACpD,CAAC,CAAC;IACH,GAAG,CAAC,aAAa,CAAC,yBAAyB,EAAE;QAC3C,WAAW,EAAE,sHAAsH;QACnI,MAAM,EAAE,IAAI;QACZ,GAAG,kBAAkB,CAAC,kBAAkB,CAAC;QACzC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC;KACvD,CAAC,CAAC;IACH,GAAG,CAAC,aAAa,CAAC,wBAAwB,EAAE;QAC1C,WAAW,EAAE,2CAA2C;QACxD,MAAM,EAAE,IAAI;QACZ,GAAG,kBAAkB,CAAC,iBAAiB,CAAC;QACxC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC;KACtD,CAAC,CAAC;IACH,GAAG,CAAC,aAAa,CAAC,8BAA8B,EAAE;QAChD,WAAW,EAAE,8DAA8D;QAC3E,MAAM,EAAE,IAAI;QACZ,GAAG,kBAAkB,CAAC,uBAAuB,CAAC;QAC9C,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;KACpD,CAAC,CAAC;IACH,GAAG,CAAC,aAAa,CAAC,0BAA0B,EAAE;QAC5C,WAAW,EAAE,wEAAwE;QACrF,MAAM,EAAE,IAAI;QACZ,GAAG,kBAAkB,CAAC,mBAAmB,CAAC;QAC1C,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;KAChD,CAAC,CAAC;AACL,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-app.d.ts","sourceRoot":"","sources":["../../src/app/register-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8G,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAqClJ,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAiG1C"}

package/dist/app/register-app.js

@@ -0,0 +1,124 @@
+import { extensionSourceSchema, installSourceSchema, kernelCommandSchemas, kernelQuerySchemas, packageNameSchema, z } from '@kvman/sdk';
+import { invalid } from "../problems.js";
+import { installSource } from "./install-source.js";
+// The `kvman` connector's commands (plan 09 §9.1, ADR 0010, 6 and 8): the model, the settings, the extensions, and the
+// preset of the app the agent runs in. Each wraps a kernel command (or kvai's model list) and nothing here reads,
+// writes, or lists a secret (CLAUDE.md §6). A change to the extensions or the preset applies at the next start. The
+// commands that change the app are registered with kvcoder as ones the person approves first (ADR 0022, 5).
+const empty = z.object({});
+const callableModelSchema = z.object({ id: z.string(), name: z.string(), provider: z.string(), isDefault: z.boolean() });
+const extensionRowSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+    source: extensionSourceSchema,
+    namespace: z.string(),
+    commands: z.array(z.string()),
+    queries: z.array(z.string()),
+    settings: z.array(z.string()),
+});
+const editResultSchema = kernelCommandSchemas['kernel.extensions.install'].output;
+// The models that can be called now: those of a provider that is connected, and those of a custom provider.
+async function callableModels(ctx) {
+    const providers = await ctx.exec('kvai.provider.list', {});
+    const callable = new Set(providers.filter((provider) => provider.connection !== null || !provider.builtIn).map((provider) => provider.id));
+    const models = await ctx.exec('kvai.model.list', {});
+    return models
+        .filter((model) => callable.has(model.provider))
+        .map((model) => ({ id: model.id, name: model.name, provider: model.provider, isDefault: model.isDefault }))
+        .sort((left, right) => left.id.localeCompare(right.id));
+}
+export function registerApp(ctx) {
+    ctx.registerQuery('kvbuilder.app.model.list', {
+        description: 'Lists the models that can be called now: those of connected providers and of custom providers.',
+        public: true,
+        input: empty,
+        output: z.array(callableModelSchema),
+        handle: () => callableModels(ctx),
+    });
+    ctx.registerCommand('kvbuilder.app.model.set', {
+        description: 'Sets the default model, which must be one that model list shows.',
+        public: true,
+        retries: 0,
+        input: z.object({ model: z.string().min(1).describe('The full model id, such as anthropic/claude-sonnet-5-5.') }),
+        output: empty,
+        handle: async (input) => {
+            if (!(await callableModels(ctx)).some((model) => model.id === input.model)) {
+                throw invalid(`${input.model} isn't a model that can be called now; run model list to see the ones that can.`, { model: input.model });
+            }
+            await ctx.exec('kernel.settings.set', { key: 'kvai.defaultModel', value: input.model, scope: 'global' });
+            return {};
+        },
+    });
+    ctx.registerQuery('kvbuilder.app.settings.list', {
+        description: 'Lists every setting with its description, schema, scopes, value, and where the value comes from.',
+        public: true,
+        input: empty,
+        output: kernelQuerySchemas['kernel.settings.list'].output,
+        handle: () => ctx.exec('kernel.settings.list', {}),
+    });
+    ctx.registerCommand('kvbuilder.app.settings.set', {
+        description: 'Sets a setting, globally or for this workspace.',
+        public: true,
+        retries: 0,
+        input: kernelCommandSchemas['kernel.settings.set'].input,
+        output: empty,
+        handle: (input) => ctx.exec('kernel.settings.set', input),
+    });
+    ctx.registerCommand('kvbuilder.app.settings.reset', {
+        description: 'Resets a setting to the value it would have without this scope.',
+        public: true,
+        retries: 0,
+        input: kernelCommandSchemas['kernel.settings.reset'].input,
+        output: empty,
+        handle: (input) => ctx.exec('kernel.settings.reset', input),
+    });
+    ctx.registerQuery('kvbuilder.app.extensions.list', {
+        description: 'Lists the extensions that run now, with their version, source, and the names they register.',
+        public: true,
+        input: empty,
+        output: z.array(extensionRowSchema),
+        handle: async () => (await ctx.exec('kernel.extensions.list', {})).map((extension) => ({
+            name: extension.name,
+            version: extension.version,
+            source: extension.source,
+            namespace: extension.namespace,
+            commands: extension.commands.map((command) => command.name),
+            queries: extension.queries.map((query) => query.name),
+            settings: extension.settings.map((setting) => setting.key),
+        })),
+    });
+    ctx.registerCommand('kvbuilder.app.extensions.install', {
+        description: 'Adds an extension to the preset; it starts at the next start of kvman. A path: folder is a project of the workspace.',
+        public: true,
+        retries: 0,
+        input: z.strictObject({
+            source: installSourceSchema.describe('npm:<package name>@<exact version>, path:<a project folder, relative to the workspace folder>, or bundled:<package name> (only for a bundled extension).'),
+        }),
+        output: editResultSchema,
+        handle: (input) => ctx.exec('kernel.extensions.install', { source: installSource(ctx.job.workspace.path, input.source) }),
+    });
+    ctx.registerCommand('kvbuilder.app.restart', {
+        description: 'Restarts kvman: it stops running work and starts again with the preset as it is stored.',
+        public: true,
+        retries: 0,
+        input: empty,
+        output: z.object({ restarting: z.literal(true) }),
+        handle: () => ctx.exec('kernel.restart', {}),
+    });
+    ctx.registerCommand('kvbuilder.app.extensions.uninstall', {
+        description: 'Removes an extension from the preset; it stops at the next start of kvman.',
+        public: true,
+        retries: 0,
+        input: z.object({ name: packageNameSchema.describe('The extension package name.') }),
+        output: editResultSchema,
+        handle: (input) => ctx.exec('kernel.extensions.uninstall', input),
+    });
+    ctx.registerQuery('kvbuilder.app.preset.get', {
+        description: 'Gives the preset as stored now: its name, where it came from, its extensions, and its settings.',
+        public: true,
+        input: empty,
+        output: kernelQuerySchemas['kernel.preset.get'].output,
+        handle: () => ctx.exec('kernel.preset.get', {}),
+    });
+}
+//# sourceMappingURL=register-app.js.map

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

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

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

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

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

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

package/dist/build/register-build.js

@@ -0,0 +1,34 @@
+import { z } from '@kvman/sdk';
+import { docsConnector } from "../connectors/docs.js";
+import { extConnector } from "../connectors/ext.js";
+import { kvmanConnector } from "../connectors/kvman.js";
+import { presetConnector } from "../connectors/preset.js";
+import { previewConnector } from "../connectors/preview.js";
+import { readGuide } from "../docs/own-docs.js";
+// `/build-kvman` (plan 09 §9.4; ADR 0027, 12): the person starts building kvman in a chat; the agent never does. The
+// connectors are enabled first, so a session that kvcoder refuses leaves nothing behind.
+// kvbuilder's connectors, which a chat has only after `/build-kvman` ran in it.
+const connectorNames = [kvmanConnector, extConnector, presetConnector, previewConnector, docsConnector].map((connector) => connector.name);
+const owner = '@kvman/kvbuilder';
+export function registerBuild(ctx) {
+    ctx.registerCommand('kvbuilder.build.start', {
+        description: "Starts building kvman in one chat: gives the chat kvbuilder's connectors and its guide.",
+        public: true,
+        retries: 0,
+        input: z.object({
+            sessionId: z.string().min(1).describe('The chat to build kvman in.'),
+            argument: z.string().describe('The text after /build-kvman; the send box sends it as the message.'),
+        }),
+        output: z.object({}),
+        handle: async ({ sessionId }) => {
+            await ctx.exec('kvcoder.connector.enable', { sessionId, names: connectorNames });
+            const sections = await ctx.exec('kvcoder.section.list', { sessionId });
+            const started = sections.some((section) => section.id === 'guide' && section.owner === owner && section.sessionId === sessionId);
+            await ctx.exec('kvcoder.section.set', { id: 'guide', title: 'Building kvman', order: 20, sessionId, content: readGuide() });
+            if (!started)
+                await ctx.exec('kvcoder.note.add', { sessionId, key: 'kvbuilder.build.started' });
+            return {};
+        },
+    });
+}
+//# sourceMappingURL=register-build.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-build.js","sourceRoot":"","sources":["../../src/build/register-build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,qHAAqH;AACrH,yFAAyF;AAEzF,gFAAgF;AAChF,MAAM,cAAc,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAE3I,MAAM,KAAK,GAAG,kBAAkB,CAAC;AAEjC,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,GAAG,CAAC,eAAe,CAAC,uBAAuB,EAAE;QAC3C,WAAW,EAAE,yFAAyF;QACtG,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;SACpG,CAAC;QACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;YAC9B,MAAM,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;YACjF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;YACjI,MAAM,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YAC5H,IAAI,CAAC,OAAO;gBAAE,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,yBAAyB,EAAE,CAAC,CAAC;YAChG,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/connectors/docs.d.ts

@@ -0,0 +1,30 @@
+export declare const docsConnector: {
+    name: string;
+    optIn: true;
+    description: string;
+    commands: ({
+        name: string;
+        command: string;
+        examples: {
+            description: string;
+            input: {};
+        }[];
+    } | {
+        name: string;
+        command: string;
+        examples: ({
+            description: string;
+            input: {
+                topic: string;
+                extension?: never;
+            };
+        } | {
+            description: string;
+            input: {
+                extension: string;
+                topic: string;
+            };
+        })[];
+    })[];
+};
+//# sourceMappingURL=docs.d.ts.map

package/dist/connectors/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/connectors/docs.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAezB,CAAC"}

package/dist/connectors/docs.js

@@ -0,0 +1,18 @@
+// The `docs` connector (plan 09 §9.1 and §9.5): the guides of kvman and the pages of every installed extension.
+export const docsConnector = {
+    name: 'docs',
+    optIn: true,
+    description: 'Read the guides of kvman and of every installed extension. Use it before you write an extension, a preset, a view, or a component, and to learn how to use an extension that is installed.',
+    commands: [
+        { name: 'list', command: 'kvbuilder.guides.list', examples: [{ description: 'List every guide and page', input: {} }] },
+        {
+            name: 'get',
+            command: 'kvbuilder.guides.get',
+            examples: [
+                { description: 'Read the SDK guide', input: { topic: 'sdk' } },
+                { description: "Read an installed extension's page", input: { extension: '@kvman/kvwebui', topic: 'views' } },
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=docs.js.map

package/dist/connectors/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/connectors/docs.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,IAAa;IACpB,WAAW,EAAE,4LAA4L;IACzM,QAAQ,EAAE;QACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE;QACvH;YACE,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,sBAAsB;YAC/B,QAAQ,EAAE;gBACR,EAAE,WAAW,EAAE,oBAAoB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC9D,EAAE,WAAW,EAAE,oCAAoC,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;aAC9G;SACF;KACF;CACF,CAAC"}