pulse-coder-engine 0.0.1-alpha.4 → 0.0.1-alpha.7

package/dist/index.d.cts

@@ -1,100 +1,9 @@
-import { FlexibleSchema, ModelMessage, LanguageModel, StepResult, ToolSet, streamText, Tool as Tool$1 } from 'ai';
-import { E as EnginePluginLoadOptions } from './index-DDqISE31.cjs';
-export { B as BuiltInSkillRegistry, a as EnginePlugin, b as EnginePluginContext, c as builtInMCPPlugin, d as builtInPlugins, e as builtInSkillsPlugin } from './index-DDqISE31.cjs';
+import { C as ClarificationRequest, T as Tool, L as LLMProviderFactory, S as SystemPromptOption, a as ToolHooks, b as Context, c as ToolExecutionContext, E as EnginePluginLoadOptions, I as ILogger, d as EngineRunHook } from './index-Dh5B8P2t.cjs';
+export { B as BuiltInPlanModeService, e as BuiltInSkillRegistry, f as EnginePlugin, g as EnginePluginContext, M as ModePolicy, P as PlanIntentLabel, h as PlanMode, i as PlanModeEvent, j as PlanModeEventName, k as PlanModeService, l as PlanModeTransitionResult, m as ToolCategory, n as ToolMeta, o as ToolRisk, p as builtInMCPPlugin, q as builtInPlanModePlugin, r as builtInPlugins, s as builtInSkillsPlugin } from './index-Dh5B8P2t.cjs';
+import { StepResult, ModelMessage, ToolSet, streamText, Tool as Tool$1 } from 'ai';
 import { z } from 'zod';
 import 'events';
 
