@co-engram/openclaw 0.1.0

package/dist/json-schemas.js

@@ -0,0 +1,432 @@
+/**
+ * 手写 JSON Schema 字典
+ *
+ * 与 packages/core/src/tools/schemas.ts 中的 Zod schemas 保持一致。
+ * P0 阶段手写避免引入 zod-to-json-schema 依赖。
+ * P1 阶段可改用 zod v4 的 z.toJSONSchema() 自动生成。
+ *
+ * @module @co-engram/openclaw
+ */
+const ENGRAM_KIND_ENUM = [
+    "observation",
+    "fact",
+    "pattern",
+    "procedure",
+    "hypothesis",
+];
+const ENGRAM_STATUS_ENUM = [
+    "active",
+    "draft",
+    "archived",
+    "forgotten",
+];
+const ENGRAM_FRESHNESS_ENUM = ["fresh", "aging", "stale", "forgotten"];
+const EMOTIONAL_VALENCE_ENUM = ["positive", "negative", "neutral"];
+const SOURCE_TYPE_ENUM = ["firsthand", "secondhand", "inferred"];
+const VISIBILITY_ENUM = ["public", "team", "private", "restricted"];
+const DISCLOSURE_TIER_ENUM = [
+    "catalog",
+    "digest",
+    "content",
+    "meta",
+    "synapses",
+];
+const ENGRAM_GET_TIER_ENUM = [
+    "catalog",
+    "digest",
+    "content",
+    "meta",
+    "synapses",
+    "auto",
+];
+const SYNAPSE_KIND_ENUM = [
+    "extends",
+    "part_of",
+    "similar_to",
+    "depends_on",
+    "causes",
+    "follows",
+    "derives_from",
+    "contradicts",
+    "exemplifies",
+    "supersedes",
+    "consolidates",
+    "contextualizes",
+];
+const SYNAPSE_DIRECTION_ENUM = ["directional", "bidirectional"];
+const stringField = (description, maxLength, minLength = 1) => ({
+    type: "string",
+    description,
+    minLength,
+    ...(maxLength !== undefined ? { maxLength } : {}),
+});
+/** 可选字符串字段（minLength=0 允许空字符串/省略） */
+const optionalStringField = (description, maxLength) => ({
+    type: "string",
+    description,
+    ...(maxLength !== undefined ? { maxLength } : {}),
+});
+const numberField = (description, min = 0, max = 1) => ({
+    type: "number",
+    description,
+    minimum: min,
+    maximum: max,
+});
+const engramIdField = stringField("Engram ID");
+const searchFilterSchema = {
+    type: "object",
+    description: "可选过滤器",
+    additionalProperties: false,
+    properties: {
+        domainTags: { type: "array", items: { type: "string" } },
+        kinds: { type: "array", items: { type: "string" } },
+        status: {
+            type: "array",
+            items: { type: "string", enum: ENGRAM_STATUS_ENUM },
+        },
+        freshness: {
+            type: "array",
+            items: { type: "string", enum: ENGRAM_FRESHNESS_ENUM },
+        },
+        emotionalValence: {
+            type: "array",
+            items: { type: "string", enum: EMOTIONAL_VALENCE_ENUM },
+        },
+        createdBy: { type: "array", items: { type: "string" } },
+        createdAfter: { type: "string", description: "ISO 8601 时间戳" },
+        createdBefore: { type: "string", description: "ISO 8601 时间戳" },
+        minImportance: numberField("最低重要性阈值", 0, 1),
+    },
+};
+export const engramCreateSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["title", "content", "kind", "domainTags", "createdBy"],
+    properties: {
+        title: stringField("标题（1-200 字符）", 200),
+        content: stringField("正文（Markdown，非空）"),
+        kind: { type: "string", enum: ENGRAM_KIND_ENUM },
+        kinds: { type: "array", items: { type: "string", enum: ENGRAM_KIND_ENUM } },
+        summary: stringField("摘要（≤300 字符）", 300),
+        domainTags: {
+            type: "array",
+            items: { type: "string", minLength: 1 },
+            minItems: 1,
+        },
+        contextTags: { type: "array", items: { type: "string", minLength: 1 } },
+        encodingContext: optionalStringField("编码情境"),
+        importance: numberField("重要性 [0,1]"),
+        confidence: numberField("置信度 [0,1]"),
+        emotionalValence: { type: "string", enum: EMOTIONAL_VALENCE_ENUM },
+        sourceType: { type: "string", enum: SOURCE_TYPE_ENUM },
+        visibility: { type: "string", enum: VISIBILITY_ENUM },
+        decayHalfLifeDays: {
+            type: ["integer", "null"],
+            description: "半衰期天数（null 表示永不衰退）",
+            minimum: 1,
+        },
+        createdBy: stringField("创建者标识"),
+        dedupe: {
+            type: "boolean",
+            description: "是否触发智能去重（默认 true）。DUPLICATE 时强化原 engram 不重复创建；UPDATE 时合并；NEW 时正常创建。",
+            default: true,
+        },
+    },
+};
+export const engramGetSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id"],
+    properties: {
+        id: engramIdField,
+        tier: {
+            type: "string",
+            enum: ENGRAM_GET_TIER_ENUM,
+            default: "digest",
+            description: "披露层级（默认 digest）；auto 表示按 contextBudget 自动选",
+        },
+        contextBudget: {
+            type: "object",
+            description: "tier=auto 时的 token 预算；省略则默认 4096",
+            additionalProperties: false,
+            properties: {
+                totalTokens: { type: "integer", minimum: 1, description: "总预算" },
+                reserved: {
+                    type: "integer",
+                    minimum: 0,
+                    default: 0,
+                    description: "已被其他内容占用",
+                },
+            },
+        },
+        score: {
+            type: "number",
+            minimum: 0,
+            maximum: 1,
+            description: "auto 模式下该 engram 的相关度分数（默认 1.0）",
+        },
+    },
+};
+export const engramUpdateSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id", "updatedBy"],
+    properties: {
+        id: stringField("Engram ID"),
+        title: stringField("新标题", 200),
+        content: stringField("新正文"),
+        summary: stringField("新摘要", 300),
+        kinds: { type: "array", items: { type: "string", enum: ENGRAM_KIND_ENUM } },
+        domainTags: {
+            type: "array",
+            items: { type: "string", minLength: 1 },
+            minItems: 1,
+        },
+        contextTags: { type: "array", items: { type: "string", minLength: 1 } },
+        encodingContext: optionalStringField("编码情境"),
+        importance: numberField("重要性 [0,1]"),
+        confidence: numberField("置信度 [0,1]"),
+        emotionalValence: { type: "string", enum: EMOTIONAL_VALENCE_ENUM },
+        decayHalfLifeDays: {
+            type: ["integer", "null"],
+            minimum: 1,
+        },
+        visibility: { type: "string", enum: VISIBILITY_ENUM },
+        updatedBy: stringField("更新者标识"),
+    },
+};
+export const engramDeleteSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id"],
+    properties: {
+        id: engramIdField,
+    },
+};
+export const engramReinforceSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id"],
+    properties: {
+        id: engramIdField,
+        effectiveness: {
+            type: "number",
+            minimum: 0,
+            maximum: 1,
+            default: 1,
+            description: "有效性 [0,1]，1=完全有效",
+        },
+        note: optionalStringField("有效性说明（≤500 字符，供审计）", 500),
+    },
+};
+export const engramReportFailureSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id", "reason"],
+    properties: {
+        id: engramIdField,
+        reason: stringField("失败原因（≤500 字符，供 LTD 学习）", 500),
+        context: optionalStringField("失败上下文（≤500 字符）", 500),
+    },
+};
+export const engramArchiveSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id"],
+    properties: {
+        id: engramIdField,
+        reason: optionalStringField("归档原因（审计）", 500),
+    },
+};
+export const engramRestoreSchema = engramArchiveSchema;
+export const engramForgetSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id", "reason"],
+    properties: {
+        id: engramIdField,
+        reason: stringField("遗忘原因（必填，不可逆操作）", 500),
+    },
+};
+export const engramRecomputeImportanceSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id"],
+    properties: {
+        id: engramIdField,
+        overrides: {
+            type: "object",
+            description: "手动覆盖 personal/team/project 维度（network/temporal 系统派生）",
+            additionalProperties: false,
+            properties: {
+                personal: { type: "number", minimum: 0, maximum: 1 },
+                team: { type: "number", minimum: 0, maximum: 1 },
+                project: { type: "number", minimum: 0, maximum: 1 },
+            },
+        },
+        persist: {
+            type: "boolean",
+            default: true,
+            description: "是否写回 meta.yaml",
+        },
+        updatedBy: stringField("调用者标识", 100),
+    },
+};
+export const contradictionResolveSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["fromId", "synapseId", "verdict", "rationale", "resolvedBy"],
+    properties: {
+        fromId: engramIdField,
+        synapseId: stringField("Synapse ID", 100),
+        verdict: {
+            type: "string",
+            enum: ["keep_new", "keep_old", "merge", "archive"],
+            description: "裁决选项",
+        },
+        rationale: stringField("裁决依据（必填，供审计）", 1000),
+        resolvedBy: stringField("裁决者标识", 100),
+    },
+};
+export const closeLearningLoopSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["engramId", "outcome", "reportedBy"],
+    properties: {
+        engramId: engramIdField,
+        outcome: {
+            type: "string",
+            enum: ["success", "failure", "partial"],
+            description: "使用结果",
+        },
+        effectiveness: {
+            type: "number",
+            minimum: 0,
+            maximum: 1,
+            description: "有效性 [0,1]（partial 时建议填写）",
+        },
+        reason: stringField("失败原因（outcome=failure 时建议填写）", 500),
+        reportedBy: stringField("调用者标识", 100),
+    },
+};
+export const engramSearchSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["query"],
+    properties: {
+        query: stringField("查询字符串"),
+        filter: searchFilterSchema,
+        limit: { type: "integer", minimum: 1, maximum: 100, default: 20 },
+    },
+};
+export const engramListSchema = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        filter: searchFilterSchema,
+        limit: { type: "integer", minimum: 1, maximum: 500, default: 100 },
+    },
+};
+export const synapseCreateSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["from", "to", "kind", "createdBy"],
+    properties: {
+        from: engramIdField,
+        to: engramIdField,
+        kind: { type: "string", enum: SYNAPSE_KIND_ENUM },
+        weight: { type: "number", minimum: 0, maximum: 1, default: 0.5 },
+        direction: {
+            type: "string",
+            enum: SYNAPSE_DIRECTION_ENUM,
+            default: "directional",
+        },
+        evidence: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["description", "addedBy"],
+                properties: {
+                    description: { type: "string", minLength: 1 },
+                    source: { type: "string" },
+                    confidence: { type: "number", minimum: 0, maximum: 1 },
+                    addedBy: { type: "string", minLength: 1 },
+                },
+            },
+        },
+        createdBy: stringField("创建者"),
+        sourceSemantic: optionalStringField("源语义标签"),
+        targetSemantic: optionalStringField("目标语义标签"),
+    },
+};
+export const synapseGetSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["from", "synapseId"],
+    properties: {
+        from: engramIdField,
+        synapseId: stringField("Synapse ID"),
+    },
+};
+export const synapseDeleteSchema = synapseGetSchema;
+export const synapseListSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["engramId"],
+    properties: {
+        engramId: engramIdField,
+        direction: {
+            type: "string",
+            enum: ["outgoing", "incoming", "both"],
+            default: "both",
+        },
+    },
+};
+export const skillGetSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id"],
+    properties: {
+        id: stringField("Skill ID"),
+    },
+};
+export const skillInvokeSchema = {
+    type: "object",
+    additionalProperties: false,
+    required: ["id"],
+    properties: {
+        id: stringField("Skill ID"),
+        args: {
+            type: "object",
+            description: "调用参数（自由 key-value）",
+            additionalProperties: true,
+            default: {},
+        },
+    },
+};
+/**
+ * 工具名 → JSON Schema 映射
+ */
+export const TOOL_JSON_SCHEMAS = {
+    engram_create: engramCreateSchema,
+    engram_get: engramGetSchema,
+    engram_update: engramUpdateSchema,
+    engram_delete: engramDeleteSchema,
+    engram_search: engramSearchSchema,
+    engram_list: engramListSchema,
+    engram_reinforce: engramReinforceSchema,
+    engram_report_failure: engramReportFailureSchema,
+    engram_archive: engramArchiveSchema,
+    engram_restore: engramRestoreSchema,
+    engram_forget: engramForgetSchema,
+    engram_recompute_importance: engramRecomputeImportanceSchema,
+    contradiction_resolve: contradictionResolveSchema,
+    close_learning_loop: closeLearningLoopSchema,
+    synapse_create: synapseCreateSchema,
+    synapse_get: synapseGetSchema,
+    synapse_delete: synapseDeleteSchema,
+    synapse_list: synapseListSchema,
+    skill_get: skillGetSchema,
+    skill_invoke: skillInvokeSchema,
+};
+//# sourceMappingURL=json-schemas.js.map

