ticlawk 0.1.16-dev.2 → 0.1.16-dev.21

package/src/runtimes/opencode/index.mjs

@@ -10,6 +10,7 @@
 import { existsSync } from 'node:fs';
 import { basename } from 'node:path';
 import { buildAgentRuntimeEnv } from '../../core/runtime-env.mjs';
+import { getGoalTaskProtocolOverlayKey } from '../_shared/goal-task-protocol.mjs';
 import { buildStandingPrompt } from '../_shared/standing-prompt.mjs';
 import { ensureAgentHome } from '../../core/agent-home.mjs';
 import {
@@ -24,18 +25,19 @@ 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,
+  resolveRuntimeSessionScope,
+  buildRuntimeSessionMetaPatch,
 } from '../../core/runtime-support.mjs';
 
+const standingPromptSeen = new Set();
+
 export const openCodeRuntime = {
   name: 'opencode',
 
@@ -51,6 +53,7 @@ export const openCodeRuntime = {
       opencodePath,
       agentEnv,
       standingPrompt: opts.standingPrompt || null,
+      forceStandingPrompt: Boolean(opts.forceStandingPrompt),
       files: opts.files,
       timeoutMs: opts.timeoutMs,
     });
@@ -64,6 +67,7 @@ export const openCodeRuntime = {
       opencodePath,
       agentEnv,
       standingPrompt: opts.standingPrompt || null,
+      forceStandingPrompt: Boolean(opts.forceStandingPrompt),
       files: opts.files,
       timeoutMs: opts.timeoutMs,
       onEvent: opts.onEvent,
@@ -146,30 +150,22 @@ 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.
       message = captionText || 'Please analyze the attached image(s).';
     }
