@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/rpc/ui-actions.js

@@ -0,0 +1,362 @@
+import { randomBytes } from "node:crypto";
+import { BUILTIN_HOST_ACTION_REGISTRY } from "../host-actions.js";
+import { validateUiActionArgs } from "./ui-action-args.js";
+const MAX_ACTIONS = 200;
+const MAX_LABEL_LENGTH = 80;
+const MAX_DESCRIPTION_LENGTH = 240;
+const MAX_SOURCE_LABEL_LENGTH = 80;
+const MAX_HINT_LENGTH = 160;
+const REDACTED_PATH = "[redacted path]";
+const catalogStates = new WeakMap();
+export function getUiActionDescriptors(session, scope, options = {}) {
+    const builtinDescriptors = BUILTIN_HOST_ACTION_REGISTRY.getDescriptors({
+        session: {
+            isBusy: session.isBusy ?? session.isStreaming ?? false,
+            isCompacting: session.isCompacting ?? false,
+            isStreaming: session.isStreaming ?? false,
+            model: session.model,
+            thinkingLevel: session.thinkingLevel,
+            fastModeRestoreThinkingLevel: session.fastModeRestoreThinkingLevel,
+        },
+    });
+    const normalizedScope = normalizeUiActionListScope(scope);
+    const descriptors = normalizedScope === "primary"
+        ? builtinDescriptors
+        : [...builtinDescriptors, ...getUiActionCatalog(session).map((entry) => entry.descriptor)];
+    return descriptors
+        .filter((descriptor) => matchesUiActionScope(descriptor, normalizedScope))
+        .filter((descriptor) => !options.remoteSafeOnly || descriptor.remoteSafe)
+        .slice(0, MAX_ACTIONS);
+}
+function normalizeUiActionListScope(scope) {
+    return scope === "primary" || scope === "palette" || scope === "all" ? scope : "all";
+}
+function matchesUiActionScope(descriptor, scope) {
+    const kind = descriptor.presentation?.kind;
+    switch (scope) {
+        case "all":
+            return true;
+        case "primary":
+            return descriptor.source === "builtin" && (kind === "card" || kind === "toggle");
+        case "palette":
+            return kind === "palette";
+        default:
+            return true;
+    }
+}
+export function createUiActionInvocationPlan(session, options) {
+    if (typeof options.action !== "string" || options.action.length === 0) {
+        throw new Error("UI action id must be a non-empty string");
+    }
+    const entry = getUiActionCatalog(session).find((candidate) => candidate.descriptor.id === options.action);
+    if (!entry) {
+        throw new Error(`UI action not available: ${options.action}`);
+    }
+    if (options.requireRemoteSafe && !entry.descriptor.remoteSafe) {
+        throw new Error(`UI action not available over remote host: ${options.action}`);
+    }
+    if (!entry.descriptor.enabled) {
+        throw new Error(entry.descriptor.disabledReason ?? `UI action is disabled: ${options.action}`);
+    }
+    const rawArguments = getRawArguments(options.args, entry.descriptor.args ?? []);
+    const promptText = createPromptText(entry.promptName, rawArguments);
+    if (entry.source === "extension") {
+        return {
+            promptText,
+            response: {
+                action: entry.descriptor.id,
+                status: "handled",
+            },
+        };
+    }
+    if (!session.isStreaming) {
+        return {
+            promptText,
+            response: {
+                action: entry.descriptor.id,
+                status: "accepted",
+            },
+        };
+    }
+    const streamingBehavior = getQueueBehavior(options.streamingBehavior, entry.descriptor.streamingBehavior);
+    return {
+        promptText,
+        promptStreamingBehavior: streamingBehavior,
+        response: {
+            action: entry.descriptor.id,
+            status: "queued",
+            queuedAs: streamingBehavior,
+        },
+    };
+}
+export async function getUiActionCompletions(session, options) {
+    if (typeof options.action !== "string" || options.action.length === 0) {
+        throw new Error("UI action id must be a non-empty string");
+    }
+    if (typeof options.argument !== "string" || options.argument.length === 0) {
+        throw new Error("UI action argument name must be a non-empty string");
+    }
+    if (options.prefix !== undefined && typeof options.prefix !== "string") {
+        throw new Error("UI action completion prefix must be a string");
+    }
+    const entry = getUiActionCatalog(session).find((candidate) => candidate.descriptor.id === options.action);
+    if (!entry) {
+        throw new Error(`UI action not available: ${options.action}`);
+    }
+    if (options.requireRemoteSafe && !entry.descriptor.remoteSafe) {
+        throw new Error(`UI action not available over remote host: ${options.action}`);
+    }
+    const argument = (entry.descriptor.args ?? []).find((candidate) => candidate.name === options.argument);
+    if (!argument) {
+        throw new Error(`UI action argument not available: ${options.argument}`);
+    }
+    if (argument.completion !== "commandArguments" || !entry.command?.getArgumentCompletions) {
+        return [];
+    }
+    const completions = await entry.command.getArgumentCompletions(options.prefix ?? "");
+    return (completions ?? [])
+        .map((completion) => ({
+        value: boundedDisplayString(completion.value, MAX_LABEL_LENGTH) ?? "",
+        label: boundedDisplayString(completion.label, MAX_LABEL_LENGTH),
+        description: boundedDisplayString(completion.description, MAX_DESCRIPTION_LENGTH),
+    }))
+        .filter((completion) => completion.value.length > 0)
+        .slice(0, 50);
+}
+function getUiActionCatalog(session) {
+    const token = getCatalogToken(session);
+    const extensionActions = session.extensionRunner
+        .getRegisteredCommands()
+        .map((command, index) => createExtensionCommandAction(command, index, token));
+    const promptActions = session.promptTemplates.map((template, index) => createPromptTemplateAction(template, index, token));
+    const skillActions = session.resourceLoader
+        .getSkills()
+        .skills.map((skill, index) => createSkillAction(skill, index, token));
+    return [...extensionActions, ...promptActions, ...skillActions].slice(0, MAX_ACTIONS);
+}
+function createExtensionCommandAction(command, index, token) {
+    const label = boundedDisplayString(command.invocationName, MAX_LABEL_LENGTH) ?? "Extension command";
+    return {
+        promptName: command.invocationName,
+        source: "extension",
+        command,
+        descriptor: {
+            schemaVersion: 1,
+            id: `extension.command.${opaqueId("ec", token, index)}`,
+            label,
+            description: boundedDisplayString(command.description, MAX_DESCRIPTION_LENGTH),
+            source: "extension",
+            ...safeSourceFields(command.sourceInfo),
+            category: "extension",
+            presentation: { kind: "palette", group: "Extensions" },
+            args: [rawArgumentsDescriptor(command.getArgumentCompletions ? "commandArguments" : undefined)],
+            enabled: true,
+            disabledReason: null,
+            destructive: false,
+            requiresConfirmation: false,
+            streamingBehavior: "immediate",
+            remoteSafe: command.remoteSafe === true,
+            slash: {
+                name: command.invocationName,
+                example: `/${command.invocationName}`,
+            },
+        },
+    };
+}
+function createPromptTemplateAction(template, index, token) {
+    const label = boundedDisplayString(template.name, MAX_LABEL_LENGTH) ?? "Prompt template";
+    return {
+        promptName: template.name,
+        source: "prompt",
+        descriptor: {
+            schemaVersion: 1,
+            id: `prompt.template.${opaqueId("pt", token, index)}`,
+            label,
+            description: boundedDisplayString(template.description, MAX_DESCRIPTION_LENGTH),
+            source: "prompt",
+            ...safeSourceFields(template.sourceInfo),
+            category: "prompt",
+            presentation: { kind: "palette", group: "Prompts" },
+            args: [rawArgumentsDescriptor(undefined, template.argumentHint)],
+            enabled: true,
+            disabledReason: null,
+            destructive: false,
+            requiresConfirmation: false,
+            streamingBehavior: ["queueSteer", "queueFollowUp"],
+            remoteSafe: true,
+            slash: {
+                name: template.name,
+                example: `/${template.name}`,
+            },
+        },
+    };
+}
+function createSkillAction(skill, index, token) {
+    const label = boundedDisplayString(skill.name, MAX_LABEL_LENGTH) ?? "Skill";
+    return {
+        promptName: `skill:${skill.name}`,
+        source: "skill",
+        descriptor: {
+            schemaVersion: 1,
+            id: `skill.${opaqueId("sk", token, index)}`,
+            label,
+            description: boundedDisplayString(skill.description, MAX_DESCRIPTION_LENGTH),
+            source: "skill",
+            ...safeSourceFields(skill.sourceInfo),
+            category: "skill",
+            presentation: { kind: "palette", group: "Skills" },
+            args: [rawArgumentsDescriptor()],
+            enabled: true,
+            disabledReason: null,
+            destructive: false,
+            requiresConfirmation: false,
+            streamingBehavior: ["queueSteer", "queueFollowUp"],
+            remoteSafe: true,
+            slash: {
+                name: `skill:${skill.name}`,
+                example: `/skill:${skill.name}`,
+            },
+        },
+    };
+}
+function getCatalogToken(session) {
+    const fingerprint = getCatalogFingerprint(session);
+    const existing = catalogStates.get(session);
+    if (existing?.fingerprint === fingerprint) {
+        return existing.token;
+    }
+    const next = {
+        fingerprint,
+        token: randomBytes(6).toString("hex"),
+    };
+    catalogStates.set(session, next);
+    return next.token;
+}
+function getCatalogFingerprint(session) {
+    return JSON.stringify({
+        commands: session.extensionRunner.getRegisteredCommands().map((command) => ({
+            description: command.description,
+            invocationName: command.invocationName,
+            name: command.name,
+            remoteSafe: command.remoteSafe === true,
+            sourceInfo: sourceFingerprint(command.sourceInfo),
+        })),
+        prompts: session.promptTemplates.map((template) => ({
+            argumentHint: template.argumentHint,
+            content: template.content,
+            description: template.description,
+            filePath: template.filePath,
+            name: template.name,
+            sourceInfo: sourceFingerprint(template.sourceInfo),
+        })),
+        skills: session.resourceLoader.getSkills().skills.map((skill) => ({
+            baseDir: skill.baseDir,
+            description: skill.description,
+            disableModelInvocation: skill.disableModelInvocation,
+            filePath: skill.filePath,
+            name: skill.name,
+            sourceInfo: sourceFingerprint(skill.sourceInfo),
+        })),
+    });
+}
+function sourceFingerprint(sourceInfo) {
+    return {
+        baseDir: sourceInfo.baseDir,
+        origin: sourceInfo.origin,
+        path: sourceInfo.path,
+        scope: sourceInfo.scope,
+        source: sourceInfo.source,
+    };
+}
+function getRawArguments(args, descriptors) {
+    const record = validateUiActionArgs(args, descriptors);
+    const unknownKeys = Object.keys(record).filter((key) => key !== "arguments");
+    if (unknownKeys.length > 0) {
+        throw new Error(`Unsupported prompt-like UI action argument: ${unknownKeys[0]}`);
+    }
+    const value = record.arguments;
+    if (value === undefined || value === null) {
+        return "";
+    }
+    if (typeof value !== "string") {
+        throw new Error('UI action argument "arguments" must be a string');
+    }
+    return value;
+}
+function createPromptText(promptName, rawArguments) {
+    return rawArguments.length > 0 ? `/${promptName} ${rawArguments}` : `/${promptName}`;
+}
+function getQueueBehavior(requested, allowed) {
+    if (requested !== "steer" && requested !== "followUp") {
+        throw new Error("UI action requires streamingBehavior ('steer' or 'followUp') while the agent is streaming");
+    }
+    const requiredBehavior = requested === "steer" ? "queueSteer" : "queueFollowUp";
+    if (!streamingBehaviorIncludes(allowed, requiredBehavior)) {
+        throw new Error(`UI action cannot be queued as ${requested}`);
+    }
+    return requested;
+}
+function streamingBehaviorIncludes(allowed, behavior) {
+    if (Array.isArray(allowed)) {
+        return allowed.includes(behavior);
+    }
+    return allowed === behavior;
+}
+function rawArgumentsDescriptor(completion, hint) {
+    const boundedHint = boundedDisplayString(hint, MAX_HINT_LENGTH);
+    return {
+        name: "arguments",
+        label: "Arguments",
+        type: "string",
+        required: false,
+        ...(boundedHint ? { hint: boundedHint, placeholder: boundedHint } : {}),
+        ...(completion ? { completion } : {}),
+    };
+}
+function safeSourceFields(sourceInfo) {
+    return {
+        sourceScope: sourceInfo.scope,
+        sourceOrigin: sourceInfo.origin,
+        sourceLabel: boundedDisplayString(getSafeSourceLabel(sourceInfo), MAX_SOURCE_LABEL_LENGTH),
+    };
+}
+function getSafeSourceLabel(sourceInfo) {
+    if (sourceInfo.origin === "package") {
+        return "Package";
+    }
+    switch (sourceInfo.scope) {
+        case "project":
+            return "Project";
+        case "user":
+            return "User";
+        case "temporary":
+            return "Temporary";
+    }
+}
+function opaqueId(prefix, token, index) {
+    return `${prefix}_${token}_${(index + 1).toString(36)}`;
+}
+function boundedDisplayString(value, maxLength) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = redactPathLikeText(value)
+        .replace(/[\r\n\t]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (!normalized) {
+        return undefined;
+    }
+    if (normalized.length <= maxLength) {
+        return normalized;
+    }
+    return `${normalized.slice(0, Math.max(0, maxLength - 3)).trimEnd()}...`;
+}
+function redactPathLikeText(value) {
+    return value
+        .replace(/(^|[\s("'`<])file:\/\/[^\s"'`<>]+/g, `$1${REDACTED_PATH}`)
+        .replace(/(^|[\s("'`<])~[^\s"'`<>]*\/[^\s"'`<>]+/g, `$1${REDACTED_PATH}`)
+        .replace(/(^|[\s("'`<])[A-Za-z]:[\\/][^\s"'`<>]+/g, `$1${REDACTED_PATH}`)
+        .replace(/(^|[\s("'`<])\/(?:[^\s"'`<>/]+\/)+[^\s"'`<>]*/g, `$1${REDACTED_PATH}`);
+}
+//# sourceMappingURL=ui-actions.js.map

package/dist/core/rpc/ui-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-actions.js","sourceRoot":"","sources":["../../../src/core/rpc/ui-actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAclE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAsCxC,MAAM,aAAa,GAAG,IAAI,OAAO,EAAkD,CAAC;AAEpF,MAAM,UAAU,sBAAsB,CACrC,OAAiC,EACjC,KAAyB,EACzB,OAAO,GAA8B,EAAE,EAChB;IACvB,MAAM,kBAAkB,GAAG,4BAA4B,CAAC,cAAc,CAAC;QACtE,OAAO,EAAE;YACR,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,WAAW,IAAI,KAAK;YACtD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK;YAC3C,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK;YACzC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,4BAA4B,EAAE,OAAO,CAAC,4BAA4B;SAClE;KACD,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,WAAW,GAChB,eAAe,KAAK,SAAS;QAC5B,CAAC,CAAC,kBAAkB;QACpB,CAAC,CAAC,CAAC,GAAG,kBAAkB,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAE7F,OAAO,WAAW;SAChB,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,oBAAoB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;SACzE,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,IAAI,UAAU,CAAC,UAAU,CAAC;SACxE,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;AAAA,CACxB;AAED,SAAS,0BAA0B,CAAC,KAAoC,EAAqB;IAC5F,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAAA,CACrF;AAED,SAAS,oBAAoB,CAAC,UAA8B,EAAE,KAAwB,EAAW;IAChG,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC;IAC3C,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,KAAK;YACT,OAAO,IAAI,CAAC;QACb,KAAK,SAAS;YACb,OAAO,UAAU,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC;QAClF,KAAK,SAAS;YACb,OAAO,IAAI,KAAK,SAAS,CAAC;QAC3B;YACC,OAAO,IAAI,CAAC;IACd,CAAC;AAAA,CACD;AAED,MAAM,UAAU,4BAA4B,CAC3C,OAA4D,EAC5D,OAKC,EACwB;IACzB,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1G,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,IAAI,0BAA0B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAChF,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACpE,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO;YACN,UAAU;YACV,QAAQ,EAAE;gBACT,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;gBAC3B,MAAM,EAAE,SAAS;aACjB;SACD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC1B,OAAO;YACN,UAAU;YACV,QAAQ,EAAE;gBACT,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;gBAC3B,MAAM,EAAE,UAAU;aAClB;SACD,CAAC;IACH,CAAC;IAED,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAC1G,OAAO;QACN,UAAU;QACV,uBAAuB,EAAE,iBAAiB;QAC1C,QAAQ,EAAE;YACT,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;YAC3B,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,iBAAiB;SAC3B;KACD,CAAC;AAAA,CACF;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,OAAiC,EACjC,OAKC,EACqC;IACtC,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1G,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,KAAK,kBAAkB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAC1F,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,sBAAsB,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACrF,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;SACxB,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACrB,KAAK,EAAE,oBAAoB,CAAC,UAAU,CAAC,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE;QACrE,KAAK,EAAE,oBAAoB,CAAC,UAAU,CAAC,KAAK,EAAE,gBAAgB,CAAC;QAC/D,WAAW,EAAE,oBAAoB,CAAC,UAAU,CAAC,WAAW,EAAE,sBAAsB,CAAC;KACjF,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACnD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAAA,CACf;AAED,SAAS,kBAAkB,CAAC,OAAiC,EAA0B;IACtF,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,gBAAgB,GAAG,OAAO,CAAC,eAAe;SAC9C,qBAAqB,EAAE;SACvB,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,4BAA4B,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CACrE,0BAA0B,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAClD,CAAC;IACF,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc;SACzC,SAAS,EAAE;SACX,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEvE,OAAO,CAAC,GAAG,gBAAgB,EAAE,GAAG,aAAa,EAAE,GAAG,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;AAAA,CACtF;AAED,SAAS,4BAA4B,CAAC,OAAwB,EAAE,KAAa,EAAE,KAAa,EAAwB;IACnH,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,cAAc,EAAE,gBAAgB,CAAC,IAAI,mBAAmB,CAAC;IACpG,OAAO;QACN,UAAU,EAAE,OAAO,CAAC,cAAc;QAClC,MAAM,EAAE,WAAW;QACnB,OAAO;QACP,UAAU,EAAE;YACX,aAAa,EAAE,CAAC;YAChB,EAAE,EAAE,qBAAqB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE;YACvD,KAAK;YACL,WAAW,EAAE,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,sBAAsB,CAAC;YAC9E,MAAM,EAAE,WAAW;YACnB,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC;YACvC,QAAQ,EAAE,WAAW;YACrB,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE;YACtD,IAAI,EAAE,CAAC,sBAAsB,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC/F,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,KAAK;YAClB,oBAAoB,EAAE,KAAK;YAC3B,iBAAiB,EAAE,WAAW;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,IAAI;YACvC,KAAK,EAAE;gBACN,IAAI,EAAE,OAAO,CAAC,cAAc;gBAC5B,OAAO,EAAE,IAAI,OAAO,CAAC,cAAc,EAAE;aACrC;SACD;KACD,CAAC;AAAA,CACF;AAED,SAAS,0BAA0B,CAAC,QAAwB,EAAE,KAAa,EAAE,KAAa,EAAwB;IACjH,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,iBAAiB,CAAC;IACzF,OAAO;QACN,UAAU,EAAE,QAAQ,CAAC,IAAI;QACzB,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE;YACX,aAAa,EAAE,CAAC;YAChB,EAAE,EAAE,mBAAmB,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE;YACrD,KAAK;YACL,WAAW,EAAE,oBAAoB,CAAC,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;YAC/E,MAAM,EAAE,QAAQ;YAChB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC;YACxC,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;YACnD,IAAI,EAAE,CAAC,sBAAsB,CAAC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;YAChE,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,KAAK;YAClB,oBAAoB,EAAE,KAAK;YAC3B,iBAAiB,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC;YAClD,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE;gBACN,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,OAAO,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE;aAC5B;SACD;KACD,CAAC;AAAA,CACF;AAED,SAAS,iBAAiB,CAAC,KAAY,EAAE,KAAa,EAAE,KAAa,EAAwB;IAC5F,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,OAAO,CAAC;IAC5E,OAAO;QACN,UAAU,EAAE,SAAS,KAAK,CAAC,IAAI,EAAE;QACjC,MAAM,EAAE,OAAO;QACf,UAAU,EAAE;YACX,aAAa,EAAE,CAAC;YAChB,EAAE,EAAE,SAAS,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE;YAC3C,KAAK;YACL,WAAW,EAAE,oBAAoB,CAAC,KAAK,CAAC,WAAW,EAAE,sBAAsB,CAAC;YAC5E,MAAM,EAAE,OAAO;YACf,GAAG,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC;YACrC,QAAQ,EAAE,OAAO;YACjB,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE;YAClD,IAAI,EAAE,CAAC,sBAAsB,EAAE,CAAC;YAChC,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,KAAK;YAClB,oBAAoB,EAAE,KAAK;YAC3B,iBAAiB,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC;YAClD,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE;gBACN,IAAI,EAAE,SAAS,KAAK,CAAC,IAAI,EAAE;gBAC3B,OAAO,EAAE,UAAU,KAAK,CAAC,IAAI,EAAE;aAC/B;SACD;KACD,CAAC;AAAA,CACF;AAED,SAAS,eAAe,CAAC,OAAiC,EAAU;IACnE,MAAM,WAAW,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,QAAQ,EAAE,WAAW,KAAK,WAAW,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC;IACvB,CAAC;IACD,MAAM,IAAI,GAAG;QACZ,WAAW;QACX,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;KACrC,CAAC;IACF,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC;AAAA,CAClB;AAED,SAAS,qBAAqB,CAAC,OAAiC,EAAU;IACzE,OAAO,IAAI,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,qBAAqB,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC3E,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU,KAAK,IAAI;YACvC,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC;SACjD,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACnD,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,UAAU,EAAE,iBAAiB,CAAC,QAAQ,CAAC,UAAU,CAAC;SAClD,CAAC,CAAC;QACH,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACjE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;YACpD,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC;SAC/C,CAAC,CAAC;KACH,CAAC,CAAC;AAAA,CACH;AAED,SAAS,iBAAiB,CAAC,UAAsB,EAAsC;IACtF,OAAO;QACN,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,MAAM,EAAE,UAAU,CAAC,MAAM;KACzB,CAAC;AAAA,CACF;AAED,SAAS,eAAe,CAAC,IAAa,EAAE,WAAsD,EAAU;IACvG,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,CAAC,CAAC;IAC7E,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,+CAA+C,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC;IAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACX,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AAAA,CACb;AAED,SAAS,gBAAgB,CAAC,UAAkB,EAAE,YAAoB,EAAU;IAC3E,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC;AAAA,CACrF;AAED,SAAS,gBAAgB,CACxB,SAAkB,EAClB,OAAgD,EACd;IAClC,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAC;IAC9G,CAAC;IACD,MAAM,gBAAgB,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC;IAChF,IAAI,CAAC,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,SAAS,yBAAyB,CACjC,OAAgD,EAChD,QAAmC,EACzB;IACV,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,KAAK,QAAQ,CAAC;AAAA,CAC5B;AAED,SAAS,sBAAsB,CAC9B,UAAqD,EACrD,IAAa,EACgB;IAC7B,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAChE,OAAO;QACN,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;QACf,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrC,CAAC;AAAA,CACF;AAED,SAAS,gBAAgB,CACxB,UAAsB,EACqD;IAC3E,OAAO;QACN,WAAW,EAAE,UAAU,CAAC,KAAK;QAC7B,YAAY,EAAE,UAAU,CAAC,MAAM;QAC/B,WAAW,EAAE,oBAAoB,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,uBAAuB,CAAC;KAC1F,CAAC;AAAA,CACF;AAED,SAAS,kBAAkB,CAAC,UAAsB,EAAU;IAC3D,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,QAAQ,UAAU,CAAC,KAAK,EAAE,CAAC;QAC1B,KAAK,SAAS;YACb,OAAO,SAAS,CAAC;QAClB,KAAK,MAAM;YACV,OAAO,MAAM,CAAC;QACf,KAAK,WAAW;YACf,OAAO,WAAW,CAAC;IACrB,CAAC;AAAA,CACD;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,KAAa,EAAE,KAAa,EAAU;IACvE,OAAO,GAAG,MAAM,IAAI,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAAA,CACxD;AAED,SAAS,oBAAoB,CAAC,KAAyB,EAAE,SAAiB,EAAsB;IAC/F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC;SAC1C,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC;SAC1B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACT,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACpC,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC;AAAA,CACzE;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAU;IAClD,OAAO,KAAK;SACV,OAAO,CAAC,oCAAoC,EAAE,KAAK,aAAa,EAAE,CAAC;SACnE,OAAO,CAAC,yCAAyC,EAAE,KAAK,aAAa,EAAE,CAAC;SACxE,OAAO,CAAC,yCAAyC,EAAE,KAAK,aAAa,EAAE,CAAC;SACxE,OAAO,CAAC,gDAAgD,EAAE,KAAK,aAAa,EAAE,CAAC,CAAC;AAAA,CAClF","sourcesContent":["import { randomBytes } from \"node:crypto\";\nimport type { ThinkingLevel } from \"@hansjm10/volt-agent-core\";\nimport type { Api, Model } from \"@hansjm10/volt-ai\";\nimport type { ResolvedCommand } from \"../extensions/types.ts\";\nimport { BUILTIN_HOST_ACTION_REGISTRY } from \"../host-actions.ts\";\nimport type { PromptTemplate } from \"../prompt-templates.ts\";\nimport type { ResourceLoader } from \"../resource-loader.ts\";\nimport type { Skill } from \"../skills.ts\";\nimport type { SourceInfo } from \"../source-info.ts\";\nimport type {\n\tUiActionArgumentDescriptor,\n\tUiActionDescriptor,\n\tUiActionInvocationQueueBehavior,\n\tUiActionInvocationResponse,\n\tUiActionListScope,\n\tUiActionOptionDescriptor,\n\tUiActionStreamingBehavior,\n} from \"./types.ts\";\nimport { validateUiActionArgs } from \"./ui-action-args.ts\";\n\nconst MAX_ACTIONS = 200;\nconst MAX_LABEL_LENGTH = 80;\nconst MAX_DESCRIPTION_LENGTH = 240;\nconst MAX_SOURCE_LABEL_LENGTH = 80;\nconst MAX_HINT_LENGTH = 160;\nconst REDACTED_PATH = \"[redacted path]\";\n\nexport interface UiActionDiscoverySession {\n\textensionRunner: {\n\t\tgetRegisteredCommands(): ResolvedCommand[];\n\t};\n\tisBusy?: boolean;\n\tisCompacting?: boolean;\n\tisStreaming?: boolean;\n\tmodel?: Model<Api>;\n\tthinkingLevel?: ThinkingLevel;\n\tfastModeRestoreThinkingLevel?: ThinkingLevel;\n\tpromptTemplates: ReadonlyArray<PromptTemplate>;\n\tresourceLoader: Pick<ResourceLoader, \"getSkills\">;\n}\n\nexport interface UiActionInvocationPlan {\n\tpromptText: string;\n\tpromptStreamingBehavior?: UiActionInvocationQueueBehavior;\n\tresponse: UiActionInvocationResponse;\n}\n\nexport interface UiActionDescriptorOptions {\n\tremoteSafeOnly?: boolean;\n}\n\ninterface UiActionCatalogState {\n\tfingerprint: string;\n\ttoken: string;\n}\n\ninterface UiActionCatalogEntry {\n\tdescriptor: UiActionDescriptor;\n\tpromptName: string;\n\tsource: \"extension\" | \"prompt\" | \"skill\";\n\tcommand?: ResolvedCommand;\n}\n\nconst catalogStates = new WeakMap<UiActionDiscoverySession, UiActionCatalogState>();\n\nexport function getUiActionDescriptors(\n\tsession: UiActionDiscoverySession,\n\tscope?: UiActionListScope,\n\toptions: UiActionDescriptorOptions = {},\n): UiActionDescriptor[] {\n\tconst builtinDescriptors = BUILTIN_HOST_ACTION_REGISTRY.getDescriptors({\n\t\tsession: {\n\t\t\tisBusy: session.isBusy ?? session.isStreaming ?? false,\n\t\t\tisCompacting: session.isCompacting ?? false,\n\t\t\tisStreaming: session.isStreaming ?? false,\n\t\t\tmodel: session.model,\n\t\t\tthinkingLevel: session.thinkingLevel,\n\t\t\tfastModeRestoreThinkingLevel: session.fastModeRestoreThinkingLevel,\n\t\t},\n\t});\n\tconst normalizedScope = normalizeUiActionListScope(scope);\n\tconst descriptors =\n\t\tnormalizedScope === \"primary\"\n\t\t\t? builtinDescriptors\n\t\t\t: [...builtinDescriptors, ...getUiActionCatalog(session).map((entry) => entry.descriptor)];\n\n\treturn descriptors\n\t\t.filter((descriptor) => matchesUiActionScope(descriptor, normalizedScope))\n\t\t.filter((descriptor) => !options.remoteSafeOnly || descriptor.remoteSafe)\n\t\t.slice(0, MAX_ACTIONS);\n}\n\nfunction normalizeUiActionListScope(scope: UiActionListScope | undefined): UiActionListScope {\n\treturn scope === \"primary\" || scope === \"palette\" || scope === \"all\" ? scope : \"all\";\n}\n\nfunction matchesUiActionScope(descriptor: UiActionDescriptor, scope: UiActionListScope): boolean {\n\tconst kind = descriptor.presentation?.kind;\n\tswitch (scope) {\n\t\tcase \"all\":\n\t\t\treturn true;\n\t\tcase \"primary\":\n\t\t\treturn descriptor.source === \"builtin\" && (kind === \"card\" || kind === \"toggle\");\n\t\tcase \"palette\":\n\t\t\treturn kind === \"palette\";\n\t\tdefault:\n\t\t\treturn true;\n\t}\n}\n\nexport function createUiActionInvocationPlan(\n\tsession: UiActionDiscoverySession & { isStreaming: boolean },\n\toptions: {\n\t\taction: string;\n\t\targs?: unknown;\n\t\trequireRemoteSafe?: boolean;\n\t\tstreamingBehavior?: unknown;\n\t},\n): UiActionInvocationPlan {\n\tif (typeof options.action !== \"string\" || options.action.length === 0) {\n\t\tthrow new Error(\"UI action id must be a non-empty string\");\n\t}\n\n\tconst entry = getUiActionCatalog(session).find((candidate) => candidate.descriptor.id === options.action);\n\tif (!entry) {\n\t\tthrow new Error(`UI action not available: ${options.action}`);\n\t}\n\tif (options.requireRemoteSafe && !entry.descriptor.remoteSafe) {\n\t\tthrow new Error(`UI action not available over remote host: ${options.action}`);\n\t}\n\tif (!entry.descriptor.enabled) {\n\t\tthrow new Error(entry.descriptor.disabledReason ?? `UI action is disabled: ${options.action}`);\n\t}\n\n\tconst rawArguments = getRawArguments(options.args, entry.descriptor.args ?? []);\n\tconst promptText = createPromptText(entry.promptName, rawArguments);\n\tif (entry.source === \"extension\") {\n\t\treturn {\n\t\t\tpromptText,\n\t\t\tresponse: {\n\t\t\t\taction: entry.descriptor.id,\n\t\t\t\tstatus: \"handled\",\n\t\t\t},\n\t\t};\n\t}\n\n\tif (!session.isStreaming) {\n\t\treturn {\n\t\t\tpromptText,\n\t\t\tresponse: {\n\t\t\t\taction: entry.descriptor.id,\n\t\t\t\tstatus: \"accepted\",\n\t\t\t},\n\t\t};\n\t}\n\n\tconst streamingBehavior = getQueueBehavior(options.streamingBehavior, entry.descriptor.streamingBehavior);\n\treturn {\n\t\tpromptText,\n\t\tpromptStreamingBehavior: streamingBehavior,\n\t\tresponse: {\n\t\t\taction: entry.descriptor.id,\n\t\t\tstatus: \"queued\",\n\t\t\tqueuedAs: streamingBehavior,\n\t\t},\n\t};\n}\n\nexport async function getUiActionCompletions(\n\tsession: UiActionDiscoverySession,\n\toptions: {\n\t\taction: string;\n\t\targument: string;\n\t\tprefix?: unknown;\n\t\trequireRemoteSafe?: boolean;\n\t},\n): Promise<UiActionOptionDescriptor[]> {\n\tif (typeof options.action !== \"string\" || options.action.length === 0) {\n\t\tthrow new Error(\"UI action id must be a non-empty string\");\n\t}\n\tif (typeof options.argument !== \"string\" || options.argument.length === 0) {\n\t\tthrow new Error(\"UI action argument name must be a non-empty string\");\n\t}\n\tif (options.prefix !== undefined && typeof options.prefix !== \"string\") {\n\t\tthrow new Error(\"UI action completion prefix must be a string\");\n\t}\n\n\tconst entry = getUiActionCatalog(session).find((candidate) => candidate.descriptor.id === options.action);\n\tif (!entry) {\n\t\tthrow new Error(`UI action not available: ${options.action}`);\n\t}\n\tif (options.requireRemoteSafe && !entry.descriptor.remoteSafe) {\n\t\tthrow new Error(`UI action not available over remote host: ${options.action}`);\n\t}\n\n\tconst argument = (entry.descriptor.args ?? []).find((candidate) => candidate.name === options.argument);\n\tif (!argument) {\n\t\tthrow new Error(`UI action argument not available: ${options.argument}`);\n\t}\n\tif (argument.completion !== \"commandArguments\" || !entry.command?.getArgumentCompletions) {\n\t\treturn [];\n\t}\n\n\tconst completions = await entry.command.getArgumentCompletions(options.prefix ?? \"\");\n\treturn (completions ?? [])\n\t\t.map((completion) => ({\n\t\t\tvalue: boundedDisplayString(completion.value, MAX_LABEL_LENGTH) ?? \"\",\n\t\t\tlabel: boundedDisplayString(completion.label, MAX_LABEL_LENGTH),\n\t\t\tdescription: boundedDisplayString(completion.description, MAX_DESCRIPTION_LENGTH),\n\t\t}))\n\t\t.filter((completion) => completion.value.length > 0)\n\t\t.slice(0, 50);\n}\n\nfunction getUiActionCatalog(session: UiActionDiscoverySession): UiActionCatalogEntry[] {\n\tconst token = getCatalogToken(session);\n\tconst extensionActions = session.extensionRunner\n\t\t.getRegisteredCommands()\n\t\t.map((command, index) => createExtensionCommandAction(command, index, token));\n\tconst promptActions = session.promptTemplates.map((template, index) =>\n\t\tcreatePromptTemplateAction(template, index, token),\n\t);\n\tconst skillActions = session.resourceLoader\n\t\t.getSkills()\n\t\t.skills.map((skill, index) => createSkillAction(skill, index, token));\n\n\treturn [...extensionActions, ...promptActions, ...skillActions].slice(0, MAX_ACTIONS);\n}\n\nfunction createExtensionCommandAction(command: ResolvedCommand, index: number, token: string): UiActionCatalogEntry {\n\tconst label = boundedDisplayString(command.invocationName, MAX_LABEL_LENGTH) ?? \"Extension command\";\n\treturn {\n\t\tpromptName: command.invocationName,\n\t\tsource: \"extension\",\n\t\tcommand,\n\t\tdescriptor: {\n\t\t\tschemaVersion: 1,\n\t\t\tid: `extension.command.${opaqueId(\"ec\", token, index)}`,\n\t\t\tlabel,\n\t\t\tdescription: boundedDisplayString(command.description, MAX_DESCRIPTION_LENGTH),\n\t\t\tsource: \"extension\",\n\t\t\t...safeSourceFields(command.sourceInfo),\n\t\t\tcategory: \"extension\",\n\t\t\tpresentation: { kind: \"palette\", group: \"Extensions\" },\n\t\t\targs: [rawArgumentsDescriptor(command.getArgumentCompletions ? \"commandArguments\" : undefined)],\n\t\t\tenabled: true,\n\t\t\tdisabledReason: null,\n\t\t\tdestructive: false,\n\t\t\trequiresConfirmation: false,\n\t\t\tstreamingBehavior: \"immediate\",\n\t\t\tremoteSafe: command.remoteSafe === true,\n\t\t\tslash: {\n\t\t\t\tname: command.invocationName,\n\t\t\t\texample: `/${command.invocationName}`,\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction createPromptTemplateAction(template: PromptTemplate, index: number, token: string): UiActionCatalogEntry {\n\tconst label = boundedDisplayString(template.name, MAX_LABEL_LENGTH) ?? \"Prompt template\";\n\treturn {\n\t\tpromptName: template.name,\n\t\tsource: \"prompt\",\n\t\tdescriptor: {\n\t\t\tschemaVersion: 1,\n\t\t\tid: `prompt.template.${opaqueId(\"pt\", token, index)}`,\n\t\t\tlabel,\n\t\t\tdescription: boundedDisplayString(template.description, MAX_DESCRIPTION_LENGTH),\n\t\t\tsource: \"prompt\",\n\t\t\t...safeSourceFields(template.sourceInfo),\n\t\t\tcategory: \"prompt\",\n\t\t\tpresentation: { kind: \"palette\", group: \"Prompts\" },\n\t\t\targs: [rawArgumentsDescriptor(undefined, template.argumentHint)],\n\t\t\tenabled: true,\n\t\t\tdisabledReason: null,\n\t\t\tdestructive: false,\n\t\t\trequiresConfirmation: false,\n\t\t\tstreamingBehavior: [\"queueSteer\", \"queueFollowUp\"],\n\t\t\tremoteSafe: true,\n\t\t\tslash: {\n\t\t\t\tname: template.name,\n\t\t\t\texample: `/${template.name}`,\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction createSkillAction(skill: Skill, index: number, token: string): UiActionCatalogEntry {\n\tconst label = boundedDisplayString(skill.name, MAX_LABEL_LENGTH) ?? \"Skill\";\n\treturn {\n\t\tpromptName: `skill:${skill.name}`,\n\t\tsource: \"skill\",\n\t\tdescriptor: {\n\t\t\tschemaVersion: 1,\n\t\t\tid: `skill.${opaqueId(\"sk\", token, index)}`,\n\t\t\tlabel,\n\t\t\tdescription: boundedDisplayString(skill.description, MAX_DESCRIPTION_LENGTH),\n\t\t\tsource: \"skill\",\n\t\t\t...safeSourceFields(skill.sourceInfo),\n\t\t\tcategory: \"skill\",\n\t\t\tpresentation: { kind: \"palette\", group: \"Skills\" },\n\t\t\targs: [rawArgumentsDescriptor()],\n\t\t\tenabled: true,\n\t\t\tdisabledReason: null,\n\t\t\tdestructive: false,\n\t\t\trequiresConfirmation: false,\n\t\t\tstreamingBehavior: [\"queueSteer\", \"queueFollowUp\"],\n\t\t\tremoteSafe: true,\n\t\t\tslash: {\n\t\t\t\tname: `skill:${skill.name}`,\n\t\t\t\texample: `/skill:${skill.name}`,\n\t\t\t},\n\t\t},\n\t};\n}\n\nfunction getCatalogToken(session: UiActionDiscoverySession): string {\n\tconst fingerprint = getCatalogFingerprint(session);\n\tconst existing = catalogStates.get(session);\n\tif (existing?.fingerprint === fingerprint) {\n\t\treturn existing.token;\n\t}\n\tconst next = {\n\t\tfingerprint,\n\t\ttoken: randomBytes(6).toString(\"hex\"),\n\t};\n\tcatalogStates.set(session, next);\n\treturn next.token;\n}\n\nfunction getCatalogFingerprint(session: UiActionDiscoverySession): string {\n\treturn JSON.stringify({\n\t\tcommands: session.extensionRunner.getRegisteredCommands().map((command) => ({\n\t\t\tdescription: command.description,\n\t\t\tinvocationName: command.invocationName,\n\t\t\tname: command.name,\n\t\t\tremoteSafe: command.remoteSafe === true,\n\t\t\tsourceInfo: sourceFingerprint(command.sourceInfo),\n\t\t})),\n\t\tprompts: session.promptTemplates.map((template) => ({\n\t\t\targumentHint: template.argumentHint,\n\t\t\tcontent: template.content,\n\t\t\tdescription: template.description,\n\t\t\tfilePath: template.filePath,\n\t\t\tname: template.name,\n\t\t\tsourceInfo: sourceFingerprint(template.sourceInfo),\n\t\t})),\n\t\tskills: session.resourceLoader.getSkills().skills.map((skill) => ({\n\t\t\tbaseDir: skill.baseDir,\n\t\t\tdescription: skill.description,\n\t\t\tdisableModelInvocation: skill.disableModelInvocation,\n\t\t\tfilePath: skill.filePath,\n\t\t\tname: skill.name,\n\t\t\tsourceInfo: sourceFingerprint(skill.sourceInfo),\n\t\t})),\n\t});\n}\n\nfunction sourceFingerprint(sourceInfo: SourceInfo): Record<string, string | undefined> {\n\treturn {\n\t\tbaseDir: sourceInfo.baseDir,\n\t\torigin: sourceInfo.origin,\n\t\tpath: sourceInfo.path,\n\t\tscope: sourceInfo.scope,\n\t\tsource: sourceInfo.source,\n\t};\n}\n\nfunction getRawArguments(args: unknown, descriptors: ReadonlyArray<UiActionArgumentDescriptor>): string {\n\tconst record = validateUiActionArgs(args, descriptors);\n\tconst unknownKeys = Object.keys(record).filter((key) => key !== \"arguments\");\n\tif (unknownKeys.length > 0) {\n\t\tthrow new Error(`Unsupported prompt-like UI action argument: ${unknownKeys[0]}`);\n\t}\n\tconst value = record.arguments;\n\tif (value === undefined || value === null) {\n\t\treturn \"\";\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error('UI action argument \"arguments\" must be a string');\n\t}\n\treturn value;\n}\n\nfunction createPromptText(promptName: string, rawArguments: string): string {\n\treturn rawArguments.length > 0 ? `/${promptName} ${rawArguments}` : `/${promptName}`;\n}\n\nfunction getQueueBehavior(\n\trequested: unknown,\n\tallowed: UiActionDescriptor[\"streamingBehavior\"],\n): UiActionInvocationQueueBehavior {\n\tif (requested !== \"steer\" && requested !== \"followUp\") {\n\t\tthrow new Error(\"UI action requires streamingBehavior ('steer' or 'followUp') while the agent is streaming\");\n\t}\n\tconst requiredBehavior = requested === \"steer\" ? \"queueSteer\" : \"queueFollowUp\";\n\tif (!streamingBehaviorIncludes(allowed, requiredBehavior)) {\n\t\tthrow new Error(`UI action cannot be queued as ${requested}`);\n\t}\n\treturn requested;\n}\n\nfunction streamingBehaviorIncludes(\n\tallowed: UiActionDescriptor[\"streamingBehavior\"],\n\tbehavior: UiActionStreamingBehavior,\n): boolean {\n\tif (Array.isArray(allowed)) {\n\t\treturn allowed.includes(behavior);\n\t}\n\treturn allowed === behavior;\n}\n\nfunction rawArgumentsDescriptor(\n\tcompletion?: UiActionArgumentDescriptor[\"completion\"],\n\thint?: string,\n): UiActionArgumentDescriptor {\n\tconst boundedHint = boundedDisplayString(hint, MAX_HINT_LENGTH);\n\treturn {\n\t\tname: \"arguments\",\n\t\tlabel: \"Arguments\",\n\t\ttype: \"string\",\n\t\trequired: false,\n\t\t...(boundedHint ? { hint: boundedHint, placeholder: boundedHint } : {}),\n\t\t...(completion ? { completion } : {}),\n\t};\n}\n\nfunction safeSourceFields(\n\tsourceInfo: SourceInfo,\n): Pick<UiActionDescriptor, \"sourceScope\" | \"sourceOrigin\" | \"sourceLabel\"> {\n\treturn {\n\t\tsourceScope: sourceInfo.scope,\n\t\tsourceOrigin: sourceInfo.origin,\n\t\tsourceLabel: boundedDisplayString(getSafeSourceLabel(sourceInfo), MAX_SOURCE_LABEL_LENGTH),\n\t};\n}\n\nfunction getSafeSourceLabel(sourceInfo: SourceInfo): string {\n\tif (sourceInfo.origin === \"package\") {\n\t\treturn \"Package\";\n\t}\n\n\tswitch (sourceInfo.scope) {\n\t\tcase \"project\":\n\t\t\treturn \"Project\";\n\t\tcase \"user\":\n\t\t\treturn \"User\";\n\t\tcase \"temporary\":\n\t\t\treturn \"Temporary\";\n\t}\n}\n\nfunction opaqueId(prefix: string, token: string, index: number): string {\n\treturn `${prefix}_${token}_${(index + 1).toString(36)}`;\n}\n\nfunction boundedDisplayString(value: string | undefined, maxLength: number): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tconst normalized = redactPathLikeText(value)\n\t\t.replace(/[\\r\\n\\t]+/g, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n\tif (!normalized) {\n\t\treturn undefined;\n\t}\n\tif (normalized.length <= maxLength) {\n\t\treturn normalized;\n\t}\n\treturn `${normalized.slice(0, Math.max(0, maxLength - 3)).trimEnd()}...`;\n}\n\nfunction redactPathLikeText(value: string): string {\n\treturn value\n\t\t.replace(/(^|[\\s(\"'`<])file:\\/\\/[^\\s\"'`<>]+/g, `$1${REDACTED_PATH}`)\n\t\t.replace(/(^|[\\s(\"'`<])~[^\\s\"'`<>]*\\/[^\\s\"'`<>]+/g, `$1${REDACTED_PATH}`)\n\t\t.replace(/(^|[\\s(\"'`<])[A-Za-z]:[\\\\/][^\\s\"'`<>]+/g, `$1${REDACTED_PATH}`)\n\t\t.replace(/(^|[\\s(\"'`<])\\/(?:[^\\s\"'`<>/]+\\/)+[^\\s\"'`<>]*/g, `$1${REDACTED_PATH}`);\n}\n"]}

package/dist/core/sdk.d.ts

@@ -0,0 +1,138 @@
+import { type ThinkingLevel } from "@hansjm10/volt-agent-core";
+import { type Model } from "@hansjm10/volt-ai";
+import { AgentSession } from "./agent-session.ts";
+import { AuthStorage } from "./auth-storage.ts";
+import type { LoadExtensionsResult, SessionStartEvent, ToolDefinition } from "./extensions/index.ts";
+import type { HostInteraction } from "./host-interaction.ts";
+import { McpManager } from "./mcp/manager.ts";
+import { ModelRegistry } from "./model-registry.ts";
+import type { ResourceLoader } from "./resource-loader.ts";
+import { SessionManager } from "./session-manager.ts";
+import { SettingsManager } from "./settings-manager.ts";
+import { createBashTool, createCodingTools, createEditTool, createFindTool, createGrepTool, createLspTool, createLsTool, createReadOnlyTools, createReadTool, createSubagentTool, createWebSearchTool, createWriteTool, type SubagentToolManager, withFileMutationQueue } from "./tools/index.ts";
+export interface CreateAgentSessionOptions {
+    /** Runtime working directory for tools and session metadata. Default: process.cwd() */
+    cwd?: string;
+    /** Project/config root for .volt resources. Defaults to cwd. */
+    projectCwd?: string;
+    /** Global config directory. Default: ~/.volt/agent */
+    agentDir?: string;
+    /** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json) */
+    authStorage?: AuthStorage;
+    /** Model registry. Default: ModelRegistry.create(authStorage, agentDir/models.json) */
+    modelRegistry?: ModelRegistry;
+    /** Model to use. Default: from settings, else first available */
+    model?: Model<any>;
+    /** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */
+    thinkingLevel?: ThinkingLevel;
+    /** Models available for cycling (Ctrl+P in interactive mode) */
+    scopedModels?: Array<{
+        model: Model<any>;
+        thinkingLevel?: ThinkingLevel;
+    }>;
+    /**
+     * Optional default tool suppression mode when no explicit allowlist is provided.
+     *
+     * - "all": start with no tools enabled
+     * - "builtin": disable the default built-in tools (read, bash, edit, write,
+     *   web_search, and subagent when a manager is supplied) but keep extension/custom tools enabled
+     */
+    noTools?: "all" | "builtin";
+    /**
+     * Optional allowlist of tool names.
+     *
+     * When omitted, volt enables the default built-in tools (read, bash, edit, write,
+     * web_search, and subagent when a manager is supplied) and leaves extension/custom tools enabled
+     * unless `noTools` changes that default.
+     * When provided, only the listed tool names are enabled.
+     */
+    tools?: string[];
+    /** Allow extension and SDK custom tools even when they are absent from `tools`. */
+    allowUnlistedExtensionTools?: boolean;
+    /** Optional denylist of tool names to disable. Applies after `tools` when both are provided. */
+    excludeTools?: string[];
+    /** Custom tools to register (in addition to built-in tools). */
+    customTools?: ToolDefinition[];
+    /** Resource loader. When omitted, DefaultResourceLoader is used. */
+    resourceLoader?: ResourceLoader;
+    /** Session manager. Default: SessionManager.create(cwd) */
+    sessionManager?: SessionManager;
+    /** Settings profile to apply when creating the default SettingsManager. */
+    profile?: string;
+    /**
+     * Whether project-local resources should be trusted when this SDK call creates
+     * trust-sensitive runtime helpers. CLI modes pass an already-resolved
+     * SettingsManager; bare SDK calls default MCP project config to untrusted.
+     */
+    projectTrusted?: boolean;
+    /** Settings manager. Default: SettingsManager.create(projectCwd, agentDir) */
+    settingsManager?: SettingsManager;
+    /** Session start event metadata for extension runtime startup. */
+    sessionStartEvent?: SessionStartEvent;
+    /** Optional host interaction bridge for blocking host-initiated actions. */
+    hostInteraction?: HostInteraction;
+    /** Optional manager enabling the built-in subagent tool when selected. */
+    subagentToolManager?: SubagentToolManager;
+    /** Optional manager enabling the native MCP gateway tool when selected. */
+    mcpManager?: McpManager;
+    /**
+     * Skip MCP entirely for this session: no default MCP manager is created, no
+     * MCP servers are started, and the native MCP gateway/direct tools are
+     * unavailable. Overrides `mcpManager` when both are set. Used by isolated
+     * sessions (e.g. the built-in reviewer) that must not spin up the user's MCP
+     * servers.
+     */
+    disableMcp?: boolean;
+}
+/** Result from createAgentSession */
+export interface CreateAgentSessionResult {
+    /** The created session */
+    session: AgentSession;
+    /** Extensions result (for UI context setup in interactive mode) */
+    extensionsResult: LoadExtensionsResult;
+    /** Warning if session was restored with a different model than saved */
+    modelFallbackMessage?: string;
+}
+export * from "./agent-session-runtime.ts";
+export type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, ExtensionFactory, SlashCommandInfo, SlashCommandSource, ToolDefinition, } from "./extensions/index.ts";
+export type { PromptTemplate } from "./prompt-templates.ts";
+export type { Skill } from "./skills.ts";
+export type { Tool } from "./tools/index.ts";
+export { withFileMutationQueue, createCodingTools, createReadOnlyTools, createReadTool, createBashTool, createEditTool, createWriteTool, createGrepTool, createFindTool, createLsTool, createLspTool, createSubagentTool, createWebSearchTool, };
+/**
+ * Create an AgentSession with the specified options.
+ *
+ * @example
+ * ```typescript
+ * // Minimal - uses defaults
+ * const { session } = await createAgentSession();
+ *
+ * // With explicit model
+ * import { getModel } from '@hansjm10/volt-ai';
+ * const { session } = await createAgentSession({
+ *   model: getModel('anthropic', 'claude-opus-4-5'),
+ *   thinkingLevel: 'high',
+ * });
+ *
+ * // Continue previous session
+ * const { session, modelFallbackMessage } = await createAgentSession({
+ *   continueSession: true,
+ * });
+ *
+ * // Full control
+ * const loader = new DefaultResourceLoader({
+ *   cwd: process.cwd(),
+ *   agentDir: getAgentDir(),
+ *   settingsManager: SettingsManager.create(),
+ * });
+ * await loader.reload();
+ * const { session } = await createAgentSession({
+ *   model: myModel,
+ *   tools: ["read", "bash"],
+ *   resourceLoader: loader,
+ *   sessionManager: SessionManager.inMemory(),
+ * });
+ * ```
+ */
+export declare function createAgentSession(options?: CreateAgentSessionOptions): Promise<CreateAgentSessionResult>;
+//# sourceMappingURL=sdk.d.ts.map

package/dist/core/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport { Agent, type AgentMessage, type ThinkingLevel } from \"@hansjm10/volt-agent-core\";\nimport { clampThinkingLevel, type Message, type Model, streamSimple } from \"@hansjm10/volt-ai\";\nimport { getAgentDir } from \"../config.ts\";\nimport { resolvePath } from \"../utils/paths.ts\";\nimport { AgentSession } from \"./agent-session.ts\";\nimport { formatNoModelsAvailableMessage } from \"./auth-guidance.ts\";\nimport { AuthStorage } from \"./auth-storage.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type { ExtensionRunner, LoadExtensionsResult, SessionStartEvent, ToolDefinition } from \"./extensions/index.ts\";\nimport type { HostInteraction } from \"./host-interaction.ts\";\nimport { resolveLspConfig } from \"./lsp/config.ts\";\nimport { McpAuditLogger } from \"./mcp/audit.ts\";\nimport { DefaultMcpClientFactory } from \"./mcp/client-factory.ts\";\nimport { loadMcpConfig } from \"./mcp/config-loader.ts\";\nimport { McpConfigWriter } from \"./mcp/config-writer.ts\";\nimport { McpManager } from \"./mcp/manager.ts\";\nimport { McpMetadataCache } from \"./mcp/metadata-cache.ts\";\nimport { McpOAuthStore } from \"./mcp/oauth-store.ts\";\nimport { McpOutputStore } from \"./mcp/output-store.ts\";\nimport { convertToLlm } from \"./messages.ts\";\nimport { ModelRegistry } from \"./model-registry.ts\";\nimport { findInitialModel } from \"./model-resolver.ts\";\nimport { mergeProviderAttributionHeaders } from \"./provider-attribution.ts\";\nimport type { ResourceLoader } from \"./resource-loader.ts\";\nimport { DefaultResourceLoader } from \"./resource-loader.ts\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.ts\";\nimport { SettingsManager } from \"./settings-manager.ts\";\nimport { time } from \"./timings.ts\";\nimport {\n\tcreateBashTool,\n\tcreateCodingTools,\n\tcreateEditTool,\n\tcreateFindTool,\n\tcreateGrepTool,\n\tcreateLspTool,\n\tcreateLsTool,\n\tcreateReadOnlyTools,\n\tcreateReadTool,\n\tcreateSubagentTool,\n\tcreateWebSearchTool,\n\tcreateWriteTool,\n\tDEFAULT_ACTIVE_TOOL_NAMES,\n\ttype SubagentToolManager,\n\twithFileMutationQueue,\n} from \"./tools/index.ts\";\n\nexport interface CreateAgentSessionOptions {\n\t/** Runtime working directory for tools and session metadata. Default: process.cwd() */\n\tcwd?: string;\n\t/** Project/config root for .volt resources. Defaults to cwd. */\n\tprojectCwd?: string;\n\t/** Global config directory. Default: ~/.volt/agent */\n\tagentDir?: string;\n\n\t/** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json) */\n\tauthStorage?: AuthStorage;\n\t/** Model registry. Default: ModelRegistry.create(authStorage, agentDir/models.json) */\n\tmodelRegistry?: ModelRegistry;\n\n\t/** Model to use. Default: from settings, else first available */\n\tmodel?: Model<any>;\n\t/** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n\tthinkingLevel?: ThinkingLevel;\n\t/** Models available for cycling (Ctrl+P in interactive mode) */\n\tscopedModels?: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\n\t/**\n\t * Optional default tool suppression mode when no explicit allowlist is provided.\n\t *\n\t * - \"all\": start with no tools enabled\n\t * - \"builtin\": disable the default built-in tools (read, bash, edit, write,\n\t *   web_search, and subagent when a manager is supplied) but keep extension/custom tools enabled\n\t */\n\tnoTools?: \"all\" | \"builtin\";\n\t/**\n\t * Optional allowlist of tool names.\n\t *\n\t * When omitted, volt enables the default built-in tools (read, bash, edit, write,\n\t * web_search, and subagent when a manager is supplied) and leaves extension/custom tools enabled\n\t * unless `noTools` changes that default.\n\t * When provided, only the listed tool names are enabled.\n\t */\n\ttools?: string[];\n\t/** Allow extension and SDK custom tools even when they are absent from `tools`. */\n\tallowUnlistedExtensionTools?: boolean;\n\t/** Optional denylist of tool names to disable. Applies after `tools` when both are provided. */\n\texcludeTools?: string[];\n\t/** Custom tools to register (in addition to built-in tools). */\n\tcustomTools?: ToolDefinition[];\n\n\t/** Resource loader. When omitted, DefaultResourceLoader is used. */\n\tresourceLoader?: ResourceLoader;\n\n\t/** Session manager. Default: SessionManager.create(cwd) */\n\tsessionManager?: SessionManager;\n\n\t/** Settings profile to apply when creating the default SettingsManager. */\n\tprofile?: string;\n\t/**\n\t * Whether project-local resources should be trusted when this SDK call creates\n\t * trust-sensitive runtime helpers. CLI modes pass an already-resolved\n\t * SettingsManager; bare SDK calls default MCP project config to untrusted.\n\t */\n\tprojectTrusted?: boolean;\n\t/** Settings manager. Default: SettingsManager.create(projectCwd, agentDir) */\n\tsettingsManager?: SettingsManager;\n\t/** Session start event metadata for extension runtime startup. */\n\tsessionStartEvent?: SessionStartEvent;\n\t/** Optional host interaction bridge for blocking host-initiated actions. */\n\thostInteraction?: HostInteraction;\n\t/** Optional manager enabling the built-in subagent tool when selected. */\n\tsubagentToolManager?: SubagentToolManager;\n\t/** Optional manager enabling the native MCP gateway tool when selected. */\n\tmcpManager?: McpManager;\n\t/**\n\t * Skip MCP entirely for this session: no default MCP manager is created, no\n\t * MCP servers are started, and the native MCP gateway/direct tools are\n\t * unavailable. Overrides `mcpManager` when both are set. Used by isolated\n\t * sessions (e.g. the built-in reviewer) that must not spin up the user's MCP\n\t * servers.\n\t */\n\tdisableMcp?: boolean;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n\t/** The created session */\n\tsession: AgentSession;\n\t/** Extensions result (for UI context setup in interactive mode) */\n\textensionsResult: LoadExtensionsResult;\n\t/** Warning if session was restored with a different model than saved */\n\tmodelFallbackMessage?: string;\n}\n\n// Re-exports\n\nexport * from \"./agent-session-runtime.ts\";\nexport type {\n\tExtensionAPI,\n\tExtensionCommandContext,\n\tExtensionContext,\n\tExtensionFactory,\n\tSlashCommandInfo,\n\tSlashCommandSource,\n\tToolDefinition,\n} from \"./extensions/index.ts\";\nexport type { PromptTemplate } from \"./prompt-templates.ts\";\nexport type { Skill } from \"./skills.ts\";\nexport type { Tool } from \"./tools/index.ts\";\n\nexport {\n\twithFileMutationQueue,\n\t// Tool factories (for custom cwd)\n\tcreateCodingTools,\n\tcreateReadOnlyTools,\n\tcreateReadTool,\n\tcreateBashTool,\n\tcreateEditTool,\n\tcreateWriteTool,\n\tcreateGrepTool,\n\tcreateFindTool,\n\tcreateLsTool,\n\tcreateLspTool,\n\tcreateSubagentTool,\n\tcreateWebSearchTool,\n};\n\n// Helper Functions\n\nfunction getDefaultAgentDir(): string {\n\treturn getAgentDir();\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@hansjm10/volt-ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [\"read\", \"bash\"],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(options: CreateAgentSessionOptions = {}): Promise<CreateAgentSessionResult> {\n\tconst cwd = resolvePath(options.cwd ?? options.sessionManager?.getCwd() ?? process.cwd());\n\tconst projectCwd = resolvePath(options.projectCwd ?? cwd);\n\tconst agentDir = options.agentDir ? resolvePath(options.agentDir) : getDefaultAgentDir();\n\tlet resourceLoader = options.resourceLoader;\n\n\t// Use provided or create AuthStorage and ModelRegistry\n\tconst authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n\tconst modelsPath = options.agentDir ? join(agentDir, \"models.json\") : undefined;\n\tconst authStorage = options.authStorage ?? AuthStorage.create(authPath);\n\tconst modelRegistry = options.modelRegistry ?? ModelRegistry.create(authStorage, modelsPath);\n\n\tconst settingsManager =\n\t\toptions.settingsManager ??\n\t\tSettingsManager.create(projectCwd, agentDir, {\n\t\t\tprofile: options.profile,\n\t\t\t...(options.projectTrusted !== undefined ? { projectTrusted: options.projectTrusted } : {}),\n\t\t});\n\tconst sessionManager = options.sessionManager ?? SessionManager.create(cwd, getDefaultSessionDir(cwd, agentDir));\n\n\tif (!resourceLoader) {\n\t\tresourceLoader = new DefaultResourceLoader({ cwd: projectCwd, agentDir, settingsManager });\n\t\tawait resourceLoader.reload();\n\t\ttime(\"resourceLoader.reload\");\n\t}\n\n\t// Check if session has existing data to restore\n\tconst existingSession = sessionManager.buildSessionContext();\n\tconst hasExistingSession = existingSession.messages.length > 0;\n\tconst hasThinkingEntry = sessionManager.getBranch().some((entry) => entry.type === \"thinking_level_change\");\n\n\tlet model = options.model;\n\tlet modelFallbackMessage: string | undefined;\n\n\t// If session has data, try to restore model from it\n\tif (!model && hasExistingSession && existingSession.model) {\n\t\tconst restoredModel = modelRegistry.find(existingSession.model.provider, existingSession.model.modelId);\n\t\tif (restoredModel && modelRegistry.hasConfiguredAuth(restoredModel)) {\n\t\t\tmodel = restoredModel;\n\t\t}\n\t\tif (!model) {\n\t\t\tmodelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId}`;\n\t\t}\n\t}\n\n\t// If still no model, use findInitialModel (checks settings default, then provider defaults)\n\tif (!model) {\n\t\tconst result = await findInitialModel({\n\t\t\tscopedModels: [],\n\t\t\tisContinuing: hasExistingSession,\n\t\t\tdefaultProvider: settingsManager.getDefaultProvider(),\n\t\t\tdefaultModelId: settingsManager.getDefaultModel(),\n\t\t\tdefaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n\t\t\tmodelRegistry,\n\t\t});\n\t\tmodel = result.model;\n\t\tif (!model) {\n\t\t\tmodelFallbackMessage = formatNoModelsAvailableMessage();\n\t\t} else if (modelFallbackMessage) {\n\t\t\tmodelFallbackMessage += `. Using ${model.provider}/${model.id}`;\n\t\t}\n\t}\n\n\tlet thinkingLevel = options.thinkingLevel;\n\n\t// If session has data, restore thinking level from it\n\tif (thinkingLevel === undefined && hasExistingSession) {\n\t\tthinkingLevel = hasThinkingEntry\n\t\t\t? (existingSession.thinkingLevel as ThinkingLevel)\n\t\t\t: (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n\t}\n\n\t// Fall back to settings default\n\tif (thinkingLevel === undefined) {\n\t\tthinkingLevel = settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n\t}\n\n\t// Clamp to model capabilities\n\tif (!model) {\n\t\tthinkingLevel = \"off\";\n\t} else {\n\t\tthinkingLevel = clampThinkingLevel(model, thinkingLevel) as ThinkingLevel;\n\t}\n\n\tconst createDefaultMcpManager = async (): Promise<McpManager | undefined> => {\n\t\tconst mcpProjectTrusted =\n\t\t\toptions.projectTrusted ?? (options.settingsManager ? settingsManager.isProjectTrusted() : false);\n\t\tconst mcpConfig = loadMcpConfig({ cwd: projectCwd, agentDir, projectTrusted: mcpProjectTrusted });\n\t\tif (!mcpConfig.settings.enabled || Object.keys(mcpConfig.servers).length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst mcpOAuthStore = McpOAuthStore.create(agentDir);\n\t\tconst manager = new McpManager({\n\t\t\tconfig: mcpConfig,\n\t\t\tclientFactory: new DefaultMcpClientFactory({ cwd: projectCwd, oauthStore: mcpOAuthStore }),\n\t\t\tmetadataCache: new McpMetadataCache({ agentDir }),\n\t\t\toutputStore: new McpOutputStore({\n\t\t\t\tagentDir,\n\t\t\t\tmaxOutputBytes: mcpConfig.settings.maxOutputBytes,\n\t\t\t\tmaxOutputLines: mcpConfig.settings.maxOutputLines,\n\t\t\t\tsessionId: sessionManager.getSessionId(),\n\t\t\t\tworkspaceId: projectCwd,\n\t\t\t}),\n\t\t\tauditLogger: new McpAuditLogger(agentDir),\n\t\t\tconfigWriter: new McpConfigWriter({ cwd: projectCwd, agentDir, projectTrusted: mcpProjectTrusted }),\n\t\t\toauthStore: mcpOAuthStore,\n\t\t\tsessionId: sessionManager.getSessionId(),\n\t\t\tworkspaceId: projectCwd,\n\t\t});\n\t\tawait manager.startEagerServers().catch(() => undefined);\n\t\treturn manager;\n\t};\n\tconst mcpManager = options.disableMcp ? undefined : (options.mcpManager ?? (await createDefaultMcpManager()));\n\n\tconst defaultActiveToolNames: string[] = [...DEFAULT_ACTIVE_TOOL_NAMES];\n\tif (options.subagentToolManager) {\n\t\tdefaultActiveToolNames.push(\"subagent\");\n\t}\n\tif (mcpManager?.isEnabled()) {\n\t\tdefaultActiveToolNames.push(\"mcp\");\n\t\tdefaultActiveToolNames.push(...mcpManager.getDirectToolCandidates().map((candidate) => candidate.directToolName));\n\t}\n\tif (resolveLspConfig(settingsManager.getLspSettings()).enabled) {\n\t\tdefaultActiveToolNames.push(\"lsp\");\n\t}\n\tconst allowedToolNames = options.tools ?? (options.noTools === \"all\" ? [] : undefined);\n\tconst excludedToolNames = options.excludeTools;\n\tconst excludedToolNameSet = excludedToolNames ? new Set(excludedToolNames) : undefined;\n\tconst initialActiveToolNames: string[] = (\n\t\toptions.tools ? [...options.tools] : options.noTools ? [] : defaultActiveToolNames\n\t).filter((name) => !excludedToolNameSet?.has(name));\n\n\tlet agent: Agent;\n\n\t// Create convertToLlm wrapper that filters images if blockImages is enabled (defense-in-depth)\n\tconst convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n\t\tconst converted = convertToLlm(messages);\n\t\t// Check setting dynamically so mid-session changes take effect\n\t\tif (!settingsManager.getBlockImages()) {\n\t\t\treturn converted;\n\t\t}\n\t\t// Filter out ImageContent from all messages, replacing with text placeholder\n\t\treturn converted.map((msg) => {\n\t\t\tif (msg.role === \"user\" || msg.role === \"toolResult\") {\n\t\t\t\tconst content = msg.content;\n\t\t\t\tif (Array.isArray(content)) {\n\t\t\t\t\tconst hasImages = content.some((c) => c.type === \"image\");\n\t\t\t\t\tif (hasImages) {\n\t\t\t\t\t\tconst filteredContent = content\n\t\t\t\t\t\t\t.map((c) =>\n\t\t\t\t\t\t\t\tc.type === \"image\" ? { type: \"text\" as const, text: \"Image reading is disabled.\" } : c,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t.filter(\n\t\t\t\t\t\t\t\t(c, i, arr) =>\n\t\t\t\t\t\t\t\t\t// Dedupe consecutive \"Image reading is disabled.\" texts\n\t\t\t\t\t\t\t\t\t!(\n\t\t\t\t\t\t\t\t\t\tc.type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\tc.text === \"Image reading is disabled.\" &&\n\t\t\t\t\t\t\t\t\t\ti > 0 &&\n\t\t\t\t\t\t\t\t\t\tarr[i - 1].type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\t(arr[i - 1] as { type: \"text\"; text: string }).text === \"Image reading is disabled.\"\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\treturn { ...msg, content: filteredContent };\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn msg;\n\t\t});\n\t};\n\n\tconst extensionRunnerRef: { current?: ExtensionRunner } = {};\n\n\tagent = new Agent({\n\t\tinitialState: {\n\t\t\tsystemPrompt: \"\",\n\t\t\tmodel,\n\t\t\tthinkingLevel,\n\t\t\ttools: [],\n\t\t},\n\t\tconvertToLlm: convertToLlmWithBlockImages,\n\t\tstreamFn: async (model, context, options) => {\n\t\t\tconst auth = await modelRegistry.getApiKeyAndHeaders(model);\n\t\t\tif (!auth.ok) {\n\t\t\t\tthrow new Error(auth.error);\n\t\t\t}\n\t\t\tconst env = auth.env || options?.env ? { ...(auth.env ?? {}), ...(options?.env ?? {}) } : undefined;\n\t\t\tconst providerRetrySettings = settingsManager.getProviderRetrySettings();\n\t\t\tconst httpIdleTimeoutMs = settingsManager.getHttpIdleTimeoutMs();\n\t\t\t// SDKs treat timeout=0 as 0ms (immediate timeout), not \"no timeout\".\n\t\t\t// Use max int32 to effectively disable the timeout.\n\t\t\tconst effectiveTimeoutMs = httpIdleTimeoutMs === 0 ? 2147483647 : httpIdleTimeoutMs;\n\t\t\tconst timeoutMs = options?.timeoutMs ?? providerRetrySettings.timeoutMs ?? effectiveTimeoutMs;\n\t\t\tconst websocketConnectTimeoutMs =\n\t\t\t\toptions?.websocketConnectTimeoutMs ?? settingsManager.getWebSocketConnectTimeoutMs();\n\t\t\treturn streamSimple(model, context, {\n\t\t\t\t...options,\n\t\t\t\tapiKey: auth.apiKey,\n\t\t\t\tenv,\n\t\t\t\ttimeoutMs,\n\t\t\t\twebsocketConnectTimeoutMs,\n\t\t\t\tmaxRetries: options?.maxRetries ?? providerRetrySettings.maxRetries,\n\t\t\t\tmaxRetryDelayMs: options?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,\n\t\t\t\theaders: mergeProviderAttributionHeaders(\n\t\t\t\t\tmodel,\n\t\t\t\t\tsettingsManager,\n\t\t\t\t\toptions?.sessionId,\n\t\t\t\t\tauth.headers,\n\t\t\t\t\toptions?.headers,\n\t\t\t\t),\n\t\t\t});\n\t\t},\n\t\tonPayload: async (payload, _model) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner?.hasHandlers(\"before_provider_request\")) {\n\t\t\t\treturn payload;\n\t\t\t}\n\t\t\treturn runner.emitBeforeProviderRequest(payload);\n\t\t},\n\t\tonResponse: async (response, _model) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner?.hasHandlers(\"after_provider_response\")) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tawait runner.emit({\n\t\t\t\ttype: \"after_provider_response\",\n\t\t\t\tstatus: response.status,\n\t\t\t\theaders: response.headers,\n\t\t\t});\n\t\t},\n\t\tsessionId: sessionManager.getSessionId(),\n\t\ttransformContext: async (messages) => {\n\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\tif (!runner) return messages;\n\t\t\treturn runner.emitContext(messages);\n\t\t},\n\t\tsteeringMode: settingsManager.getSteeringMode(),\n\t\tfollowUpMode: settingsManager.getFollowUpMode(),\n\t\ttransport: settingsManager.getTransport(),\n\t\tthinkingBudgets: settingsManager.getThinkingBudgets(),\n\t\tmaxRetryDelayMs: settingsManager.getProviderRetrySettings().maxRetryDelayMs,\n\t});\n\n\t// Restore messages if session has existing data\n\tif (hasExistingSession) {\n\t\tagent.state.messages = existingSession.messages;\n\t\tif (!hasThinkingEntry) {\n\t\t\tsessionManager.appendThinkingLevelChange(thinkingLevel);\n\t\t}\n\t} else {\n\t\t// Save initial model and thinking level for new sessions so they can be restored on resume\n\t\tif (model) {\n\t\t\tsessionManager.appendModelChange(model.provider, model.id);\n\t\t}\n\t\tsessionManager.appendThinkingLevelChange(thinkingLevel);\n\t}\n\n\tconst session = new AgentSession({\n\t\tagent,\n\t\tsessionManager,\n\t\tsettingsManager,\n\t\tcwd,\n\t\tscopedModels: options.scopedModels,\n\t\tresourceLoader,\n\t\tcustomTools: options.customTools,\n\t\tmodelRegistry,\n\t\tinitialActiveToolNames,\n\t\tallowedToolNames,\n\t\tallowUnlistedExtensionTools: options.allowUnlistedExtensionTools,\n\t\texcludedToolNames,\n\t\textensionRunnerRef,\n\t\tsessionStartEvent: options.sessionStartEvent,\n\t\thostInteraction: options.hostInteraction,\n\t\tsubagentToolManager: options.subagentToolManager,\n\t\tmcpManager,\n\t\tmcpManagerFactory: options.disableMcp || options.mcpManager ? undefined : createDefaultMcpManager,\n\t});\n\tconst extensionsResult = resourceLoader.getExtensions();\n\n\treturn {\n\t\tsession,\n\t\textensionsResult,\n\t\tmodelFallbackMessage,\n\t};\n}\n"]}