@opencow-ai/opencow-agent-sdk 0.4.6 → 0.4.8

package/dist/Tool.d.ts

@@ -1,6 +1,7 @@
 import type { CanonicalToolResultBlockParam as ToolResultBlockParam } from './session/canonical/index.js';
 import type { z } from 'zod/v4';
 import type { CanUseToolFn } from './types/toolRuntime.js';
+import type { SetToolJSXFn } from './types/toolUI.js';
 export type { ToolRuntime, ToolRuntimes, ToolRuntimeContext, CanUseToolFn as CanUseToolFnRuntime, } from './types/toolRuntime.js';
 export { toolMatchesName as toolMatchesNameRuntime, findToolRuntimeByName, } from './types/toolRuntime.js';
 export type { ToolUI } from './types/toolUI.js';

package/dist/capabilities/SdkTool.d.ts

@@ -34,4 +34,12 @@ export interface SdkTool {
      * use this to schedule parallel calls.
      */
     readonly isConcurrencySafe?: boolean;
+    /**
+     * Optional: defer this tool behind ToolSearch. Deferred tools are NOT
+     * serialized into every model request — only their name is announced;
+     * the model loads the full schema on demand via ToolSearchTool. Use for
+     * large dynamic tool pools (e.g. cloud-tool catalogs). Defaults to
+     * false: inline tools are loaded upfront, preserving existing behavior.
+     */
+    readonly shouldDefer?: boolean;
 }

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

@@ -5,10 +5,10 @@ export declare const ConfigScopeSchema: () => z.ZodEnum<{
     user: "user";
     project: "project";
     local: "local";
-    managed: "managed";
     dynamic: "dynamic";
     enterprise: "enterprise";
     claudeai: "claudeai";
+    managed: "managed";
 }>;
 export type ConfigScope = z.infer<ReturnType<typeof ConfigScopeSchema>>;
 export declare const TransportSchema: () => z.ZodEnum<{

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

@@ -0,0 +1,8 @@
+import type { AgentDefinition } from './loadAgentsDir.js';
+/**
+ * Merge two agent lists, deduping by `agentType`. `override` entries win over
+ * `base` entries of the same `agentType`; a built-in's slot/order is preserved
+ * when overridden. Used to combine SDK built-in agents (`base`) with
+ * host-provided `Options.agents` (`override`).
+ */
+export declare function mergeAgentsByType(base: AgentDefinition[], override: AgentDefinition[]): AgentDefinition[];

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

@@ -1,3 +1,18 @@
 import type { AgentDefinition } from './loadAgentsDir.js';
 export declare function areExplorePlanAgentsEnabled(): boolean;
 export declare function getBuiltInAgents(): AgentDefinition[];
+/**
+ * Resolve the active agent set for the SDK programmatic path.
+ *
+ * The CLI merges built-in agents through `loadAgentsDir`, but the SDK runtime
+ * path (`sdkRuntime` → `QueryEngine`) used `Options.agents` verbatim. A host
+ * that passes no agents therefore ended up with an EMPTY `activeAgents` list,
+ * so every `subagent_type` — including the universal `general-purpose` — failed
+ * with "Agent type X not found. Available agents:" and no subagent could run.
+ *
+ * Merge the built-ins back in (deduped by `agentType`, host definitions taking
+ * precedence over a built-in of the same type). `getBuiltInAgents()` already
+ * honors `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS`, so a host wanting a blank
+ * slate keeps that opt-out.
+ */
+export declare function resolveSdkAgents(hostAgents: AgentDefinition[]): AgentDefinition[];

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

@@ -2,13 +2,13 @@ import type { QuerySource } from '../../../constants/querySource.js';
 import type { CanUseToolFn } from '../../../types/canUseTool.js';
 import type { ToolRuntimes, ToolRuntimeContext } from '../../../types/toolRuntime.js';
 import type { AgentId } from '../../../types/ids.js';
-import type { Message } from '../../../types/message.js';
+import type { AssistantMessage, Message } from '../../../types/message.js';
 import { type CacheSafeParams } from '../../../session/forkedAgent.js';
 import type { ModelAlias } from '../../../providers/shared/model/aliases.js';
 import { type SystemPrompt } from '../../../session/systemPromptType.js';
 import type { ContentReplacementState } from '../../../controller/toolResultStorage.js';
 import { type AgentDefinition } from './loadAgentsDir.js';
-export declare function runAgent({ agentDefinition, promptMessages, toolUseContext, canUseTool, isAsync, canShowPermissionPrompts, forkContextMessages, querySource, override, model, maxTurns, preserveToolUseResults, availableTools, allowedTools, onCacheSafeParams, contentReplacementState, useExactTools, worktreePath, description, transcriptSubdir, onQueryProgress, agentName, }: {
+export declare function runAgent({ agentDefinition, promptMessages, toolUseContext, canUseTool, isAsync, canShowPermissionPrompts, forkContextMessages, querySource, override, model, maxTurns, preserveToolUseResults, availableTools, allowedTools, onCacheSafeParams, contentReplacementState, useExactTools, worktreePath, description, transcriptSubdir, onQueryProgress, onPartialAssistant, agentName, }: {
     agentDefinition: AgentDefinition;
     promptMessages: Message[];
     toolUseContext: ToolRuntimeContext;
@@ -71,6 +71,17 @@ 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 /
+     * 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
+     * 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:
+     * if the provider emits no text_delta, rendering falls back to block
+     * granularity). Wired only for foreground sub-agents today. */
+    onPartialAssistant?: (message: AssistantMessage) => void;
     /** Agent name (team member name) for routing resolution */
     agentName?: string;
 }): AsyncGenerator<Message, void>;

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

@@ -33,7 +33,7 @@ export declare const ToolSearchTool: Omit<{
     renderToolUseMessage(): any;
     userFacingName: () => string;
     /**
-     * Returns a tool_result with tool_reference blocks.
+     * Native wire: returns a tool_result with tool_reference blocks.
      * This format works on 1P/Foundry. Bedrock/Vertex may not support
      * client-side tool_reference expansion yet.
      */