@geminixiang/mikan 1.0.0-beta.4 → 1.0.0-beta.41

package/dist/adapters/progressive-renderer.js

@@ -0,0 +1,440 @@
+import * as log from "../log.js";
+import { createChatResponseErrorReporter, formatToolArgs, splitText, } from "./shared.js";
+export function formatMarkdownToolResult(result) {
+    const argsFormatted = formatToolArgs(result.args);
+    const duration = (result.durationMs / 1000).toFixed(1);
+    let text = `**${result.isError ? "Error" : "Done"} ${result.toolName}**`;
+    if (result.label)
+        text += `: ${result.label}`;
+    text += ` (${duration}s)\n`;
+    if (argsFormatted)
+        text += `\`\`\`\n${argsFormatted}\n\`\`\`\n`;
+    text += `**Result:**\n\`\`\`\n${result.result}\n\`\`\``;
+    return text;
+}
+/**
+ * Floor on how often a streaming response redraws.
+ *
+ * Every platform meters edits per channel — Slack's is the tightest at roughly
+ * fifty a minute — and a redraw sends the whole message, so the cost is the
+ * number of calls, not their size. One second keeps a long answer inside that
+ * budget while still reading as live.
+ *
+ * This is a floor, not a target: the interval is measured from when the last
+ * redraw *finished*, so a platform that slows down under load slows the redraw
+ * rate with it instead of queueing work it cannot deliver.
+ */
+const DEFAULT_FLUSH_INTERVAL_MS = 1000;
+export function createProgressiveRenderer(platform) {
+    const state = {
+        responseId: platform.initialResponseId ?? null,
+        source: "",
+        working: true,
+        streamActive: false,
+        streamUnavailable: false,
+        streamedSource: "",
+        pendingChars: 0,
+        lastFlushAt: 0,
+        resetDelta: false,
+        typingInterval: null,
+        typingFailureWarned: false,
+        extraIds: [],
+        continuationIds: [],
+    };
+    const sanitize = platform.sanitize ?? ((text) => text);
+    const reportResponseError = platform.responseErrorContext
+        ? createChatResponseErrorReporter(() => platform.responseErrorContext(state.responseId))
+        : (err, operation, extra) => platform.reportError?.(err, operation, extra ?? {}, state.responseId);
+    const now = Date.now;
+    const flushIntervalMs = platform.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+    function stopTyping() {
+        if (state.typingInterval !== null) {
+            clearInterval(state.typingInterval);
+            state.typingInterval = null;
+        }
+    }
+    function provisional(text, working) {
+        if (platform.formatProvisional)
+            return platform.formatProvisional(text, working);
+        return working && platform.workingIndicator ? text + platform.workingIndicator : text;
+    }
+    function split(text) {
+        return splitText(text, platform.maxLength, platform.formatContinuation);
+    }
+    async function postOrUpdate(text) {
+        if (state.responseId !== null) {
+            await platform.update(state.responseId, text);
+            return;
+        }
+        if (platform.typing?.stopOnSend)
+            stopTyping();
+        state.responseId = await platform.post(text);
+    }
+    /**
+     * Render `text` as a head message plus however many overflow messages it
+     * needs.
+     *
+     * The overflow is *edited* on later redraws, not re-posted. A streaming
+     * response redraws roughly once a second, and re-posting meant every redraw
+     * past the length limit dropped another copy of the tail into the channel —
+     * a single long answer arrived as one correct message followed by six
+     * partial duplicates of itself.
+     *
+     * Reuse is positional: overflow N always lives in the same message, so the
+     * text a reader has already scrolled past does not move. A platform whose
+     * `postExtra` reports no id cannot be edited, and falls back to the old
+     * behaviour rather than losing the content.
+     */
+    async function postSplit(text) {
+        const [head = text, ...tail] = split(text);
+        await postOrUpdate(head);
+        for (const [index, part] of tail.entries()) {
+            const existing = state.continuationIds[index];
+            if (existing !== undefined) {
+                await platform.update(String(existing), part);
+                continue;
+            }
+            if (platform.typing?.stopOnSend)
+                stopTyping();
+            const id = await platform.postExtra(part, state.responseId);
+            if (id !== undefined && id !== null)
+                state.continuationIds[index] = id;
+        }
+    }
+    async function postExtra(text) {
+        if (platform.typing?.stopOnSend)
+            stopTyping();
+        await platform.postExtra(text, state.responseId);
+    }
+    async function stopNativeStream() {
+        if (!state.streamActive || state.responseId === null || !platform.stream)
+            return;
+        const streamId = state.responseId;
+        state.streamActive = false;
+        state.streamedSource = "";
+        await platform.stream.stop(streamId);
+    }
+    async function abandonNativeStream() {
+        if (!platform.stream || state.responseId === null)
+            return;
+        const streamId = state.responseId;
+        state.streamActive = false;
+        state.streamedSource = "";
+        await platform.stream.stop(streamId).catch(() => undefined);
+        if (state.responseId === streamId)
+            state.responseId = null;
+    }
+    async function renderRaw(text, operation, options, canonicalText = text) {
+        try {
+            await postSplit(text);
+            return canonicalText;
+        }
+        catch (err) {
+            if (!platform.handleTooLong)
+                throw err;
+            // Only a length rejection may take the truncating path. Treating every
+            // failure as "too long" turned a transient rate limit into a response
+            // cut to a few thousand characters under a notice blaming its length,
+            // and the retry it triggered kept the limit alive.
+            if (platform.isTooLongError && !platform.isTooLongError(err))
+                throw err;
+            const fallback = await platform.handleTooLong(canonicalText, operation, options, state.responseId, postSplit, () => state.responseId);
+            return fallback.text;
+        }
+    }
+    async function renderDelta(text) {
+        if (state.working && !text.trim())
+            return text;
+        const prepared = platform.prepareSource?.(text, state.working) ?? text;
+        const stream = platform.stream;
+        const display = provisional(prepared, state.working);
+        if (!stream || state.streamUnavailable) {
+            await renderRaw(display, "render", undefined, prepared);
+            return prepared;
+        }
+        if (state.responseId !== null && !state.streamActive) {
+            await renderRaw(display, "render", undefined, prepared);
+            return prepared;
+        }
+        if (state.responseId !== null &&
+            state.streamActive &&
+            !prepared.startsWith(state.streamedSource)) {
+            await abandonNativeStream();
+            await renderRaw(display, "render", undefined, prepared);
+            return prepared;
+        }
+        try {
+            if (state.responseId !== null) {
+                const delta = prepared.slice(state.streamedSource.length);
+                // Below the threshold the delta stays pending: `state.streamedSource`
+                // does not advance, so the next tick recomputes it from the same base
+                // and `renderFinal` flushes the remainder before stopping.
+                if (delta && delta.length >= (stream.minDeltaChars ?? 0)) {
+                    await stream.append(state.responseId, delta);
+                    state.streamedSource = prepared;
+                }
+                return prepared;
+            }
+            state.responseId = await stream.start(prepared);
+            state.streamActive = true;
+            state.streamedSource = prepared;
+            return prepared;
+        }
+        catch (err) {
+            state.streamUnavailable = true;
+            log.logWarning("Native response streaming unavailable; falling back to message updates", err instanceof Error ? err.message : String(err));
+            await abandonNativeStream();
+            await renderRaw(display, "render", undefined, prepared);
+            return prepared;
+        }
+    }
+    async function renderFinal(text) {
+        const stream = platform.stream;
+        if (stream && state.streamActive && state.responseId !== null) {
+            let streamed = false;
+            try {
+                if (text.startsWith(state.streamedSource)) {
+                    const delta = text.slice(state.streamedSource.length);
+                    if (delta)
+                        await stream.append(state.responseId, delta);
+                    await stream.stop(state.responseId);
+                    streamed = true;
+                }
+            }
+            catch (err) {
+                state.streamUnavailable = true;
+                log.logWarning("Native response streaming unavailable; falling back to message updates", err instanceof Error ? err.message : String(err));
+            }
+            state.streamActive = false;
+            state.streamedSource = "";
+            if (streamed) {
+                if (platform.needsCanonicalRender?.(text))
+                    await renderRaw(text, "render");
+                return text;
+            }
+            await abandonNativeStream();
+        }
+        if (state.responseId !== null || text)
+            return renderRaw(text, "render");
+        return text;
+    }
+    async function run(label, operation, work, extra) {
+        const operationPromise = queueTail.then(work);
+        const handled = operationPromise.catch(async (err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            log.logWarning(`${platform.label} ${label} error`, message);
+            reportResponseError(err, operation, extra());
+            if (platform.notifySendFailure) {
+                try {
+                    await platform.notifySendFailure(message);
+                }
+                catch {
+                    // A secondary notification must not poison the response queue.
+                }
+            }
+        });
+        queueTail = handled.catch(() => undefined);
+        return handled;
+    }
+    let queueTail = Promise.resolve();
+    async function appendDelta(delta) {
+        await run("appendResponseDelta", "respond", async () => {
+            if (!delta)
+                return;
+            if (state.resetDelta) {
+                state.source = "";
+                state.pendingChars = 0;
+                state.resetDelta = false;
+            }
+            const sanitized = sanitize(delta);
+            state.source += sanitized;
+            state.pendingChars += sanitized.length;
+            const elapsed = now() - state.lastFlushAt;
+            // A character threshold must not bypass the interval. When it did, a
+            // fast stream redrew every eighty characters — well over a hundred
+            // edits for a long answer — and the platform started refusing them.
+            if (state.lastFlushAt === 0 || (elapsed >= flushIntervalMs && state.pendingChars > 0)) {
+                state.pendingChars = 0;
+                state.source = await renderDelta(state.source);
+                // Stamp on completion: a slow or retrying send pushes the next
+                // redraw out by however long it took, so pressure never compounds.
+                state.lastFlushAt = now();
+            }
+        }, () => ({ textLength: delta.length, accumulatedLength: state.source.length }));
+    }
+    const responder = {
+        respond: async (text) => {
+            await run("respond", "respond", async () => {
+                const sanitized = sanitize(text);
+                state.source = state.source ? `${state.source}\n${sanitized}` : sanitized;
+                state.pendingChars = 0;
+                state.source = await renderDelta(state.source);
+                if (state.responseId !== null && platform.logIntermediateResponses) {
+                    platform.logBotResponse?.(text, state.responseId);
+                }
+            }, () => ({
+                phase: state.responseId ? "update" : "initial_post",
+                textLength: text.length,
+                accumulatedLength: state.source.length,
+            }));
+        },
+        appendResponseDelta: platform.supportsDeltas || platform.stream ? appendDelta : undefined,
+        finishResponse: platform.supportsDeltas || platform.stream
+            ? async (finalText) => {
+                await run("finishResponse", "set_working", async () => {
+                    if (finalText !== undefined)
+                        state.source = sanitize(finalText);
+                    state.resetDelta = false;
+                    state.pendingChars = 0;
+                    stopTyping();
+                    state.working = false;
+                    state.source = await renderFinal(state.source);
+                    if (state.responseId !== null)
+                        platform.logBotResponse?.(state.source, state.responseId);
+                    await platform.onFinish?.(state.source, state.responseId);
+                }, () => ({ finalTextLength: finalText?.length }));
+            }
+            : undefined,
+        replaceResponse: async (text, options) => {
+            await run("replaceResponse", "replace_response", async () => {
+                state.source = sanitize(text);
+                state.pendingChars = 0;
+                state.resetDelta = true;
+                if (state.streamActive)
+                    await stopNativeStream();
+                if (state.working && !state.source.trim())
+                    return;
+                // Prepare here too, not only on the delta path. This render is the
+                // last word on the response, so skipping it let the canonical
+                // replace overwrite prepared text with the raw source — a Discord
+                // table converted during streaming reverted to literal pipes the
+                // moment the run finished.
+                const prepared = platform.prepareSource?.(state.source, state.working) ?? state.source;
+                state.source = await renderRaw(provisional(prepared, state.working), "replace", options, 
+                // The prepared text is what was sent, so it is also what the
+                // renderer must remember it sent.
+                prepared);
+            }, () => ({
+                textLength: text.length,
+                hadExistingResponse: Boolean(state.responseId),
+            }));
+        },
+        replaceSubagentProgress: platform.formatSubagentProgress
+            ? async (progress, finalText) => {
+                const dashboard = platform.formatSubagentProgress(progress);
+                await responder.replaceResponse(finalText ? `${dashboard}\n\n${finalText}` : dashboard);
+            }
+            : undefined,
+        respondDiagnostic: async (text, options = {}) => {
+            await run("respondDiagnostic", "respond_diagnostic", async () => {
+                const ids = platform.postDiagnostic
+                    ? await platform.postDiagnostic(text, options, state.responseId)
+                    : await postDefaultDiagnostic(text, options);
+                state.extraIds.push(...ids);
+            }, () => ({ textLength: text.length, style: options.style }));
+        },
+        respondToolResult: async (result) => {
+            await responder.respondDiagnostic(platform.formatToolResult(result));
+        },
+        setTyping: async (isTyping) => {
+            await run("setTyping", "set_working", async () => {
+                if (platform.setTyping) {
+                    await platform.setTyping(isTyping, state.responseId);
+                    return;
+                }
+                const typing = platform.typing;
+                if (!typing)
+                    return;
+                const onTypingError = (err) => {
+                    if (state.typingFailureWarned)
+                        return;
+                    state.typingFailureWarned = true;
+                    log.logWarning(`${platform.label} sendTyping failed (further occurrences suppressed for this session)`, err instanceof Error ? err.message : String(err));
+                };
+                if (isTyping && state.typingInterval === null) {
+                    typing.send().catch(onTypingError);
+                    state.typingInterval = setInterval(() => {
+                        typing.send().catch(onTypingError);
+                    }, typing.intervalMs);
+                }
+                else if (!isTyping) {
+                    stopTyping();
+                }
+            }, () => ({ working: isTyping }));
+        },
+        setWorking: async (working) => {
+            await run("setWorking", "set_working", async () => {
+                state.working = working;
+                if (!working)
+                    stopTyping();
+                await platform.onWorkingChanged?.(working, state.responseId);
+                if (state.responseId === null || (!platform.workingIndicator && !platform.stream))
+                    return;
+                if (working && !state.source.trim())
+                    return;
+                if (state.streamActive && !working) {
+                    await stopNativeStream();
+                    return;
+                }
+                if (state.responseId !== null) {
+                    state.source = await renderRaw(provisional(state.source, working), "render", undefined, state.source);
+                }
+            }, () => ({ working }));
+        },
+        uploadFile: async (filePath, title) => {
+            if (platform.uploadFile) {
+                await platform.uploadFile(filePath, title);
+                return;
+            }
+            const note = platform.uploadFallbackNote?.(title ?? filePath);
+            if (note === undefined)
+                return;
+            await run("uploadFile", "respond_diagnostic", () => postExtra(note), () => ({ filePath }));
+        },
+        ...(platform.react ? { react: platform.react } : {}),
+        deleteResponse: async () => {
+            await run("deleteResponse", "respond", async () => {
+                stopTyping();
+                if (state.streamActive)
+                    await stopNativeStream().catch(() => undefined);
+                for (const id of [...state.extraIds, ...state.continuationIds]) {
+                    try {
+                        await platform.deleteExtra?.(id);
+                    }
+                    catch {
+                        // Deleting diagnostics is best effort.
+                    }
+                }
+                state.extraIds = [];
+                state.continuationIds = [];
+                if (state.responseId !== null) {
+                    try {
+                        await platform.delete?.(state.responseId);
+                    }
+                    catch {
+                        // Deleting the main response is best effort.
+                    }
+                }
+                state.responseId = null;
+                state.source = "";
+                state.streamUnavailable = false;
+                state.streamedSource = "";
+                state.streamActive = false;
+                state.resetDelta = false;
+                state.working = true;
+            }, () => ({}));
+        },
+    };
+    async function postDefaultDiagnostic(text, options) {
+        const prefix = options.style === "error" ? platform.errorPrefix : "";
+        const ids = [];
+        for (const part of split(sanitize(`${prefix}${text}`))) {
+            const id = await platform.postExtra(part, state.responseId);
+            if (typeof id === "string" || typeof id === "number")
+                ids.push(id);
+        }
+        return ids;
+    }
+    return { responder };
+}
+//# sourceMappingURL=progressive-renderer.js.map

