@relayflows/core 0.0.1 → 1.0.1

package/dist/builtin-templates/review-loop.yaml

@@ -0,0 +1,227 @@
+version: '1.0'
+name: review-loop
+description: 'Implement a task with automated multi-perspective code review loop. Inspired by claude-review-loop pattern.'
+swarm:
+  pattern: review-loop
+  maxConcurrency: 4
+  timeoutMs: 3600000
+  channel: swarm-review-loop
+  idleNudge:
+    nudgeAfterMs: 180000
+    escalateAfterMs: 180000
+    maxNudges: 2
+agents:
+  - name: implementer
+    cli: claude
+    role: 'Senior developer implementing the task and addressing review feedback'
+    permissions: { access: full }
+  - name: reviewer-diff
+    cli: codex
+    role: 'Code quality reviewer focusing on git diff, tests, and potential bugs'
+    permissions: { access: readonly }
+    interactive: false
+  - name: reviewer-architecture
+    cli: claude
+    role: 'Architecture and design reviewer assessing structure and maintainability'
+    permissions: { access: readonly }
+    interactive: false
+  - name: reviewer-security
+    cli: codex
+    role: 'Security reviewer checking for OWASP Top 10 vulnerabilities'
+    permissions: { access: readonly }
+    interactive: false
+workflows:
+  - name: review-loop-workflow
+    description: 'Implement task, run parallel reviews, consolidate feedback, and address issues.'
+    onError: fail
+    steps:
+      # Phase 1: Implementation
+      - name: implement
+        type: agent
+        agent: implementer
+        task: |
+          Implement the following task:
+          {{task}}
+
+          When complete, output: IMPLEMENTATION COMPLETE
+        verification:
+          type: output_contains
+          value: IMPLEMENTATION COMPLETE
+
+      # Deterministic: Capture diff for review
+      - name: capture-diff
+        type: deterministic
+        dependsOn: [implement]
+        command: git diff HEAD~1 2>/dev/null || git diff 2>/dev/null || echo "No changes"
+        captureOutput: true
+
+      # Deterministic: Capture file list
+      - name: capture-files
+        type: deterministic
+        dependsOn: [capture-diff]
+        command: git diff --name-only HEAD~1 2>/dev/null || git diff --name-only 2>/dev/null || echo "No files"
+        captureOutput: true
+
+      # Phase 2: Parallel Reviews (fan-out)
+      - name: review-diff
+        type: agent
+        agent: reviewer-diff
+        dependsOn: [capture-files]
+        task: |
+          Review the git diff for code quality issues:
+
+          Focus areas:
+          - Code readability and clarity
+          - Test coverage (are new features tested?)
+          - Potential bugs or edge cases
+          - Error handling completeness
+
+          Changed files: {{steps.capture-files.output}}
+
+          Diff:
+          {{steps.capture-diff.output}}
+
+          Output format:
+          - If all looks good: REVIEW:PASS
+          - If issues found: REVIEW:ISSUES followed by numbered list of issues
+        verification:
+          type: output_contains
+          value: 'REVIEW:'
+
+      - name: review-architecture
+        type: agent
+        agent: reviewer-architecture
+        dependsOn: [capture-files]
+        task: |
+          Review the architecture and design:
+
+          Focus areas:
+          - Design patterns and best practices
+          - Separation of concerns
+          - Code organization and maintainability
+          - API design (if applicable)
+
+          Changed files: {{steps.capture-files.output}}
+
+          Diff:
+          {{steps.capture-diff.output}}
+
+          Output format:
+          - If all looks good: REVIEW:PASS
+          - If issues found: REVIEW:ISSUES followed by numbered list of issues
+        verification:
+          type: output_contains
+          value: 'REVIEW:'
+
+      - name: review-security
+        type: agent
+        agent: reviewer-security
+        dependsOn: [capture-files]
+        task: |
+          Security review for OWASP Top 10 vulnerabilities:
+
+          Focus areas:
+          - Injection vulnerabilities (SQL, command, XSS)
+          - Authentication and authorization issues
+          - Sensitive data exposure
+          - Security misconfiguration
+          - Input validation
+
+          Changed files: {{steps.capture-files.output}}
+
+          Diff:
+          {{steps.capture-diff.output}}
+
+          Output format:
+          - If secure: REVIEW:PASS
+          - If vulnerabilities found: REVIEW:ISSUES followed by numbered list with severity
+        verification:
+          type: output_contains
+          value: 'REVIEW:'
+
+      # Phase 3: Consolidate reviews
+      - name: consolidate
+        type: agent
+        agent: implementer
+        dependsOn: [review-diff, review-architecture, review-security]
+        task: |
+          Review all feedback from the code reviewers and consolidate findings:
+
+          ## Diff Review
+          {{steps.review-diff.output}}
+
+          ## Architecture Review
+          {{steps.review-architecture.output}}
+
+          ## Security Review
+          {{steps.review-security.output}}
+
+          Tasks:
+          1. Analyze each review's findings
+          2. Identify which issues are valid and should be addressed
+          3. Note any conflicting feedback
+          4. Create a prioritized action plan
+
+          Output: CONSOLIDATED with summary of issues to address (or NO_ISSUES if all reviews passed)
+        verification:
+          type: output_contains
+          value: CONSOLIDATED
+
+      # Phase 4: Address feedback (the loop)
+      - name: address-feedback
+        type: agent
+        agent: implementer
+        dependsOn: [consolidate]
+        task: |
+          Address the consolidated review feedback:
+
+          {{steps.consolidate.output}}
+
+          For each valid issue:
+          1. Make the necessary code changes
+          2. Explain what was fixed and why
+
+          If there were no issues to address, confirm the implementation is complete.
+
+          Output: ADDRESSED followed by summary of changes made (or NO_CHANGES_NEEDED)
+        verification:
+          type: output_contains
+          value: ADDRESSED
+        retries: 2
+        maxIterations: 3
+
+      # Final step: Completion summary
+      - name: complete
+        type: agent
+        agent: implementer
+        dependsOn: [address-feedback]
+        task: |
+          Provide a final summary of the completed work:
+
+          Original task: {{task}}
+
+          Include:
+          1. What was implemented
+          2. Key decisions made
+          3. Review feedback that was addressed
+          4. Any remaining considerations or follow-up items
+
+          Output: DONE
+        verification:
+          type: output_contains
+          value: DONE
+
+coordination:
+  barriers:
+    - name: reviews-complete
+      waitFor: [review-diff, review-architecture, review-security]
+      timeoutMs: 900000
+  consensusStrategy: majority
+state:
+  backend: memory
+  ttlMs: 21600000
+  namespace: review-loop
+errorHandling:
+  strategy: continue
+  maxRetries: 2
+  notifyChannel: swarm-review-loop

