@aliyunrds/ctxdb 0.0.10 → 1.0.0-beta.2

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

@@ -1,147 +0,0 @@
-// 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

@@ -1,9 +0,0 @@
-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

@@ -1,64 +0,0 @@
-// 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

@@ -1,87 +0,0 @@
-// 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

@@ -1,51 +0,0 @@
-// 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(", ");
-}