@aliyunrds/ctxdb 0.0.9 → 0.0.10

package/dist/opencode/src/http-client.ts

@@ -0,0 +1,147 @@
+// Minimal HTTP client for the ctxdb server (in-process plugin variant).
+//
+// Stripped down from `@aliyunrds/ctxdb`'s HttpClient: no multipart, no
+// PUT/DELETE, no debug logging — the plugin only ever does:
+//
+//   GET  /v1/knowledge/knowledge_bases
+//   POST /v3/memories/search/
+//   POST /v3/memories/add/
+//
+// Per-call timeouts are mandatory (callers pass 5s for recall/KB,
+// 8s for capture). Errors are caught at the hook layer; this client
+// throws on non-2xx but never logs to stderr itself.
+
+const DEFAULT_TIMEOUT_MS = 30_000;
+
+export class CtxdbHttpError extends Error {
+  readonly status: number | null;
+  readonly path: string;
+  constructor(path: string, status: number | null, message: string) {
+    super(message);
+    this.name = "CtxdbHttpError";
+    this.path = path;
+    this.status = status;
+  }
+}
+
+export interface HttpClientOptions {
+  baseUrl: string;
+  apiKey: string | null;
+  userAgent?: string;
+  fetchImpl?: typeof fetch;
+}
+
+export interface RequestOptions {
+  timeoutMs?: number;
+}
+
+export class HttpClient {
+  readonly baseUrl: string;
+  readonly apiKey: string | null;
+  readonly userAgent: string;
+  private readonly fetchImpl: typeof fetch;
+
+  constructor(opts: HttpClientOptions) {
+    this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+    this.apiKey = opts.apiKey;
+    this.userAgent = opts.userAgent ?? "ctxdb-opencode-plugin/0.0.0";
+    this.fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
+  }
+
+  private headers(contentType?: string): Record<string, string> {
+    const h: Record<string, string> = {
+      "User-Agent": this.userAgent,
+      Connection: "close",
+    };
+    if (this.apiKey) h.Authorization = `Token ${this.apiKey}`;
+    if (contentType) h["Content-Type"] = contentType;
+    return h;
+  }
+
+  async get(path: string, params?: Record<string, unknown>, options: RequestOptions = {}): Promise<unknown> {
+    let url = `${this.baseUrl}${path}`;
+    if (params) {
+      const qs = new URLSearchParams();
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined && v !== null) qs.append(k, String(v));
+      }
+      const s = qs.toString();
+      if (s) url = `${url}?${s}`;
+    }
+    return this.request("GET", url, path, undefined, undefined, options.timeoutMs);
+  }
+
+  async postJson(
+    path: string,
+    body: Record<string, unknown> | unknown[],
+    options: RequestOptions = {},
+  ): Promise<unknown> {
+    const url = `${this.baseUrl}${path}`;
+    return this.request("POST", url, path, JSON.stringify(body), "application/json", options.timeoutMs);
+  }
+
+  private async request(
+    method: string,
+    url: string,
+    path: string,
+    body: string | undefined,
+    contentType: string | undefined,
+    timeoutMs: number | undefined,
+  ): Promise<unknown> {
+    const effectiveTimeout = timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), effectiveTimeout);
+    try {
+      let resp: Response;
+      try {
+        resp = await this.fetchImpl(url, {
+          method,
+          headers: this.headers(contentType),
+          body,
+          signal: controller.signal,
+        });
+      } catch (err: any) {
+        if (err?.name === "AbortError") {
+          throw new CtxdbHttpError(path, null, `timeout after ${effectiveTimeout}ms`);
+        }
+        throw new CtxdbHttpError(path, null, `network error: ${err?.message ?? err}`);
+      }
+
+      if (resp.status === 204) return {};
+      let text: string;
+      try {
+        text = await resp.text();
+      } catch (err: any) {
+        throw new CtxdbHttpError(path, resp.status, `body read failed: ${err?.message ?? err}`);
+      }
+      if (!resp.ok) {
+        throw new CtxdbHttpError(path, resp.status, extractDetail(text) || `HTTP ${resp.status}`);
+      }
+      if (!text) return {};
+      try {
+        return JSON.parse(text);
+      } catch {
+        return text;
+      }
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+}
+
+function extractDetail(text: string): string {
+  if (!text) return "";
+  try {
+    const parsed = JSON.parse(text);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      for (const k of ["detail", "message", "error"]) {
+        const v = (parsed as Record<string, unknown>)[k];
+        if (typeof v === "string" && v) return v;
+      }
+      return JSON.stringify(parsed);
+    }
+    return String(parsed);
+  } catch {
+    return text;
+  }
+}

