@mrc2204/opencode-bridge 0.1.1

package/README.en.md

@@ -0,0 +1,115 @@
+# @mrc2204/opencode-bridge
+
+OpenClaw ↔ OpenCode bridge plugin for multi-agent orchestration, callback routing, SSE probing, run observability, and runtime serve management.
+
+## Goals
+- Standardize callback flow from OpenCode back into OpenClaw via `/hooks/agent`
+- Standardize `sessionKey` and routing envelope
+- Support **1 project = 1 OpenCode serve instance**
+- Provide runtime-ops baseline for:
+  - SSE probe / event normalization
+  - run status / run events / session tail
+  - serve registry / spawn / reuse / shutdown / idle evaluation
+
+## Install from npm
+```bash
+openclaw plugins install @mrc2204/openclaw-opencode-bridge
+```
+
+## Repository structure (build-based)
+```text
+openclaw-opencode-bridge/
+├── openclaw.plugin.json
+├── package.json
+├── tsconfig.json
+├── src/
+│   ├── index.ts
+│   ├── observability.ts
+│   └── types.ts
+├── dist/                  # generated by npm run build
+├── test/
+│   ├── run-tests.ts
+│   └── observability.test.ts
+├── skills/
+│   └── opencode-orchestration/
+│       └── SKILL.md
+├── README.md
+└── README.en.md
+```
+
+## Available tools
+- `opencode_status`
+- `opencode_resolve_project`
+- `opencode_build_envelope`
+- `opencode_check_hook_policy`
+- `opencode_evaluate_lifecycle`
+- `opencode_run_status`
+- `opencode_run_events`
+- `opencode_session_tail`
+- `opencode_serve_spawn`
+- `opencode_registry_get`
+- `opencode_registry_upsert`
+- `opencode_registry_cleanup`
+- `opencode_serve_shutdown`
+- `opencode_serve_idle_check`
+
+## Current assumptions
+- `1 project = 1 opencode serve instance`
+- callback primary = `/hooks/agent`
+- `sessionKey` convention = `hook:opencode:<agentId>:<taskId>`
+- `opencode_server_url` is required in practical routing envelopes
+
+## Build & test
+```bash
+npm install
+npm run build
+npm run typecheck
+npm run test
+```
+
+After `npm run build`, runtime entrypoints point to built artifacts in `dist/`:
+- `main`: `./dist/index.js`
+- `types`: `./dist/index.d.ts`
+- `openclaw.extensions`: `./dist/index.js`
+
+## Publish flow (safe)
+```bash
+npm run build
+npm run test
+npm pack --dry-run
+# if all good:
+# npm publish
+```
+
+Use `npm pack --dry-run` to confirm package contents are build artifacts (`dist/`, `skills/`, readmes, plugin manifest), not raw TypeScript entrypoints.
+
+## Runtime config
+Plugin-owned config path:
+```text
+~/.openclaw/opencode-bridge/config.json
+```
+
+Example:
+```json
+{
+  "opencodeServerUrl": "http://127.0.0.1:4096",
+  "hookBaseUrl": "http://127.0.0.1:18789",
+  "hookToken": "<OPENCLAW_HOOK_TOKEN>",
+  "projectRegistry": [
+    {
+      "projectId": "agent-smart-memo",
+      "repoRoot": "/Users/me/Work/projects/agent-smart-memo",
+      "serverUrl": "http://127.0.0.1:4096",
+      "idleTimeoutMs": 900000
+    }
+  ]
+}
+```
+
+## Local development install
+```bash
+openclaw plugins install -l ~/Work/projects/opencode-bridge
+```
+
+## License
+MIT

package/README.md

