@opencow-ai/opencow-agent-sdk 0.4.22 → 0.4.24

package/dist/capabilities/SdkTool.d.ts

@@ -11,6 +11,11 @@ export interface SdkTool {
      * behind the permissive value type.
      */
     readonly inputSchema: ToolInputSchemaShape;
+    /**
+     * Runtime policy for object keys that are absent from `inputSchema`.
+     * Defaults to `strip`; security-sensitive host tools can opt into `reject`.
+     */
+    readonly unknownKeys?: 'strip' | 'reject';
     /**
      * Business logic. Receives validated args plus a structured invocation
      * context. Must return a `CallToolResult`. Exceptions are caught by the

package/dist/capabilities/lsp/LSPServerManager.d.ts

@@ -1,4 +1,5 @@
 import { type LSPServerInstance } from './LSPServerInstance.js';
+import type { ScopedLspServerConfig } from './types.js';
 /**
  * LSP Server Manager interface returned by createLSPServerManager.
  * Manages multiple LSP server instances and routes requests based on file extensions.
@@ -41,4 +42,4 @@ export type LSPServerManager = {
  * const result = await manager.sendRequest('/path/to/file.ts', 'textDocument/definition', params)
  * await manager.shutdown()
  */
-export declare function createLSPServerManager(): LSPServerManager;
+export declare function createLSPServerManager(explicitServerConfigs?: Readonly<Record<string, ScopedLspServerConfig>>): LSPServerManager;

package/dist/capabilities/mcp/types.d.ts

@@ -2,9 +2,9 @@ import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import type { Resource, ServerCapabilities } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod/v4';
 export declare const ConfigScopeSchema: () => z.ZodEnum<{
+    local: "local";
     user: "user";
     project: "project";
-    local: "local";
     dynamic: "dynamic";
     enterprise: "enterprise";
     claudeai: "claudeai";
@@ -14,10 +14,10 @@ export type ConfigScope = z.infer<ReturnType<typeof ConfigScopeSchema>>;
 export declare const TransportSchema: () => z.ZodEnum<{
     stdio: "stdio";
     sse: "sse";
-    http: "http";
-    sdk: "sdk";
     "sse-ide": "sse-ide";
+    http: "http";
     ws: "ws";
+    sdk: "sdk";
 }>;
 export type Transport = z.infer<ReturnType<typeof TransportSchema>>;
 export declare const McpStdioServerConfigSchema: () => z.ZodObject<{

package/dist/capabilities/plugins/loadPluginAgents.d.ts

@@ -1,2 +1,8 @@
+import type { AgentDefinition } from '../tools/AgentTool/loadAgentsDir.js';
+import type { LoadedPlugin } from '../../types/plugin.js';
 export declare const loadPluginAgents: any;
+/** Load agent components from an explicit plugin set without settings discovery. */
+export declare function loadPluginAgentsFromPlugins(enabled: readonly LoadedPlugin[], options?: {
+    strict?: boolean;
+}): Promise<AgentDefinition[]>;
 export declare function clearPluginAgentCache(): void;

package/dist/capabilities/plugins/loadPluginCommands.d.ts

@@ -1,4 +1,14 @@
+import type { Command } from '../../types/command.js';
+import type { LoadedPlugin } from '../../types/plugin.js';
 export declare const getPluginCommands: any;
+/** Load command components from an explicit plugin set without settings discovery. */
+export declare function loadPluginCommandsFromPlugins(enabled: readonly LoadedPlugin[], options?: {
+    strict?: boolean;
+}): Promise<Command[]>;
 export declare function clearPluginCommandCache(): void;
 export declare const getPluginSkills: any;
+/** Load skill components from an explicit plugin set without settings discovery. */
+export declare function loadPluginSkillsFromPlugins(enabled: readonly LoadedPlugin[], options?: {
+    strict?: boolean;
+}): Promise<Command[]>;
 export declare function clearPluginSkillsCache(): void;

package/dist/capabilities/plugins/loadPluginHooks.d.ts

@@ -1,3 +1,8 @@
+import type { HookEvent } from '../../entrypoints/sdk/coreTypes.js';
+import type { LoadedPlugin } from '../../types/plugin.js';
+import type { PluginHookMatcher } from '../../session/settings/types.js';
+/** Build session-scoped hook matchers from an explicit plugin snapshot. */
+export declare function buildExplicitPluginHookMatchers(plugins: readonly LoadedPlugin[]): Partial<Record<HookEvent, PluginHookMatcher[]>>;
 /**
  * Load and register hooks from all enabled plugins
  */

package/dist/capabilities/plugins/loadPluginOutputStyles.d.ts

@@ -1,2 +1,8 @@
+import type { OutputStyleConfig } from '../../session/outputStyles/config.js';
+import type { LoadedPlugin } from '../../types/plugin.js';
 export declare const loadPluginOutputStyles: any;
+/** Load output styles from an explicit plugin set without settings discovery. */
+export declare function loadPluginOutputStylesFromPlugins(enabled: readonly LoadedPlugin[], options?: {
+    strict?: boolean;
+}): Promise<OutputStyleConfig[]>;
 export declare function clearPluginOutputStyleCache(): void;

package/dist/capabilities/plugins/lspPluginIntegration.d.ts

@@ -20,6 +20,7 @@ export declare function loadPluginLspServers(plugin: LoadedPlugin, errors?: Plug
 export declare function resolvePluginLspEnvironment(config: LspServerConfig, plugin: {
     path: string;
     source: string;
+    dataPath?: string;
 }, userConfig?: PluginOptionValues, _errors?: PluginError[]): LspServerConfig;
 /**
  * Add plugin scope to LSP server configs

package/dist/capabilities/plugins/mcpPluginIntegration.d.ts

@@ -47,6 +47,7 @@ export declare function extractMcpServersFromPlugins(plugins: LoadedPlugin[], er
 export declare function resolvePluginMcpEnvironment(config: McpServerConfig, plugin: {
     path: string;
     source: string;
+    dataPath?: string;
 }, userConfig?: UserConfigValues, errors?: PluginError[], pluginName?: string, serverName?: string): McpServerConfig;
 /**
  * Get MCP servers from a specific plugin with environment variable resolution and scoping

package/dist/capabilities/plugins/pluginOptionsStorage.d.ts

@@ -84,6 +84,7 @@ export declare function getUnconfiguredOptions(plugin: LoadedPlugin): PluginOpti
 export declare function substitutePluginVariables(value: string, plugin: {
     path: string;
     source?: string;
+    dataPath?: string;
 }): string;
 /**
  * Substitute ${user_config.KEY} with saved option values.

package/dist/capabilities/plugins/schemas.d.ts

@@ -1594,9 +1594,9 @@ export declare const InstalledPluginsFileSchemaV1: () => z.ZodObject<{
  * are NOT persisted to installed_plugins.json.
  */
 export declare const PluginScopeSchema: () => z.ZodEnum<{
+    local: "local";
     user: "user";
     project: "project";
-    local: "local";
     managed: "managed";
 }>;
 /**
@@ -1608,9 +1608,9 @@ export declare const PluginScopeSchema: () => z.ZodEnum<{
  */
 export declare const PluginInstallationEntrySchema: () => z.ZodObject<{
     scope: z.ZodEnum<{
+        local: "local";
         user: "user";
         project: "project";
-        local: "local";
         managed: "managed";
     }>;
     projectPath: z.ZodOptional<z.ZodString>;
@@ -1642,9 +1642,9 @@ export declare const InstalledPluginsFileSchemaV2: () => z.ZodObject<{
     version: z.ZodLiteral<2>;
     plugins: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
         scope: z.ZodEnum<{
+            local: "local";
             user: "user";
             project: "project";
-            local: "local";
             managed: "managed";
         }>;
         projectPath: z.ZodOptional<z.ZodString>;
@@ -1672,9 +1672,9 @@ export declare const InstalledPluginsFileSchema: () => z.ZodUnion<readonly [z.Zo
     version: z.ZodLiteral<2>;
     plugins: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
         scope: z.ZodEnum<{
+            local: "local";
             user: "user";
             project: "project";
-            local: "local";
             managed: "managed";
         }>;
         projectPath: z.ZodOptional<z.ZodString>;

package/dist/capabilities/plugins/sdkPluginRuntime.d.ts

@@ -0,0 +1,35 @@
+import type { SdkLocalPlugin, SdkPluginApplyResult, SdkPluginComponentCounts, SdkPluginSnapshot, SdkPluginState } from '../../entrypoints/sdk/runtimeTypes.js';
+import type { LoadedPlugin } from '../../types/plugin.js';
+import type { PluginHookMatcher } from '../../session/settings/types.js';
+import type { HookEvent } from '../../entrypoints/sdk/coreTypes.js';
+import type { LSPServerManager } from '../lsp/LSPServerManager.js';
+import type { OutputStyleConfig } from '../../session/outputStyles/config.js';
+export type ExplicitPluginRuntimeBundle = {
+    revision: string;
+    plugins: readonly LoadedPlugin[];
+    commands: readonly unknown[];
+    skills: readonly unknown[];
+    agents: readonly unknown[];
+    hooks: Partial<Record<HookEvent, PluginHookMatcher[]>>;
+    mcpServers: Readonly<Record<string, unknown>>;
+    lspManager: LSPServerManager | null;
+    outputStyles: readonly OutputStyleConfig[];
+    dataPaths: ReadonlyMap<string, string>;
+    state: SdkPluginState;
+    dispose(): Promise<void>;
+};
+export declare function emptyPluginComponentCounts(): SdkPluginComponentCounts;
+export declare function emptyPluginState(): SdkPluginState;
+/** Compute the canonical SHA-256 used by managed plugin snapshots. */
+export declare function computeSdkPluginContentHash(path: string): Promise<string>;
+export declare function stageManagedPluginSnapshot(snapshot: SdkPluginSnapshot, appliedState: SdkPluginState): Promise<{
+    status: 'staged';
+    bundle: ExplicitPluginRuntimeBundle;
+    result: SdkPluginApplyResult;
+} | {
+    status: 'rejected';
+    result: SdkPluginApplyResult;
+}>;
+/** Validate and inspect a managed snapshot without retaining runtime resources. */
+export declare function inspectPluginSnapshot(snapshot: SdkPluginSnapshot): Promise<SdkPluginApplyResult>;
+export declare function stageStaticLocalPlugins(plugins: readonly SdkLocalPlugin[], cwd?: string, dataRoot?: string): Promise<ExplicitPluginRuntimeBundle>;

package/dist/capabilities/todo/types.d.ts

@@ -3,8 +3,8 @@ export declare const TodoItemSchema: () => z.ZodObject<{
     content: z.ZodString;
     status: z.ZodEnum<{
         pending: "pending";
-        completed: "completed";
         in_progress: "in_progress";
+        completed: "completed";
     }>;
     activeForm: z.ZodString;
 }, z.core.$strip>;
@@ -13,8 +13,8 @@ export declare const TodoListSchema: () => z.ZodArray<z.ZodObject<{
     content: z.ZodString;
     status: z.ZodEnum<{
         pending: "pending";
-        completed: "completed";
         in_progress: "in_progress";
+        completed: "completed";
     }>;
     activeForm: z.ZodString;
 }, z.core.$strip>>;

package/dist/capabilities/tools/AgentTool/AgentTool.d.ts

@@ -4,17 +4,17 @@ import { z } from 'zod/v4';
 import type { PermissionResult } from '../../../permissions/PermissionResult.js';
 import type { AgentDefinition } from './loadAgentsDir.js';
 export declare const inputSchema: () => z.ZodObject<{
-    name: z.ZodOptional<z.ZodString>;
-    description: z.ZodString;
     mode: z.ZodOptional<z.ZodEnum<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
         auto: "auto";
     }>>;
+    name: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
+    description: z.ZodString;
     model: z.ZodOptional<z.ZodEnum<{
         haiku: "haiku";
         sonnet: "sonnet";
@@ -77,17 +77,17 @@ export declare const AgentTool: {
     inputSchema: InputSchema;
     inputJSONSchema: ToolInputJSONSchema;
     name: string;
-    description: (input: any, options: {
-        isNonInteractiveSession: boolean;
-        toolPermissionContext: import("../../../types/toolRuntime.js").ToolPermissionContext;
-        tools: import("../../../types/toolRuntime.js").ToolRuntimes;
-    }) => Promise<string>;
     prompt: (options: {
         getToolPermissionContext: () => Promise<import("../../../types/toolRuntime.js").ToolPermissionContext>;
         tools: import("../../../types/toolRuntime.js").ToolRuntimes;
         agents: AgentDefinition[];
         allowedAgentTypes?: string[];
     }) => Promise<string>;
+    description: (input: any, options: {
+        isNonInteractiveSession: boolean;
+        toolPermissionContext: import("../../../types/toolRuntime.js").ToolPermissionContext;
+        tools: import("../../../types/toolRuntime.js").ToolRuntimes;
+    }) => Promise<string>;
     strict?: boolean;
     aliases?: string[];
     searchHint?: string;
@@ -99,6 +99,7 @@ export declare const AgentTool: {
     isLsp?: boolean;
     shouldDefer?: boolean;
     alwaysLoad?: boolean;
+    unknownKeys?: "strip" | "reject";
     outputSchema?: z.ZodType<unknown>;
     call: (args: any, context: import("../../../types/toolRuntime.js").ToolRuntimeContext, canUseTool: import("../../../types/toolRuntime.js").CanUseToolFn, parentMessage: MessageType, onProgress?: import("../../../types/toolRuntime.js").ToolCallProgress<any>) => Promise<import("../../../types/toolRuntime.js").ToolResult<any>>;
     validateInput?: (input: any, context: import("../../../types/toolRuntime.js").ToolRuntimeContext) => Promise<import("../../../types/toolRuntime.js").ValidationResult>;

package/dist/capabilities/tools/AgentTool/agentMerge.d.ts

@@ -6,3 +6,4 @@ import type { AgentDefinition } from './loadAgentsDir.js';
  * host-provided `Options.agents` (`override`).
  */
 export declare function mergeAgentsByType(base: AgentDefinition[], override: AgentDefinition[]): AgentDefinition[];
+export declare function withDefaultAgentForInvocation(activeAgents: AgentDefinition[], requestedType: string | undefined, defaultAgent: AgentDefinition): AgentDefinition[];

package/dist/capabilities/tools/AgentTool/inputSchema.d.ts

@@ -15,17 +15,17 @@ export declare function buildAgentInputSchema(options: {
     includeCwd: boolean;
     includeRunInBackground: boolean;
 }): z.ZodObject<{
-    name: z.ZodOptional<z.ZodString>;
-    description: z.ZodString;
     mode: z.ZodOptional<z.ZodEnum<{
         default: "default";
         acceptEdits: "acceptEdits";
         bypassPermissions: "bypassPermissions";
-        plan: "plan";
         dontAsk: "dontAsk";
+        plan: "plan";
         auto: "auto";
     }>>;
+    name: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
+    description: z.ZodString;
     model: z.ZodOptional<z.ZodEnum<{
         haiku: "haiku";
         sonnet: "sonnet";

package/dist/capabilities/tools/AgentTool/loadAgentsDir.d.ts

@@ -23,6 +23,7 @@ export type BaseAgentDefinition = {
     permissionMode?: PermissionMode;
     maxTurns?: number;
     filename?: string;
+    sourcePath?: string;
     baseDir?: string;
     criticalSystemReminder_EXPERIMENTAL?: string;
     requiredMcpServers?: string[];

package/dist/capabilities/tools/AgentTool/runAgent.d.ts

@@ -71,11 +71,11 @@ export declare function runAgent({ agentDefinition, promptMessages, toolUseConte
      * during long single-block streams (e.g. thinking) where no assistant
      * message is yielded for >60s. */
     onQueryProgress?: () => void;
-    /** Optional callback fired with a GROWING single-block assistant message as
-     * the sub-agent's text streams token-by-token (content_block_delta /
+    /** Optional callback fired at most once every 50ms with a GROWING single-block
+     * assistant message as the sub-agent's text streams (content_block_delta /
      * text_delta accumulated per content-block index, keyed to the message_start
      * id). The consumer (AgentTool) forwards it via the existing agent_progress
-     * onProgress channel so the host renders the sub-conversation token-by-token
+     * onProgress channel so the host renders the sub-conversation progressively
      * instead of block-at-once. Side-channel only: these partials are NOT yielded
      * and NOT recorded to the sidechain transcript — the authoritative whole
      * messages still flow through the normal yield path (graceful degradation:

package/dist/capabilities/tools/TodoWriteTool/TodoWriteTool.d.ts

@@ -4,8 +4,8 @@ declare const inputSchema: () => z.ZodObject<{
         content: z.ZodString;
         status: z.ZodEnum<{
             pending: "pending";
-            completed: "completed";
             in_progress: "in_progress";
+            completed: "completed";
         }>;
         activeForm: z.ZodString;
     }, z.core.$strip>>;
@@ -16,8 +16,8 @@ declare const outputSchema: () => z.ZodObject<{
         content: z.ZodString;
         status: z.ZodEnum<{
             pending: "pending";
-            completed: "completed";
             in_progress: "in_progress";
+            completed: "completed";
         }>;
         activeForm: z.ZodString;
     }, z.core.$strip>>;
@@ -25,8 +25,8 @@ declare const outputSchema: () => z.ZodObject<{
         content: z.ZodString;
         status: z.ZodEnum<{
             pending: "pending";
-            completed: "completed";
             in_progress: "in_progress";
+            completed: "completed";
         }>;
         activeForm: z.ZodString;
     }, z.core.$strip>>;
@@ -49,14 +49,14 @@ export declare const TodoWriteTool: Omit<{
     toAutoClassifierInput(input: {
         todos: {
             content: string;
-            status: "pending" | "completed" | "in_progress";
+            status: "pending" | "in_progress" | "completed";
             activeForm: string;
         }[];
     }): string;
     checkPermissions(input: {
         todos: {
             content: string;
-            status: "pending" | "completed" | "in_progress";
+            status: "pending" | "in_progress" | "completed";
             activeForm: string;
         }[];
     }): Promise<{
@@ -64,7 +64,7 @@ export declare const TodoWriteTool: Omit<{
         updatedInput: {
             todos: {
                 content: string;
-                status: "pending" | "completed" | "in_progress";
+                status: "pending" | "in_progress" | "completed";
                 activeForm: string;
             }[];
         };
@@ -73,7 +73,7 @@ export declare const TodoWriteTool: Omit<{
     call({ todos }: {
         todos: {
             content: string;
-            status: "pending" | "completed" | "in_progress";
+            status: "pending" | "in_progress" | "completed";
             activeForm: string;
         }[];
     }, context: import("../../../types/toolRuntime.js").ToolRuntimeContext): Promise<{
@@ -81,7 +81,7 @@ export declare const TodoWriteTool: Omit<{
             oldTodos: any;
             newTodos: {
                 content: string;
-                status: "pending" | "completed" | "in_progress";
+                status: "pending" | "in_progress" | "completed";
                 activeForm: string;
             }[];
             verificationNudgeNeeded: boolean;
@@ -90,12 +90,12 @@ export declare const TodoWriteTool: Omit<{
     mapToolResultToToolResultBlockParam({ verificationNudgeNeeded }: {
         oldTodos: {
             content: string;
-            status: "pending" | "completed" | "in_progress";
+            status: "pending" | "in_progress" | "completed";
             activeForm: string;
         }[];
         newTodos: {
             content: string;
-            status: "pending" | "completed" | "in_progress";
+            status: "pending" | "in_progress" | "completed";
             activeForm: string;
         }[];
         verificationNudgeNeeded?: boolean;