package/dist/opencode/src/index.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from "@opencode-ai/plugin";
+import { buildHooks } from "./hooks.ts";
+
+const plugin: Plugin = async (input) => buildHooks(input);
+
+export default {
+  id: "ctxdb",
+  server: plugin,
+};

package/dist/opencode/src/kb-catalog.ts

@@ -0,0 +1,64 @@
+// Fetch /v1/knowledge/knowledge_bases (the existing endpoint used by
+// `@aliyunrds/ctxdb`) and render the `<available-knowledge-bases>` block.
+//
+// The agent slug in the embedded `--agent=<X>` hint is hard-coded to
+// "opencode" so the SKILL.md template substitution is consistent with
+// what `ctxdb setup --agent opencode` writes to ~/.config/opencode/skills/.
+
+import type { HttpClient } from "./http-client.ts";
+
+export const KB_LIST_PATH = "/v1/knowledge/knowledge_bases";
+
+interface KnowledgeBase {
+  name?: unknown;
+  status?: unknown;
+  key_entities?: unknown;
+}
+
+function sanitizeKeyEntities(raw: unknown): string[] {
+  if (!Array.isArray(raw)) return [];
+  const out: string[] = [];
+  for (const e of raw) {
+    if (typeof e !== "string") continue;
+    const cleaned = e.replace(/\s+/g, " ").trim();
+    if (cleaned) out.push(cleaned);
+  }
+  return out;
+}
+
+export async function fetchKbCatalogBlock(
+  client: HttpClient,
+  timeoutMs: number,
+  agent = "opencode",
+): Promise<string> {
+  let resp: unknown;
+  try {
+    resp = await client.get(KB_LIST_PATH, undefined, { timeoutMs });
+  } catch {
+    return "";
+  }
+
+  let kbs: KnowledgeBase[] = [];
+  if (Array.isArray(resp)) {
+    kbs = resp as KnowledgeBase[];
+  } else if (resp && typeof resp === "object") {
+    const o = resp as Record<string, unknown>;
+    const list = (o.knowledge_bases ?? o.results) as unknown;
+    if (Array.isArray(list)) kbs = list as KnowledgeBase[];
+  }
+
+  const active = kbs.filter((kb) => kb.status === "active" && typeof kb.name === "string" && kb.name);
+  if (active.length === 0) return "";
+
+  const lines = active.map((kb) => {
+    const ents = sanitizeKeyEntities(kb.key_entities);
+    return ents.length > 0 ? `· ${kb.name}: ${ents.join(", ")}` : `· ${kb.name}`;
+  });
+
+  return [
+    "<available-knowledge-bases>",
+    `When you identify that relevant information may exist in the knowledge bases below, you MUST run \`ctxdb kb search "<query>" --kb=<name> --agent=${agent}\` with targeted keywords after initial analysis to supplement and correct your approach. For keyword-based KB search, keep each single query focused: use at most 5 keywords or short phrases; run multiple targeted searches if more are needed. Knowledge bases:`,
+    ...lines,
+    "</available-knowledge-bases>",
+  ].join("\n");
+}

package/dist/opencode/src/recall.ts