@@ -0,0 +1,117 @@
+# @mrc2204/opencode-bridge
+
+> English README: [README.en.md](./README.en.md)
+
+Plugin bridge giữa **OpenClaw** và **OpenCode** cho orchestration multi-agent, callback routing, SSE probing, run observability và serve runtime management.
+
+## Mục tiêu
+- Chuẩn hóa callback path từ OpenCode về OpenClaw qua `/hooks/agent`
+- Chuẩn hóa `sessionKey` / `routing envelope`
+- Hỗ trợ mô hình vận hành: **1 project = 1 OpenCode serve instance**
+- Cung cấp runtime-ops baseline:
+  - SSE probe / event normalize
+  - run status / run events / session tail
+  - serve registry / spawn / reuse / shutdown / idle evaluation
+
+## Cài package từ npm
+```bash
+openclaw plugins install @mrc2204/openclaw-opencode-bridge
+```
+
+## Cấu trúc repo (build-based)
+```text
+openclaw-opencode-bridge/
+├── openclaw.plugin.json
+├── package.json
+├── tsconfig.json
+├── src/
+│   ├── index.ts
+│   ├── observability.ts
+│   └── types.ts
+├── dist/                  # artifact tạo bởi npm run build
+├── test/
+│   ├── run-tests.ts
+│   └── observability.test.ts
+├── skills/
+│   └── opencode-orchestration/
+│       └── SKILL.md
+├── README.md
+└── README.en.md
+```
+
+## Tool hiện có
+- `opencode_status`
+- `opencode_resolve_project`
+- `opencode_build_envelope`
+- `opencode_check_hook_policy`
+- `opencode_evaluate_lifecycle`
+- `opencode_run_status`
+- `opencode_run_events`
+- `opencode_session_tail`
+- `opencode_serve_spawn`
+- `opencode_registry_get`
+- `opencode_registry_upsert`
+- `opencode_registry_cleanup`
+- `opencode_serve_shutdown`
+- `opencode_serve_idle_check`
+
+## Assumptions hiện tại
+- `1 project = 1 opencode serve instance`
+- callback primary = `/hooks/agent`
+- `sessionKey` convention = `hook:opencode:<agentId>:<taskId>`
+- `opencode_server_url` là field bắt buộc trong envelope routing thực tế
+
+## Build/Test
+```bash
+npm install
+npm run build
+npm run typecheck
+npm run test
+```
+
+Sau `npm run build`, entrypoint runtime dùng artifact trong `dist/`:
+- `main`: `./dist/index.js`
+- `types`: `./dist/index.d.ts`
+- `openclaw.extensions`: `./dist/index.js`
+
+## Publish flow (safe)
+```bash
+npm run build
+npm run test
+npm pack --dry-run
+# nếu OK:
+# npm publish
+```
+
+`npm pack --dry-run` dùng để kiểm tra package chỉ publish artifact cần thiết (`dist/`, `skills/`, readme, plugin manifest), không trỏ trực tiếp vào source TypeScript.
+
+## Config runtime
+Plugin dùng plugin-owned config tại:
+```text
+~/.openclaw/opencode-bridge/config.json
+```
+
+Ví dụ:
+```json
+{
+  "opencodeServerUrl": "http://127.0.0.1:4096",
+  "hookBaseUrl": "http://127.0.0.1:18789",
+  "hookToken": "<OPENCLAW_HOOK_TOKEN>",
+  "projectRegistry": [
+    {
+      "projectId": "agent-smart-memo",
+      "repoRoot": "/Users/me/Work/projects/agent-smart-memo",
+      "serverUrl": "http://127.0.0.1:4096",
+      "idleTimeoutMs": 900000
+    }
+  ]
+}
+```
+
+## Local dev plugin install
+```bash
+openclaw plugins install -l ~/Work/projects/opencode-bridge
+```
+
+## License
+MIT

package/dist/chunk-6NIQKNRA.js