-/**
- * Custom LLM provider factory - receives a model name and returns a LanguageModel.
- * Use this to plug in any Vercel AI SDK-compatible provider.
- *
- * @example
- * import { createOpenAI } from '@ai-sdk/openai';
- * const provider: LLMProviderFactory = createOpenAI({ apiKey: '...' }).chat;
- *
- * @example
- * import { createAnthropic } from '@ai-sdk/anthropic';
- * const provider: LLMProviderFactory = createAnthropic({ apiKey: '...' });
- */
-type LLMProviderFactory = (model: string) => LanguageModel;
-/**
- * System prompt customization.
- * - `string` — replaces the built-in prompt entirely.
- * - `() => string` — factory evaluated on every request (supports dynamic prompts).
- * - `{ append: string }` — appends extra content after the built-in prompt.
- */
-type SystemPromptOption = string | (() => string) | {
-    append: string;
-};
-/**
- * Hooks that fire around every tool execution.
- *
- * @example
- * const hooks: ToolHooks = {
- *   onBeforeToolCall: (name, input) => {
- *     if (name === 'bash') throw new Error('bash tool is disabled');
- *     return input; // can return modified input
- *   },
- *   onAfterToolCall: (name, input, output) => {
- *     auditLog(name, input, output);
- *     return output; // can return modified output
- *   },
- * };
- */
-interface ToolHooks {
-    /**
-     * Called before a tool executes.
-     * Return a (possibly modified) input object, or throw to abort the call.
-     */
-    onBeforeToolCall?: (name: string, input: any) => any | Promise<any>;
-    /**
-     * Called after a tool executes.
-     * Return a (possibly modified) output value.
-     */
-    onAfterToolCall?: (name: string, input: any, output: any) => any | Promise<any>;
-}
-interface ClarificationRequest {
-    id: string;
-    question: string;
-    context?: string;
-    defaultAnswer?: string;
-    timeout: number;
-}
-interface ToolExecutionContext {
-    onClarificationRequest?: (request: ClarificationRequest) => Promise<string>;
-    abortSignal?: AbortSignal;
-}
-interface Tool<Input = any, Output = any> {
-    name: string;
-    description: string;
-    inputSchema: FlexibleSchema<Input>;
-    execute: (input: Input, context?: ToolExecutionContext) => Promise<Output>;
-}
-interface Context {
-    messages: ModelMessage[];
-}
-interface IPlugin {
-    name: string;
-    version: string;
-    extensions: Extension[];
-    activate(context: IExtensionContext): Promise<void>;
-    deactivate?(): Promise<void>;
-}
-interface Extension {
-    type: 'skill' | 'mcp' | 'tool' | 'context';
-    provider: any;
-}
-interface IExtensionContext {
-    registerTools(toolName: string, tool: Tool<any, any>): void;
-    logger: ILogger;
-}
-interface ILogger {
-    debug(message: string, meta?: Record<string, unknown>): void;
-    info(message: string, meta?: Record<string, unknown>): void;
-    warn(message: string, meta?: Record<string, unknown>): void;
-    error(message: string, error?: Error, meta?: Record<string, unknown>): void;
-}
-
 interface LoopOptions {
     onText?: (delta: string) => void;
     onToolCall?: (toolCall: any) => void;
@@ -150,10 +59,10 @@ interface UserConfigPlugin {
  */
 declare const ToolConfigSchema: z.ZodObject<{
     type: z.ZodEnum<{
-        skill: "skill";
         bash: "bash";
         http: "http";
         javascript: "javascript";
+        skill: "skill";
         custom: "custom";
     }>;
     command: z.ZodOptional<z.ZodString>;
@@ -504,6 +413,7 @@ declare class Engine {
      * 准备引擎插件列表（包含内置插件）
      */
     private prepareEnginePlugins;
+    private applyRunHooks;
     /**
      * 运行AI循环
      */
@@ -515,6 +425,7 @@ declare class Engine {
         enginePlugins: string[];
         userConfigPlugins: string[];
         tools: string[];
+        runHooks: string[];
         services: string[];
         protocols: string[];
     };
@@ -543,6 +454,7 @@ declare class PluginManager {
     private enginePlugins;
     private userConfigPlugins;
     private tools;
+    private runHooks;
     private services;
     private protocols;
     private config;
@@ -590,6 +502,9 @@ declare class PluginManager {
     private applyUserConfig;
     /**
      * 验证核心能力
+     *
+     * - requiredCapabilities: 任意一个别名匹配即可，缺失时 **抛错** 阻止启动。
+     * - recommendedCapabilities: 缺失时仅 warn，不影响启动。
      */
     private validateCoreCapabilities;
     /**
@@ -600,6 +515,10 @@ declare class PluginManager {
      * 工具获取
      */
     getTools(): Record<string, any>;
+    /**
+     * 运行时钩子获取
+     */
+    getRunHooks(): EngineRunHook[];
     /**
      * 服务获取
      */
@@ -615,6 +534,7 @@ declare class PluginManager {
         enginePlugins: string[];
         userConfigPlugins: string[];
         tools: string[];
+        runHooks: string[];
         services: string[];
         protocols: string[];
     };
@@ -624,4 +544,4 @@ declare class PluginManager {
     private resolvePath;
 }
 
-export { BashTool, BuiltinTools, BuiltinToolsMap, type ClarificationRequest, ClarifyTool, type Context, EditTool, Engine, type Extension, GrepTool, type IExtensionContext, type ILogger, type IPlugin, type LLMProviderFactory, LsTool, PluginManager, Engine as PulseAgent, ReadTool, type SystemPromptOption, TavilyTool, type Tool, type ToolExecutionContext, type ToolHooks, type UserConfigPlugin, type UserConfigPluginLoadOptions, WriteTool, getFinalToolsMap, loop, maybeCompactContext, streamTextAI };
+export { BashTool, BuiltinTools, BuiltinToolsMap, ClarificationRequest, ClarifyTool, Context, EditTool, Engine, GrepTool, ILogger, LLMProviderFactory, LsTool, PluginManager, Engine as PulseAgent, ReadTool, SystemPromptOption, TavilyTool, Tool, ToolExecutionContext, ToolHooks, type UserConfigPlugin, type UserConfigPluginLoadOptions, WriteTool, getFinalToolsMap, loop, maybeCompactContext, streamTextAI };

package/dist/index.d.ts

@@ -1,100 +1,9 @@
-import { FlexibleSchema, ModelMessage, LanguageModel, StepResult, ToolSet, streamText, Tool as Tool$1 } from 'ai';
-import { E as EnginePluginLoadOptions } from './index-DDqISE31.js';
-export { B as BuiltInSkillRegistry, a as EnginePlugin, b as EnginePluginContext, c as builtInMCPPlugin, d as builtInPlugins, e as builtInSkillsPlugin } from './index-DDqISE31.js';
+import { C as ClarificationRequest, T as Tool, L as LLMProviderFactory, S as SystemPromptOption, a as ToolHooks, b as Context, c as ToolExecutionContext, E as EnginePluginLoadOptions, I as ILogger, d as EngineRunHook } from './index-Dh5B8P2t.js';
+export { B as BuiltInPlanModeService, e as BuiltInSkillRegistry, f as EnginePlugin, g as EnginePluginContext, M as ModePolicy, P as PlanIntentLabel, h as PlanMode, i as PlanModeEvent, j as PlanModeEventName, k as PlanModeService, l as PlanModeTransitionResult, m as ToolCategory, n as ToolMeta, o as ToolRisk, p as builtInMCPPlugin, q as builtInPlanModePlugin, r as builtInPlugins, s as builtInSkillsPlugin } from './index-Dh5B8P2t.js';
+import { StepResult, ModelMessage, ToolSet, streamText, Tool as Tool$1 } from 'ai';
 import { z } from 'zod';
 import 'events';
 
-/**
- * Custom LLM provider factory - receives a model name and returns a LanguageModel.
- * Use this to plug in any Vercel AI SDK-compatible provider.
- *
- * @example
- * import { createOpenAI } from '@ai-sdk/openai';
- * const provider: LLMProviderFactory = createOpenAI({ apiKey: '...' }).chat;
- *
- * @example
- * import { createAnthropic } from '@ai-sdk/anthropic';
- * const provider: LLMProviderFactory = createAnthropic({ apiKey: '...' });
- */
-type LLMProviderFactory = (model: string) => LanguageModel;
-/**
- * System prompt customization.
- * - `string` — replaces the built-in prompt entirely.
- * - `() => string` — factory evaluated on every request (supports dynamic prompts).
- * - `{ append: string }` — appends extra content after the built-in prompt.
- */
-type SystemPromptOption = string | (() => string) | {
-    append: string;
-};
-/**
- * Hooks that fire around every tool execution.
- *
- * @example
- * const hooks: ToolHooks = {
- *   onBeforeToolCall: (name, input) => {
- *     if (name === 'bash') throw new Error('bash tool is disabled');
- *     return input; // can return modified input
- *   },
- *   onAfterToolCall: (name, input, output) => {
- *     auditLog(name, input, output);
- *     return output; // can return modified output
- *   },
- * };
- */
-interface ToolHooks {
-    /**
-     * Called before a tool executes.
-     * Return a (possibly modified) input object, or throw to abort the call.
-     */
-    onBeforeToolCall?: (name: string, input: any) => any | Promise<any>;
-    /**
-     * Called after a tool executes.
-     * Return a (possibly modified) output value.
-     */
-    onAfterToolCall?: (name: string, input: any, output: any) => any | Promise<any>;
-}
-interface ClarificationRequest {
-    id: string;
-    question: string;
-    context?: string;
-    defaultAnswer?: string;
-    timeout: number;
-}
-interface ToolExecutionContext {
-    onClarificationRequest?: (request: ClarificationRequest) => Promise<string>;
-    abortSignal?: AbortSignal;
-}
-interface Tool<Input = any, Output = any> {
-    name: string;
-    description: string;
-    inputSchema: FlexibleSchema<Input>;
-    execute: (input: Input, context?: ToolExecutionContext) => Promise<Output>;
-}
-interface Context {
-    messages: ModelMessage[];
-}
-interface IPlugin {
-    name: string;
-    version: string;
-    extensions: Extension[];
-    activate(context: IExtensionContext): Promise<void>;
-    deactivate?(): Promise<void>;
-}
-interface Extension {
-    type: 'skill' | 'mcp' | 'tool' | 'context';
-    provider: any;
-}
-interface IExtensionContext {
-    registerTools(toolName: string, tool: Tool<any, any>): void;
-    logger: ILogger;
-}
-interface ILogger {
-    debug(message: string, meta?: Record<string, unknown>): void;
-    info(message: string, meta?: Record<string, unknown>): void;
-    warn(message: string, meta?: Record<string, unknown>): void;
-    error(message: string, error?: Error, meta?: Record<string, unknown>): void;
-}
-
 interface LoopOptions {
     onText?: (delta: string) => void;
     onToolCall?: (toolCall: any) => void;
@@ -150,10 +59,10 @@ interface UserConfigPlugin {
  */
 declare const ToolConfigSchema: z.ZodObject<{
     type: z.ZodEnum<{
-        skill: "skill";
         bash: "bash";
         http: "http";
         javascript: "javascript";
+        skill: "skill";
         custom: "custom";
     }>;
     command: z.ZodOptional<z.ZodString>;
@@ -504,6 +413,7 @@ declare class Engine {
      * 准备引擎插件列表（包含内置插件）
      */
     private prepareEnginePlugins;
+    private applyRunHooks;
     /**
      * 运行AI循环
      */
@@ -515,6 +425,7 @@ declare class Engine {
         enginePlugins: string[];
         userConfigPlugins: string[];
         tools: string[];
+        runHooks: string[];
         services: string[];
         protocols: string[];
     };
@@ -543,6 +454,7 @@ declare class PluginManager {
     private enginePlugins;
     private userConfigPlugins;
     private tools;
+    private runHooks;
     private services;
     private protocols;
     private config;
@@ -590,6 +502,9 @@ declare class PluginManager {
     private applyUserConfig;
     /**
      * 验证核心能力
+     *
+     * - requiredCapabilities: 任意一个别名匹配即可，缺失时 **抛错** 阻止启动。
+     * - recommendedCapabilities: 缺失时仅 warn，不影响启动。
      */
     private validateCoreCapabilities;
     /**
@@ -600,6 +515,10 @@ declare class PluginManager {
      * 工具获取
      */
     getTools(): Record<string, any>;
+    /**
+     * 运行时钩子获取
+     */
+    getRunHooks(): EngineRunHook[];
     /**
      * 服务获取
      */
@@ -615,6 +534,7 @@ declare class PluginManager {
         enginePlugins: string[];
         userConfigPlugins: string[];
         tools: string[];
+        runHooks: string[];
         services: string[];
         protocols: string[];
     };
@@ -624,4 +544,4 @@ declare class PluginManager {
     private resolvePath;
 }
 
-export { BashTool, BuiltinTools, BuiltinToolsMap, type ClarificationRequest, ClarifyTool, type Context, EditTool, Engine, type Extension, GrepTool, type IExtensionContext, type ILogger, type IPlugin, type LLMProviderFactory, LsTool, PluginManager, Engine as PulseAgent, ReadTool, type SystemPromptOption, TavilyTool, type Tool, type ToolExecutionContext, type ToolHooks, type UserConfigPlugin, type UserConfigPluginLoadOptions, WriteTool, getFinalToolsMap, loop, maybeCompactContext, streamTextAI };
+export { BashTool, BuiltinTools, BuiltinToolsMap, ClarificationRequest, ClarifyTool, Context, EditTool, Engine, GrepTool, ILogger, LLMProviderFactory, LsTool, PluginManager, Engine as PulseAgent, ReadTool, SystemPromptOption, TavilyTool, Tool, ToolExecutionContext, ToolHooks, type UserConfigPlugin, type UserConfigPluginLoadOptions, WriteTool, getFinalToolsMap, loop, maybeCompactContext, streamTextAI };