agent-relay 1.0.22 → 1.2.0

package/dist/continuity/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Continuity System Types
+ *
+ * Core types for the CLI-agnostic session continuity system.
+ * Works with any CLI (Claude, Codex, Gemini, custom) via output
+ * pattern detection and PTY injection.
+ */
+import type { PDEROPhase } from '../trajectory/integration.js';
+/**
+ * A decision recorded during agent work
+ */
+export interface Decision {
+    /** The choice that was made */
+    decision: string;
+    /** Why this choice was made */
+    reasoning?: string;
+    /** Alternative options considered */
+    alternatives?: string[];
+    /** Confidence level (0-1) */
+    confidence?: number;
+    /** When the decision was made */
+    timestamp: Date;
+}
+/**
+ * A file reference with optional line numbers
+ */
+export interface FileRef {
+    /** Relative or absolute path */
+    path: string;
+    /** Line range [start, end] */
+    lines?: [number, number];
+    /** Brief description of what's relevant */
+    description?: string;
+}
+/**
+ * Ledger - Within-session state snapshot
+ *
+ * Ephemeral, overwritten each session. Captures current work state
+ * for context injection on restart/clear.
+ */
+export interface Ledger {
+    /** Agent name this ledger belongs to */
+    agentName: string;
+    /** Unique agent instance ID (persists across restarts for resume) */
+    agentId: string;
+    /** Unique session identifier */
+    sessionId: string;
+    /** CLI being used (claude, codex, gemini, custom) */
+    cli: string;
+    /** What the agent is currently working on */
+    currentTask: string;
+    /** Completed work items */
+    completed: string[];
+    /** Work in progress */
+    inProgress: string[];
+    /** Blocked items with reasons */
+    blocked: string[];
+    /** Key decisions made during session */
+    keyDecisions: Decision[];
+    /** Items marked as uncertain (need verification) */
+    uncertainItems: string[];
+    /** Recently touched files */
+    fileContext: FileRef[];
+    /** Active trajectory ID if using trail */
+    trajectoryId?: string;
+    /** Current PDERO phase */
+    pderoPhase?: PDEROPhase;
+    /** Last update timestamp */
+    updatedAt: Date;
+}
+/**
+ * Handoff - Cross-session transfer document
+ *
+ * Permanent, searchable. Created on trajectory completion,
+ * context limit, crash, or manual save.
+ */
+export interface Handoff {
+    /** Unique handoff identifier */
+    id: string;
+    /** Agent that created this handoff */
+    agentName: string;
+    /** Agent instance ID that created this handoff */
+    agentId?: string;
+    /** CLI used (for context) */
+    cli: string;
+    /** Brief summary of the handoff */
+    summary: string;
+    /** Task being worked on */
+    taskDescription: string;
+    /** Work completed before handoff */
+    completedWork: string[];
+    /** Recommended next steps */
+    nextSteps: string[];
+    /** Files relevant to the work */
+    fileReferences: FileRef[];
+    /** Key decisions made */
+    decisions: Decision[];
+    /** Links to related previous handoffs */
+    relatedHandoffs: string[];
+    /** When the handoff was created */
+    createdAt: Date;
+    /** What triggered the handoff */
+    triggerReason: HandoffTrigger;
+    /** Trajectory ID if created from trajectory completion */
+    trajectoryId?: string;
+    /** PDERO phase at handoff time */
+    pderoPhase?: PDEROPhase;
+    /** Confidence level from trajectory */
+    confidence?: number;
+    /** Learnings extracted from trajectory */
+    learnings?: string[];
+}
+/**
+ * What triggered handoff creation
+ */
+export type HandoffTrigger = 'manual' | 'trajectory_complete' | 'context_limit' | 'auto_restart' | 'crash' | 'session_end';
+/**
+ * Continuity command parsed from agent output
+ */
+export interface ContinuityCommand {
+    /** Command type */
+    type: 'save' | 'load' | 'search' | 'uncertain' | 'handoff';
+    /** Content for save commands */
+    content?: string;
+    /** Query for search commands */
+    query?: string;
+    /** Item for uncertain command */
+    item?: string;
+    /** Whether to create a handoff (for save) */
+    createHandoff?: boolean;
+}
+/**
+ * Context to inject on agent startup
+ */
+export interface StartupContext {
+    /** The ledger if available */
+    ledger?: Ledger;
+    /** The most recent handoff if available */
+    handoff?: Handoff;
+    /** Relevant learnings from past sessions */
+    learnings?: string[];
+    /** Formatted markdown to inject */
+    formatted: string;
+}
+/**
+ * Continuity storage paths
+ */
+export interface ContinuityPaths {
+    /** Base continuity directory */
+    base: string;
+    /** Ledgers directory */
+    ledgers: string;
+    /** Handoffs directory */
+    handoffs: string;
+    /** Artifact index database */
+    artifactDb: string;
+}
+/**
+ * Options for saving a ledger
+ */
+export interface SaveLedgerOptions {
+    /** Create a handoff as well */
+    createHandoff?: boolean;
+    /** Trigger reason if creating handoff */
+    triggerReason?: HandoffTrigger;
+}
+/**
+ * Options for searching handoffs
+ */
+export interface SearchOptions {
+    /** Filter by agent name */
+    agentName?: string;
+    /** Maximum results to return */
+    limit?: number;
+    /** Filter by date range */
+    since?: Date;
+    /** Filter by trigger reason */
+    triggerReason?: HandoffTrigger;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/continuity/types.d.ts.map

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

package/dist/continuity/types.js

@@ -0,0 +1,9 @@
+/**
+ * Continuity System Types
+ *
+ * Core types for the CLI-agnostic session continuity system.
+ * Works with any CLI (Claude, Codex, Gemini, custom) via output
+ * pattern detection and PTY injection.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/continuity/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/continuity/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/daemon/agent-manager.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Agent Manager
+ * Manages agents across workspaces with integrated resiliency.
+ */
+import { EventEmitter } from 'events';
+import { type SummaryEvent, type SessionEndEvent } from '../wrapper/pty-wrapper.js';
+import type { Agent, SpawnAgentRequest } from './types.js';
+/**
+ * Optional cloud persistence handler.
+ * When set, agent-manager forwards PtyWrapper events to this handler.
+ */
+export interface CloudPersistenceHandler {
+    onSummary: (agentId: string, event: SummaryEvent) => Promise<void>;
+    onSessionEnd: (agentId: string, event: SessionEndEvent) => Promise<void>;
+    /** Optional cleanup method for tests and graceful shutdown */
+    destroy?: () => void;
+}
+export declare class AgentManager extends EventEmitter {
+    private agents;
+    private supervisor;
+    private dataDir;
+    private logsDir;
+    private cloudPersistence?;
+    constructor(dataDir: string);
+    /**
+     * Set cloud persistence handler for forwarding PtyWrapper events.
+     * When set, 'summary' and 'session-end' events from agents are forwarded
+     * to the handler for cloud persistence (PostgreSQL/Redis).
+     */
+    setCloudPersistence(handler: CloudPersistenceHandler): void;
+    /**
+     * Spawn a new agent in a workspace
+     */
+    spawn(workspaceId: string, workspacePath: string, request: SpawnAgentRequest): Promise<Agent>;
+    /**
+     * Stop an agent
+     */
+    stop(agentId: string): Promise<boolean>;
+    /**
+     * Stop all agents in a workspace
+     */
+    stopAllInWorkspace(workspaceId: string): Promise<void>;
+    /**
+     * Stop all agents
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Get an agent by ID
+     */
+    get(agentId: string): Agent | undefined;
+    /**
+     * Get all agents in a workspace
+     */
+    getByWorkspace(workspaceId: string): Agent[];
+    /**
+     * Get all agents
+     */
+    getAll(): Agent[];
+    /**
+     * Find agent by name in a workspace
+     */
+    findByName(workspaceId: string, name: string): Agent | undefined;
+    /**
+     * Get agent output/logs
+     */
+    getOutput(agentId: string, limit?: number): string[] | null;
+    /**
+     * Get raw output from agent
+     */
+    getRawOutput(agentId: string): string | null;
+    /**
+     * Send input to an agent
+     */
+    sendInput(agentId: string, input: string): boolean;
+    /**
+     * Restart an agent
+     */
+    private restartAgent;
+    /**
+     * Handle agent exit
+     */
+    private handleAgentExit;
+    /**
+     * Bind PtyWrapper events to cloud persistence and daemon events.
+     *
+     * Events bound:
+     * - 'summary': Agent output a [[SUMMARY]] block
+     * - 'session-end': Agent output a [[SESSION_END]] block
+     * - 'injection-failed': Message injection failed after retries
+     */
+    private bindPtyEvents;
+    /**
+     * Setup supervisor event handlers
+     */
+    private setupSupervisorEvents;
+    /**
+     * Get CLI command for provider
+     */
+    private getCliCommand;
+    /**
+     * Convert internal agent to public agent (without pty reference)
+     */
+    private toPublicAgent;
+    /**
+     * Emit a daemon event
+     */
+    private emitEvent;
+    /**
+     * Shutdown the agent manager
+     */
+    shutdown(): Promise<void>;
+}
+export declare function getAgentManager(dataDir?: string): AgentManager;
+//# sourceMappingURL=agent-manager.d.ts.map

package/dist/daemon/agent-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-manager.d.ts","sourceRoot":"","sources":["../../src/daemon/agent-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,EAAqC,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEvH,OAAO,KAAK,EACV,KAAK,EAGL,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAYD,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,UAAU,CAOf;IACH,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAC,CAA0B;gBAEvC,OAAO,EAAE,MAAM;IAmB3B;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAK3D;;OAEG;IACG,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,KAAK,CAAC;IA8HjB;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAwC7C;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAKvC;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,EAAE;IAM5C;;OAEG;IACH,MAAM,IAAI,KAAK,EAAE;IAIjB;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAOhE;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAM3D;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAM5C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAOlD;;OAEG;YACW,YAAY;IA6D1B;;OAEG;IACH,OAAO,CAAC,eAAe;IA6BvB;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IA6ErB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC;AAID,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAM9D"}