agent-afk 5.313.15 → 5.314.0

package/dist/agent/tools/handlers/witness.query.d.ts

@@ -1,4 +1,5 @@
 import type { TraceEvent } from '../../trace/index.js';
+import { type CurrentSessionRef, type WhereClause } from './witness.query.where.js';
 export declare const MAX_LIMIT = 200;
 export declare const MAX_SEARCH_MATCHES = 200;
 export declare function clampLimit(raw: unknown): number;
@@ -9,6 +10,7 @@ export interface ReadWitnessParams {
     toolName?: string;
     errorsOnly?: boolean;
     limit?: number;
+    where?: WhereClause;
 }
 export interface ReadWitnessResult {
     sessionId: string;
@@ -24,6 +26,9 @@ export interface SearchWitnessParams {
     kinds?: string[];
     since?: string;
     toolName?: string;
+    where?: WhereClause;
+    currentSession?: CurrentSessionRef;
+    includeCurrentSession?: boolean;
 }
 export interface SearchMatch {
     sessionId: string;
@@ -37,5 +42,8 @@ export interface SearchWitnessResult {
     sessionsScanned: number;
     matches: SearchMatch[];
     truncatedSessions?: string[];
+    matchLimitReached?: true;
+    hint?: string;
+    excludedCurrentSession?: true;
 }
 export declare function searchAcrossSessions(params: SearchWitnessParams): Promise<SearchWitnessResult>;

package/dist/agent/tools/handlers/witness.query.where.d.ts

@@ -0,0 +1,26 @@
+export type WhereScalar = string | number | boolean | null;
+export type WhereClause = ReadonlyArray<{
+    path: string;
+    segments: string[];
+    value: WhereScalar;
+}>;
+export declare class WitnessWhereError extends Error {
+    constructor(message: string);
+}
+export declare function parseWhere(raw: unknown): WhereClause | undefined;
+export declare function matchesWhere(event: unknown, where: WhereClause | undefined): boolean;
+export interface CurrentSessionRef {
+    tracePath?: string;
+    sessionId?: string;
+}
+export declare function isCurrentSession(entry: {
+    sessionId: string;
+    tracePath: string;
+}, current: CurrentSessionRef | undefined): boolean;
+export declare function currentSessionRef(ctx: {
+    traceWriter?: {
+        getTracePath(): string;
+    };
+    sessionId?: string;
+}): CurrentSessionRef | undefined;
+export declare const MATCH_LIMIT_HINT: string;

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

@@ -1,7 +1,8 @@
-import type { AbortPayload, BackgroundAgentPayload, BrowserEventPayload, BudgetPayload, ClaimPayload, ClosurePayload, CompactionPayloadInput, HookDecisionPayload, PeerMessagePayload, QueuedUserMessagePayload, SessionPhasePayload, SubagentLifecyclePayload, ToolCallPayload } from './types.js';
+import type { AbortPayload, BackgroundAgentPayload, BrowserEventPayload, BudgetPayload, ClaimPayload, ClosurePayload, CompactionPayloadInput, HookDecisionPayload, HookSummaryPayload, PeerMessagePayload, QueuedUserMessagePayload, SessionPhasePayload, SubagentLifecyclePayload, ToolCallPayload } from './types.js';
 import type { TraceSink } from './writer.js';
 export declare const emitToolCall: (w: TraceSink | undefined, p: ToolCallPayload) => Promise<void>;
 export declare const emitHookDecision: (w: TraceSink | undefined, p: HookDecisionPayload) => Promise<void>;
+export declare const emitHookSummary: (w: TraceSink | undefined, p: HookSummaryPayload) => Promise<void>;
 export declare const emitSubagentLifecycle: (w: TraceSink | undefined, p: SubagentLifecyclePayload) => Promise<void>;
 export declare const emitBackgroundAgent: (w: TraceSink | undefined, p: BackgroundAgentPayload) => Promise<void>;
 export declare const emitBudget: (w: TraceSink | undefined, p: BudgetPayload) => Promise<void>;

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

@@ -115,6 +115,12 @@ export declare const HookDecisionPayloadSchema: z.ZodObject<{
         "hard-block": "hard-block";
     }>>;
 }, z.core.$strip>;
+export declare const HookSummaryPayloadSchema: z.ZodObject<{
+    scope: z.ZodLiteral<"root-session-including-subagents">;
+    counts: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    written: z.ZodNumber;
+    suppressed: z.ZodNumber;
+}, z.core.$strip>;
 export declare const BackgroundAgentPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     transition: z.ZodLiteral<"started">;
     jobId: z.ZodString;
@@ -335,6 +341,14 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             "hard-block": "hard-block";
         }>>;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"hook_summary">;
