@opencow-ai/opencow-agent-sdk 0.4.17 → 0.4.18

package/README.md

@@ -148,6 +148,7 @@ const stream = query({
     cwd: process.cwd(),
     model: 'gpt-4o',
     maxTurns: 3,
+    builtInToolPreset: 'default',
   },
 })
 
@@ -158,6 +159,11 @@ for await (const message of stream) {
 }
 ```
 
+`builtInToolPreset: 'default'` enables the SDK-owned tools for that query.
+On Windows the SDK registers Bash when Git Bash is available; otherwise it
+registers PowerShell (`pwsh`, then Windows PowerShell). Use `'none'`, or omit
+the option, when the embedding host does not want SDK built-in tools.
+
 ### Use SDK MCP tools in-process
 
 ```bash

package/dist/Tool.d.ts

@@ -22,7 +22,7 @@ import type { SpinnerMode } from './types/spinner.js';
 import type { HookProgress } from './types/hooks.js';
 import type { DeepImmutable } from './types/utils.js';
 import type { ToolUI } from './types/toolUI.js';
-import type { ToolRuntimeContext } from './types/toolRuntime.js';
+import type { ToolRuntimeContext, ToolRuntimes } from './types/toolRuntime.js';
 export type QueryChainTracking = {
     chainId: string;
     depth: number;
@@ -80,13 +80,7 @@ export type ToolUICallbacks = {
     /** Open the interactive message selector dialog (REPL only). */
     openMessageSelector?: () => void;
 };
-export type ToolUseContext = ToolRuntimeContext & ToolUICallbacks & {
-    /** Narrow tools to full Tool[] for CLI code that needs render methods. */
-    options: ToolRuntimeContext['options'] & {
-        tools: Tools;
-        refreshTools?: () => Tools;
-    };
-};
+export type ToolUseContext = ToolRuntimeContext & ToolUICallbacks;
 export type { ToolProgressData };
 export type Progress = ToolProgressData | HookProgress;
 export type ToolProgress<P extends ToolProgressData> = {
@@ -97,7 +91,7 @@ export declare function filterToolProgressMessages(progressMessagesForMessage: P
 export type ToolResult<T> = {
     data: T;
     newMessages?: (UserMessage | AssistantMessage | AttachmentMessage | SystemMessage)[];
-    contextModifier?: (context: ToolUseContext) => ToolUseContext;
+    contextModifier?: (context: ToolRuntimeContext) => ToolRuntimeContext;
     /** MCP protocol metadata (structuredContent, _meta) to pass through to SDK consumers */
     mcpMeta?: {
         _meta?: Record<string, unknown>;
@@ -136,7 +130,7 @@ export type Tool<Input extends AnyObject = AnyObject, Output = unknown, P extend
     description(input: z.infer<Input>, options: {
         isNonInteractiveSession: boolean;
         toolPermissionContext: ToolPermissionContext;
-        tools: Tools;
+        tools: ToolRuntimes;
     }): Promise<string>;
     readonly inputSchema: Input;
     readonly inputJSONSchema?: ToolInputJSONSchema;
@@ -248,7 +242,7 @@ export type Tool<Input extends AnyObject = AnyObject, Output = unknown, P extend
     preparePermissionMatcher?(input: z.infer<Input>): Promise<(pattern: string) => boolean>;
     prompt(options: {
         getToolPermissionContext: () => Promise<ToolPermissionContext>;
-        tools: Tools;
+        tools: ToolRuntimes;
         agents: AgentDefinition[];
         allowedAgentTypes?: string[];
     }): Promise<string>;

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

@@ -1,6 +1,6 @@
 import type { Command } from '../../types/command.js';
 type AgentMcpServerInfo = any;
-import type { Tool } from '../../Tool.js';
+import type { ToolRuntime } from '../../types/toolRuntime.js';
 import type { AgentDefinition } from '../tools/AgentTool/loadAgentsDir.js';
 import { type ConfigScope, type MCPServerConnection, type McpServerConfig, type ScopedMcpServerConfig, type ServerResource } from './types.js';
 /**
@@ -10,7 +10,7 @@ import { type ConfigScope, type MCPServerConnection, type McpServerConfig, type
  * @param serverName Name of the MCP server
  * @returns Tools belonging to the specified server
  */
-export declare function filterToolsByServer(tools: Tool[], serverName: string): Tool[];
+export declare function filterToolsByServer(tools: ToolRuntime[], serverName: string): ToolRuntime[];
 /**
  * True when a command belongs to the given MCP server.
  *
@@ -49,7 +49,7 @@ export declare function filterResourcesByServer(resources: ServerResource[], ser
  * @param serverName Name of the MCP server to exclude
  * @returns Tools not belonging to the specified server
  */
-export declare function excludeToolsByServer(tools: Tool[], serverName: string): Tool[];
+export declare function excludeToolsByServer(tools: ToolRuntime[], serverName: string): ToolRuntime[];
 /**
  * Removes commands belonging to a specific MCP server
  * @param commands Array of commands
@@ -87,12 +87,12 @@ export declare function hashMcpConfig(config: ScopedMcpServerConfig): string;
  */
 export declare function excludeStalePluginClients(mcp: {
     clients: MCPServerConnection[];
-    tools: Tool[];
+    tools: ToolRuntime[];
     commands: Command[];
     resources: Record<string, ServerResource[]>;
 }, configs: Record<string, ScopedMcpServerConfig>): {
     clients: MCPServerConnection[];
-    tools: Tool[];
+    tools: ToolRuntime[];
     commands: Command[];
     resources: Record<string, ServerResource[]>;
     stale: MCPServerConnection[];
@@ -109,7 +109,7 @@ export declare function isToolFromMcpServer(toolName: string, serverName: string
  * @param tool The tool to check
  * @returns True if the tool is from an MCP server
  */
-export declare function isMcpTool(tool: Tool): boolean;
+export declare function isMcpTool(tool: Pick<ToolRuntime, 'name' | 'isMcp'>): boolean;
 /**
  * Checks if a command belongs to any MCP server
  * @param command The command to check

package/dist/capabilities/shell/posixShellDetection.d.ts

@@ -0,0 +1 @@
+export declare function findPosixShell(): Promise<string>;

package/dist/capabilities/shell/powershellDetection.d.ts

@@ -10,11 +10,6 @@
  * Windows/macOS, PATH is sufficient.
  */
 export declare function findPowerShell(): Promise<string | null>;
-/**
- * Gets the cached PowerShell path. Returns a memoized promise that
- * resolves to the PowerShell executable path or null.
- */
-export declare function getCachedPowerShellPath(): Promise<string | null>;
 export type PowerShellEdition = 'core' | 'desktop';
 /**
  * Infers the PowerShell edition from the binary name without spawning.
@@ -29,8 +24,4 @@ export type PowerShellEdition = 'core' | 'desktop';
  * the model doesn't emit `cmd1 && cmd2` on 5.1 (parser error) or avoid
  * `&&` on 7+ where it's the correct short-circuiting operator.
  */
-export declare function getPowerShellEdition(): Promise<PowerShellEdition | null>;
-/**
- * Resets the cached PowerShell path. Only for testing.
- */
-export declare function resetPowerShellCache(): void;
+export declare function inferPowerShellEdition(executablePath: string | null): PowerShellEdition | null;

package/dist/capabilities/shell/shellCapabilities.d.ts

@@ -0,0 +1,33 @@
+import type { Platform } from '../../lib/platform.js';
+import { type GitBashExecutable } from '../../lib/windowsPaths.js';
+import type { ShellType } from './shellProvider.js';
+export type ShellCapabilitySource = 'env' | 'standard-path' | 'path';
+export type ShellExecutable = {
+    type: ShellType;
+    path: string;
+    source: ShellCapabilitySource;
+};
+export type ShellCapabilities = {
+    platform: Platform;
+    defaultShell: ShellExecutable | null;
+    bash: ShellExecutable | null;
+    powershell: ShellExecutable | null;
+};
+export type ShellCapabilityDependencies = {
+    platform: () => Platform;
+    findGitBash: () => GitBashExecutable | null;
+    findPowerShell: () => Promise<string | null>;
+    findPosixShell: () => Promise<string>;
+    setProcessShell: (shellPath: string) => void;
+};
+export declare class ShellCapabilityError extends Error {
+    readonly code: 'NO_SHELL_AVAILABLE' | 'SHELL_NOT_AVAILABLE';
+    constructor(code: 'NO_SHELL_AVAILABLE' | 'SHELL_NOT_AVAILABLE', message: string);
+}
+export declare function detectShellCapabilities(dependencies?: ShellCapabilityDependencies): Promise<ShellCapabilities>;
+export declare function initializeShellCapabilities(): Promise<ShellCapabilities>;
+export declare function resolveShellCapability(capabilities: ShellCapabilities, type?: ShellType): ShellExecutable;
+export declare function requireDefaultShellCapability(): Promise<ShellExecutable>;
+export declare function requireShellCapability(type: ShellType): Promise<ShellExecutable>;
+/** Test-only reset for deterministic platform and PATH fixtures. */
+export declare function resetShellCapabilitiesForTest(): void;

package/dist/capabilities/shell/shellProvider.d.ts

@@ -1,6 +1,5 @@
 export declare const SHELL_TYPES: readonly ["bash", "powershell"];
 export type ShellType = (typeof SHELL_TYPES)[number];
-export declare const DEFAULT_HOOK_SHELL: ShellType;
 export type ShellProvider = {
     type: ShellType;
     shellPath: string;

package/dist/capabilities/shell/shellToolUtils.d.ts

@@ -1,11 +1 @@
 export declare const SHELL_TOOL_NAMES: string[];
-/**
- * Runtime gate for PowerShellTool. Windows-only (the permission engine uses
- * Win32-specific path normalizations). Ant defaults on (opt-out via env=0);
- * external defaults off (opt-in via env=1).
- *
- * Used by tools.ts (tool-list visibility), processBashCommand (! routing),
- * and promptShellExecution (skill frontmatter routing) so the gate is
- * consistent across all paths that invoke PowerShellTool.call().
- */
-export declare function isPowerShellToolEnabled(): boolean;