package/dist/builtin-templates/security-audit.yaml

@@ -0,0 +1,139 @@
+version: '1.0'
+name: security-audit
+description: 'Blueprint-style security assessment with deterministic scanning and agent triage.'
+swarm:
+  pattern: pipeline
+  maxConcurrency: 1
+  timeoutMs: 5400000
+  channel: swarm-security-audit
+  idleNudge:
+    nudgeAfterMs: 120000
+    escalateAfterMs: 120000
+    maxNudges: 1
+agents:
+  - name: lead
+    cli: claude
+    role: 'Owns final risk sign-off and recommendations'
+    permissions: { access: full }
+  - name: analyst
+    cli: claude
+    role: 'Prioritizes findings and recommends mitigations'
+    permissions:
+      access: readonly
+      files:
+        deny: ['.env', 'secrets/**', '*.pem', '*.key']
+  - name: remediator
+    cli: codex
+    role: 'Implements approved remediations'
+    permissions: { access: readwrite }
+    interactive: false
+  - name: verifier
+    cli: gemini
+    role: 'Verifies fixes and residual exposure'
+    permissions:
+      access: readonly
+      files:
+        deny: ['.env', 'secrets/**', '*.pem', '*.key']
+workflows:
+  - name: audit-pipeline
+    description: 'Scan, triage, remediate, verify, and report security posture.'
+    onError: fail
+    preflight:
+      - command: npm audit --json 2>/dev/null | head -100 || echo "{}"
+        description: 'Run npm audit preflight check'
+      - command: git diff --check 2>/dev/null || echo "clean"
+        description: 'Check for whitespace errors'
+    steps:
+      # Deterministic: Run npm audit
+      - name: scan-npm
+        type: deterministic
+        command: npm audit --json 2>/dev/null || echo '{"vulnerabilities":{}}'
+        captureOutput: true
+
+      # Deterministic: Run additional security scans if available
+      - name: scan-extra
+        type: deterministic
+        dependsOn: [scan-npm]
+        command: |
+          if command -v semgrep &> /dev/null; then
+            semgrep --config auto --json . 2>/dev/null || echo '{"results":[]}'
+          else
+            echo '{"results":[],"note":"semgrep not installed"}'
+          fi
+
+      # Agent: Triage findings
+      - name: triage
+        type: agent
+        agent: analyst
+        dependsOn: [scan-npm, scan-extra]
+        task: |
+          Prioritize security findings by severity and exploitability:
+
+          NPM Audit: {{steps.scan-npm.output}}
+          Additional Scans: {{steps.scan-extra.output}}
+
+          Task context: {{task}}
+        verification:
+          type: output_contains
+          value: TRIAGE_COMPLETE
+
+      # Agent: Implement remediations
+      - name: remediate
+        type: agent
+        agent: remediator
+        dependsOn: [triage]
+        task: |
+          Implement mitigations for approved findings:
+          {{steps.triage.output}}
+        retries: 1
+        verification:
+          type: output_contains
+          value: REMEDIATION_COMPLETE
+
+      # Deterministic: Re-run tests
+      - name: test
+        type: deterministic
+        dependsOn: [remediate]
+        command: npm test 2>/dev/null || echo "No tests configured"
+
+      # Agent: Verify fixes
+      - name: verify
+        type: agent
+        agent: verifier
+        dependsOn: [test]
+        task: |
+          Re-test security posture and confirm mitigations hold:
+          {{steps.remediate.output}}
+          Test results: {{steps.test.output}}
+        verification:
+          type: output_contains
+          value: VERIFICATION_COMPLETE
+
+      # Deterministic: Commit security fixes
+      - name: commit
+        type: deterministic
+        dependsOn: [verify]
+        command: 'git add -A && git commit -m "security: address vulnerabilities from audit" 2>/dev/null || echo "No changes to commit"'
+
+      # Agent: Final report
+      - name: report
+        type: agent
+        agent: lead
+        dependsOn: [commit]
+        task: |
+          Produce final audit report with residual risk and next actions.
+        verification:
+          type: output_contains
+          value: DONE
+coordination:
+  barriers:
+    - name: audit-complete
+      waitFor: [scan-npm, triage, remediate, verify]
+      timeoutMs: 1200000
+state:
+  backend: memory
+  ttlMs: 86400000
+  namespace: security-audit
+errorHandling:
+  strategy: fail-fast
+  notifyChannel: swarm-security-audit

