@ouro.bot/cli 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/heart/streaming.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FinalAnswerParser = void 0;
+exports.FinalAnswerStreamer = exports.FinalAnswerParser = void 0;
 exports.toResponsesInput = toResponsesInput;
 exports.toResponsesTools = toResponsesTools;
 exports.streamChatCompletion = streamChatCompletion;
@@ -77,6 +77,89 @@ class FinalAnswerParser {
     }
 }
 exports.FinalAnswerParser = FinalAnswerParser;
+// Shared helper: wraps FinalAnswerParser with onClearText + onTextChunk wiring.
+// Used by all streaming providers (Chat Completions, Responses API, Anthropic)
+// so the eager-match streaming pattern lives in one place.
+class FinalAnswerStreamer {
+    parser = new FinalAnswerParser();
+    _detected = false;
+    callbacks;
+    constructor(callbacks) {
+        this.callbacks = callbacks;
+    }
+    get detected() { return this._detected; }
+    get streamed() { return this.parser.active; }
+    /** Mark final_answer as detected. Calls onClearText on the callbacks. */
+    activate() {
+        if (this._detected)
+            return;
+        this._detected = true;
+        this.callbacks.onClearText?.();
+    }
+    /** Feed an argument delta through the parser. Emits text via onTextChunk. */
+    processDelta(delta) {
+        if (!this._detected)
+            return;
+        const text = this.parser.process(delta);
+        if (text)
+            this.callbacks.onTextChunk(text);
+    }
+}
+exports.FinalAnswerStreamer = FinalAnswerStreamer;
+function toResponsesUserContent(content) {
+    if (typeof content === "string") {
+        return content;
+    }
+    if (!Array.isArray(content)) {
+        return "";
+    }
+    const parts = [];
+    for (const part of content) {
+        if (!part || typeof part !== "object") {
+            continue;
+        }
+        if (part.type === "text" && typeof part.text === "string") {
+            parts.push({ type: "input_text", text: part.text });
+            continue;
+        }
+        if (part.type === "image_url") {
+            const imageUrl = typeof part.image_url?.url === "string" ? part.image_url.url : "";
+            if (!imageUrl)
+                continue;
+            parts.push({
+                type: "input_image",
+                image_url: imageUrl,
+                detail: part.image_url?.detail ?? "auto",
+            });
+            continue;
+        }
+        if (part.type === "input_audio" &&
+            typeof part.input_audio?.data === "string" &&
+            (part.input_audio.format === "mp3" || part.input_audio.format === "wav")) {
+            parts.push({
+                type: "input_audio",
+                input_audio: {
+                    data: part.input_audio.data,
+                    format: part.input_audio.format,
+                },
+            });
+            continue;
+        }
+        if (part.type === "file") {
+            const fileRecord = { type: "input_file" };
+            if (typeof part.file?.file_data === "string")
+                fileRecord.file_data = part.file.file_data;
+            if (typeof part.file?.file_id === "string")
+                fileRecord.file_id = part.file.file_id;
+            if (typeof part.file?.filename === "string")
+                fileRecord.filename = part.file.filename;
+            if (typeof part.file?.file_data === "string" || typeof part.file?.file_id === "string") {
+                parts.push(fileRecord);
+            }
+        }
+    }
+    return parts.length > 0 ? parts : "";
+}
 function toResponsesInput(messages) {
     let instructions = "";
     const input = [];
@@ -90,7 +173,7 @@ function toResponsesInput(messages) {
         }
         if (msg.role === "user") {
             const u = msg;
-            input.push({ role: "user", content: typeof u.content === "string" ? u.content : "" });
+            input.push({ role: "user", content: toResponsesUserContent(u.content) });
             continue;
         }
         if (msg.role === "assistant") {
@@ -106,6 +189,9 @@ function toResponsesInput(messages) {
             }
             if (a.tool_calls) {
                 for (const tc of a.tool_calls) {
+                    /* v8 ignore next -- type narrowing: OpenAI SDK only emits function tool_calls @preserve */
+                    if (tc.type !== "function")
+                        continue;
                     input.push({
                         type: "function_call",
                         call_id: tc.id,
@@ -152,8 +238,7 @@ async function streamChatCompletion(client, createParams, callbacks, signal) {
     let toolCalls = {};
     let streamStarted = false;
     let usage;
-    const answerParser = new FinalAnswerParser();
-    let finalAnswerDetected = false;
+    const answerStreamer = new FinalAnswerStreamer(callbacks);
     // State machine for parsing inline <think> tags (MiniMax pattern)
     let contentBuf = "";
     let inThinkTag = false;
@@ -271,21 +356,18 @@ async function streamChatCompletion(client, createParams, callbacks, signal) {
                     // Detect final_answer tool call on first name delta.
                     // Only activate streaming if this is the sole tool call (index 0
                     // and no other indices seen). Mixed calls are rejected by core.ts.
-                    if (tc.function.name === "final_answer" && !finalAnswerDetected
+                    if (tc.function.name === "final_answer" && !answerStreamer.detected
                         && tc.index === 0 && Object.keys(toolCalls).length === 1) {
-                        finalAnswerDetected = true;
-                        callbacks.onClearText?.();
+                        answerStreamer.activate();
                     }
                 }
                 if (tc.function?.arguments) {
                     toolCalls[tc.index].arguments += tc.function.arguments;
                     // Feed final_answer argument deltas to the parser for progressive
                     // streaming, but only when it appears to be the sole tool call.
-                    if (finalAnswerDetected && toolCalls[tc.index].name === "final_answer"
+                    if (answerStreamer.detected && toolCalls[tc.index].name === "final_answer"
                         && Object.keys(toolCalls).length === 1) {
-                        const text = answerParser.process(tc.function.arguments);
-                        if (text)
-                            callbacks.onTextChunk(text);
+                        answerStreamer.processDelta(tc.function.arguments);
                     }
                 }
             }
@@ -299,7 +381,7 @@ async function streamChatCompletion(client, createParams, callbacks, signal) {
         toolCalls: Object.values(toolCalls),
         outputItems: [],
         usage,
-        finalAnswerStreamed: answerParser.active,
+        finalAnswerStreamed: answerStreamer.streamed,
     };
 }
 async function streamResponsesApi(client, createParams, callbacks, signal) {
@@ -317,9 +399,8 @@ async function streamResponsesApi(client, createParams, callbacks, signal) {
     const outputItems = [];
     let currentToolCall = null;
     let usage;
-    const answerParser = new FinalAnswerParser();
+    const answerStreamer = new FinalAnswerStreamer(callbacks);
     let functionCallCount = 0;
-    let finalAnswerDetected = false;
     for await (const event of response) {
         if (signal?.aborted)
             break;
@@ -352,8 +433,7 @@ async function streamResponsesApi(client, createParams, callbacks, signal) {
                     // Only activate when this is the first (and so far only) function call.
                     // Mixed calls are rejected by core.ts; no need to stream their args.
                     if (String(event.item.name) === "final_answer" && functionCallCount === 1) {
-                        finalAnswerDetected = true;
-                        callbacks.onClearText?.();
+                        answerStreamer.activate();
                     }
                 }
                 break;
@@ -363,11 +443,9 @@ async function streamResponsesApi(client, createParams, callbacks, signal) {
                     currentToolCall.arguments += event.delta;
                     // Feed final_answer argument deltas to the parser for progressive
                     // streaming, but only when it appears to be the sole function call.
-                    if (finalAnswerDetected && currentToolCall.name === "final_answer"
+                    if (answerStreamer.detected && currentToolCall.name === "final_answer"
                         && functionCallCount === 1) {
-                        const text = answerParser.process(String(event.delta));
-                        if (text)
-                            callbacks.onTextChunk(text);
+                        answerStreamer.processDelta(String(event.delta));
                     }
                 }
                 break;
@@ -407,6 +485,6 @@ async function streamResponsesApi(client, createParams, callbacks, signal) {
         toolCalls,
         outputItems,
         usage,
-        finalAnswerStreamed: answerParser.active,
+        finalAnswerStreamed: answerStreamer.streamed,
     };
 }

package/dist/mind/bundle-manifest.js

@@ -34,6 +34,10 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CANONICAL_BUNDLE_MANIFEST = void 0;
+exports.getPackageVersion = getPackageVersion;
+exports.createBundleMeta = createBundleMeta;
+exports.backfillBundleMeta = backfillBundleMeta;
+exports.resetBackfillTracking = resetBackfillTracking;
 exports.isCanonicalBundlePath = isCanonicalBundlePath;
 exports.findNonCanonicalBundlePaths = findNonCanonicalBundlePaths;
 const fs = __importStar(require("fs"));
@@ -41,6 +45,7 @@ const path = __importStar(require("path"));
 const runtime_1 = require("../nerves/runtime");
 exports.CANONICAL_BUNDLE_MANIFEST = [
     { path: "agent.json", kind: "file" },
+    { path: "bundle-meta.json", kind: "file" },
     { path: "psyche/SOUL.md", kind: "file" },
     { path: "psyche/IDENTITY.md", kind: "file" },
     { path: "psyche/LORE.md", kind: "file" },
@@ -53,6 +58,59 @@ exports.CANONICAL_BUNDLE_MANIFEST = [
     { path: "senses", kind: "dir" },
     { path: "senses/teams", kind: "dir" },
 ];
+function getPackageVersion() {
+    const packageJsonPath = path.resolve(__dirname, "../../package.json");
+    const raw = fs.readFileSync(packageJsonPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    (0, runtime_1.emitNervesEvent)({
+        component: "mind",
+        event: "mind.package_version_read",
+        message: "read package version",
+        meta: { version: parsed.version },
+    });
+    return parsed.version;
+}
+function createBundleMeta() {
+    return {
+        runtimeVersion: getPackageVersion(),
+        bundleSchemaVersion: 1,
+        lastUpdated: new Date().toISOString(),
+    };
+}
+const _backfilledRoots = new Set();
+/**
+ * If bundle-meta.json is missing from the agent root, create it with current runtime version.
+ * This backfills existing agent bundles that were created before bundle-meta.json was introduced.
+ * Only attempts once per bundleRoot per process.
+ */
+function backfillBundleMeta(bundleRoot) {
+    if (_backfilledRoots.has(bundleRoot))
+        return;
+    _backfilledRoots.add(bundleRoot);
+    const metaPath = path.join(bundleRoot, "bundle-meta.json");
+    try {
+        if (fs.existsSync(metaPath)) {
+            return;
+        }
+        const meta = createBundleMeta();
+        fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2) + "\n", "utf-8");
+        (0, runtime_1.emitNervesEvent)({
+            component: "mind",
+            event: "mind.bundle_meta_backfill",
+            message: "backfilled missing bundle-meta.json",
+            meta: { bundleRoot },
+        });
+    }
+    catch {
+        // Non-blocking: if we can't write, that's okay
+    }
+}
+/**
+ * Reset the backfill tracking set. Used in tests.
+ */
+function resetBackfillTracking() {
+    _backfilledRoots.clear();
+}
 const CANONICAL_FILE_PATHS = new Set(exports.CANONICAL_BUNDLE_MANIFEST
     .filter((entry) => entry.kind === "file")
     .map((entry) => entry.path));

package/dist/mind/friends/channel.js

@@ -21,6 +21,14 @@ const CHANNEL_CAPABILITIES = {
         supportsRichCards: true,
         maxMessageLength: Infinity,
     },
+    bluebubbles: {
+        channel: "bluebubbles",
+        availableIntegrations: [],
+        supportsMarkdown: false,
+        supportsStreaming: false,
+        supportsRichCards: false,
+        maxMessageLength: Infinity,
+    },
 };
 const DEFAULT_CAPABILITIES = {
     channel: "cli",

package/dist/mind/friends/types.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isIdentityProvider = isIdentityProvider;
 exports.isIntegration = isIntegration;
 const runtime_1 = require("../../nerves/runtime");
-const IDENTITY_PROVIDERS = new Set(["aad", "local", "teams-conversation"]);
+const IDENTITY_PROVIDERS = new Set(["aad", "local", "teams-conversation", "imessage-handle"]);
 function isIdentityProvider(value) {
     (0, runtime_1.emitNervesEvent)({
         component: "friends",

package/dist/mind/prompt.js

@@ -47,10 +47,12 @@ const identity_1 = require("../heart/identity");
 const os = __importStar(require("os"));
 const channel_1 = require("./friends/channel");
 const runtime_1 = require("../nerves/runtime");
+const bundle_manifest_1 = require("./bundle-manifest");
 const first_impressions_1 = require("./first-impressions");
 const tasks_1 = require("../repertoire/tasks");
 // Lazy-loaded psyche text cache
 let _psycheCache = null;
+let _senseStatusLinesCache = null;
 function loadPsycheFile(name) {
     try {
         const psycheDir = path.join((0, identity_1.getAgentRoot)(), "psyche");
@@ -74,6 +76,7 @@ function loadPsyche() {
 }
 function resetPsycheCache() {
     _psycheCache = null;
+    _senseStatusLinesCache = null;
 }
 const DEFAULT_ACTIVE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24 hours
 function resolveFriendName(friendId, friendsDir, agentName) {
@@ -194,15 +197,84 @@ function runtimeInfoSection(channel) {
     lines.push(`agent: ${agentName}`);
     lines.push(`cwd: ${process.cwd()}`);
     lines.push(`channel: ${channel}`);
+    lines.push(`current sense: ${channel}`);
     lines.push(`i can read and modify my own source code.`);
     if (channel === "cli") {
         lines.push("i introduce myself on boot with a fun random greeting.");
     }
+    else if (channel === "bluebubbles") {
+        lines.push("i am responding in iMessage through BlueBubbles. i keep replies short and phone-native. i do not use markdown. i do not introduce myself on boot.");
+    }
     else {
         lines.push("i am responding in Microsoft Teams. i keep responses concise. i use markdown formatting. i do not introduce myself on boot.");
     }
+    lines.push("");
+    lines.push(...senseRuntimeGuidance(channel));
     return lines.join("\n");
 }
+function hasTextField(record, key) {
+    return typeof record?.[key] === "string" && record[key].trim().length > 0;
+}
+function localSenseStatusLines() {
+    if (_senseStatusLinesCache) {
+        return [..._senseStatusLinesCache];
+    }
+    const config = (0, identity_1.loadAgentConfig)();
+    const senses = config.senses ?? {
+        cli: { enabled: true },
+        teams: { enabled: false },
+        bluebubbles: { enabled: false },
+    };
+    let payload = {};
+    try {
+        const raw = fs.readFileSync((0, identity_1.getAgentSecretsPath)(), "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            payload = parsed;
+        }
+    }
+    catch {
+        payload = {};
+    }
+    const teams = payload.teams;
+    const bluebubbles = payload.bluebubbles;
+    const configured = {
+        cli: true,
+        teams: hasTextField(teams, "clientId") && hasTextField(teams, "clientSecret") && hasTextField(teams, "tenantId"),
+        bluebubbles: hasTextField(bluebubbles, "serverUrl") && hasTextField(bluebubbles, "password"),
+    };
+    const rows = [
+        { label: "CLI", status: "interactive" },
+        {
+            label: "Teams",
+            status: !senses.teams.enabled ? "disabled" : configured.teams ? "ready" : "needs_config",
+        },
+        {
+            label: "BlueBubbles",
+            status: !senses.bluebubbles.enabled ? "disabled" : configured.bluebubbles ? "ready" : "needs_config",
+        },
+    ];
+    _senseStatusLinesCache = rows.map((row) => `- ${row.label}: ${row.status}`);
+    return [..._senseStatusLinesCache];
+}
+function senseRuntimeGuidance(channel) {
+    const lines = ["available senses:"];
+    lines.push(...localSenseStatusLines());
+    lines.push("sense states:");
+    lines.push("- interactive = available when opened by the user instead of kept running by the daemon");
+    lines.push("- disabled = turned off in agent.json");
+    lines.push("- needs_config = enabled but missing required secrets.json values");
+    lines.push("- ready = enabled and configured; `ouro up` should bring it online");
+    lines.push("- running = enabled and currently active");
+    lines.push("- error = enabled but unhealthy");
+    lines.push("If asked how to enable another sense, I explain the relevant agent.json senses entry and required secrets.json fields instead of guessing.");
+    lines.push("teams setup truth: enable `senses.teams.enabled`, then provide `teams.clientId`, `teams.clientSecret`, and `teams.tenantId` in secrets.json.");
+    lines.push("bluebubbles setup truth: enable `senses.bluebubbles.enabled`, then provide `bluebubbles.serverUrl` and `bluebubbles.password` in secrets.json.");
+    if (channel === "cli") {
+        lines.push("cli is interactive: it is available when the user opens it, not something `ouro up` daemonizes.");
+    }
+    return lines;
+}
 function providerSection() {
     return `## my provider\n${(0, core_1.getProviderDisplayLabel)()}`;
 }
@@ -210,8 +282,8 @@ function dateSection() {
     const today = new Date().toISOString().slice(0, 10);
     return `current date: ${today}`;
 }
-function toolsSection(channel, options) {
-    const channelTools = (0, tools_1.getToolsForChannel)((0, channel_1.getChannelCapabilities)(channel));
+function toolsSection(channel, options, context) {
+    const channelTools = (0, tools_1.getToolsForChannel)((0, channel_1.getChannelCapabilities)(channel), undefined, context);
     const activeTools = (options?.toolChoiceRequired ?? true) ? [...channelTools, tools_1.finalAnswerTool] : channelTools;
     const list = activeTools
         .map((t) => `- ${t.function.name}: ${t.function.description}`)
@@ -316,6 +388,8 @@ async function buildSystem(channel = "cli", options, context) {
         message: "buildSystem started",
         meta: { channel, has_context: Boolean(context), tool_choice_required: Boolean(options?.toolChoiceRequired) },
     });
+    // Backfill bundle-meta.json for existing agents that don't have one
+    (0, bundle_manifest_1.backfillBundleMeta)((0, identity_1.getAgentRoot)());
     const system = [
         soulSection(),
         identitySection(),
@@ -325,7 +399,7 @@ async function buildSystem(channel = "cli", options, context) {
         runtimeInfoSection(channel),
         providerSection(),
         dateSection(),
-        toolsSection(channel, options),
+        toolsSection(channel, options, context),
         skillsSection(),
         taskBoardSection(),
         buildSessionSummary({

package/dist/nerves/cli-logging.js

@@ -5,20 +5,33 @@ const config_1 = require("../heart/config");
 const nerves_1 = require("../nerves");
 const runtime_1 = require("./runtime");
 const runtime_2 = require("./runtime");
+const LEVEL_PRIORITY = { debug: 10, info: 20, warn: 30, error: 40 };
+/** Wrap a sink so it only receives events at or above the given level. */
+/* v8 ignore start -- internal filter plumbing, exercised via integration @preserve */
+function filterSink(sink, minLevel) {
+    const minPriority = LEVEL_PRIORITY[minLevel] ?? 0;
+    return (entry) => {
+        if ((LEVEL_PRIORITY[entry.level] ?? 0) >= minPriority)
+            sink(entry);
+    };
+}
 function resolveCliSinks(sinks) {
     const requested = sinks && sinks.length > 0 ? sinks : ["terminal", "ndjson"];
     return [...new Set(requested)];
 }
 function configureCliRuntimeLogger(_friendId, options = {}) {
     const sinkKinds = resolveCliSinks(options.sinks);
+    const level = options.level ?? "info";
     const sinks = sinkKinds.map((sinkKind) => {
         if (sinkKind === "terminal") {
-            return (0, nerves_1.createTerminalSink)();
+            // Terminal only shows warnings and errors — INFO is too noisy
+            // for an interactive session. Full detail goes to the ndjson file.
+            return filterSink((0, nerves_1.createTerminalSink)(), "warn");
         }
         return (0, nerves_1.createNdjsonFileSink)((0, config_1.logPath)("cli", "runtime"));
     });
     const logger = (0, nerves_1.createLogger)({
-        level: options.level ?? "info",
+        level,
         sinks,
     });
     (0, runtime_2.setRuntimeLogger)(logger);

package/dist/repertoire/ado-client.js

@@ -28,8 +28,10 @@ function resolveContentType(method, path) {
         : "application/json";
 }
 // Generic ADO API request. Returns response body as pretty-printed JSON string.
-async function adoRequest(token, method, org, path, body) {
+// `host` overrides the base URL for non-standard APIs (e.g. "vsapm.dev.azure.com", "vssps.dev.azure.com").
+async function adoRequest(token, method, org, path, body, host) {
     try {
+        const base = host ? `https://${host}/${org}` : `${ADO_BASE}/${org}`;
         (0, runtime_1.emitNervesEvent)({
             event: "client.request_start",
             component: "clients",
@@ -37,7 +39,7 @@ async function adoRequest(token, method, org, path, body) {
             meta: { client: "ado", method, org, path },
         });
         const fullPath = ensureApiVersion(path);
-        const url = `${ADO_BASE}/${org}${fullPath}`;
+        const url = `${base}${fullPath}`;
         const contentType = resolveContentType(method, path);
         const opts = {
             method,

package/dist/repertoire/coding/feedback.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatCodingTail = formatCodingTail;
+exports.attachCodingSessionFeedback = attachCodingSessionFeedback;
+const runtime_1 = require("../../nerves/runtime");
+const TERMINAL_UPDATE_KINDS = new Set(["completed", "failed", "killed"]);
+function clip(text, maxLength = 280) {
+    const trimmed = text.trim();
+    if (trimmed.length <= maxLength)
+        return trimmed;
+    return `${trimmed.slice(0, maxLength - 3)}...`;
+}
+function isNoiseLine(line) {
+    return (/^-+$/.test(line)
+        || /^Reading prompt from stdin/i.test(line)
+        || /^OpenAI Codex v/i.test(line)
+        || /^workdir:/i.test(line)
+        || /^model:/i.test(line)
+        || /^provider:/i.test(line)
+        || /^approval:/i.test(line)
+        || /^sandbox:/i.test(line)
+        || /^reasoning effort:/i.test(line)
+        || /^reasoning summaries:/i.test(line)
+        || /^session id:/i.test(line)
+        || /^mcp startup:/i.test(line)
+        || /^tokens used$/i.test(line)
+        || /^\d{1,3}(,\d{3})*$/.test(line)
+        || /^\d{4}-\d{2}-\d{2}T.*\bWARN\b/.test(line)
+        || line === "user"
+        || line === "codex");
+}
+function lastMeaningfulLine(text) {
+    if (!text)
+        return null;
+    const lines = text
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .filter((line) => !isNoiseLine(line));
+    if (lines.length === 0)
+        return null;
+    return clip(lines.at(-1));
+}
+function formatSessionLabel(session) {
+    return `${session.runner} ${session.id}`;
+}
+function isSafeProgressSnippet(snippet) {
+    const wordCount = snippet.split(/\s+/).filter(Boolean).length;
+    return (snippet.length <= 80
+        && wordCount <= 8
+        && !snippet.includes(":")
+        && !snippet.startsWith("**")
+        && !/^Respond with\b/i.test(snippet)
+        && !/^Coding session metadata\b/i.test(snippet)
+        && !/^sessionId\b/i.test(snippet)
+        && !/^taskRef\b/i.test(snippet)
+        && !/^parentAgent\b/i.test(snippet));
+}
+function pickUpdateSnippet(update) {
+    return (lastMeaningfulLine(update.text)
+        ?? lastMeaningfulLine(update.session.stderrTail)
+        ?? lastMeaningfulLine(update.session.stdoutTail));
+}
+function formatUpdateMessage(update) {
+    const label = formatSessionLabel(update.session);
+    const snippet = pickUpdateSnippet(update);
+    switch (update.kind) {
+        case "progress":
+            return snippet && isSafeProgressSnippet(snippet) ? `${label}: ${snippet}` : null;
+        case "waiting_input":
+            return snippet ? `${label} waiting: ${snippet}` : `${label} waiting`;
+        case "stalled":
+            return snippet ? `${label} stalled: ${snippet}` : `${label} stalled`;
+        case "completed":
+            return snippet ? `${label} completed: ${snippet}` : `${label} completed`;
+        case "failed":
+            return snippet ? `${label} failed: ${snippet}` : `${label} failed`;
+        case "killed":
+            return `${label} killed`;
+        case "spawned":
+            return `${label} started`;
+    }
+}
+function formatCodingTail(session) {
+    const stdout = session.stdoutTail.trim() || "(empty)";
+    const stderr = session.stderrTail.trim() || "(empty)";
+    return [
+        `sessionId: ${session.id}`,
+        `runner: ${session.runner}`,
+        `status: ${session.status}`,
+        `workdir: ${session.workdir}`,
+        "",
+        "[stdout]",
+        stdout,
+        "",
+        "[stderr]",
+        stderr,
+    ].join("\n");
+}
+function attachCodingSessionFeedback(manager, session, target) {
+    let lastMessage = "";
+    let closed = false;
+    let unsubscribe = () => { };
+    const sendMessage = (message) => {
+        if (closed || !message || message === lastMessage) {
+            return;
+        }
+        lastMessage = message;
+        void Promise.resolve(target.send(message)).catch((error) => {
+            (0, runtime_1.emitNervesEvent)({
+                level: "warn",
+                component: "repertoire",
+                event: "repertoire.coding_feedback_error",
+                message: "coding feedback transport failed",
+                meta: {
+                    sessionId: session.id,
+                    reason: error instanceof Error ? error.message : String(error),
+                },
+            });
+        });
+    };
+    sendMessage(formatUpdateMessage({ kind: "spawned", session }));
+    unsubscribe = manager.subscribe(session.id, async (update) => {
+        sendMessage(formatUpdateMessage(update));
+        if (TERMINAL_UPDATE_KINDS.has(update.kind)) {
+            closed = true;
+            unsubscribe();
+        }
+    });
+    return () => {
+        closed = true;
+        unsubscribe();
+    };
+}

package/dist/repertoire/coding/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatCodingMonitorReport = exports.CodingSessionMonitor = exports.CodingSessionManager = void 0;
+exports.formatCodingTail = exports.attachCodingSessionFeedback = exports.formatCodingMonitorReport = exports.CodingSessionMonitor = exports.CodingSessionManager = void 0;
 exports.getCodingSessionManager = getCodingSessionManager;
 exports.resetCodingSessionManager = resetCodingSessionManager;
 const runtime_1 = require("../../nerves/runtime");
@@ -34,3 +34,6 @@ var monitor_1 = require("./monitor");
 Object.defineProperty(exports, "CodingSessionMonitor", { enumerable: true, get: function () { return monitor_1.CodingSessionMonitor; } });
 var reporter_1 = require("./reporter");
 Object.defineProperty(exports, "formatCodingMonitorReport", { enumerable: true, get: function () { return reporter_1.formatCodingMonitorReport; } });
+var feedback_1 = require("./feedback");
+Object.defineProperty(exports, "attachCodingSessionFeedback", { enumerable: true, get: function () { return feedback_1.attachCodingSessionFeedback; } });
+Object.defineProperty(exports, "formatCodingTail", { enumerable: true, get: function () { return feedback_1.formatCodingTail; } });