chivgent 0.10.0 → 0.12.0

package/dist/extensions/discover.js

@@ -0,0 +1,61 @@
+import { readdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { CONFIG_DIRECTORY, EXTENSIONS_DIRECTORY } from "./trust.js";
+import { defaultSessionHome } from "../session-store.js";
+export function userExtensionsDirectory(environment = process.env) {
+    return path.join(defaultSessionHome(environment), EXTENSIONS_DIRECTORY);
+}
+export function projectExtensionsDirectory(cwd) {
+    return path.join(cwd, CONFIG_DIRECTORY, EXTENSIONS_DIRECTORY);
+}
+/**
+ * Lists the extension entry points in one directory.
+ *
+ * Two shapes are recognised: `name.js`, and `name/index.js`. Nesting stops
+ * there. Anything more elaborate is a package, and packaging is not what this
+ * stage is about.
+ */
+async function discoverIn(directory, origin) {
+    let entries;
+    try {
+        entries = await readdir(directory, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const found = [];
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        const entryPath = path.join(directory, entry.name);
+        if (entry.isFile() && entry.name.endsWith(".js")) {
+            found.push({ path: entryPath, origin });
+            continue;
+        }
+        if (entry.isDirectory()) {
+            const index = path.join(entryPath, "index.js");
+            try {
+                if ((await stat(index)).isFile()) {
+                    found.push({ path: index, origin });
+                }
+            }
+            catch {
+                // A directory without an index is not an extension.
+            }
+        }
+    }
+    return found;
+}
+/**
+ * User extensions come first so that a project cannot take a name the user
+ * already uses: the first registration of a name wins.
+ */
+export async function discoverExtensions(options) {
+    const environment = options.environment ?? process.env;
+    const found = [
+        ...(await discoverIn(userExtensionsDirectory(environment), "user")),
+    ];
+    if (options.includeProject) {
+        found.push(...(await discoverIn(projectExtensionsDirectory(options.cwd), "project")));
+    }
+    return found;
+}
+//# sourceMappingURL=discover.js.map

package/dist/extensions/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/extensions/discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AASzD,MAAM,UAAU,uBAAuB,CACrC,WAAW,GAAsB,OAAO,CAAC,GAAG;IAE5C,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,oBAAoB,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,UAAU,CACvB,SAAiB,EACjB,MAAuB;IAEvB,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAA0B,EAAE,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAC/C,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;oBACjC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AASD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAwB;IAExB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IACvD,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,MAAM,UAAU,CAAC,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;KACpE,CAAC;IACF,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CACR,GAAG,CAAC,MAAM,UAAU,CAAC,0BAA0B,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/extensions/loader.d.ts

@@ -0,0 +1,28 @@
+import type { DiscoveredExtension } from "./discover.js";
+import { ExtensionRegistry, type RegistryOptions } from "./registry.js";
+export interface LoadedExtension {
+    readonly path: string;
+    readonly origin: DiscoveredExtension["origin"];
+}
+export interface LoadResult {
+    readonly registry: ExtensionRegistry;
+    readonly loaded: readonly LoadedExtension[];
+    readonly failed: readonly {
+        readonly path: string;
+        readonly reason: string;
+    }[];
+}
+export interface LoadOptions extends RegistryOptions {
+    /** Injectable so tests do not have to write modules to disk to test loading. */
+    readonly importModule?: (path: string) => Promise<unknown>;
+}
+/**
+ * Imports each extension and lets it register.
+ *
+ * Importing a module runs its top-level code, so this is the point of no
+ * return: everything the caller wanted to gate must already have been decided.
+ * From here on the job is containment — one broken extension must leave
+ * chivgent working.
+ */
+export declare function loadExtensions(discovered: readonly DiscoveredExtension[], options: LoadOptions): Promise<LoadResult>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/extensions/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/extensions/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAGxE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChF;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,gFAAgF;IAChF,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5D;AAiBD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,SAAS,mBAAmB,EAAE,EAC1C,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAuCrB"}

package/dist/extensions/loader.js

@@ -0,0 +1,60 @@
+import { pathToFileURL } from "node:url";
+import { ExtensionRegistry } from "./registry.js";
+async function defaultImport(modulePath) {
+    // A file URL is required on Windows and harmless elsewhere.
+    return import(pathToFileURL(modulePath).href);
+}
+function readFactory(module) {
+    if (typeof module !== "object" || module === null) {
+        return undefined;
+    }
+    const candidate = module.default;
+    return typeof candidate === "function"
+        ? candidate
+        : undefined;
+}
+/**
+ * Imports each extension and lets it register.
+ *
+ * Importing a module runs its top-level code, so this is the point of no
+ * return: everything the caller wanted to gate must already have been decided.
+ * From here on the job is containment — one broken extension must leave
+ * chivgent working.
+ */
+export async function loadExtensions(discovered, options) {
+    const registry = new ExtensionRegistry(options);
+    const importModule = options.importModule ?? defaultImport;
+    const loaded = [];
+    const failed = [];
+    for (const extension of discovered) {
+        let factory;
+        try {
+            factory = readFactory(await importModule(extension.path));
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            failed.push({ path: extension.path, reason });
+            options.onWarning(`${extension.path}: failed to load (${reason}).`);
+            continue;
+        }
+        if (factory === undefined) {
+            const reason = "no default export function";
+            failed.push({ path: extension.path, reason });
+            options.onWarning(`${extension.path}: ${reason}; an extension must export default a function.`);
+            continue;
+        }
+        try {
+            await factory(registry.apiFor(extension.path));
+            loaded.push({ path: extension.path, origin: extension.origin });
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            failed.push({ path: extension.path, reason });
+            // Whatever it registered before throwing stays: partial is better than
+            // discarding work that is already valid.
+            options.onWarning(`${extension.path}: threw while registering (${reason}).`);
+        }
+    }
+    return { registry, loaded, failed };
+}
+//# sourceMappingURL=loader.js.map

package/dist/extensions/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/extensions/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAwB,MAAM,eAAe,CAAC;AAmBxE,KAAK,UAAU,aAAa,CAAC,UAAkB;IAC7C,4DAA4D;IAC5D,OAAO,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,WAAW,CAAC,MAAe;IAClC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAI,MAAgC,CAAC,OAAO,CAAC;IAC5D,OAAO,OAAO,SAAS,KAAK,UAAU;QACpC,CAAC,CAAE,SAA8B;QACjC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAA0C,EAC1C,OAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,aAAa,CAAC;IAC3D,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,MAAM,GAAuC,EAAE,CAAC;IAEtD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,OAAqC,CAAC;QAC1C,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,IAAI,qBAAqB,MAAM,IAAI,CAAC,CAAC;YACpE,SAAS;QACX,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,4BAA4B,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,SAAS,CACf,GAAG,SAAS,CAAC,IAAI,KAAK,MAAM,gDAAgD,CAC7E,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YAC9C,uEAAuE;YACvE,yCAAyC;YACzC,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,IAAI,8BAA8B,MAAM,IAAI,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/extensions/registry.d.ts

@@ -0,0 +1,36 @@
+import type { AgentEvent } from "../events.js";
+import type { ExtensionAPI, RegisteredCommand, RegisteredTool } from "./api.js";
+export interface RegistryOptions {
+    /** Names an extension may not take, so a project cannot shadow read_file. */
+    readonly reservedToolNames: readonly string[];
+    readonly reservedCommandNames: readonly string[];
+    readonly onWarning: (message: string) => void;
+}
+/**
+ * Collects what extensions register.
+ *
+ * Every rejection is reported and survivable: a conflicting registration is
+ * dropped, the rest of the extension keeps whatever it registered before and
+ * after, and the built-in stays in place.
+ */
+export declare class ExtensionRegistry {
+    private readonly options;
+    private readonly tools;
+    private readonly commands;
+    private readonly listeners;
+    private readonly promptContributions;
+    constructor(options: RegistryOptions);
+    /** The API handed to one extension; `source` identifies it in diagnostics. */
+    apiFor(source: string): ExtensionAPI;
+    get registeredTools(): readonly RegisteredTool[];
+    get registeredCommands(): readonly RegisteredCommand[];
+    get systemPromptContributions(): readonly string[];
+    command(name: string): RegisteredCommand | undefined;
+    /** A single listener that fans one event out to every subscribed handler. */
+    get eventListener(): (event: AgentEvent) => void;
+    private addTool;
+    private addCommand;
+    private addListener;
+    private addPrompt;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/extensions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EACV,YAAY,EAEZ,iBAAiB,EACjB,cAAc,EACf,MAAM,UAAU,CAAC;AAIlB,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAShB,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGjB;IACT,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgB;IAEpD,YAA6B,OAAO,EAAE,eAAe,EAAI;IAEzD,8EAA8E;IAC9E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CASnC;IAED,IAAI,eAAe,IAAI,SAAS,cAAc,EAAE,CAE/C;IAED,IAAI,kBAAkB,IAAI,SAAS,iBAAiB,EAAE,CAErD;IAED,IAAI,yBAAyB,IAAI,SAAS,MAAM,EAAE,CAEjD;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEnD;IAED,6EAA6E;IAC7E,IAAI,aAAa,IAAI,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAa/C;IAED,OAAO,CAAC,OAAO;IA2Bf,OAAO,CAAC,UAAU;IAoClB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,SAAS;CAOlB"}

package/dist/extensions/registry.js

@@ -0,0 +1,115 @@
+const COMMAND_NAME = /^[a-z][a-z0-9-]*$/;
+/**
+ * Collects what extensions register.
+ *
+ * Every rejection is reported and survivable: a conflicting registration is
+ * dropped, the rest of the extension keeps whatever it registered before and
+ * after, and the built-in stays in place.
+ */
+export class ExtensionRegistry {
+    options;
+    tools = new Map();
+    commands = new Map();
+    listeners = [];
+    promptContributions = [];
+    constructor(options) {
+        this.options = options;
+    }
+    /** The API handed to one extension; `source` identifies it in diagnostics. */
+    apiFor(source) {
+        return {
+            registerTool: (tool) => this.addTool(tool, source),
+            registerCommand: (name, command) => this.addCommand(name, command, source),
+            on: (type, handler) => this.addListener(type, handler, source),
+            contributeSystemPrompt: (text) => this.addPrompt(text, source),
+        };
+    }
+    get registeredTools() {
+        return [...this.tools.values()];
+    }
+    get registeredCommands() {
+        return [...this.commands.values()];
+    }
+    get systemPromptContributions() {
+        return this.promptContributions;
+    }
+    command(name) {
+        return this.commands.get(name);
+    }
+    /** A single listener that fans one event out to every subscribed handler. */
+    get eventListener() {
+        return (event) => {
+            for (const listener of this.listeners) {
+                if (listener.type !== event.type) {
+                    continue;
+                }
+                try {
+                    listener.handler(event);
+                }
+                catch {
+                    // An extension must not change the outcome of the run it observes.
+                }
+            }
+        };
+    }
+    addTool(tool, source) {
+        if (typeof tool !== "object" ||
+            tool === null ||
+            typeof tool.name !== "string" ||
+            tool.name.length === 0 ||
+            typeof tool.execute !== "function") {
+            this.options.onWarning(`${source}: registerTool needs a tool with a name and an execute function.`);
+            return;
+        }
+        if (this.options.reservedToolNames.includes(tool.name)) {
+            this.options.onWarning(`${source}: cannot register the tool "${tool.name}"; that name is built in.`);
+            return;
+        }
+        const existing = this.tools.get(tool.name);
+        if (existing !== undefined) {
+            this.options.onWarning(`${source}: the tool "${tool.name}" is already registered by ${existing.source}.`);
+            return;
+        }
+        this.tools.set(tool.name, { tool, source });
+    }
+    addCommand(name, command, source) {
+        if (typeof name !== "string" || !COMMAND_NAME.test(name)) {
+            this.options.onWarning(`${source}: "${String(name)}" is not a usable command name; use lowercase letters, digits and dashes.`);
+            return;
+        }
+        if (typeof command !== "object" || command === null || typeof command.run !== "function") {
+            this.options.onWarning(`${source}: the command "${name}" needs a run function.`);
+            return;
+        }
+        if (this.options.reservedCommandNames.includes(name)) {
+            this.options.onWarning(`${source}: cannot register "/${name}"; that command is built in.`);
+            return;
+        }
+        const existing = this.commands.get(name);
+        if (existing !== undefined) {
+            this.options.onWarning(`${source}: "/${name}" is already registered by ${existing.source}.`);
+            return;
+        }
+        this.commands.set(name, {
+            name,
+            source,
+            description: typeof command.description === "string" ? command.description : "",
+            run: command.run.bind(command),
+        });
+    }
+    addListener(type, handler, source) {
+        if (typeof handler !== "function") {
+            this.options.onWarning(`${source}: on("${String(type)}") needs a function.`);
+            return;
+        }
+        this.listeners.push({ type, handler });
+    }
+    addPrompt(text, source) {
+        if (typeof text !== "string" || text.trim().length === 0) {
+            this.options.onWarning(`${source}: contributeSystemPrompt needs a non-empty string.`);
+            return;
+        }
+        this.promptContributions.push(text.trim());
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/extensions/registry.js.map

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

package/dist/extensions/trust.d.ts

@@ -0,0 +1,44 @@
+export declare const CONFIG_DIRECTORY = ".chivgent";
+export declare const EXTENSIONS_DIRECTORY = "extensions";
+export declare class TrustFileError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare function defaultTrustFile(environment?: NodeJS.ProcessEnv): string;
+/**
+ * Resolves a directory the way the trust store keys it.
+ *
+ * Symlinks and `..` are resolved first so that two paths naming the same
+ * directory cannot produce two entries, one of which the user never sees.
+ */
+export declare function canonicalDirectory(directory: string): Promise<string>;
+export type TrustDecision = boolean;
+export interface TrustEntry {
+    /** The directory the decision was recorded against, which may be an ancestor. */
+    readonly path: string;
+    readonly decision: TrustDecision;
+}
+/**
+ * Records whether a project directory may contribute code to chivgent.
+ *
+ * Decisions are looked up by nearest ancestor, so trusting `~/work` covers
+ * every repository under it. A monorepo does not ask once per package.
+ */
+export declare class TrustStore {
+    private readonly filePath;
+    constructor(filePath?: string);
+    get location(): string;
+    lookup(directory: string): Promise<TrustEntry | undefined>;
+    set(directory: string, decision: TrustDecision): Promise<void>;
+    /**
+     * Removes the decision that covers this directory, including an ancestor's,
+     * so that forgetting actually makes chivgent ask again.
+     */
+    forget(directory: string): Promise<string | undefined>;
+    private read;
+    private write;
+}
+/** True when the project directory carries anything trust has to gate. */
+export declare function hasProjectExtensions(cwd: string): boolean;
+//# sourceMappingURL=trust.d.ts.map

package/dist/extensions/trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../../src/extensions/trust.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAC5C,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAGjD,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAGzD;CACF;AAED,wBAAgB,gBAAgB,CAC9B,WAAW,GAAE,MAAM,CAAC,UAAwB,GAC3C,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS3E;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AAEpC,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,GAAE,MAA2B,EAAI;IAEtE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAEK,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAc/D;IAEK,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnE;IAED;;;OAGG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS3D;YAEa,IAAI;YAyCJ,KAAK;CAcpB;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/extensions/trust.js

@@ -0,0 +1,129 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { realpath } from "node:fs/promises";
+import path from "node:path";
+import { defaultSessionHome } from "../session-store.js";
+export const CONFIG_DIRECTORY = ".chivgent";
+export const EXTENSIONS_DIRECTORY = "extensions";
+const TRUST_FILE = "trust.json";
+export class TrustFileError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "TrustFileError";
+    }
+}
+export function defaultTrustFile(environment = process.env) {
+    return path.join(defaultSessionHome(environment), TRUST_FILE);
+}
+/**
+ * Resolves a directory the way the trust store keys it.
+ *
+ * Symlinks and `..` are resolved first so that two paths naming the same
+ * directory cannot produce two entries, one of which the user never sees.
+ */
+export async function canonicalDirectory(directory) {
+    const absolute = path.resolve(directory);
+    try {
+        return await realpath(absolute);
+    }
+    catch {
+        // A directory that does not exist cannot be resolved, but it can still be
+        // recorded; the lexical form is the best available key.
+        return absolute;
+    }
+}
+/**
+ * Records whether a project directory may contribute code to chivgent.
+ *
+ * Decisions are looked up by nearest ancestor, so trusting `~/work` covers
+ * every repository under it. A monorepo does not ask once per package.
+ */
+export class TrustStore {
+    filePath;
+    constructor(filePath = defaultTrustFile()) {
+        this.filePath = filePath;
+    }
+    get location() {
+        return this.filePath;
+    }
+    async lookup(directory) {
+        const data = await this.read();
+        let current = await canonicalDirectory(directory);
+        for (;;) {
+            const decision = data[current];
+            if (decision !== undefined) {
+                return { path: current, decision };
+            }
+            const parent = path.dirname(current);
+            if (parent === current) {
+                return undefined;
+            }
+            current = parent;
+        }
+    }
+    async set(directory, decision) {
+        const key = await canonicalDirectory(directory);
+        const data = await this.read();
+        data[key] = decision;
+        await this.write(data);
+    }
+    /**
+     * Removes the decision that covers this directory, including an ancestor's,
+     * so that forgetting actually makes chivgent ask again.
+     */
+    async forget(directory) {
+        const entry = await this.lookup(directory);
+        if (entry === undefined) {
+            return undefined;
+        }
+        const data = await this.read();
+        delete data[entry.path];
+        await this.write(data);
+        return entry.path;
+    }
+    async read() {
+        let contents;
+        try {
+            contents = await readFile(this.filePath, "utf8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return {};
+            }
+            throw new TrustFileError(`Could not read the trust file at ${this.filePath}.`, { cause: error });
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(contents);
+        }
+        catch (error) {
+            throw new TrustFileError(`The trust file at ${this.filePath} is not valid JSON.`, { cause: error });
+        }
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            throw new TrustFileError(`The trust file at ${this.filePath} must contain a JSON object keyed by directory.`);
+        }
+        const data = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (typeof value !== "boolean") {
+                throw new TrustFileError(`The trust file entry for "${key}" must be true or false.`);
+            }
+            data[key] = value;
+        }
+        return data;
+    }
+    async write(data) {
+        await mkdir(path.dirname(this.filePath), { recursive: true });
+        const sorted = {};
+        for (const key of Object.keys(data).sort()) {
+            sorted[key] = data[key];
+        }
+        // The file is meant to be read and edited by a person, so it stays sorted
+        // and indented rather than compact.
+        await writeFile(this.filePath, `${JSON.stringify(sorted, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+    }
+}
+/** True when the project directory carries anything trust has to gate. */
+export function hasProjectExtensions(cwd) {
+    return existsSync(path.join(cwd, CONFIG_DIRECTORY, EXTENSIONS_DIRECTORY));
+}
+//# sourceMappingURL=trust.js.map

package/dist/extensions/trust.js.map

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

package/dist/remote/client.d.ts

@@ -0,0 +1,42 @@
+import type { AgentEventListener } from "../events.js";
+import { type ServerHello, type ServerResult } from "./protocol.js";
+export declare class RemoteError extends Error {
+    readonly code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+export interface RemoteSessionOptions {
+    readonly socketPath: string;
+    /** Receives the server's event stream, so the existing renderers work as-is. */
+    readonly onEvent?: AgentEventListener;
+    readonly onError?: (code: string, message: string) => void;
+}
+/**
+ * A client attached to a session running in another process.
+ *
+ * It holds no state of its own: it sends prompts and renders what comes back.
+ * That is what keeps a second client honest — two attached clients see one
+ * stream because there is only one session.
+ */
+export declare class RemoteSession {
+    private readonly options;
+    private socket;
+    private readonly decoder;
+    private hello;
+    private pending;
+    private closedReason;
+    constructor(options: RemoteSessionOptions);
+    get session(): ServerHello["session"];
+    get toolNames(): readonly string[];
+    connect(): Promise<ServerHello>;
+    private onHello;
+    private onHelloError;
+    /** Sends a prompt and resolves when the run it started finishes. */
+    prompt(text: string): Promise<ServerResult>;
+    interrupt(): void;
+    close(): void;
+    private write;
+    private receive;
+    private handleClose;
+    private failAll;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/remote/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/remote/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAEvB,qBAAa,WAAY,SAAQ,KAAK;IACP,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IAAnD,YAAY,OAAO,EAAE,MAAM,EAAW,IAAI,CAAC,EAAE,MAAM,YAAA,EAGlD;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5D;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IAUZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IATpC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,OAAO,CAGD;IACd,OAAO,CAAC,YAAY,CAAqB;IAEzC,YAA6B,OAAO,EAAE,oBAAoB,EAAI;IAE9D,IAAI,OAAO,IAAI,WAAW,CAAC,SAAS,CAAC,CAKpC;IAED,IAAI,SAAS,IAAI,SAAS,MAAM,EAAE,CAEjC;IAEK,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,CAsCpC;IAED,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,YAAY,CAAuC;IAE3D,oEAAoE;IACpE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAW1C;IAED,SAAS,IAAI,IAAI,CAIhB;IAED,KAAK,IAAI,IAAI,CAIZ;IAED,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,OAAO;IAiEf,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,OAAO;CAQhB"}