atom-lite 0.1.0 → 0.5.1

package/dist/extensions/tool-adapter.js

@@ -0,0 +1,157 @@
+export function coerceToolArguments(schema, input) {
+    const result = { ...(input ?? {}) };
+    const properties = (schema?.properties ?? {});
+    const required = Array.isArray(schema?.required)
+        ? schema.required
+        : [];
+    for (const [key, prop] of Object.entries(properties)) {
+        if (result[key] === undefined)
+            continue;
+        const type = prop?.type;
+        if (result[key] === null && !required.includes(key)) {
+            delete result[key];
+            continue;
+        }
+        if (type === "number" || type === "integer") {
+            if (typeof result[key] === "string") {
+                const n = Number(result[key]);
+                if (!Number.isNaN(n))
+                    result[key] = n;
+            }
+            else if (typeof result[key] === "boolean") {
+                result[key] = result[key] ? 1 : 0;
+            }
+        }
+        else if (type === "boolean") {
+            if (typeof result[key] === "string") {
+                if (result[key] === "true")
+                    result[key] = true;
+                if (result[key] === "false")
+                    result[key] = false;
+            }
+            else if (typeof result[key] === "number") {
+                result[key] = result[key] !== 0;
+            }
+        }
+        else if (type === "string") {
+            if (result[key] !== null && typeof result[key] !== "string") {
+                result[key] = String(result[key]);
+            }
+        }
+        else if (type === "array") {
+            if (!Array.isArray(result[key]) && result[key] !== null) {
+                result[key] = [result[key]];
+            }
+            if (Array.isArray(result[key]) && prop?.items) {
+                result[key] = result[key].map((item) => typeof prop.items === "object" && prop.items?.type
+                    ? coerceScalar(prop.items, item)
+                    : item);
+            }
+        }
+        else if (type === "object" && prop?.properties) {
+            if (result[key] && typeof result[key] === "object") {
+                result[key] = coerceToolArguments(prop, result[key]);
+            }
+        }
+    }
+    return result;
+}
+function coerceScalar(prop, value) {
+    if (value === null)
+        return value;
+    const type = prop?.type;
+    if (type === "number" || type === "integer") {
+        if (typeof value === "string") {
+            const n = Number(value);
+            if (!Number.isNaN(n))
+                return n;
+        }
+    }
+    if (type === "boolean" && typeof value === "string") {
+        if (value === "true")
+            return true;
+        if (value === "false")
+            return false;
+    }
+    if (type === "string" && value !== null && typeof value !== "string") {
+        return String(value);
+    }
+    return value;
+}
+export function extensionToolToAgentTool(extensionTool, extensionContext) {
+    const tool = {
+        definition: {
+            name: extensionTool.name,
+            description: extensionTool.description,
+            parameters: extensionTool.parameters ?? {},
+        },
+        annotations: extensionTool.annotations,
+        exposure: extensionTool.exposure,
+        execute: async (call, toolCtx) => {
+            const coerced = coerceToolArguments(extensionTool.parameters, call.arguments ?? {});
+            call.arguments = coerced;
+            const signal = toolCtx.signal;
+            const onUpdate = (partial) => {
+                toolCtx.onToolOutput?.(call, "stdout", JSON.stringify(partial));
+            };
+            const ctx = { ...extensionContext };
+            let raw;
+            try {
+                if (extensionTool.execute.length >= 3) {
+                    raw = await extensionTool.execute(call.id, coerced, signal, onUpdate, ctx);
+                }
+                else if (extensionTool.execute.length === 2) {
+                    raw = await extensionTool.execute(coerced, ctx);
+                }
+                else {
+                    raw = await extensionTool.execute(coerced);
+                }
+            }
+            catch (error) {
+                return {
+                    toolCallId: call.id,
+                    name: call.name,
+                    content: `COMMAND_FAILED: ${error instanceof Error ? error.message : String(error)}`,
+                    isError: true,
+                };
+            }
+            const content = Array.isArray(raw?.content)
+                ? raw.content
+                    .map((part) => part?.type === "text" ? String(part.text ?? "") : "")
+                    .join("")
+                : typeof raw === "string"
+                    ? raw
+                    : raw === undefined
+                        ? ""
+                        : JSON.stringify(raw);
+            return {
+                toolCallId: call.id,
+                name: call.name,
+                content,
+                isError: raw?.isError === true,
+                details: raw?.details,
+                structuredContent: raw?.structuredContent,
+                usage: raw?.usage,
+                diff: raw?.diff,
+            };
+        },
+    };
+    return tool;
+}
+export function collectExtensionTools(loader) {
+    const out = [];
+    for (const loaded of loader.list()) {
+        const ctx = loaded.context ?? {
+            workspace: process.cwd(),
+            trusted: true,
+            hasUI: false,
+            ui: null,
+            log: () => { },
+        };
+        for (const tool of loaded.registries.tools.values()) {
+            out.push(extensionToolToAgentTool(tool, ctx));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=tool-adapter.js.map

package/dist/extensions/tool-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-adapter.js","sourceRoot":"","sources":["../../src/extensions/tool-adapter.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,mBAAmB,CACjC,MAA2C,EAC3C,KAA8B;IAE9B,MAAM,MAAM,GAA4B,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;IAC7D,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,CAAwB,CAAC;IACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC9C,CAAC,CAAE,MAAM,CAAC,QAAqB;QAC/B,CAAC,CAAC,EAAE,CAAC;IACP,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,SAAS;QACxC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;QACxB,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACpD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5C,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACpC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,CAAC;iBAAM,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC5C,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACpC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,MAAM;oBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBAC/C,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,OAAO;oBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnD,CAAC;iBAAM,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC5D,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBACxD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;gBAC9C,MAAM,CAAC,GAAG,CAAC,GAAI,MAAM,CAAC,GAAG,CAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACpD,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI;oBAChD,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC;oBAChC,CAAC,CAAC,IAAI,CACT,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,EAAE,UAAU,EAAE,CAAC;YACjD,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACnD,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAA4B,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,IAAS,EAAE,KAAc;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;IACxB,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACpD,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAClC,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,aAA4B,EAC5B,gBAAkC;IAElC,MAAM,IAAI,GAAS;QACjB,UAAU,EAAE;YACV,IAAI,EAAE,aAAa,CAAC,IAAI;YACxB,WAAW,EAAE,aAAa,CAAC,WAAW;YACtC,UAAU,EAAE,aAAa,CAAC,UAAU,IAAI,EAAE;SAC3C;QACD,WAAW,EAAE,aAAa,CAAC,WAAW;QACtC,QAAQ,EAAE,aAAa,CAAC,QAAQ;QAChC,OAAO,EAAE,KAAK,EAAE,IAAc,EAAE,OAAoB,EAAuB,EAAE;YAC3E,MAAM,OAAO,GAAG,mBAAmB,CACjC,aAAa,CAAC,UAAU,EACxB,IAAI,CAAC,SAAS,IAAI,EAAE,CACrB,CAAC;YACF,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;YACzB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,MAAM,QAAQ,GAAG,CAAC,OAAgB,EAAE,EAAE;gBACpC,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YAClE,CAAC,CAAC;YACF,MAAM,GAAG,GAAG,EAAE,GAAG,gBAAgB,EAAE,CAAC;YACpC,IAAI,GAAQ,CAAC;YACb,IAAI,CAAC;gBACH,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;oBACtC,GAAG,GAAG,MAAM,aAAa,CAAC,OAAO,CAC/B,IAAI,CAAC,EAAE,EACP,OAAO,EACP,MAAM,EACN,QAAQ,EACR,GAAG,CACJ,CAAC;gBACJ,CAAC;qBAAM,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC9C,GAAG,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAClD,CAAC;qBAAM,CAAC;oBACN,GAAG,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,UAAU,EAAE,IAAI,CAAC,EAAE;oBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO,EAAE,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;oBACpF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC;gBACzC,CAAC,CAAC,GAAG,CAAC,OAAO;qBACR,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CACjB,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CACrD;qBACA,IAAI,CAAC,EAAE,CAAC;gBACb,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ;oBACvB,CAAC,CAAC,GAAG;oBACL,CAAC,CAAC,GAAG,KAAK,SAAS;wBACjB,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAE5B,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,EAAE;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO;gBACP,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI;gBAC9B,OAAO,EAAE,GAAG,EAAE,OAAO;gBACrB,iBAAiB,EAAE,GAAG,EAAE,iBAAiB;gBACzC,KAAK,EAAE,GAAG,EAAE,KAAK;gBACjB,IAAI,EAAE,GAAG,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;KACF,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAgH;IAEhH,MAAM,GAAG,GAAW,EAAE,CAAC;IACvB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnC,MAAM,GAAG,GACP,MAAM,CAAC,OAAO,IAAI;YAChB,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE;YACxB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,KAAK;YACZ,EAAE,EAAE,IAAW;YACf,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;SACd,CAAC;QACJ,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACpD,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/extensions/trust.d.ts

@@ -0,0 +1,6 @@
+export declare function normalizeProjectPath(projectDir: string): string;
+export declare function isProjectTrusted(projectDir: string, configPath?: string): boolean;
+export declare function isProjectDenied(projectDir: string, configPath?: string): boolean;
+export declare function trustProject(projectDir: string, configPath?: string): void;
+export declare function denyProject(projectDir: string, configPath?: string): void;
+export declare function untrustProject(projectDir: string, configPath?: string): void;

package/dist/extensions/trust.js

@@ -0,0 +1,55 @@
+import { loadConfig } from "../config/load.js";
+import { updateUserConfig } from "../config/write.js";
+import { resolve } from "node:path";
+export function normalizeProjectPath(projectDir) {
+    return resolve(projectDir);
+}
+function readExtensions(configPath) {
+    const config = loadConfig(configPath ? { userConfigPath: configPath } : undefined);
+    return {
+        trustedProjects: [...(config.extensions?.trustedProjects ?? [])],
+        deniedProjects: [...(config.extensions?.deniedProjects ?? [])],
+    };
+}
+export function isProjectTrusted(projectDir, configPath) {
+    const normalized = normalizeProjectPath(projectDir);
+    return readExtensions(configPath).trustedProjects.includes(normalized);
+}
+export function isProjectDenied(projectDir, configPath) {
+    const normalized = normalizeProjectPath(projectDir);
+    return readExtensions(configPath).deniedProjects.includes(normalized);
+}
+function writeDecision(projectDir, decision, configPath) {
+    const normalized = normalizeProjectPath(projectDir);
+    updateUserConfig((config) => {
+        const extensions = config.extensions && typeof config.extensions === "object"
+            ? config.extensions
+            : {};
+        const trusted = Array.isArray(extensions.trustedProjects)
+            ? [...extensions.trustedProjects]
+            : [];
+        const denied = Array.isArray(extensions.deniedProjects)
+            ? [...extensions.deniedProjects]
+            : [];
+        const without = (paths) => paths.filter((path) => path !== normalized);
+        extensions.trustedProjects =
+            decision === "trusted"
+                ? [...without(trusted), normalized]
+                : without(trusted);
+        extensions.deniedProjects =
+            decision === "denied"
+                ? [...without(denied), normalized]
+                : without(denied);
+        config.extensions = extensions;
+    }, configPath);
+}
+export function trustProject(projectDir, configPath) {
+    writeDecision(projectDir, "trusted", configPath);
+}
+export function denyProject(projectDir, configPath) {
+    writeDecision(projectDir, "denied", configPath);
+}
+export function untrustProject(projectDir, configPath) {
+    writeDecision(projectDir, "none", configPath);
+}
+//# 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/extensions/types.d.ts

@@ -0,0 +1,94 @@
+export type AtomEvent = "extension_load" | "extension_activate" | "extension_unload" | "extension_error" | "session_start" | "session_end" | "turn_start" | "turn_end" | "tool_call" | "tool_result" | "message" | "context_build" | "config_change";
+export interface ExtensionTool {
+    name: string;
+    label: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    exposure?: "direct" | "model-only" | "hidden" | "codemode" | "deferred";
+    annotations?: Record<string, unknown>;
+    execute: (...args: any[]) => Promise<unknown>;
+}
+export interface ExtensionCommand {
+    name: string;
+    description: string;
+    argumentHint?: string;
+    category?: string;
+    getArgumentCompletions?: (prefix: string) => unknown;
+    run?: (args: string, ctx: ExtensionContext) => void | Promise<void>;
+    handler?: (args: string, ctx: any) => void | Promise<void>;
+}
+export interface ExtensionWidget {
+    id: string;
+    location: "aboveInput" | "belowInput" | "footer";
+    render: (width: number) => string[];
+}
+export interface ExtensionUIContext {
+    select(title: string, options: string[], opts?: any): Promise<string | undefined>;
+    confirm(title: string, message: string, opts?: any): Promise<boolean>;
+    input(title: string, placeholder?: string, opts?: any): Promise<string | undefined>;
+    editor(title: string, prefill?: string, opts?: any): Promise<string | undefined>;
+    notify(message: string, type?: "info" | "warning" | "error"): void;
+    onTerminalInput(handler: (data: string) => {
+        consume?: boolean;
+        data?: string;
+    } | undefined): () => void;
+    setStatus(key: string, text: string | undefined): void;
+    setWorkingMessage(message?: string): void;
+    setWorkingVisible(visible: boolean): void;
+    setWorkingIndicator(options?: {
+        frames?: string[];
+        intervalMs?: number;
+    }): void;
+    setHiddenThinkingLabel(label?: string): void;
+    setWidget(key: string, content: string[] | ((tui: any, theme: any) => any) | undefined, options?: {
+        placement?: "aboveEditor" | "belowEditor";
+    }): void;
+    setFooter(factory: ((tui: any, theme: any, footerData: any) => any) | undefined): void;
+    setHeader(factory: ((tui: any, theme: any) => any) | undefined): void;
+    setTitle(title: string): void;
+    custom<T>(factory: any, options?: any): Promise<T>;
+    pasteToEditor(text: string): void;
+    setEditorText(text: string): void;
+    getEditorText(): string;
+    getToolsExpanded(): boolean;
+    setToolsExpanded(expanded: boolean): void;
+    getTheme(name: string): any;
+    setTheme(theme: string | any): {
+        success: boolean;
+        error?: string;
+    };
+}
+export interface ExtensionContext {
+    workspace: string;
+    trusted: boolean;
+    hasUI: boolean;
+    ui: ExtensionUIContext;
+    log: (message: string) => void;
+    sessionManager?: any;
+}
+export interface ExtensionProvider {
+    name: string;
+    config: Record<string, unknown>;
+}
+export interface ExtensionModel {
+    provider: string;
+    id: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface ExecOptions {
+    cwd?: string;
+    timeoutMs?: number;
+}
+export type ExtensionEventHandler = (event: unknown, ctx: ExtensionContext) => unknown | Promise<unknown>;
+export interface ExtensionStatus {
+    id: string;
+    source: string;
+    entryPath: string;
+    status: "loaded" | "error" | "skipped";
+    error?: string;
+}

package/dist/extensions/types.js

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

package/dist/extensions/types.js.map

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

package/dist/extensions/ui.d.ts

@@ -0,0 +1,21 @@
+import type { ExtensionContext, ExtensionUIContext } from "./types.js";
+import type { ExtensionRegistries } from "./api.js";
+export interface ExtensionUICallbacks {
+    notify?: (message: string, type?: "info" | "warning" | "error") => void;
+    requestRender?: () => void;
+    getToolsExpanded?: () => boolean;
+    setToolsExpanded?: (expanded: boolean) => void;
+    select?: (title: string, options: string[], opts?: any) => Promise<string | undefined>;
+    confirm?: (title: string, message: string, opts?: any) => Promise<boolean>;
+    input?: (title: string, placeholder?: string, opts?: any) => Promise<string | undefined>;
+    editor?: (title: string, prefill?: string, opts?: any) => Promise<string | undefined>;
+    custom?: <T>(factory: any, options?: any) => Promise<T>;
+    pasteToEditor?: (text: string) => void;
+    setEditorText?: (text: string) => void;
+    getEditorText?: () => string;
+    onTerminalInput?: (handler: (data: string) => {
+        consume?: boolean;
+        data?: string;
+    } | undefined) => () => void;
+}
+export declare function createDefaultExtensionUI(registries: ExtensionRegistries, ctx: ExtensionContext, callbacks?: ExtensionUICallbacks): ExtensionUIContext;

package/dist/extensions/ui.js

@@ -0,0 +1,75 @@
+export function createDefaultExtensionUI(registries, ctx, callbacks = {}) {
+    const noopUnsubscribe = () => { };
+    return {
+        notify: (message, type) => {
+            if (callbacks.notify)
+                callbacks.notify(message, type);
+            else {
+                // eslint-disable-next-line no-console
+                console.error(`[extension] ${type ?? "info"}: ${message}`);
+            }
+        },
+        setStatus: (key, text) => {
+            if (text === undefined)
+                registries.status.delete(key);
+            else
+                registries.status.set(key, text);
+            callbacks.requestRender?.();
+        },
+        setWorkingMessage: (message) => {
+            registries.workingMessage = message;
+        },
+        setWorkingVisible: (visible) => {
+            registries.workingVisible = visible;
+        },
+        setWorkingIndicator: (options) => {
+            registries.workingIndicator = options;
+        },
+        setHiddenThinkingLabel: (label) => {
+            registries.hiddenThinkingLabel = label;
+        },
+        setWidget: (key, content, options) => {
+            if (content === undefined)
+                registries.uiWidgets.delete(key);
+            else
+                registries.uiWidgets.set(key, {
+                    key,
+                    content,
+                    placement: options?.placement ?? "aboveEditor",
+                });
+            callbacks.requestRender?.();
+        },
+        setFooter: (factory) => {
+            registries.footerFactory = factory;
+            callbacks.requestRender?.();
+        },
+        setHeader: (factory) => {
+            registries.headerFactory = factory;
+            callbacks.requestRender?.();
+        },
+        setTitle: (title) => {
+            registries.title = title;
+            callbacks.requestRender?.();
+        },
+        select: (title, options, opts) => callbacks.select ? callbacks.select(title, options, opts) : Promise.resolve(undefined),
+        confirm: (title, message, opts) => callbacks.confirm ? callbacks.confirm(title, message, opts) : Promise.resolve(false),
+        input: (title, placeholder, opts) => callbacks.input ? callbacks.input(title, placeholder, opts) : Promise.resolve(undefined),
+        editor: (title, prefill, opts) => callbacks.editor ? callbacks.editor(title, prefill, opts) : Promise.resolve(undefined),
+        custom: (factory, options) => callbacks.custom ? callbacks.custom(factory, options) : Promise.resolve(undefined),
+        pasteToEditor: (text) => callbacks.pasteToEditor?.(text),
+        setEditorText: (text) => callbacks.setEditorText?.(text),
+        getEditorText: () => (callbacks.getEditorText ? callbacks.getEditorText() : ""),
+        onTerminalInput: (handler) => callbacks.onTerminalInput ? callbacks.onTerminalInput(handler) : () => { },
+        getToolsExpanded: () => (callbacks.getToolsExpanded ? callbacks.getToolsExpanded() : registries.toolsExpanded),
+        setToolsExpanded: (expanded) => {
+            registries.toolsExpanded = expanded;
+            if (callbacks.setToolsExpanded)
+                callbacks.setToolsExpanded(expanded);
+            else
+                callbacks.requestRender?.();
+        },
+        getTheme: () => undefined,
+        setTheme: () => ({ success: false, error: "theme switching is not available" }),
+    };
+}
+//# sourceMappingURL=ui.js.map

package/dist/extensions/ui.js.map

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

package/dist/index.d.ts

@@ -8,9 +8,11 @@ export { createProvider } from "./providers/factory.js";
 export { InMemoryProviderRegistry } from "./providers/registry.js";
 export { InMemorySession } from "./sessions/store.js";
 export * from "./sessions/store.js";
+export * from "./extensions/session-manager.js";
 export * from "./sessions/events.js";
 export * from "./sessions/recovery.js";
 export { OllamaAdapter, OllamaProvider } from "./providers/ollama.js";
 export { GeminiAdapter } from "./providers/gemini.js";
 export { InMemoryToolRegistry } from "./tools/registry.js";
+export * from "./mcp/index.js";
 export * from "./types.js";

package/dist/index.js

@@ -7,10 +7,12 @@ export { createProvider } from "./providers/factory.js";
 export { InMemoryProviderRegistry } from "./providers/registry.js";
 export { InMemorySession } from "./sessions/store.js";
 export * from "./sessions/store.js";
+export * from "./extensions/session-manager.js";
 export * from "./sessions/events.js";
 export * from "./sessions/recovery.js";
 export { OllamaAdapter, OllamaProvider } from "./providers/ollama.js";
 export { GeminiAdapter } from "./providers/gemini.js";
 export { InMemoryToolRegistry } from "./tools/registry.js";
+export * from "./mcp/index.js";
 export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/mcp/client.d.ts

@@ -0,0 +1,73 @@
+import type { McpRemoteTool, McpTransport } from "./types.js";
+export declare const SUPPORTED_PROTOCOL_VERSIONS: readonly ["2024-11-05", "2025-03-26", "2025-06-18"];
+export declare const PREFERRED_PROTOCOL_VERSION = "2025-06-18";
+export declare class McpError extends Error {
+    readonly code?: number;
+    readonly data?: unknown;
+    constructor(message: string, code?: number, data?: unknown);
+}
+export declare class McpNotConnectedError extends McpError {
+    constructor(message?: string);
+}
+export interface McpClientOptions {
+    clientName?: string;
+    clientVersion?: string;
+    /** Called when the transport closes unexpectedly (not via close()). */
+    onClose?: (info: {
+        code?: number | null;
+        signal?: string | null;
+    }) => void;
+}
+export interface McpRequestOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface McpConnectOptions extends McpRequestOptions {
+    /** Timeout for spawning the transport and completing the handshake. */
+    startupTimeoutMs?: number;
+}
+export interface McpClientConnectResult {
+    protocolVersion: string;
+    serverInfo?: unknown;
+    capabilities?: unknown;
+}
+/**
+ * Small JSON-RPC 2.0 client for MCP. The transport owns framing and process
+ * lifecycle; this class owns request ids, timeouts, cancellation, and
+ * notifications.
+ */
+export declare class McpClient {
+    private readonly transport;
+    private readonly clientName;
+    private readonly clientVersion;
+    private readonly onClose?;
+    private nextId;
+    private pending;
+    private notificationHandlers;
+    private closed;
+    private started;
+    private startPromise?;
+    private protocolVersion?;
+    private serverInfo?;
+    private capabilities?;
+    private lastTransportError?;
+    constructor(transport: McpTransport, options?: McpClientOptions);
+    get protocolVersionValue(): string | undefined;
+    get serverInfoValue(): unknown;
+    get capabilitiesValue(): unknown;
+    get lastError(): Error | undefined;
+    isClosed(): boolean;
+    /** Spawn the transport and perform the MCP initialize handshake. */
+    connect(options?: McpConnectOptions): Promise<McpClientConnectResult>;
+    /** Discover every page of tools/list. */
+    listTools(options?: McpRequestOptions): Promise<McpRemoteTool[]>;
+    callTool(name: string, args: Record<string, unknown>, options?: McpRequestOptions): Promise<unknown>;
+    ping(options?: McpRequestOptions): Promise<unknown>;
+    onNotification(method: string, handler: (params: unknown) => void): () => void;
+    request(method: string, params: unknown, options?: McpRequestOptions): Promise<unknown>;
+    close(): Promise<void>;
+    private sendNotification;
+    private handleMessage;
+    private handleTransportError;
+    private handleClose;
+}