agent-relay 2.0.29 → 2.0.32

package/packages/hooks/src/trajectory-hooks.ts

@@ -0,0 +1,251 @@
+/**
+ * Trajectory Hooks
+ *
+ * Provides trajectory tracking hooks that integrate with the PDERO paradigm.
+ * These hooks automatically track agent work when registered with a HookRegistry.
+ */
+
+import type {
+  LifecycleHooks,
+  SessionStartContext,
+  SessionEndContext,
+  OutputContext,
+  MessageReceivedContext,
+  MessageSentContext,
+  HookResult,
+} from './types.js';
+import {
+  TrajectoryIntegration,
+  getTrajectoryIntegration,
+  detectPhaseFromContent,
+  detectToolCalls,
+  detectErrors,
+  getCompactTrailInstructions,
+  type PDEROPhase,
+} from '@agent-relay/trajectory';
+
+/**
+ * Options for trajectory hooks
+ */
+export interface TrajectoryHooksOptions {
+  /** Project identifier */
+  projectId: string;
+  /** Agent name */
+  agentName: string;
+  /** Whether to auto-detect phase transitions */
+  autoDetectPhase?: boolean;
+  /** Whether to detect and record tool calls */
+  detectTools?: boolean;
+  /** Whether to detect and record errors */
+  detectErrors?: boolean;
+  /** Whether to inject trail instructions on session start */
+  injectInstructions?: boolean;
+  /** Whether to prompt for retrospective on session end */
+  promptRetrospective?: boolean;
+}
+
+/**
+ * State for trajectory hooks
+ */
+interface TrajectoryHooksState {
+  trajectory: TrajectoryIntegration;
+  lastDetectedPhase?: PDEROPhase;
+  /** Set of tool calls already recorded to avoid duplicates */
+  seenTools: Set<string>;
+  /** Set of errors already recorded to avoid duplicates */
+  seenErrors: Set<string>;
+  options: TrajectoryHooksOptions;
+}
+
+/**
+ * Create trajectory hooks for automatic PDERO tracking
+ *
+ * @example
+ * ```typescript
+ * const hooks = createTrajectoryHooks({
+ *   projectId: 'my-project',
+ *   agentName: 'Alice',
+ * });
+ *
+ * registry.registerLifecycleHooks(hooks);
+ * ```
+ */
+export function createTrajectoryHooks(options: TrajectoryHooksOptions): LifecycleHooks {
+  const state: TrajectoryHooksState = {
+    trajectory: getTrajectoryIntegration(options.projectId, options.agentName),
+    seenTools: new Set<string>(),
+    seenErrors: new Set<string>(),
+    options: {
+      autoDetectPhase: true,
+      detectTools: true,
+      detectErrors: true,
+      injectInstructions: true,
+      promptRetrospective: true,
+      ...options,
+    },
+  };
+
+  return {
+    onSessionStart: createSessionStartHook(state),
+    onSessionEnd: createSessionEndHook(state),
+    onOutput: createOutputHook(state),
+    onMessageReceived: createMessageReceivedHook(state),
+    onMessageSent: createMessageSentHook(state),
+  };
+}
+
+/**
+ * Session start hook - initializes trajectory tracking
+ */
+function createSessionStartHook(state: TrajectoryHooksState) {
+  return async (ctx: SessionStartContext): Promise<HookResult | void> => {
+    const { trajectory, options } = state;
+
+    // Initialize trajectory with task if provided
+    if (ctx.task) {
+      const success = await trajectory.initialize(ctx.task, ctx.taskId, ctx.taskSource);
+      if (success) {
+        console.log(`[trajectory] Started tracking: ${ctx.task}`);
+      }
+    } else {
+      await trajectory.initialize();
+    }
+
+    // Inject trail instructions if enabled and trail is available
+    if (options.injectInstructions && trajectory.isTrailInstalledSync()) {
+      const instructions = getCompactTrailInstructions();
+      return { inject: `\n${instructions}\n` };
+    }
+  };
+}
+
+/**
+ * Session end hook - completes or abandons trajectory
+ */
+function createSessionEndHook(state: TrajectoryHooksState) {
+  return async (ctx: SessionEndContext): Promise<HookResult | void> => {
+    const { trajectory, options } = state;
+
+    if (!trajectory.hasActiveTrajectory()) {
+      return;
+    }
+
+    if (ctx.graceful) {
+      // Prompt for retrospective if enabled
+      if (options.promptRetrospective) {
+        const durationSeconds = Math.round(ctx.duration / 1000);
+        const result: HookResult = {
+          inject: `
+[SESSION ENDING]
+Complete your trajectory with a summary:
+  trail complete --summary "What you accomplished" --confidence 0.9
+
+Or if you need to document learnings:
+  trail decision "Key choice" --reasoning "Why"
+`,
+        };
+
+        // Also complete the trajectory
+        await trajectory.complete({
+          summary: `Session ended after ${durationSeconds}s`,
+        });
+
+        return result;
+      } else {
+        await trajectory.complete({
+          summary: `Session ended gracefully`,
+        });
+      }
+    } else {
+      await trajectory.abandon('Session terminated');
+    }
+  };
+}
+
+/**
+ * Output hook - auto-detects PDERO phase transitions, tool calls, and errors
+ */
+function createOutputHook(state: TrajectoryHooksState) {
+  return async (ctx: OutputContext): Promise<HookResult | void> => {
+    const { trajectory, options } = state;
+
+    // Detect and record phase transitions
+    if (options.autoDetectPhase) {
+      const detectedPhase = detectPhaseFromContent(ctx.content);
+
+      if (detectedPhase && detectedPhase !== state.lastDetectedPhase) {
+        state.lastDetectedPhase = detectedPhase;
+        await trajectory.transition(detectedPhase, 'Auto-detected from output');
+      }
+    }
+
+    // Detect and record tool calls
+    // Note: We deduplicate by tool+status to record each unique tool type once per session
+    // (e.g., "Read" started, "Read" completed). This provides a summary of tools used
+    // without flooding the trajectory with every individual invocation.
+    if (options.detectTools) {
+      const tools = detectToolCalls(ctx.content);
+      for (const tool of tools) {
+        const key = `${tool.tool}:${tool.status || 'started'}`;
+        if (!state.seenTools.has(key)) {
+          state.seenTools.add(key);
+          const statusLabel = tool.status === 'completed' ? ' (completed)' : '';
+          await trajectory.event(`Tool: ${tool.tool}${statusLabel}`, 'tool_call');
+        }
+      }
+    }
+
+    // Detect and record errors
+    if (options.detectErrors) {
+      const errors = detectErrors(ctx.content);
+      for (const error of errors) {
+        // Deduplicate by message content
+        if (!state.seenErrors.has(error.message)) {
+          state.seenErrors.add(error.message);
+          const prefix = error.type === 'warning' ? 'Warning' : 'Error';
+          await trajectory.event(`${prefix}: ${error.message}`, 'error');
+        }
+      }
+    }
+  };
+}
+
+/**
+ * Message received hook - records incoming messages
+ */
+function createMessageReceivedHook(state: TrajectoryHooksState) {
+  return async (ctx: MessageReceivedContext): Promise<HookResult | void> => {
+    const { trajectory, options } = state;
+
+    await trajectory.message('received', ctx.from, options.agentName, ctx.body);
+  };
+}
+
+/**
+ * Message sent hook - records outgoing messages
+ */
+function createMessageSentHook(state: TrajectoryHooksState) {
+  return async (ctx: MessageSentContext): Promise<HookResult | void> => {
+    const { trajectory, options } = state;
+
+    await trajectory.message('sent', options.agentName, ctx.to, ctx.body);
+  };
+}
+
+/**
+ * Get trajectory hooks for a project/agent combination
+ *
+ * This is a convenience function that creates trajectory hooks
+ * with default options.
+ */
+export function getTrajectoryHooks(projectId: string, agentName: string): LifecycleHooks {
+  return createTrajectoryHooks({ projectId, agentName });
+}
+
+/**
+ * Utility to check if trajectory tracking is available
+ */
+export function isTrajectoryTrackingAvailable(projectId: string, agentName: string): boolean {
+  const trajectory = getTrajectoryIntegration(projectId, agentName);
+  return trajectory.isTrailInstalledSync();
+}