@@ -0,0 +1,87 @@
+// Recall path: search /v3/memories/search/ → format via shared
+// formatRecalledMemoriesBlock. Mirrors recall-orchestrator.ts in
+// `@aliyunrds/ctxdb` but stripped to the bare minimum the plugin needs.
+//
+// All callers wrap this in their own try/catch + timeout (5s recall).
+// This module never throws — all failures resolve to an empty result.
+
+import {
+  formatRecalledMemoriesBlock,
+  buildExternalKnowledgeBlock,
+  type MemoryItem,
+  type ExternalContextChunk,
+} from "@aliyunrds/ctxdb-shared";
+
+import type { OpencodeConfig } from "./config.ts";
+import type { HttpClient } from "./http-client.ts";
+
+export interface RecallResult {
+  /** Combined `<recalled-memories>` + `<external-knowledge>` block, or
+   *  empty string when nothing to inject. */
+  block: string;
+  memoryCount: number;
+  knowledgeChunkCount: number;
+  reason: string;
+}
+
+const EMPTY: RecallResult = { block: "", memoryCount: 0, knowledgeChunkCount: 0, reason: "" };
+
+function stripSystemReminders(raw: string): string {
+  const cleaned = raw.replace(/<system-reminder>[\s\S]*?<\/system-reminder>/g, "").trim();
+  return cleaned || raw;
+}
+
+export async function searchAndFormatRecall(
+  prompt: string,
+  cfg: OpencodeConfig,
+  client: HttpClient,
+  timeoutMs: number,
+): Promise<RecallResult> {
+  if (!prompt.trim()) return { ...EMPTY, reason: "empty_prompt" };
+  if (!cfg.baseUrl) return { ...EMPTY, reason: "config_incomplete" };
+
+  const body: Record<string, unknown> = {
+    query: stripSystemReminders(prompt),
+    user_id: cfg.userId,
+    top_k: cfg.topK,
+    threshold: cfg.threshold,
+  };
+  if (cfg.recallKnowledge) {
+    body.knowledge = { enable: true, top_k: cfg.knowledgeTopK };
+  }
+
+  let resp: unknown;
+  try {
+    resp = await client.postJson("/v3/memories/search/", body, { timeoutMs });
+  } catch (err) {
+    return { ...EMPTY, reason: `http_error: ${(err as Error).message}` };
+  }
+
+  if (!resp || typeof resp !== "object") {
+    return { ...EMPTY, reason: "bad_response_shape" };
+  }
+
+  const r = resp as Record<string, unknown>;
+  const memories: MemoryItem[] = Array.isArray(r.results)
+    ? (r.results as MemoryItem[])
+    : Array.isArray(r.memories)
+      ? (r.memories as MemoryItem[])
+      : [];
+  const knowledge =
+    r.knowledge && typeof r.knowledge === "object"
+      ? (r.knowledge as { chunks?: ExternalContextChunk[] })
+      : null;
+  const chunks: ExternalContextChunk[] = Array.isArray(knowledge?.chunks) ? knowledge!.chunks! : [];
+
+  const blocks: string[] = [];
+  if (memories.length > 0) blocks.push(formatRecalledMemoriesBlock(memories, cfg.userId));
+  if (chunks.length > 0) blocks.push(buildExternalKnowledgeBlock(chunks, cfg.userId));
+
+  if (blocks.length === 0) return { ...EMPTY, reason: "nothing_to_inject" };
+  return {
+    block: blocks.join("\n\n"),
+    memoryCount: memories.length,
+    knowledgeChunkCount: chunks.length,
+    reason: "ok",
+  };
+}

package/dist/opencode/src/warmup.ts

