@agent-relay/continuity 0.1.0

package/dist/formatter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Context Formatter
+ *
+ * Formats ledgers, handoffs, and learnings into markdown
+ * for injection into agent context.
+ */
+import type { Ledger, Handoff, StartupContext, FileRef, Decision } from './types.js';
+/**
+ * Format options for context injection
+ */
+export interface FormatOptions {
+    /** Maximum length of the formatted context */
+    maxLength?: number;
+    /** Include file references */
+    includeFiles?: boolean;
+    /** Include decisions */
+    includeDecisions?: boolean;
+    /** Include learnings */
+    includeLearnings?: boolean;
+    /** Compact mode (less verbose) */
+    compact?: boolean;
+}
+/**
+ * Format a startup context for injection
+ */
+export declare function formatStartupContext(context: Omit<StartupContext, 'formatted'>, options?: FormatOptions): string;
+/**
+ * Format a ledger for context injection
+ */
+export declare function formatLedger(ledger: Ledger, options?: FormatOptions): string;
+/**
+ * Format a handoff for context injection
+ */
+export declare function formatHandoff(handoff: Handoff, options?: FormatOptions): string;
+/**
+ * Format a search result summary
+ */
+export declare function formatSearchResults(handoffs: Handoff[], query: string): string;
+/**
+ * Format a brief status summary (for status line / dashboard)
+ */
+export declare function formatBriefStatus(ledger: Ledger | null, handoff: Handoff | null): string;
+/**
+ * Format file references for injection
+ */
+export declare function formatFileRefs(files: FileRef[]): string;
+/**
+ * Format decisions for injection
+ */
+export declare function formatDecisions(decisions: Decision[]): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAUD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,EAC1C,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAwCR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAqGhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CA2FnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA0B9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAwBxF;AASD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAUvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAE7D"}

package/dist/formatter.js

