ticlawk 0.1.16-dev.7 → 0.1.16-dev.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticlawk",
-  "version": "0.1.16-dev.7",
+  "version": "0.1.16-dev.8",
   "description": "Local connector that links agent harnesses (Claude Code, Codex, OpenClaw, opencode, Pi) to the Ticlawk mobile app.",
   "type": "module",
   "main": "ticlawk.mjs",

package/src/adapters/ticlawk/api.mjs

@@ -149,18 +149,6 @@ export async function updateChannel(id, updates) {
   return updateAgent(id, updates);
 }
 
-export async function postRuntimeResult(body) {
-  // Activity-only: backend records the agent_event for UI trajectory
-  // display but does NOT project it into a chat message. The agent CLI's
-  // `ticlawk message send` is the only path that produces chat rows.
-  const result = await apiFetch('/api/runtime-results', {
-    method: 'POST',
-    body: JSON.stringify(body),
-    timeout: 30000,
-  });
-  return result;
-}
-
 // ── Deliveries (replaces legacy message_jobs poll/ack) ──
 
 export async function claimPendingDeliveries(hostId, limit = 5, excludedAgentIds = []) {
@@ -199,6 +187,7 @@ export async function sendAgentMessage({
   replyToMessageId,
   runtimeHostId,
   visibility,
+  mediaAssetIds,
 }) {
   const { data } = await apiFetch('/api/agent/messages/send', {
     method: 'POST',
@@ -210,6 +199,7 @@ export async function sendAgentMessage({
       reply_to_message_id: replyToMessageId ?? null,
       runtime_host_id: runtimeHostId ?? null,
       visibility: visibility || null,
+      media_asset_ids: Array.isArray(mediaAssetIds) && mediaAssetIds.length > 0 ? mediaAssetIds : undefined,
     }),
   });
   return data || null;
@@ -494,22 +484,6 @@ export async function removeAgentGroupMember({
   );
 }
 
-// ── Upload ──
-
-export async function uploadAsset(fileName, fileData, contentType, kind = 'chat_media') {
-  const formData = new FormData();
-  formData.append('file', new Blob([fileData], { type: contentType }), fileName);
-  formData.append('kind', kind);
-  if (contentType) formData.append('content_type', contentType);
-
-  const { data } = await apiFetch('/api/assets/upload', {
-    method: 'POST',
-    body: formData,
-    timeout: 30000,
-  });
-  return data;
-}
-
 // ── Channel event pipe ──
 
 export async function postEvent({ agent, agent_id, runtime_host_id, session_id, cwd, runtime_version, event, required = false }) {

package/src/adapters/ticlawk/index.mjs

@@ -10,7 +10,6 @@ import { isTerminalRuntimeFailure } from '../../core/runtime-support.mjs';
 import { clearUpdateRequiredState, readUpdateState, setUpdateRequiredState } from '../../core/update-state.mjs';
 import { isManagedInstall, startDetachedSelfUpdate } from '../../core/update.mjs';
 import * as api from './api.mjs';
-import { processAndSaveResult } from './cards.mjs';
 import { persistApiCredential } from './credentials.mjs';
 import { TiclawkWakeClient } from './wake-client.mjs';
 
@@ -205,10 +204,6 @@ export function normalizeInboundMessage(msg) {
   };
 }
 
-function getBindingSessionId(binding) {
-  return binding?.runtimeMeta?.sessionId || binding?.runtimeMeta?.sessionKey || binding?.runtimeMeta?.agentId || binding?.id || null;
-}
-
 function getRuntimeVersion(bindingOrMeta) {
   const value = bindingOrMeta?.runtimeMeta?.runtimeVersion ?? bindingOrMeta?.runtimeVersion ?? bindingOrMeta?.agent_runtime_version ?? null;
   return Number.isInteger(value) ? Number(value) : null;
@@ -1341,25 +1336,6 @@ export function createTiclawkAdapter(ctx) {
       }
     },
 
-    async send(binding, outbound) {
-      const localMediaPaths = (outbound.media || [])
-        .filter((item) => item.kind === 'local_path')
-        .map((item) => item.value);
-      await processAndSaveResult({
-        text: outbound.text || '',
-        mediaUrls: localMediaPaths,
-      }, {
-        agentId: binding.id,
-        hostId,
-        agent: binding.runtime,
-        sessionId: getBindingSessionId(binding),
-        runtimeVersion: getRuntimeVersion(binding),
-        turnId: outbound.turnId || outbound.replyToMessageId || null,
-        type: outbound.type || 'agent_message',
-        replyToMessageId: outbound.replyToMessageId || null,
-      });
-    },
-
     // Daemon-driven impersonated reply: the runtime never reached
     // `ticlawk message send` (subprocess died, timeout, etc.), so the
     // daemon speaks for the agent. Used by reportSubprocessFailure

package/src/cli/agent-commands.mjs

@@ -136,12 +136,37 @@ export async function runMessageSendCommand(args) {
     console.error('  EOF');
     return 2;
   }
+
+  // --attach <path> may be passed multiple times. Each file is uploaded
+  // through the same daemon endpoint as `ticlawk attachment upload`, then
+  // its asset_id is linked to the message via media_asset_ids.
+  const attachArg = args.attach;
+  const attachPaths = Array.isArray(attachArg)
+    ? attachArg
+    : attachArg
+      ? [attachArg]
+      : [];
+  if (attachPaths.length > 10) {
+    console.error('at most 10 --attach files per message');
+    return 2;
+  }
+  const mediaAssetIds = [];
+  for (const filePath of attachPaths) {
+    const upload = await uploadFileViaDaemon(env, String(filePath));
+    if (!upload.ok) {
+      console.error(`attachment upload failed for ${filePath}: ${upload.error}`);
+      return 1;
+    }
+    mediaAssetIds.push(upload.assetId);
+  }
+
   const body = {
     target,
     conversation_id: conversationId,
     text: text.replace(/\n+$/, ''),
     seen_up_to_seq: getNumberArg(args, 'seen-up-to-seq'),
     reply_to_message_id: getArg(args, 'reply-to'),
+    media_asset_ids: mediaAssetIds.length > 0 ? mediaAssetIds : undefined,
   };
   const res = await daemonRequest({
     method: 'POST',
@@ -802,12 +827,14 @@ export async function runServerInfoCommand(args) {
 
 export const AGENT_COMMAND_HELP = {
   message: `ticlawk message <send|read|check|search|react>
-  ticlawk message send --target "<target>" [--seen-up-to-seq N] [--reply-to <msg-id>]
+  ticlawk message send --target "<target>" [--seen-up-to-seq N] [--reply-to <msg-id>] [--attach <file> ...]
     Body is read from stdin (use <<'EOF' ... EOF for multiline).
     Targets:
       dm:@<user>         private message
       #<group>           group conversation
       #<group>:<msgid>   thread under a top-level message in that group
+    --attach <file> uploads a local file and attaches it to the message
+      (repeatable; max 10 attachments per message).
   ticlawk message read --target "<target>" [--around <msg-id>] [--before-seq N] [--limit N]
   ticlawk message check [--target "<target>"]
     Non-blocking poll for new/unprocessed messages.
@@ -823,6 +850,9 @@ export const AGENT_COMMAND_HELP = {
 `,
   attachment: `ticlawk attachment <upload|view>
   ticlawk attachment upload <file>
+    Upload-only — the user is NOT notified. Almost always you want
+    \`ticlawk message send --attach <file>\` instead, which uploads AND
+    surfaces the file to the user inside a chat message.
   ticlawk attachment view <asset-id> [--out <path>]
 `,
   reminder: `ticlawk reminder <schedule|list|snooze|update|cancel|log>

package/src/core/agent-cli-handlers.mjs

@@ -145,6 +145,10 @@ export async function handleMessageSend(req, body, ctx) {
     return { status: 400, body: { error: 'target or conversation_id is required' } };
   }
 
+  const mediaAssetIds = Array.isArray(body?.media_asset_ids)
+    ? body.media_asset_ids.map((v) => String(v).trim()).filter(Boolean)
+    : [];
+
   try {
     const data = await api.sendAgentMessage({
       actingAgentId,
@@ -153,6 +157,7 @@ export async function handleMessageSend(req, body, ctx) {
       seenUpToSeq: body?.seen_up_to_seq,
       replyToMessageId: body?.reply_to_message_id || threadRootMsgId || null,
       runtimeHostId: getRuntimeHostId(req, body),
+      mediaAssetIds,
     });
     debugLog('agent-cli', 'send.ok', {
       actingAgentId,

package/src/core/runtime-support.mjs

@@ -42,36 +42,6 @@ export function shouldStreamRuntime(runtimeName, runtime) {
   return Boolean(runtime?.runTurnStream) && getStreamingMode(runtimeName);
 }
 
-export async function sendAdapterMessage(adapter, binding, payload) {
-  await adapter.send(binding, payload);
-}
-
-/**
- * Record the runtime's final turn output as activity (NOT chat).
- *
- * Previously called `sendResult` and treated as "the chat reply path".
- * After the group-chat upgrade, chat is produced exclusively by the
- * agent invoking `ticlawk message send` via the CLI. The runtime's
- * raw final output is still surfaced for trajectory/debug UI, but it
- * no longer materializes as a `messages` row — the trigger
- * `project_agent_event` was updated in PR-2b to drop the chat
- * projection.
- *
- * Renamed so the call sites read self-evidently: "record activity"
- * never reads as "send a chat message".
- */
-export async function recordActivity(adapter, binding, inbound, result) {
-  if (!result?.text && (!result?.mediaUrls || result.mediaUrls.length === 0)) return;
-  await sendAdapterMessage(adapter, binding, {
-    type: 'assistant',
-    text: result.text || '',
-    media: result.media || [],
-    turnId: inbound.messageId || result?.turnId || null,
-    replyToMessageId: inbound.messageId || null,
-  });
-}
-
-
 export async function reportSubprocessFailure({ adapter, binding, inbound, runtimeName, info }) {
   if (!info || info.ok) return;
   const seconds = ((info.durationMs || 0) / 1000).toFixed(1);

package/src/runtimes/_shared/standing-prompt.mjs

@@ -63,6 +63,27 @@ EOF
 
 **IMPORTANT**: To reply to any message, always reuse the exact \`target\` from the received message. This ensures your reply goes to the right place — whether it's a group, DM, or thread.
 
+### Sending files
+
+When you produce a file the user should see (a generated report, a
+screenshot, a downloaded asset, a code patch as a file), attach it
+inline with the chat message:
+
+\`\`\`bash
+ticlawk message send --target "#group" --attach /tmp/report.pdf --attach /tmp/chart.png <<'EOF'
+Here's the analysis you asked for — full report attached, plus the
+key chart pulled out for quick reference.
+EOF
+\`\`\`
+
+- \`--attach <path>\` may be repeated; up to 10 files per message.
+- Each file uploads to the secure file layer and surfaces to the user
+  inside the chat UI alongside your text.
+- \`ticlawk attachment upload <file>\` exists as a separate command but
+  **only uploads** — the user is not notified and cannot see the file.
+  Almost never the right command. Only use it if you have a specific
+  reason to stash a file for later use without telling the user.
+
 ### Threads
 
 Threads are sub-conversations attached to a specific message. They let you discuss a topic without cluttering the main group.

package/src/runtimes/claude-code/index.mjs

@@ -23,11 +23,9 @@ import {
 } from './session.mjs';
 import { discoverSessions } from './transcripts.mjs';
 import { buildImageMessageFromInbound } from '../../core/media/inbound.mjs';
-import { normalizeOutboundMedia } from '../../core/media/outbound.mjs';
 import { emitWorkerEvent } from '../../core/events/worker-events.mjs';
 import {
   shouldStreamRuntime,
-  recordActivity,
   reportSubprocessFailure,
   terminalRuntimeFailure,
   updateBindingRuntimeMeta,
@@ -196,10 +194,6 @@ export const claudeCodeRuntime = {
         rotatePending: false,
         lastRotatedAt: shouldRotate ? new Date().toISOString() : meta.lastRotatedAt,
       }, { status: 'connected' });
-      await recordActivity(adapter, nextBinding, inbound, {
-        ...result,
-        media: normalizeOutboundMedia(result),
-      });
       await emitWorkerEvent({
         adapter,
         binding: nextBinding,

package/src/runtimes/codex/index.mjs

@@ -18,13 +18,10 @@ import {
   requireCodexPath,
 } from './session.mjs';
 import { buildCodexInputFromInbound } from '../../core/media/inbound.mjs';
-import { normalizeOutboundMedia } from '../../core/media/outbound.mjs';
 import { emitWorkerEvent } from '../../core/events/worker-events.mjs';
 import {
   shouldStreamRuntime,
   createDeltaAggregator,
-  sendAdapterMessage,
-  recordActivity,
   reportSubprocessFailure,
   terminalRuntimeFailure,
   updateBindingRuntimeMeta,
@@ -215,10 +212,6 @@ export const codexRuntime = {
         rotatePending: false,
         lastRotatedAt: shouldRotate ? new Date().toISOString() : meta.lastRotatedAt,
       }, { status: 'connected' });
-      await recordActivity(adapter, nextBinding, inbound, {
-        ...result,
-        media: normalizeOutboundMedia(result),
-      });
       await emitWorkerEvent({
         adapter,
         binding: nextBinding,

package/src/runtimes/openclaw/index.mjs

@@ -1,5 +1,4 @@
-import { normalizeOutboundMedia } from '../../core/media/outbound.mjs';
-import { reportSubprocessFailure, sendAdapterMessage, recordActivity, terminalRuntimeFailure } from '../../core/runtime-support.mjs';
+import { reportSubprocessFailure, terminalRuntimeFailure } from '../../core/runtime-support.mjs';
 import { buildStandingPrompt } from '../_shared/standing-prompt.mjs';
 import { GATEWAY_HOST, GATEWAY_PORT } from './identity.mjs';
 
@@ -192,10 +191,6 @@ export const openClawRuntime = {
           });
         },
       });
-      await recordActivity(adapter, binding, inbound, {
-        ...result,
-        media: normalizeOutboundMedia(result),
-      });
       return true;
     } catch (err) {
       if (typeof adapter.emitEvent === 'function') {
@@ -233,18 +228,11 @@ export const openClawRuntime = {
     }
   },
 
-  async recoverInFlight(ctx) {
+  async recoverInFlight() {
+    // Just drain the persisted in-flight set — the user-facing notice
+    // that used to surface here went through the dead chat-projection
+    // path. OpenClaw is non-primary; this no-ops cleanly for now.
     const entries = recoverInFlightEntries();
-    for (const entry of entries) {
-      const binding = ctx.getBinding(entry.bindingId);
-      if (!binding) continue;
-      await sendAdapterMessage(ctx.adapter, binding, {
-        type: 'assistant',
-        text: '⚠️ Lost while ticlawk restarted.\n\nThis OpenClaw message was in flight when ticlawk restarted. Please retry your message.',
-        media: [],
-        replyToMessageId: entry.messageId || null,
-      }).catch(() => {});
-    }
     return entries.length;
   },
 

package/src/runtimes/opencode/index.mjs

@@ -24,13 +24,10 @@ import {
   requireOpenCodePath,
 } from './session.mjs';
 import { buildOpenCodeInputFromInbound } from '../../core/media/inbound.mjs';
-import { normalizeOutboundMedia } from '../../core/media/outbound.mjs';
 import { emitWorkerEvent } from '../../core/events/worker-events.mjs';
 import {
   shouldStreamRuntime,
   createDeltaAggregator,
-  sendAdapterMessage,
-  recordActivity,
   reportSubprocessFailure,
   terminalRuntimeFailure,
   updateBindingRuntimeMeta,
@@ -146,24 +143,14 @@ export const openCodeRuntime = {
       const captionText = (inbound.text || '').trim();
 
       if (files.length === 0 && !captionText) {
-        await sendAdapterMessage(adapter, binding, {
-          type: 'assistant',
-          text: '⚠️ Image attached, but I could not access the image data and there is no caption to fall back to. Try sending the image again, or include a text caption.',
-          media: [],
-          replyToMessageId: inbound.messageId || null,
-        });
+        // Image decode failed and no caption to fall back on — we have
+        // nothing meaningful to feed the model. Bail without a user
+        // notice; this runtime is non-primary and the dead chat-projection
+        // path that used to surface such notices is gone.
         return true;
       }
-
-      if (files.length === 0 && captionText) {
-        // Downloads all failed; tell the user we're proceeding with the caption alone.
-        await sendAdapterMessage(adapter, binding, {
-          type: 'assistant',
-          text: '⚠️ Could not access the attached image data; acting on the caption text only.',
-          media: [],
-          replyToMessageId: inbound.messageId || null,
-        });
-      }
+      // If files.length === 0 && captionText, fall through with the
+      // caption-only message below — no inline user notice.
 
       // If user sent images with no caption, give the model a minimal
       // instruction so it has something to anchor on.
@@ -238,10 +225,6 @@ export const openCodeRuntime = {
         rotatePending: false,
         lastRotatedAt: shouldRotate ? new Date().toISOString() : meta.lastRotatedAt,
       }, { status: 'connected' });
-      await recordActivity(adapter, nextBinding, inbound, {
-        ...result,
-        media: normalizeOutboundMedia(result),
-      });
       await emitWorkerEvent({
         adapter,
         binding: nextBinding,

package/src/runtimes/pi/index.mjs

@@ -22,8 +22,6 @@ import { emitWorkerEvent } from '../../core/events/worker-events.mjs';
 import {
   shouldStreamRuntime,
   createDeltaAggregator,
-  sendAdapterMessage,
-  recordActivity,
   reportSubprocessFailure,
   terminalRuntimeFailure,
   updateBindingRuntimeMeta,
@@ -122,22 +120,11 @@ export const piRuntime = {
       images = await buildPiImagesFromInbound(inbound);
       const captionText = (inbound.text || '').trim();
       if (images.length === 0 && !captionText) {
-        await sendAdapterMessage(adapter, binding, {
-          type: 'assistant',
-          text: '⚠️ Image attached, but I could not access the image data and there is no caption to fall back on. Try sending the image again, or include a text caption.',
-          media: [],
-          replyToMessageId: inbound.messageId || null,
-        });
+        // Image decode failed and no caption to fall back on. Bail
+        // without a user notice; the dead chat-projection path that
+        // used to surface such notices is gone.
         return true;
       }
-      if (images.length === 0 && captionText) {
-        await sendAdapterMessage(adapter, binding, {
-          type: 'assistant',
-          text: '⚠️ Could not access the attached image data; acting on the caption text only.',
-          media: [],
-          replyToMessageId: inbound.messageId || null,
-        });
-      }
       message = captionText || 'Please analyze the attached image(s).';
     }
 
@@ -209,7 +196,6 @@ export const piRuntime = {
         rotatePending: false,
         lastRotatedAt: shouldRotate ? new Date().toISOString() : meta.lastRotatedAt,
       }, { status: 'connected' });
-      await recordActivity(adapter, nextBinding, inbound, result);
       await emitWorkerEvent({
         adapter,
         binding: nextBinding,

package/src/adapters/ticlawk/cards.mjs

@@ -1,149 +0,0 @@
-/**
- * ticlawk adapter — final agent message / media write path.
- *
- * Everything here turns an agent result (text + optional media local paths)
- * into a terminal runtime result written back to ticlawk.
- *
- * This module imports from `./api.mjs` (HTTP client) and from
- * `../../core/logger.mjs` (structured logging). No runtime dependencies.
- */
-
-import { existsSync, readFileSync } from 'node:fs';
-import { extname } from 'node:path';
-import { randomUUID } from 'node:crypto';
-import * as api from './api.mjs';
-import { extractMediaPaths } from '../../core/media/outbound.mjs';
-import { debugLog, debugError } from '../../core/logger.mjs';
-import { TICLAWK_CONNECTOR_API_KEY } from '../../core/config.mjs';
-
-const MIME_MAP = {
-  '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
-  '.gif': 'image/gif', '.webp': 'image/webp', '.svg': 'image/svg+xml',
-  '.mp4': 'video/mp4', '.webm': 'video/webm',
-  '.opus': 'audio/opus', '.mp3': 'audio/mpeg', '.wav': 'audio/wav',
-  '.pdf': 'application/pdf',
-};
-
-async function uploadLocalAsset(localPath) {
-  if (!process.env[TICLAWK_CONNECTOR_API_KEY]) {
-    debugError('relay', 'upload.skipped', {
-      localPath,
-      reason: 'missing connector api key',
-    });
-    return null;
-  }
-  if (!existsSync(localPath)) {
-    debugError('relay', 'upload.skipped', {
-      localPath,
-      reason: 'file not found',
-    });
-    return null;
-  }
-
-  const ext = extname(localPath).toLowerCase();
-  const contentType = MIME_MAP[ext] || 'application/octet-stream';
-  const fileName = `${Date.now()}-${randomUUID().slice(0, 8)}${ext}`;
-  const fileData = readFileSync(localPath);
-
-  try {
-    const asset = await api.uploadAsset(fileName, fileData, contentType);
-    if (!asset?.asset_id) {
-      debugError('relay', 'upload.failed', {
-        localPath,
-        fileName,
-        error: 'missing asset_id in upload response',
-      });
-      return null;
-    }
-    debugLog('relay', 'upload.ok', {
-      localPath,
-      fileName,
-      assetId: asset.asset_id,
-      contentType: asset.content_type || contentType,
-      sizeBytes: asset.size_bytes ?? null,
-    });
-    return asset;
-  } catch (err) {
-    debugError('relay', 'upload.failed', {
-      localPath,
-      fileName,
-      error: err.message,
-    });
-    return null;
-  }
-}
-
-export async function uploadMediaAssets(localPaths) {
-  const assets = [];
-  for (const p of localPaths) {
-    const asset = await uploadLocalAsset(p);
-    if (asset) assets.push(asset);
-  }
-  return assets;
-}
-
-export async function processAndSaveResult(result, opts) {
-  const { agentId: explicitAgentId, sessionKey, hostId, type, replyToMessageId, agent, sessionId, turnId, runtimeVersion } = opts;
-  const agentId = explicitAgentId || sessionKey;
-  const startedAt = Date.now();
-
-  // Collect media: from agent mediaUrls + parsed from text
-  const allLocalPaths = [...new Set([
-    ...(result.mediaUrls || []),
-    ...extractMediaPaths(result.text || ''),
-  ])];
-
-  debugLog('relay', 'process-result.begin', {
-    agentId,
-    type,
-    parentMessageId: replyToMessageId || null,
-    textLength: result.text?.length || 0,
-    localMediaCount: allLocalPaths.length,
-  });
-
-  // Upload local media to Ticlawk private chat assets.
-  const uploadedAssets = await uploadMediaAssets(allLocalPaths);
-  const uploadedAssetIds = uploadedAssets
-    .map((asset) => asset?.asset_id)
-    .filter(Boolean);
-
-  const updateId = randomUUID();
-  debugLog('relay', 'post-final.begin', {
-    agentId,
-    updateId,
-    durationMs: Date.now() - startedAt,
-    uploadedMediaCount: uploadedAssetIds.length,
-  });
-  try {
-    await api.postRuntimeResult({
-      agent,
-      agent_id: agentId,
-      runtime_host_id: hostId,
-      session_id: sessionId || null,
-      cwd: '',
-      runtime_version: runtimeVersion ?? null,
-      result_id: updateId,
-      turn_id: turnId || replyToMessageId || null,
-      reply_to_message_id: replyToMessageId || null,
-      origin_ts: new Date().toISOString(),
-      text: result.text || '',
-      media_asset_ids: uploadedAssetIds,
-      output_type: type || 'agent_message',
-    });
-  } catch (err) {
-    debugError('relay', 'post-final.failed', {
-      agentId,
-      updateId,
-      durationMs: Date.now() - startedAt,
-      error: err.message,
-    });
-    throw err;
-  }
-  debugLog('relay', 'process-result.ok', {
-    agentId,
-    updateId,
-    durationMs: Date.now() - startedAt,
-    uploadedMediaCount: uploadedAssetIds.length,
-  });
-  return { id: updateId, agentId };
-}

package/src/core/media/outbound.mjs

@@ -1,163 +0,0 @@
-import { extname } from 'node:path';
-import { homedir } from 'node:os';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-
-export const MIME_MAP = {
-  '.png': 'image/png',
-  '.jpg': 'image/jpeg',
-  '.jpeg': 'image/jpeg',
-  '.gif': 'image/gif',
-  '.webp': 'image/webp',
-  '.svg': 'image/svg+xml',
-  '.mp4': 'video/mp4',
-  '.webm': 'video/webm',
-  '.pdf': 'application/pdf',
-};
-
-function mediaExtensionPattern() {
-  return Object.keys(MIME_MAP).map((entry) => entry.replace('.', '\\.')).join('|');
-}
-
-function stripUrlSuffix(value) {
-  return String(value || '').replace(/[?#].*$/, '');
-}
-
-function trimCandidate(value) {
-  return String(value || '')
-    .trim()
-    .replace(/^<|>$/g, '')
-    .replace(/^["']|["']$/g, '')
-    .replace(/\\\//g, '/');
-}
-
-function hasKnownMediaExtension(value) {
-  return Boolean(MIME_MAP[extname(stripUrlSuffix(value)).toLowerCase()]);
-}
-
-function normalizeMediaPath(value) {
-  let candidate = trimCandidate(value);
-  if (!candidate) return null;
-
-  candidate = candidate.replace(/^about:/i, '');
-
-  if (/^file:/i.test(candidate)) {
-    try {
-      candidate = fileURLToPath(candidate);
-    } catch {
-      candidate = candidate.replace(/^file:(?:\/\/)?/i, '');
-    }
-  }
-
-  candidate = stripUrlSuffix(candidate);
-
-  if (candidate.startsWith('~')) {
-    candidate = candidate.replace(/^~/, homedir());
-  }
-
-  if (candidate.startsWith('/')) {
-    candidate = candidate.replace(/^\/{2,}/, '/');
-  }
-
-  if (!candidate.startsWith('/')) return null;
-  if (!hasKnownMediaExtension(candidate)) return null;
-  return candidate;
-}
-
-function addMediaCandidate(paths, value) {
-  const normalized = normalizeMediaPath(value);
-  if (normalized) paths.add(normalized);
-}
-
-export function extractMediaPaths(text) {
-  const extPattern = mediaExtensionPattern();
-  const paths = new Set();
-  const candidates = [];
-
-  const body = String(text || '');
-  for (const match of body.matchAll(/<img[^>]+src=["']([^"']+)["'][^>]*>/gi)) {
-    candidates.push({ index: match.index || 0, value: match[1] });
-  }
-  for (const match of body.matchAll(/!?\[[^\]]*\]\(\s*<([^>\n]+)>/gi)) {
-    candidates.push({ index: match.index || 0, value: match[1] });
-  }
-  for (const match of body.matchAll(/!?\[[^\]]*\]\(\s*([^\s)>]+)>?/gi)) {
-    candidates.push({ index: match.index || 0, value: match[1] });
-  }
-
-  const re = new RegExp(`((?:file:(?://)?|about:(?://)?)?(?:~|/{1,3})[^\\s"'<>)]*?(?:${extPattern})(?:[?#][^\\s"'<>)]*)?)`, 'gi');
-  for (const match of body.matchAll(re)) {
-    candidates.push({ index: match.index || 0, value: match[1] });
-  }
-
-  candidates
-    .sort((a, b) => a.index - b.index)
-    .forEach((candidate) => addMediaCandidate(paths, candidate.value));
-
-  return [...paths];
-}
-
-function escapeRegExp(value) {
-  return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function referencesPath(value, normalizedPaths) {
-  const normalized = normalizeMediaPath(value);
-  return Boolean(normalized && normalizedPaths.has(normalized));
-}
-
-function pathReferenceVariants(path) {
-  const normalized = normalizeMediaPath(path) || path;
-  const variants = new Set([normalized]);
-  if (normalized.startsWith('/')) {
-    variants.add(pathToFileURL(normalized).href);
-    variants.add(`about:${normalized}`);
-    variants.add(`about://${normalized}`);
-  }
-  return [...variants].sort((a, b) => b.length - a.length);
-}
-
-export function stripMediaPathReferences(text, explicitPaths = []) {
-  let next = String(text || '');
-  const paths = [...new Set([
-    ...explicitPaths,
-    ...extractMediaPaths(next),
-  ].map((path) => normalizeMediaPath(path)).filter(Boolean))];
-  const normalizedPaths = new Set(paths);
-
-  next = next
-    .replace(/<img[^>]+src=["']([^"']+)["'][^>]*>/gi, (match, src) => (
-      referencesPath(src, normalizedPaths) ? '' : match
-    ))
-    .replace(/!\[[^\]]*\]\(\s*<([^>\n]+)>(?:\s+["'][^"']*["'])?\s*\)/gi, (match, target) => (
-      referencesPath(target, normalizedPaths) ? '' : match
-    ))
-    .replace(/!\[[^\]]*\]\(\s*([^\s)>]+)>?(?:\s+["'][^"']*["'])?\s*\)/gi, (match, target) => (
-      referencesPath(target, normalizedPaths) ? '' : match
-    ));
-
-  for (const path of paths) {
-    for (const variant of pathReferenceVariants(path)) {
-      const escapedPath = escapeRegExp(variant);
-      next = next
-        .replace(new RegExp(`\\[media attached[^\\]]*${escapedPath}[^\\]]*\\]\\s*`, 'gi'), '')
-        .replace(new RegExp(`^\\s*${escapedPath}\\s*$`, 'gim'), '')
-        .replace(new RegExp(escapedPath, 'g'), '');
-    }
-  }
-
-  return next
-    .replace(/<img[^>]+src=["'](?:file:|about:)(?:\/){0,3}(?:tmp|private|var|Users|home)[^"']*["'][^>]*>/gi, '')
-    .replace(/!\[[^\]]*\]\(\s*<?(?:file:|about:)(?:\/){0,3}(?:tmp|private|var|Users|home)[^)]*\)/gi, '')
-    .replace(/\n{3,}/g, '\n\n')
-    .trim();
-}
-
-export function normalizeOutboundMedia(result) {
-  const explicit = Array.isArray(result?.mediaUrls) ? result.mediaUrls : [];
-  const inferred = extractMediaPaths(result?.text || '');
-  return [...new Set([...explicit, ...inferred])].map((path) => ({
-    kind: 'local_path',
-    value: path,
-    mime: MIME_MAP[extname(path).toLowerCase()] || 'application/octet-stream',
-  }));
-}