@@ -0,0 +1,51 @@
+// Warmup query builder — collects cwd basename + git branch + last 3
+// commit subjects, joins into a single query string. Search is run via
+// the regular recall path (searchAndFormatRecall); only the query
+// shape differs.
+
+import { execSync } from "node:child_process";
+import { basename } from "node:path";
+
+export interface GitSignals {
+  branch: string;
+  recentCommits: string[];
+}
+
+export function collectGitSignals(cwd: string): GitSignals {
+  const result: GitSignals = { branch: "", recentCommits: [] };
+  try {
+    result.branch = execSync("git rev-parse --abbrev-ref HEAD", {
+      cwd,
+      timeout: 500,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"],
+    }).trim();
+  } catch {
+    // not a git repo / no git
+  }
+  try {
+    const log = execSync("git log --oneline -3 --no-decorate", {
+      cwd,
+      timeout: 500,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"],
+    }).trim();
+    if (log) {
+      result.recentCommits = log.split("\n").map((l) => {
+        const idx = l.indexOf(" ");
+        return idx > 0 ? l.slice(idx + 1) : l;
+      });
+    }
+  } catch {
+    // same
+  }
+  return result;
+}
+
+export function buildWarmupQuery(cwd: string, git: GitSignals): string {
+  const project = basename(cwd) || "unknown";
+  const parts: string[] = [`project: ${project}`];
+  if (git.branch) parts.push(`branch: ${git.branch}`);
+  if (git.recentCommits.length > 0) parts.push(`recent work: ${git.recentCommits.join("; ")}`);
+  return parts.join(", ");
+}

package/dist/setup/skills/contextdb-knowledge/SKILL.md

@@ -18,7 +18,7 @@ description: contextdb 知识库高频操作（查询 / 浏览 KB / 上传文档
 
 ## 2. 高频 recipes
 
-> 命令里的 `--agent={{agent}}` 是当前 skill 安装目标。不要把示例改成 `qoder`；如果读到未替换的双花括号 agent 模板，先按 §6 判定真实 agent，再替换成 `qoder` / `qoderwork` / `codex` / `claude` / `default`。
+> 命令里的 `--agent={{agent}}` 是当前 skill 安装目标。不要把示例改成 `qoder`；如果读到未替换的双花括号 agent 模板，先按 §6 判定真实 agent，再替换成 `qoder` / `qoderwork` / `codex` / `claude` / `opencode` / `default`。
 
 ### Recipe 1：在已知 KB 中查内容（最常见）
 
@@ -172,18 +172,18 @@ ctxdb kb upload-file <kb-name> <local-path> --agent={{agent}}
 
 | 参数 | 说明 |
 |------|------|
-| `--agent=<name>` | **必填**。指定操作哪个 agent 的配置桶（`qoder` / `qoderwork` / `codex` / `claude` / `default`） |
+| `--agent=<name>` | **必填**。指定操作哪个 agent 的配置桶（`qoder` / `qoderwork` / `codex` / `claude` / `opencode` / `default`） |
 
 `--agent` 解析顺序：
 1. 命令行显式 `--agent=<name>` → 用它
 2. 缺省 → 读 `CTXDB_AGENT` 环境变量
 3. env 也没有 → 落到 `"default"` 桶
-4. 新版本 `ctxdb setup --agent <qoder|qoderwork|codex|claude>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
+4. 新版本 `ctxdb setup --agent <qoder|qoderwork|codex|claude|opencode>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
 5. 若 `"default"` 桶仍不存在或未配置完整 → exit 2 "config incomplete for agent default"
 
 ## 7. 配置
 
-- 配置文件：`~/.ctxdb/ctxdb.json`，分 `agents.<name>` 段（`qoder` / `qoderwork` / `codex` / `claude` / `default`），互不复用
+- 配置文件：`~/.ctxdb/ctxdb.json`，分 `agents.<name>` 段（`qoder` / `qoderwork` / `codex` / `claude` / `opencode` / `default`），互不复用
 - 配置命令：`ctxdb setup --agent <name> --api-key=<key> --base-url=<url> [--user-id=<id>]`
   - 带 `--agent` 时还会装 hooks + skill；若 `agents.default` 缺失，会复制当前 agent 配置作为 CLI 兜底
   - `--agent default` 只写 `agents.default` 段（仅 CLI 用，不装 hooks / skill）

package/dist/setup/skills/contextdb-memory/SKILL.md

@@ -18,7 +18,7 @@ description: contextdb 长期记忆高频操作（主动记忆 / 搜索过往 /
 
 ## 2. 高频 recipes
 
