ticlawk 0.1.15-dev.6 → 0.1.16-dev.1

package/src/runtimes/opencode/index.mjs

@@ -9,6 +9,8 @@
 
 import { existsSync } from 'node:fs';
 import { basename } from 'node:path';
+import { buildAgentRuntimeEnv } from '../../core/runtime-env.mjs';
+import { buildStandingPrompt } from '../_shared/standing-prompt.mjs';
 import {
   createOpenCodeSession,
   getOpenCodeRuntimeHealth,
@@ -27,7 +29,7 @@ import {
   shouldStreamRuntime,
   createDeltaAggregator,
   sendAdapterMessage,
-  sendResult,
+  recordActivity,
   reportSubprocessFailure,
   terminalRuntimeFailure,
   updateBindingRuntimeMeta,
@@ -40,23 +42,27 @@ export const openCodeRuntime = {
     return createOpenCodeSession({ cwd, message: text, opencodePath });
   },
 
-  runTurn({ sessionId, cwd, opencodePath }, text, opts = {}) {
+  runTurn({ sessionId, cwd, opencodePath, agentEnv }, text, opts = {}) {
     return runOpenCodePrompt({
       sessionId,
       cwd,
       message: text,
       opencodePath,
+      agentEnv,
+      standingPrompt: opts.standingPrompt || null,
       files: opts.files,
       timeoutMs: opts.timeoutMs,
     });
   },
 
-  runTurnStream({ sessionId, cwd, opencodePath }, text, opts = {}) {
+  runTurnStream({ sessionId, cwd, opencodePath, agentEnv }, text, opts = {}) {
     return streamOpenCodePrompt({
       sessionId,
       cwd,
       message: text,
       opencodePath,
+      agentEnv,
+      standingPrompt: opts.standingPrompt || null,
       files: opts.files,
       timeoutMs: opts.timeoutMs,
       onEvent: opts.onEvent,
@@ -204,8 +210,15 @@ export const openCodeRuntime = {
     try {
       const opencodePath = requireOpenCodePath(runtimeOpenCodePath);
       const opencodeVersion = getOpenCodeRuntimeHealth(opencodePath).version || meta.opencodeVersion || null;
+      const agentEnv = buildAgentRuntimeEnv({
+        agentId: binding.id,
+        sessionId: meta.sessionId,
+        hostId: binding.runtime_host_id,
+      });
+      const standingPrompt = buildStandingPrompt({ agentId: binding.id });
       const result = shouldStreamRuntime(this.name, this)
-        ? await this.runTurnStream({ sessionId: shouldRotate ? null : meta.sessionId, cwd: meta.cwd, opencodePath }, message, {
+        ? await this.runTurnStream({ sessionId: shouldRotate ? null : meta.sessionId, cwd: meta.cwd, opencodePath, agentEnv }, message, {
+            standingPrompt,
             files,
             onEvent: async (event) => {
               if (event?.type === 'turn.started') {
@@ -230,7 +243,7 @@ export const openCodeRuntime = {
               }
             },
           })
-        : await this.runTurn({ sessionId: shouldRotate ? null : meta.sessionId, cwd: meta.cwd, opencodePath }, message, { files });
+        : await this.runTurn({ sessionId: shouldRotate ? null : meta.sessionId, cwd: meta.cwd, opencodePath, agentEnv }, message, { files, standingPrompt });
 
       await deltaAggregator.flush();
 
@@ -243,7 +256,7 @@ export const openCodeRuntime = {
         rotatePending: false,
         lastRotatedAt: shouldRotate ? new Date().toISOString() : meta.lastRotatedAt,
       }, { status: 'connected' });
-      await sendResult(adapter, nextBinding, inbound, {
+      await recordActivity(adapter, nextBinding, inbound, {
         ...result,
         media: normalizeOutboundMedia(result),
       });

package/src/runtimes/opencode/session.mjs

@@ -208,15 +208,24 @@ export function runOpenCodePrompt({
   message,
   files = [],
   opencodePath = null,
+  agentEnv = null,
+  standingPrompt = null,
   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
+    ? `${standingPrompt}\n\n---\n\n${message}`
+    : message;
   return new Promise((resolve, reject) => {
     const startedAt = Date.now();
     const opencodeCommand = requireOpenCodePath(opencodePath);
-    const child = spawn(opencodeCommand, buildOpenCodeRunArgs({ sessionId, message, files }), {
+    const child = spawn(opencodeCommand, buildOpenCodeRunArgs({ sessionId, message: finalMessage, files }), {
       cwd,
-      env: buildRuntimeEnv(),
+      env: buildRuntimeEnv(agentEnv || {}),
       stdio: ['ignore', 'pipe', 'ignore'],
     });
 

package/src/runtimes/pi/index.mjs

@@ -6,6 +6,8 @@
 
 import { existsSync } from 'node:fs';
 import { basename } from 'node:path';
+import { buildAgentRuntimeEnv } from '../../core/runtime-env.mjs';
+import { buildStandingPrompt } from '../_shared/standing-prompt.mjs';
 import {
   buildPiImagesFromInbound,
   discoverPiSessions,
@@ -21,7 +23,7 @@ import {
   shouldStreamRuntime,
   createDeltaAggregator,
   sendAdapterMessage,
-  sendResult,
+  recordActivity,
   reportSubprocessFailure,
   terminalRuntimeFailure,
   updateBindingRuntimeMeta,
@@ -30,24 +32,28 @@ import {
 export const piRuntime = {
   name: 'pi',
 
-  runTurn({ sessionId, cwd, piPath }, text, opts = {}) {
+  runTurn({ sessionId, cwd, piPath, agentEnv }, text, opts = {}) {
     return runPiPrompt({
       sessionId,
       cwd,
       message: text,
       images: opts.images,
       piPath,
+      agentEnv,
+      standingPrompt: opts.standingPrompt || null,
       timeoutMs: opts.timeoutMs,
     });
   },
 
-  runTurnStream({ sessionId, cwd, piPath }, text, opts = {}) {
+  runTurnStream({ sessionId, cwd, piPath, agentEnv }, text, opts = {}) {
     return runPiPrompt({
       sessionId,
       cwd,
       message: text,
       images: opts.images,
       piPath,
+      agentEnv,
+      standingPrompt: opts.standingPrompt || null,
       timeoutMs: opts.timeoutMs,
       onEvent: opts.onEvent,
     });
@@ -176,8 +182,15 @@ export const piRuntime = {
     try {
       const runtimePiPath = requirePiPath(meta.piPath || meta.runtimePath);
       const runtimePiVersion = getPiRuntimeHealth(runtimePiPath).version || meta.piVersion || null;
+      const agentEnv = buildAgentRuntimeEnv({
+        agentId: binding.id,
+        sessionId: meta.sessionId,
+        hostId: binding.runtime_host_id,
+      });
+      const standingPrompt = buildStandingPrompt({ agentId: binding.id });
       const result = shouldStreamRuntime(this.name, this)
-        ? await this.runTurnStream({ sessionId: shouldRotate ? null : meta.sessionId, cwd: meta.cwd, piPath: runtimePiPath }, message, {
+        ? await this.runTurnStream({ sessionId: shouldRotate ? null : meta.sessionId, cwd: meta.cwd, piPath: runtimePiPath, agentEnv }, message, {
+            standingPrompt,
             images,
             onEvent: async (event) => {
               if (event?.type === 'turn.started') {
@@ -202,7 +215,7 @@ export const piRuntime = {
               }
             },
           })
-        : await this.runTurn({ sessionId: shouldRotate ? null : meta.sessionId, cwd: meta.cwd, piPath: runtimePiPath }, message, { images });
+        : await this.runTurn({ sessionId: shouldRotate ? null : meta.sessionId, cwd: meta.cwd, piPath: runtimePiPath, agentEnv }, message, { images, standingPrompt });
 
       await deltaAggregator.flush();
       const nextBinding = await updateBindingRuntimeMeta(ctx, binding, {
@@ -215,7 +228,7 @@ export const piRuntime = {
         rotatePending: false,
         lastRotatedAt: shouldRotate ? new Date().toISOString() : meta.lastRotatedAt,
       }, { status: 'connected' });
-      await sendResult(adapter, nextBinding, inbound, result);
+      await recordActivity(adapter, nextBinding, inbound, result);
       await emitWorkerEvent({
         adapter,
         binding: nextBinding,

package/src/runtimes/pi/session.mjs

@@ -195,15 +195,21 @@ export function runPiPrompt({
   message,
   images = [],
   piPath = null,
+  agentEnv = null,
+  standingPrompt = null,
   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
+    ? `${standingPrompt}\n\n---\n\n${message}`
+    : message;
   return new Promise((resolve, reject) => {
     const startedAt = Date.now();
     const piCommand = requirePiPath(piPath);
     const child = spawn(piCommand, buildPiRpcArgs({ sessionId }), {
       cwd,
-      env: buildRuntimeEnv(),
+      env: buildRuntimeEnv(agentEnv || {}),
       stdio: ['pipe', 'pipe', 'pipe'],
     });
 
@@ -349,7 +355,7 @@ export function runPiPrompt({
 
     (async () => {
       try {
-        await send({ type: 'prompt', message, images });
+        await send({ type: 'prompt', message: finalMessage, images });
         await completion;
         const state = await send({ type: 'get_state' }).catch(() => null);
         const lastAssistant = await send({ type: 'get_last_assistant_text' }).catch(() => null);

package/ticlawk.mjs

@@ -17,7 +17,6 @@ import {
   AF_CONFIG_PATH,
   AF_LOG_PATH,
   AF_CRASH_LOG_PATH,
-  getConfiguredAdapter,
   loadPersistentConfig,
   persistConfig,
 } from './src/core/config.mjs';
@@ -225,7 +224,6 @@ export async function startTiclawk() {
 
   const { runtimeList, runtimes } = await buildRuntimeContext();
   const resolveRuntimeBinding = createResolveRuntimeBinding(runtimes);
-  const configuredAdapter = getConfiguredAdapter();
   let adapter;
   const cacheBinding = createCacheBinding(runtimes, () => adapter);
   let baseRuntimeCtx;
@@ -237,7 +235,7 @@ export async function startTiclawk() {
   };
   baseRuntimeCtx = createBaseRuntimeCtx(runtimes, cacheBinding, (binding) => syncBinding(binding));
   adapter = createAdapter(
-    configuredAdapter,
+    'ticlawk',
     createAdapterContext(baseRuntimeCtx, resolveRuntimeBinding)
   );
   syncBinding = createUpsertBindingWithSync(runtimes, adapter);
@@ -249,7 +247,11 @@ export async function startTiclawk() {
   }
   registerRuntimeHandlers(runtimeList, baseRuntimeCtx, adapter);
   await replayBindings(runtimes, adapter);
-  startLocalHttpServer({ port: HTTP_PORT, adapter });
+  startLocalHttpServer({
+    port: HTTP_PORT,
+    adapter,
+    ctx: { listBindings, getBinding },
+  });
   await recoverAllRuntimes(runtimeList, adapter);
   await reconcileBindingsAfterRestart(runtimes, adapter);
   await adapter.start();

package/assets/ticlawk-concept.svg

@@ -1,137 +0,0 @@
-<svg width="960" height="520" viewBox="0 0 960 520" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
-  <title id="title">ticlawk connects any client to any agent</title>
-  <desc id="desc">A hub-and-spoke diagram with clients on the left, ticlawk in the center, and agent runtimes on the right.</desc>
-
-  <defs>
-    <linearGradient id="hub" x1="372" y1="162" x2="588" y2="378" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#1D4ED8"/>
-      <stop offset="0.52" stop-color="#0F766E"/>
-      <stop offset="1" stop-color="#7C2D12"/>
-    </linearGradient>
-    <linearGradient id="clientLine" x1="180" y1="72" x2="460" y2="260" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#2563EB"/>
-      <stop offset="1" stop-color="#0F766E"/>
-    </linearGradient>
-    <linearGradient id="agentLine" x1="500" y1="260" x2="780" y2="448" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#0F766E"/>
-      <stop offset="1" stop-color="#C2410C"/>
-    </linearGradient>
-    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%" color-interpolation-filters="sRGB">
-      <feDropShadow dx="0" dy="10" stdDeviation="16" flood-color="#0F172A" flood-opacity="0.12"/>
-    </filter>
-    <style>
-      .label { fill: #0f172a; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; font-weight: 700; font-size: 16px; }
-      .small { fill: #475569; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; font-weight: 600; font-size: 13px; }
-      .hubText { fill: white; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; font-weight: 800; font-size: 27px; }
-      .hubSub { fill: #E0F2FE; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; font-weight: 650; font-size: 13px; letter-spacing: 0.08em; }
-      .caption { fill: #334155; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; font-weight: 650; font-size: 14px; }
-      .node { fill: #FFFFFF; stroke: #CBD5E1; stroke-width: 1.4; }
-      .dot { fill: #F8FAFC; stroke: #CBD5E1; stroke-width: 1.4; }
-    </style>
-  </defs>
-
-  <rect width="960" height="520" rx="22" fill="#F8FAFC"/>
-  <rect x="24" y="24" width="912" height="472" rx="18" fill="#FFFFFF" stroke="#E2E8F0"/>
-
-  <text x="180" y="64" text-anchor="middle" class="caption">Any client surface</text>
-  <text x="780" y="64" text-anchor="middle" class="caption">Any agent runtime</text>
-
-  <path d="M230 116 C310 126 350 166 405 215" stroke="url(#clientLine)" stroke-width="4" stroke-linecap="round"/>
-  <path d="M230 188 C310 192 354 216 405 244" stroke="url(#clientLine)" stroke-width="4" stroke-linecap="round"/>
-  <path d="M230 260 C306 260 348 260 405 260" stroke="url(#clientLine)" stroke-width="4" stroke-linecap="round"/>
-  <path d="M230 332 C310 328 354 304 405 276" stroke="url(#clientLine)" stroke-width="4" stroke-linecap="round"/>
-  <path d="M230 404 C310 394 350 354 405 305" stroke="url(#clientLine)" stroke-width="4" stroke-linecap="round"/>
-
-  <path d="M555 215 C610 166 650 126 730 116" stroke="url(#agentLine)" stroke-width="4" stroke-linecap="round"/>
-  <path d="M555 244 C606 216 650 192 730 188" stroke="url(#agentLine)" stroke-width="4" stroke-linecap="round"/>
-  <path d="M555 260 C612 260 654 260 730 260" stroke="url(#agentLine)" stroke-width="4" stroke-linecap="round"/>
-  <path d="M555 276 C606 304 650 328 730 332" stroke="url(#agentLine)" stroke-width="4" stroke-linecap="round"/>
-  <path d="M555 305 C610 354 650 394 730 404" stroke="url(#agentLine)" stroke-width="4" stroke-linecap="round"/>
-
-  <g filter="url(#shadow)">
-    <rect x="70" y="88" width="160" height="56" rx="8" class="node"/>
-    <circle cx="100" cy="116" r="14" fill="#DBEAFE"/>
-    <path d="M94 116h12M100 110v12" stroke="#2563EB" stroke-width="2.4" stroke-linecap="round"/>
-    <text x="124" y="112" class="label">Telegram</text>
-    <text x="124" y="130" class="small">chat bot</text>
-
-    <rect x="70" y="160" width="160" height="56" rx="8" class="node"/>
-    <circle cx="100" cy="188" r="14" fill="#CCFBF1"/>
-    <rect x="94" y="180" width="12" height="16" rx="3" stroke="#0F766E" stroke-width="2.2"/>
-    <path d="M98 202h4" stroke="#0F766E" stroke-width="2.2" stroke-linecap="round"/>
-    <text x="124" y="184" class="label">ticlawk</text>
-    <text x="124" y="202" class="small">mobile app</text>
-
-    <rect x="70" y="232" width="160" height="56" rx="8" class="node"/>
-    <circle cx="100" cy="260" r="14" fill="#FDE68A"/>
-    <path d="M92 256h16M92 262h16M100 252v16" stroke="#A16207" stroke-width="2" stroke-linecap="round"/>
-    <text x="124" y="256" class="label">Web UI</text>
-    <text x="124" y="274" class="small">browser</text>
-
-    <rect x="70" y="304" width="160" height="56" rx="8" class="node"/>
-    <circle cx="100" cy="332" r="14" fill="#EDE9FE"/>
-    <path d="M94 326l6 6-6 6M102 338h6" stroke="#6D28D9" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"/>
-    <text x="124" y="328" class="label">CLI</text>
-    <text x="124" y="346" class="small">terminal</text>
-
-    <rect x="70" y="376" width="160" height="56" rx="8" class="node"/>
-    <circle cx="100" cy="404" r="14" fill="#FFE4E6"/>
-    <path d="M94 398h12v12H94z" stroke="#BE123C" stroke-width="2.2" stroke-linejoin="round"/>
-    <path d="M97 395h6M97 413h6" stroke="#BE123C" stroke-width="2.2" stroke-linecap="round"/>
-    <text x="124" y="400" class="label">Custom app</text>
-    <text x="124" y="418" class="small">your surface</text>
-  </g>
-
-  <g filter="url(#shadow)">
-    <rect x="730" y="88" width="160" height="56" rx="8" class="node"/>
-    <circle cx="760" cy="116" r="14" fill="#FEF3C7"/>
-    <path d="M753 121l7-12 7 12M756 117h8" stroke="#B45309" stroke-width="2.2" stroke-linecap="round" stroke-linejoin="round"/>
-    <text x="784" y="112" class="label">Claude Code</text>
-    <text x="784" y="130" class="small">project agent</text>
-
-    <rect x="730" y="160" width="160" height="56" rx="8" class="node"/>
-    <circle cx="760" cy="188" r="14" fill="#DBEAFE"/>
-    <path d="M754 188a6 6 0 1 1 12 0a6 6 0 1 1-12 0" stroke="#1D4ED8" stroke-width="2.2"/>
-    <path d="M760 176v4M760 196v4M748 188h4M768 188h4" stroke="#1D4ED8" stroke-width="2.2" stroke-linecap="round"/>
-    <text x="784" y="184" class="label">Codex</text>
-    <text x="784" y="202" class="small">coding agent</text>
-
-    <rect x="730" y="232" width="160" height="56" rx="8" class="node"/>
-    <circle cx="760" cy="260" r="14" fill="#CCFBF1"/>
-    <path d="M752 260h16M760 252v16M755 255l10 10M765 255l-10 10" stroke="#0F766E" stroke-width="2" stroke-linecap="round"/>
-    <text x="784" y="256" class="label">OpenClaw</text>
-    <text x="784" y="274" class="small">local runtime</text>
-
-    <rect x="730" y="304" width="160" height="56" rx="8" class="node"/>
-    <circle cx="760" cy="332" r="14" fill="#FCE7F3"/>
-    <path d="M752 332c3-8 13-8 16 0c-3 8-13 8-16 0Z" stroke="#BE185D" stroke-width="2.2"/>
-    <circle cx="760" cy="332" r="3" fill="#BE185D"/>
-    <text x="784" y="328" class="label">opencode</text>
-    <text x="784" y="346" class="small">provider agnostic</text>
-
-    <rect x="730" y="376" width="160" height="56" rx="8" class="node"/>
-    <circle cx="760" cy="404" r="14" fill="#E0E7FF"/>
-    <path d="M754 398h12v12h-12zM751 401h3M766 401h3M751 407h3M766 407h3" stroke="#4338CA" stroke-width="2" stroke-linejoin="round"/>
-    <text x="784" y="400" class="label">Custom agent</text>
-    <text x="784" y="418" class="small">your harness</text>
-  </g>
-
-  <g filter="url(#shadow)">
-    <circle cx="480" cy="260" r="118" fill="url(#hub)"/>
-    <circle cx="480" cy="260" r="86" fill="#FFFFFF" fill-opacity="0.12" stroke="#FFFFFF" stroke-opacity="0.32" stroke-width="1.5"/>
-    <circle cx="480" cy="260" r="52" fill="#FFFFFF" fill-opacity="0.16" stroke="#FFFFFF" stroke-opacity="0.38" stroke-width="1.4"/>
-
-    <circle cx="480" cy="176" r="8" class="dot"/>
-    <circle cx="548" cy="212" r="8" class="dot"/>
-    <circle cx="548" cy="308" r="8" class="dot"/>
-    <circle cx="480" cy="344" r="8" class="dot"/>
-    <circle cx="412" cy="308" r="8" class="dot"/>
-    <circle cx="412" cy="212" r="8" class="dot"/>
-    <path d="M480 184v152M420 216l120 88M540 216l-120 88" stroke="#FFFFFF" stroke-opacity="0.65" stroke-width="2.6" stroke-linecap="round"/>
-
-    <text x="480" y="253" text-anchor="middle" class="hubText">ticlawk</text>
-    <text x="480" y="281" text-anchor="middle" class="hubSub">UNIVERSAL ROUTER</text>
-  </g>
-
-  <text x="480" y="465" text-anchor="middle" class="small">Bind sessions, relay streams, keep every side replaceable.</text>
-</svg>