agent-afk 5.50.0 → 5.51.1

package/dist/agent/default-hook-registry.d.ts

@@ -22,4 +22,5 @@ export declare function createDefaultHookRegistry(onSubagentComplete?: (info: Su
     cwd?: string;
     sessionId?: string;
     traceWriter?: TraceWriter;
+    afkPromptForApproval?: boolean;
 }, getCwd?: () => string | undefined): DefaultHookRegistryResult;

package/dist/agent/hooks/command-executor.d.ts

@@ -5,6 +5,7 @@ export interface ExecuteCommandOptions {
     agentCwd: string;
     sessionId?: string;
     timeoutMs: number;
+    pluginRoot?: string;
 }
 export interface CommandExecutorResult {
     decision: HookDecision;

package/dist/agent/hooks/config-loader.d.ts

@@ -14,17 +14,19 @@ export interface ResolvedCommandHook {
     type: 'command';
     command: string;
     timeoutMs: number;
+    pluginRoot?: string;
 }
 export interface ResolvedMatcherGroup {
     matcher?: string;
     hooks: ResolvedCommandHook[];
-    tier?: 'user-global' | 'project-local';
+    tier?: 'user-global' | 'project-local' | 'plugin';
 }
 export type ResolvedHooksConfig = Partial<Record<HarnessHookEvent, ResolvedMatcherGroup[]>>;
 export interface LoadedHooksConfig {
     hooks: ResolvedHooksConfig;
     userGlobalEnabled: boolean;
     allowProjectHooks: boolean;
+    pluginHooksEnabled: boolean;
     sources: string[];
     warnings: string[];
 }
@@ -33,12 +35,18 @@ interface SingleFileResult {
     hooks: ResolvedHooksConfig;
     enableShellHooks: boolean;
     allowProjectHooks: boolean;
+    enablePluginHooks: boolean;
     sources: string[];
     warnings: string[];
 }
-export declare function loadHooksConfigFile(path: string, tier: 'user-global' | 'project-local'): SingleFileResult;
+export declare function loadHooksConfigFile(path: string, tier: 'user-global' | 'project-local' | 'plugin', pluginRoot?: string): SingleFileResult;
+export declare function discoverPluginHooksConfigs(pluginsRoot?: string): Array<{
+    path: string;
+    pluginRoot: string;
+}>;
 export interface LoadHooksConfigOptions {
     cwd?: string;
+    pluginsDir?: string;
 }
 export declare function loadHooksConfig(opts?: LoadHooksConfigOptions): LoadedHooksConfig;
 export {};

package/dist/agent/subagent.d.ts

@@ -14,6 +14,7 @@ export type { SubagentStatus, SubagentResult, SubagentTrace, SubagentHandle };
 export declare const DENY_ELICITATION: NonNullable<AgentConfig['onElicitation']>;
 export declare const SUBAGENT_DEFAULT_MAX_TOOL_USE_ITERATIONS = 50;
 export declare const SUBAGENT_DEFAULT_TIMEOUT_MS: number;
+export declare function resolveSubagentTimeoutMs(): number;
 export declare const SUBAGENT_BACKGROUND_TIMEOUT_MS: number;
 export interface ForkParent {
     sessionId?: string;
@@ -26,6 +27,7 @@ export interface ForkSubagentOptions<T = unknown> {
     outputSchema?: ZodType<T>;
     agentType: string;
     parentId?: string;
+    promptHead?: string;
     denyElicitations?: boolean;
     phaseRole?: PhaseRole;
 }

package/dist/agent/trace/events.d.ts

@@ -96,6 +96,7 @@ export declare const HookDecisionPayloadSchema: z.ZodObject<{
         unrecognised: "unrecognised";
         decline: "decline";
         cancel: "cancel";
+        "hard-block": "hard-block";
     }>>;
 }, z.core.$strip>;
 export declare const SubagentStartedPayloadSchema: z.ZodObject<{
@@ -105,6 +106,8 @@ export declare const SubagentStartedPayloadSchema: z.ZodObject<{
     model: z.ZodString;
     allowedTools: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
     systemPromptHash: z.ZodOptional<z.ZodString>;
+    promptHead: z.ZodOptional<z.ZodString>;
+    agentType: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const SubagentSucceededPayloadSchema: z.ZodObject<{
     transition: z.ZodLiteral<"succeeded">;
@@ -121,6 +124,15 @@ export declare const SubagentFailedPayloadSchema: z.ZodObject<{
     errorClass: z.ZodString;
     errorMessage: z.ZodString;
     partialOutputBytes: z.ZodNumber;
+    failureClass: z.ZodOptional<z.ZodEnum<{
+        abort: "abort";
+        "policy-refusal": "policy-refusal";
+        timeout: "timeout";
+        "permission-denied": "permission-denied";
+        "hook-block": "hook-block";
+        "elicitation-declined": "elicitation-declined";
+        "denial-breaker": "denial-breaker";
+    }>>;
 }, z.core.$strip>;
 export declare const SubagentCancelledPayloadSchema: z.ZodObject<{
     transition: z.ZodLiteral<"cancelled">;
@@ -129,6 +141,7 @@ export declare const SubagentCancelledPayloadSchema: z.ZodObject<{
         cascade: "cascade";
         explicit: "explicit";
     }>;
+    timeout: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export declare const SubagentLifecyclePayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     transition: z.ZodLiteral<"started">;
@@ -137,6 +150,8 @@ export declare const SubagentLifecyclePayloadSchema: z.ZodDiscriminatedUnion<[z.
     model: z.ZodString;
     allowedTools: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
     systemPromptHash: z.ZodOptional<z.ZodString>;
+    promptHead: z.ZodOptional<z.ZodString>;
+    agentType: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     transition: z.ZodLiteral<"succeeded">;
     subagentId: z.ZodString;
@@ -151,6 +166,15 @@ export declare const SubagentLifecyclePayloadSchema: z.ZodDiscriminatedUnion<[z.
     errorClass: z.ZodString;
     errorMessage: z.ZodString;
     partialOutputBytes: z.ZodNumber;
+    failureClass: z.ZodOptional<z.ZodEnum<{
+        abort: "abort";
+        "policy-refusal": "policy-refusal";
+        timeout: "timeout";
+        "permission-denied": "permission-denied";
+        "hook-block": "hook-block";
+        "elicitation-declined": "elicitation-declined";
+        "denial-breaker": "denial-breaker";
+    }>>;
 }, z.core.$strip>, z.ZodObject<{
     transition: z.ZodLiteral<"cancelled">;
     subagentId: z.ZodString;
@@ -158,6 +182,7 @@ export declare const SubagentLifecyclePayloadSchema: z.ZodDiscriminatedUnion<[z.
         cascade: "cascade";
         explicit: "explicit";
     }>;
+    timeout: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>], "transition">;
 export declare const BackgroundAgentStartedPayloadSchema: z.ZodObject<{
     transition: z.ZodLiteral<"started">;
@@ -560,6 +585,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             unrecognised: "unrecognised";
             decline: "decline";
             cancel: "cancel";
+            "hard-block": "hard-block";
         }>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
@@ -571,6 +597,8 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         model: z.ZodString;
         allowedTools: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
         systemPromptHash: z.ZodOptional<z.ZodString>;
+        promptHead: z.ZodOptional<z.ZodString>;
+        agentType: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         transition: z.ZodLiteral<"succeeded">;
         subagentId: z.ZodString;
@@ -585,6 +613,15 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
         errorClass: z.ZodString;
         errorMessage: z.ZodString;
         partialOutputBytes: z.ZodNumber;
+        failureClass: z.ZodOptional<z.ZodEnum<{
+            abort: "abort";
+            "policy-refusal": "policy-refusal";
+            timeout: "timeout";
+            "permission-denied": "permission-denied";
+            "hook-block": "hook-block";
+            "elicitation-declined": "elicitation-declined";
+            "denial-breaker": "denial-breaker";
+        }>>;
     }, z.core.$strip>, z.ZodObject<{
         transition: z.ZodLiteral<"cancelled">;
         subagentId: z.ZodString;
@@ -592,6 +629,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             cascade: "cascade";
             explicit: "explicit";
         }>;
+        timeout: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>], "transition">;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"background_agent">;
@@ -854,6 +892,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             unrecognised: "unrecognised";
             decline: "decline";
             cancel: "cancel";
+            "hard-block": "hard-block";
         }>>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
@@ -867,6 +906,8 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         model: z.ZodString;
         allowedTools: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
         systemPromptHash: z.ZodOptional<z.ZodString>;
+        promptHead: z.ZodOptional<z.ZodString>;
+        agentType: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         transition: z.ZodLiteral<"succeeded">;
         subagentId: z.ZodString;
@@ -881,6 +922,15 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         errorClass: z.ZodString;
         errorMessage: z.ZodString;
         partialOutputBytes: z.ZodNumber;
+        failureClass: z.ZodOptional<z.ZodEnum<{
+            abort: "abort";
+            "policy-refusal": "policy-refusal";
+            timeout: "timeout";
+            "permission-denied": "permission-denied";
+            "hook-block": "hook-block";
+            "elicitation-declined": "elicitation-declined";
+            "denial-breaker": "denial-breaker";
+        }>>;
     }, z.core.$strip>, z.ZodObject<{
         transition: z.ZodLiteral<"cancelled">;
         subagentId: z.ZodString;
@@ -888,6 +938,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             cascade: "cascade";
             explicit: "explicit";
         }>;
+        timeout: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>], "transition">;
 }, z.core.$strip>, z.ZodObject<{
     ts: z.ZodString;

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

@@ -24,7 +24,7 @@ export interface ToolCallCompletedPayload {
 }
 export type ToolCallPayload = ToolCallStartedPayload | ToolCallCompletedPayload;
 export type HookEventName = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'SessionStart' | 'SessionEnd' | 'SubagentStart' | 'SubagentStop';
-export type AfkApprovalOutcome = 'approved' | 'denied' | 'unrecognised' | 'timeout' | 'decline' | 'cancel';
+export type AfkApprovalOutcome = 'approved' | 'denied' | 'unrecognised' | 'timeout' | 'decline' | 'cancel' | 'hard-block';
 export interface HookDecisionPayload {
     hookEvent: HookEventName;
     decision?: 'block' | 'approve';
@@ -41,6 +41,8 @@ export interface SubagentStartedPayload {
     model: string;
     allowedTools?: readonly string[];
     systemPromptHash?: string;
+    promptHead?: string;
+    agentType?: string;
 }
 export interface SubagentSucceededPayload {
     transition: 'succeeded';
@@ -57,11 +59,13 @@ export interface SubagentFailedPayload {
     errorClass: string;
     errorMessage: string;
     partialOutputBytes: number;
+    failureClass?: ToolFailureClass;
 }
 export interface SubagentCancelledPayload {
     transition: 'cancelled';
     subagentId: string;
     source: 'cascade' | 'explicit';
+    timeout?: boolean;
 }
 export type SubagentLifecyclePayload = SubagentStartedPayload | SubagentSucceededPayload | SubagentFailedPayload | SubagentCancelledPayload;
 export interface BackgroundAgentStartedPayload {

package/dist/cli/config/types.d.ts

@@ -55,6 +55,7 @@ export interface CliConfig {
     maxSummaryCallsPerSession?: number;
     hooks?: RawHooksConfig;
     enableShellHooks?: boolean;
+    enablePluginHooks?: boolean;
     importFrom?: ImportFromConfig;
 }
 export interface ModelSlotConfigEntry {
@@ -115,6 +116,7 @@ export interface ConfigFileSchema {
     maxSummaryCallsPerSession?: number;
     hooks?: RawHooksConfig;
     enableShellHooks?: boolean;
+    enablePluginHooks?: boolean;
     importFrom?: Partial<Record<ImportSourceBinary, boolean | {
         plugins?: boolean;
         skills?: boolean;