package/dist/json-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schemas.js","sourceRoot":"","sources":["../src/json-schemas.ts"],"names":[],"mappings":"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"}

package/dist/list-intent-detector.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 列举记忆意图检测
+ *
+ * 用于 before_prompt_build hook:当用户 prompt 明显是"列举我的记忆"场景时,
+ * 通过 appendSystemContext 直接注入实际的 engram 列表(markdown),与
+ * workspace MEMORY.md 平等竞争——避免 agent 因为看到 workspace MEMORY.md
+ * 现成内容而绕开 co-engram 工具调用。
+ *
+ * 检测策略:保守正则匹配。只在非常明确的列举意图下触发,避免对正常
+ * query 误注入(那样会污染 prompt + 损 prompt cache)。
+ *
+ * @module @co-engram/openclaw/list-intent
+ */
+/**
+ * 检测 prompt 是否为列举记忆意图
+ *
+ * @returns true 如果是明确的列举场景
+ */
+export declare function isListMemoryIntent(prompt: string): boolean;
+//# sourceMappingURL=list-intent-detector.d.ts.map

package/dist/list-intent-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-intent-detector.d.ts","sourceRoot":"","sources":["../src/list-intent-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA2BH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK1D"}

package/dist/list-intent-detector.js

@@ -0,0 +1,50 @@
+/**
+ * 列举记忆意图检测
+ *
+ * 用于 before_prompt_build hook:当用户 prompt 明显是"列举我的记忆"场景时,
+ * 通过 appendSystemContext 直接注入实际的 engram 列表(markdown),与
+ * workspace MEMORY.md 平等竞争——避免 agent 因为看到 workspace MEMORY.md
+ * 现成内容而绕开 co-engram 工具调用。
+ *
+ * 检测策略:保守正则匹配。只在非常明确的列举意图下触发,避免对正常
+ * query 误注入(那样会污染 prompt + 损 prompt cache)。
+ *
+ * @module @co-engram/openclaw/list-intent
+ */
+const LIST_INTENT_PATTERNS = [
+    // 中文:列举/显示/列出 + 记忆/记忆库/记忆库
+    /我有哪些记忆/,
+    /列出.*记忆/,
+    /列出.*engram/,
+    /显示.*记忆/,
+    /显示.*engram/,
+    /列举.*记忆/,
+    /列举.*engram/,
+    /查看.*记忆库/,
+    /看看.*记忆/,
+    /记忆库.*有什么/,
+    /记忆库.*有哪些/,
+    /记忆库.*内容/,
+    /记忆总数/,
+    /多少.*记忆/,
+    /所有记忆/,
+    // 英文
+    /\bwhat.*memor(y|ies)\b.*(?:do i have|have|i)\b/i,
+    /\blist.*memor(y|ies)\b/i,
+    /\bshow.*memor(y|ies)\b/i,
+    /\ball memori?es?\b/i,
+    /\bhow many memori?es?\b/i,
+];
+/**
+ * 检测 prompt 是否为列举记忆意图
+ *
+ * @returns true 如果是明确的列举场景
+ */
+export function isListMemoryIntent(prompt) {
+    if (!prompt || typeof prompt !== "string")
+        return false;
+    // 只看 prompt 的前 500 字符(避免长 prompt 触发误判)
+    const head = prompt.slice(0, 500);
+    return LIST_INTENT_PATTERNS.some((re) => re.test(head));
+}
+//# sourceMappingURL=list-intent-detector.js.map

