agent-afk 5.19.4 → 5.20.0

package/dist/agent/agents/builtins.d.ts

@@ -0,0 +1,2 @@
+import type { RegisteredAgent } from './types.js';
+export declare function builtinAgents(): Map<string, RegisteredAgent>;

package/dist/agent/agents/index.d.ts

@@ -0,0 +1,6 @@
+export type { AgentRegistry, AgentSource, RegisteredAgent, ResolvedAgentToolAccess, } from './types.js';
+export { parseAgentMarkdown, type ParsedAgentFile } from './parser.js';
+export { resolveAgentToolAccess } from './resolve.js';
+export { builtinAgents } from './builtins.js';
+export { loadAgentRegistry, type LoadAgentRegistryOptions } from './registry.js';
+export { buildAgentToolDef } from './tool-def.js';

package/dist/agent/agents/parser.d.ts

@@ -0,0 +1,8 @@
+import type { AgentDefinition } from '../types/sdk-types.js';
+export interface ParsedAgentFile {
+    name: string;
+    definition: AgentDefinition;
+    bashReadOnly?: boolean;
+    ignoredKeys?: string[];
+}
+export declare function parseAgentMarkdown(content: string, warn?: (message: string) => void): ParsedAgentFile | undefined;

package/dist/agent/agents/registry.d.ts

@@ -0,0 +1,8 @@
+import type { AgentDefinition } from '../types/sdk-types.js';
+import type { AgentRegistry } from './types.js';
+export interface LoadAgentRegistryOptions {
+    cwd?: string;
+    configAgents?: Record<string, AgentDefinition>;
+    warn?: (message: string) => void;
+}
+export declare function loadAgentRegistry(options?: LoadAgentRegistryOptions): AgentRegistry;

package/dist/agent/agents/resolve.d.ts

@@ -0,0 +1,2 @@
+import type { RegisteredAgent, ResolvedAgentToolAccess } from './types.js';
+export declare function resolveAgentToolAccess(agent: RegisteredAgent, inheritPool: readonly string[]): ResolvedAgentToolAccess;

package/dist/agent/agents/tool-def.d.ts

@@ -0,0 +1,3 @@
+import type { AnthropicToolDef } from '../tools/types.js';
+import type { AgentRegistry } from './types.js';
+export declare function buildAgentToolDef(registry: AgentRegistry | undefined): AnthropicToolDef;

package/dist/agent/agents/types.d.ts

@@ -0,0 +1,16 @@
+import type { AgentDefinition } from '../types/sdk-types.js';
+export type AgentSource = 'builtin' | 'user' | 'project' | 'config' | `plugin:${string}`;
+export interface RegisteredAgent {
+    name: string;
+    definition: AgentDefinition;
+    source: AgentSource;
+    filePath?: string;
+    bashReadOnly?: boolean;
+    ignoredKeys?: string[];
+}
+export type AgentRegistry = ReadonlyMap<string, RegisteredAgent>;
+export interface ResolvedAgentToolAccess {
+    allowedTools: string[] | undefined;
+    bashReadOnly: boolean;
+    droppedTokens: string[];
+}

package/dist/agent/tools/nesting.d.ts

@@ -6,6 +6,7 @@ import { SkillExecutor } from './skill-executor.js';
 import type { SubagentExecutor } from './subagent-executor.js';
 import type { TraceWriter } from '../trace/index.js';
 import type { BackgroundAgentRegistry } from '../background-registry.js';
