@caupulican/pi-adaptative 0.90.7 → 0.90.12

package/dist/core/extension-binding-controller.js

@@ -0,0 +1,224 @@
+/**
+ * Extension runtime binding: the boundary between {@link AgentSession} and the {@link
+ * ExtensionRunner} it hosts. Owns the public `bindExtensions()` entry point (stores the
+ * host-supplied UI/mode/callback bindings, applies them to the runner, fires the session-start
+ * event, discovers extension-contributed resources, and initializes memory), the resource
+ * discovery pass that turns extension-reported skill/prompt/theme paths into labeled {@link
+ * ResourceExtensionPaths}, and `bindExtensionCore` — the ~30-method translation of the session's
+ * own public surface (send message, set model, compact, abort, reload, …) into the `ExtensionActions`
+ * / `ExtensionContextActions` shape `ExtensionRunner.bindCore` expects.
+ *
+ * Extracted verbatim from agent-session.ts (god-file decomposition). All logic here is pure code
+ * motion — no behavior changes. State that other collaborators (RuntimeBuilder, LocalRuntimeController,
+ * HumanInputController) also read (`_extensionUIContext`, `_extensionMode`, `_extensionCommandContextActions`,
+ * `_extensionShutdownHandler`, `_extensionErrorListener`) stays host-owned and is reached through the
+ * same get/set deps accessors those collaborators already use; `_extensionAbortHandler` and the
+ * error-unsubscribe callback are touched only within this binding boundary, so they are owned here.
+ *
+ * Host-binding boundary note (see runtime-builder.ts): `bindExtensionCore` exposes session identity
+ * to the extension runner, not tool-registry build logic, which is why it lives in its own dedicated
+ * module rather than inside RuntimeBuilder; RuntimeBuilder still invokes it (and `applyExtensionBindings`
+ * / `extendResourcesFromExtensions`) through {@link RuntimeBuilderDeps}, one level further delegated.
+ */
+import { basename, dirname } from "node:path";
+export class ExtensionBindingController {
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async bindExtensions(bindings) {
+        if (bindings.uiContext !== undefined) {
+            this.deps.setExtensionUIContext(bindings.uiContext);
+        }
+        if (bindings.mode !== undefined) {
+            this.deps.setExtensionMode(bindings.mode);
+        }
+        if (bindings.commandContextActions !== undefined) {
+            this.deps.setExtensionCommandContextActions(bindings.commandContextActions);
+        }
+        if (bindings.abortHandler !== undefined) {
+            this.extensionAbortHandler = bindings.abortHandler;
+        }
+        if (bindings.shutdownHandler !== undefined) {
+            this.deps.setExtensionShutdownHandler(bindings.shutdownHandler);
+        }
+        if (bindings.onError !== undefined) {
+            this.deps.setExtensionErrorListener(bindings.onError);
+        }
+        this.applyExtensionBindings(this.deps.getExtensionRunner());
+        await this.deps.getExtensionRunner().emit(this.deps.getSessionStartEvent());
+        await this.extendResourcesFromExtensions(this.deps.getSessionStartEvent().reason === "reload" ? "reload" : "startup");
+        // Initialize the memory subsystem after extensions have had a chance to register providers.
+        await this.deps.initializeMemory();
+    }
+    async extendResourcesFromExtensions(reason) {
+        const runner = this.deps.getExtensionRunner();
+        if (!runner.hasHandlers("resources_discover")) {
+            return;
+        }
+        const { skillPaths, promptPaths, themePaths } = await runner.emitResourcesDiscover(this.deps.getCwd(), reason);
+        if (skillPaths.length === 0 && promptPaths.length === 0 && themePaths.length === 0) {
+            return;
+        }
+        const extensionPaths = {
+            skillPaths: this.buildExtensionResourcePaths(skillPaths),
+            promptPaths: this.buildExtensionResourcePaths(promptPaths),
+            themePaths: this.buildExtensionResourcePaths(themePaths),
+        };
+        this.deps.getResourceLoader().extendResources(extensionPaths);
+        const rebuiltSystemPrompt = this.deps.rebuildSystemPrompt(this.deps.getActiveToolNames());
+        this.deps.setBaseSystemPrompt(rebuiltSystemPrompt);
+        this.deps.getAgent().state.systemPrompt = rebuiltSystemPrompt;
+    }
+    buildExtensionResourcePaths(entries) {
+        return entries.map((entry) => {
+            const source = this.getExtensionSourceLabel(entry.extensionPath);
+            const baseDir = entry.extensionPath.startsWith("<") ? undefined : dirname(entry.extensionPath);
+            return {
+                path: entry.path,
+                metadata: {
+                    source,
+                    scope: "temporary",
+                    origin: "top-level",
+                    baseDir,
+                },
+            };
+        });
+    }
+    getExtensionSourceLabel(extensionPath) {
+        if (extensionPath.startsWith("<")) {
+            return `extension:${extensionPath.replace(/[<>]/g, "")}`;
+        }
+        const base = basename(extensionPath);
+        const name = base.replace(/\.(ts|js)$/, "");
+        return `extension:${name}`;
+    }
+    applyExtensionBindings(runner) {
+        runner.setUIContext(this.deps.getExtensionUIContext());
+        runner.setMode(this.deps.getExtensionMode());
+        runner.bindCommandContext(this.deps.getExtensionCommandContextActions());
+        this.extensionErrorUnsubscriber?.();
+        const errorListener = this.deps.getExtensionErrorListener();
+        this.extensionErrorUnsubscriber = errorListener ? runner.onError(errorListener) : undefined;
+    }
+    bindExtensionCore(runner) {
+        const getCommands = () => {
+            const extensionCommands = runner.getRegisteredCommands().map((command) => ({
+                name: command.invocationName,
+                description: command.description,
+                source: "extension",
+                sourceInfo: command.sourceInfo,
+            }));
+            const templates = this.deps.getPromptTemplates().map((template) => ({
+                name: template.name,
+                description: template.description,
+                source: "prompt",
+                sourceInfo: template.sourceInfo,
+            }));
+            const skills = this.deps
+                .getResourceLoader()
+                .getActiveSkills()
+                .map((skill) => ({
+                name: `skill:${skill.name}`,
+                description: skill.description,
+                source: "skill",
+                sourceInfo: skill.sourceInfo,
+            }));
+            return [...extensionCommands, ...templates, ...skills];
+        };
+        runner.bindCore({
+            sendMessage: (message, options) => {
+                this.deps.sendCustomMessage(message, options).catch((err) => {
+                    runner.emitError({
+                        extensionPath: "<runtime>",
+                        event: "send_message",
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            },
+            sendUserMessage: (content, options) => {
+                this.deps.sendUserMessage(content, options).catch((err) => {
+                    runner.emitError({
+                        extensionPath: "<runtime>",
+                        event: "send_user_message",
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            },
+            appendEntry: (customType, data) => {
+                this.deps.getSessionManager().appendCustomEntry(customType, data);
+            },
+            setSessionName: (name) => {
+                this.deps.setSessionName(name);
+            },
+            getSessionName: () => {
+                return this.deps.getSessionManager().getSessionName();
+            },
+            setLabel: (entryId, label) => {
+                this.deps.getSessionManager().appendLabelChange(entryId, label);
+            },
+            getActiveTools: () => this.deps.getActiveToolNames(),
+            getAllTools: () => this.deps.getAllTools(),
+            setActiveTools: (toolNames) => this.deps.setActiveToolsByName(toolNames),
+            refreshTools: () => this.deps.refreshToolRegistry(),
+            getCommands,
+            setModel: async (model) => {
+                if (!this.deps.getModelRegistry().hasConfiguredAuth(model))
+                    return false;
+                await this.deps.setModel(model);
+                return true;
+            },
+            getThinkingLevel: () => this.deps.getThinkingLevel(),
+            setThinkingLevel: (level) => this.deps.setThinkingLevel(level),
+            getExternalResourceRoots: () => this.deps.getSettingsManager().getEffectiveExternalResourceRoots(),
+            registerMemoryProvider: (provider) => this.deps.registerMemoryProvider(provider),
+            registerContextMemoryProvider: (provider) => this.deps.registerContextMemoryProvider(provider),
+            reportSpawnedUsage: (usage, opts) => {
+                this.deps.addSpawnedUsage(usage, opts);
+            },
+            reportManagedLane: (event) => {
+                this.deps.recordManagedLane(event);
+            },
+        }, {
+            getModel: () => this.deps.getModel(),
+            isIdle: () => !this.deps.isForegroundBusy(),
+            getSignal: () => this.deps.getAgent().signal,
+            abort: () => {
+                if (this.extensionAbortHandler) {
+                    this.extensionAbortHandler();
+                    return;
+                }
+                void this.deps.abort();
+            },
+            hasPendingMessages: () => this.deps.getPendingMessageCount() > 0,
+            shutdown: () => {
+                this.deps.getExtensionShutdownHandler()?.();
+            },
+            getContextUsage: () => this.deps.getContextUsage(),
+            compact: (options) => this.deps.compactForExtension(options),
+            reload: () => {
+                if (this.deps.isStreaming()) {
+                    return Promise.reject(new Error("ctx.reload() cannot run while the agent is streaming or a tool call is active. Wait for ctx.isIdle(), queue a follow-up /reload, or use an idle command/event handler so hot reload cannot destabilize the UI."));
+                }
+                if (this.deps.isCompacting()) {
+                    return Promise.reject(new Error("ctx.reload() cannot run during context compaction or branch summarization. Let compaction finish before reloading so the session tree and UI remain stable."));
+                }
+                const actions = this.deps.getExtensionCommandContextActions();
+                if (!actions) {
+                    return this.deps.reload();
+                }
+                return actions.reload();
+            },
+            getSystemPrompt: () => this.deps.getSystemPrompt(),
+        }, {
+            registerProvider: (name, config) => {
+                this.deps.getModelRegistry().registerProvider(name, config);
+                this.deps.refreshCurrentModelFromRegistry();
+            },
+            unregisterProvider: (name) => {
+                this.deps.getModelRegistry().unregisterProvider(name);
+                this.deps.refreshCurrentModelFromRegistry();
+            },
+        });
+    }
+}
+//# sourceMappingURL=extension-binding-controller.js.map

package/dist/core/extension-binding-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-binding-controller.js","sourceRoot":"","sources":["../../src/core/extension-binding-controller.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Extension runtime binding: the boundary between {@link AgentSession} and the {@link\n * ExtensionRunner} it hosts. Owns the public `bindExtensions()` entry point (stores the\n * host-supplied UI/mode/callback bindings, applies them to the runner, fires the session-start\n * event, discovers extension-contributed resources, and initializes memory), the resource\n * discovery pass that turns extension-reported skill/prompt/theme paths into labeled {@link\n * ResourceExtensionPaths}, and `bindExtensionCore` — the ~30-method translation of the session's\n * own public surface (send message, set model, compact, abort, reload, …) into the `ExtensionActions`\n * / `ExtensionContextActions` shape `ExtensionRunner.bindCore` expects.\n *\n * Extracted verbatim from agent-session.ts (god-file decomposition). All logic here is pure code\n * motion — no behavior changes. State that other collaborators (RuntimeBuilder, LocalRuntimeController,\n * HumanInputController) also read (`_extensionUIContext`, `_extensionMode`, `_extensionCommandContextActions`,\n * `_extensionShutdownHandler`, `_extensionErrorListener`) stays host-owned and is reached through the\n * same get/set deps accessors those collaborators already use; `_extensionAbortHandler` and the\n * error-unsubscribe callback are touched only within this binding boundary, so they are owned here.\n *\n * Host-binding boundary note (see runtime-builder.ts): `bindExtensionCore` exposes session identity\n * to the extension runner, not tool-registry build logic, which is why it lives in its own dedicated\n * module rather than inside RuntimeBuilder; RuntimeBuilder still invokes it (and `applyExtensionBindings`\n * / `extendResourcesFromExtensions`) through {@link RuntimeBuilderDeps}, one level further delegated.\n */\n\nimport { basename, dirname } from \"node:path\";\nimport type { Agent, ThinkingLevel } from \"@caupulican/pi-agent-core\";\nimport type { CustomMessage } from \"@caupulican/pi-agent-core/messages\";\nimport type { SessionManager } from \"@caupulican/pi-agent-core/node\";\nimport type { Api, ImageContent, Model, TextContent, Usage } from \"@caupulican/pi-ai\";\nimport type { ExtensionBindings } from \"./agent-session-contracts.ts\";\nimport type { MemoryProvider as ContextMemoryProvider } from \"./context/memory-provider-contract.ts\";\nimport type {\n\tCompactOptions,\n\tContextUsage,\n\tExtensionCommandContextActions,\n\tExtensionContext,\n\tExtensionErrorListener,\n\tExtensionRunner,\n\tExtensionUIContext,\n\tSessionStartEvent,\n\tShutdownHandler,\n\tToolInfo,\n} from \"./extensions/index.ts\";\nimport type { ManagedLaneEvent } from \"./extensions/types.ts\";\nimport type { MemoryProvider } from \"./memory/memory-provider.ts\";\nimport type { ModelRegistry } from \"./model-registry.ts\";\nimport type { PromptTemplate } from \"./prompt-templates.ts\";\nimport type { ResourceExtensionPaths, ResourceLoader } from \"./resource-loader.ts\";\nimport type { SettingsManager } from \"./settings-manager.ts\";\nimport type { SlashCommandInfo } from \"./slash-commands.ts\";\n\nexport interface ExtensionBindingControllerDeps {\n\tgetAgent(): Agent;\n\tgetExtensionRunner(): ExtensionRunner;\n\tgetSessionStartEvent(): SessionStartEvent;\n\tgetCwd(): string;\n\tgetResourceLoader(): ResourceLoader;\n\tgetSessionManager(): SessionManager;\n\tgetSettingsManager(): SettingsManager;\n\tgetModelRegistry(): ModelRegistry;\n\tgetModel(): Model<Api> | undefined;\n\tgetActiveToolNames(): string[];\n\tgetAllTools(): ToolInfo[];\n\tsetActiveToolsByName(toolNames: string[]): void;\n\trefreshToolRegistry(): void;\n\trebuildSystemPrompt(toolNames: string[]): string;\n\tsetBaseSystemPrompt(prompt: string): void;\n\tgetPromptTemplates(): ReadonlyArray<PromptTemplate>;\n\tgetThinkingLevel(): ThinkingLevel;\n\tsetThinkingLevel(level: ThinkingLevel): void;\n\tsetModel(model: Model<Api>): Promise<void>;\n\tsendCustomMessage(\n\t\tmessage: Pick<CustomMessage, \"customType\" | \"content\" | \"display\" | \"details\">,\n\t\toptions?: { triggerTurn?: boolean; deliverAs?: \"steer\" | \"followUp\" | \"nextTurn\" },\n\t): Promise<void>;\n\tsendUserMessage(\n\t\tcontent: string | (TextContent | ImageContent)[],\n\t\toptions?: { deliverAs?: \"steer\" | \"followUp\"; processSlashCommands?: boolean },\n\t): Promise<void>;\n\tsetSessionName(name: string): void;\n\tregisterMemoryProvider(provider: MemoryProvider): void;\n\tregisterContextMemoryProvider(provider: ContextMemoryProvider): void;\n\taddSpawnedUsage(\n\t\tusage: Usage,\n\t\topts?: { label?: string; sourceSessionId?: string; reportId?: string },\n\t): string | undefined;\n\trecordManagedLane(event: ManagedLaneEvent): void;\n\tisForegroundBusy(): boolean;\n\tgetPendingMessageCount(): number;\n\tisStreaming(): boolean;\n\tisCompacting(): boolean;\n\tgetContextUsage(): ContextUsage | undefined;\n\tcompactForExtension(options?: CompactOptions): void;\n\treload(): Promise<void>;\n\tabort(): Promise<void>;\n\tgetSystemPrompt(): string;\n\tgetExtensionCommandContextActions(): ExtensionCommandContextActions | undefined;\n\trefreshCurrentModelFromRegistry(): void;\n\tinitializeMemory(): Promise<void>;\n\tgetExtensionUIContext(): ExtensionUIContext | undefined;\n\tsetExtensionUIContext(uiContext: ExtensionUIContext | undefined): void;\n\tgetExtensionMode(): ExtensionContext[\"mode\"];\n\tsetExtensionMode(mode: ExtensionContext[\"mode\"]): void;\n\tsetExtensionCommandContextActions(actions: ExtensionCommandContextActions | undefined): void;\n\tgetExtensionShutdownHandler(): ShutdownHandler | undefined;\n\tsetExtensionShutdownHandler(handler: ShutdownHandler | undefined): void;\n\tgetExtensionErrorListener(): ExtensionErrorListener | undefined;\n\tsetExtensionErrorListener(listener: ExtensionErrorListener | undefined): void;\n}\n\nexport class ExtensionBindingController {\n\tprivate readonly deps: ExtensionBindingControllerDeps;\n\tprivate extensionAbortHandler?: () => void;\n\tprivate extensionErrorUnsubscriber?: () => void;\n\n\tconstructor(deps: ExtensionBindingControllerDeps) {\n\t\tthis.deps = deps;\n\t}\n\n\tasync bindExtensions(bindings: ExtensionBindings): Promise<void> {\n\t\tif (bindings.uiContext !== undefined) {\n\t\t\tthis.deps.setExtensionUIContext(bindings.uiContext);\n\t\t}\n\t\tif (bindings.mode !== undefined) {\n\t\t\tthis.deps.setExtensionMode(bindings.mode);\n\t\t}\n\t\tif (bindings.commandContextActions !== undefined) {\n\t\t\tthis.deps.setExtensionCommandContextActions(bindings.commandContextActions);\n\t\t}\n\t\tif (bindings.abortHandler !== undefined) {\n\t\t\tthis.extensionAbortHandler = bindings.abortHandler;\n\t\t}\n\t\tif (bindings.shutdownHandler !== undefined) {\n\t\t\tthis.deps.setExtensionShutdownHandler(bindings.shutdownHandler);\n\t\t}\n\t\tif (bindings.onError !== undefined) {\n\t\t\tthis.deps.setExtensionErrorListener(bindings.onError);\n\t\t}\n\n\t\tthis.applyExtensionBindings(this.deps.getExtensionRunner());\n\t\tawait this.deps.getExtensionRunner().emit(this.deps.getSessionStartEvent());\n\t\tawait this.extendResourcesFromExtensions(\n\t\t\tthis.deps.getSessionStartEvent().reason === \"reload\" ? \"reload\" : \"startup\",\n\t\t);\n\t\t// Initialize the memory subsystem after extensions have had a chance to register providers.\n\t\tawait this.deps.initializeMemory();\n\t}\n\n\tasync extendResourcesFromExtensions(reason: \"startup\" | \"reload\"): Promise<void> {\n\t\tconst runner = this.deps.getExtensionRunner();\n\t\tif (!runner.hasHandlers(\"resources_discover\")) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst { skillPaths, promptPaths, themePaths } = await runner.emitResourcesDiscover(this.deps.getCwd(), reason);\n\n\t\tif (skillPaths.length === 0 && promptPaths.length === 0 && themePaths.length === 0) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst extensionPaths: ResourceExtensionPaths = {\n\t\t\tskillPaths: this.buildExtensionResourcePaths(skillPaths),\n\t\t\tpromptPaths: this.buildExtensionResourcePaths(promptPaths),\n\t\t\tthemePaths: this.buildExtensionResourcePaths(themePaths),\n\t\t};\n\n\t\tthis.deps.getResourceLoader().extendResources(extensionPaths);\n\t\tconst rebuiltSystemPrompt = this.deps.rebuildSystemPrompt(this.deps.getActiveToolNames());\n\t\tthis.deps.setBaseSystemPrompt(rebuiltSystemPrompt);\n\t\tthis.deps.getAgent().state.systemPrompt = rebuiltSystemPrompt;\n\t}\n\n\tprivate buildExtensionResourcePaths(entries: Array<{ path: string; extensionPath: string }>): Array<{\n\t\tpath: string;\n\t\tmetadata: { source: string; scope: \"temporary\"; origin: \"top-level\"; baseDir?: string };\n\t}> {\n\t\treturn entries.map((entry) => {\n\t\t\tconst source = this.getExtensionSourceLabel(entry.extensionPath);\n\t\t\tconst baseDir = entry.extensionPath.startsWith(\"<\") ? undefined : dirname(entry.extensionPath);\n\t\t\treturn {\n\t\t\t\tpath: entry.path,\n\t\t\t\tmetadata: {\n\t\t\t\t\tsource,\n\t\t\t\t\tscope: \"temporary\",\n\t\t\t\t\torigin: \"top-level\",\n\t\t\t\t\tbaseDir,\n\t\t\t\t},\n\t\t\t};\n\t\t});\n\t}\n\n\tprivate getExtensionSourceLabel(extensionPath: string): string {\n\t\tif (extensionPath.startsWith(\"<\")) {\n\t\t\treturn `extension:${extensionPath.replace(/[<>]/g, \"\")}`;\n\t\t}\n\t\tconst base = basename(extensionPath);\n\t\tconst name = base.replace(/\\.(ts|js)$/, \"\");\n\t\treturn `extension:${name}`;\n\t}\n\n\tapplyExtensionBindings(runner: ExtensionRunner): void {\n\t\trunner.setUIContext(this.deps.getExtensionUIContext());\n\t\trunner.setMode(this.deps.getExtensionMode());\n\t\trunner.bindCommandContext(this.deps.getExtensionCommandContextActions());\n\n\t\tthis.extensionErrorUnsubscriber?.();\n\t\tconst errorListener = this.deps.getExtensionErrorListener();\n\t\tthis.extensionErrorUnsubscriber = errorListener ? runner.onError(errorListener) : undefined;\n\t}\n\n\tbindExtensionCore(runner: ExtensionRunner): void {\n\t\tconst getCommands = (): SlashCommandInfo[] => {\n\t\t\tconst extensionCommands: SlashCommandInfo[] = runner.getRegisteredCommands().map((command) => ({\n\t\t\t\tname: command.invocationName,\n\t\t\t\tdescription: command.description,\n\t\t\t\tsource: \"extension\",\n\t\t\t\tsourceInfo: command.sourceInfo,\n\t\t\t}));\n\n\t\t\tconst templates: SlashCommandInfo[] = this.deps.getPromptTemplates().map((template) => ({\n\t\t\t\tname: template.name,\n\t\t\t\tdescription: template.description,\n\t\t\t\tsource: \"prompt\",\n\t\t\t\tsourceInfo: template.sourceInfo,\n\t\t\t}));\n\n\t\t\tconst skills: SlashCommandInfo[] = this.deps\n\t\t\t\t.getResourceLoader()\n\t\t\t\t.getActiveSkills()\n\t\t\t\t.map((skill) => ({\n\t\t\t\t\tname: `skill:${skill.name}`,\n\t\t\t\t\tdescription: skill.description,\n\t\t\t\t\tsource: \"skill\",\n\t\t\t\t\tsourceInfo: skill.sourceInfo,\n\t\t\t\t}));\n\n\t\t\treturn [...extensionCommands, ...templates, ...skills];\n\t\t};\n\n\t\trunner.bindCore(\n\t\t\t{\n\t\t\t\tsendMessage: (message, options) => {\n\t\t\t\t\tthis.deps.sendCustomMessage(message, options).catch((err) => {\n\t\t\t\t\t\trunner.emitError({\n\t\t\t\t\t\t\textensionPath: \"<runtime>\",\n\t\t\t\t\t\t\tevent: \"send_message\",\n\t\t\t\t\t\t\terror: err instanceof Error ? err.message : String(err),\n\t\t\t\t\t\t});\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tsendUserMessage: (content, options) => {\n\t\t\t\t\tthis.deps.sendUserMessage(content, options).catch((err) => {\n\t\t\t\t\t\trunner.emitError({\n\t\t\t\t\t\t\textensionPath: \"<runtime>\",\n\t\t\t\t\t\t\tevent: \"send_user_message\",\n\t\t\t\t\t\t\terror: err instanceof Error ? err.message : String(err),\n\t\t\t\t\t\t});\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t\tappendEntry: (customType, data) => {\n\t\t\t\t\tthis.deps.getSessionManager().appendCustomEntry(customType, data);\n\t\t\t\t},\n\t\t\t\tsetSessionName: (name) => {\n\t\t\t\t\tthis.deps.setSessionName(name);\n\t\t\t\t},\n\t\t\t\tgetSessionName: () => {\n\t\t\t\t\treturn this.deps.getSessionManager().getSessionName();\n\t\t\t\t},\n\t\t\t\tsetLabel: (entryId, label) => {\n\t\t\t\t\tthis.deps.getSessionManager().appendLabelChange(entryId, label);\n\t\t\t\t},\n\t\t\t\tgetActiveTools: () => this.deps.getActiveToolNames(),\n\t\t\t\tgetAllTools: () => this.deps.getAllTools(),\n\t\t\t\tsetActiveTools: (toolNames) => this.deps.setActiveToolsByName(toolNames),\n\t\t\t\trefreshTools: () => this.deps.refreshToolRegistry(),\n\t\t\t\tgetCommands,\n\t\t\t\tsetModel: async (model) => {\n\t\t\t\t\tif (!this.deps.getModelRegistry().hasConfiguredAuth(model)) return false;\n\t\t\t\t\tawait this.deps.setModel(model);\n\t\t\t\t\treturn true;\n\t\t\t\t},\n\t\t\t\tgetThinkingLevel: () => this.deps.getThinkingLevel(),\n\t\t\t\tsetThinkingLevel: (level) => this.deps.setThinkingLevel(level),\n\t\t\t\tgetExternalResourceRoots: () => this.deps.getSettingsManager().getEffectiveExternalResourceRoots(),\n\t\t\t\tregisterMemoryProvider: (provider) => this.deps.registerMemoryProvider(provider),\n\t\t\t\tregisterContextMemoryProvider: (provider) => this.deps.registerContextMemoryProvider(provider),\n\t\t\t\treportSpawnedUsage: (usage, opts) => {\n\t\t\t\t\tthis.deps.addSpawnedUsage(usage, opts);\n\t\t\t\t},\n\t\t\t\treportManagedLane: (event) => {\n\t\t\t\t\tthis.deps.recordManagedLane(event);\n\t\t\t\t},\n\t\t\t},\n\t\t\t{\n\t\t\t\tgetModel: () => this.deps.getModel(),\n\t\t\t\tisIdle: () => !this.deps.isForegroundBusy(),\n\t\t\t\tgetSignal: () => this.deps.getAgent().signal,\n\t\t\t\tabort: () => {\n\t\t\t\t\tif (this.extensionAbortHandler) {\n\t\t\t\t\t\tthis.extensionAbortHandler();\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tvoid this.deps.abort();\n\t\t\t\t},\n\t\t\t\thasPendingMessages: () => this.deps.getPendingMessageCount() > 0,\n\t\t\t\tshutdown: () => {\n\t\t\t\t\tthis.deps.getExtensionShutdownHandler()?.();\n\t\t\t\t},\n\t\t\t\tgetContextUsage: () => this.deps.getContextUsage(),\n\t\t\t\tcompact: (options) => this.deps.compactForExtension(options),\n\t\t\t\treload: () => {\n\t\t\t\t\tif (this.deps.isStreaming()) {\n\t\t\t\t\t\treturn Promise.reject(\n\t\t\t\t\t\t\tnew Error(\n\t\t\t\t\t\t\t\t\"ctx.reload() cannot run while the agent is streaming or a tool call is active. Wait for ctx.isIdle(), queue a follow-up /reload, or use an idle command/event handler so hot reload cannot destabilize the UI.\",\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tif (this.deps.isCompacting()) {\n\t\t\t\t\t\treturn Promise.reject(\n\t\t\t\t\t\t\tnew Error(\n\t\t\t\t\t\t\t\t\"ctx.reload() cannot run during context compaction or branch summarization. Let compaction finish before reloading so the session tree and UI remain stable.\",\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tconst actions = this.deps.getExtensionCommandContextActions();\n\t\t\t\t\tif (!actions) {\n\t\t\t\t\t\treturn this.deps.reload();\n\t\t\t\t\t}\n\t\t\t\t\treturn actions.reload();\n\t\t\t\t},\n\t\t\t\tgetSystemPrompt: () => this.deps.getSystemPrompt(),\n\t\t\t},\n\t\t\t{\n\t\t\t\tregisterProvider: (name, config) => {\n\t\t\t\t\tthis.deps.getModelRegistry().registerProvider(name, config);\n\t\t\t\t\tthis.deps.refreshCurrentModelFromRegistry();\n\t\t\t\t},\n\t\t\t\tunregisterProvider: (name) => {\n\t\t\t\t\tthis.deps.getModelRegistry().unregisterProvider(name);\n\t\t\t\t\tthis.deps.refreshCurrentModelFromRegistry();\n\t\t\t\t},\n\t\t\t},\n\t\t);\n\t}\n}\n"]}

package/dist/core/extensions/extension-session-scope.d.ts

@@ -0,0 +1,17 @@
+import type { TSchema } from "typebox";
+import type { ToolDefinition } from "./types.ts";
+export declare class ExtensionSessionScope {
+    private readonly valuesByOwner;
+    prepare(ownerKey: string, schema: TSchema, args: unknown): unknown;
+    observeSuccess(ownerKey: string, schema: TSchema, params: unknown, details: unknown): void;
+    get(ownerKey: string, key: string): string | undefined;
+    clear(ownerKey?: string): void;
+}
+export declare function extensionSessionScopeFor(owner: object): ExtensionSessionScope;
+export declare function applyExtensionSessionHeal<TParams extends TSchema, TDetails>(definition: ToolDefinition<TParams, TDetails>, ownerKey: string, scope: ExtensionSessionScope): ToolDefinition<TParams, TDetails>;
+export declare function extensionScopeOwnerKey(source: {
+    path: string;
+    source: string;
+    baseDir?: string;
+}): string | undefined;
+//# sourceMappingURL=extension-session-scope.d.ts.map

package/dist/core/extensions/extension-session-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-session-scope.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/extension-session-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,qBAAa,qBAAqB;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0C;IAExE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAejE;IAED,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAOzF;IAED,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErD;IAED,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAG7B;CACD;AAID,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAM7E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,SAAS,OAAO,EAAE,QAAQ,EAC1E,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC7C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,qBAAqB,GAC1B,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAiBnC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAGrH"}

package/dist/core/extensions/extension-session-scope.js

@@ -0,0 +1,135 @@
+const MAX_IDENTITY_CHARS = 256;
+const IDENTITY_KEY = /^(?:card|project|board|.+Id)$/;
+export class ExtensionSessionScope {
+    constructor() {
+        this.valuesByOwner = new Map();
+    }
+    prepare(ownerKey, schema, args) {
+        if (!isRecord(args))
+            return args;
+        const stored = this.valuesByOwner.get(ownerKey);
+        if (!stored || stored.size === 0)
+            return args;
+        const schemaKeys = schemaPropertyNames(schema);
+        if (schemaKeys.length === 0)
+            return args;
+        let next;
+        for (const key of schemaKeys) {
+            if (!stored.has(key) || !isVacantIdentity(args[key]))
+                continue;
+            const value = stored.get(key);
+            if (!value)
+                continue;
+            next ??= { ...args };
+            next[key] = value;
+        }
+        return next ?? args;
+    }
+    observeSuccess(ownerKey, schema, params, details) {
+        if (!shouldRetainIdentity(details))
+            return;
+        const extracted = extractIdentity(schemaPropertyNames(schema), isRecord(params) ? params : {}, details);
+        if (extracted.size === 0)
+            return;
+        const stored = this.valuesByOwner.get(ownerKey) ?? new Map();
+        for (const [key, value] of extracted)
+            stored.set(key, value);
+        this.valuesByOwner.set(ownerKey, stored);
+    }
+    get(ownerKey, key) {
+        return this.valuesByOwner.get(ownerKey)?.get(key);
+    }
+    clear(ownerKey) {
+        if (ownerKey)
+            this.valuesByOwner.delete(ownerKey);
+        else
+            this.valuesByOwner.clear();
+    }
+}
+const scopes = new WeakMap();
+export function extensionSessionScopeFor(owner) {
+    const existing = scopes.get(owner);
+    if (existing)
+        return existing;
+    const created = new ExtensionSessionScope();
+    scopes.set(owner, created);
+    return created;
+}
+export function applyExtensionSessionHeal(definition, ownerKey, scope) {
+    const originalPrepare = definition.prepareArguments;
+    const originalExecute = definition.execute;
+    return {
+        ...definition,
+        prepareArguments: (args) => {
+            const prepared = originalPrepare ? originalPrepare(args) : args;
+            return scope.prepare(ownerKey, definition.parameters, prepared);
+        },
+        execute: async (toolCallId, params, signal, onUpdate, ctx) => {
+            const result = await originalExecute(toolCallId, params, signal, onUpdate, ctx);
+            scope.observeSuccess(ownerKey, definition.parameters, params, result.details);
+            return result;
+        },
+    };
+}
+export function extensionScopeOwnerKey(source) {
+    if (source.source === "builtin")
+        return undefined;
+    return source.baseDir ?? source.path;
+}
+function schemaPropertyNames(schema) {
+    const properties = schema.properties;
+    if (!isRecord(properties))
+        return [];
+    return Object.keys(properties);
+}
+function extractIdentity(schemaKeys, params, details) {
+    const extracted = new Map();
+    for (const key of schemaKeys) {
+        if (!IDENTITY_KEY.test(key))
+            continue;
+        const fromParams = params[key];
+        if (isIdentityValue(fromParams))
+            extracted.set(key, fromParams);
+    }
+    if (!isRecord(details))
+        return extracted;
+    for (const key of schemaKeys) {
+        if (!IDENTITY_KEY.test(key) || extracted.has(key))
+            continue;
+        const fromDetails = details[key];
+        if (isIdentityValue(fromDetails)) {
+            extracted.set(key, fromDetails);
+            continue;
+        }
+        if (!key.endsWith("Id"))
+            continue;
+        const nested = details[key.slice(0, -2)];
+        if (isRecord(nested) && isIdentityValue(nested.id))
+            extracted.set(key, nested.id);
+    }
+    return extracted;
+}
+function shouldRetainIdentity(details) {
+    if (!isRecord(details))
+        return true;
+    if (details.error || details.ok === false)
+        return false;
+    const status = details.status;
+    if (typeof status !== "string")
+        return true;
+    return status === "resolved" || status === "ok" || status === "success";
+}
+function isVacantIdentity(value) {
+    return value === undefined || value === null || value === "";
+}
+function isIdentityValue(value) {
+    return (typeof value === "string" &&
+        value.length > 0 &&
+        value.length <= MAX_IDENTITY_CHARS &&
+        !value.includes("\0") &&
+        !value.includes("\n"));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=extension-session-scope.js.map

package/dist/core/extensions/extension-session-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-session-scope.js","sourceRoot":"","sources":["../../../src/core/extensions/extension-session-scope.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TSchema } from \"typebox\";\nimport type { ToolDefinition } from \"./types.ts\";\n\nconst MAX_IDENTITY_CHARS = 256;\nconst IDENTITY_KEY = /^(?:card|project|board|.+Id)$/;\n\nexport class ExtensionSessionScope {\n\tprivate readonly valuesByOwner = new Map<string, Map<string, string>>();\n\n\tprepare(ownerKey: string, schema: TSchema, args: unknown): unknown {\n\t\tif (!isRecord(args)) return args;\n\t\tconst stored = this.valuesByOwner.get(ownerKey);\n\t\tif (!stored || stored.size === 0) return args;\n\t\tconst schemaKeys = schemaPropertyNames(schema);\n\t\tif (schemaKeys.length === 0) return args;\n\t\tlet next: Record<string, unknown> | undefined;\n\t\tfor (const key of schemaKeys) {\n\t\t\tif (!stored.has(key) || !isVacantIdentity(args[key])) continue;\n\t\t\tconst value = stored.get(key);\n\t\t\tif (!value) continue;\n\t\t\tnext ??= { ...args };\n\t\t\tnext[key] = value;\n\t\t}\n\t\treturn next ?? args;\n\t}\n\n\tobserveSuccess(ownerKey: string, schema: TSchema, params: unknown, details: unknown): void {\n\t\tif (!shouldRetainIdentity(details)) return;\n\t\tconst extracted = extractIdentity(schemaPropertyNames(schema), isRecord(params) ? params : {}, details);\n\t\tif (extracted.size === 0) return;\n\t\tconst stored = this.valuesByOwner.get(ownerKey) ?? new Map<string, string>();\n\t\tfor (const [key, value] of extracted) stored.set(key, value);\n\t\tthis.valuesByOwner.set(ownerKey, stored);\n\t}\n\n\tget(ownerKey: string, key: string): string | undefined {\n\t\treturn this.valuesByOwner.get(ownerKey)?.get(key);\n\t}\n\n\tclear(ownerKey?: string): void {\n\t\tif (ownerKey) this.valuesByOwner.delete(ownerKey);\n\t\telse this.valuesByOwner.clear();\n\t}\n}\n\nconst scopes = new WeakMap<object, ExtensionSessionScope>();\n\nexport function extensionSessionScopeFor(owner: object): ExtensionSessionScope {\n\tconst existing = scopes.get(owner);\n\tif (existing) return existing;\n\tconst created = new ExtensionSessionScope();\n\tscopes.set(owner, created);\n\treturn created;\n}\n\nexport function applyExtensionSessionHeal<TParams extends TSchema, TDetails>(\n\tdefinition: ToolDefinition<TParams, TDetails>,\n\townerKey: string,\n\tscope: ExtensionSessionScope,\n): ToolDefinition<TParams, TDetails> {\n\tconst originalPrepare = definition.prepareArguments;\n\tconst originalExecute = definition.execute;\n\treturn {\n\t\t...definition,\n\t\tprepareArguments: (args) => {\n\t\t\tconst prepared = originalPrepare ? originalPrepare(args) : args;\n\t\t\treturn scope.prepare(ownerKey, definition.parameters, prepared) as ReturnType<\n\t\t\t\tNonNullable<ToolDefinition<TParams, TDetails>[\"prepareArguments\"]>\n\t\t\t>;\n\t\t},\n\t\texecute: async (toolCallId, params, signal, onUpdate, ctx) => {\n\t\t\tconst result = await originalExecute(toolCallId, params, signal, onUpdate, ctx);\n\t\t\tscope.observeSuccess(ownerKey, definition.parameters, params, result.details);\n\t\t\treturn result;\n\t\t},\n\t};\n}\n\nexport function extensionScopeOwnerKey(source: { path: string; source: string; baseDir?: string }): string | undefined {\n\tif (source.source === \"builtin\") return undefined;\n\treturn source.baseDir ?? source.path;\n}\n\nfunction schemaPropertyNames(schema: TSchema): string[] {\n\tconst properties = (schema as { properties?: unknown }).properties;\n\tif (!isRecord(properties)) return [];\n\treturn Object.keys(properties);\n}\n\nfunction extractIdentity(\n\tschemaKeys: readonly string[],\n\tparams: Record<string, unknown>,\n\tdetails: unknown,\n): Map<string, string> {\n\tconst extracted = new Map<string, string>();\n\tfor (const key of schemaKeys) {\n\t\tif (!IDENTITY_KEY.test(key)) continue;\n\t\tconst fromParams = params[key];\n\t\tif (isIdentityValue(fromParams)) extracted.set(key, fromParams);\n\t}\n\tif (!isRecord(details)) return extracted;\n\tfor (const key of schemaKeys) {\n\t\tif (!IDENTITY_KEY.test(key) || extracted.has(key)) continue;\n\t\tconst fromDetails = details[key];\n\t\tif (isIdentityValue(fromDetails)) {\n\t\t\textracted.set(key, fromDetails);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!key.endsWith(\"Id\")) continue;\n\t\tconst nested = details[key.slice(0, -2)];\n\t\tif (isRecord(nested) && isIdentityValue(nested.id)) extracted.set(key, nested.id);\n\t}\n\treturn extracted;\n}\n\nfunction shouldRetainIdentity(details: unknown): boolean {\n\tif (!isRecord(details)) return true;\n\tif (details.error || details.ok === false) return false;\n\tconst status = details.status;\n\tif (typeof status !== \"string\") return true;\n\treturn status === \"resolved\" || status === \"ok\" || status === \"success\";\n}\n\nfunction isVacantIdentity(value: unknown): boolean {\n\treturn value === undefined || value === null || value === \"\";\n}\n\nfunction isIdentityValue(value: unknown): value is string {\n\treturn (\n\t\ttypeof value === \"string\" &&\n\t\tvalue.length > 0 &&\n\t\tvalue.length <= MAX_IDENTITY_CHARS &&\n\t\t!value.includes(\"\\0\") &&\n\t\t!value.includes(\"\\n\")\n\t);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"]}

package/dist/core/extensions/index.d.ts

@@ -3,6 +3,7 @@
  */
 export type { SlashCommandInfo, SlashCommandSource } from "../slash-commands.ts";
 export type { SourceInfo } from "../source-info.ts";
+export { applyExtensionSessionHeal, ExtensionSessionScope, extensionScopeOwnerKey, extensionSessionScopeFor, } from "./extension-session-scope.ts";
 export { createExtensionRuntime } from "./factory-runtime.ts";
 export type { ExtensionErrorListener, ForkHandler, NavigateTreeHandler, NewSessionHandler, ShutdownHandler, SwitchSessionHandler, } from "./runner.ts";
 export { ExtensionRunner } from "./runner.ts";

package/dist/core/extensions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACjF,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,YAAY,EACX,sBAAsB,EACtB,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACX,0BAA0B,EAC1B,aAAa,EACb,eAAe,EAEf,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAElB,aAAa,EACb,2BAA2B,EAE3B,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,gCAAgC,EAChC,wBAAwB,EAExB,cAAc,EAEd,YAAY,EAEZ,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAEhB,YAAY,EACZ,uBAAuB,EACvB,8BAA8B,EAC9B,gBAAgB,EAChB,uBAAuB,EAEvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAEhB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EAEnB,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EAEjB,eAAe,EAEf,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAEjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EAEnB,iBAAiB,EACjB,cAAc,EACd,sBAAsB,EACtB,eAAe,EAEf,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EAEpB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EAEpB,aAAa,EACb,mBAAmB,EAEnB,cAAc,EAEd,qBAAqB,EAErB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,QAAQ,EACR,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,cAAc,EAEd,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACN,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/index.ts"],"names":[],"mappings":"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"}

package/dist/core/extensions/index.js

@@ -1,6 +1,7 @@
 /**
  * Extension system for lifecycle events and custom tools.
  */
+export { applyExtensionSessionHeal, ExtensionSessionScope, extensionScopeOwnerKey, extensionSessionScopeFor, } from "./extension-session-scope.js";
 export { createExtensionRuntime } from "./factory-runtime.js";
 export { ExtensionRunner } from "./runner.js";
 // Type guards

package/dist/core/extensions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/extensions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAS9D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA6I9C,cAAc;AACd,OAAO,EACN,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Extension system for lifecycle events and custom tools.\n */\n\nexport type { SlashCommandInfo, SlashCommandSource } from \"../slash-commands.ts\";\nexport type { SourceInfo } from \"../source-info.ts\";\nexport { createExtensionRuntime } from \"./factory-runtime.ts\";\nexport type {\n\tExtensionErrorListener,\n\tForkHandler,\n\tNavigateTreeHandler,\n\tNewSessionHandler,\n\tShutdownHandler,\n\tSwitchSessionHandler,\n} from \"./runner.ts\";\nexport { ExtensionRunner } from \"./runner.ts\";\nexport type {\n\tAfterProviderResponseEvent,\n\tAgentEndEvent,\n\tAgentStartEvent,\n\t// Re-exports\n\tAgentToolResult,\n\tAgentToolUpdateCallback,\n\tAppendEntryHandler,\n\t// App keybindings (for custom editors)\n\tAppKeybinding,\n\tAutocompleteProviderFactory,\n\t// Events - Tool (ToolCallEvent types)\n\tBashToolCallEvent,\n\tBashToolResultEvent,\n\tBeforeAgentStartEvent,\n\tBeforeAgentStartEventResult,\n\tBeforeProviderRequestEvent,\n\tBeforeProviderRequestEventResult,\n\tBuildSystemPromptOptions,\n\t// Context\n\tCompactOptions,\n\t// Events - Agent\n\tContextEvent,\n\t// Event Results\n\tContextEventResult,\n\tContextUsage,\n\tCustomToolCallEvent,\n\tCustomToolResultEvent,\n\tEditorFactory,\n\tEditToolCallEvent,\n\tEditToolResultEvent,\n\tExecOptions,\n\tExecResult,\n\tExtension,\n\tExtensionActions,\n\t// API\n\tExtensionAPI,\n\tExtensionCommandContext,\n\tExtensionCommandContextActions,\n\tExtensionContext,\n\tExtensionContextActions,\n\t// Errors\n\tExtensionError,\n\tExtensionEvent,\n\tExtensionFactory,\n\tExtensionFlag,\n\tExtensionHandler,\n\t// Runtime\n\tExtensionRuntime,\n\tExtensionShortcut,\n\tExtensionStorage,\n\tExtensionUIContext,\n\tExtensionUIDialogOptions,\n\tExtensionWidgetOptions,\n\tExtensionWorkRunOptions,\n\tFindToolCallEvent,\n\tFindToolResultEvent,\n\tGetActiveToolsHandler,\n\tGetAllToolsHandler,\n\tGetCommandsHandler,\n\tGetThinkingLevelHandler,\n\tGrepToolCallEvent,\n\tGrepToolResultEvent,\n\t// Events - Input\n\tInputEvent,\n\tInputEventResult,\n\tInputSource,\n\tKeybindingsManager,\n\tLoadExtensionsResult,\n\tLsToolCallEvent,\n\tLsToolResultEvent,\n\t// Events - Message\n\tMessageEndEvent,\n\t// Message Rendering\n\tMessageRenderer,\n\tMessageRenderOptions,\n\tMessageStartEvent,\n\tMessageUpdateEvent,\n\tModelSelectEvent,\n\tModelSelectSource,\n\t// Provider Registration\n\tProviderConfig,\n\tProviderModelConfig,\n\tReadToolCallEvent,\n\tReadToolResultEvent,\n\t// Commands\n\tRegisteredCommand,\n\tRegisteredTool,\n\tReplacedSessionContext,\n\tResolvedCommand,\n\t// Events - Resources\n\tResourcesDiscoverEvent,\n\tResourcesDiscoverResult,\n\tSendMessageHandler,\n\tSendUserMessageHandler,\n\tSessionBeforeCompactEvent,\n\tSessionBeforeCompactResult,\n\tSessionBeforeForkEvent,\n\tSessionBeforeForkResult,\n\tSessionBeforeSwitchEvent,\n\tSessionBeforeSwitchResult,\n\tSessionBeforeTreeEvent,\n\tSessionBeforeTreeResult,\n\tSessionCompactEvent,\n\tSessionEvent,\n\tSessionShutdownEvent,\n\t// Events - Session\n\tSessionStartEvent,\n\tSessionTreeEvent,\n\tSetActiveToolsHandler,\n\tSetLabelHandler,\n\tSetModelHandler,\n\tSetThinkingLevelHandler,\n\tTerminalInputHandler,\n\t// Events - Tool\n\tToolCallEvent,\n\tToolCallEventResult,\n\t// Tools\n\tToolDefinition,\n\t// Events - Tool Execution\n\tToolExecutionEndEvent,\n\t// Tool execution mode\n\tToolExecutionMode,\n\tToolExecutionStartEvent,\n\tToolExecutionUpdateEvent,\n\tToolInfo,\n\tToolRenderResultOptions,\n\tToolResultEvent,\n\tToolResultEventResult,\n\tTreePreparation,\n\tTurnEndEvent,\n\tTurnStartEvent,\n\t// Events - User Bash\n\tUserBashEvent,\n\tUserBashEventResult,\n\tWidgetPlacement,\n\tWorkingIndicatorOptions,\n\tWriteToolCallEvent,\n\tWriteToolResultEvent,\n} from \"./types.ts\";\n// Type guards\nexport {\n\tdefineTool,\n\tisBashToolResult,\n\tisEditToolResult,\n\tisFindToolResult,\n\tisGrepToolResult,\n\tisLsToolResult,\n\tisReadToolResult,\n\tisToolCallEventType,\n\tisWriteToolResult,\n} from \"./types.ts\";\nexport { wrapRegisteredTool, wrapRegisteredTools } from \"./wrapper.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/extensions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EACN,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,GACxB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAS9D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA6I9C,cAAc;AACd,OAAO,EACN,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Extension system for lifecycle events and custom tools.\n */\n\nexport type { SlashCommandInfo, SlashCommandSource } from \"../slash-commands.ts\";\nexport type { SourceInfo } from \"../source-info.ts\";\nexport {\n\tapplyExtensionSessionHeal,\n\tExtensionSessionScope,\n\textensionScopeOwnerKey,\n\textensionSessionScopeFor,\n} from \"./extension-session-scope.ts\";\nexport { createExtensionRuntime } from \"./factory-runtime.ts\";\nexport type {\n\tExtensionErrorListener,\n\tForkHandler,\n\tNavigateTreeHandler,\n\tNewSessionHandler,\n\tShutdownHandler,\n\tSwitchSessionHandler,\n} from \"./runner.ts\";\nexport { ExtensionRunner } from \"./runner.ts\";\nexport type {\n\tAfterProviderResponseEvent,\n\tAgentEndEvent,\n\tAgentStartEvent,\n\t// Re-exports\n\tAgentToolResult,\n\tAgentToolUpdateCallback,\n\tAppendEntryHandler,\n\t// App keybindings (for custom editors)\n\tAppKeybinding,\n\tAutocompleteProviderFactory,\n\t// Events - Tool (ToolCallEvent types)\n\tBashToolCallEvent,\n\tBashToolResultEvent,\n\tBeforeAgentStartEvent,\n\tBeforeAgentStartEventResult,\n\tBeforeProviderRequestEvent,\n\tBeforeProviderRequestEventResult,\n\tBuildSystemPromptOptions,\n\t// Context\n\tCompactOptions,\n\t// Events - Agent\n\tContextEvent,\n\t// Event Results\n\tContextEventResult,\n\tContextUsage,\n\tCustomToolCallEvent,\n\tCustomToolResultEvent,\n\tEditorFactory,\n\tEditToolCallEvent,\n\tEditToolResultEvent,\n\tExecOptions,\n\tExecResult,\n\tExtension,\n\tExtensionActions,\n\t// API\n\tExtensionAPI,\n\tExtensionCommandContext,\n\tExtensionCommandContextActions,\n\tExtensionContext,\n\tExtensionContextActions,\n\t// Errors\n\tExtensionError,\n\tExtensionEvent,\n\tExtensionFactory,\n\tExtensionFlag,\n\tExtensionHandler,\n\t// Runtime\n\tExtensionRuntime,\n\tExtensionShortcut,\n\tExtensionStorage,\n\tExtensionUIContext,\n\tExtensionUIDialogOptions,\n\tExtensionWidgetOptions,\n\tExtensionWorkRunOptions,\n\tFindToolCallEvent,\n\tFindToolResultEvent,\n\tGetActiveToolsHandler,\n\tGetAllToolsHandler,\n\tGetCommandsHandler,\n\tGetThinkingLevelHandler,\n\tGrepToolCallEvent,\n\tGrepToolResultEvent,\n\t// Events - Input\n\tInputEvent,\n\tInputEventResult,\n\tInputSource,\n\tKeybindingsManager,\n\tLoadExtensionsResult,\n\tLsToolCallEvent,\n\tLsToolResultEvent,\n\t// Events - Message\n\tMessageEndEvent,\n\t// Message Rendering\n\tMessageRenderer,\n\tMessageRenderOptions,\n\tMessageStartEvent,\n\tMessageUpdateEvent,\n\tModelSelectEvent,\n\tModelSelectSource,\n\t// Provider Registration\n\tProviderConfig,\n\tProviderModelConfig,\n\tReadToolCallEvent,\n\tReadToolResultEvent,\n\t// Commands\n\tRegisteredCommand,\n\tRegisteredTool,\n\tReplacedSessionContext,\n\tResolvedCommand,\n\t// Events - Resources\n\tResourcesDiscoverEvent,\n\tResourcesDiscoverResult,\n\tSendMessageHandler,\n\tSendUserMessageHandler,\n\tSessionBeforeCompactEvent,\n\tSessionBeforeCompactResult,\n\tSessionBeforeForkEvent,\n\tSessionBeforeForkResult,\n\tSessionBeforeSwitchEvent,\n\tSessionBeforeSwitchResult,\n\tSessionBeforeTreeEvent,\n\tSessionBeforeTreeResult,\n\tSessionCompactEvent,\n\tSessionEvent,\n\tSessionShutdownEvent,\n\t// Events - Session\n\tSessionStartEvent,\n\tSessionTreeEvent,\n\tSetActiveToolsHandler,\n\tSetLabelHandler,\n\tSetModelHandler,\n\tSetThinkingLevelHandler,\n\tTerminalInputHandler,\n\t// Events - Tool\n\tToolCallEvent,\n\tToolCallEventResult,\n\t// Tools\n\tToolDefinition,\n\t// Events - Tool Execution\n\tToolExecutionEndEvent,\n\t// Tool execution mode\n\tToolExecutionMode,\n\tToolExecutionStartEvent,\n\tToolExecutionUpdateEvent,\n\tToolInfo,\n\tToolRenderResultOptions,\n\tToolResultEvent,\n\tToolResultEventResult,\n\tTreePreparation,\n\tTurnEndEvent,\n\tTurnStartEvent,\n\t// Events - User Bash\n\tUserBashEvent,\n\tUserBashEventResult,\n\tWidgetPlacement,\n\tWorkingIndicatorOptions,\n\tWriteToolCallEvent,\n\tWriteToolResultEvent,\n} from \"./types.ts\";\n// Type guards\nexport {\n\tdefineTool,\n\tisBashToolResult,\n\tisEditToolResult,\n\tisFindToolResult,\n\tisGrepToolResult,\n\tisLsToolResult,\n\tisReadToolResult,\n\tisToolCallEventType,\n\tisWriteToolResult,\n} from \"./types.ts\";\nexport { wrapRegisteredTool, wrapRegisteredTools } from \"./wrapper.ts\";\n"]}

package/dist/core/extensions/types.d.ts

@@ -1131,6 +1131,8 @@ export interface ProviderConfig {
     oauth?: {
         /** Display name for the provider in login UI. */
         name: string;
+        /** Whether access through this auth method is backed by a provider subscription. */
+        isSubscription?: boolean;
         /** Run the login flow, return credentials to persist. */
         login(callbacks: OAuthLoginCallbacks): Promise<OAuthCredentials>;
         /** Refresh expired credentials, return updated credentials to persist. */