@@ -0,0 +1,313 @@
+/**
+ * Context Formatter
+ *
+ * Formats ledgers, handoffs, and learnings into markdown
+ * for injection into agent context.
+ */
+const DEFAULT_OPTIONS = {
+    maxLength: 4000,
+    includeFiles: true,
+    includeDecisions: true,
+    includeLearnings: true,
+    compact: false,
+};
+/**
+ * Format a startup context for injection
+ */
+export function formatStartupContext(context, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const sections = [];
+    sections.push('# Session Continuity');
+    sections.push('');
+    sections.push('*This context was automatically loaded from your previous session.*');
+    sections.push('');
+    // Format ledger if present
+    if (context.ledger) {
+        sections.push(formatLedger(context.ledger, opts));
+    }
+    // Format handoff if present (and no ledger or ledger is stale)
+    if (context.handoff) {
+        if (!context.ledger || isHandoffNewer(context.handoff, context.ledger)) {
+            sections.push('');
+            sections.push(formatHandoff(context.handoff, opts));
+        }
+    }
+    // Format learnings if present
+    if (context.learnings && context.learnings.length > 0 && opts.includeLearnings) {
+        sections.push('');
+        sections.push('## Relevant Learnings');
+        sections.push('');
+        for (const learning of context.learnings.slice(0, 5)) {
+            sections.push(`- ${learning}`);
+        }
+    }
+    let result = sections.join('\n');
+    // Truncate if too long
+    if (opts.maxLength && result.length > opts.maxLength) {
+        result = result.slice(0, opts.maxLength - 100) + '\n\n*[Context truncated for length]*';
+    }
+    return result;
+}
+/**
+ * Format a ledger for context injection
+ */
+export function formatLedger(ledger, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const lines = [];
+    lines.push('## Current Session State');
+    lines.push('');
+    // Current task
+    if (ledger.currentTask) {
+        lines.push(`**Current Task:** ${ledger.currentTask}`);
+        lines.push('');
+    }
+    // PDERO phase if available
+    if (ledger.pderoPhase) {
+        lines.push(`**Phase:** ${ledger.pderoPhase.toUpperCase()}`);
+        lines.push('');
+    }
+    // Completed work
+    if (ledger.completed.length > 0) {
+        if (opts.compact) {
+            lines.push(`**Completed:** ${ledger.completed.join(', ')}`);
+        }
+        else {
+            lines.push('### Completed');
+            for (const item of ledger.completed) {
+                lines.push(`- ✓ ${item}`);
+            }
+        }
+        lines.push('');
+    }
+    // In progress
+    if (ledger.inProgress.length > 0) {
+        if (opts.compact) {
+            lines.push(`**In Progress:** ${ledger.inProgress.join(', ')}`);
+        }
+        else {
+            lines.push('### In Progress');
+            for (const item of ledger.inProgress) {
+                lines.push(`- ${item}`);
+            }
+        }
+        lines.push('');
+    }
+    // Blocked items
+    if (ledger.blocked.length > 0) {
+        if (opts.compact) {
+            lines.push(`**Blocked:** ${ledger.blocked.join(', ')}`);
+        }
+        else {
+            lines.push('### Blocked');
+            for (const item of ledger.blocked) {
+                lines.push(`- ⚠ ${item}`);
+            }
+        }
+        lines.push('');
+    }
+    // Uncertain items
+    if (ledger.uncertainItems.length > 0) {
+        lines.push('### Needs Verification');
+        for (const item of ledger.uncertainItems) {
+            lines.push(`- ❓ ${item}`);
+        }
+        lines.push('');
+    }
+    // Key decisions
+    if (ledger.keyDecisions.length > 0 && opts.includeDecisions) {
+        if (opts.compact) {
+            const decisions = ledger.keyDecisions.map((d) => d.decision).join('; ');
+            lines.push(`**Decisions:** ${decisions}`);
+        }
+        else {
+            lines.push('### Key Decisions');
+            for (const decision of ledger.keyDecisions.slice(-5)) {
+                lines.push(`- **${decision.decision}**`);
+                if (decision.reasoning) {
+                    lines.push(`  - Reasoning: ${decision.reasoning}`);
+                }
+            }
+        }
+        lines.push('');
+    }
+    // File context
+    if (ledger.fileContext.length > 0 && opts.includeFiles) {
+        lines.push('### Relevant Files');
+        for (const file of ledger.fileContext.slice(-10)) {
+            let line = `- \`${file.path}\``;
+            if (file.lines) {
+                line += `:${file.lines[0]}-${file.lines[1]}`;
+            }
+            if (file.description) {
+                line += ` - ${file.description}`;
+            }
+            lines.push(line);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a handoff for context injection
+ */
+export function formatHandoff(handoff, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    const lines = [];
+    lines.push('## Previous Session Handoff');
+    lines.push('');
+    // Task and summary
+    if (handoff.taskDescription) {
+        lines.push(`**Task:** ${handoff.taskDescription}`);
+    }
+    if (handoff.summary) {
+        lines.push('');
+        lines.push(handoff.summary);
+    }
+    lines.push('');
+    // PDERO phase if available
+    if (handoff.pderoPhase) {
+        lines.push(`**Last Phase:** ${handoff.pderoPhase.toUpperCase()}`);
+        if (handoff.confidence !== undefined) {
+            lines.push(`**Confidence:** ${Math.round(handoff.confidence * 100)}%`);
+        }
+        lines.push('');
+    }
+    // Completed work
+    if (handoff.completedWork.length > 0) {
+        if (opts.compact) {
+            lines.push(`**Completed:** ${handoff.completedWork.join(', ')}`);
+        }
+        else {
+            lines.push('### Previously Completed');
+            for (const item of handoff.completedWork) {
+                lines.push(`- ✓ ${item}`);
+            }
+        }
+        lines.push('');
+    }
+    // Next steps (these are the priority)
+    if (handoff.nextSteps.length > 0) {
+        lines.push('### Next Steps');
+        for (const item of handoff.nextSteps) {
+            lines.push(`- ${item}`);
+        }
+        lines.push('');
+    }
+    // Key decisions
+    if (handoff.decisions.length > 0 && opts.includeDecisions) {
+        if (opts.compact) {
+            const decisions = handoff.decisions.map((d) => d.decision).join('; ');
+            lines.push(`**Prior Decisions:** ${decisions}`);
+        }
+        else {
+            lines.push('### Prior Decisions');
+            for (const decision of handoff.decisions.slice(-5)) {
+                lines.push(`- ${decision.decision}`);
+                if (decision.reasoning) {
+                    lines.push(`  - *${decision.reasoning}*`);
+                }
+            }
+        }
+        lines.push('');
+    }
+    // File references
+    if (handoff.fileReferences.length > 0 && opts.includeFiles) {
+        lines.push('### Key Files');
+        for (const file of handoff.fileReferences.slice(-10)) {
+            let line = `- \`${file.path}\``;
+            if (file.lines) {
+                line += `:${file.lines[0]}-${file.lines[1]}`;
+            }
+            if (file.description) {
+                line += ` - ${file.description}`;
+            }
+            lines.push(line);
+        }
+        lines.push('');
+    }
+    // Learnings
+    if (handoff.learnings && handoff.learnings.length > 0 && opts.includeLearnings) {
+        lines.push('### Learnings');
+        for (const learning of handoff.learnings) {
+            lines.push(`- ${learning}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a search result summary
+ */
+export function formatSearchResults(handoffs, query) {
+    const lines = [];
+    lines.push(`## Search Results for "${query}"`);
+    lines.push('');
+    if (handoffs.length === 0) {
+        lines.push('*No matching handoffs found.*');
+        return lines.join('\n');
+    }
+    lines.push(`Found ${handoffs.length} matching handoff(s):`);
+    lines.push('');
+    for (const handoff of handoffs) {
+        const date = handoff.createdAt.toISOString().split('T')[0];
+        lines.push(`### ${handoff.taskDescription || 'Untitled'} (${date})`);
+        lines.push(`- **Agent:** ${handoff.agentName}`);
+        lines.push(`- **ID:** ${handoff.id}`);
+        if (handoff.summary) {
+            lines.push(`- **Summary:** ${handoff.summary.slice(0, 100)}...`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a brief status summary (for status line / dashboard)
+ */
+export function formatBriefStatus(ledger, handoff) {
+    if (!ledger && !handoff) {
+        return 'No continuity data';
+    }
+    const parts = [];
+    if (ledger) {
+        if (ledger.currentTask) {
+            parts.push(`Task: ${ledger.currentTask.slice(0, 40)}`);
+        }
+        if (ledger.pderoPhase) {
+            parts.push(`Phase: ${ledger.pderoPhase}`);
+        }
+        const progress = `${ledger.completed.length}✓ ${ledger.inProgress.length}→ ${ledger.blocked.length}⚠`;
+        parts.push(progress);
+    }
+    if (handoff && !ledger) {
+        parts.push(`Last handoff: ${handoff.taskDescription?.slice(0, 30) || handoff.id}`);
+        parts.push(handoff.createdAt.toISOString().split('T')[0]);
+    }
+    return parts.join(' | ');
+}
+/**
+ * Check if handoff is newer than ledger
+ */
+function isHandoffNewer(handoff, ledger) {
+    return handoff.createdAt > ledger.updatedAt;
+}
+/**
+ * Format file references for injection
+ */
+export function formatFileRefs(files) {
+    return files
+        .map((f) => {
+        let line = f.path;
+        if (f.lines) {
+            line += `:${f.lines[0]}-${f.lines[1]}`;
+        }
+        return line;
+    })
+        .join(', ');
+}
+/**
+ * Format decisions for injection
+ */
+export function formatDecisions(decisions) {
+    return decisions.map((d) => d.decision).join('; ');
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

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

package/dist/handoff-store.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Handoff Store
+ *
+ * Persists cross-session handoffs as markdown files.
+ * Organized by agent, with timestamps in filenames.
+ */
+import type { Handoff } from './types.js';
+export declare class HandoffStore {
+    private basePath;
+    constructor(basePath: string);
+    /**
+     * Ensure the handoffs directory exists
+     */
+    initialize(): Promise<void>;
+    /**
+     * Generate a unique handoff ID
+     */
+    private generateId;
+    /**
+     * Get the directory path for an agent's handoffs
+     */
+    private getAgentDir;
+    /**
+     * Generate a filename for a handoff
+     */
+    private generateFilename;
+    /**
+     * Convert a handoff to markdown format
+     */
+    private toMarkdown;
+    /**
+     * Parse a markdown file back to a Handoff object
+     */
+    private fromMarkdown;
+    private parseListItems;
+    private parseFileRefs;
+    private parseDecisions;
+    /**
+     * Save a handoff
+     */
+    save(handoff: Handoff): Promise<string>;
+    /**
+     * Load a handoff by ID
+     */
+    loadById(handoffId: string): Promise<Handoff | null>;
+    /**
+     * Get the latest handoff for an agent
+     */
+    getLatest(agentName: string): Promise<Handoff | null>;
+    /**
+     * List handoffs for an agent (sorted by date, newest first)
+     */
+    listForAgent(agentName: string, limit?: number): Promise<Handoff[]>;
+    /**
+     * List all agents with handoffs
+     */
+    listAgents(): Promise<string[]>;
+    /**
+     * Count handoffs for an agent
+     */
+    countForAgent(agentName: string): Promise<number>;
+    /**
+     * Delete a handoff by ID
+     */
+    delete(handoffId: string): Promise<boolean>;
+}
+//# sourceMappingURL=handoff-store.d.ts.map

package/dist/handoff-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-store.d.ts","sourceRoot":"","sources":["../src/handoff-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAqC,MAAM,YAAY,CAAC;AAE7E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAmHlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwHpB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB7C;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAgC1D;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAK3D;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAwBzE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYrC;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcvD;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAgClD"}