agent-relay 1.0.7 → 1.0.9

package/dist/wrapper/parser.d.ts

@@ -3,13 +3,13 @@
  * Extracts relay commands from agent terminal output.
  *
  * Supports two formats:
- * 1. Inline: @relay:<target> <message> (single line, start of line only)
+ * 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
+ * - Escape with \->relay: to output literal
  * - Block format is preferred for structured data
  */
 import type { PayloadKind } from '../protocol/types.js';
@@ -18,19 +18,47 @@ export interface ParsedCommand {
     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;
     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;
 }
 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 fencedInlineProject;
+    private fencedInlineRaw;
+    private fencedInlineKind;
+    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.
@@ -43,8 +71,8 @@ export declare class OutputParser {
         output: string;
     };
     /**
-     * Find [[RELAY]] that's at the start of a line and not inside a code fence.
-     * Returns the index, or -1 if not found.
+     * 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;
     /**
@@ -75,6 +103,11 @@ export declare class OutputParser {
      * Returns the command (if valid) and any remaining content after [[/RELAY]].
      */
     private finishBlock;
+    /**
+     * 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).
      */
@@ -91,4 +124,94 @@ export declare class OutputParser {
  * Format a relay command for injection into agent input.
  */
 export declare function formatIncomingMessage(from: string, body: string, kind?: PayloadKind): string;
+/**
+ * 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/wrapper/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/wrapper/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,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,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA2BD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAM;gBAEb,OAAO,GAAE,aAAkB;IAIvC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAyDlE;;;OAGG;IACH,OAAO,CAAC,cAAc;IA2DtB;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;IAyGxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IA0DnB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAiCnB;;OAEG;IACH,KAAK,IAAI;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAQtD;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAuB,GAAG,MAAM,CAGvG"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/wrapper/parser.ts"],"names":[],"mappings":"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"}