@agent-relay/wrapper 0.1.0

package/dist/inbox.js

@@ -0,0 +1,73 @@
+/**
+ * File-based Inbox Manager
+ * Writes incoming messages to a file that the CLI agent reads itself.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export const DEFAULT_INBOX_DIR = '/tmp/agent-relay';
+export class InboxManager {
+    config;
+    inboxPath;
+    constructor(config) {
+        this.config = {
+            inboxDir: DEFAULT_INBOX_DIR,
+            ...config,
+        };
+        this.inboxPath = path.join(this.config.inboxDir, this.config.agentName, 'inbox.md');
+    }
+    /**
+     * Initialize inbox directory and file.
+     */
+    init() {
+        const dir = path.dirname(this.inboxPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Start with empty inbox
+        this.clear();
+    }
+    /**
+     * Get the inbox file path (for telling the agent where to read).
+     */
+    getInboxPath() {
+        return this.inboxPath;
+    }
+    /**
+     * Add a message to the inbox.
+     */
+    addMessage(from, body) {
+        const timestamp = new Date().toISOString();
+        const entry = `\n## Message from ${from} | ${timestamp}\n${body}\n`;
+        // Read existing content
+        let content = '';
+        if (fs.existsSync(this.inboxPath)) {
+            content = fs.readFileSync(this.inboxPath, 'utf-8');
+        }
+        // If empty, add header
+        if (!content.trim()) {
+            content = `# 📬 INBOX - CHECK AND RESPOND TO ALL MESSAGES\n`;
+        }
+        // Append new message
+        content += entry;
+        // Atomic write (write to temp, then rename)
+        const tmpPath = `${this.inboxPath}.tmp`;
+        fs.writeFileSync(tmpPath, content, 'utf-8');
+        fs.renameSync(tmpPath, this.inboxPath);
+    }
+    /**
+     * Clear the inbox.
+     */
+    clear() {
+        fs.writeFileSync(this.inboxPath, '', 'utf-8');
+    }
+    /**
+     * Check if inbox has messages.
+     */
+    hasMessages() {
+        if (!fs.existsSync(this.inboxPath))
+            return false;
+        const content = fs.readFileSync(this.inboxPath, 'utf-8');
+        return content.includes('## Message from');
+    }
+}
+//# sourceMappingURL=inbox.js.map