@@ -0,0 +1,176 @@
+// src/observability.ts
+function parseSseFramesFromBuffer(input) {
+  const normalized = input.replace(/\r\n/g, "\n");
+  const parts = normalized.split("\n\n");
+  const remainder = parts.pop() ?? "";
+  const frames = [];
+  for (const rawFrame of parts) {
+    const lines = rawFrame.split("\n");
+    let event;
+    let id;
+    let retry;
+    const dataLines = [];
+    for (const line of lines) {
+      if (!line || line.startsWith(":")) continue;
+      const idx = line.indexOf(":");
+      const field = idx >= 0 ? line.slice(0, idx).trim() : line.trim();
+      const value = idx >= 0 ? line.slice(idx + 1).replace(/^\s/, "") : "";
+      if (field === "event") event = value;
+      else if (field === "id") id = value;
+      else if (field === "retry") {
+        const n = Number(value);
+        if (Number.isFinite(n)) retry = n;
+      } else if (field === "data") dataLines.push(value);
+    }
+    if (dataLines.length <= 0) continue;
+    frames.push({
+      event,
+      id,
+      retry,
+      data: dataLines.join("\n"),
+      raw: rawFrame
+    });
+  }
+  return { frames, remainder };
+}
+function parseSseData(data) {
+  const trimmed = data.trim();
+  if (!trimmed) return null;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return { raw: trimmed };
+  }
+}
+function unwrapGlobalPayload(raw) {
+  let current = raw;
+  const wrappers = [];
+  for (let i = 0; i < 3; i += 1) {
+    if (!current || typeof current !== "object") break;
+    if ("payload" in current && current.payload !== void 0) {
+      wrappers.push("payload");
+      current = current.payload;
+      continue;
+    }
+    if ("data" in current && current.data !== void 0 && Object.keys(current).length <= 4) {
+      wrappers.push("data");
+      current = current.data;
+      continue;
+    }
+    break;
+  }
+  return { payload: current, wrappers };
+}
+function pickFirstString(obj, keys) {
+  if (!obj || typeof obj !== "object") return void 0;
+  for (const key of keys) {
+    const value = obj[key];
+    if (typeof value === "string" && value.trim()) return value.trim();
+  }
+  return void 0;
+}
+function normalizeOpenCodeEvent(raw) {
+  const text = JSON.stringify(raw || {}).toLowerCase();
+  if (text.includes("permission") || text.includes("question.asked")) {
+    return { kind: "permission.requested", summary: "OpenCode \u0111ang ch\u1EDD permission/user input", raw };
+  }
+  if (text.includes("error") || text.includes("failed")) {
+    return { kind: "task.failed", summary: "OpenCode task failed", raw };
+  }
+  if (text.includes("stalled")) {
+    return { kind: "task.stalled", summary: "OpenCode task stalled", raw };
+  }
+  if (text.includes("complete") || text.includes("completed") || text.includes("done")) {
+    return { kind: "task.completed", summary: "OpenCode task completed", raw };
+  }
+  if (text.includes("progress") || text.includes("delta") || text.includes("assistant")) {
+    return { kind: "task.progress", summary: "OpenCode task made progress", raw };
+  }
+  if (text.includes("start") || text.includes("created") || text.includes("connected")) {
+    return { kind: "task.started", summary: "OpenCode task/server started", raw };
+  }
+  return { kind: null, raw };
+}
+function normalizeTypedEventV1(frame, scope) {
+  const parsed = parseSseData(frame.data);
+  const unwrapped = unwrapGlobalPayload(parsed);
+  const normalized = normalizeOpenCodeEvent(unwrapped.payload);
+  return {
+    schema: "opencode.event.v1",
+    scope,
+    eventName: frame.event,
+    eventId: frame.id,
+    kind: normalized.kind,
+    summary: normalized.summary,
+    runId: pickFirstString(unwrapped.payload, ["run_id", "runId"]),
+    taskId: pickFirstString(unwrapped.payload, ["task_id", "taskId"]),
+    sessionId: pickFirstString(unwrapped.payload, ["session_id", "sessionId", "session"]),
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    wrappers: unwrapped.wrappers,
+    payload: unwrapped.payload
+  };
+}
+function asString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function scoreSessionCandidate(candidate, ctx) {
+  const id = asString(candidate?.id) || "";
+  const candidateText = JSON.stringify(candidate || {}).toLowerCase();
+  const runId = ctx.runId?.toLowerCase();
+  const taskId = ctx.taskId?.toLowerCase();
+  const sessionKey = ctx.sessionKey?.toLowerCase();
+  const artifactSessionId = ctx.artifactSessionId;
+  let score = 0;
+  if (artifactSessionId && id === artifactSessionId) score += 1e3;
+  if (runId && candidateText.includes(runId)) score += 120;
+  if (taskId && candidateText.includes(taskId)) score += 70;
+  if (sessionKey && candidateText.includes(sessionKey)) score += 60;
+  if (runId && id.toLowerCase().includes(runId)) score += 30;
+  if (taskId && id.toLowerCase().includes(taskId)) score += 20;
+  score += Math.max(0, 20 - ctx.recencyRank);
+  return score;
+}
+function resolveSessionId(input) {
+  if (input.explicitSessionId) {
+    return { sessionId: input.explicitSessionId, strategy: "explicit", score: 9999 };
+  }
+  const list = Array.isArray(input.sessionList) ? input.sessionList : [];
+  const withRecency = [...list].map((item, idx) => {
+    const updated = Number(item?.time?.updated || 0);
+    return { item, idx, updated };
+  }).sort((a, b) => b.updated - a.updated).map((x, rank) => ({ ...x, rank }));
+  if (input.artifactSessionId) {
+    const direct = withRecency.find((x) => asString(x.item?.id) === input.artifactSessionId);
+    if (direct) {
+      return { sessionId: input.artifactSessionId, strategy: "artifact", score: 1e3 };
+    }
+  }
+  let best = { score: -1 };
+  for (const candidate of withRecency) {
+    const id = asString(candidate.item?.id);
+    if (!id) continue;
+    const score = scoreSessionCandidate(candidate.item, {
+      runId: input.runId,
+      taskId: input.taskId,
+      sessionKey: input.sessionKey,
+      artifactSessionId: input.artifactSessionId,
+      recencyRank: candidate.rank
+    });
+    if (score > best.score) best = { id, score };
+  }
+  if (best.id && best.score > 0) {
+    return { sessionId: best.id, strategy: "scored_fallback", score: best.score };
+  }
+  const latest = withRecency.find((x) => asString(x.item?.id));
+  if (latest) return { sessionId: asString(latest.item?.id), strategy: "latest", score: 0 };
+  return { strategy: "none", score: -1 };
+}
+
+export {
+  parseSseFramesFromBuffer,
+  parseSseData,
+  unwrapGlobalPayload,
+  normalizeOpenCodeEvent,
+  normalizeTypedEventV1,
+  resolveSessionId
+};

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+declare const plugin: {
+    id: string;
+    name: string;
+    version: string;
+    register(api: any): void;
+};
+
+export { plugin as default };