-> 命令里的 `--agent={{agent}}` 是当前 skill 安装目标。不要把示例改成 `qoder`；如果读到未替换的双花括号 agent 模板，先按 §6 判定真实 agent，再替换成 `qoder` / `qoderwork` / `codex` / `claude` / `default`。
+> 命令里的 `--agent={{agent}}` 是当前 skill 安装目标。不要把示例改成 `qoder`；如果读到未替换的双花括号 agent 模板，先按 §6 判定真实 agent，再替换成 `qoder` / `qoderwork` / `codex` / `claude` / `opencode` / `default`。
 
 ### Recipe 1：主动记忆（"记住 X"）
 
@@ -165,18 +165,18 @@ ctxdb memory delete <memory-id> --agent={{agent}}
 
 | 参数 | 说明 |
 |------|------|
-| `--agent=<name>` | **必填**。指定操作哪个 agent 的配置桶（`qoder` / `qoderwork` / `codex` / `claude` / `default`） |
+| `--agent=<name>` | **必填**。指定操作哪个 agent 的配置桶（`qoder` / `qoderwork` / `codex` / `claude` / `opencode` / `default`） |
 
 `--agent` 解析顺序：
 1. 命令行显式 `--agent=<name>` → 用它
 2. 缺省 → 读 `CTXDB_AGENT` 环境变量
 3. env 也没有 → 落到 `"default"` 桶
-4. 新版本 `ctxdb setup --agent <qoder|qoderwork|codex|claude>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
+4. 新版本 `ctxdb setup --agent <qoder|qoderwork|codex|claude|opencode>` 会在 `agents.default` 缺失时复制当前 agent 配置作为兜底
 5. 若 `"default"` 桶仍不存在或未配置完整 → exit 2 "config incomplete for agent default"
 
 ## 7. 配置
 
-- 配置文件：`~/.ctxdb/ctxdb.json`，分 `agents.<name>` 段（`qoder` / `qoderwork` / `codex` / `claude` / `default`），互不复用
+- 配置文件：`~/.ctxdb/ctxdb.json`，分 `agents.<name>` 段（`qoder` / `qoderwork` / `codex` / `claude` / `opencode` / `default`），互不复用
 - 配置命令：`ctxdb setup --agent <name> --api-key=<key> --base-url=<url> [--user-id=<id>]`
   - 带 `--agent` 时还会装 hooks + skill；若 `agents.default` 缺失，会复制当前 agent 配置作为 CLI 兜底
   - `--agent default` 只写 `agents.default` 段（仅 CLI 用，不装 hooks / skill）

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@aliyunrds/ctxdb",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "type": "module",
-  "description": "Unified access layer for RDS ContextDatabase: `ctxdb` CLI (memory + KB ops), one-shot `setup --agent <qoder|codex|claude>` installer, per-agent config, hooks, and SKILL.md.",
+  "description": "Unified access layer for RDS ContextDatabase: `ctxdb` CLI (memory + KB ops), one-shot `setup --agent <qoder|qoderwork|codex|claude|opencode>` installer, per-agent config, hooks/plugins, and SKILL.md.",
   "license": "Apache-2.0",
   "keywords": [
     "rds-context-database",
@@ -12,6 +12,7 @@
     "qoder",
     "codex",
     "claude-code",
+    "opencode",
     "hooks"
   ],
   "main": "./dist/cli/main.js",
@@ -38,7 +39,7 @@
     "vitest": "^4.0.18"
   },
   "scripts": {
-    "build": "tsup && mkdir -p dist/setup && cp -r src/setup/skills dist/setup/ && chmod +x dist/hooks/*.js dist/cli/main.js",
+    "build": "tsup && mkdir -p dist/setup dist/opencode && cp -r src/setup/skills dist/setup/ && cp -r ../opencode/src dist/opencode/ && chmod +x dist/hooks/*.js dist/cli/main.js",
     "test": "vitest run"
   }
 }