package/dist/adapters/progressive-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progressive-renderer.js","sourceRoot":"","sources":["../../src/adapters/progressive-renderer.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ChatToolResult,\n  ConversationResponder,\n  SubagentProgressSnapshot,\n} from \"../adapter.js\";\nimport * as log from \"../log.js\";\nimport {\n  createChatResponseErrorReporter,\n  formatToolArgs,\n  splitText,\n  type ChatResponseErrorOperation,\n} from \"./shared.js\";\nimport type { ProgressiveRendererPlatform } from \"./types.js\";\n\nexport function formatMarkdownToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  let text = `**${result.isError ? \"Error\" : \"Done\"} ${result.toolName}**`;\n  if (result.label) text += `: ${result.label}`;\n  text += ` (${duration}s)\\n`;\n  if (argsFormatted) text += `\\`\\`\\`\\n${argsFormatted}\\n\\`\\`\\`\\n`;\n  text += `**Result:**\\n\\`\\`\\`\\n${result.result}\\n\\`\\`\\``;\n  return text;\n}\n\ninterface RendererState {\n  responseId: string | null;\n  source: string;\n  working: boolean;\n  streamActive: boolean;\n  streamUnavailable: boolean;\n  streamedSource: string;\n  pendingChars: number;\n  lastFlushAt: number;\n  resetDelta: boolean;\n  typingInterval: ReturnType<typeof setInterval> | null;\n  typingFailureWarned: boolean;\n  extraIds: Array<string | number>;\n  /**\n   * Messages holding the overflow of a response too long for one message,\n   * in order. Reused across redraws — see `postSplit`.\n   */\n  continuationIds: Array<string | number>;\n}\n\n/**\n * Floor on how often a streaming response redraws.\n *\n * Every platform meters edits per channel — Slack's is the tightest at roughly\n * fifty a minute — and a redraw sends the whole message, so the cost is the\n * number of calls, not their size. One second keeps a long answer inside that\n * budget while still reading as live.\n *\n * This is a floor, not a target: the interval is measured from when the last\n * redraw *finished*, so a platform that slows down under load slows the redraw\n * rate with it instead of queueing work it cannot deliver.\n */\nconst DEFAULT_FLUSH_INTERVAL_MS = 1000;\n\nexport function createProgressiveRenderer(platform: ProgressiveRendererPlatform): {\n  responder: ConversationResponder;\n} {\n  const state: RendererState = {\n    responseId: platform.initialResponseId ?? null,\n    source: \"\",\n    working: true,\n    streamActive: false,\n    streamUnavailable: false,\n    streamedSource: \"\",\n    pendingChars: 0,\n    lastFlushAt: 0,\n    resetDelta: false,\n    typingInterval: null,\n    typingFailureWarned: false,\n    extraIds: [],\n    continuationIds: [],\n  };\n  const sanitize = platform.sanitize ?? ((text: string) => text);\n  const reportResponseError = platform.responseErrorContext\n    ? createChatResponseErrorReporter(() => platform.responseErrorContext!(state.responseId))\n    : (err: unknown, operation: ChatResponseErrorOperation, extra?: Record<string, unknown>) =>\n        platform.reportError?.(err, operation, extra ?? {}, state.responseId);\n  const now = Date.now;\n  const flushIntervalMs = platform.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;\n\n  function stopTyping(): void {\n    if (state.typingInterval !== null) {\n      clearInterval(state.typingInterval);\n      state.typingInterval = null;\n    }\n  }\n\n  function provisional(text: string, working: boolean): string {\n    if (platform.formatProvisional) return platform.formatProvisional(text, working);\n    return working && platform.workingIndicator ? text + platform.workingIndicator : text;\n  }\n\n  function split(text: string): string[] {\n    return splitText(text, platform.maxLength, platform.formatContinuation);\n  }\n\n  async function postOrUpdate(text: string): Promise<void> {\n    if (state.responseId !== null) {\n      await platform.update(state.responseId, text);\n      return;\n    }\n    if (platform.typing?.stopOnSend) stopTyping();\n    state.responseId = await platform.post(text);\n  }\n\n  /**\n   * Render `text` as a head message plus however many overflow messages it\n   * needs.\n   *\n   * The overflow is *edited* on later redraws, not re-posted. A streaming\n   * response redraws roughly once a second, and re-posting meant every redraw\n   * past the length limit dropped another copy of the tail into the channel —\n   * a single long answer arrived as one correct message followed by six\n   * partial duplicates of itself.\n   *\n   * Reuse is positional: overflow N always lives in the same message, so the\n   * text a reader has already scrolled past does not move. A platform whose\n   * `postExtra` reports no id cannot be edited, and falls back to the old\n   * behaviour rather than losing the content.\n   */\n  async function postSplit(text: string): Promise<void> {\n    const [head = text, ...tail] = split(text);\n    await postOrUpdate(head);\n    for (const [index, part] of tail.entries()) {\n      const existing = state.continuationIds[index];\n      if (existing !== undefined) {\n        await platform.update(String(existing), part);\n        continue;\n      }\n      if (platform.typing?.stopOnSend) stopTyping();\n      const id = await platform.postExtra(part, state.responseId);\n      if (id !== undefined && id !== null) state.continuationIds[index] = id;\n    }\n  }\n\n  async function postExtra(text: string): Promise<void> {\n    if (platform.typing?.stopOnSend) stopTyping();\n    await platform.postExtra(text, state.responseId);\n  }\n\n  async function stopNativeStream(): Promise<void> {\n    if (!state.streamActive || state.responseId === null || !platform.stream) return;\n    const streamId = state.responseId;\n    state.streamActive = false;\n    state.streamedSource = \"\";\n    await platform.stream.stop(streamId);\n  }\n\n  async function abandonNativeStream(): Promise<void> {\n    if (!platform.stream || state.responseId === null) return;\n    const streamId = state.responseId;\n    state.streamActive = false;\n    state.streamedSource = \"\";\n    await platform.stream.stop(streamId).catch(() => undefined);\n    if (state.responseId === streamId) state.responseId = null;\n  }\n\n  async function renderRaw(\n    text: string,\n    operation: \"render\" | \"replace\",\n    options?: { createOverflowLink?: () => string },\n    canonicalText = text,\n  ): Promise<string> {\n    try {\n      await postSplit(text);\n      return canonicalText;\n    } catch (err) {\n      if (!platform.handleTooLong) throw err;\n      // Only a length rejection may take the truncating path. Treating every\n      // failure as \"too long\" turned a transient rate limit into a response\n      // cut to a few thousand characters under a notice blaming its length,\n      // and the retry it triggered kept the limit alive.\n      if (platform.isTooLongError && !platform.isTooLongError(err)) throw err;\n      const fallback = await platform.handleTooLong(\n        canonicalText,\n        operation,\n        options,\n        state.responseId,\n        postSplit,\n        () => state.responseId,\n      );\n      return fallback.text;\n    }\n  }\n\n  async function renderDelta(text: string): Promise<string> {\n    if (state.working && !text.trim()) return text;\n    const prepared = platform.prepareSource?.(text, state.working) ?? text;\n    const stream = platform.stream;\n    const display = provisional(prepared, state.working);\n    if (!stream || state.streamUnavailable) {\n      await renderRaw(display, \"render\", undefined, prepared);\n      return prepared;\n    }\n    if (state.responseId !== null && !state.streamActive) {\n      await renderRaw(display, \"render\", undefined, prepared);\n      return prepared;\n    }\n    if (\n      state.responseId !== null &&\n      state.streamActive &&\n      !prepared.startsWith(state.streamedSource)\n    ) {\n      await abandonNativeStream();\n      await renderRaw(display, \"render\", undefined, prepared);\n      return prepared;\n    }\n\n    try {\n      if (state.responseId !== null) {\n        const delta = prepared.slice(state.streamedSource.length);\n        // Below the threshold the delta stays pending: `state.streamedSource`\n        // does not advance, so the next tick recomputes it from the same base\n        // and `renderFinal` flushes the remainder before stopping.\n        if (delta && delta.length >= (stream.minDeltaChars ?? 0)) {\n          await stream.append(state.responseId, delta);\n          state.streamedSource = prepared;\n        }\n        return prepared;\n      }\n      state.responseId = await stream.start(prepared);\n      state.streamActive = true;\n      state.streamedSource = prepared;\n      return prepared;\n    } catch (err) {\n      state.streamUnavailable = true;\n      log.logWarning(\n        \"Native response streaming unavailable; falling back to message updates\",\n        err instanceof Error ? err.message : String(err),\n      );\n      await abandonNativeStream();\n      await renderRaw(display, \"render\", undefined, prepared);\n      return prepared;\n    }\n  }\n\n  async function renderFinal(text: string): Promise<string> {\n    const stream = platform.stream;\n    if (stream && state.streamActive && state.responseId !== null) {\n      let streamed = false;\n      try {\n        if (text.startsWith(state.streamedSource)) {\n          const delta = text.slice(state.streamedSource.length);\n          if (delta) await stream.append(state.responseId, delta);\n          await stream.stop(state.responseId);\n          streamed = true;\n        }\n      } catch (err) {\n        state.streamUnavailable = true;\n        log.logWarning(\n          \"Native response streaming unavailable; falling back to message updates\",\n          err instanceof Error ? err.message : String(err),\n        );\n      }\n      state.streamActive = false;\n      state.streamedSource = \"\";\n      if (streamed) {\n        if (platform.needsCanonicalRender?.(text)) await renderRaw(text, \"render\");\n        return text;\n      }\n      await abandonNativeStream();\n    }\n    if (state.responseId !== null || text) return renderRaw(text, \"render\");\n    return text;\n  }\n\n  async function run(\n    label: string,\n    operation: ChatResponseErrorOperation,\n    work: () => Promise<void>,\n    extra: () => Record<string, unknown>,\n  ): Promise<void> {\n    const operationPromise = queueTail.then(work);\n    const handled = operationPromise.catch(async (err) => {\n      const message = err instanceof Error ? err.message : String(err);\n      log.logWarning(`${platform.label} ${label} error`, message);\n      reportResponseError(err, operation, extra());\n      if (platform.notifySendFailure) {\n        try {\n          await platform.notifySendFailure(message);\n        } catch {\n          // A secondary notification must not poison the response queue.\n        }\n      }\n    });\n    queueTail = handled.catch(() => undefined);\n    return handled;\n  }\n\n  let queueTail = Promise.resolve();\n\n  async function appendDelta(delta: string): Promise<void> {\n    await run(\n      \"appendResponseDelta\",\n      \"respond\",\n      async () => {\n        if (!delta) return;\n        if (state.resetDelta) {\n          state.source = \"\";\n          state.pendingChars = 0;\n          state.resetDelta = false;\n        }\n        const sanitized = sanitize(delta);\n        state.source += sanitized;\n        state.pendingChars += sanitized.length;\n        const elapsed = now() - state.lastFlushAt;\n        // A character threshold must not bypass the interval. When it did, a\n        // fast stream redrew every eighty characters — well over a hundred\n        // edits for a long answer — and the platform started refusing them.\n        if (state.lastFlushAt === 0 || (elapsed >= flushIntervalMs && state.pendingChars > 0)) {\n          state.pendingChars = 0;\n          state.source = await renderDelta(state.source);\n          // Stamp on completion: a slow or retrying send pushes the next\n          // redraw out by however long it took, so pressure never compounds.\n          state.lastFlushAt = now();\n        }\n      },\n      () => ({ textLength: delta.length, accumulatedLength: state.source.length }),\n    );\n  }\n\n  const responder: ConversationResponder = {\n    respond: async (text: string) => {\n      await run(\n        \"respond\",\n        \"respond\",\n        async () => {\n          const sanitized = sanitize(text);\n          state.source = state.source ? `${state.source}\\n${sanitized}` : sanitized;\n          state.pendingChars = 0;\n          state.source = await renderDelta(state.source);\n          if (state.responseId !== null && platform.logIntermediateResponses) {\n            platform.logBotResponse?.(text, state.responseId);\n          }\n        },\n        () => ({\n          phase: state.responseId ? \"update\" : \"initial_post\",\n          textLength: text.length,\n          accumulatedLength: state.source.length,\n        }),\n      );\n    },\n\n    appendResponseDelta: platform.supportsDeltas || platform.stream ? appendDelta : undefined,\n\n    finishResponse:\n      platform.supportsDeltas || platform.stream\n        ? async (finalText?: string) => {\n            await run(\n              \"finishResponse\",\n              \"set_working\",\n              async () => {\n                if (finalText !== undefined) state.source = sanitize(finalText);\n                state.resetDelta = false;\n                state.pendingChars = 0;\n                stopTyping();\n                state.working = false;\n                state.source = await renderFinal(state.source);\n                if (state.responseId !== null)\n                  platform.logBotResponse?.(state.source, state.responseId);\n                await platform.onFinish?.(state.source, state.responseId);\n              },\n              () => ({ finalTextLength: finalText?.length }),\n            );\n          }\n        : undefined,\n\n    replaceResponse: async (text: string, options?: { createOverflowLink?: () => string }) => {\n      await run(\n        \"replaceResponse\",\n        \"replace_response\",\n        async () => {\n          state.source = sanitize(text);\n          state.pendingChars = 0;\n          state.resetDelta = true;\n          if (state.streamActive) await stopNativeStream();\n          if (state.working && !state.source.trim()) return;\n          // Prepare here too, not only on the delta path. This render is the\n          // last word on the response, so skipping it let the canonical\n          // replace overwrite prepared text with the raw source — a Discord\n          // table converted during streaming reverted to literal pipes the\n          // moment the run finished.\n          const prepared = platform.prepareSource?.(state.source, state.working) ?? state.source;\n          state.source = await renderRaw(\n            provisional(prepared, state.working),\n            \"replace\",\n            options,\n            // The prepared text is what was sent, so it is also what the\n            // renderer must remember it sent.\n            prepared,\n          );\n        },\n        () => ({\n          textLength: text.length,\n          hadExistingResponse: Boolean(state.responseId),\n        }),\n      );\n    },\n\n    replaceSubagentProgress: platform.formatSubagentProgress\n      ? async (progress: SubagentProgressSnapshot, finalText?: string) => {\n          const dashboard = platform.formatSubagentProgress!(progress);\n          await responder.replaceResponse(finalText ? `${dashboard}\\n\\n${finalText}` : dashboard);\n        }\n      : undefined,\n\n    respondDiagnostic: async (text, options = {}) => {\n      await run(\n        \"respondDiagnostic\",\n        \"respond_diagnostic\",\n        async () => {\n          const ids = platform.postDiagnostic\n            ? await platform.postDiagnostic(text, options, state.responseId)\n            : await postDefaultDiagnostic(text, options);\n          state.extraIds.push(...ids);\n        },\n        () => ({ textLength: text.length, style: options.style }),\n      );\n    },\n\n    respondToolResult: async (result: ChatToolResult) => {\n      await responder.respondDiagnostic(platform.formatToolResult(result));\n    },\n\n    setTyping: async (isTyping: boolean) => {\n      await run(\n        \"setTyping\",\n        \"set_working\",\n        async () => {\n          if (platform.setTyping) {\n            await platform.setTyping(isTyping, state.responseId);\n            return;\n          }\n          const typing = platform.typing;\n          if (!typing) return;\n          const onTypingError = (err: unknown): void => {\n            if (state.typingFailureWarned) return;\n            state.typingFailureWarned = true;\n            log.logWarning(\n              `${platform.label} sendTyping failed (further occurrences suppressed for this session)`,\n              err instanceof Error ? err.message : String(err),\n            );\n          };\n          if (isTyping && state.typingInterval === null) {\n            typing.send().catch(onTypingError);\n            state.typingInterval = setInterval(() => {\n              typing.send().catch(onTypingError);\n            }, typing.intervalMs);\n          } else if (!isTyping) {\n            stopTyping();\n          }\n        },\n        () => ({ working: isTyping }),\n      );\n    },\n\n    setWorking: async (working: boolean) => {\n      await run(\n        \"setWorking\",\n        \"set_working\",\n        async () => {\n          state.working = working;\n          if (!working) stopTyping();\n          await platform.onWorkingChanged?.(working, state.responseId);\n          if (state.responseId === null || (!platform.workingIndicator && !platform.stream)) return;\n          if (working && !state.source.trim()) return;\n\n          if (state.streamActive && !working) {\n            await stopNativeStream();\n            return;\n          }\n          if (state.responseId !== null) {\n            state.source = await renderRaw(\n              provisional(state.source, working),\n              \"render\",\n              undefined,\n              state.source,\n            );\n          }\n        },\n        () => ({ working }),\n      );\n    },\n\n    uploadFile: async (filePath: string, title?: string) => {\n      if (platform.uploadFile) {\n        await platform.uploadFile(filePath, title);\n        return;\n      }\n      const note = platform.uploadFallbackNote?.(title ?? filePath);\n      if (note === undefined) return;\n      await run(\n        \"uploadFile\",\n        \"respond_diagnostic\",\n        () => postExtra(note),\n        () => ({ filePath }),\n      );\n    },\n\n    ...(platform.react ? { react: platform.react } : {}),\n\n    deleteResponse: async () => {\n      await run(\n        \"deleteResponse\",\n        \"respond\",\n        async () => {\n          stopTyping();\n          if (state.streamActive) await stopNativeStream().catch(() => undefined);\n          for (const id of [...state.extraIds, ...state.continuationIds]) {\n            try {\n              await platform.deleteExtra?.(id);\n            } catch {\n              // Deleting diagnostics is best effort.\n            }\n          }\n          state.extraIds = [];\n          state.continuationIds = [];\n          if (state.responseId !== null) {\n            try {\n              await platform.delete?.(state.responseId);\n            } catch {\n              // Deleting the main response is best effort.\n            }\n          }\n          state.responseId = null;\n          state.source = \"\";\n          state.streamUnavailable = false;\n          state.streamedSource = \"\";\n          state.streamActive = false;\n          state.resetDelta = false;\n          state.working = true;\n        },\n        () => ({}),\n      );\n    },\n  };\n\n  async function postDefaultDiagnostic(\n    text: string,\n    options: { style?: \"muted\" | \"error\" },\n  ): Promise<Array<string | number>> {\n    const prefix = options.style === \"error\" ? platform.errorPrefix : \"\";\n    const ids: Array<string | number> = [];\n    for (const part of split(sanitize(`${prefix}${text}`))) {\n      const id = await platform.postExtra(part, state.responseId);\n      if (typeof id === \"string\" || typeof id === \"number\") ids.push(id);\n    }\n    return ids;\n  }\n\n  return { responder };\n}\n"]}

