agent-relay 4.0.18 → 4.0.20

package/packages/hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/hooks",
-  "version": "4.0.18",
+  "version": "4.0.20",
   "description": "Hook emitter, registry, and trajectory hooks for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -37,9 +37,9 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/config": "4.0.18",
-    "@agent-relay/trajectory": "4.0.18",
-    "@agent-relay/sdk": "4.0.18"
+    "@agent-relay/config": "4.0.20",
+    "@agent-relay/trajectory": "4.0.20",
+    "@agent-relay/sdk": "4.0.20"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/sdk/dist/workflows/trajectory.d.ts

@@ -1,15 +1,3 @@
-/**
- * WorkflowTrajectory — records a structured trajectory for each workflow run.
- *
- * Writes trajectory JSON files directly to `.trajectories/active/` in a format
- * compatible with `trail show`. No external CLI or package dependency required.
- *
- * Design principles:
- *   1. One trajectory per workflow run
- *   2. Chapters map to workflow phases, not individual steps
- *   3. Non-blocking — trajectory recording never fails the workflow
- *   4. Opt-in but default-on
- */
 import type { StepCompletionDecision, TrajectoryConfig, WorkflowStep } from './types.js';
 interface StepParticipants {
     role?: string;
@@ -25,36 +13,27 @@ export interface StepOutcome {
     output?: string;
     error?: string;
     verificationPassed?: boolean;
-    /** Sentinel value the step was verifying for, if any. */
     verificationValue?: string;
-    /** Whether this was a non-interactive (subprocess) step. */
     nonInteractive?: boolean;
-    /** Duration in ms. */
     durationMs?: number;
-    /** How the step completion was determined. */
     completionMode?: StepCompletionDecision['mode'];
 }
 export declare class WorkflowTrajectory {
     private trajectory;
-    private currentChapterId;
+    private storage?;
+    private storageInit?;
     private readonly enabled;
     private readonly reflectOnBarriers;
     private readonly reflectOnConverge;
     private readonly autoDecisions;
-    private readonly dataDir;
+    private readonly storageBaseDir;
     private readonly runId;
     private startTime;
     private swarmPattern;
     constructor(config: TrajectoryConfig | false | undefined, runId: string, cwd: string);
-    /** Start the trajectory (called at run:started). */
     start(workflowName: string, stepCount: number, trackInfo?: string, description?: string, pattern?: string): Promise<void>;
-    /** Begin a new parallel track chapter. */
     beginTrack(trackName: string): Promise<void>;
-    /** Begin a convergence chapter (after barrier/parallel completion). */
     beginConvergence(label: string): Promise<void>;
-    /** Begin the retrospective chapter. */
-    private openRetrospective;
-    /** Record step started — captures intent, not just assignment. */
     stepStarted(step: WorkflowStep, agent: string, participants?: StepParticipants): Promise<void>;
     registerAgent(name: string, role: string): Promise<void>;
     stepSupervisionAssigned(step: WorkflowStep, supervised: {
@@ -71,26 +50,17 @@ export declare class WorkflowTrajectory {
     ownerMonitoringEvent(stepName: string, owner: string, detail: string, raw?: Record<string, unknown>): Promise<void>;
     reviewCompleted(stepName: string, reviewerName: string, decision: 'approved' | 'rejected', reason?: string): Promise<void>;
     stepCompletionDecision(stepName: string, decision: StepCompletionDecision): Promise<void>;
-    /** Record step completed — captures what was accomplished. */
     stepCompleted(step: WorkflowStep, output: string, attempt: number, decision?: StepCompletionDecision): Promise<void>;
-    /** Record step failed — categorizes root cause for actionable diagnosis. */
     stepFailed(step: WorkflowStep, error: string, attempt: number, maxRetries: number, outcome?: Partial<StepOutcome>): Promise<void>;
-    /** Record step skipped — note the cascade impact. */
     stepSkipped(step: WorkflowStep, reason: string): Promise<void>;
-    /** Record step retrying. */
     stepRetrying(step: WorkflowStep, attempt: number, maxRetries: number): Promise<void>;
-    /** Record a reflection at a convergence point. */
     reflect(synthesis: string, confidence: number, focalPoints?: string[]): Promise<void>;
-    /** Synthesize and reflect after a set of steps complete (barrier or parallel convergence). */
     synthesizeAndReflect(label: string, outcomes: StepOutcome[], unblocks?: string[]): Promise<void>;
-    /** Record an orchestrator decision. */
     decide(question: string, chosen: string, reasoning: string): Promise<void>;
-    /** Complete the trajectory with a summary. */
     complete(summary: string, confidence: number, meta?: {
         learnings?: string[];
         challenges?: string[];
     }): Promise<void>;
-    /** Abandon the trajectory. */
     abandon(reason: string, meta?: {
         summary?: string;
         confidence?: number;
@@ -107,11 +77,11 @@ export declare class WorkflowTrajectory {
     extractLearnings(outcomes: StepOutcome[]): string[];
     extractChallenges(outcomes: StepOutcome[]): string[];
     private openChapter;
-    private closeCurrentChapter;
     private addEvent;
+    private buildApproach;
     private formatCompletionEvidenceSummary;
+    private ensureStorage;
     private flush;
-    private moveToCompleted;
 }
 export {};
 //# sourceMappingURL=trajectory.d.ts.map

package/packages/sdk/dist/workflows/trajectory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/workflows/trajectory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/workflows/trajectory.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzF,UAAU,gBAAgB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;CACjD;AAuHD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,gBAAgB,GAAG,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAW9E,KAAK,CACT,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAyBV,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9F,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD,uBAAuB,CAC3B,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,QAAQ,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GACjG,OAAO,CAAC,IAAI,CAAC;IAmBV,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;IAWV,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,UAAU,GAAG,UAAU,EACjC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAWV,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAczF,aAAa,CACjB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC;IAoBV,UAAU,CACd,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAqBV,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpF,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrF,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACrD,OAAO,CAAC,IAAI,CAAC;IAkBV,OAAO,CACX,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC5F,OAAO,CAAC,IAAI,CAAC;IAuBhB,SAAS,IAAI,OAAO;IAGpB,uBAAuB,IAAI,OAAO;IAGlC,uBAAuB,IAAI,OAAO;IAGlC,eAAe,IAAI,MAAM,GAAG,IAAI;IAGhC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAGnF,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAGlD,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAGhD,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE;IAGnD,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE;IAIpD,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,+BAA+B;YAazB,aAAa;YAMb,KAAK;CASpB"}