@agent-relay/continuity 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,180 @@
+export type PDEROPhase = 'plan' | 'design' | 'execute' | 'review' | 'observe';
+/**
+ * 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.
+ */
+/**
+ * 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/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@agent-relay/continuity",
+  "version": "0.1.0",
+  "description": "Session continuity manager for Relay (ledgers, handoffs, resume)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}