package/packages/hooks/src/types.ts

@@ -0,0 +1,342 @@
+/**
+ * Agent Relay Hook Types
+ *
+ * Core types for the agent-relay hooks system. Hooks allow agents to intercept
+ * and modify behavior at various points in the agent lifecycle.
+ */
+
+import type { SendPayload } from '@agent-relay/protocol/types';
+import { PROTOCOL_VERSION } from '@agent-relay/protocol';
+
+/**
+ * A message in the conversation history
+ */
+export interface ConversationMessage {
+  /** Role of the message sender */
+  role: 'user' | 'assistant' | 'system';
+  /** Message content */
+  content: string;
+  /** Timestamp when the message was created */
+  timestamp?: number;
+}
+
+/**
+ * Output from the agent (tool calls, responses, etc.)
+ */
+export interface AgentOutput {
+  /** Type of output */
+  type: 'text' | 'tool_call' | 'tool_result';
+  /** Content of the output */
+  content: string;
+  /** Tool name if type is tool_call or tool_result */
+  tool?: string;
+  /** Timestamp of the output */
+  timestamp: number;
+}
+
+/**
+ * Memory interface for persisting data across hook invocations
+ */
+export interface HookMemory {
+  /** Get a value from memory */
+  get<T = unknown>(key: string): T | undefined;
+  /** Set a value in memory */
+  set<T = unknown>(key: string, value: T): void;
+  /** Delete a value from memory */
+  delete(key: string): boolean;
+  /** Check if a key exists */
+  has(key: string): boolean;
+  /** Clear all memory */
+  clear(): void;
+}
+
+/**
+ * Relay interface for sending messages to other agents
+ */
+export interface HookRelay {
+  /** Send a message to a specific agent or broadcast */
+  send(to: string | '*', body: string, options?: Partial<SendPayload>): Promise<void>;
+  /** Check if connected to the relay daemon */
+  isConnected(): boolean;
+  /** Get the current agent's name in the relay */
+  getAgentName(): string | undefined;
+}
+
+/**
+ * Context provided to hooks during execution
+ *
+ * This interface provides hooks with access to the current execution context,
+ * allowing them to inspect and modify agent behavior.
+ */
+export interface HookContext {
+  /** Unique identifier for this agent instance */
+  agentId: string;
+
+  /** Session identifier for the current conversation */
+  sessionId: string;
+
+  /** Working directory of the agent */
+  workingDir: string;
+
+  /** Environment variables available to the hook */
+  env: Record<string, string | undefined>;
+
+  /**
+   * Inject content into the agent's input stream.
+   * This content will be processed as if it came from the user.
+   * @param content - The content to inject
+   */
+  inject(content: string): void;
+
+  /**
+   * Send a message through the relay to other agents.
+   * @param to - Target agent name or '*' for broadcast
+   * @param body - Message body
+   * @param options - Optional message options
+   */
+  send(to: string | '*', body: string, options?: Partial<SendPayload>): Promise<void>;
+
+  /** Persistent memory for storing data across hook invocations */
+  memory: HookMemory;
+
+  /** Relay interface for agent communication */
+  relay: HookRelay;
+
+  /** Array of outputs from the current agent turn */
+  output: AgentOutput[];
+
+  /** Conversation message history */
+  messages: ConversationMessage[];
+}
+
+/**
+ * Result returned by a hook execution
+ *
+ * Hooks can modify agent behavior by returning specific fields:
+ * - inject: Add content to the agent's input
+ * - suppress: Prevent the triggering action from executing
+ * - stop: Halt further hook processing
+ */
+export interface HookResult {
+  /**
+   * Content to inject into the agent's input stream.
+   * If provided, this content will be processed as user input.
+   */
+  inject?: string;
+
+  /**
+   * If true, suppress the action that triggered the hook.
+   * For example, on a Stop hook, this would prevent the agent from stopping.
+   */
+  suppress?: boolean;
+
+  /**
+   * If true, stop processing any remaining hooks in the chain.
+   * The current hook's result will be the final result.
+   */
+  stop?: boolean;
+}
+
+/**
+ * Hook event types that can trigger hook execution
+ */
+export type HookEventType =
+  | 'PreToolCall'
+  | 'PostToolCall'
+  | 'Stop'
+  | 'Start'
+  | 'Error'
+  | 'Message';
+
+/**
+ * Configuration for a hook
+ */
+export interface HookConfig {
+  /** The event type that triggers this hook */
+  event: HookEventType;
+  /** Command to execute for the hook */
+  command: string;
+  /** Optional working directory for the command */
+  workingDir?: string;
+  /** Optional timeout in milliseconds */
+  timeout?: number;
+  /** Whether this hook is enabled */
+  enabled?: boolean;
+}
+
+/**
+ * Handler function signature for programmatic hooks
+ */
+export type HookHandler = (context: HookContext) => HookResult | Promise<HookResult>;
+
+// ============================================================================
+// Lifecycle Hook Types
+// ============================================================================
+
+/**
+ * Extended context for session start hooks
+ */
+export interface SessionStartContext extends HookContext {
+  /** Task description if agent was started with a task */
+  task?: string;
+  /** Task ID if linked to external system */
+  taskId?: string;
+  /** Task source (e.g., 'beads', 'linear', 'github') */
+  taskSource?: string;
+}
+
+/**
+ * Extended context for session end hooks
+ */
+export interface SessionEndContext extends HookContext {
+  /** Exit code if available */
+  exitCode?: number;
+  /** Duration of the session in milliseconds */
+  duration: number;
+  /** Whether the session ended gracefully */
+  graceful: boolean;
+}
+
+/**
+ * Extended context for output hooks
+ */
+export interface OutputContext extends HookContext {
+  /** Cleaned output (ANSI codes stripped) */
+  content: string;
+  /** Raw output with ANSI codes */
+  rawContent: string;
+  /** Whether this is a complete line */
+  isComplete: boolean;
+}
+
+/**
+ * Extended context for message received hooks
+ */
+export interface MessageReceivedContext extends HookContext {
+  /** Sender agent name */
+  from: string;
+  /** Message body */
+  body: string;
+  /** Message ID */
+  messageId: string;
+  /** Thread ID if threaded */
+  thread?: string;
+}
+
+/**
+ * Extended context for message sent hooks
+ */
+export interface MessageSentContext extends HookContext {
+  /** Target agent name */
+  to: string;
+  /** Message body */
+  body: string;
+  /** Thread ID if threaded */
+  thread?: string;
+}
+
+/**
+ * Extended context for idle hooks
+ */
+export interface IdleContext extends HookContext {
+  /** Duration of inactivity in milliseconds */
+  idleDuration: number;
+  /** Number of times idle hook has fired this session */
+  idleCount: number;
+}
+
+/**
+ * Extended context for error hooks
+ */
+export interface ErrorContext extends HookContext {
+  /** The error that occurred */
+  error: Error;
+  /** Phase where error occurred (e.g., 'output', 'message', 'tool') */
+  phase?: string;
+}
+
+/**
+ * Lifecycle hook handler types
+ */
+export type OnSessionStartHook = (ctx: SessionStartContext) => Promise<HookResult | void> | HookResult | void;
+export type OnSessionEndHook = (ctx: SessionEndContext) => Promise<HookResult | void> | HookResult | void;
+export type OnOutputHook = (ctx: OutputContext) => Promise<HookResult | void> | HookResult | void;
+export type OnMessageReceivedHook = (ctx: MessageReceivedContext) => Promise<HookResult | void> | HookResult | void;
+export type OnMessageSentHook = (ctx: MessageSentContext) => Promise<HookResult | void> | HookResult | void;
+export type OnIdleHook = (ctx: IdleContext) => Promise<HookResult | void> | HookResult | void;
+export type OnErrorHook = (ctx: ErrorContext) => Promise<HookResult | void> | HookResult | void;
+
+/**
+ * Lifecycle hook definitions for registration
+ */
+export interface LifecycleHooks {
+  onSessionStart?: OnSessionStartHook | OnSessionStartHook[];
+  onSessionEnd?: OnSessionEndHook | OnSessionEndHook[];
+  onOutput?: OnOutputHook | OnOutputHook[];
+  onMessageReceived?: OnMessageReceivedHook | OnMessageReceivedHook[];
+  onMessageSent?: OnMessageSentHook | OnMessageSentHook[];
+  onIdle?: OnIdleHook | OnIdleHook[];
+  onError?: OnErrorHook | OnErrorHook[];
+}
+
+/**
+ * Lifecycle hook event names
+ */
+export type LifecycleHookEvent =
+  | 'sessionStart'
+  | 'sessionEnd'
+  | 'output'
+  | 'messageReceived'
+  | 'messageSent'
+  | 'idle'
+  | 'error';
+
+/**
+ * Pattern handler for custom namespaces (e.g., @deploy:, @notify:)
+ */
+export type PatternHandler = (
+  target: string,
+  message: string,
+  ctx: HookContext
+) => Promise<HookResult | void> | HookResult | void;
+
+/**
+ * Memory configuration for hooks
+ */
+export interface HooksMemoryConfig {
+  /** Memory adapter type: 'inmemory', 'supermemory', etc. */
+  type?: string;
+  /** API key for external memory services */
+  apiKey?: string;
+  /** Custom API endpoint */
+  endpoint?: string;
+  /** Whether to inject memories on session start */
+  injectOnStart?: boolean;
+  /** Maximum memories to inject on start */
+  maxStartMemories?: number;
+  /** Whether to prompt for memory save on session end */
+  promptOnEnd?: boolean;
+  /** Whether to auto-save detected learnings (default: true) */
+  autoSave?: boolean;
+  /** Whether to track learnings for session-end summary (default: true) */
+  autoSaveOnEnd?: boolean;
+}
+
+/**
+ * Full hooks configuration
+ */
+export interface HooksConfig {
+  /** Lifecycle hooks */
+  hooks?: LifecycleHooks;
+  /** Pattern handlers by namespace */
+  patterns?: Record<string, PatternHandler | 'builtin'>;
+  /** Idle timeout in milliseconds (default: 30000) */
+  idleTimeout?: number;
+  /** Whether to enable trajectory tracking hooks */
+  trajectoryTracking?: boolean;
+  /** Memory system configuration */
+  memory?: HooksMemoryConfig | boolean;
+}
+
+// Hook ABI version aligns with protocol wire version
+export const HOOK_ABI_VERSION = PROTOCOL_VERSION;