package/dist/channel-messenger.d.ts

@@ -0,0 +1,28 @@
+import type { StepOutcome } from './trajectory.js';
+import type { AgentDefinition, WorkflowStepRow } from './types.js';
+type StepStateLike = {
+    row: Pick<WorkflowStepRow, 'agentName' | 'status'>;
+};
+export interface ChannelRelayLike {
+    send(to: string, text: string): Promise<unknown>;
+}
+export interface ChannelMessengerOptions {
+    postFn?: (text: string) => void;
+}
+export declare function sendToChannel(relay: ChannelRelayLike, channel: string, message: string): Promise<void>;
+export declare function truncateMessage(message: string, maxLength: number): string;
+export declare function formatStepOutput(stepName: string, output: string, maxLength?: number): string;
+export declare function formatError(stepName: string, error: unknown): string;
+export declare function scrubSecrets(text: string): string;
+export declare function scrubForChannel(text: string): string;
+export declare class ChannelMessenger {
+    private readonly postFn?;
+    constructor(options?: ChannelMessengerOptions);
+    buildNonInteractiveAwareness(agentMap: Map<string, AgentDefinition>, stepStates: Map<string, StepStateLike>): string | undefined;
+    buildRelayRegistrationNote(cli: string, agentName: string): string;
+    buildDelegationGuidance(cli: string, timeoutMs?: number): string;
+    postCompletionReport(workflowName: string, outcomes: StepOutcome[], summary: string, confidence: number): void;
+    postFailureReport(workflowName: string, outcomes: StepOutcome[], errorMsg: string): void;
+}
+export {};
+//# sourceMappingURL=channel-messenger.d.ts.map

