@vetta-org/plugin-sdk 0.1.1 → 0.3.0

package/dist/activity-tab.d.ts

@@ -6,6 +6,8 @@ export interface ActivityTabContextValue {
      * active conversation may belong to another project (or be null).
      */
     cwd: string | null;
+    /** Whether this tab is the selected docked tab or a visible floating tab. */
+    active: boolean;
 }
 /**
  * Internal: the host wraps attached activity-tab components in this context's

package/dist/activity-tab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity-tab.d.ts","sourceRoot":"","sources":["../src/activity-tab.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACvC;;;;;OAKG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,kDAAwD,CAAC;AAE1F,yEAAyE;AACzE,wBAAgB,cAAc,IAAI,uBAAuB,CAExD","sourcesContent":["import { createContext, useContext } from \"react\";\n\nexport interface ActivityTabContextValue {\n\t/**\n\t * The cwd scope of the activity panel this tab is rendered in — the same\n\t * key the attach record uses. Do NOT substitute useActiveConversation().cwd:\n\t * on the project detail page the panel cwd is the project's, while the\n\t * active conversation may belong to another project (or be null).\n\t */\n\tcwd: string | null;\n}\n\n/**\n * Internal: the host wraps attached activity-tab components in this context's\n * Provider. Module Federation shares this single SDK instance, so the value\n * the host provides is visible to plugin components.\n */\nexport const __ActivityTabContext = createContext<ActivityTabContextValue>({ cwd: null });\n\n/** The panel scope of the activity tab this component is rendered in. */\nexport function useActivityTab(): ActivityTabContextValue {\n\treturn useContext(__ActivityTabContext);\n}\n"]}
+{"version":3,"file":"activity-tab.d.ts","sourceRoot":"","sources":["../src/activity-tab.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,uBAAuB;IACvC;;;;;OAKG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,kDAAuE,CAAC;AAEzG,yEAAyE;AACzE,wBAAgB,cAAc,IAAI,uBAAuB,CAExD","sourcesContent":["import { createContext, useContext } from \"react\";\n\nexport interface ActivityTabContextValue {\n\t/**\n\t * The cwd scope of the activity panel this tab is rendered in — the same\n\t * key the attach record uses. Do NOT substitute useActiveConversation().cwd:\n\t * on the project detail page the panel cwd is the project's, while the\n\t * active conversation may belong to another project (or be null).\n\t */\n\tcwd: string | null;\n\t/** Whether this tab is the selected docked tab or a visible floating tab. */\n\tactive: boolean;\n}\n\n/**\n * Internal: the host wraps attached activity-tab components in this context's\n * Provider. Module Federation shares this single SDK instance, so the value\n * the host provides is visible to plugin components.\n */\nexport const __ActivityTabContext = createContext<ActivityTabContextValue>({ cwd: null, active: false });\n\n/** The panel scope of the activity tab this component is rendered in. */\nexport function useActivityTab(): ActivityTabContextValue {\n\treturn useContext(__ActivityTabContext);\n}\n"]}

package/dist/activity-tab.js

@@ -4,7 +4,7 @@ import { createContext, useContext } from "react";
  * Provider. Module Federation shares this single SDK instance, so the value
  * the host provides is visible to plugin components.
  */
-export const __ActivityTabContext = createContext({ cwd: null });
+export const __ActivityTabContext = createContext({ cwd: null, active: false });
 /** The panel scope of the activity tab this component is rendered in. */
 export function useActivityTab() {
     return useContext(__ActivityTabContext);

package/dist/activity-tab.js.map

@@ -1 +1 @@
-{"version":3,"file":"activity-tab.js","sourceRoot":"","sources":["../src/activity-tab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAYlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAA0B,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAE1F,yEAAyE;AACzE,MAAM,UAAU,cAAc,GAA4B;IACzD,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAAA,CACxC","sourcesContent":["import { createContext, useContext } from \"react\";\n\nexport interface ActivityTabContextValue {\n\t/**\n\t * The cwd scope of the activity panel this tab is rendered in — the same\n\t * key the attach record uses. Do NOT substitute useActiveConversation().cwd:\n\t * on the project detail page the panel cwd is the project's, while the\n\t * active conversation may belong to another project (or be null).\n\t */\n\tcwd: string | null;\n}\n\n/**\n * Internal: the host wraps attached activity-tab components in this context's\n * Provider. Module Federation shares this single SDK instance, so the value\n * the host provides is visible to plugin components.\n */\nexport const __ActivityTabContext = createContext<ActivityTabContextValue>({ cwd: null });\n\n/** The panel scope of the activity tab this component is rendered in. */\nexport function useActivityTab(): ActivityTabContextValue {\n\treturn useContext(__ActivityTabContext);\n}\n"]}
+{"version":3,"file":"activity-tab.js","sourceRoot":"","sources":["../src/activity-tab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAclD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAA0B,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAEzG,yEAAyE;AACzE,MAAM,UAAU,cAAc,GAA4B;IACzD,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAAA,CACxC","sourcesContent":["import { createContext, useContext } from \"react\";\n\nexport interface ActivityTabContextValue {\n\t/**\n\t * The cwd scope of the activity panel this tab is rendered in — the same\n\t * key the attach record uses. Do NOT substitute useActiveConversation().cwd:\n\t * on the project detail page the panel cwd is the project's, while the\n\t * active conversation may belong to another project (or be null).\n\t */\n\tcwd: string | null;\n\t/** Whether this tab is the selected docked tab or a visible floating tab. */\n\tactive: boolean;\n}\n\n/**\n * Internal: the host wraps attached activity-tab components in this context's\n * Provider. Module Federation shares this single SDK instance, so the value\n * the host provides is visible to plugin components.\n */\nexport const __ActivityTabContext = createContext<ActivityTabContextValue>({ cwd: null, active: false });\n\n/** The panel scope of the activity tab this component is rendered in. */\nexport function useActivityTab(): ActivityTabContextValue {\n\treturn useContext(__ActivityTabContext);\n}\n"]}

package/dist/agent.d.ts

@@ -26,7 +26,10 @@ export interface PluginAgentToolRegistration<TInput = unknown> {
     scope_use?: readonly ConversationScenario[];
     /** 需要的会话能力 slug（如 "knowledge"）；全满足才激活。一般插件无需设置。 */
     requires?: string[];
-    /** 允许该工具出现的工作模式 slug（agent_mode 轴，如 "work"/"coding"）。缺省/空 = 通用。见 ADR-0046。 */
+    /**
+     * @deprecated 工作模式不再影响工具的可用性与顺序（ADR-0071）。字段容忍传入但被宿主忽略；
+     * 需要限定使用场景请写进 description 的反向触发段（Do NOT / Only for）。
+     */
     agent_mode?: readonly string[];
     context?: {
         conversation?: "summary" | "messages";
@@ -75,7 +78,6 @@ export interface PluginSystemPromptProviderContext {
     plugin: {
         id: string;
         providerId: string;
-        settings: Readonly<Record<string, unknown>>;
     };
     session: {
         id: string;
@@ -132,8 +134,11 @@ export interface PluginAgentActions {
         setBlockEnabled(blockId: string, enabled: boolean): void;
     };
     tools: {
+        /** Emit a Turn-local tool effect. It applies after this handler succeeds. */
         setEnabled(toolName: string, enabled: boolean): void;
+        /** Enable an already registered tool for subsequent model calls in this Turn. */
         enable(toolName: string): void;
+        /** Disable an already registered tool for subsequent model calls in this Turn. */
         disable(toolName: string): void;
     };
     continuation: {
@@ -145,7 +150,6 @@ export interface PluginAgentHandlerContext<TTrigger> {
     plugin: {
         id: string;
         contributionId: string;
-        settings: Readonly<Record<string, unknown>>;
     };
     session: PluginSystemPromptProviderContext["session"];
     model: PluginSystemPromptProviderContext["model"];
@@ -198,14 +202,154 @@ export interface PluginContinuationRegistration {
     };
     handler: PluginContinuationHandler;
 }
+export declare const PLUGIN_CODING_AGENT_HOOK_EVENT_NAMES: readonly ["SessionStart", "SessionEnd", "UserPromptSubmit", "PreToolUse", "PermissionRequest", "PostToolUse", "PostToolUseFailure", "PreCompact", "PostCompact", "SubagentStart", "SubagentStop", "Stop"];
+export type PluginCodingAgentHookEventName = (typeof PLUGIN_CODING_AGENT_HOOK_EVENT_NAMES)[number];
+export type PluginCodingAgentPermissionMode = "default" | "acceptEdits" | "plan" | "dontAsk" | "bypassPermissions";
+export interface PluginCodingAgentHookTool {
+    hostName: string;
+    kind: "function" | "shell" | "mcp" | "file-edit" | "agent" | "custom";
+    source?: {
+        ecosystem?: string;
+        serverName?: string;
+        originalName?: string;
+    };
+}
+interface PluginCodingAgentHookEventBase {
+    sessionId: string;
+    cwd: string;
+    model: string;
+    permissionMode: PluginCodingAgentPermissionMode;
+    subagent?: {
+        agentId: string;
+        agentType: string;
+    };
+}
+export type PluginCodingAgentHookEvent = (PluginCodingAgentHookEventBase & {
+    eventName: "SessionStart";
+    source: "startup" | "resume" | "clear" | "compact";
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "SessionEnd";
+    cause: "new_session" | "switch_session" | "fork_session" | "dispose";
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "UserPromptSubmit";
+    turnId: string;
+    prompt: string;
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "PreToolUse";
+    turnId: string;
+    tool: PluginCodingAgentHookTool;
+    toolUseId: string;
+    toolInput: unknown;
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "PermissionRequest";
+    turnId: string;
+    tool: PluginCodingAgentHookTool;
+    toolInput: unknown;
+    runIdSuffix: string;
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "PostToolUse";
+    turnId: string;
+    tool: PluginCodingAgentHookTool;
+    toolUseId: string;
+    toolInput: unknown;
+    toolResponse: unknown;
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "PostToolUseFailure";
+    turnId: string;
+    tool: PluginCodingAgentHookTool;
+    toolUseId: string;
+    toolInput: unknown;
+    error: string;
+    isInterrupt?: boolean;
+    durationMs?: number;
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "PreCompact" | "PostCompact";
+    turnId: string;
+    trigger: "manual" | "auto";
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "SubagentStart";
+    turnId: string;
+    agentId: string;
+    agentType: string;
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "SubagentStop";
+    turnId: string;
+    agentId: string;
+    agentType: string;
+    stopHookActive: boolean;
+    lastAssistantMessage: string | null;
+}) | (PluginCodingAgentHookEventBase & {
+    eventName: "Stop";
+    turnId: string;
+    stopHookActive: boolean;
+    lastAssistantMessage: string | null;
+});
+export type PluginCodingAgentHookEventOf<E extends PluginCodingAgentHookEventName> = Extract<PluginCodingAgentHookEvent, {
+    eventName: E;
+}>;
+interface PluginCodingAgentHookContinueResult {
+    action: "continue";
+    additionalContexts?: readonly string[];
+    feedbackMessage?: string;
+}
+type PluginCodingAgentHookTerminalResult = {
+    action: "block";
+    reason: string;
+} | {
+    action: "stop";
+    reason?: string;
+};
+export type PluginCodingAgentHookResult<E extends PluginCodingAgentHookEventName> = PluginCodingAgentHookTerminalResult | (PluginCodingAgentHookContinueResult & (E extends "PreToolUse" ? {
+    updatedToolInput?: Record<string, unknown>;
+} : object) & (E extends "PermissionRequest" ? {
+    permissionDecision?: "allow" | "deny";
+    permissionMessage?: string;
+} : object)) | (E extends "Stop" | "SubagentStop" ? {
+    action: "continue-agent";
+    continuationFragments: readonly string[];
+} : never);
+export interface PluginCodingAgentHookHandlerContext<E extends PluginCodingAgentHookEventName> {
+    invocationId: string;
+    plugin: {
+        id: string;
+        contributionId: string;
+    };
+    session: {
+        id: string;
+        cwd: string;
+        scenario: ConversationScenario;
+    };
+    event: PluginCodingAgentHookEventOf<E>;
+    host: PluginAgentToolApi;
+}
+export type PluginCodingAgentHookHandler<E extends PluginCodingAgentHookEventName> = (context: PluginCodingAgentHookHandlerContext<E>) => void | PluginCodingAgentHookResult<E> | Promise<void | PluginCodingAgentHookResult<E>>;
+export interface PluginCodingAgentHookRegistration<E extends PluginCodingAgentHookEventName = PluginCodingAgentHookEventName> {
+    id: string;
+    eventName: E;
+    /** Hook 是可执行贡献，必须显式声明允许出现的会话场景。 */
+    scope_use: readonly ConversationScenario[];
+    /** @deprecated 工作模式不参与 hook 触发（ADR-0071）。字段容忍传入但被宿主忽略。 */
+    agent_mode?: readonly string[];
+    /** 工具事件只匹配列出的宿主工具名；缺省/空数组表示所有工具。 */
+    toolNames?: readonly string[];
+    timeoutMs?: number;
+    handler: PluginCodingAgentHookHandler<E>;
+}
 export interface PluginAgentApi {
     registerTool<TInput = unknown>(registration: PluginAgentToolRegistration<TInput>): Disposable;
-    /** Register a provider evaluated before every Agent run. */
+    /**
+     * Register a provider evaluated once at the beginning of each Agent Turn.
+     * Its effects are replayed across later model calls in that Turn; changing plugin
+     * state does not re-run the provider before the next Turn.
+     */
     registerSystemPromptProvider(registration: PluginSystemPromptProviderRegistration): Disposable;
     /**
      * Register a policy consulted when the agent reaches a natural stopping point.
      * Return null to allow the agent to stop, or a message to continue with another turn.
      */
     registerContinuationProvider(registration: PluginContinuationRegistration): Disposable;
+    /** Register a typed, dynamically removable Coding Agent lifecycle hook. */
+    registerHook<E extends PluginCodingAgentHookEventName>(registration: PluginCodingAgentHookRegistration<E>): Disposable;
 }
+export {};
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginConversationApi } from \"./conversation.js\";\nimport type { Disposable } from \"./disposable.js\";\nimport type { PluginFsApi } from \"./fs.js\";\nimport type { ConversationScenario } from \"./scenario.js\";\n\nexport type PluginJsonSchema = object;\n\nexport interface PluginAgentToolApi {\n\tfs: PluginFsApi;\n\tconversation: PluginConversationApi;\n}\n\nexport interface PluginAgentToolRegistration<TInput = unknown> {\n\tid: string;\n\tname?: string;\n\t/**\n\t * Host UI display name for this tool (e.g. Work-mode tool headers).\n\t * Supports `%catalogKey%` resolved against the plugin's locales; bare strings\n\t * are used as literals. Not sent to the model — use {@link description} for that.\n\t */\n\tlabel?: string;\n\tdescription: string;\n\tparameters: PluginJsonSchema;\n\ttimeoutMs?: number;\n\t/**\n\t * 允许该工具出现的对话场景 slug 列表。**fail-closed**：未声明/空数组 = 所有场景都不激活。\n\t * 插件须显式声明。\n\t */\n\tscope_use?: readonly ConversationScenario[];\n\t/** 需要的会话能力 slug（如 \"knowledge\"）；全满足才激活。一般插件无需设置。 */\n\trequires?: string[];\n\t/** 允许该工具出现的工作模式 slug（agent_mode 轴，如 \"work\"/\"coding\"）。缺省/空 = 通用。见 ADR-0046。 */\n\tagent_mode?: readonly string[];\n\tcontext?: { conversation?: \"summary\" | \"messages\" };\n\thandler: PluginAgentToolHandler<TInput>;\n}\n\nexport interface PluginSystemPromptBlock {\n\tid: string;\n\tcontent: string;\n\tpriority?: number;\n\tenabled?: boolean;\n}\n\nexport type PluginDynamicSystemPromptOperation =\n\t| { type: \"addBlock\"; block: PluginSystemPromptBlock }\n\t| { type: \"replaceBlock\"; blockId: string; block: Omit<PluginSystemPromptBlock, \"id\"> }\n\t| {\n\t\t\ttype: \"updateBlock\";\n\t\t\tblockId: string;\n\t\t\tpatch: Partial<Pick<PluginSystemPromptBlock, \"content\" | \"priority\" | \"enabled\">>;\n\t  }\n\t| { type: \"removeBlock\"; blockId: string }\n\t| { type: \"setBlockEnabled\"; blockId: string; enabled: boolean }\n\t| { type: \"setToolEnabled\"; toolName: string; enabled: boolean }\n\t| { type: \"requestContinuation\"; result: PluginContinuationResult };\n\nexport interface PluginSystemPromptMessage {\n\trole: string;\n\ttext: string;\n\ttimestamp?: number;\n\ttoolName?: string;\n}\n\nexport interface PluginSystemPromptProviderContext {\n\tplugin: {\n\t\tid: string;\n\t\tproviderId: string;\n\t\tsettings: Readonly<Record<string, unknown>>;\n\t};\n\tsession: {\n\t\tid: string;\n\t\tcwd: string;\n\t\tscenario: ConversationScenario;\n\t};\n\tmodel: {\n\t\tprovider: string;\n\t\tid: string;\n\t\tapi: string;\n\t\tinput: readonly string[];\n\t\tcontextWindow?: number;\n\t\tmaxTokens?: number;\n\t};\n\tconversation: {\n\t\tmessages: readonly PluginSystemPromptMessage[];\n\t\tmessageCount: number;\n\t};\n\truntime: {\n\t\tactiveToolNames: readonly string[];\n\t\tavailableToolNames: readonly string[];\n\t\trunIndex: number;\n\t};\n\ttrigger: {\n\t\tkind: \"agent-run\";\n\t\ttimestamp: number;\n\t};\n\tsystemPrompt?: {\n\t\tbase: {\n\t\t\tblocks?: readonly PluginSystemPromptBlockView[];\n\t\t\trendered?: string;\n\t\t};\n\t\tcurrent: {\n\t\t\tblocks?: readonly PluginSystemPromptBlockView[];\n\t\t\trendered?: string;\n\t\t};\n\t};\n}\n\nexport interface PluginSystemPromptBlockView extends PluginSystemPromptBlock {\n\ttype: string;\n\tsource: {\n\t\tkind: \"core\" | \"plugin\";\n\t\tpluginId?: string;\n\t};\n\tpriority: number;\n\tenabled: boolean;\n}\n\nexport interface PluginAgentActions {\n\tsystemPrompt: {\n\t\taddBlock(block: PluginSystemPromptBlock): void;\n\t\treplaceBlock(blockId: string, block: Omit<PluginSystemPromptBlock, \"id\">): void;\n\t\tupdateBlock(\n\t\t\tblockId: string,\n\t\t\tpatch: Partial<Pick<PluginSystemPromptBlock, \"content\" | \"priority\" | \"enabled\">>,\n\t\t): void;\n\t\tremoveBlock(blockId: string): void;\n\t\tsetBlockEnabled(blockId: string, enabled: boolean): void;\n\t};\n\ttools: {\n\t\tsetEnabled(toolName: string, enabled: boolean): void;\n\t\tenable(toolName: string): void;\n\t\tdisable(toolName: string): void;\n\t};\n\tcontinuation: {\n\t\trequest(result: PluginContinuationResult): void;\n\t};\n}\n\nexport interface PluginAgentHandlerContext<TTrigger> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tcontributionId: string;\n\t\tsettings: Readonly<Record<string, unknown>>;\n\t};\n\tsession: PluginSystemPromptProviderContext[\"session\"];\n\tmodel: PluginSystemPromptProviderContext[\"model\"];\n\tconversation: PluginSystemPromptProviderContext[\"conversation\"];\n\truntime: PluginSystemPromptProviderContext[\"runtime\"];\n\ttrigger: TTrigger;\n\tsystemPrompt?: PluginSystemPromptProviderContext[\"systemPrompt\"];\n\tactions: PluginAgentActions;\n\thost: PluginAgentToolApi;\n}\n\nexport type PluginAgentToolHandler<TInput = unknown> = (\n\tcontext: PluginAgentHandlerContext<{\n\t\tkind: \"tool-call\";\n\t\ttimestamp: number;\n\t\ttoolCallId: string;\n\t\ttoolId: string;\n\t\ttoolName: string;\n\t\tinput: TInput;\n\t}>,\n) => unknown | Promise<unknown>;\n\nexport type PluginSystemPromptProviderHandler = (\n\tcontext: PluginAgentHandlerContext<{ kind: \"agent-run\"; timestamp: number }>,\n) => void | PluginDynamicSystemPromptOperation[] | Promise<void | PluginDynamicSystemPromptOperation[]>;\n\nexport interface PluginSystemPromptProviderRegistration {\n\tid: string;\n\ttimeoutMs?: number;\n\t/**\n\t * Large context is opt-in. Omitted fields are not serialized across the\n\t * host/renderer boundary.\n\t */\n\tcontext?: {\n\t\tsystemPrompt?: \"none\" | \"blocks\" | \"rendered\" | \"full\";\n\t\tconversation?: \"summary\" | \"messages\";\n\t};\n\thandler: PluginSystemPromptProviderHandler;\n}\n\nexport interface PluginContinuationResult {\n\ttext: string;\n\t/** Stable key used by the host to suppress duplicate continuations in a session. */\n\tidempotencyKey?: string;\n}\n\nexport type PluginContinuationHandler = (\n\tcontext: PluginAgentHandlerContext<{ kind: \"continuation\"; timestamp: number }>,\n) => PluginContinuationResult | null | Promise<PluginContinuationResult | null>;\n\nexport interface PluginContinuationRegistration {\n\tid: string;\n\ttimeoutMs?: number;\n\tcontext?: { conversation?: \"summary\" | \"messages\" };\n\thandler: PluginContinuationHandler;\n}\n\nexport interface PluginAgentApi {\n\tregisterTool<TInput = unknown>(registration: PluginAgentToolRegistration<TInput>): Disposable;\n\t/** Register a provider evaluated before every Agent run. */\n\tregisterSystemPromptProvider(registration: PluginSystemPromptProviderRegistration): Disposable;\n\t/**\n\t * Register a policy consulted when the agent reaches a natural stopping point.\n\t * Return null to allow the agent to stop, or a message to continue with another turn.\n\t */\n\tregisterContinuationProvider(registration: PluginContinuationRegistration): Disposable;\n}\n"]}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginConversationApi } from \"./conversation.js\";\nimport type { Disposable } from \"./disposable.js\";\nimport type { PluginFsApi } from \"./fs.js\";\nimport type { ConversationScenario } from \"./scenario.js\";\n\nexport type PluginJsonSchema = object;\n\nexport interface PluginAgentToolApi {\n\tfs: PluginFsApi;\n\tconversation: PluginConversationApi;\n}\n\nexport interface PluginAgentToolRegistration<TInput = unknown> {\n\tid: string;\n\tname?: string;\n\t/**\n\t * Host UI display name for this tool (e.g. Work-mode tool headers).\n\t * Supports `%catalogKey%` resolved against the plugin's locales; bare strings\n\t * are used as literals. Not sent to the model — use {@link description} for that.\n\t */\n\tlabel?: string;\n\tdescription: string;\n\tparameters: PluginJsonSchema;\n\ttimeoutMs?: number;\n\t/**\n\t * 允许该工具出现的对话场景 slug 列表。**fail-closed**：未声明/空数组 = 所有场景都不激活。\n\t * 插件须显式声明。\n\t */\n\tscope_use?: readonly ConversationScenario[];\n\t/** 需要的会话能力 slug（如 \"knowledge\"）；全满足才激活。一般插件无需设置。 */\n\trequires?: string[];\n\t/**\n\t * @deprecated 工作模式不再影响工具的可用性与顺序（ADR-0071）。字段容忍传入但被宿主忽略；\n\t * 需要限定使用场景请写进 description 的反向触发段（Do NOT / Only for）。\n\t */\n\tagent_mode?: readonly string[];\n\tcontext?: { conversation?: \"summary\" | \"messages\" };\n\thandler: PluginAgentToolHandler<TInput>;\n}\n\nexport interface PluginSystemPromptBlock {\n\tid: string;\n\tcontent: string;\n\tpriority?: number;\n\tenabled?: boolean;\n}\n\nexport type PluginDynamicSystemPromptOperation =\n\t| { type: \"addBlock\"; block: PluginSystemPromptBlock }\n\t| { type: \"replaceBlock\"; blockId: string; block: Omit<PluginSystemPromptBlock, \"id\"> }\n\t| {\n\t\t\ttype: \"updateBlock\";\n\t\t\tblockId: string;\n\t\t\tpatch: Partial<Pick<PluginSystemPromptBlock, \"content\" | \"priority\" | \"enabled\">>;\n\t  }\n\t| { type: \"removeBlock\"; blockId: string }\n\t| { type: \"setBlockEnabled\"; blockId: string; enabled: boolean }\n\t| { type: \"setToolEnabled\"; toolName: string; enabled: boolean }\n\t| { type: \"requestContinuation\"; result: PluginContinuationResult };\n\nexport interface PluginSystemPromptMessage {\n\trole: string;\n\ttext: string;\n\ttimestamp?: number;\n\ttoolName?: string;\n}\n\nexport interface PluginSystemPromptProviderContext {\n\tplugin: {\n\t\tid: string;\n\t\tproviderId: string;\n\t};\n\tsession: {\n\t\tid: string;\n\t\tcwd: string;\n\t\tscenario: ConversationScenario;\n\t};\n\tmodel: {\n\t\tprovider: string;\n\t\tid: string;\n\t\tapi: string;\n\t\tinput: readonly string[];\n\t\tcontextWindow?: number;\n\t\tmaxTokens?: number;\n\t};\n\tconversation: {\n\t\tmessages: readonly PluginSystemPromptMessage[];\n\t\tmessageCount: number;\n\t};\n\truntime: {\n\t\tactiveToolNames: readonly string[];\n\t\tavailableToolNames: readonly string[];\n\t\trunIndex: number;\n\t};\n\ttrigger: {\n\t\tkind: \"agent-run\";\n\t\ttimestamp: number;\n\t};\n\tsystemPrompt?: {\n\t\tbase: {\n\t\t\tblocks?: readonly PluginSystemPromptBlockView[];\n\t\t\trendered?: string;\n\t\t};\n\t\tcurrent: {\n\t\t\tblocks?: readonly PluginSystemPromptBlockView[];\n\t\t\trendered?: string;\n\t\t};\n\t};\n}\n\nexport interface PluginSystemPromptBlockView extends PluginSystemPromptBlock {\n\ttype: string;\n\tsource: {\n\t\tkind: \"core\" | \"plugin\";\n\t\tpluginId?: string;\n\t};\n\tpriority: number;\n\tenabled: boolean;\n}\n\nexport interface PluginAgentActions {\n\tsystemPrompt: {\n\t\taddBlock(block: PluginSystemPromptBlock): void;\n\t\treplaceBlock(blockId: string, block: Omit<PluginSystemPromptBlock, \"id\">): void;\n\t\tupdateBlock(\n\t\t\tblockId: string,\n\t\t\tpatch: Partial<Pick<PluginSystemPromptBlock, \"content\" | \"priority\" | \"enabled\">>,\n\t\t): void;\n\t\tremoveBlock(blockId: string): void;\n\t\tsetBlockEnabled(blockId: string, enabled: boolean): void;\n\t};\n\ttools: {\n\t\t/** Emit a Turn-local tool effect. It applies after this handler succeeds. */\n\t\tsetEnabled(toolName: string, enabled: boolean): void;\n\t\t/** Enable an already registered tool for subsequent model calls in this Turn. */\n\t\tenable(toolName: string): void;\n\t\t/** Disable an already registered tool for subsequent model calls in this Turn. */\n\t\tdisable(toolName: string): void;\n\t};\n\tcontinuation: {\n\t\trequest(result: PluginContinuationResult): void;\n\t};\n}\n\nexport interface PluginAgentHandlerContext<TTrigger> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tcontributionId: string;\n\t};\n\tsession: PluginSystemPromptProviderContext[\"session\"];\n\tmodel: PluginSystemPromptProviderContext[\"model\"];\n\tconversation: PluginSystemPromptProviderContext[\"conversation\"];\n\truntime: PluginSystemPromptProviderContext[\"runtime\"];\n\ttrigger: TTrigger;\n\tsystemPrompt?: PluginSystemPromptProviderContext[\"systemPrompt\"];\n\tactions: PluginAgentActions;\n\thost: PluginAgentToolApi;\n}\n\nexport type PluginAgentToolHandler<TInput = unknown> = (\n\tcontext: PluginAgentHandlerContext<{\n\t\tkind: \"tool-call\";\n\t\ttimestamp: number;\n\t\ttoolCallId: string;\n\t\ttoolId: string;\n\t\ttoolName: string;\n\t\tinput: TInput;\n\t}>,\n) => unknown | Promise<unknown>;\n\nexport type PluginSystemPromptProviderHandler = (\n\tcontext: PluginAgentHandlerContext<{ kind: \"agent-run\"; timestamp: number }>,\n) => void | PluginDynamicSystemPromptOperation[] | Promise<void | PluginDynamicSystemPromptOperation[]>;\n\nexport interface PluginSystemPromptProviderRegistration {\n\tid: string;\n\ttimeoutMs?: number;\n\t/**\n\t * Large context is opt-in. Omitted fields are not serialized across the\n\t * host/renderer boundary.\n\t */\n\tcontext?: {\n\t\tsystemPrompt?: \"none\" | \"blocks\" | \"rendered\" | \"full\";\n\t\tconversation?: \"summary\" | \"messages\";\n\t};\n\thandler: PluginSystemPromptProviderHandler;\n}\n\nexport interface PluginContinuationResult {\n\ttext: string;\n\t/** Stable key used by the host to suppress duplicate continuations in a session. */\n\tidempotencyKey?: string;\n}\n\nexport type PluginContinuationHandler = (\n\tcontext: PluginAgentHandlerContext<{ kind: \"continuation\"; timestamp: number }>,\n) => PluginContinuationResult | null | Promise<PluginContinuationResult | null>;\n\nexport interface PluginContinuationRegistration {\n\tid: string;\n\ttimeoutMs?: number;\n\tcontext?: { conversation?: \"summary\" | \"messages\" };\n\thandler: PluginContinuationHandler;\n}\n\nexport const PLUGIN_CODING_AGENT_HOOK_EVENT_NAMES = [\n\t\"SessionStart\",\n\t\"SessionEnd\",\n\t\"UserPromptSubmit\",\n\t\"PreToolUse\",\n\t\"PermissionRequest\",\n\t\"PostToolUse\",\n\t\"PostToolUseFailure\",\n\t\"PreCompact\",\n\t\"PostCompact\",\n\t\"SubagentStart\",\n\t\"SubagentStop\",\n\t\"Stop\",\n] as const;\n\nexport type PluginCodingAgentHookEventName = (typeof PLUGIN_CODING_AGENT_HOOK_EVENT_NAMES)[number];\nexport type PluginCodingAgentPermissionMode =\n\t| \"default\"\n\t| \"acceptEdits\"\n\t| \"plan\"\n\t| \"dontAsk\"\n\t| \"bypassPermissions\";\n\nexport interface PluginCodingAgentHookTool {\n\thostName: string;\n\tkind: \"function\" | \"shell\" | \"mcp\" | \"file-edit\" | \"agent\" | \"custom\";\n\tsource?: { ecosystem?: string; serverName?: string; originalName?: string };\n}\n\ninterface PluginCodingAgentHookEventBase {\n\tsessionId: string;\n\tcwd: string;\n\tmodel: string;\n\tpermissionMode: PluginCodingAgentPermissionMode;\n\tsubagent?: { agentId: string; agentType: string };\n}\n\nexport type PluginCodingAgentHookEvent =\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"SessionStart\";\n\t\t\tsource: \"startup\" | \"resume\" | \"clear\" | \"compact\";\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"SessionEnd\";\n\t\t\tcause: \"new_session\" | \"switch_session\" | \"fork_session\" | \"dispose\";\n\t\t})\n\t| (PluginCodingAgentHookEventBase & { eventName: \"UserPromptSubmit\"; turnId: string; prompt: string })\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PreToolUse\";\n\t\t\tturnId: string;\n\t\t\ttool: PluginCodingAgentHookTool;\n\t\t\ttoolUseId: string;\n\t\t\ttoolInput: unknown;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PermissionRequest\";\n\t\t\tturnId: string;\n\t\t\ttool: PluginCodingAgentHookTool;\n\t\t\ttoolInput: unknown;\n\t\t\trunIdSuffix: string;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PostToolUse\";\n\t\t\tturnId: string;\n\t\t\ttool: PluginCodingAgentHookTool;\n\t\t\ttoolUseId: string;\n\t\t\ttoolInput: unknown;\n\t\t\ttoolResponse: unknown;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PostToolUseFailure\";\n\t\t\tturnId: string;\n\t\t\ttool: PluginCodingAgentHookTool;\n\t\t\ttoolUseId: string;\n\t\t\ttoolInput: unknown;\n\t\t\terror: string;\n\t\t\tisInterrupt?: boolean;\n\t\t\tdurationMs?: number;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PreCompact\" | \"PostCompact\";\n\t\t\tturnId: string;\n\t\t\ttrigger: \"manual\" | \"auto\";\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"SubagentStart\";\n\t\t\tturnId: string;\n\t\t\tagentId: string;\n\t\t\tagentType: string;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"SubagentStop\";\n\t\t\tturnId: string;\n\t\t\tagentId: string;\n\t\t\tagentType: string;\n\t\t\tstopHookActive: boolean;\n\t\t\tlastAssistantMessage: string | null;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"Stop\";\n\t\t\tturnId: string;\n\t\t\tstopHookActive: boolean;\n\t\t\tlastAssistantMessage: string | null;\n\t\t});\n\nexport type PluginCodingAgentHookEventOf<E extends PluginCodingAgentHookEventName> = Extract<\n\tPluginCodingAgentHookEvent,\n\t{ eventName: E }\n>;\n\ninterface PluginCodingAgentHookContinueResult {\n\taction: \"continue\";\n\tadditionalContexts?: readonly string[];\n\tfeedbackMessage?: string;\n}\n\ntype PluginCodingAgentHookTerminalResult =\n\t| { action: \"block\"; reason: string }\n\t| { action: \"stop\"; reason?: string };\n\nexport type PluginCodingAgentHookResult<E extends PluginCodingAgentHookEventName> =\n\t| PluginCodingAgentHookTerminalResult\n\t| (PluginCodingAgentHookContinueResult &\n\t\t\t(E extends \"PreToolUse\" ? { updatedToolInput?: Record<string, unknown> } : object) &\n\t\t\t(E extends \"PermissionRequest\"\n\t\t\t\t? { permissionDecision?: \"allow\" | \"deny\"; permissionMessage?: string }\n\t\t\t\t: object))\n\t| (E extends \"Stop\" | \"SubagentStop\"\n\t\t\t? { action: \"continue-agent\"; continuationFragments: readonly string[] }\n\t\t\t: never);\n\nexport interface PluginCodingAgentHookHandlerContext<E extends PluginCodingAgentHookEventName> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tcontributionId: string;\n\t};\n\tsession: { id: string; cwd: string; scenario: ConversationScenario };\n\tevent: PluginCodingAgentHookEventOf<E>;\n\thost: PluginAgentToolApi;\n}\n\nexport type PluginCodingAgentHookHandler<E extends PluginCodingAgentHookEventName> = (\n\tcontext: PluginCodingAgentHookHandlerContext<E>,\n) => void | PluginCodingAgentHookResult<E> | Promise<void | PluginCodingAgentHookResult<E>>;\n\nexport interface PluginCodingAgentHookRegistration<\n\tE extends PluginCodingAgentHookEventName = PluginCodingAgentHookEventName,\n> {\n\tid: string;\n\teventName: E;\n\t/** Hook 是可执行贡献，必须显式声明允许出现的会话场景。 */\n\tscope_use: readonly ConversationScenario[];\n\t/** @deprecated 工作模式不参与 hook 触发（ADR-0071）。字段容忍传入但被宿主忽略。 */\n\tagent_mode?: readonly string[];\n\t/** 工具事件只匹配列出的宿主工具名；缺省/空数组表示所有工具。 */\n\ttoolNames?: readonly string[];\n\ttimeoutMs?: number;\n\thandler: PluginCodingAgentHookHandler<E>;\n}\n\nexport interface PluginAgentApi {\n\tregisterTool<TInput = unknown>(registration: PluginAgentToolRegistration<TInput>): Disposable;\n\t/**\n\t * Register a provider evaluated once at the beginning of each Agent Turn.\n\t * Its effects are replayed across later model calls in that Turn; changing plugin\n\t * state does not re-run the provider before the next Turn.\n\t */\n\tregisterSystemPromptProvider(registration: PluginSystemPromptProviderRegistration): Disposable;\n\t/**\n\t * Register a policy consulted when the agent reaches a natural stopping point.\n\t * Return null to allow the agent to stop, or a message to continue with another turn.\n\t */\n\tregisterContinuationProvider(registration: PluginContinuationRegistration): Disposable;\n\t/** Register a typed, dynamically removable Coding Agent lifecycle hook. */\n\tregisterHook<E extends PluginCodingAgentHookEventName>(\n\t\tregistration: PluginCodingAgentHookRegistration<E>,\n\t): Disposable;\n}\n"]}

package/dist/agent.js

@@ -1,2 +1,15 @@
-export {};
+export const PLUGIN_CODING_AGENT_HOOK_EVENT_NAMES = [
+    "SessionStart",
+    "SessionEnd",
+    "UserPromptSubmit",
+    "PreToolUse",
+    "PermissionRequest",
+    "PostToolUse",
+    "PostToolUseFailure",
+    "PreCompact",
+    "PostCompact",
+    "SubagentStart",
+    "SubagentStop",
+    "Stop",
+];
 //# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginConversationApi } from \"./conversation.js\";\nimport type { Disposable } from \"./disposable.js\";\nimport type { PluginFsApi } from \"./fs.js\";\nimport type { ConversationScenario } from \"./scenario.js\";\n\nexport type PluginJsonSchema = object;\n\nexport interface PluginAgentToolApi {\n\tfs: PluginFsApi;\n\tconversation: PluginConversationApi;\n}\n\nexport interface PluginAgentToolRegistration<TInput = unknown> {\n\tid: string;\n\tname?: string;\n\t/**\n\t * Host UI display name for this tool (e.g. Work-mode tool headers).\n\t * Supports `%catalogKey%` resolved against the plugin's locales; bare strings\n\t * are used as literals. Not sent to the model — use {@link description} for that.\n\t */\n\tlabel?: string;\n\tdescription: string;\n\tparameters: PluginJsonSchema;\n\ttimeoutMs?: number;\n\t/**\n\t * 允许该工具出现的对话场景 slug 列表。**fail-closed**：未声明/空数组 = 所有场景都不激活。\n\t * 插件须显式声明。\n\t */\n\tscope_use?: readonly ConversationScenario[];\n\t/** 需要的会话能力 slug（如 \"knowledge\"）；全满足才激活。一般插件无需设置。 */\n\trequires?: string[];\n\t/** 允许该工具出现的工作模式 slug（agent_mode 轴，如 \"work\"/\"coding\"）。缺省/空 = 通用。见 ADR-0046。 */\n\tagent_mode?: readonly string[];\n\tcontext?: { conversation?: \"summary\" | \"messages\" };\n\thandler: PluginAgentToolHandler<TInput>;\n}\n\nexport interface PluginSystemPromptBlock {\n\tid: string;\n\tcontent: string;\n\tpriority?: number;\n\tenabled?: boolean;\n}\n\nexport type PluginDynamicSystemPromptOperation =\n\t| { type: \"addBlock\"; block: PluginSystemPromptBlock }\n\t| { type: \"replaceBlock\"; blockId: string; block: Omit<PluginSystemPromptBlock, \"id\"> }\n\t| {\n\t\t\ttype: \"updateBlock\";\n\t\t\tblockId: string;\n\t\t\tpatch: Partial<Pick<PluginSystemPromptBlock, \"content\" | \"priority\" | \"enabled\">>;\n\t  }\n\t| { type: \"removeBlock\"; blockId: string }\n\t| { type: \"setBlockEnabled\"; blockId: string; enabled: boolean }\n\t| { type: \"setToolEnabled\"; toolName: string; enabled: boolean }\n\t| { type: \"requestContinuation\"; result: PluginContinuationResult };\n\nexport interface PluginSystemPromptMessage {\n\trole: string;\n\ttext: string;\n\ttimestamp?: number;\n\ttoolName?: string;\n}\n\nexport interface PluginSystemPromptProviderContext {\n\tplugin: {\n\t\tid: string;\n\t\tproviderId: string;\n\t\tsettings: Readonly<Record<string, unknown>>;\n\t};\n\tsession: {\n\t\tid: string;\n\t\tcwd: string;\n\t\tscenario: ConversationScenario;\n\t};\n\tmodel: {\n\t\tprovider: string;\n\t\tid: string;\n\t\tapi: string;\n\t\tinput: readonly string[];\n\t\tcontextWindow?: number;\n\t\tmaxTokens?: number;\n\t};\n\tconversation: {\n\t\tmessages: readonly PluginSystemPromptMessage[];\n\t\tmessageCount: number;\n\t};\n\truntime: {\n\t\tactiveToolNames: readonly string[];\n\t\tavailableToolNames: readonly string[];\n\t\trunIndex: number;\n\t};\n\ttrigger: {\n\t\tkind: \"agent-run\";\n\t\ttimestamp: number;\n\t};\n\tsystemPrompt?: {\n\t\tbase: {\n\t\t\tblocks?: readonly PluginSystemPromptBlockView[];\n\t\t\trendered?: string;\n\t\t};\n\t\tcurrent: {\n\t\t\tblocks?: readonly PluginSystemPromptBlockView[];\n\t\t\trendered?: string;\n\t\t};\n\t};\n}\n\nexport interface PluginSystemPromptBlockView extends PluginSystemPromptBlock {\n\ttype: string;\n\tsource: {\n\t\tkind: \"core\" | \"plugin\";\n\t\tpluginId?: string;\n\t};\n\tpriority: number;\n\tenabled: boolean;\n}\n\nexport interface PluginAgentActions {\n\tsystemPrompt: {\n\t\taddBlock(block: PluginSystemPromptBlock): void;\n\t\treplaceBlock(blockId: string, block: Omit<PluginSystemPromptBlock, \"id\">): void;\n\t\tupdateBlock(\n\t\t\tblockId: string,\n\t\t\tpatch: Partial<Pick<PluginSystemPromptBlock, \"content\" | \"priority\" | \"enabled\">>,\n\t\t): void;\n\t\tremoveBlock(blockId: string): void;\n\t\tsetBlockEnabled(blockId: string, enabled: boolean): void;\n\t};\n\ttools: {\n\t\tsetEnabled(toolName: string, enabled: boolean): void;\n\t\tenable(toolName: string): void;\n\t\tdisable(toolName: string): void;\n\t};\n\tcontinuation: {\n\t\trequest(result: PluginContinuationResult): void;\n\t};\n}\n\nexport interface PluginAgentHandlerContext<TTrigger> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tcontributionId: string;\n\t\tsettings: Readonly<Record<string, unknown>>;\n\t};\n\tsession: PluginSystemPromptProviderContext[\"session\"];\n\tmodel: PluginSystemPromptProviderContext[\"model\"];\n\tconversation: PluginSystemPromptProviderContext[\"conversation\"];\n\truntime: PluginSystemPromptProviderContext[\"runtime\"];\n\ttrigger: TTrigger;\n\tsystemPrompt?: PluginSystemPromptProviderContext[\"systemPrompt\"];\n\tactions: PluginAgentActions;\n\thost: PluginAgentToolApi;\n}\n\nexport type PluginAgentToolHandler<TInput = unknown> = (\n\tcontext: PluginAgentHandlerContext<{\n\t\tkind: \"tool-call\";\n\t\ttimestamp: number;\n\t\ttoolCallId: string;\n\t\ttoolId: string;\n\t\ttoolName: string;\n\t\tinput: TInput;\n\t}>,\n) => unknown | Promise<unknown>;\n\nexport type PluginSystemPromptProviderHandler = (\n\tcontext: PluginAgentHandlerContext<{ kind: \"agent-run\"; timestamp: number }>,\n) => void | PluginDynamicSystemPromptOperation[] | Promise<void | PluginDynamicSystemPromptOperation[]>;\n\nexport interface PluginSystemPromptProviderRegistration {\n\tid: string;\n\ttimeoutMs?: number;\n\t/**\n\t * Large context is opt-in. Omitted fields are not serialized across the\n\t * host/renderer boundary.\n\t */\n\tcontext?: {\n\t\tsystemPrompt?: \"none\" | \"blocks\" | \"rendered\" | \"full\";\n\t\tconversation?: \"summary\" | \"messages\";\n\t};\n\thandler: PluginSystemPromptProviderHandler;\n}\n\nexport interface PluginContinuationResult {\n\ttext: string;\n\t/** Stable key used by the host to suppress duplicate continuations in a session. */\n\tidempotencyKey?: string;\n}\n\nexport type PluginContinuationHandler = (\n\tcontext: PluginAgentHandlerContext<{ kind: \"continuation\"; timestamp: number }>,\n) => PluginContinuationResult | null | Promise<PluginContinuationResult | null>;\n\nexport interface PluginContinuationRegistration {\n\tid: string;\n\ttimeoutMs?: number;\n\tcontext?: { conversation?: \"summary\" | \"messages\" };\n\thandler: PluginContinuationHandler;\n}\n\nexport interface PluginAgentApi {\n\tregisterTool<TInput = unknown>(registration: PluginAgentToolRegistration<TInput>): Disposable;\n\t/** Register a provider evaluated before every Agent run. */\n\tregisterSystemPromptProvider(registration: PluginSystemPromptProviderRegistration): Disposable;\n\t/**\n\t * Register a policy consulted when the agent reaches a natural stopping point.\n\t * Return null to allow the agent to stop, or a message to continue with another turn.\n\t */\n\tregisterContinuationProvider(registration: PluginContinuationRegistration): Disposable;\n}\n"]}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AA8MA,MAAM,CAAC,MAAM,oCAAoC,GAAG;IACnD,cAAc;IACd,YAAY;IACZ,kBAAkB;IAClB,YAAY;IACZ,mBAAmB;IACnB,aAAa;IACb,oBAAoB;IACpB,YAAY;IACZ,aAAa;IACb,eAAe;IACf,cAAc;IACd,MAAM;CACG,CAAC","sourcesContent":["import type { PluginConversationApi } from \"./conversation.js\";\nimport type { Disposable } from \"./disposable.js\";\nimport type { PluginFsApi } from \"./fs.js\";\nimport type { ConversationScenario } from \"./scenario.js\";\n\nexport type PluginJsonSchema = object;\n\nexport interface PluginAgentToolApi {\n\tfs: PluginFsApi;\n\tconversation: PluginConversationApi;\n}\n\nexport interface PluginAgentToolRegistration<TInput = unknown> {\n\tid: string;\n\tname?: string;\n\t/**\n\t * Host UI display name for this tool (e.g. Work-mode tool headers).\n\t * Supports `%catalogKey%` resolved against the plugin's locales; bare strings\n\t * are used as literals. Not sent to the model — use {@link description} for that.\n\t */\n\tlabel?: string;\n\tdescription: string;\n\tparameters: PluginJsonSchema;\n\ttimeoutMs?: number;\n\t/**\n\t * 允许该工具出现的对话场景 slug 列表。**fail-closed**：未声明/空数组 = 所有场景都不激活。\n\t * 插件须显式声明。\n\t */\n\tscope_use?: readonly ConversationScenario[];\n\t/** 需要的会话能力 slug（如 \"knowledge\"）；全满足才激活。一般插件无需设置。 */\n\trequires?: string[];\n\t/**\n\t * @deprecated 工作模式不再影响工具的可用性与顺序（ADR-0071）。字段容忍传入但被宿主忽略；\n\t * 需要限定使用场景请写进 description 的反向触发段（Do NOT / Only for）。\n\t */\n\tagent_mode?: readonly string[];\n\tcontext?: { conversation?: \"summary\" | \"messages\" };\n\thandler: PluginAgentToolHandler<TInput>;\n}\n\nexport interface PluginSystemPromptBlock {\n\tid: string;\n\tcontent: string;\n\tpriority?: number;\n\tenabled?: boolean;\n}\n\nexport type PluginDynamicSystemPromptOperation =\n\t| { type: \"addBlock\"; block: PluginSystemPromptBlock }\n\t| { type: \"replaceBlock\"; blockId: string; block: Omit<PluginSystemPromptBlock, \"id\"> }\n\t| {\n\t\t\ttype: \"updateBlock\";\n\t\t\tblockId: string;\n\t\t\tpatch: Partial<Pick<PluginSystemPromptBlock, \"content\" | \"priority\" | \"enabled\">>;\n\t  }\n\t| { type: \"removeBlock\"; blockId: string }\n\t| { type: \"setBlockEnabled\"; blockId: string; enabled: boolean }\n\t| { type: \"setToolEnabled\"; toolName: string; enabled: boolean }\n\t| { type: \"requestContinuation\"; result: PluginContinuationResult };\n\nexport interface PluginSystemPromptMessage {\n\trole: string;\n\ttext: string;\n\ttimestamp?: number;\n\ttoolName?: string;\n}\n\nexport interface PluginSystemPromptProviderContext {\n\tplugin: {\n\t\tid: string;\n\t\tproviderId: string;\n\t};\n\tsession: {\n\t\tid: string;\n\t\tcwd: string;\n\t\tscenario: ConversationScenario;\n\t};\n\tmodel: {\n\t\tprovider: string;\n\t\tid: string;\n\t\tapi: string;\n\t\tinput: readonly string[];\n\t\tcontextWindow?: number;\n\t\tmaxTokens?: number;\n\t};\n\tconversation: {\n\t\tmessages: readonly PluginSystemPromptMessage[];\n\t\tmessageCount: number;\n\t};\n\truntime: {\n\t\tactiveToolNames: readonly string[];\n\t\tavailableToolNames: readonly string[];\n\t\trunIndex: number;\n\t};\n\ttrigger: {\n\t\tkind: \"agent-run\";\n\t\ttimestamp: number;\n\t};\n\tsystemPrompt?: {\n\t\tbase: {\n\t\t\tblocks?: readonly PluginSystemPromptBlockView[];\n\t\t\trendered?: string;\n\t\t};\n\t\tcurrent: {\n\t\t\tblocks?: readonly PluginSystemPromptBlockView[];\n\t\t\trendered?: string;\n\t\t};\n\t};\n}\n\nexport interface PluginSystemPromptBlockView extends PluginSystemPromptBlock {\n\ttype: string;\n\tsource: {\n\t\tkind: \"core\" | \"plugin\";\n\t\tpluginId?: string;\n\t};\n\tpriority: number;\n\tenabled: boolean;\n}\n\nexport interface PluginAgentActions {\n\tsystemPrompt: {\n\t\taddBlock(block: PluginSystemPromptBlock): void;\n\t\treplaceBlock(blockId: string, block: Omit<PluginSystemPromptBlock, \"id\">): void;\n\t\tupdateBlock(\n\t\t\tblockId: string,\n\t\t\tpatch: Partial<Pick<PluginSystemPromptBlock, \"content\" | \"priority\" | \"enabled\">>,\n\t\t): void;\n\t\tremoveBlock(blockId: string): void;\n\t\tsetBlockEnabled(blockId: string, enabled: boolean): void;\n\t};\n\ttools: {\n\t\t/** Emit a Turn-local tool effect. It applies after this handler succeeds. */\n\t\tsetEnabled(toolName: string, enabled: boolean): void;\n\t\t/** Enable an already registered tool for subsequent model calls in this Turn. */\n\t\tenable(toolName: string): void;\n\t\t/** Disable an already registered tool for subsequent model calls in this Turn. */\n\t\tdisable(toolName: string): void;\n\t};\n\tcontinuation: {\n\t\trequest(result: PluginContinuationResult): void;\n\t};\n}\n\nexport interface PluginAgentHandlerContext<TTrigger> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tcontributionId: string;\n\t};\n\tsession: PluginSystemPromptProviderContext[\"session\"];\n\tmodel: PluginSystemPromptProviderContext[\"model\"];\n\tconversation: PluginSystemPromptProviderContext[\"conversation\"];\n\truntime: PluginSystemPromptProviderContext[\"runtime\"];\n\ttrigger: TTrigger;\n\tsystemPrompt?: PluginSystemPromptProviderContext[\"systemPrompt\"];\n\tactions: PluginAgentActions;\n\thost: PluginAgentToolApi;\n}\n\nexport type PluginAgentToolHandler<TInput = unknown> = (\n\tcontext: PluginAgentHandlerContext<{\n\t\tkind: \"tool-call\";\n\t\ttimestamp: number;\n\t\ttoolCallId: string;\n\t\ttoolId: string;\n\t\ttoolName: string;\n\t\tinput: TInput;\n\t}>,\n) => unknown | Promise<unknown>;\n\nexport type PluginSystemPromptProviderHandler = (\n\tcontext: PluginAgentHandlerContext<{ kind: \"agent-run\"; timestamp: number }>,\n) => void | PluginDynamicSystemPromptOperation[] | Promise<void | PluginDynamicSystemPromptOperation[]>;\n\nexport interface PluginSystemPromptProviderRegistration {\n\tid: string;\n\ttimeoutMs?: number;\n\t/**\n\t * Large context is opt-in. Omitted fields are not serialized across the\n\t * host/renderer boundary.\n\t */\n\tcontext?: {\n\t\tsystemPrompt?: \"none\" | \"blocks\" | \"rendered\" | \"full\";\n\t\tconversation?: \"summary\" | \"messages\";\n\t};\n\thandler: PluginSystemPromptProviderHandler;\n}\n\nexport interface PluginContinuationResult {\n\ttext: string;\n\t/** Stable key used by the host to suppress duplicate continuations in a session. */\n\tidempotencyKey?: string;\n}\n\nexport type PluginContinuationHandler = (\n\tcontext: PluginAgentHandlerContext<{ kind: \"continuation\"; timestamp: number }>,\n) => PluginContinuationResult | null | Promise<PluginContinuationResult | null>;\n\nexport interface PluginContinuationRegistration {\n\tid: string;\n\ttimeoutMs?: number;\n\tcontext?: { conversation?: \"summary\" | \"messages\" };\n\thandler: PluginContinuationHandler;\n}\n\nexport const PLUGIN_CODING_AGENT_HOOK_EVENT_NAMES = [\n\t\"SessionStart\",\n\t\"SessionEnd\",\n\t\"UserPromptSubmit\",\n\t\"PreToolUse\",\n\t\"PermissionRequest\",\n\t\"PostToolUse\",\n\t\"PostToolUseFailure\",\n\t\"PreCompact\",\n\t\"PostCompact\",\n\t\"SubagentStart\",\n\t\"SubagentStop\",\n\t\"Stop\",\n] as const;\n\nexport type PluginCodingAgentHookEventName = (typeof PLUGIN_CODING_AGENT_HOOK_EVENT_NAMES)[number];\nexport type PluginCodingAgentPermissionMode =\n\t| \"default\"\n\t| \"acceptEdits\"\n\t| \"plan\"\n\t| \"dontAsk\"\n\t| \"bypassPermissions\";\n\nexport interface PluginCodingAgentHookTool {\n\thostName: string;\n\tkind: \"function\" | \"shell\" | \"mcp\" | \"file-edit\" | \"agent\" | \"custom\";\n\tsource?: { ecosystem?: string; serverName?: string; originalName?: string };\n}\n\ninterface PluginCodingAgentHookEventBase {\n\tsessionId: string;\n\tcwd: string;\n\tmodel: string;\n\tpermissionMode: PluginCodingAgentPermissionMode;\n\tsubagent?: { agentId: string; agentType: string };\n}\n\nexport type PluginCodingAgentHookEvent =\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"SessionStart\";\n\t\t\tsource: \"startup\" | \"resume\" | \"clear\" | \"compact\";\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"SessionEnd\";\n\t\t\tcause: \"new_session\" | \"switch_session\" | \"fork_session\" | \"dispose\";\n\t\t})\n\t| (PluginCodingAgentHookEventBase & { eventName: \"UserPromptSubmit\"; turnId: string; prompt: string })\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PreToolUse\";\n\t\t\tturnId: string;\n\t\t\ttool: PluginCodingAgentHookTool;\n\t\t\ttoolUseId: string;\n\t\t\ttoolInput: unknown;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PermissionRequest\";\n\t\t\tturnId: string;\n\t\t\ttool: PluginCodingAgentHookTool;\n\t\t\ttoolInput: unknown;\n\t\t\trunIdSuffix: string;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PostToolUse\";\n\t\t\tturnId: string;\n\t\t\ttool: PluginCodingAgentHookTool;\n\t\t\ttoolUseId: string;\n\t\t\ttoolInput: unknown;\n\t\t\ttoolResponse: unknown;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PostToolUseFailure\";\n\t\t\tturnId: string;\n\t\t\ttool: PluginCodingAgentHookTool;\n\t\t\ttoolUseId: string;\n\t\t\ttoolInput: unknown;\n\t\t\terror: string;\n\t\t\tisInterrupt?: boolean;\n\t\t\tdurationMs?: number;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"PreCompact\" | \"PostCompact\";\n\t\t\tturnId: string;\n\t\t\ttrigger: \"manual\" | \"auto\";\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"SubagentStart\";\n\t\t\tturnId: string;\n\t\t\tagentId: string;\n\t\t\tagentType: string;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"SubagentStop\";\n\t\t\tturnId: string;\n\t\t\tagentId: string;\n\t\t\tagentType: string;\n\t\t\tstopHookActive: boolean;\n\t\t\tlastAssistantMessage: string | null;\n\t\t})\n\t| (PluginCodingAgentHookEventBase & {\n\t\t\teventName: \"Stop\";\n\t\t\tturnId: string;\n\t\t\tstopHookActive: boolean;\n\t\t\tlastAssistantMessage: string | null;\n\t\t});\n\nexport type PluginCodingAgentHookEventOf<E extends PluginCodingAgentHookEventName> = Extract<\n\tPluginCodingAgentHookEvent,\n\t{ eventName: E }\n>;\n\ninterface PluginCodingAgentHookContinueResult {\n\taction: \"continue\";\n\tadditionalContexts?: readonly string[];\n\tfeedbackMessage?: string;\n}\n\ntype PluginCodingAgentHookTerminalResult =\n\t| { action: \"block\"; reason: string }\n\t| { action: \"stop\"; reason?: string };\n\nexport type PluginCodingAgentHookResult<E extends PluginCodingAgentHookEventName> =\n\t| PluginCodingAgentHookTerminalResult\n\t| (PluginCodingAgentHookContinueResult &\n\t\t\t(E extends \"PreToolUse\" ? { updatedToolInput?: Record<string, unknown> } : object) &\n\t\t\t(E extends \"PermissionRequest\"\n\t\t\t\t? { permissionDecision?: \"allow\" | \"deny\"; permissionMessage?: string }\n\t\t\t\t: object))\n\t| (E extends \"Stop\" | \"SubagentStop\"\n\t\t\t? { action: \"continue-agent\"; continuationFragments: readonly string[] }\n\t\t\t: never);\n\nexport interface PluginCodingAgentHookHandlerContext<E extends PluginCodingAgentHookEventName> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tcontributionId: string;\n\t};\n\tsession: { id: string; cwd: string; scenario: ConversationScenario };\n\tevent: PluginCodingAgentHookEventOf<E>;\n\thost: PluginAgentToolApi;\n}\n\nexport type PluginCodingAgentHookHandler<E extends PluginCodingAgentHookEventName> = (\n\tcontext: PluginCodingAgentHookHandlerContext<E>,\n) => void | PluginCodingAgentHookResult<E> | Promise<void | PluginCodingAgentHookResult<E>>;\n\nexport interface PluginCodingAgentHookRegistration<\n\tE extends PluginCodingAgentHookEventName = PluginCodingAgentHookEventName,\n> {\n\tid: string;\n\teventName: E;\n\t/** Hook 是可执行贡献，必须显式声明允许出现的会话场景。 */\n\tscope_use: readonly ConversationScenario[];\n\t/** @deprecated 工作模式不参与 hook 触发（ADR-0071）。字段容忍传入但被宿主忽略。 */\n\tagent_mode?: readonly string[];\n\t/** 工具事件只匹配列出的宿主工具名；缺省/空数组表示所有工具。 */\n\ttoolNames?: readonly string[];\n\ttimeoutMs?: number;\n\thandler: PluginCodingAgentHookHandler<E>;\n}\n\nexport interface PluginAgentApi {\n\tregisterTool<TInput = unknown>(registration: PluginAgentToolRegistration<TInput>): Disposable;\n\t/**\n\t * Register a provider evaluated once at the beginning of each Agent Turn.\n\t * Its effects are replayed across later model calls in that Turn; changing plugin\n\t * state does not re-run the provider before the next Turn.\n\t */\n\tregisterSystemPromptProvider(registration: PluginSystemPromptProviderRegistration): Disposable;\n\t/**\n\t * Register a policy consulted when the agent reaches a natural stopping point.\n\t * Return null to allow the agent to stop, or a message to continue with another turn.\n\t */\n\tregisterContinuationProvider(registration: PluginContinuationRegistration): Disposable;\n\t/** Register a typed, dynamically removable Coding Agent lifecycle hook. */\n\tregisterHook<E extends PluginCodingAgentHookEventName>(\n\t\tregistration: PluginCodingAgentHookRegistration<E>,\n\t): Disposable;\n}\n"]}

package/dist/ai.d.ts

@@ -0,0 +1,106 @@
+export interface PluginAiModel {
+    modelKey: string;
+    provider: string;
+    id: string;
+    name: string;
+    api: string;
+    reasoning: boolean;
+    input: Array<"text" | "image">;
+    contextWindow: number;
+    maxTokens?: number;
+}
+export interface PluginAiModelListResult {
+    defaultModel: string | null;
+    models: PluginAiModel[];
+}
+export interface PluginAiCompleteRequest {
+    modelKey?: string;
+    systemPrompt?: string;
+    prompt: string;
+    temperature?: number;
+    maxTokens?: number;
+    reasoning?: string;
+}
+export interface PluginAiUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+export interface PluginAiToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface PluginAiChatUserMessage {
+    role: "user";
+    content: string;
+}
+export interface PluginAiChatAssistantMessage {
+    role: "assistant";
+    content: string;
+    toolCalls?: PluginAiToolCall[];
+}
+export interface PluginAiChatToolResultMessage {
+    role: "toolResult";
+    toolCallId: string;
+    toolName: string;
+    content: string;
+    isError?: boolean;
+}
+export type PluginAiChatMessage = PluginAiChatUserMessage | PluginAiChatAssistantMessage | PluginAiChatToolResultMessage;
+/** Tool visible only to this chat request. The plugin executes matching tool calls itself. */
+export interface PluginAiChatTool {
+    name: string;
+    description: string;
+    /** JSON Schema object describing the tool arguments. */
+    parameters: Record<string, unknown>;
+}
+export interface PluginAiChatRequest {
+    modelKey?: string;
+    systemPrompt?: string;
+    /** Full conversation transcript, oldest first. The host keeps no chat state between calls. */
+    messages: PluginAiChatMessage[];
+    tools?: PluginAiChatTool[];
+    temperature?: number;
+    maxTokens?: number;
+    reasoning?: string;
+}
+export interface PluginAiChatResult {
+    modelKey: string;
+    text: string;
+    /** Pending tool calls the plugin must execute and answer via `toolResult` messages. */
+    toolCalls: PluginAiToolCall[];
+    stopReason: "stop" | "length" | "toolUse";
+    usage: PluginAiUsage;
+}
+export interface PluginAiCompleteResult {
+    modelKey: string;
+    text: string;
+    stopReason: "stop" | "length";
+    usage: PluginAiUsage;
+}
+export interface PluginAiTextDeltaEvent {
+    /** Newly generated text in this event. */
+    delta: string;
+    /** Complete text generated by this request so far. */
+    text: string;
+}
+export interface PluginAiStreamOptions {
+    /** Cancels the provider request and rejects the returned promise when aborted. */
+    signal?: AbortSignal;
+    onTextDelta?(event: PluginAiTextDeltaEvent): void;
+}
+/** Host-managed text inference. Provider credentials never enter the plugin runtime. */
+export interface PluginAiApi {
+    listModels(): Promise<PluginAiModelListResult>;
+    complete(request: PluginAiCompleteRequest): Promise<PluginAiCompleteResult>;
+    /** Streams one assistant response while resolving to the same final contract as complete(). */
+    stream(request: PluginAiCompleteRequest, options?: PluginAiStreamOptions): Promise<PluginAiCompleteResult>;
+    /**
+     * Stateless multi-turn completion. The plugin owns and persists the transcript;
+     * each call sends the full message history (optionally with plugin-internal tools)
+     * and receives the next assistant turn. Requires the `ai.complete` permission.
+     */
+    chat(request: PluginAiChatRequest): Promise<PluginAiChatResult>;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"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","sourcesContent":["export interface PluginAiModel {\n\tmodelKey: string;\n\tprovider: string;\n\tid: string;\n\tname: string;\n\tapi: string;\n\treasoning: boolean;\n\tinput: Array<\"text\" | \"image\">;\n\tcontextWindow: number;\n\tmaxTokens?: number;\n}\n\nexport interface PluginAiModelListResult {\n\tdefaultModel: string | null;\n\tmodels: PluginAiModel[];\n}\n\nexport interface PluginAiCompleteRequest {\n\tmodelKey?: string;\n\tsystemPrompt?: string;\n\tprompt: string;\n\ttemperature?: number;\n\tmaxTokens?: number;\n\treasoning?: string;\n}\n\nexport interface PluginAiUsage {\n\tinputTokens: number;\n\toutputTokens: number;\n\ttotalTokens: number;\n}\n\nexport interface PluginAiToolCall {\n\tid: string;\n\tname: string;\n\targuments: Record<string, unknown>;\n}\n\nexport interface PluginAiChatUserMessage {\n\trole: \"user\";\n\tcontent: string;\n}\n\nexport interface PluginAiChatAssistantMessage {\n\trole: \"assistant\";\n\tcontent: string;\n\ttoolCalls?: PluginAiToolCall[];\n}\n\nexport interface PluginAiChatToolResultMessage {\n\trole: \"toolResult\";\n\ttoolCallId: string;\n\ttoolName: string;\n\tcontent: string;\n\tisError?: boolean;\n}\n\nexport type PluginAiChatMessage =\n\t| PluginAiChatUserMessage\n\t| PluginAiChatAssistantMessage\n\t| PluginAiChatToolResultMessage;\n\n/** Tool visible only to this chat request. The plugin executes matching tool calls itself. */\nexport interface PluginAiChatTool {\n\tname: string;\n\tdescription: string;\n\t/** JSON Schema object describing the tool arguments. */\n\tparameters: Record<string, unknown>;\n}\n\nexport interface PluginAiChatRequest {\n\tmodelKey?: string;\n\tsystemPrompt?: string;\n\t/** Full conversation transcript, oldest first. The host keeps no chat state between calls. */\n\tmessages: PluginAiChatMessage[];\n\ttools?: PluginAiChatTool[];\n\ttemperature?: number;\n\tmaxTokens?: number;\n\treasoning?: string;\n}\n\nexport interface PluginAiChatResult {\n\tmodelKey: string;\n\ttext: string;\n\t/** Pending tool calls the plugin must execute and answer via `toolResult` messages. */\n\ttoolCalls: PluginAiToolCall[];\n\tstopReason: \"stop\" | \"length\" | \"toolUse\";\n\tusage: PluginAiUsage;\n}\n\nexport interface PluginAiCompleteResult {\n\tmodelKey: string;\n\ttext: string;\n\tstopReason: \"stop\" | \"length\";\n\tusage: PluginAiUsage;\n}\n\nexport interface PluginAiTextDeltaEvent {\n\t/** Newly generated text in this event. */\n\tdelta: string;\n\t/** Complete text generated by this request so far. */\n\ttext: string;\n}\n\nexport interface PluginAiStreamOptions {\n\t/** Cancels the provider request and rejects the returned promise when aborted. */\n\tsignal?: AbortSignal;\n\tonTextDelta?(event: PluginAiTextDeltaEvent): void;\n}\n\n/** Host-managed text inference. Provider credentials never enter the plugin runtime. */\nexport interface PluginAiApi {\n\tlistModels(): Promise<PluginAiModelListResult>;\n\tcomplete(request: PluginAiCompleteRequest): Promise<PluginAiCompleteResult>;\n\t/** Streams one assistant response while resolving to the same final contract as complete(). */\n\tstream(request: PluginAiCompleteRequest, options?: PluginAiStreamOptions): Promise<PluginAiCompleteResult>;\n\t/**\n\t * Stateless multi-turn completion. The plugin owns and persists the transcript;\n\t * each call sends the full message history (optionally with plugin-internal tools)\n\t * and receives the next assistant turn. Requires the `ai.complete` permission.\n\t */\n\tchat(request: PluginAiChatRequest): Promise<PluginAiChatResult>;\n}\n"]}

package/dist/ai.js

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

package/dist/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"","sourcesContent":["export interface PluginAiModel {\n\tmodelKey: string;\n\tprovider: string;\n\tid: string;\n\tname: string;\n\tapi: string;\n\treasoning: boolean;\n\tinput: Array<\"text\" | \"image\">;\n\tcontextWindow: number;\n\tmaxTokens?: number;\n}\n\nexport interface PluginAiModelListResult {\n\tdefaultModel: string | null;\n\tmodels: PluginAiModel[];\n}\n\nexport interface PluginAiCompleteRequest {\n\tmodelKey?: string;\n\tsystemPrompt?: string;\n\tprompt: string;\n\ttemperature?: number;\n\tmaxTokens?: number;\n\treasoning?: string;\n}\n\nexport interface PluginAiUsage {\n\tinputTokens: number;\n\toutputTokens: number;\n\ttotalTokens: number;\n}\n\nexport interface PluginAiToolCall {\n\tid: string;\n\tname: string;\n\targuments: Record<string, unknown>;\n}\n\nexport interface PluginAiChatUserMessage {\n\trole: \"user\";\n\tcontent: string;\n}\n\nexport interface PluginAiChatAssistantMessage {\n\trole: \"assistant\";\n\tcontent: string;\n\ttoolCalls?: PluginAiToolCall[];\n}\n\nexport interface PluginAiChatToolResultMessage {\n\trole: \"toolResult\";\n\ttoolCallId: string;\n\ttoolName: string;\n\tcontent: string;\n\tisError?: boolean;\n}\n\nexport type PluginAiChatMessage =\n\t| PluginAiChatUserMessage\n\t| PluginAiChatAssistantMessage\n\t| PluginAiChatToolResultMessage;\n\n/** Tool visible only to this chat request. The plugin executes matching tool calls itself. */\nexport interface PluginAiChatTool {\n\tname: string;\n\tdescription: string;\n\t/** JSON Schema object describing the tool arguments. */\n\tparameters: Record<string, unknown>;\n}\n\nexport interface PluginAiChatRequest {\n\tmodelKey?: string;\n\tsystemPrompt?: string;\n\t/** Full conversation transcript, oldest first. The host keeps no chat state between calls. */\n\tmessages: PluginAiChatMessage[];\n\ttools?: PluginAiChatTool[];\n\ttemperature?: number;\n\tmaxTokens?: number;\n\treasoning?: string;\n}\n\nexport interface PluginAiChatResult {\n\tmodelKey: string;\n\ttext: string;\n\t/** Pending tool calls the plugin must execute and answer via `toolResult` messages. */\n\ttoolCalls: PluginAiToolCall[];\n\tstopReason: \"stop\" | \"length\" | \"toolUse\";\n\tusage: PluginAiUsage;\n}\n\nexport interface PluginAiCompleteResult {\n\tmodelKey: string;\n\ttext: string;\n\tstopReason: \"stop\" | \"length\";\n\tusage: PluginAiUsage;\n}\n\nexport interface PluginAiTextDeltaEvent {\n\t/** Newly generated text in this event. */\n\tdelta: string;\n\t/** Complete text generated by this request so far. */\n\ttext: string;\n}\n\nexport interface PluginAiStreamOptions {\n\t/** Cancels the provider request and rejects the returned promise when aborted. */\n\tsignal?: AbortSignal;\n\tonTextDelta?(event: PluginAiTextDeltaEvent): void;\n}\n\n/** Host-managed text inference. Provider credentials never enter the plugin runtime. */\nexport interface PluginAiApi {\n\tlistModels(): Promise<PluginAiModelListResult>;\n\tcomplete(request: PluginAiCompleteRequest): Promise<PluginAiCompleteResult>;\n\t/** Streams one assistant response while resolving to the same final contract as complete(). */\n\tstream(request: PluginAiCompleteRequest, options?: PluginAiStreamOptions): Promise<PluginAiCompleteResult>;\n\t/**\n\t * Stateless multi-turn completion. The plugin owns and persists the transcript;\n\t * each call sends the full message history (optionally with plugin-internal tools)\n\t * and receives the next assistant turn. Requires the `ai.complete` permission.\n\t */\n\tchat(request: PluginAiChatRequest): Promise<PluginAiChatResult>;\n}\n"]}

package/dist/app-actions.d.ts

@@ -1,6 +1,13 @@
 import type { PluginJsonSchema } from "./agent.js";
 import type { Disposable } from "./disposable.js";
 export type PluginAppActionEffect = "read" | "write" | "execute";
+/** Model-facing routing guidance, not authorization or an execution policy. */
+export interface PluginAppActionUsage {
+    target: string;
+    useWhen: string;
+    avoidWhen: string;
+    alternatives: string;
+}
 export interface PluginAppActionExample<TInput = unknown> {
     description: string;
     input: TInput;
@@ -10,7 +17,6 @@ export interface PluginAppActionHandlerContext<TInput = unknown> {
     plugin: {
         id: string;
         actionId: string;
-        settings: Readonly<Record<string, unknown>>;
     };
     input: TInput;
     signal: AbortSignal;
@@ -46,6 +52,8 @@ export interface PluginAppActionRegistration<TInput = unknown> {
     title: string;
     summary: string;
     description?: string;
+    /** Returned by search and describe; exclusions are never positive search terms. */
+    usage?: PluginAppActionUsage;
     keywords?: string[];
     effect: PluginAppActionEffect;
     /** 官方插件可引用宿主已有审批界面；不能关闭 effect 对应的审批。 */

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

@@ -1 +1 @@
-{"version":3,"file":"app-actions.d.ts","sourceRoot":"","sources":["../src/app-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,sBAAsB,CAAC,MAAM,GAAG,OAAO;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,6BAA6B,CAAC,MAAM,GAAG,OAAO;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KAC5C,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,CAAC,MAAM,GAAG,OAAO,IAAI,CACtD,OAAO,EAAE,6BAA6B,CAAC,MAAM,CAAC,KAC1C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,MAAM,2BAA2B,CAAC,MAAM,GAAG,OAAO,IAAI,CAC3D,OAAO,EAAE,6BAA6B,CAAC,MAAM,CAAC,KAC1C,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,2EAAmC;AACnC,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAK3D;CACD;AAED,MAAM,WAAW,mCAAmC;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACvC,2CAAmB;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mEAA2B;IAC3B,aAAa,EAAE,mCAAmC,EAAE,CAAC;IACrD,0FAA0D;IAC1D,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,yGAA+C;IAC/C,mCAAmC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,2BAA2B,CAAC,MAAM,GAAG,OAAO;IAC5D,uEAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,iHAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,6FAAyC;IACzC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA8B;IAC9B,WAAW,CAAC,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,GAAG,OAAO,EAAE,YAAY,EAAE,2BAA2B,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC;CAC1F","sourcesContent":["import type { PluginJsonSchema } from \"./agent.js\";\nimport type { Disposable } from \"./disposable.js\";\n\nexport type PluginAppActionEffect = \"read\" | \"write\" | \"execute\";\n\nexport interface PluginAppActionExample<TInput = unknown> {\n\tdescription: string;\n\tinput: TInput;\n}\n\nexport interface PluginAppActionHandlerContext<TInput = unknown> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tactionId: string;\n\t\tsettings: Readonly<Record<string, unknown>>;\n\t};\n\tinput: TInput;\n\tsignal: AbortSignal;\n}\n\nexport type PluginAppActionHandler<TInput = unknown> = (\n\tcontext: PluginAppActionHandlerContext<TInput>,\n) => unknown | Promise<unknown>;\n\nexport type PluginAppActionReadyHandler<TInput = unknown> = (\n\tcontext: PluginAppActionHandlerContext<TInput>,\n) => void | Promise<void>;\n\n/** 插件 Action 向宿主返回稳定错误码与可序列化详情。 */\nexport class PluginAppActionError extends Error {\n\treadonly code: string;\n\treadonly details?: unknown;\n\n\tconstructor(code: string, message: string, details?: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"PluginAppActionError\";\n\t\tthis.code = code;\n\t\tthis.details = details;\n\t}\n}\n\nexport interface PluginAppActionApprovalPresentation {\n\tid: string;\n\ttitle: string;\n\tdescription: string;\n}\n\nexport interface PluginAppActionApproval {\n\t/** 默认使用的宿主审批界面。 */\n\tdefaultPresentation: string;\n\t/** 可用的宿主审批界面；仅官方插件可以声明。 */\n\tpresentations: PluginAppActionApprovalPresentation[];\n\t/** 根据 input.operation 自动选择审批界面，不要求 Agent 传 approvalUi。 */\n\tpresentationByOperation?: Record<string, string>;\n\t/** 某 operation 明确允许的附加审批界面；宿主仍会拒绝未列出的调用方选择。 */\n\talternativePresentationsByOperation?: Record<string, string[]>;\n}\n\nexport interface PluginAppActionRegistration<TInput = unknown> {\n\t/** 插件内局部 id；宿主公开为 `plugin.<pluginId>.<id>`。 */\n\tid: string;\n\t/** 可信官方插件可指定稳定公共 id；若 id 已被占用则后到者忽略（先注册为准）。 */\n\tpublicId?: string;\n\ttitle: string;\n\tsummary: string;\n\tdescription?: string;\n\tkeywords?: string[];\n\teffect: PluginAppActionEffect;\n\t/** 官方插件可引用宿主已有审批界面；不能关闭 effect 对应的审批。 */\n\tapproval?: PluginAppActionApproval;\n\tinputSchema: PluginJsonSchema;\n\texamples?: PluginAppActionExample<TInput>[];\n\ttimeoutMs?: number;\n\t/** 审批前业务就绪校验；失败时不会向用户弹出审批。 */\n\tassertReady?: PluginAppActionReadyHandler<TInput>;\n\thandler: PluginAppActionHandler<TInput>;\n}\n\nexport interface PluginAppActionsApi {\n\tregister<TInput = unknown>(registration: PluginAppActionRegistration<TInput>): Disposable;\n}\n"]}
+{"version":3,"file":"app-actions.d.ts","sourceRoot":"","sources":["../src/app-actions.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PluginJsonSchema } from \"./agent.js\";\nimport type { Disposable } from \"./disposable.js\";\n\nexport type PluginAppActionEffect = \"read\" | \"write\" | \"execute\";\n\n/** Model-facing routing guidance, not authorization or an execution policy. */\nexport interface PluginAppActionUsage {\n\ttarget: string;\n\tuseWhen: string;\n\tavoidWhen: string;\n\talternatives: string;\n}\n\nexport interface PluginAppActionExample<TInput = unknown> {\n\tdescription: string;\n\tinput: TInput;\n}\n\nexport interface PluginAppActionHandlerContext<TInput = unknown> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tactionId: string;\n\t};\n\tinput: TInput;\n\tsignal: AbortSignal;\n}\n\nexport type PluginAppActionHandler<TInput = unknown> = (\n\tcontext: PluginAppActionHandlerContext<TInput>,\n) => unknown | Promise<unknown>;\n\nexport type PluginAppActionReadyHandler<TInput = unknown> = (\n\tcontext: PluginAppActionHandlerContext<TInput>,\n) => void | Promise<void>;\n\n/** 插件 Action 向宿主返回稳定错误码与可序列化详情。 */\nexport class PluginAppActionError extends Error {\n\treadonly code: string;\n\treadonly details?: unknown;\n\n\tconstructor(code: string, message: string, details?: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"PluginAppActionError\";\n\t\tthis.code = code;\n\t\tthis.details = details;\n\t}\n}\n\nexport interface PluginAppActionApprovalPresentation {\n\tid: string;\n\ttitle: string;\n\tdescription: string;\n}\n\nexport interface PluginAppActionApproval {\n\t/** 默认使用的宿主审批界面。 */\n\tdefaultPresentation: string;\n\t/** 可用的宿主审批界面；仅官方插件可以声明。 */\n\tpresentations: PluginAppActionApprovalPresentation[];\n\t/** 根据 input.operation 自动选择审批界面，不要求 Agent 传 approvalUi。 */\n\tpresentationByOperation?: Record<string, string>;\n\t/** 某 operation 明确允许的附加审批界面；宿主仍会拒绝未列出的调用方选择。 */\n\talternativePresentationsByOperation?: Record<string, string[]>;\n}\n\nexport interface PluginAppActionRegistration<TInput = unknown> {\n\t/** 插件内局部 id；宿主公开为 `plugin.<pluginId>.<id>`。 */\n\tid: string;\n\t/** 可信官方插件可指定稳定公共 id；若 id 已被占用则后到者忽略（先注册为准）。 */\n\tpublicId?: string;\n\ttitle: string;\n\tsummary: string;\n\tdescription?: string;\n\t/** Returned by search and describe; exclusions are never positive search terms. */\n\tusage?: PluginAppActionUsage;\n\tkeywords?: string[];\n\teffect: PluginAppActionEffect;\n\t/** 官方插件可引用宿主已有审批界面；不能关闭 effect 对应的审批。 */\n\tapproval?: PluginAppActionApproval;\n\tinputSchema: PluginJsonSchema;\n\texamples?: PluginAppActionExample<TInput>[];\n\ttimeoutMs?: number;\n\t/** 审批前业务就绪校验；失败时不会向用户弹出审批。 */\n\tassertReady?: PluginAppActionReadyHandler<TInput>;\n\thandler: PluginAppActionHandler<TInput>;\n}\n\nexport interface PluginAppActionsApi {\n\tregister<TInput = unknown>(registration: PluginAppActionRegistration<TInput>): Disposable;\n}\n"]}

package/dist/app-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-actions.js","sourceRoot":"","sources":["../src/app-actions.ts"],"names":[],"mappings":"AA6BA,2EAAmC;AACnC,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACrC,IAAI,CAAS;IACb,OAAO,CAAW;IAE3B,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB,EAAE;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAAA,CACvB;CACD","sourcesContent":["import type { PluginJsonSchema } from \"./agent.js\";\nimport type { Disposable } from \"./disposable.js\";\n\nexport type PluginAppActionEffect = \"read\" | \"write\" | \"execute\";\n\nexport interface PluginAppActionExample<TInput = unknown> {\n\tdescription: string;\n\tinput: TInput;\n}\n\nexport interface PluginAppActionHandlerContext<TInput = unknown> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tactionId: string;\n\t\tsettings: Readonly<Record<string, unknown>>;\n\t};\n\tinput: TInput;\n\tsignal: AbortSignal;\n}\n\nexport type PluginAppActionHandler<TInput = unknown> = (\n\tcontext: PluginAppActionHandlerContext<TInput>,\n) => unknown | Promise<unknown>;\n\nexport type PluginAppActionReadyHandler<TInput = unknown> = (\n\tcontext: PluginAppActionHandlerContext<TInput>,\n) => void | Promise<void>;\n\n/** 插件 Action 向宿主返回稳定错误码与可序列化详情。 */\nexport class PluginAppActionError extends Error {\n\treadonly code: string;\n\treadonly details?: unknown;\n\n\tconstructor(code: string, message: string, details?: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"PluginAppActionError\";\n\t\tthis.code = code;\n\t\tthis.details = details;\n\t}\n}\n\nexport interface PluginAppActionApprovalPresentation {\n\tid: string;\n\ttitle: string;\n\tdescription: string;\n}\n\nexport interface PluginAppActionApproval {\n\t/** 默认使用的宿主审批界面。 */\n\tdefaultPresentation: string;\n\t/** 可用的宿主审批界面；仅官方插件可以声明。 */\n\tpresentations: PluginAppActionApprovalPresentation[];\n\t/** 根据 input.operation 自动选择审批界面，不要求 Agent 传 approvalUi。 */\n\tpresentationByOperation?: Record<string, string>;\n\t/** 某 operation 明确允许的附加审批界面；宿主仍会拒绝未列出的调用方选择。 */\n\talternativePresentationsByOperation?: Record<string, string[]>;\n}\n\nexport interface PluginAppActionRegistration<TInput = unknown> {\n\t/** 插件内局部 id；宿主公开为 `plugin.<pluginId>.<id>`。 */\n\tid: string;\n\t/** 可信官方插件可指定稳定公共 id；若 id 已被占用则后到者忽略（先注册为准）。 */\n\tpublicId?: string;\n\ttitle: string;\n\tsummary: string;\n\tdescription?: string;\n\tkeywords?: string[];\n\teffect: PluginAppActionEffect;\n\t/** 官方插件可引用宿主已有审批界面；不能关闭 effect 对应的审批。 */\n\tapproval?: PluginAppActionApproval;\n\tinputSchema: PluginJsonSchema;\n\texamples?: PluginAppActionExample<TInput>[];\n\ttimeoutMs?: number;\n\t/** 审批前业务就绪校验；失败时不会向用户弹出审批。 */\n\tassertReady?: PluginAppActionReadyHandler<TInput>;\n\thandler: PluginAppActionHandler<TInput>;\n}\n\nexport interface PluginAppActionsApi {\n\tregister<TInput = unknown>(registration: PluginAppActionRegistration<TInput>): Disposable;\n}\n"]}
+{"version":3,"file":"app-actions.js","sourceRoot":"","sources":["../src/app-actions.ts"],"names":[],"mappings":"AAoCA,2EAAmC;AACnC,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACrC,IAAI,CAAS;IACb,OAAO,CAAW;IAE3B,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB,EAAE;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAAA,CACvB;CACD","sourcesContent":["import type { PluginJsonSchema } from \"./agent.js\";\nimport type { Disposable } from \"./disposable.js\";\n\nexport type PluginAppActionEffect = \"read\" | \"write\" | \"execute\";\n\n/** Model-facing routing guidance, not authorization or an execution policy. */\nexport interface PluginAppActionUsage {\n\ttarget: string;\n\tuseWhen: string;\n\tavoidWhen: string;\n\talternatives: string;\n}\n\nexport interface PluginAppActionExample<TInput = unknown> {\n\tdescription: string;\n\tinput: TInput;\n}\n\nexport interface PluginAppActionHandlerContext<TInput = unknown> {\n\tinvocationId: string;\n\tplugin: {\n\t\tid: string;\n\t\tactionId: string;\n\t};\n\tinput: TInput;\n\tsignal: AbortSignal;\n}\n\nexport type PluginAppActionHandler<TInput = unknown> = (\n\tcontext: PluginAppActionHandlerContext<TInput>,\n) => unknown | Promise<unknown>;\n\nexport type PluginAppActionReadyHandler<TInput = unknown> = (\n\tcontext: PluginAppActionHandlerContext<TInput>,\n) => void | Promise<void>;\n\n/** 插件 Action 向宿主返回稳定错误码与可序列化详情。 */\nexport class PluginAppActionError extends Error {\n\treadonly code: string;\n\treadonly details?: unknown;\n\n\tconstructor(code: string, message: string, details?: unknown) {\n\t\tsuper(message);\n\t\tthis.name = \"PluginAppActionError\";\n\t\tthis.code = code;\n\t\tthis.details = details;\n\t}\n}\n\nexport interface PluginAppActionApprovalPresentation {\n\tid: string;\n\ttitle: string;\n\tdescription: string;\n}\n\nexport interface PluginAppActionApproval {\n\t/** 默认使用的宿主审批界面。 */\n\tdefaultPresentation: string;\n\t/** 可用的宿主审批界面；仅官方插件可以声明。 */\n\tpresentations: PluginAppActionApprovalPresentation[];\n\t/** 根据 input.operation 自动选择审批界面，不要求 Agent 传 approvalUi。 */\n\tpresentationByOperation?: Record<string, string>;\n\t/** 某 operation 明确允许的附加审批界面；宿主仍会拒绝未列出的调用方选择。 */\n\talternativePresentationsByOperation?: Record<string, string[]>;\n}\n\nexport interface PluginAppActionRegistration<TInput = unknown> {\n\t/** 插件内局部 id；宿主公开为 `plugin.<pluginId>.<id>`。 */\n\tid: string;\n\t/** 可信官方插件可指定稳定公共 id；若 id 已被占用则后到者忽略（先注册为准）。 */\n\tpublicId?: string;\n\ttitle: string;\n\tsummary: string;\n\tdescription?: string;\n\t/** Returned by search and describe; exclusions are never positive search terms. */\n\tusage?: PluginAppActionUsage;\n\tkeywords?: string[];\n\teffect: PluginAppActionEffect;\n\t/** 官方插件可引用宿主已有审批界面；不能关闭 effect 对应的审批。 */\n\tapproval?: PluginAppActionApproval;\n\tinputSchema: PluginJsonSchema;\n\texamples?: PluginAppActionExample<TInput>[];\n\ttimeoutMs?: number;\n\t/** 审批前业务就绪校验；失败时不会向用户弹出审批。 */\n\tassertReady?: PluginAppActionReadyHandler<TInput>;\n\thandler: PluginAppActionHandler<TInput>;\n}\n\nexport interface PluginAppActionsApi {\n\tregister<TInput = unknown>(registration: PluginAppActionRegistration<TInput>): Disposable;\n}\n"]}