@opencow-ai/opencow-agent-sdk 0.4.19 → 0.4.20

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

@@ -1,5 +1,8 @@
+import { type ToolInputJSONSchema } from '../../../types/toolRuntime.js';
+import type { Message as MessageType } from 'src/types/message.js';
 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;
@@ -19,10 +22,8 @@ export declare const inputSchema: () => z.ZodObject<{
     }>>;
     team_name: z.ZodOptional<z.ZodString>;
     subagent_type: z.ZodOptional<z.ZodString>;
-    isolation: z.ZodOptional<z.ZodEnum<{
-        worktree: "worktree";
-    }>>;
 }, z.core.$strip>;
+type InputSchema = ReturnType<typeof inputSchema>;
 export declare const outputSchema: () => z.ZodUnion<readonly [z.ZodObject<{
     agentId: z.ZodString;
     agentType: z.ZodOptional<z.ZodString>;
@@ -72,7 +73,50 @@ export type RemoteLaunchedOutput = {
 };
 import type { AgentToolProgress, ShellProgress } from '../../../types/tools.js';
 export type Progress = AgentToolProgress | ShellProgress;
-export declare const AgentTool: Omit<Omit<import("../../../types/toolRuntime.js").ToolRuntime<any, any, any>, "isEnabled" | "isConcurrencySafe" | "isReadOnly" | "isDestructive" | "checkPermissions" | "toAutoClassifierInput" | "userFacingName"> & Partial<Pick<import("../../../types/toolRuntime.js").ToolRuntime<any, any, any>, "isEnabled" | "isConcurrencySafe" | "isReadOnly" | "isDestructive" | "checkPermissions" | "toAutoClassifierInput" | "userFacingName">>, "isEnabled" | "isConcurrencySafe" | "isReadOnly" | "isDestructive" | "checkPermissions" | "toAutoClassifierInput" | "userFacingName"> & {
+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>;
+    strict?: boolean;
+    aliases?: string[];
+    searchHint?: string;
+    mcpInfo?: {
+        serverName: string;
+        toolName: string;
+    };
+    isMcp?: boolean;
+    isLsp?: boolean;
+    shouldDefer?: boolean;
+    alwaysLoad?: boolean;
+    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>;
+    backfillObservableInput?: (input: Record<string, unknown>) => void;
+    inputsEquivalent?: (a: any, b: any) => boolean;
+    getPath?: (input: any) => string;
+    preparePermissionMatcher?: (input: any) => Promise<(pattern: string) => boolean>;
+    isOpenWorld?: (input: any) => boolean;
+    requiresUserInteraction?: () => boolean;
+    isSearchOrReadCommand?: (input: any) => {
+        isSearch: boolean;
+        isRead: boolean;
+        isList?: boolean;
+    };
+    interruptBehavior?: () => "cancel" | "block";
+    maxResultSizeChars: number;
+    mapToolResultToToolResultBlockParam: (content: any, toolUseID: string) => import("../../../session/canonical/types.js").CanonicalToolResultBlockParam;
+    extractSearchText?: (out: any) => string;
     isEnabled: () => boolean;
     isConcurrencySafe: (_input?: unknown) => boolean;
     isReadOnly: (_input?: unknown) => boolean;
@@ -83,3 +127,4 @@ export declare const AgentTool: Omit<Omit<import("../../../types/toolRuntime.js"
     toAutoClassifierInput: (_input?: unknown) => string;
     userFacingName: (_input?: unknown) => string;
 };
+export {};

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

@@ -0,0 +1,7 @@
+type AssistantMessageLike = {
+    message?: {
+        content?: unknown;
+    };
+};
+export declare function findEarlierDuplicateAgentToolUse(assistantMessage: AssistantMessageLike | undefined, currentToolUseId: string | undefined): string | undefined;
+export {};

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

@@ -0,0 +1,36 @@
+import { z } from 'zod/v4';
+export declare const baseInputSchema: () => z.ZodObject<{
+    description: z.ZodString;
+    prompt: z.ZodString;
+    subagent_type: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodEnum<{
+        haiku: "haiku";
+        sonnet: "sonnet";
+        opus: "opus";
+    }>>;
+    run_in_background: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function buildAgentInputSchema(options: {
+    worktreeIsolationAvailable: boolean;
+    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";
+        auto: "auto";
+    }>>;
+    prompt: z.ZodString;
+    model: z.ZodOptional<z.ZodEnum<{
+        haiku: "haiku";
+        sonnet: "sonnet";
+        opus: "opus";
+    }>>;
+    team_name: z.ZodOptional<z.ZodString>;
+    subagent_type: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

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

@@ -0,0 +1,4 @@
+import type { WorktreeUnavailableReason } from '../../worktreeAvailability.js';
+export declare const WORKTREE_ISOLATION_SCHEMA_DESCRIPTION = "Isolation mode. Set \"worktree\" only when the user explicitly requests worktree isolation. It requires a Git repository with a resolvable HEAD commit or a configured WorktreeCreate hook; omit it for ordinary tasks, including read-only research.";
+export declare const WORKTREE_ISOLATION_USAGE_GUIDANCE = "Only set `isolation: \"worktree\"` when the user explicitly requests worktree isolation. Omit it for ordinary tasks, including read-only research. Worktree isolation requires a Git repository with a resolvable HEAD commit or a configured WorktreeCreate hook.";
+export declare function getWorktreeIsolationUnavailableMessage(reason: WorktreeUnavailableReason): string;

package/dist/capabilities/worktree.d.ts

@@ -86,6 +86,16 @@ export declare function createAgentWorktree(slug: string): Promise<{
     gitRoot?: string;
     hookBased?: boolean;
 }>;
+/**
+ * Whether AgentTool can safely advertise worktree isolation for the current
+ * query. Hook-based worktrees do not require Git; the built-in path requires
+ * both a repository and a resolvable base commit.
+ */
+export declare function isAgentWorktreeIsolationAvailable(options?: {
+    cwd?: string;
+    hasCreateHook?: boolean;
+    gitAvailabilityCache?: Map<string, boolean>;
+}): boolean;
 /**
  * Remove a worktree created by createAgentWorktree.
  * For git-based worktrees, removes the worktree directory and deletes the temporary branch.

package/dist/capabilities/worktreeAvailability.d.ts

@@ -0,0 +1,20 @@
+export type WorktreeUnavailableReason = 'not_git_repository' | 'unborn_head' | 'git_unavailable';
+export type GitWorktreeAvailability = {
+    available: true;
+    gitRoot: string;
+    headCommit: string;
+} | {
+    available: false;
+    reason: WorktreeUnavailableReason;
+};
+export declare class WorktreeUnavailableError extends Error {
+    readonly reason: WorktreeUnavailableReason;
+    constructor(reason: WorktreeUnavailableReason);
+}
+/** Resolve Git worktree prerequisites using Git itself as the authority. */
+export declare function resolveGitWorktreeAvailability(cwd: string, gitExecutable?: string): GitWorktreeAvailability;
+/**
+ * Check the built-in Git worktree prerequisites without creating anything.
+ * An optional caller-owned cache keeps lifecycle and invalidation explicit.
+ */
+export declare function isGitWorktreeIsolationAvailable(cwd: string, gitExecutable?: string, cache?: Map<string, boolean>): boolean;