package/packages/hooks/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}

package/packages/hooks/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['src/**/*.test.ts'],
+  },
+});

package/packages/mcp/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/packages/mcp/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}

package/packages/mcp/dist/client.d.ts

@@ -4,21 +4,22 @@
  * This module uses @agent-relay/protocol for wire format handling
  * to avoid code duplication with the SDK.
  */
-import { type HealthResponsePayload, type MetricsResponsePayload } from '@agent-relay/protocol';
+import { type AckPayload, type HealthResponsePayload, type MetricsResponsePayload } from '@agent-relay/protocol';
+import { type SpawnResult, type ReleaseResult } from '@agent-relay/utils/client-helpers';
 export type HealthResponse = HealthResponsePayload;
 export type MetricsResponse = MetricsResponsePayload;
 export interface RelayClient {
     send(to: string, message: string, options?: {
         thread?: string;
+        kind?: string;
+        data?: Record<string, unknown>;
     }): Promise<void>;
     sendAndWait(to: string, message: string, options?: {
         thread?: string;
         timeoutMs?: number;
-    }): Promise<{
-        from: string;
-        content: string;
-        thread?: string;
-    }>;
+        kind?: string;
+        data?: Record<string, unknown>;
+    }): Promise<AckPayload>;
     broadcast(message: string, options?: {
         kind?: string;
     }): Promise<void>;
@@ -28,15 +29,8 @@ export interface RelayClient {
         task: string;
         model?: string;
         cwd?: string;
-    }): Promise<{
-        success: boolean;
-        error?: string;
-        pid?: number;
-    }>;
-    release(name: string, reason?: string): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
+    }): Promise<SpawnResult>;
+    release(name: string, reason?: string): Promise<ReleaseResult>;
     subscribe(topic: string): Promise<{
         success: boolean;
         error?: string;

package/packages/mcp/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}