-    const shouldRotate = !meta.sessionId || meta.rotatePending;
+    const sessionScope = resolveRuntimeSessionScope(meta, inbound);
+    const shouldRotate = sessionScope.shouldRotate;
+    const targetSessionId = shouldRotate ? null : sessionScope.sessionId;
 
     const deltaAggregator = createDeltaAggregator({
       flushDelta: async ({ text, sessionId, cwd }) => {
@@ -177,7 +173,7 @@ export const openCodeRuntime = {
           adapter,
           binding,
           agent: this.name,
-          sessionId: sessionId || meta.sessionId || binding.id,
+          sessionId: sessionId || targetSessionId || binding.id,
           cwd: cwd || agentHome,
           replyToMessageId: inbound.messageId || null,
           event: {
@@ -195,13 +191,22 @@ export const openCodeRuntime = {
       const opencodeVersion = getOpenCodeRuntimeHealth(opencodePath).version || meta.opencodeVersion || null;
       const agentEnv = buildAgentRuntimeEnv({
         agentId: binding.id,
-        sessionId: meta.sessionId,
+        sessionId: targetSessionId,
         hostId: binding.runtime_host_id,
+        conversationId: inbound.conversationId,
+        messageId: inbound.messageId,
+        target: inbound.envelopeTarget,
       });
-      const standingPrompt = buildStandingPrompt({ agentId: binding.id });
+      const standingPrompt = buildStandingPrompt({ agentId: binding.id, inbound });
+      const protocolOverlayKey = getGoalTaskProtocolOverlayKey({ agentId: binding.id, inbound });
+      const standingPromptSeenKey = targetSessionId
+        ? `${binding.id}|${targetSessionId}|${protocolOverlayKey}`
+        : null;
+      const forceStandingPrompt = Boolean(standingPromptSeenKey && !standingPromptSeen.has(standingPromptSeenKey));
       const result = shouldStreamRuntime(this.name, this)
-        ? await this.runTurnStream({ sessionId: shouldRotate ? null : meta.sessionId, cwd: agentHome, opencodePath, agentEnv }, message, {
+        ? await this.runTurnStream({ sessionId: targetSessionId, cwd: agentHome, opencodePath, agentEnv }, message, {
             standingPrompt,
+            forceStandingPrompt,
             files,
             onEvent: async (event) => {
               if (event?.type === 'turn.started') {
@@ -209,7 +214,7 @@ export const openCodeRuntime = {
                   adapter,
                   binding,
                   agent: this.name,
-                  sessionId: event.sessionId || meta.sessionId || binding.id,
+                  sessionId: event.sessionId || targetSessionId || binding.id,
                   cwd: agentHome,
                   replyToMessageId: inbound.messageId || null,
                   event: {
@@ -220,33 +225,34 @@ export const openCodeRuntime = {
                 });
               } else if (event?.type === 'message.delta' && event.text) {
                 deltaAggregator.push(event.text, {
-                  sessionId: event.sessionId || meta.sessionId || binding.id,
+                  sessionId: event.sessionId || targetSessionId || binding.id,
                   cwd: agentHome,
                 });
               }
             },
           })
-        : await this.runTurn({ sessionId: shouldRotate ? null : meta.sessionId, cwd: agentHome, opencodePath, agentEnv }, message, { files, standingPrompt });
+        : await this.runTurn({ sessionId: targetSessionId, cwd: agentHome, opencodePath, agentEnv }, message, { files, standingPrompt, forceStandingPrompt });
 
       await deltaAggregator.flush();
+      const observedSessionId = result?.sessionId || targetSessionId;
+      if (observedSessionId) {
+        standingPromptSeen.add(`${binding.id}|${observedSessionId}|${protocolOverlayKey}`);
+      }
 
       const nextBinding = await updateBindingRuntimeMeta(ctx, binding, {
-        sessionId: result?.sessionId || meta.sessionId,
+        ...buildRuntimeSessionMetaPatch(meta, sessionScope, {
+          sessionId: result?.sessionId,
+          path: result?.path,
+        }),
         runtimePath: opencodePath,
         opencodePath,
         opencodeVersion,
-        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,
         agent: this.name,
-        sessionId: result?.sessionId || meta.sessionId || binding.id,
+        sessionId: result?.sessionId || targetSessionId || binding.id,
         cwd: result?.cwd || agentHome,
         replyToMessageId: inbound.messageId || null,
         event: {
@@ -262,7 +268,7 @@ export const openCodeRuntime = {
         adapter,
         binding,
         agent: this.name,
-        sessionId: meta.sessionId || binding.id,
+        sessionId: targetSessionId || binding.id,
         cwd: agentHome,
         replyToMessageId: inbound.messageId || null,
         event: {

package/src/runtimes/opencode/session.mjs

@@ -210,14 +210,15 @@ export function runOpenCodePrompt({
   opencodePath = null,
   agentEnv = null,
   standingPrompt = null,
+  forceStandingPrompt = false,
   timeoutMs = Number(process.env.OPENCODE_RUN_TIMEOUT_MS || DEFAULT_OPENCODE_RUN_TIMEOUT_MS),
   onEvent,
 }) {
   // opencode has no documented `--system` flag, so we prepend the
-  // standing prompt to the first-turn message body. Resumed sessions
-  // (sessionId set) skip injection because the model already saw it
-  // on the originating turn.
-  const finalMessage = standingPrompt && !sessionId
+  // standing prompt to the first-turn message body. Callers may force a
+  // resumed-session injection when the selected protocol overlay changes
+  // or this daemon process has not yet observed the session.
+  const finalMessage = standingPrompt && (!sessionId || forceStandingPrompt)
     ? `${standingPrompt}\n\n---\n\n${message}`
     : message;
   return new Promise((resolve, reject) => {

package/src/runtimes/pi/index.mjs

@@ -6,6 +6,7 @@
 
 import { basename } from 'node:path';
 import { buildAgentRuntimeEnv } from '../../core/runtime-env.mjs';
+import { getGoalTaskProtocolOverlayKey } from '../_shared/goal-task-protocol.mjs';
 import { buildStandingPrompt } from '../_shared/standing-prompt.mjs';
 import { ensureAgentHome } from '../../core/agent-home.mjs';
 import {
@@ -22,13 +23,15 @@ import { emitWorkerEvent } from '../../core/events/worker-events.mjs';
 import {
   shouldStreamRuntime,
   createDeltaAggregator,
-  sendAdapterMessage,
-  recordActivity,
   reportSubprocessFailure,
   terminalRuntimeFailure,
   updateBindingRuntimeMeta,
+  resolveRuntimeSessionScope,
+  buildRuntimeSessionMetaPatch,
 } from '../../core/runtime-support.mjs';
 
+const standingPromptSeen = new Set();
+
 export const piRuntime = {
   name: 'pi',
 
@@ -41,6 +44,7 @@ export const piRuntime = {
       piPath,
       agentEnv,
       standingPrompt: opts.standingPrompt || null,
+      forceStandingPrompt: Boolean(opts.forceStandingPrompt),
       timeoutMs: opts.timeoutMs,
     });
   },
@@ -54,6 +58,7 @@ export const piRuntime = {
       piPath,
       agentEnv,
       standingPrompt: opts.standingPrompt || null,
+      forceStandingPrompt: Boolean(opts.forceStandingPrompt),
       timeoutMs: opts.timeoutMs,
       onEvent: opts.onEvent,
     });
@@ -122,33 +127,24 @@ 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).';
     }
 
-    const shouldRotate = !meta.sessionId || meta.rotatePending;
+    const sessionScope = resolveRuntimeSessionScope(meta, inbound);
+    const shouldRotate = sessionScope.shouldRotate;
+    const targetSessionId = shouldRotate ? null : sessionScope.sessionId;
     const deltaAggregator = createDeltaAggregator({
       flushDelta: async ({ text, sessionId, cwd }) => {
         await emitWorkerEvent({
           adapter,
           binding,
           agent: this.name,
-          sessionId: sessionId || meta.sessionId || binding.id,
+          sessionId: sessionId || targetSessionId || binding.id,
           cwd: cwd || agentHome,
           replyToMessageId: inbound.messageId || null,
           event: {
@@ -166,13 +162,22 @@ export const piRuntime = {
       const runtimePiVersion = getPiRuntimeHealth(runtimePiPath).version || meta.piVersion || null;
       const agentEnv = buildAgentRuntimeEnv({
         agentId: binding.id,
-        sessionId: meta.sessionId,
+        sessionId: targetSessionId,
         hostId: binding.runtime_host_id,
+        conversationId: inbound.conversationId,
+        messageId: inbound.messageId,
+        target: inbound.envelopeTarget,
       });
-      const standingPrompt = buildStandingPrompt({ agentId: binding.id });
+      const standingPrompt = buildStandingPrompt({ agentId: binding.id, inbound });
+      const protocolOverlayKey = getGoalTaskProtocolOverlayKey({ agentId: binding.id, inbound });
+      const standingPromptSeenKey = targetSessionId
+        ? `${binding.id}|${targetSessionId}|${protocolOverlayKey}`
+        : null;
+      const forceStandingPrompt = Boolean(standingPromptSeenKey && !standingPromptSeen.has(standingPromptSeenKey));
       const result = shouldStreamRuntime(this.name, this)
-        ? await this.runTurnStream({ sessionId: shouldRotate ? null : meta.sessionId, cwd: agentHome, piPath: runtimePiPath, agentEnv }, message, {
+        ? await this.runTurnStream({ sessionId: targetSessionId, cwd: agentHome, piPath: runtimePiPath, agentEnv }, message, {
             standingPrompt,
+            forceStandingPrompt,
             images,
             onEvent: async (event) => {
               if (event?.type === 'turn.started') {
@@ -180,7 +185,7 @@ export const piRuntime = {
                   adapter,
                   binding,
                   agent: this.name,
-                  sessionId: event.sessionId || meta.sessionId || binding.id,
+                  sessionId: event.sessionId || targetSessionId || binding.id,
                   cwd: agentHome,
                   replyToMessageId: inbound.messageId || null,
                   event: {
@@ -191,30 +196,33 @@ export const piRuntime = {
                 });
               } else if (event?.type === 'message.delta' && event.text) {
                 deltaAggregator.push(event.text, {
-                  sessionId: event.sessionId || meta.sessionId || binding.id,
+                  sessionId: event.sessionId || targetSessionId || binding.id,
                   cwd: agentHome,
                 });
               }
             },
           })
-        : await this.runTurn({ sessionId: shouldRotate ? null : meta.sessionId, cwd: agentHome, piPath: runtimePiPath, agentEnv }, message, { images, standingPrompt });
+        : await this.runTurn({ sessionId: targetSessionId, cwd: agentHome, piPath: runtimePiPath, agentEnv }, message, { images, standingPrompt, forceStandingPrompt });
 
       await deltaAggregator.flush();
+      const observedSessionId = result?.sessionId || targetSessionId;
+      if (observedSessionId) {
+        standingPromptSeen.add(`${binding.id}|${observedSessionId}|${protocolOverlayKey}`);
+      }
       const nextBinding = await updateBindingRuntimeMeta(ctx, binding, {
-        sessionId: result?.sessionId || meta.sessionId,
-        path: result?.path || meta.path || null,
+        ...buildRuntimeSessionMetaPatch(meta, sessionScope, {
+          sessionId: result?.sessionId,
+          path: result?.path,
+        }),
         runtimePath: runtimePiPath,
         piPath: runtimePiPath,
         piVersion: runtimePiVersion,
-        rotatePending: false,
-        lastRotatedAt: shouldRotate ? new Date().toISOString() : meta.lastRotatedAt,
       }, { status: 'connected' });
-      await recordActivity(adapter, nextBinding, inbound, result);
       await emitWorkerEvent({
         adapter,
         binding: nextBinding,
         agent: this.name,
-        sessionId: result?.sessionId || meta.sessionId || binding.id,
+        sessionId: result?.sessionId || targetSessionId || binding.id,
         cwd: result?.cwd || agentHome,
         replyToMessageId: inbound.messageId || null,
         event: {
@@ -230,7 +238,7 @@ export const piRuntime = {
         adapter,
         binding,
         agent: this.name,
-        sessionId: meta.sessionId || binding.id,
+        sessionId: targetSessionId || binding.id,
         cwd: agentHome,
         replyToMessageId: inbound.messageId || null,
         event: {

package/src/runtimes/pi/session.mjs

@@ -197,11 +197,14 @@ export function runPiPrompt({
   piPath = null,
   agentEnv = null,
   standingPrompt = null,
+  forceStandingPrompt = false,
   timeoutMs = Number(process.env.PI_RUN_TIMEOUT_MS || DEFAULT_PI_RUN_TIMEOUT_MS),
   onEvent,
 }) {
-  // pi has no documented system-prompt flag — prepend on first turn.
-  const finalMessage = standingPrompt && !sessionId
+  // pi has no documented system-prompt flag. Prepend on first turn, and
+  // let callers force one resumed-session injection for a newly selected
+  // protocol overlay.
+  const finalMessage = standingPrompt && (!sessionId || forceStandingPrompt)
     ? `${standingPrompt}\n\n---\n\n${message}`
     : message;
   return new Promise((resolve, reject) => {

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 };
-}