@relay-harness/coding-agent 0.0.0-stage → 1.0.2

package/dist/core/bash-executor.js

@@ -0,0 +1,106 @@
+/**
+ * Bash command execution with streaming support and cancellation.
+ *
+ * This module provides a unified bash execution implementation used by:
+ * - AgentSession.executeBash() for interactive and RPC modes
+ * - Direct calls from modes that need bash execution
+ */
+import { stripAnsi } from "../utils/ansi.js";
+import { createOutputFileStream } from "../utils/output-files.js";
+import { sanitizeBinaryOutput } from "../utils/shell.js";
+import { DEFAULT_MAX_BYTES, truncateTail } from "./tools/truncate.js";
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Execute a bash command using custom BashOperations.
+ * Used for remote execution (SSH, containers, etc.).
+ */
+export async function executeBashWithOperations(command, cwd, operations, options) {
+    const outputChunks = [];
+    let outputBytes = 0;
+    const maxOutputBytes = DEFAULT_MAX_BYTES * 2;
+    let tempFilePath;
+    let tempFileStream;
+    let totalBytes = 0;
+    const ensureTempFile = () => {
+        if (tempFilePath) {
+            return;
+        }
+        ({ path: tempFilePath, stream: tempFileStream } = createOutputFileStream("relay-bash", ".log"));
+        for (const chunk of outputChunks) {
+            tempFileStream.write(chunk);
+        }
+    };
+    const decoder = new TextDecoder();
+    const onData = (data) => {
+        totalBytes += data.length;
+        // Sanitize: strip ANSI, replace binary garbage, normalize newlines
+        const text = sanitizeBinaryOutput(stripAnsi(decoder.decode(data, { stream: true }))).replace(/\r/g, "");
+        // Start writing to temp file if exceeds threshold
+        if (totalBytes > DEFAULT_MAX_BYTES) {
+            ensureTempFile();
+        }
+        if (tempFileStream) {
+            tempFileStream.write(text);
+        }
+        // Keep rolling buffer
+        outputChunks.push(text);
+        outputBytes += text.length;
+        while (outputBytes > maxOutputBytes && outputChunks.length > 1) {
+            const removed = outputChunks.shift();
+            outputBytes -= removed.length;
+        }
+        // Stream to callback
+        if (options?.onChunk) {
+            options.onChunk(text);
+        }
+    };
+    try {
+        const result = await operations.exec(command, cwd, {
+            onData,
+            signal: options?.signal,
+        });
+        const fullOutput = outputChunks.join("");
+        const truncationResult = truncateTail(fullOutput);
+        if (truncationResult.truncated) {
+            ensureTempFile();
+        }
+        if (tempFileStream) {
+            tempFileStream.end();
+        }
+        const cancelled = options?.signal?.aborted ?? false;
+        return {
+            output: truncationResult.truncated ? truncationResult.content : fullOutput,
+            exitCode: cancelled ? undefined : (result.exitCode ?? undefined),
+            cancelled,
+            truncated: truncationResult.truncated,
+            fullOutputPath: tempFilePath,
+        };
+    }
+    catch (err) {
+        // Check if it was an abort
+        if (options?.signal?.aborted) {
+            const fullOutput = outputChunks.join("");
+            const truncationResult = truncateTail(fullOutput);
+            if (truncationResult.truncated) {
+                ensureTempFile();
+            }
+            if (tempFileStream) {
+                tempFileStream.end();
+            }
+            return {
+                output: truncationResult.truncated ? truncationResult.content : fullOutput,
+                exitCode: undefined,
+                cancelled: true,
+                truncated: truncationResult.truncated,
+                fullOutputPath: tempFilePath,
+            };
+        }
+        if (tempFileStream) {
+            tempFileStream.end();
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=bash-executor.js.map

package/dist/core/bash-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-executor.js","sourceRoot":"","sources":["../../src/core/bash-executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bash command execution with streaming support and cancellation.\n *\n * This module provides a unified bash execution implementation used by:\n * - AgentSession.executeBash() for interactive and RPC modes\n * - Direct calls from modes that need bash execution\n */\n\nimport type { WriteStream } from \"node:fs\";\nimport { stripAnsi } from \"../utils/ansi.ts\";\nimport { createOutputFileStream } from \"../utils/output-files.ts\";\nimport { sanitizeBinaryOutput } from \"../utils/shell.ts\";\nimport type { BashOperations } from \"./tools/bash.ts\";\nimport { DEFAULT_MAX_BYTES, truncateTail } from \"./tools/truncate.ts\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface BashExecutorOptions {\n\t/** Callback for streaming output chunks (already sanitized) */\n\tonChunk?: (chunk: string) => void;\n\t/** AbortSignal for cancellation */\n\tsignal?: AbortSignal;\n}\n\nexport interface BashResult {\n\t/** Combined stdout + stderr output (sanitized, possibly truncated) */\n\toutput: string;\n\t/** Process exit code (undefined if killed/cancelled) */\n\texitCode: number | undefined;\n\t/** Whether the command was cancelled via signal */\n\tcancelled: boolean;\n\t/** Whether the output was truncated */\n\ttruncated: boolean;\n\t/** Path to temp file containing full output (if output exceeded truncation threshold) */\n\tfullOutputPath?: string;\n}\n\n// ============================================================================\n// Implementation\n// ============================================================================\n\n/**\n * Execute a bash command using custom BashOperations.\n * Used for remote execution (SSH, containers, etc.).\n */\nexport async function executeBashWithOperations(\n\tcommand: string,\n\tcwd: string,\n\toperations: BashOperations,\n\toptions?: BashExecutorOptions,\n): Promise<BashResult> {\n\tconst outputChunks: string[] = [];\n\tlet outputBytes = 0;\n\tconst maxOutputBytes = DEFAULT_MAX_BYTES * 2;\n\n\tlet tempFilePath: string | undefined;\n\tlet tempFileStream: WriteStream | undefined;\n\tlet totalBytes = 0;\n\n\tconst ensureTempFile = () => {\n\t\tif (tempFilePath) {\n\t\t\treturn;\n\t\t}\n\t\t({ path: tempFilePath, stream: tempFileStream } = createOutputFileStream(\"relay-bash\", \".log\"));\n\t\tfor (const chunk of outputChunks) {\n\t\t\ttempFileStream.write(chunk);\n\t\t}\n\t};\n\n\tconst decoder = new TextDecoder();\n\n\tconst onData = (data: Buffer) => {\n\t\ttotalBytes += data.length;\n\n\t\t// Sanitize: strip ANSI, replace binary garbage, normalize newlines\n\t\tconst text = sanitizeBinaryOutput(stripAnsi(decoder.decode(data, { stream: true }))).replace(/\\r/g, \"\");\n\n\t\t// Start writing to temp file if exceeds threshold\n\t\tif (totalBytes > DEFAULT_MAX_BYTES) {\n\t\t\tensureTempFile();\n\t\t}\n\n\t\tif (tempFileStream) {\n\t\t\ttempFileStream.write(text);\n\t\t}\n\n\t\t// Keep rolling buffer\n\t\toutputChunks.push(text);\n\t\toutputBytes += text.length;\n\t\twhile (outputBytes > maxOutputBytes && outputChunks.length > 1) {\n\t\t\tconst removed = outputChunks.shift()!;\n\t\t\toutputBytes -= removed.length;\n\t\t}\n\n\t\t// Stream to callback\n\t\tif (options?.onChunk) {\n\t\t\toptions.onChunk(text);\n\t\t}\n\t};\n\n\ttry {\n\t\tconst result = await operations.exec(command, cwd, {\n\t\t\tonData,\n\t\t\tsignal: options?.signal,\n\t\t});\n\n\t\tconst fullOutput = outputChunks.join(\"\");\n\t\tconst truncationResult = truncateTail(fullOutput);\n\t\tif (truncationResult.truncated) {\n\t\t\tensureTempFile();\n\t\t}\n\t\tif (tempFileStream) {\n\t\t\ttempFileStream.end();\n\t\t}\n\t\tconst cancelled = options?.signal?.aborted ?? false;\n\n\t\treturn {\n\t\t\toutput: truncationResult.truncated ? truncationResult.content : fullOutput,\n\t\t\texitCode: cancelled ? undefined : (result.exitCode ?? undefined),\n\t\t\tcancelled,\n\t\t\ttruncated: truncationResult.truncated,\n\t\t\tfullOutputPath: tempFilePath,\n\t\t};\n\t} catch (err) {\n\t\t// Check if it was an abort\n\t\tif (options?.signal?.aborted) {\n\t\t\tconst fullOutput = outputChunks.join(\"\");\n\t\t\tconst truncationResult = truncateTail(fullOutput);\n\t\t\tif (truncationResult.truncated) {\n\t\t\t\tensureTempFile();\n\t\t\t}\n\t\t\tif (tempFileStream) {\n\t\t\t\ttempFileStream.end();\n\t\t\t}\n\t\t\treturn {\n\t\t\t\toutput: truncationResult.truncated ? truncationResult.content : fullOutput,\n\t\t\t\texitCode: undefined,\n\t\t\t\tcancelled: true,\n\t\t\t\ttruncated: truncationResult.truncated,\n\t\t\t\tfullOutputPath: tempFilePath,\n\t\t\t};\n\t\t}\n\n\t\tif (tempFileStream) {\n\t\t\ttempFileStream.end();\n\t\t}\n\n\t\tthrow err;\n\t}\n}\n"]}

package/dist/core/bug-report.d.ts

@@ -0,0 +1,176 @@
+import type { AgentMessage, StreamFn, ThinkingLevel } from "@relay-harness/agent-core";
+import { type RetryPolicy } from "@relay-harness/ai";
+import type { Api, Model } from "@relay-harness/ai/compat";
+import type { CrashRecord } from "./crash-log.ts";
+import type { Extension } from "./extensions/types.ts";
+import type { ModelRuntime } from "./model-runtime.ts";
+import type { ReadonlySessionManager } from "./session-manager.ts";
+import type { Settings } from "./settings-manager.ts";
+export declare const BUG_REPORT_CUSTOM_ENTRY_TYPE = "relay.bug-report";
+/** Strip credentials and secret-looking query parameters from a URL. */
+export declare function redactUrl(value: string): string;
+/** Copy a JSON value while removing values that may contain credentials. */
+export declare function redactJsonValue(value: unknown): unknown;
+interface CollectBugReportMetadataOptions {
+    id?: string;
+    hint?: string;
+    sessionId: string;
+    cwd: string;
+    includeSession: boolean;
+    includeSummary: boolean;
+    messageCount: number;
+    model?: Model<Api>;
+    modelRuntime: ModelRuntime;
+    thinkingLevel: ThinkingLevel;
+    extensions: readonly Extension[];
+    extensionErrors: ReadonlyArray<{
+        path: string;
+        error: string;
+    }>;
+    globalSettings: Settings;
+    projectSettings: Settings;
+}
+export declare function collectBugReportMetadata(options: CollectBugReportMetadataOptions): {
+    schemaVersion: number;
+    id: string;
+    createdAt: string;
+    hint: string | null;
+    environment: {
+        version: string;
+        userAgent: string;
+        runtime: string;
+        platform: NodeJS.Platform;
+        arch: NodeJS.Architecture;
+        osRelease: string;
+        osVersion: string;
+        shell: string | null;
+        terminal: {
+            term: string | null;
+            program: string | null;
+            programVersion: string | null;
+            colorterm: string | null;
+            tmux: boolean;
+            ssh: boolean;
+            ci: boolean;
+        };
+        relayEnvironmentVariables: string[];
+    };
+    session: {
+        id: string;
+        included: boolean;
+        summaryIncluded: boolean;
+        messageCount: number;
+        cwd?: string | undefined;
+    };
+    model: {
+        provider: string;
+        id: string;
+        name: string;
+        api: Api;
+        baseUrl: string;
+        reasoning: boolean;
+        input: ("image" | "text")[];
+        contextWindow: number;
+        maxTokens: number;
+        samplingParams: unknown;
+        compat: unknown;
+        thinkingLevelMap: Partial<Record<import("@relay-harness/ai").ModelThinkingLevel, string | null>> | null;
+        headerNames: string[];
+    } | null;
+    provider: {
+        id: string;
+        name: string;
+        baseUrl: string | null;
+        headerNames: string[];
+        authTypes: ("api_key" | "oauth")[];
+        authStatus: import("./provider-composer.ts").AuthStatus;
+        usingOAuth: boolean;
+        registeredByExtension: boolean;
+    } | null;
+    thinkingLevel: ThinkingLevel;
+    extensions: {
+        path: string;
+        source: string;
+        scope: import("./source-info.ts").SourceScope;
+        origin: import("./source-info.ts").SourceOrigin;
+        hidden: boolean;
+    }[];
+    extensionErrors: {
+        path: string;
+        error: string;
+    }[];
+    settings: {
+        global: Settings;
+        project: Settings;
+    };
+};
+/** Collect failed assistant turns without collecting conversation content. */
+export declare function collectBugReportDiagnostics(sessionManager: ReadonlySessionManager, crashes?: readonly CrashRecord[]): {
+    schemaVersion: number;
+    sessionId: string;
+    entryCount: number;
+    assistantMessageCount: number;
+    assistant: {
+        entryId: string;
+        timestamp: string;
+        provider: string;
+        model: string;
+        api: Api;
+        stopReason: import("@relay-harness/ai").StopReason;
+        rawStopReason?: string | undefined;
+        errorMessage?: string | undefined;
+        diagnostics: import("@relay-harness/ai").AssistantMessageDiagnostic[];
+    }[];
+    crashes: {
+        timestamp: string;
+        version: string;
+        kind: "uncaught_exception" | "fatal_error";
+        message: string;
+        stack: string | null;
+        sessionFile: string | null;
+        cwd: string;
+    }[];
+};
+export type BugReportMetadata = ReturnType<typeof collectBugReportMetadata>;
+export type BugReportDiagnostics = ReturnType<typeof collectBugReportDiagnostics>;
+export interface BugReportBundle {
+    metadata: BugReportMetadata;
+    diagnostics: BugReportDiagnostics;
+    sessionJsonl?: string;
+    summary?: string;
+}
+export interface BugReportSessionEntryData {
+    id: string;
+    createdAt: string;
+    hint: string | null;
+    sessionIncluded: boolean;
+    summaryIncluded: boolean;
+    delivery: "zip";
+    path?: string;
+}
+interface BugReportFile {
+    name: string;
+    contentType: string;
+    data: string;
+}
+/** Files written to the bug report zip archive. */
+export declare function bugReportFiles(bundle: BugReportBundle): BugReportFile[];
+export declare function writeBugReportArchive(bundle: BugReportBundle, filePath: string): Promise<void>;
+export declare function bugReportArchiveFileName(id: string): string;
+interface GenerateBugReportSummaryOptions {
+    messages: readonly AgentMessage[];
+    hint?: string;
+    model: Model<Api>;
+    apiKey?: string;
+    headers?: Record<string, string>;
+    env?: Record<string, string>;
+    signal: AbortSignal;
+    thinkingLevel?: ThinkingLevel;
+    streamFn?: StreamFn;
+    retry?: RetryPolicy;
+    sessionId?: string;
+}
+/** Ask the session model for a report when the user does not share the transcript. */
+export declare function generateBugReportSummary(options: GenerateBugReportSummaryOptions): Promise<string>;
+export {};
+//# sourceMappingURL=bug-report.d.ts.map

package/dist/core/bug-report.d.ts.map

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

package/dist/core/bug-report.js

@@ -0,0 +1,292 @@
+import * as os from "node:os";
+import { contentText, normalizeContext, uuidv7 } from "@relay-harness/ai";
+import { VERSION } from "../config.js";
+import { getRelayUserAgent } from "../utils/relay-user-agent.js";
+import { writeZipArchive } from "../utils/zip.js";
+import { completeSummarization, estimateTokens, getSummarizationFailure } from "./compaction/compaction.js";
+import { serializeConversation } from "./compaction/utils.js";
+import { convertToLlm } from "./messages.js";
+export const BUG_REPORT_CUSTOM_ENTRY_TYPE = "relay.bug-report";
+const BUG_REPORT_SCHEMA_VERSION = 1;
+const REDACTED = "<redacted>";
+const SENSITIVE_KEY = /(?:^|[-_])(api[-_]?key|secret|token|password|passwd|credential|authorization|cookie)(?:$|[-_])/i;
+function isSensitiveKey(key) {
+    return SENSITIVE_KEY.test(key.replace(/([a-z0-9])([A-Z])/g, "$1_$2"));
+}
+/** Strip credentials and secret-looking query parameters from a URL. */
+export function redactUrl(value) {
+    const nested = /^([a-z][a-z0-9+.-]*:)([a-z][a-z0-9+.-]*:\/\/.*)$/i.exec(value);
+    if (nested)
+        return `${nested[1]}${redactUrl(nested[2])}`;
+    try {
+        const url = new URL(value);
+        let changed = false;
+        if (url.username || url.password) {
+            url.username = "";
+            url.password = "";
+            changed = true;
+        }
+        for (const key of url.searchParams.keys()) {
+            if (isSensitiveKey(key)) {
+                url.searchParams.set(key, REDACTED);
+                changed = true;
+            }
+        }
+        return changed ? url.toString() : value;
+    }
+    catch {
+        return value;
+    }
+}
+/** Copy a JSON value while removing values that may contain credentials. */
+export function redactJsonValue(value) {
+    if (value === undefined)
+        return undefined;
+    return JSON.parse(JSON.stringify(value, (key, child) => {
+        if (child !== null && child !== undefined && isSensitiveKey(key))
+            return REDACTED;
+        return typeof child === "string" ? redactUrl(child) : child;
+    }));
+}
+function redactSettings(settings) {
+    const { trackingId: _trackingId, deviceId: _deviceId, ...rest } = settings;
+    return redactJsonValue(rest);
+}
+function collectEnvironment() {
+    const env = (name) => process.env[name] || null;
+    return {
+        version: VERSION,
+        userAgent: getRelayUserAgent(VERSION),
+        runtime: process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`,
+        platform: process.platform,
+        arch: process.arch,
+        osRelease: os.release(),
+        osVersion: os.version(),
+        shell: process.env.SHELL?.split(/[\\/]/).pop() || null,
+        terminal: {
+            term: env("TERM"),
+            program: env("TERM_PROGRAM"),
+            programVersion: env("TERM_PROGRAM_VERSION"),
+            colorterm: env("COLORTERM"),
+            tmux: Boolean(process.env.TMUX),
+            ssh: Boolean(process.env.SSH_CONNECTION || process.env.SSH_CLIENT || process.env.SSH_TTY),
+            ci: Boolean(process.env.CI),
+        },
+        // Names help diagnose configuration; values never leave the machine.
+        relayEnvironmentVariables: Object.keys(process.env)
+            .filter((name) => name.startsWith("RELAY_"))
+            .sort(),
+    };
+}
+function describeModel(model) {
+    return {
+        provider: model.provider,
+        id: model.id,
+        name: model.name,
+        api: model.api,
+        baseUrl: redactUrl(model.baseUrl),
+        reasoning: model.reasoning,
+        input: model.input,
+        contextWindow: model.contextWindow,
+        maxTokens: model.maxTokens,
+        samplingParams: model.samplingParams ? redactJsonValue(model.samplingParams) : null,
+        compat: model.compat ? redactJsonValue(model.compat) : null,
+        thinkingLevelMap: model.thinkingLevelMap ?? null,
+        headerNames: Object.keys(model.headers ?? {}).sort(),
+    };
+}
+function describeProvider(modelRuntime, provider) {
+    const authTypes = [];
+    if (provider.auth.apiKey)
+        authTypes.push("api_key");
+    if (provider.auth.oauth)
+        authTypes.push("oauth");
+    return {
+        id: provider.id,
+        name: provider.name,
+        baseUrl: provider.baseUrl ? redactUrl(provider.baseUrl) : null,
+        headerNames: Object.keys(provider.headers ?? {}).sort(),
+        authTypes,
+        authStatus: modelRuntime.getProviderAuthStatus(provider.id),
+        usingOAuth: modelRuntime.isUsingOAuth(provider.id),
+        registeredByExtension: modelRuntime.getRegisteredProviderIds().includes(provider.id),
+    };
+}
+function describeExtension(extension) {
+    return {
+        path: extension.path,
+        source: redactUrl(extension.sourceInfo.source),
+        scope: extension.sourceInfo.scope,
+        origin: extension.sourceInfo.origin,
+        hidden: extension.hidden === true,
+    };
+}
+export function collectBugReportMetadata(options) {
+    const hint = options.hint?.trim() || null;
+    const provider = options.model ? options.modelRuntime.getProvider(options.model.provider) : undefined;
+    return {
+        schemaVersion: BUG_REPORT_SCHEMA_VERSION,
+        id: options.id ?? uuidv7(),
+        createdAt: new Date().toISOString(),
+        hint,
+        environment: collectEnvironment(),
+        session: {
+            id: options.sessionId,
+            included: options.includeSession,
+            summaryIncluded: options.includeSummary,
+            messageCount: options.messageCount,
+            ...(options.includeSession ? { cwd: options.cwd } : {}),
+        },
+        model: options.model ? describeModel(options.model) : null,
+        provider: provider ? describeProvider(options.modelRuntime, provider) : null,
+        thinkingLevel: options.thinkingLevel,
+        extensions: options.extensions.map(describeExtension),
+        extensionErrors: options.extensionErrors.map(({ path, error }) => ({ path, error })),
+        settings: {
+            global: redactSettings(options.globalSettings),
+            project: redactSettings(options.projectSettings),
+        },
+    };
+}
+/** Collect failed assistant turns without collecting conversation content. */
+export function collectBugReportDiagnostics(sessionManager, crashes = []) {
+    const entries = sessionManager.getEntries();
+    const assistant = [];
+    let assistantMessageCount = 0;
+    for (const entry of entries) {
+        if (entry.type !== "message" || entry.message.role !== "assistant")
+            continue;
+        assistantMessageCount++;
+        const message = entry.message;
+        const diagnostics = message.diagnostics ?? [];
+        if (diagnostics.length === 0 &&
+            message.stopReason !== "error" &&
+            message.stopReason !== "aborted" &&
+            !message.errorMessage) {
+            continue;
+        }
+        assistant.push({
+            entryId: entry.id,
+            timestamp: entry.timestamp,
+            provider: message.provider,
+            model: message.model,
+            api: message.api,
+            stopReason: message.stopReason,
+            ...(message.rawStopReason === undefined ? {} : { rawStopReason: message.rawStopReason }),
+            ...(message.errorMessage === undefined ? {} : { errorMessage: message.errorMessage }),
+            diagnostics,
+        });
+    }
+    return {
+        schemaVersion: BUG_REPORT_SCHEMA_VERSION,
+        sessionId: sessionManager.getSessionId(),
+        entryCount: entries.length,
+        assistantMessageCount,
+        assistant,
+        crashes: crashes.map(({ notified: _notified, ...record }) => record),
+    };
+}
+/** Files written to the bug report zip archive. */
+export function bugReportFiles(bundle) {
+    const files = [
+        { name: "report.json", contentType: "application/json", data: `${JSON.stringify(bundle.metadata, null, 2)}\n` },
+        {
+            name: "diagnostics.json",
+            contentType: "application/json",
+            data: `${JSON.stringify(bundle.diagnostics, null, 2)}\n`,
+        },
+    ];
+    if (bundle.sessionJsonl !== undefined) {
+        files.push({ name: "session.jsonl", contentType: "application/x-ndjson", data: bundle.sessionJsonl });
+    }
+    if (bundle.summary !== undefined) {
+        files.push({
+            name: "summary.md",
+            contentType: "text/markdown",
+            data: bundle.summary.endsWith("\n") ? bundle.summary : `${bundle.summary}\n`,
+        });
+    }
+    return files;
+}
+export function writeBugReportArchive(bundle, filePath) {
+    return writeZipArchive(filePath, bugReportFiles(bundle));
+}
+export function bugReportArchiveFileName(id) {
+    return `relay-bug-report-${id}.zip`;
+}
+const BUG_SUMMARY_SYSTEM_PROMPT = `You are helping a user file a bug report about relay, the coding agent they are talking to. You will be shown the conversation transcript. Write a report for the relay developers describing what the user was doing and what went wrong.
+
+Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the report.`;
+const BUG_SUMMARY_INSTRUCTIONS = `Write the bug report in Markdown with these sections:
+
+## What the user was doing
+One short paragraph.
+
+## What went wrong
+Concrete description of the failure: wrong output, errors, hangs, tool failures, unexpected behavior. Quote error messages and tool output verbatim where they exist.
+
+## Steps to reproduce
+Numbered list, as specific as the transcript allows.
+
+## Relevant details
+Tool calls involved, files touched, model behavior, anything else that helps a developer reproduce or locate the problem.
+
+Do not include file contents, secrets, or credentials from the transcript; refer to files by path only. Keep the report factual and concise.`;
+function selectMessages(messages, tokenBudget) {
+    const selected = [];
+    let tokens = 0;
+    for (let index = messages.length - 1; index >= 0; index--) {
+        const message = messages[index];
+        const next = estimateTokens(message);
+        if (selected.length > 0 && tokens + next > tokenBudget)
+            break;
+        selected.push(message);
+        tokens += next;
+    }
+    return selected.reverse();
+}
+/** Ask the session model for a report when the user does not share the transcript. */
+export async function generateBugReportSummary(options) {
+    const { model } = options;
+    const contextWindow = model.contextWindow > 0 ? model.contextWindow : 128_000;
+    const messages = selectMessages(options.messages, Math.floor(contextWindow * 0.6));
+    const hint = options.hint?.trim();
+    const prompt = [
+        messages.length < options.messages.length
+            ? `Note: only the last ${messages.length} of ${options.messages.length} messages are shown.`
+            : undefined,
+        `<conversation>\n${serializeConversation(convertToLlm(messages))}\n</conversation>`,
+        hint ? `<user-report>\n${hint}\n</user-report>` : undefined,
+        BUG_SUMMARY_INSTRUCTIONS,
+    ]
+        .filter((part) => part !== undefined)
+        .join("\n\n");
+    const requestOptions = {
+        maxTokens: Math.min(4096, model.maxTokens > 0 ? model.maxTokens : Number.POSITIVE_INFINITY),
+        signal: options.signal,
+        apiKey: options.apiKey,
+        headers: options.headers,
+        env: options.env,
+        sessionId: options.sessionId,
+        ...(model.reasoning && options.thinkingLevel && options.thinkingLevel !== "off"
+            ? { reasoning: options.thinkingLevel }
+            : {}),
+    };
+    const response = await completeSummarization(model, normalizeContext({
+        systemPrompt: BUG_SUMMARY_SYSTEM_PROMPT,
+        messages: [{ role: "user", content: [{ type: "text", text: prompt }], timestamp: Date.now() }],
+    }), requestOptions, options.streamFn, options.retry);
+    if (response.stopReason === "aborted")
+        throw new Error("Bug report summary was cancelled");
+    const failure = getSummarizationFailure(response, "Bug report summary");
+    if (failure)
+        throw new Error(failure);
+    if (response.content.some((block) => block.type === "toolCall")) {
+        throw new Error("Bug report summary attempted to call a tool");
+    }
+    const text = contentText(response.content).trim();
+    if (!text)
+        throw new Error("Bug report summary was empty");
+    return text;
+}
+//# sourceMappingURL=bug-report.js.map

package/dist/core/bug-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-report.js","sourceRoot":"","sources":["../../src/core/bug-report.ts"],"names":[],"mappings":"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","sourcesContent":["import * as os from \"node:os\";\nimport type { AgentMessage, StreamFn, ThinkingLevel } from \"@relay-harness/agent-core\";\nimport { contentText, normalizeContext, type RetryPolicy, uuidv7 } from \"@relay-harness/ai\";\nimport type { Api, Model, Provider, SimpleStreamOptions } from \"@relay-harness/ai/compat\";\nimport { VERSION } from \"../config.ts\";\nimport { getRelayUserAgent } from \"../utils/relay-user-agent.ts\";\nimport { writeZipArchive } from \"../utils/zip.ts\";\nimport { completeSummarization, estimateTokens, getSummarizationFailure } from \"./compaction/compaction.ts\";\nimport { serializeConversation } from \"./compaction/utils.ts\";\nimport type { CrashRecord } from \"./crash-log.ts\";\nimport type { Extension } from \"./extensions/types.ts\";\nimport { convertToLlm } from \"./messages.ts\";\nimport type { ModelRuntime } from \"./model-runtime.ts\";\nimport type { ReadonlySessionManager } from \"./session-manager.ts\";\nimport type { Settings } from \"./settings-manager.ts\";\n\nexport const BUG_REPORT_CUSTOM_ENTRY_TYPE = \"relay.bug-report\";\nconst BUG_REPORT_SCHEMA_VERSION = 1;\nconst REDACTED = \"<redacted>\";\nconst SENSITIVE_KEY = /(?:^|[-_])(api[-_]?key|secret|token|password|passwd|credential|authorization|cookie)(?:$|[-_])/i;\n\nfunction isSensitiveKey(key: string): boolean {\n\treturn SENSITIVE_KEY.test(key.replace(/([a-z0-9])([A-Z])/g, \"$1_$2\"));\n}\n\n/** Strip credentials and secret-looking query parameters from a URL. */\nexport function redactUrl(value: string): string {\n\tconst nested = /^([a-z][a-z0-9+.-]*:)([a-z][a-z0-9+.-]*:\\/\\/.*)$/i.exec(value);\n\tif (nested) return `${nested[1]}${redactUrl(nested[2])}`;\n\ttry {\n\t\tconst url = new URL(value);\n\t\tlet changed = false;\n\t\tif (url.username || url.password) {\n\t\t\turl.username = \"\";\n\t\t\turl.password = \"\";\n\t\t\tchanged = true;\n\t\t}\n\t\tfor (const key of url.searchParams.keys()) {\n\t\t\tif (isSensitiveKey(key)) {\n\t\t\t\turl.searchParams.set(key, REDACTED);\n\t\t\t\tchanged = true;\n\t\t\t}\n\t\t}\n\t\treturn changed ? url.toString() : value;\n\t} catch {\n\t\treturn value;\n\t}\n}\n\n/** Copy a JSON value while removing values that may contain credentials. */\nexport function redactJsonValue(value: unknown): unknown {\n\tif (value === undefined) return undefined;\n\treturn JSON.parse(\n\t\tJSON.stringify(value, (key, child: unknown) => {\n\t\t\tif (child !== null && child !== undefined && isSensitiveKey(key)) return REDACTED;\n\t\t\treturn typeof child === \"string\" ? redactUrl(child) : child;\n\t\t}),\n\t);\n}\n\nfunction redactSettings(settings: Settings): Settings {\n\tconst { trackingId: _trackingId, deviceId: _deviceId, ...rest } = settings;\n\treturn redactJsonValue(rest) as Settings;\n}\n\nfunction collectEnvironment() {\n\tconst env = (name: string): string | null => process.env[name] || null;\n\treturn {\n\t\tversion: VERSION,\n\t\tuserAgent: getRelayUserAgent(VERSION),\n\t\truntime: process.versions.bun ? `bun/${process.versions.bun}` : `node/${process.version}`,\n\t\tplatform: process.platform,\n\t\tarch: process.arch,\n\t\tosRelease: os.release(),\n\t\tosVersion: os.version(),\n\t\tshell: process.env.SHELL?.split(/[\\\\/]/).pop() || null,\n\t\tterminal: {\n\t\t\tterm: env(\"TERM\"),\n\t\t\tprogram: env(\"TERM_PROGRAM\"),\n\t\t\tprogramVersion: env(\"TERM_PROGRAM_VERSION\"),\n\t\t\tcolorterm: env(\"COLORTERM\"),\n\t\t\ttmux: Boolean(process.env.TMUX),\n\t\t\tssh: Boolean(process.env.SSH_CONNECTION || process.env.SSH_CLIENT || process.env.SSH_TTY),\n\t\t\tci: Boolean(process.env.CI),\n\t\t},\n\t\t// Names help diagnose configuration; values never leave the machine.\n\t\trelayEnvironmentVariables: Object.keys(process.env)\n\t\t\t.filter((name) => name.startsWith(\"RELAY_\"))\n\t\t\t.sort(),\n\t};\n}\n\nfunction describeModel(model: Model<Api>) {\n\treturn {\n\t\tprovider: model.provider,\n\t\tid: model.id,\n\t\tname: model.name,\n\t\tapi: model.api,\n\t\tbaseUrl: redactUrl(model.baseUrl),\n\t\treasoning: model.reasoning,\n\t\tinput: model.input,\n\t\tcontextWindow: model.contextWindow,\n\t\tmaxTokens: model.maxTokens,\n\t\tsamplingParams: model.samplingParams ? redactJsonValue(model.samplingParams) : null,\n\t\tcompat: model.compat ? redactJsonValue(model.compat) : null,\n\t\tthinkingLevelMap: model.thinkingLevelMap ?? null,\n\t\theaderNames: Object.keys(model.headers ?? {}).sort(),\n\t};\n}\n\nfunction describeProvider(modelRuntime: ModelRuntime, provider: Provider) {\n\tconst authTypes: Array<\"api_key\" | \"oauth\"> = [];\n\tif (provider.auth.apiKey) authTypes.push(\"api_key\");\n\tif (provider.auth.oauth) authTypes.push(\"oauth\");\n\treturn {\n\t\tid: provider.id,\n\t\tname: provider.name,\n\t\tbaseUrl: provider.baseUrl ? redactUrl(provider.baseUrl) : null,\n\t\theaderNames: Object.keys(provider.headers ?? {}).sort(),\n\t\tauthTypes,\n\t\tauthStatus: modelRuntime.getProviderAuthStatus(provider.id),\n\t\tusingOAuth: modelRuntime.isUsingOAuth(provider.id),\n\t\tregisteredByExtension: modelRuntime.getRegisteredProviderIds().includes(provider.id),\n\t};\n}\n\nfunction describeExtension(extension: Extension) {\n\treturn {\n\t\tpath: extension.path,\n\t\tsource: redactUrl(extension.sourceInfo.source),\n\t\tscope: extension.sourceInfo.scope,\n\t\torigin: extension.sourceInfo.origin,\n\t\thidden: extension.hidden === true,\n\t};\n}\n\ninterface CollectBugReportMetadataOptions {\n\tid?: string;\n\thint?: string;\n\tsessionId: string;\n\tcwd: string;\n\tincludeSession: boolean;\n\tincludeSummary: boolean;\n\tmessageCount: number;\n\tmodel?: Model<Api>;\n\tmodelRuntime: ModelRuntime;\n\tthinkingLevel: ThinkingLevel;\n\textensions: readonly Extension[];\n\textensionErrors: ReadonlyArray<{ path: string; error: string }>;\n\tglobalSettings: Settings;\n\tprojectSettings: Settings;\n}\n\nexport function collectBugReportMetadata(options: CollectBugReportMetadataOptions) {\n\tconst hint = options.hint?.trim() || null;\n\tconst provider = options.model ? options.modelRuntime.getProvider(options.model.provider) : undefined;\n\treturn {\n\t\tschemaVersion: BUG_REPORT_SCHEMA_VERSION,\n\t\tid: options.id ?? uuidv7(),\n\t\tcreatedAt: new Date().toISOString(),\n\t\thint,\n\t\tenvironment: collectEnvironment(),\n\t\tsession: {\n\t\t\tid: options.sessionId,\n\t\t\tincluded: options.includeSession,\n\t\t\tsummaryIncluded: options.includeSummary,\n\t\t\tmessageCount: options.messageCount,\n\t\t\t...(options.includeSession ? { cwd: options.cwd } : {}),\n\t\t},\n\t\tmodel: options.model ? describeModel(options.model) : null,\n\t\tprovider: provider ? describeProvider(options.modelRuntime, provider) : null,\n\t\tthinkingLevel: options.thinkingLevel,\n\t\textensions: options.extensions.map(describeExtension),\n\t\textensionErrors: options.extensionErrors.map(({ path, error }) => ({ path, error })),\n\t\tsettings: {\n\t\t\tglobal: redactSettings(options.globalSettings),\n\t\t\tproject: redactSettings(options.projectSettings),\n\t\t},\n\t};\n}\n\n/** Collect failed assistant turns without collecting conversation content. */\nexport function collectBugReportDiagnostics(\n\tsessionManager: ReadonlySessionManager,\n\tcrashes: readonly CrashRecord[] = [],\n) {\n\tconst entries = sessionManager.getEntries();\n\tconst assistant = [];\n\tlet assistantMessageCount = 0;\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"message\" || entry.message.role !== \"assistant\") continue;\n\t\tassistantMessageCount++;\n\t\tconst message = entry.message;\n\t\tconst diagnostics = message.diagnostics ?? [];\n\t\tif (\n\t\t\tdiagnostics.length === 0 &&\n\t\t\tmessage.stopReason !== \"error\" &&\n\t\t\tmessage.stopReason !== \"aborted\" &&\n\t\t\t!message.errorMessage\n\t\t) {\n\t\t\tcontinue;\n\t\t}\n\t\tassistant.push({\n\t\t\tentryId: entry.id,\n\t\t\ttimestamp: entry.timestamp,\n\t\t\tprovider: message.provider,\n\t\t\tmodel: message.model,\n\t\t\tapi: message.api,\n\t\t\tstopReason: message.stopReason,\n\t\t\t...(message.rawStopReason === undefined ? {} : { rawStopReason: message.rawStopReason }),\n\t\t\t...(message.errorMessage === undefined ? {} : { errorMessage: message.errorMessage }),\n\t\t\tdiagnostics,\n\t\t});\n\t}\n\treturn {\n\t\tschemaVersion: BUG_REPORT_SCHEMA_VERSION,\n\t\tsessionId: sessionManager.getSessionId(),\n\t\tentryCount: entries.length,\n\t\tassistantMessageCount,\n\t\tassistant,\n\t\tcrashes: crashes.map(({ notified: _notified, ...record }) => record),\n\t};\n}\n\nexport type BugReportMetadata = ReturnType<typeof collectBugReportMetadata>;\nexport type BugReportDiagnostics = ReturnType<typeof collectBugReportDiagnostics>;\n\nexport interface BugReportBundle {\n\tmetadata: BugReportMetadata;\n\tdiagnostics: BugReportDiagnostics;\n\tsessionJsonl?: string;\n\tsummary?: string;\n}\n\nexport interface BugReportSessionEntryData {\n\tid: string;\n\tcreatedAt: string;\n\thint: string | null;\n\tsessionIncluded: boolean;\n\tsummaryIncluded: boolean;\n\tdelivery: \"zip\";\n\tpath?: string;\n}\n\ninterface BugReportFile {\n\tname: string;\n\tcontentType: string;\n\tdata: string;\n}\n\n/** Files written to the bug report zip archive. */\nexport function bugReportFiles(bundle: BugReportBundle): BugReportFile[] {\n\tconst files: BugReportFile[] = [\n\t\t{ name: \"report.json\", contentType: \"application/json\", data: `${JSON.stringify(bundle.metadata, null, 2)}\\n` },\n\t\t{\n\t\t\tname: \"diagnostics.json\",\n\t\t\tcontentType: \"application/json\",\n\t\t\tdata: `${JSON.stringify(bundle.diagnostics, null, 2)}\\n`,\n\t\t},\n\t];\n\tif (bundle.sessionJsonl !== undefined) {\n\t\tfiles.push({ name: \"session.jsonl\", contentType: \"application/x-ndjson\", data: bundle.sessionJsonl });\n\t}\n\tif (bundle.summary !== undefined) {\n\t\tfiles.push({\n\t\t\tname: \"summary.md\",\n\t\t\tcontentType: \"text/markdown\",\n\t\t\tdata: bundle.summary.endsWith(\"\\n\") ? bundle.summary : `${bundle.summary}\\n`,\n\t\t});\n\t}\n\treturn files;\n}\n\nexport function writeBugReportArchive(bundle: BugReportBundle, filePath: string): Promise<void> {\n\treturn writeZipArchive(filePath, bugReportFiles(bundle));\n}\n\nexport function bugReportArchiveFileName(id: string): string {\n\treturn `relay-bug-report-${id}.zip`;\n}\n\nconst BUG_SUMMARY_SYSTEM_PROMPT = `You are helping a user file a bug report about relay, the coding agent they are talking to. You will be shown the conversation transcript. Write a report for the relay developers describing what the user was doing and what went wrong.\n\nDo NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the report.`;\n\nconst BUG_SUMMARY_INSTRUCTIONS = `Write the bug report in Markdown with these sections:\n\n## What the user was doing\nOne short paragraph.\n\n## What went wrong\nConcrete description of the failure: wrong output, errors, hangs, tool failures, unexpected behavior. Quote error messages and tool output verbatim where they exist.\n\n## Steps to reproduce\nNumbered list, as specific as the transcript allows.\n\n## Relevant details\nTool calls involved, files touched, model behavior, anything else that helps a developer reproduce or locate the problem.\n\nDo not include file contents, secrets, or credentials from the transcript; refer to files by path only. Keep the report factual and concise.`;\n\nfunction selectMessages(messages: readonly AgentMessage[], tokenBudget: number): AgentMessage[] {\n\tconst selected: AgentMessage[] = [];\n\tlet tokens = 0;\n\tfor (let index = messages.length - 1; index >= 0; index--) {\n\t\tconst message = messages[index];\n\t\tconst next = estimateTokens(message);\n\t\tif (selected.length > 0 && tokens + next > tokenBudget) break;\n\t\tselected.push(message);\n\t\ttokens += next;\n\t}\n\treturn selected.reverse();\n}\n\ninterface GenerateBugReportSummaryOptions {\n\tmessages: readonly AgentMessage[];\n\thint?: string;\n\tmodel: Model<Api>;\n\tapiKey?: string;\n\theaders?: Record<string, string>;\n\tenv?: Record<string, string>;\n\tsignal: AbortSignal;\n\tthinkingLevel?: ThinkingLevel;\n\tstreamFn?: StreamFn;\n\tretry?: RetryPolicy;\n\tsessionId?: string;\n}\n\n/** Ask the session model for a report when the user does not share the transcript. */\nexport async function generateBugReportSummary(options: GenerateBugReportSummaryOptions): Promise<string> {\n\tconst { model } = options;\n\tconst contextWindow = model.contextWindow > 0 ? model.contextWindow : 128_000;\n\tconst messages = selectMessages(options.messages, Math.floor(contextWindow * 0.6));\n\tconst hint = options.hint?.trim();\n\tconst prompt = [\n\t\tmessages.length < options.messages.length\n\t\t\t? `Note: only the last ${messages.length} of ${options.messages.length} messages are shown.`\n\t\t\t: undefined,\n\t\t`<conversation>\\n${serializeConversation(convertToLlm(messages))}\\n</conversation>`,\n\t\thint ? `<user-report>\\n${hint}\\n</user-report>` : undefined,\n\t\tBUG_SUMMARY_INSTRUCTIONS,\n\t]\n\t\t.filter((part) => part !== undefined)\n\t\t.join(\"\\n\\n\");\n\tconst requestOptions: SimpleStreamOptions = {\n\t\tmaxTokens: Math.min(4096, model.maxTokens > 0 ? model.maxTokens : Number.POSITIVE_INFINITY),\n\t\tsignal: options.signal,\n\t\tapiKey: options.apiKey,\n\t\theaders: options.headers,\n\t\tenv: options.env,\n\t\tsessionId: options.sessionId,\n\t\t...(model.reasoning && options.thinkingLevel && options.thinkingLevel !== \"off\"\n\t\t\t? { reasoning: options.thinkingLevel }\n\t\t\t: {}),\n\t};\n\tconst response = await completeSummarization(\n\t\tmodel,\n\t\tnormalizeContext({\n\t\t\tsystemPrompt: BUG_SUMMARY_SYSTEM_PROMPT,\n\t\t\tmessages: [{ role: \"user\", content: [{ type: \"text\", text: prompt }], timestamp: Date.now() }],\n\t\t}),\n\t\trequestOptions,\n\t\toptions.streamFn,\n\t\toptions.retry,\n\t);\n\tif (response.stopReason === \"aborted\") throw new Error(\"Bug report summary was cancelled\");\n\tconst failure = getSummarizationFailure(response, \"Bug report summary\");\n\tif (failure) throw new Error(failure);\n\tif (response.content.some((block) => block.type === \"toolCall\")) {\n\t\tthrow new Error(\"Bug report summary attempted to call a tool\");\n\t}\n\tconst text = contentText(response.content).trim();\n\tif (!text) throw new Error(\"Bug report summary was empty\");\n\treturn text;\n}\n"]}