@neovate/code 0.23.1 → 0.25.0

package/dist/index.d.ts

@@ -8,6 +8,7 @@ import { z as _zod } from 'zod';
 
 declare interface AddSkillOptions {
     global?: boolean;
+    claude?: boolean;
     overwrite?: boolean;
     name?: string;
     targetDir?: string;
@@ -80,6 +81,7 @@ declare class AgentManager {
         tools: Tool[];
         cwd: string;
         signal?: AbortSignal;
+        parentSessionId?: string;
         forkContextMessages?: NormalizedMessage[];
         onMessage?: (message: NormalizedMessage, agentId: string, model: string) => void | Promise<void>;
         onToolApprove?: (opts: {
@@ -139,6 +141,32 @@ declare type ApprovalContext = {
 
 declare type ApprovalMode = 'default' | 'autoEdit' | 'yolo';
 
+export declare type Argv = {
+    _: string[];
+    help: boolean;
+    mcp: boolean;
+    quiet: boolean;
+    continue?: boolean;
+    version: boolean;
+    appendSystemPrompt?: string;
+    approvalMode?: string;
+    cwd?: string;
+    host?: string;
+    language?: string;
+    model?: string;
+    outputFormat?: string;
+    outputStyle?: string;
+    planModel?: string;
+    smallModel?: string;
+    visionModel?: string;
+    resume?: string;
+    systemPrompt?: string;
+    tools?: string;
+    port?: number;
+    plugin: string[];
+    mcpConfig: string[];
+};
+
 declare type AssistantContent = string | Array<TextPart | ReasoningPart | ToolUsePart>;
 
 declare type AssistantMessage = {
@@ -236,6 +264,20 @@ declare type Config = {
      * Example: { explore: { model: "anthropic/claude-haiku-4" } }
      */
     agent?: Record<string, AgentConfig>;
+    /**
+     * Extra SKILL.md file paths for user-defined skills.
+     * Accepts absolute paths to SKILL.md files or directories containing SKILL.md.
+     * Example: ["/path/to/my-skill/SKILL.md", "/path/to/skill-dir"]
+     */
+    skills?: string[];
+    /**
+     * Notification configuration.
+     * - true: play default sound (Funk/warning)
+     * - false: disabled
+     * - string: custom sound name (e.g., "Glass", "Ping")
+     * - object: extended notification config (reserved for future use, e.g., url)
+     */
+    notification?: boolean | string;
 };
 
 declare type ConfigGetInput = {
@@ -308,6 +350,7 @@ export declare class Context {
     messageBus?: MessageBus;
     agentManager?: AgentManager;
     plugins: (string | Plugin_2)[];
+    fetch?: typeof globalThis.fetch;
     constructor(opts: ContextOpts);
     apply(applyOpts: Omit<PluginApplyOpts, 'pluginContext'>): Promise<any>;
     destroy(): Promise<void>;
@@ -322,6 +365,7 @@ declare type ContextCreateOpts = {
     argvConfig: Record<string, any>;
     plugins: (string | Plugin_2)[];
     messageBus?: MessageBus;
+    fetch?: typeof globalThis.fetch;
 };
 
 declare type ContextOpts = {
@@ -339,6 +383,7 @@ declare type ContextOpts = {
     messageBus?: MessageBus;
     agentManager?: AgentManager;
     plugins: (string | Plugin_2)[];
+    fetch?: typeof globalThis.fetch;
 };
 
 export declare function createSession(options: SDKSessionOptions): Promise<SDKSession>;
@@ -569,6 +614,10 @@ declare type HandlerMap = {
         input: ModelsListInput;
         output: ModelsListOutput;
     };
+    'models.test': {
+        input: ModelsTestInput;
+        output: ModelsTestOutput;
+    };
     'outputStyles.list': {
         input: OutputStylesListInput;
         output: OutputStylesListOutput;
@@ -741,6 +790,10 @@ declare type HandlerMap = {
         input: UtilsGetPathsInput;
         output: UtilsGetPathsOutput;
     };
+    'utils.searchPaths': {
+        input: UtilsSearchPathsInput;
+        output: UtilsSearchPathsOutput;
+    };
     'utils.telemetry': {
         input: UtilsTelemetryInput;
         output: SuccessResponse;
@@ -1040,9 +1093,43 @@ declare type ModelsListOutput = {
             modelId: string;
             modelContextLimit: number;
         } | null;
+        nullModels: Array<{
+            providerId: string;
+            modelId: string;
+        }>;
     };
 };
 
+declare type ModelsTestInput = {
+    cwd?: string;
+    model: string;
+    timeout?: number;
+    prompt?: string;
+};
+
+declare type ModelsTestOutput = {
+    success: true;
+    data: {
+        model: string;
+        provider: string;
+        modelName: string;
+        prompt: string;
+        response: string;
+        responseTime: number;
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+        } | null;
+    };
+} | {
+    success: false;
+    error: string;
+};
+
+declare type NodeBridgeHandlers = Partial<{
+    [K in keyof HandlerMap]: (data: HandlerMap[K]['input'], context: Context) => Promise<HandlerMap[K]['output']> | HandlerMap[K]['output'];
+}>;
+
 declare type NormalizedMessage = Message_2 & {
     type: 'message';
     timestamp: string;
@@ -1087,6 +1174,8 @@ declare type OutputStylesListOutput = {
     };
 };
 
+export declare function parseArgs(argv: any): Promise<Argv>;
+
 declare class Paths {
     globalConfigDir: string;
     globalProjectDir: string;
@@ -1176,6 +1265,29 @@ declare type Plugin_2 = {
         name: string;
         payload: Record<string, any>;
     }) => Promise<void> | void;
+    stop?: (this: PluginContext, opts: {
+        sessionId: string;
+        result: LoopResult;
+        usage: Usage;
+        turnsCount: number;
+        toolCallsCount: number;
+        duration: number;
+        model: string;
+    }) => Promise<void> | void;
+    subagentStop?: (this: PluginContext, opts: {
+        parentSessionId: string;
+        agentId: string;
+        agentType: string;
+        result: AgentExecutionResult;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+        };
+        totalToolCalls: number;
+        totalDuration: number;
+        model: string;
+    }) => Promise<void> | void;
+    nodeBridgeHandler?: (this: PluginContext) => Promise<NodeBridgeHandlers> | NodeBridgeHandlers;
 };
 export { Plugin_2 as Plugin }
 
@@ -1207,6 +1319,12 @@ declare class PluginManager {
     apply({ hook, args, memo, type, pluginContext, }: PluginApplyOpts): Promise<any>;
 }
 
+declare interface PreviewSkillsResult {
+    tempDir: string;
+    skills: SkillPreview[];
+    errors: SkillError[];
+}
+
 declare type ProjectAddHistoryInput = {
     cwd: string;
     history: string;
@@ -1413,7 +1531,7 @@ declare interface Provider {
     };
 }
 
-declare type ProviderConfig = Partial<Omit<Provider, 'createModel'>>;
+export declare type ProviderConfig = Partial<Omit<Provider, 'createModel'>>;
 
 declare type ProvidersListInput = {
     cwd: string;
@@ -1428,8 +1546,19 @@ declare type ProvidersListOutput = {
             doc?: string;
             env?: string[];
             apiEnv?: string[];
+            api?: string;
+            options?: {
+                baseURL?: string;
+                apiKey?: string;
+                headers?: Record<string, string>;
+                httpProxy?: string;
+            };
             validEnvs: string[];
             hasApiKey: boolean;
+            maskedApiKey?: string;
+            apiKeyOrigin?: 'env' | 'config';
+            apiKeyEnvName?: string;
+            oauthUser?: string;
         }>;
     };
 };
@@ -1485,7 +1614,11 @@ export declare function runNeovate(opts: {
     version: string;
     plugins: Plugin_2[];
     upgrade?: UpgradeOptions;
-}): Promise<void>;
+    argv: Argv;
+    fetch?: typeof globalThis.fetch;
+}): Promise<{
+    shutdown?: () => Promise<void>;
+}>;
 
 export declare type SDKMessage = NormalizedMessage | SDKSystemMessage | SDKResultMessage;
 
@@ -1515,6 +1648,24 @@ export declare type SDKSessionOptions = {
     cwd?: string;
     productName?: string;
     plugins?: Plugin_2[];
+    /**
+     * Custom provider configurations to add or override built-in providers.
+     * Allows specifying custom API endpoints and model definitions.
+     *
+     * @example
+     * ```typescript
+     * providers: {
+     *   "my-custom-provider": {
+     *     api: "https://my-api.example.com/v1",
+     *     env: ["MY_API_KEY"],
+     *     models: {
+     *       "my-model": "deepseek-v3.2" // Reference existing model
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    providers?: Record<string, ProviderConfig>;
 };
 
 declare type SDKSystemMessage = {
@@ -1773,6 +1924,10 @@ declare class SkillManager {
     loadSkills(): Promise<void>;
     private loadSkillsFromDirectory;
     private loadSkillFile;
+    /**
+     * Load skill from a path that can be either a SKILL.md file or a directory containing SKILL.md.
+     */
+    private loadSkillPath;
     private parseSkillFile;
     addSkill(source: string, options?: AddSkillOptions): Promise<AddSkillResult>;
     private normalizeSource;
@@ -1780,6 +1935,9 @@ declare class SkillManager {
     private scanForSkills;
     private copyDirectory;
     private parseSkillFileForAdd;
+    previewSkills(source: string): Promise<PreviewSkillsResult>;
+    installFromPreview(preview: PreviewSkillsResult, selectedSkills: SkillPreview[], source: string, options?: AddSkillOptions): Promise<AddSkillResult>;
+    cleanupPreview(preview: PreviewSkillsResult): void;
     removeSkill(name: string, targetDir?: string): Promise<{
         success: boolean;
         error?: string;
@@ -1797,8 +1955,16 @@ declare interface SkillMetadata {
     source: SkillSource;
 }
 
+declare interface SkillPreview {
+    name: string;
+    description: string;
+    skillPath: string;
+    skillDir: string;
+}
+
 declare enum SkillSource {
     Plugin = "plugin",
+    Config = "config",
     GlobalClaude = "global-claude",
     Global = "global",
     ProjectClaude = "project-claude",
@@ -2111,6 +2277,20 @@ declare type UtilsQuickQueryInput = {
 
 declare type UtilsQuickQueryOutput = any;
 
+declare type UtilsSearchPathsInput = {
+    cwd: string;
+    query: string;
+    maxResults?: number;
+};
+
+declare type UtilsSearchPathsOutput = {
+    success: boolean;
+    data: {
+        paths: string[];
+        truncated: boolean;
+    };
+};
+
 declare type UtilsSummarizeMessageInput = {
     message: string;
     cwd: string;