+import type { AgentRegistry } from '../agents/types.js';
 export declare const DEFAULT_MAX_NESTING_DEPTH = 3;
 export interface ChildProviderFactoryArgs {
     childExecutor: SubagentExecutor;
@@ -18,12 +19,13 @@ export declare function createStubParentSession(signal: AbortSignal): Pick<IAgen
 export declare const CHILD_ALLOWED_TOOLS: string[];
 export declare const RECON_ALLOWED_TOOLS: readonly string[];
 export declare const DEFAULT_READ_ONLY_SKILLS: ReadonlySet<string>;
+export declare const DEFAULT_FORK_SKILLS: ReadonlySet<string>;
 export interface CreateChildProviderFactoryOptions {
     openaiBaseUrl?: string;
 }
 export declare function createChildProviderFactory(opts?: CreateChildProviderFactoryOptions): (args: ChildProviderFactoryArgs) => ModelProvider;
 export declare function buildReadOnlyReconProvider(model: AgentModelInput | undefined): ModelProvider;
-export declare function createChildSkillExecutorFactory(defaultModel: AgentModelInput, apiKey: string | undefined, childProviderFactory: (args: ChildProviderFactoryArgs) => ModelProvider, baseUrl?: string, traceWriter?: TraceWriter, backgroundRegistry?: BackgroundAgentRegistry, cwd?: string, resolveApiKeyForModel?: (model: string) => string | undefined, surface?: Surface, defaultSubagentModel?: AgentModelInput): (depth: number, maxDepth: number, signal: AbortSignal) => SkillExecutor;
+export declare function createChildSkillExecutorFactory(defaultModel: AgentModelInput, apiKey: string | undefined, childProviderFactory: (args: ChildProviderFactoryArgs) => ModelProvider, baseUrl?: string, traceWriter?: TraceWriter, backgroundRegistry?: BackgroundAgentRegistry, cwd?: string, resolveApiKeyForModel?: (model: string) => string | undefined, surface?: Surface, defaultSubagentModel?: AgentModelInput, agentRegistry?: AgentRegistry): (depth: number, maxDepth: number, signal: AbortSignal) => SkillExecutor;
 export type PhaseRole = 'read-only' | 'read-write';
-export declare function buildSkillRestrictedProvider(allowedTools: string[], model: AgentModelInput | undefined): ModelProvider;
+export declare function buildSkillRestrictedProvider(allowedTools: string[], model: AgentModelInput | undefined, readOnlyBash?: boolean): ModelProvider;
 export declare function buildPhaseRestrictedProvider(_role: 'read-only', model: AgentModelInput | undefined): ModelProvider;

package/dist/agent/tools/skill-executor.d.ts

@@ -22,6 +22,7 @@ export interface SkillExecutorContext {
     traceWriter?: TraceWriter;
     backgroundRegistry?: BackgroundAgentRegistry;
     cwd?: string;
+    agentRegistry?: import('../agents/index.js').AgentRegistry;
 }
 export declare class SkillExecutor {
     private readonly ctx;

package/dist/agent/tools/subagent-executor.d.ts

@@ -3,8 +3,9 @@ import { BackgroundAgentRegistry } from '../background-registry.js';
 import type { ModelProvider } from '../provider.js';
 import type { AgentModelInput, IAgentSession } from '../types.js';
 import type { AgentConfig } from '../types/config-types.js';
-import type { ToolCall, ToolResult } from './types.js';
+import type { AnthropicToolDef, ToolCall, ToolResult } from './types.js';
 import { type ChildProviderFactoryArgs } from './nesting.js';
+import type { AgentRegistry } from '../agents/index.js';
 import type { SkillExecutor } from './skill-executor.js';
 import type { Surface } from '../awareness/types.js';
 export { DEFAULT_MAX_NESTING_DEPTH, type ChildProviderFactoryArgs } from './nesting.js';
@@ -23,6 +24,8 @@ export interface SubagentExecutorContext {
     cwd?: string;
     allowedTools?: string[];
     readOnlyBash?: boolean;
+    agentRegistry?: AgentRegistry;
+    parentModel?: AgentModelInput;
 }
 export type AgentExecutionMode = 'foreground' | 'background';
 export interface PromotedSubagentInfo {
@@ -40,6 +43,7 @@ export declare class SubagentExecutor implements SubagentControl {
     private currentCwd;
     constructor(ctx: SubagentExecutorContext);
     setCwd(cwd: string): void;
+    describeAgentTool(): AnthropicToolDef;
     private readonly promotionTriggers;
     private readonly activeForegroundHandles;
     hasPromotableForeground(): boolean;