package/dist/adapters/shared.d.ts

@@ -6,9 +6,10 @@
  * The split/normalize logic itself doesn't differ across platforms — only the
  * markup wrappers — so it lives here once.
  */
-import type { MessagingEventHandler } from "../adapter.js";
-export type { ChatResponseErrorContext, ChatResponseErrorOperation, ChatResponseErrorReporter, ResolveStopTargetInput, RetryOptions, } from "./types.js";
-import type { ChatResponseErrorContext, ChatResponseErrorReporter, RetryOptions, ResolveStopTargetInput } from "./types.js";
+import type { MessagingEventHandler, OfficeAddress } from "../adapter.js";
+import { type Office } from "../office/index.js";
+export type { ChatResponseErrorContext, ChatResponseErrorOperation, ChatResponseErrorReporter, IncomingAttachment, ResolveStopTargetInput, RetryOptions, SavedAttachments, } from "./types.js";
+import type { ChatResponseErrorContext, ChatResponseErrorReporter, IncomingAttachment, RetryOptions, ResolveStopTargetInput, SavedAttachments } from "./types.js";
 export declare function createChatResponseErrorReporter(resolve: () => Omit<ChatResponseErrorContext, "operation" | "extra">): ChatResponseErrorReporter;
 export declare class MessagingEventQueue {
     private readonly name;
@@ -34,13 +35,24 @@ export declare function withRetry<T>(fn: () => Promise<T>, opts: RetryOptions):
  */
 export declare function splitText(text: string, limit: number, formatContinuation: (partNum: number) => string): string[];
 /**
- * Append a JSON-serializable entry to `${workingDir}/${channel}/log.jsonl`,
- * creating the directory on first use. This is the single write path every
+ * Append a JSON-serializable entry to the office's `log.jsonl`,
+ * materializing the office on first use. This is the single write path every
  * adapter uses for human-readable message history.
  */
-export declare function appendChannelLog(workingDir: string, channel: string, entry: object): void;
+export declare function appendChannelLog(office: Office, entry: object): void;
+/**
+ * Save incoming platform files under the office's attachments directory.
+ *
+ * The one owner of the attachment convention: sanitized
+ * `<timestamp>_<name>` filenames, the `<office key>/attachments/<file>`
+ * workspace-relative localPath the agent reads, and office materialization
+ * before the first write. Download mechanics and failure policy stay with
+ * the adapter — failures come back in `failed` for the caller to throw or
+ * warn about, matching its platform's behavior.
+ */
+export declare function saveIncomingAttachments(office: Office, items: readonly IncomingAttachment[]): Promise<SavedAttachments>;
 /** Convenience for appending the bot's own outbound message. */
-export declare function appendBotResponseLog(workingDir: string, channel: string, text: string, ts: string, threadTs?: string, extraFields?: Record<string, unknown>): void;
+export declare function appendBotResponseLog(office: Office, text: string, ts: string, threadTs?: string, extraFields?: Record<string, unknown>): void;
 /**
  * Pick which session key a `/stop` should target without applying any
  * platform-specific fallback policy. Order:
@@ -49,10 +61,11 @@ export declare function appendBotResponseLog(workingDir: string, channel: string
  */
 export declare function resolveStopTarget(input: ResolveStopTargetInput): string | null;
 /**
- * Return the single running scoped session for this conversation, or null when
- * there are zero or multiple matches.
+ * Return the single running scoped session for this office, or null when there
+ * are zero or multiple matches. Another platform's identically named
+ * conversation is a different office and is never a stop target.
  */
-export declare function resolveOnlyScopedStopTarget(handler: MessagingEventHandler, conversationId: string): string | null;
+export declare function resolveOnlyScopedStopTarget(handler: MessagingEventHandler, address: OfficeAddress): string | null;
 /**
  * Render tool-call args for human display. Drops `label` (already in the
  * heading) and folds `path` + `offset`/`limit` into a single `path:start-end`

package/dist/adapters/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAI3D,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,YAAY,EACZ,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,IAAI,CAAC,wBAAwB,EAAE,WAAW,GAAG,OAAO,CAAC,GACnE,yBAAyB,CAI3B;AA0BD,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAAS;IAE3B,YAA6B,IAAI,GAAE,MAAW,EAAI;IAElD,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAGvC;IAED,IAAI,IAAI,MAAM,CAEb;YAEa,WAAW;CAe1B;AAID;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBvF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAC9C,MAAM,EAAE,CAeV;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIzF;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACxC,IAAI,CAWN;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAM9E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,qBAAqB,EAC9B,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAOf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAsBhF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpF"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG7D,YAAY,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,IAAI,CAAC,wBAAwB,EAAE,WAAW,GAAG,OAAO,CAAC,GACnE,yBAAyB,CAI3B;AA0BD,qBAAa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,UAAU,CAAS;IAE3B,YAA6B,IAAI,GAAE,MAAW,EAAI;IAElD,OAAO,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAGvC;IAED,IAAI,IAAI,MAAM,CAEb;YAEa,WAAW;CAe1B;AAID;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBvF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAC9C,MAAM,EAAE,CAeV;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGpE;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,kBAAkB,EAAE,GACnC,OAAO,CAAC,gBAAgB,CAAC,CA2B3B;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACxC,IAAI,CAWN;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAM9E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,aAAa,GACrB,MAAM,GAAG,IAAI,CAQf;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAsBhF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQpF"}