package/dist/list-intent-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-intent-detector.js","sourceRoot":"","sources":["../src/list-intent-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,oBAAoB,GAAsB;IAC9C,2BAA2B;IAC3B,QAAQ;IACR,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,QAAQ;IACR,UAAU;IACV,UAAU;IACV,SAAS;IACT,MAAM;IACN,QAAQ;IACR,MAAM;IACN,KAAK;IACL,iDAAiD;IACjD,yBAAyB;IACzB,yBAAyB;IACzB,qBAAqB;IACrB,0BAA0B;CAC3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxD,uCAAuC;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/llm-client.d.ts

@@ -0,0 +1,29 @@
+/**
+ * OpenAI-compatible LlmClient 适配器
+ *
+ * 把 co-engram core 的 LlmClient 抽象映射到一个 fetch POST `/chat/completions`。
+ * 支持任何 OpenAI 兼容端点(OpenAI / Azure / 通义 / 智谱 / DeepSeek / 月之暗面 / 本地 ollama 等)。
+ * 推理模型(Qwen3 / DeepSeek-R1 / DeepSeek-V4 / GLM-5.2)通过 reasoning_content fallback 自动支持。
+ *
+ * 设计参考 flexmem shared/llm-call.ts:
+ *   - 复用 OpenClaw native model config(若可用)作为 fallback
+ *   - 失败时抛错,由 LlmNecessityEvaluator 决定是否 fallback 到规则版
+ *
+ * @module @co-engram/openclaw
+ */
+import type { LlmClient } from "@co-engram/core";
+import type { NecessityLlmConfig } from "./types.js";
+/**
+ * 从 OpenClaw 全局配置(~/.openclaw/openclaw.json)读默认 LLM 配置
+ *
+ * 当用户未在 plugin config 显式配置 necessityLlm 时,作为 fallback。
+ * 读 agents.defaults.model.primary 解析 provider,再取对应 provider 的 baseUrl + apiKey。
+ */
+export declare function loadOpenClawFallbackLlmConfig(): NecessityLlmConfig | undefined;
+/**
+ * 创建 OpenAI-compatible LlmClient
+ *
+ * 自动追加 `/chat/completions` 后缀。
+ */
+export declare function createOpenAiCompatibleLlmClient(cfg: NecessityLlmConfig): LlmClient;
+//# sourceMappingURL=llm-client.d.ts.map