+    payload: z.ZodObject<{
+        scope: z.ZodLiteral<"root-session-including-subagents">;
+        counts: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        written: z.ZodNumber;
+        suppressed: z.ZodNumber;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"subagent_lifecycle">;
     payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -730,6 +744,16 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "hard-block": "hard-block";
         }>>;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    ts: z.ZodString;
+    seq: z.ZodNumber;
+    kind: z.ZodLiteral<"hook_summary">;
+    payload: z.ZodObject<{
+        scope: z.ZodLiteral<"root-session-including-subagents">;
+        counts: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        written: z.ZodNumber;
+        suppressed: z.ZodNumber;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     ts: z.ZodString;
     seq: z.ZodNumber;

package/dist/agent/trace/hook-tally.d.ts

@@ -0,0 +1,8 @@
+import type { HookDecisionPayload, HookSummaryPayload } from './types.js';
+import type { TraceSink } from './writer.js';
+export interface HookTallyAliasedSink extends TraceSink {
+    readonly hookTallyKey: TraceSink;
+}
+export declare function isInformativeHookDecision(p: HookDecisionPayload): boolean;
+export declare function recordHookDecision(writer: TraceSink, p: HookDecisionPayload, written: boolean): void;
+export declare function takeHookSummary(writer: TraceSink): HookSummaryPayload | undefined;

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

@@ -1,4 +1,4 @@
-export type TraceEventKind = 'tool_call' | 'hook_decision' | 'subagent_lifecycle' | 'background_agent' | 'budget' | 'abort' | 'compaction' | 'closure' | 'claim' | 'browser_event' | 'queued_user_message' | 'peer_message' | 'session_phase' | 'session_sealed';
+export type TraceEventKind = 'tool_call' | 'hook_decision' | 'hook_summary' | 'subagent_lifecycle' | 'background_agent' | 'budget' | 'abort' | 'compaction' | 'closure' | 'claim' | 'browser_event' | 'queued_user_message' | 'peer_message' | 'session_phase' | 'session_sealed';
 export interface ToolCallStartedPayload {
     phase: 'started';
     toolUseId: string;
@@ -42,6 +42,12 @@ export interface HookDecisionPayload {
     durationMs?: number;
     approvalOutcome?: AfkApprovalOutcome;
 }
+export interface HookSummaryPayload {
+    scope: 'root-session-including-subagents';
+    counts: Record<string, Record<string, number>>;
+    written: number;
+    suppressed: number;
+}
 export interface SubagentStartedPayload {
     transition: 'started';
     subagentId: string;
@@ -216,6 +222,9 @@ export type TraceEventInput = {
 } | {
     kind: 'hook_decision';
     payload: HookDecisionPayload;
+} | {
+    kind: 'hook_summary';
+    payload: HookSummaryPayload;
 } | {
     kind: 'subagent_lifecycle';
     payload: SubagentLifecyclePayload;
@@ -260,6 +269,11 @@ export type TraceEvent = {
     seq: number;
     kind: 'hook_decision';
     payload: HookDecisionPayload;
+} | {
+    ts: string;
+    seq: number;
+    kind: 'hook_summary';
+    payload: HookSummaryPayload;
 } | {
     ts: string;
     seq: number;