package/dist/channel-messenger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-messenger.d.ts","sourceRoot":"","sources":["../src/channel-messenger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,KAAK,aAAa,GAAG;IACnB,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,MAAM,CAQ3F;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAKpE;AA+CD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjD;AAWD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmFpD;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAyB;gBAErC,OAAO,GAAE,uBAA4B;IAIjD,4BAA4B,CAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACtC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACrC,MAAM,GAAG,SAAS;IA6BrB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAalE,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAmChE,oBAAoB,CAClB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,IAAI;IA6BP,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAoBzF"}

package/dist/channel-messenger.js

@@ -0,0 +1,275 @@
+import stripAnsiFn from 'strip-ansi';
+export async function sendToChannel(relay, channel, message) {
+    await relay.send(channel, message);
+}
+export function truncateMessage(message, maxLength) {
+    if (maxLength <= 0)
+        return '';
+    return message.length > maxLength ? message.slice(-maxLength) : message;
+}
+export function formatStepOutput(stepName, output, maxLength = 2000) {
+    const scrubbed = scrubForChannel(output);
+    if (scrubbed.length === 0) {
+        return `**[${stepName}]** Step completed — output written to disk`;
+    }
+    const preview = truncateMessage(scrubbed, maxLength);
+    return `**[${stepName}] Output:**\n\`\`\`\n${preview}\n\`\`\``;
+}
+export function formatError(stepName, error) {
+    const raw = error instanceof Error ? error.message : String(error);
+    // Strip absolute paths that could leak internal directory structure
+    const message = raw.replace(/(?:\/[\w.-]+){3,}/g, '[path]');
+    return `**[${stepName}]** Failed: ${message}`;
+}
+// Common secret patterns to redact from channel output.
+const SECRET_PATTERNS = [
+    /(?:api[_-]?key|apikey|secret[_-]?key|access[_-]?token|auth[_-]?token|bearer)\s*[:=]\s*\S+/gi,
+    /(?:sk|pk|rk|ak)[-_][a-zA-Z0-9]{20,}/g,
+    /ghp_[a-zA-Z0-9]{36,}/g,
+    /gho_[a-zA-Z0-9]{36,}/g,
+    /github_pat_[a-zA-Z0-9_]{22,}/g,
+    /xox[bpors]-[a-zA-Z0-9-]+/g,
+    /-----BEGIN\s+(?:RSA\s+)?PRIVATE\s+KEY-----[\s\S]*?-----END/g,
+];
+// Unicode spinner / ornament characters used by Claude TUI animations.
+// Includes block-element chars (▗▖▘▝) used in the Claude Code header bar.
+const SPINNER = '\\u2756\\u2738\\u2739\\u273a\\u273b\\u273c\\u273d\\u2731\\u2732\\u2733\\u2734\\u2735\\u2736\\u2737\\u2743\\u2745\\u2746\\u25d6\\u25d7\\u25d8\\u25d9\\u2022\\u25cf\\u25cb\\u25a0\\u25a1\\u25b6\\u25c0\\u23f5\\u23f6\\u23f7\\u23f8\\u23f9\\u25e2\\u25e3\\u25e4\\u25e5\\u2597\\u2596\\u2598\\u259d\\u2bc8\\u2bc7\\u2bc5\\u2bc6\\u00b7' +
+    '\\u2590\\u258c\\u2588\\u2584\\u2580\\u259a\\u259e' +
+    '\\u2b21\\u2b22';
+// Pre-compiled regex constants — hoisted to module level to avoid recompilation per call.
+const SPINNER_RE = new RegExp(`[${SPINNER}]`, 'gu');
+const SPINNER_CLASS_RE = new RegExp(`^[\\s${SPINNER}]*$`, 'u');
+const BOX_DRAWING_ONLY_RE = /^[\s\u2500-\u257f\u2580-\u259f\u25a0-\u25ff\-_=~]{3,}$/u;
+const BROKER_LOG_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d+Z\s+(?:INFO|WARN|ERROR|DEBUG)\s/u;
+const CLAUDE_HEADER_RE = /^(?:[\s\u2580-\u259f✢*·▗▖▘▝]+\s*)?(?:Claude\s+Code(?:\s+v?[\d.]+)?|(?:Sonnet|Haiku|Opus)\s*[\d.]+|claude-(?:sonnet|haiku|opus)-[\w.-]+|Running\s+on\s+claude)/iu;
+const DIR_BREADCRUMB_RE = /^\s*~[\\/]/u;
+const UI_HINT_RE = /\b(?:Press\s*up\s*to\s*edit|tab\s*to\s*queue|bypass\s*permissions|esc\s*to\s*interrupt|paste\s*again\s*to\s*expand|shift\s*[+]?\s*tab\s*to\s*cycle|running\s+stop\s+hook|fan\s+out\s+subagents)/iu;
+const VIM_MODE_RE = /^[-\s]*--?(?:INSERT|NORMAL|VISUAL|REPLACE)--?[-\s]*$|--?(?:INSERT|NORMAL|VISUAL|REPLACE)--/u;
+const CLAUDE_FOOTER_RE = /(?:Opus|Sonnet|Haiku)\s*\d[\d.]*\s*\(?(?:1M\s*context|context)?\)?\s*ctx\s*:\s*\d+%/iu;
+const THINKING_LINE_RE = new RegExp(`^[\\s${SPINNER}]*\\s*\\w[\\w\\s]*\\u2026\\s*$`, 'u');
+const THINKING_STATUS_RE = /\b(?:thinking\s+(?:with\s+\w+\s+effort|more\s+with|harder)|↓\s*\d+\s*tokens?\b|↑\s*\d+\s*tokens?\b|crunched\s+for\s+\d|sautéed\s+for\s+\d|befuddl|flibbertigib|gitifying|flowing\s*…)/iu;
+const CURSOR_ONLY_RE = /^[\s❯⎿›»◀▶←→↑↓⟨⟩⟪⟫·]+$/u;
+const CURSOR_AGENT_RE = /^(?:Cursor Agent|[\s⬡⬢]*Generating[.\s]|\[Pasted text|Auto-run all|Add a follow-up|ctrl\+c to stop|shift\+tab|Auto$|\/\s*commands|@\s*files|!\s*shell|follow-ups?\s|The user ha)/iu;
+const SLASH_COMMAND_RE = /^\/\w+\s*$/u;
+const MCP_JSON_KV_RE = /^\s*"(?:type|method|params|result|id|jsonrpc|tool|name|arguments|content|role|metadata)"\s*:/u;
+const MEANINGFUL_CONTENT_RE = /[a-zA-Z0-9]/u;
+const MALFORMED_PTY_FRAME_RUN_RE = /(?:(?:qW0|q[A-Za-z]?0|[lmjkx]q{2,}|q{2,}[lmjkx]?)[\s|/_=\-~]*){4,}/giu;
+const MALFORMED_PTY_FRAME_ONLY_RE = /^[\s|/_=\-~lmjkxqtwuvn0W]{12,}$/iu;
+export function scrubSecrets(text) {
+    let result = text;
+    for (const pattern of SECRET_PATTERNS) {
+        result = result.replace(pattern, '[REDACTED]');
+    }
+    return result;
+}
+function stripMalformedPtyFrameGarbage(line) {
+    const strippedRuns = line.replace(MALFORMED_PTY_FRAME_RUN_RE, ' ');
+    const compact = strippedRuns.replace(SPINNER_RE, '').replace(/\s+/g, '');
+    if (compact.length >= 12 && MALFORMED_PTY_FRAME_ONLY_RE.test(compact)) {
+        return '';
+    }
+    return strippedRuns;
+}
+export function scrubForChannel(text) {
+    // Strip system-reminder blocks (closed or unclosed) iteratively to avoid
+    // polynomial backtracking (ReDoS) with [\s\S]*? on adversarial input.
+    let withoutSystemReminders = text;
+    const openTag = '<system-reminder>';
+    const closeTag = '</system-reminder>';
+    let idx;
+    while ((idx = withoutSystemReminders.toLowerCase().indexOf(openTag)) !== -1) {
+        const closeIdx = withoutSystemReminders.toLowerCase().indexOf(closeTag, idx + openTag.length);
+        if (closeIdx !== -1) {
+            withoutSystemReminders =
+                withoutSystemReminders.slice(0, idx) + withoutSystemReminders.slice(closeIdx + closeTag.length);
+        }
+        else {
+            // Unclosed tag — strip everything from the opening tag onward
+            withoutSystemReminders = withoutSystemReminders.slice(0, idx);
+            break;
+        }
+    }
+    // Normalize CRLF and bare \r before stripping ANSI — PTY output often
+    // contains \r\r\n which leaves stray \r after stripping that confuse line splitting.
+    const normalized = withoutSystemReminders.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    const ansiStripped = stripAnsiFn(normalized);
+    // Redact secrets before further processing
+    const secretsRedacted = scrubSecrets(ansiStripped);
+    const countJsonDepth = (line) => {
+        let depth = 0;
+        for (const ch of line) {
+            if (ch === '{' || ch === '[')
+                depth += 1;
+            if (ch === '}' || ch === ']')
+                depth -= 1;
+        }
+        return depth;
+    };
+    const lines = secretsRedacted.split('\n');
+    const meaningful = [];
+    let jsonDepth = 0;
+    for (const line of lines) {
+        const cleanedLine = stripMalformedPtyFrameGarbage(line);
+        const trimmed = cleanedLine.trim();
+        if (jsonDepth > 0) {
+            jsonDepth += countJsonDepth(cleanedLine);
+            if (jsonDepth <= 0)
+                jsonDepth = 0;
+            continue;
+        }
+        if (trimmed.length === 0)
+            continue;
+        if (trimmed.startsWith('{') || /^\[\s*\{/.test(trimmed)) {
+            jsonDepth = Math.max(countJsonDepth(cleanedLine), 0);
+            continue;
+        }
+        if (MCP_JSON_KV_RE.test(cleanedLine))
+            continue;
+        if (SPINNER_CLASS_RE.test(trimmed))
+            continue;
+        if (BOX_DRAWING_ONLY_RE.test(trimmed))
+            continue;
+        if (BROKER_LOG_RE.test(trimmed))
+            continue;
+        if (CLAUDE_HEADER_RE.test(trimmed))
+            continue;
+        if (DIR_BREADCRUMB_RE.test(trimmed))
+            continue;
+        if (UI_HINT_RE.test(trimmed))
+            continue;
+        if (VIM_MODE_RE.test(trimmed))
+            continue;
+        if (CLAUDE_FOOTER_RE.test(trimmed))
+            continue;
+        if (THINKING_LINE_RE.test(trimmed))
+            continue;
+        if (THINKING_STATUS_RE.test(trimmed))
+            continue;
+        if (CURSOR_ONLY_RE.test(trimmed))
+            continue;
+        if (CURSOR_AGENT_RE.test(trimmed))
+            continue;
+        if (SLASH_COMMAND_RE.test(trimmed))
+            continue;
+        if (!MEANINGFUL_CONTENT_RE.test(trimmed))
+            continue;
+        const alphanum = trimmed.replace(SPINNER_RE, '').replace(/\s+/g, '');
+        if (alphanum.replace(/[^a-zA-Z0-9]/g, '').length <= 3)
+            continue;
+        meaningful.push(cleanedLine);
+    }
+    return meaningful
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+export class ChannelMessenger {
+    postFn;
+    constructor(options = {}) {
+        this.postFn = options.postFn;
+    }
+    buildNonInteractiveAwareness(agentMap, stepStates) {
+        const nonInteractive = [...agentMap.values()].filter((agent) => agent.interactive === false);
+        if (nonInteractive.length === 0)
+            return undefined;
+        const agentToSteps = new Map();
+        for (const [stepName, state] of stepStates) {
+            const agentName = state.row.agentName;
+            if (!agentName)
+                continue;
+            if (!agentToSteps.has(agentName))
+                agentToSteps.set(agentName, []);
+            agentToSteps.get(agentName).push(stepName);
+        }
+        const lines = nonInteractive.map((agent) => {
+            const stepRefs = (agentToSteps.get(agent.name) ?? []).map((stepName) => `{{steps.${stepName}.output}}`);
+            return (`- ${agent.name} (${agent.cli}) — will return output when complete` +
+                (stepRefs.length > 0 ? `. Access via: ${stepRefs.join(', ')}` : ''));
+        });
+        return ('\n\n---\n' +
+            'Note: The following agents are non-interactive workers and cannot receive messages:\n' +
+            lines.join('\n') +
+            '\n' +
+            'Do NOT attempt to message these agents. Use the {{steps.<name>.output}} references above to access their results.');
+    }
+    buildRelayRegistrationNote(cli, agentName) {
+        if (cli === 'claude')
+            return '';
+        return ('---\n' +
+            'RELAY SETUP — do this FIRST before any other relay tool:\n' +
+            `1. Call: register_agent(name="${agentName}")\n` +
+            '   This authenticates you in the Relaycast workspace.\n' +
+            '   ALL relay tools (mcp__relaycast__send_dm, mcp__relaycast__check_inbox, mcp__relaycast__post_message, etc.) require\n' +
+            '   registration first — they will fail with "Not registered" otherwise.\n' +
+            `2. Your agent name is "${agentName}" — use this exact name when registering.`);
+    }
+    buildDelegationGuidance(cli, timeoutMs) {
+        const timeoutNote = timeoutMs
+            ? `You have approximately ${Math.round(timeoutMs / 60000)} minutes before this step times out. ` +
+                'Plan accordingly — delegate early if the work is substantial.\n\n'
+            : '';
+        const subAgentOption = cli === 'claude'
+            ? 'Option 2 — Use built-in sub-agents (Task tool) for research or scoped work:\n' +
+                '  - Good for exploring code, reading files, or making targeted changes\n' +
+                '  - Can run multiple sub-agents in parallel\n\n'
+            : '';
+        return ('---\n' +
+            'AUTONOMOUS DELEGATION — READ THIS BEFORE STARTING:\n' +
+            timeoutNote +
+            'Before diving in, assess whether this task is too large or complex for a single agent. ' +
+            'If it involves multiple independent subtasks, touches many files, or could take a long time, ' +
+            'you should break it down and delegate to helper agents to avoid timeouts.\n\n' +
+            'Option 1 — Spawn relay agents (for real parallel coding work):\n' +
+            '  - mcp__relaycast__add_agent(name="helper-1", cli="claude", task="Specific subtask description")\n' +
+            '  - Coordinate via mcp__relaycast__send_dm(to="helper-1", text="...")\n' +
+            '  - Check on them with mcp__relaycast__check_inbox()\n' +
+            '  - Clean up when done: mcp__relaycast__remove_agent(name="helper-1")\n\n' +
+            subAgentOption +
+            'Guidelines:\n' +
+            '- You are the lead — delegate but stay in control, track progress, integrate results\n' +
+            '- Give each helper a clear, self-contained task with enough context to work independently\n' +
+            "- For simple or quick work, just do it yourself — don't over-delegate\n" +
+            '- Always release spawned relay agents when their work is complete\n' +
+            '- When spawning non-claude agents (codex, gemini, etc.), prepend to their task:\n' +
+            '  "RELAY SETUP: First call register_agent(name=\'<exact-agent-name>\') before any other relay tool."');
+    }
+    postCompletionReport(workflowName, outcomes, summary, confidence) {
+        const completed = outcomes.filter((outcome) => outcome.status === 'completed');
+        const skipped = outcomes.filter((outcome) => outcome.status === 'skipped');
+        const retried = outcomes.filter((outcome) => outcome.attempts > 1);
+        const lines = [
+            `## Workflow **${workflowName}** — Complete`,
+            '',
+            summary,
+            `Confidence: ${Math.round(confidence * 100)}%`,
+            '',
+            '### Steps',
+            ...completed.map((outcome) => `- **${outcome.name}** (${outcome.agent}) — passed${outcome.verificationPassed ? ' (verified)' : ''}${outcome.attempts > 1 ? ` after ${outcome.attempts} attempts` : ''}`),
+            ...skipped.map((outcome) => `- **${outcome.name}** — skipped`),
+        ];
+        if (retried.length > 0) {
+            lines.push('', '### Retries');
+            for (const outcome of retried) {
+                lines.push(`- ${outcome.name}: ${outcome.attempts} attempts`);
+            }
+        }
+        this.postFn?.(lines.join('\n'));
+    }
+    postFailureReport(workflowName, outcomes, errorMsg) {
+        const completed = outcomes.filter((outcome) => outcome.status === 'completed');
+        const failed = outcomes.filter((outcome) => outcome.status === 'failed');
+        const skipped = outcomes.filter((outcome) => outcome.status === 'skipped');
+        const lines = [
+            `## Workflow **${workflowName}** — Failed`,
+            '',
+            `${completed.length}/${outcomes.length} steps passed. Error: ${errorMsg}`,
+            '',
+            '### Steps',
+            ...completed.map((outcome) => `- **${outcome.name}** (${outcome.agent}) — passed`),
+            ...failed.map((outcome) => `- **${outcome.name}** (${outcome.agent}) — FAILED: ${outcome.error ?? 'unknown'}`),
+            ...skipped.map((outcome) => `- **${outcome.name}** — skipped`),
+        ];
+        this.postFn?.(lines.join('\n'));
+    }
+}
+//# sourceMappingURL=channel-messenger.js.map