package/dist/llm-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../src/llm-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,6BAA6B,IACzC,kBAAkB,GAClB,SAAS,CA8BZ;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,kBAAkB,GACtB,SAAS,CAyDX"}

package/dist/llm-client.js

@@ -0,0 +1,112 @@
+/**
+ * OpenAI-compatible LlmClient 适配器
+ *
+ * 把 co-engram core 的 LlmClient 抽象映射到一个 fetch POST `/chat/completions`。
+ * 支持任何 OpenAI 兼容端点(OpenAI / Azure / 通义 / 智谱 / DeepSeek / 月之暗面 / 本地 ollama 等)。
+ * 推理模型(Qwen3 / DeepSeek-R1 / DeepSeek-V4 / GLM-5.2)通过 reasoning_content fallback 自动支持。
+ *
+ * 设计参考 flexmem shared/llm-call.ts:
+ *   - 复用 OpenClaw native model config(若可用)作为 fallback
+ *   - 失败时抛错,由 LlmNecessityEvaluator 决定是否 fallback 到规则版
+ *
+ * @module @co-engram/openclaw
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * 从 OpenClaw 全局配置(~/.openclaw/openclaw.json)读默认 LLM 配置
+ *
+ * 当用户未在 plugin config 显式配置 necessityLlm 时,作为 fallback。
+ * 读 agents.defaults.model.primary 解析 provider,再取对应 provider 的 baseUrl + apiKey。
+ */
+export function loadOpenClawFallbackLlmConfig() {
+    try {
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
+        const cfgPath = join(home, ".openclaw", "openclaw.json");
+        if (!existsSync(cfgPath))
+            return undefined;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const raw = JSON.parse(readFileSync(cfgPath, "utf8"));
+        const agentModel = raw?.agents?.defaults?.model?.primary;
+        if (!agentModel)
+            return undefined;
+        const [providerKey, modelId] = agentModel.includes("/")
+            ? agentModel.split("/", 2)
+            : [undefined, agentModel];
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const providerCfg = providerKey
+            ? raw?.models?.providers?.[providerKey]
+            : Object.values(raw?.models?.providers ?? {})[0];
+        if (!providerCfg)
+            return undefined;
+        const baseUrl = providerCfg.baseUrl;
+        const apiKey = providerCfg.apiKey;
+        if (!baseUrl || !apiKey)
+            return undefined;
+        return { endpoint: baseUrl, apiKey, model: modelId };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 创建 OpenAI-compatible LlmClient
+ *
+ * 自动追加 `/chat/completions` 后缀。
+ */
+export function createOpenAiCompatibleLlmClient(cfg) {
+    const endpoint = normalizeEndpoint(cfg.endpoint);
+    return {
+        async complete(prompt, opts = {}) {
+            const headers = {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${cfg.apiKey}`,
+                ...(cfg.headers ?? {}),
+            };
+            const body = {
+                model: cfg.model,
+                temperature: opts.temperature ?? 0.1,
+                max_tokens: opts.maxTokens ?? 300,
+                messages: [{ role: "user", content: prompt }],
+            };
+            const resp = await fetch(endpoint, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(opts.timeoutMs ?? 15_000),
+            });
+            if (!resp.ok) {
+                const text = await resp.text();
+                throw new Error(`LLM call failed (${resp.status}): ${text.slice(0, 200)}`);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const json = (await resp.json());
+            const choice = json?.choices?.[0];
+            const message = choice?.message;
+            const finishReason = choice?.finish_reason;
+            // 1. 正式 content 优先
+            const content = message?.content;
+            if (content && content.trim().length > 0)
+                return content.trim();
+            // 2. reasoning 模型 fallback:content=null + reasoning_content 非空
+            //    Qwen3 / DeepSeek-R1 / DeepSeek-V4 / GLM-5.2 等 reasoning 模型,
+            //    reasoning 阶段就用光 max_tokens 时 content=null。
+            //    reasoning_content 末尾常含 JSON 答案,交给 core 的 parseLlmVerdict 抽取。
+            const reasoning = message?.reasoning_content;
+            if (reasoning && reasoning.trim().length > 0) {
+                return reasoning.trim();
+            }
+            // 3. 都为空:抛错带诊断,让 LlmNecessityEvaluator fallback 到规则版
+            throw new Error(`LLM returned empty content (finish_reason=${finishReason ?? "unknown"})`);
+        },
+    };
+}
+function normalizeEndpoint(url) {
+    const stripped = url.replace(/\/+$/, "");
+    if (stripped.endsWith("/chat/completions"))
+        return stripped;
+    if (stripped.endsWith("/completions"))
+        return stripped;
+    return `${stripped}/chat/completions`;
+}
+//# sourceMappingURL=llm-client.js.map