package/dist/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../src/inbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAOpD,MAAM,OAAO,YAAY;IACf,MAAM,CAAc;IACpB,SAAS,CAAS;IAE1B,YAAY,MAAoD;QAC9D,IAAI,CAAC,MAAM,GAAG;YACZ,QAAQ,EAAE,iBAAiB;YAC3B,GAAG,MAAM;SACV,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,IAAI;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,yBAAyB;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY,EAAE,IAAY;QACnC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,qBAAqB,IAAI,MAAM,SAAS,KAAK,IAAI,IAAI,CAAC;QAEpE,wBAAwB;QACxB,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACpB,OAAO,GAAG,kDAAkD,CAAC;QAC/D,CAAC;QAED,qBAAqB;QACrB,OAAO,IAAI,KAAK,CAAC;QAEjB,4CAA4C;QAC5C,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,MAAM,CAAC;QACxC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;QACjD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @agent-relay/wrapper
+ *
+ * CLI agent wrappers for Agent Relay.
+ * Phase 2B extraction - utilities and types.
+ */
+export { IdGenerator, idGen, generateId } from './id-generator.js';
+export { getTmuxPath, resolveTmux, isTmuxAvailable, checkTmuxVersion, getBundledTmuxDir, getBundledTmuxPath, getPlatformIdentifier, TmuxNotFoundError, type TmuxInfo, BUNDLED_TMUX_DIR, BUNDLED_TMUX_PATH, MIN_TMUX_VERSION, } from './tmux-resolver.js';
+export { OutputParser, parseSummaryFromOutput, parseSummaryWithDetails, parseSessionEndFromOutput, parseRelayMetadataFromOutput, isPlaceholderTarget, type ParsedCommand, type ParserOptions, type ParsedSummary, type ParsedMessageMetadata, type MetadataParseResult, type SummaryParseResult, type SessionEndMarker, } from './parser.js';
+export { stripAnsi, sleep, getDefaultRelayPrefix, buildInjectionString, injectWithRetry, INJECTION_CONSTANTS, CLI_QUIRKS, type QueuedMessage, type InjectionResult, type InjectionMetrics, type CliType, type InjectionCallbacks, } from './shared.js';
+export { AUTH_REVOCATION_PATTERNS, AUTH_FALSE_POSITIVE_PATTERNS, PROVIDER_AUTH_PATTERNS, detectProviderAuthRevocation, type AuthRevocationResult, } from './auth-detection.js';
+export { UniversalIdleDetector, getTmuxPanePid, type IdleSignal, type IdleResult, type IdleDetectorConfig, } from './idle-detector.js';
+export { TrajectoryIntegration, getTrajectoryIntegration, detectPhaseFromContent, detectToolCalls, detectErrors, getCompactTrailInstructions, getTrailEnvVars, getTrailInstructions, isTrailAvailable, startTrajectory, getTrajectoryStatus, transitionPhase, recordDecision, recordEvent, recordMessage, completeTrajectory, abandonTrajectory, listTrajectorySteps, getTrajectoryHistory, type PDEROPhase, type StartTrajectoryOptions, type CompleteTrajectoryOptions, type DecisionOptions, type TrajectoryStepData, type TrajectoryHistoryEntry, type DetectedToolCall, type DetectedError, } from './trajectory-integration.js';
+export { type InjectionFailedEvent, type SummaryEvent, type SessionEndEvent, type AuthRevokedEvent, } from './wrapper-types.js';
+export { StuckDetector, type StuckEvent, type StuckReason, type StuckDetectorConfig, } from './stuck-detector.js';
+export { composeForAgent, getAvailableRoles, parseRoleFromProfile, clearPromptCache, type AgentRole, type AgentProfile, type ComposedPrompt, } from './prompt-composer.js';
+/**
+ * Relay client (internal use only)
+ *
+ * @deprecated **MIGRATION REQUIRED** - Use `@agent-relay/sdk` instead.
+ *
+ * ```typescript
+ * // BEFORE (deprecated)
+ * import { RelayClient } from '@agent-relay/wrapper';
+ *
+ * // AFTER (recommended)
+ * import { RelayClient } from '@agent-relay/sdk';
+ * ```
+ *
+ * This export is retained only for internal daemon/wrapper integration.
+ * External consumers should migrate to `@agent-relay/sdk`.
+ * This export will be removed in a future major version.
+ */
+export { RelayClient, type ClientState, type ClientConfig, type SyncOptions, } from './client.js';
+export { BaseWrapper, type BaseWrapperConfig, } from './base-wrapper.js';
+export { RelayPtyOrchestrator, type RelayPtyOrchestratorConfig, } from './relay-pty-orchestrator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,QAAQ,EACb,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,SAAS,EACT,KAAK,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,OAAO,EACZ,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,EAC5B,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,2BAA2B,EAC3B,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,GAChC,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,47 @@
+/**
+ * @agent-relay/wrapper
+ *
+ * CLI agent wrappers for Agent Relay.
+ * Phase 2B extraction - utilities and types.
+ */
+// ID generation
+export { IdGenerator, idGen, generateId } from './id-generator.js';
+// Tmux binary resolution
+export { getTmuxPath, resolveTmux, isTmuxAvailable, checkTmuxVersion, getBundledTmuxDir, getBundledTmuxPath, getPlatformIdentifier, TmuxNotFoundError, BUNDLED_TMUX_DIR, BUNDLED_TMUX_PATH, MIN_TMUX_VERSION, } from './tmux-resolver.js';
+// Output parser
+export { OutputParser, parseSummaryFromOutput, parseSummaryWithDetails, parseSessionEndFromOutput, parseRelayMetadataFromOutput, isPlaceholderTarget, } from './parser.js';
+// Shared wrapper utilities and types
+export { stripAnsi, sleep, getDefaultRelayPrefix, buildInjectionString, injectWithRetry, INJECTION_CONSTANTS, CLI_QUIRKS, } from './shared.js';
+// Auth revocation detection
+export { AUTH_REVOCATION_PATTERNS, AUTH_FALSE_POSITIVE_PATTERNS, PROVIDER_AUTH_PATTERNS, detectProviderAuthRevocation, } from './auth-detection.js';
+// Idle detection
+export { UniversalIdleDetector, getTmuxPanePid, } from './idle-detector.js';
+// Trajectory integration (PDERO paradigm tracking)
+export { TrajectoryIntegration, getTrajectoryIntegration, detectPhaseFromContent, detectToolCalls, detectErrors, getCompactTrailInstructions, getTrailEnvVars, getTrailInstructions, isTrailAvailable, startTrajectory, getTrajectoryStatus, transitionPhase, recordDecision, recordEvent, recordMessage, completeTrajectory, abandonTrajectory, listTrajectorySteps, getTrajectoryHistory, } from './trajectory-integration.js';
+// Stuck detection
+export { StuckDetector, } from './stuck-detector.js';
+// Prompt composition
+export { composeForAgent, getAvailableRoles, parseRoleFromProfile, clearPromptCache, } from './prompt-composer.js';
+/**
+ * Relay client (internal use only)
+ *
+ * @deprecated **MIGRATION REQUIRED** - Use `@agent-relay/sdk` instead.
+ *
+ * ```typescript
+ * // BEFORE (deprecated)
+ * import { RelayClient } from '@agent-relay/wrapper';
+ *
+ * // AFTER (recommended)
+ * import { RelayClient } from '@agent-relay/sdk';
+ * ```
+ *
+ * This export is retained only for internal daemon/wrapper integration.
+ * External consumers should migrate to `@agent-relay/sdk`.
+ * This export will be removed in a future major version.
+ */
+export { RelayClient, } from './client.js';
+// Base wrapper class
+export { BaseWrapper, } from './base-wrapper.js';
+// RelayPtyOrchestrator (relay-pty Rust binary)
+export { RelayPtyOrchestrator, } from './relay-pty-orchestrator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEnE,yBAAyB;AACzB,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EAEjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,mBAAmB,GAQpB,MAAM,aAAa,CAAC;AAErB,qCAAqC;AACrC,OAAO,EACL,SAAS,EACT,KAAK,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,UAAU,GAMX,MAAM,aAAa,CAAC;AAErB,4BAA4B;AAC5B,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,4BAA4B,GAE7B,MAAM,qBAAqB,CAAC;AAE7B,iBAAiB;AACjB,OAAO,EACL,qBAAqB,EACrB,cAAc,GAIf,MAAM,oBAAoB,CAAC;AAE5B,mDAAmD;AACnD,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,eAAe,EACf,YAAY,EACZ,2BAA2B,EAC3B,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GASrB,MAAM,6BAA6B,CAAC;AAUrC,kBAAkB;AAClB,OAAO,EACL,aAAa,GAId,MAAM,qBAAqB,CAAC;AAE7B,qBAAqB;AACrB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,GAIjB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,WAAW,GAIZ,MAAM,aAAa,CAAC;AAErB,qBAAqB;AACrB,OAAO,EACL,WAAW,GAEZ,MAAM,mBAAmB,CAAC;AAE3B,+CAA+C;AAC/C,OAAO,EACL,oBAAoB,GAErB,MAAM,6BAA6B,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,236 @@
+/**
+ * PTY Output Parser
+ * Extracts relay commands from agent terminal output.
+ *
+ * Supports two formats:
+ * 1. Inline: ->relay:<target> <message> (single line, start of line only)
+ * 2. Block: [[RELAY]]{ json }[[/RELAY]] (multi-line, structured)
+ *
+ * Rules:
+ * - Inline only matches at start of line (after whitespace)
+ * - Ignores content inside code fences
+ * - Escape with \->relay: to output literal
+ * - Block format is preferred for structured data
+ */
+import type { PayloadKind } from '@agent-relay/protocol/types';
+export interface ParsedCommand {
+    to: string;
+    kind: PayloadKind;
+    body: string;
+    data?: Record<string, unknown>;
+    /** Optional thread ID for grouping related messages */
+    thread?: string;
+    /** Optional project for cross-project messaging (e.g., ->relay:project:agent) */
+    project?: string;
+    /** Optional thread project for cross-project threads (e.g., [thread:project:id]) */
+    threadProject?: string;
+    /** Optional sync metadata parsed from [await] */
+    sync?: {
+        blocking: boolean;
+        timeoutMs?: number;
+    };
+    raw: string;
+    meta?: ParsedMessageMetadata;
+}
+export interface ParserOptions {
+    maxBlockBytes?: number;
+    enableInline?: boolean;
+    enableBlock?: boolean;
+    /** Relay prefix pattern (default: '->relay:') */
+    prefix?: string;
+    /** Thinking prefix pattern (default: '->thinking:') */
+    thinkingPrefix?: string;
+}
+/**
+ * Check if a target name is a placeholder commonly used in documentation/examples.
+ * These should not be treated as real message targets.
+ */
+export declare function isPlaceholderTarget(target: string): boolean;
+export declare class OutputParser {
+    private options;
+    private inCodeFence;
+    private inBlock;
+    private blockBuffer;
+    private blockType;
+    private lastParsedMetadata;
+    private inThinkingBlock;
+    private inFencedInline;
+    private fencedInlineBuffer;
+    private fencedInlineTarget;
+    private fencedInlineThread;
+    private fencedInlineThreadProject;
+    private fencedInlineProject;
+    private fencedInlineRaw;
+    private fencedInlineKind;
+    private fencedInlineSync;
+    private inlineRelayPattern;
+    private inlineThinkingPattern;
+    private fencedRelayPattern;
+    private fencedThinkingPattern;
+    private escapePattern;
+    constructor(options?: ParserOptions);
+    /**
+     * Get the configured relay prefix
+     */
+    get prefix(): string;
+    /**
+     * Push data into the parser and extract commands.
+     * Returns array of parsed commands and cleaned output.
+     *
+     * Design: Pass through data with minimal buffering to preserve terminal rendering.
+     * Only buffer content when inside [[RELAY]]...[[/RELAY]] blocks.
+     */
+    parse(data: string): {
+        commands: ParsedCommand[];
+        output: string;
+    };
+    /**
+     * Find [[RELAY_METADATA]] or [[RELAY]] that's at the start of a line and not inside a code fence.
+     * Returns the index and identifier, or -1 and null if not found.
+     */
+    private findBlockStart;
+    /**
+     * Parse data in pass-through mode - TRUE pass-through for terminal rendering.
+     * Output is exactly the input data, minus any relay command lines found in this chunk.
+     * No cross-chunk buffering to avoid double-output issues.
+     *
+     * IMPORTANT: We ONLY parse complete lines (i.e. those terminated by `\n` in the
+     * current chunk). The final unterminated line (if any) is passed through without
+     * parsing. This intentionally avoids cross-chunk detection when a line is split
+     * across chunks.
+     */
+    private parsePassThrough;
+    /**
+     * Parse while inside a [[RELAY]] block - buffer until we see [[/RELAY]].
+     */
+    private parseInBlockMode;
+    /**
+     * Process a single complete line for inline relay commands.
+     * Block handling is done at the parse() level, not here.
+     *
+     * IMPORTANT: We strip ANSI codes for pattern matching, but preserve
+     * the original line for output to maintain terminal rendering.
+     *
+     * OPTIMIZATION: Early exit for lines that can't possibly be relay commands.
+     * Most lines don't contain relay patterns, so we avoid expensive regex/ANSI
+     * stripping for the common case.
+     */
+    private processLine;
+    /**
+     * Finish processing a block and extract command.
+     * Returns the command (if valid) and any remaining content after [[/RELAY]].
+     */
+    private finishBlock;
+    /**
+     * Check if the current fenced inline command should be filtered out.
+     * Returns true if the command looks like instructional/example text.
+     */
+    private shouldFilterFencedInline;
+    /**
+     * Parse while inside a fenced inline block (->relay:Target <<< ... >>>).
+     * Accumulates lines until >>> is seen on its own line.
+     */
+    private parseFencedInlineMode;
+    /**
+     * Flush any remaining buffer (call on stream end).
+     */
+    flush(): {
+        commands: ParsedCommand[];
+        output: string;
+    };
+    /**
+     * Reset parser state.
+     */
+    reset(): void;
+}
+/**
+ * Parsed message metadata block from agent output.
+ */
+export interface ParsedMessageMetadata {
+    subject?: string;
+    importance?: number;
+    replyTo?: string;
+    ackRequired?: boolean;
+}
+/**
+ * Result of attempting to parse a RELAY_METADATA block.
+ */
+export interface MetadataParseResult {
+    found: boolean;
+    valid: boolean;
+    metadata: ParsedMessageMetadata | null;
+    rawContent: string | null;
+}
+/**
+ * Parse [[RELAY_METADATA]]...[[/RELAY_METADATA]] blocks from agent output.
+ * Agents can output metadata to enhance messages.
+ *
+ * Format:
+ * [[RELAY_METADATA]]
+ * {
+ *   "subject": "Task update",
+ *   "importance": 80,
+ *   "replyTo": "msg-abc123",
+ *   "ackRequired": true
+ * }
+ * [[/RELAY_METADATA]]
+ */
+export declare function parseRelayMetadataFromOutput(output: string): MetadataParseResult;
+/**
+ * Parsed summary block from agent output.
+ */
+export interface ParsedSummary {
+    currentTask?: string;
+    completedTasks?: string[];
+    decisions?: string[];
+    context?: string;
+    files?: string[];
+}
+/**
+ * Result of attempting to parse a SUMMARY block.
+ */
+export interface SummaryParseResult {
+    found: boolean;
+    valid: boolean;
+    summary: ParsedSummary | null;
+    rawContent: string | null;
+}
+/**
+ * Parse [[SUMMARY]]...[[/SUMMARY]] blocks from agent output.
+ * Agents can output summaries to keep a running context of their work.
+ *
+ * Format:
+ * [[SUMMARY]]
+ * {
+ *   "currentTask": "Working on auth module",
+ *   "context": "Completed login flow, now implementing logout",
+ *   "files": ["src/auth.ts", "src/session.ts"]
+ * }
+ * [[/SUMMARY]]
+ */
+export declare function parseSummaryFromOutput(output: string): ParsedSummary | null;
+/**
+ * Parse SUMMARY block with full details for deduplication.
+ * Returns raw content to allow caller to dedupe before logging errors.
+ */
+export declare function parseSummaryWithDetails(output: string): SummaryParseResult;
+/**
+ * Session end marker from agent output.
+ */
+export interface SessionEndMarker {
+    summary?: string;
+    completedTasks?: string[];
+}
+/**
+ * Parse [[SESSION_END]]...[[/SESSION_END]] blocks from agent output.
+ * Agents output this to explicitly mark their session as complete.
+ *
+ * Format:
+ * [[SESSION_END]]
+ * {"summary": "Completed auth module implementation", "completedTasks": ["login", "logout"]}
+ * [[/SESSION_END]]
+ *
+ * Or simply: [[SESSION_END]][[/SESSION_END]] for a clean close without summary.
+ */
+export declare function parseSessionEndFromOutput(output: string): SessionEndMarker | null;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAoHD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAmKD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,kBAAkB,CAAsC;IAGhE,OAAO,CAAC,eAAe,CAAS;IAGhC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,yBAAyB,CAAiC;IAClE,OAAO,CAAC,mBAAmB,CAAiC;IAC5D,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,gBAAgB,CAAgD;IAGxE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,GAAE,aAAkB;IAWvC;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAiElE;;;OAGG;IACH,OAAO,CAAC,cAAc;IAqEtB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IA6PxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;IAmJnB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAqEnB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAchC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAkN7B;;OAEG;IACH,KAAK,IAAI;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAoBtD;;OAEG;IACH,KAAK,IAAI,IAAI;CAiBd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACvC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAehF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAe1E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAkBjF"}