@co-engram/core 0.1.0

package/dist/tools/proposal-tools.js

@@ -0,0 +1,99 @@
+/**
+ * Proposal 工具集（M1：候选提示机制）
+ *
+ * 3 个工具：
+ *   - engram_list_proposals   列出 pending/全部提案
+ *   - engram_accept_proposal  接受提案 → 创建 engram
+ *   - engram_dismiss_proposal 拒绝提案（带冷却期）
+ *
+ * 详见 spec §2.2（候选提示机制）。
+ *
+ * @module @co-engram/core/tools
+ */
+import { validateInput } from "./tool.js";
+import { EngramListProposalsInputSchema, EngramAcceptProposalInputSchema, EngramDismissProposalInputSchema, } from "./schemas.js";
+// ============================================================
+// engram_list_proposals
+// ============================================================
+export const engramListProposalsTool = {
+    name: "engram_list_proposals",
+    description: "列出主题候选提案。当某主题在对话中被多次提及但无匹配 engram 时,系统会生成 pending 提案等待确认。默认只返回 pending;传 includeAll=true 可查看历史 accepted/dismissed。",
+    inputSchema: EngramListProposalsInputSchema,
+    execute(input, ctx) {
+        const parsed = validateInput(EngramListProposalsInputSchema, input);
+        if (!ctx.proposalEngine) {
+            throw new Error("ProposalEngine not available in ToolContext");
+        }
+        const all = parsed.includeAll
+            ? ctx.proposalEngine.listAll()
+            : ctx.proposalEngine.listPending();
+        return {
+            proposals: all.map((p) => ({
+                entityId: p.entityId,
+                occurrences: p.occurrences,
+                sampleQuotes: p.sampleQuotes,
+                centroidExcerpt: p.centroidExcerpt,
+                firstSeenAt: p.firstSeenAt,
+                lastSeenAt: p.lastSeenAt,
+                createdAt: p.createdAt,
+                status: p.status,
+            })),
+            total: all.length,
+        };
+    },
+};
+// ============================================================
+// engram_accept_proposal
+// ============================================================
+export const engramAcceptProposalTool = {
+    name: "engram_accept_proposal",
+    description: "接受一个候选提案 → 系统自动创建对应 engram,并把提案标记为 accepted。后续相同主题不会再产生重复提案。",
+    inputSchema: EngramAcceptProposalInputSchema,
+    execute(input, ctx) {
+        const parsed = validateInput(EngramAcceptProposalInputSchema, input);
+        if (!ctx.proposalEngine) {
+            throw new Error("ProposalEngine not available in ToolContext");
+        }
+        // 与 engram_create 完全相同的 createdBy 解析链:
+        // 显式传值 → ctx.defaultCreatedBy(MCP env / OpenClaw plugin config / git 身份) → 'unknown'
+        // 修复前 Zod schema `.default('proposal-engine')` 把这里写死,绕过了整条链。
+        const createdBy = parsed.createdBy ?? ctx.defaultCreatedBy ?? "unknown";
+        const engramId = ctx.proposalEngine.accept(parsed.entityId, {
+            title: parsed.title,
+            content: parsed.content,
+            domainTags: parsed.domainTags,
+            createdBy,
+            kind: parsed.kind,
+        });
+        return { engramId, entityId: parsed.entityId, status: "accepted" };
+    },
+};
+// ============================================================
+// engram_dismiss_proposal
+// ============================================================
+export const engramDismissProposalTool = {
+    name: "engram_dismiss_proposal",
+    description: "拒绝一个候选提案。默认 30 天内不再提示;可通过 dismissDays 自定义冷却期。可填 reason 便于元学习。",
+    inputSchema: EngramDismissProposalInputSchema,
+    execute(input, ctx) {
+        const parsed = validateInput(EngramDismissProposalInputSchema, input);
+        if (!ctx.proposalEngine) {
+            throw new Error("ProposalEngine not available in ToolContext");
+        }
+        ctx.proposalEngine.dismiss(parsed.entityId, parsed.reason, parsed.dismissDays);
+        const all = ctx.proposalEngine.listAll();
+        const target = all.find((p) => p.entityId === parsed.entityId);
+        const dismissedUntil = target?.dismissedUntil ?? new Date().toISOString();
+        return {
+            entityId: parsed.entityId,
+            status: "dismissed",
+            dismissedUntil,
+        };
+    },
+};
+export const ALL_PROPOSAL_TOOLS = [
+    engramListProposalsTool,
+    engramAcceptProposalTool,
+    engramDismissProposalTool,
+];
+//# sourceMappingURL=proposal-tools.js.map

package/dist/tools/proposal-tools.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 工具注册表
+ *
+ * 集中管理所有 Self-Editing Tools。
+ * host adapter 调用 createToolRegistry() 获取所有工具，
+ * 然后包装为各自的工具调用格式（MCP inputSchema / OpenClaw tool descriptor）。
+ *
+ * @module @co-engram/core/tools
+ */
+import type { Tool } from "./tool.js";
+/**
+ * 工具注册表
+ */
+export interface ToolRegistry {
+    /** 按名查工具 */
+    get(name: string): Tool | undefined;
+    /** 列出所有工具 */
+    list(): readonly Tool[];
+    /** 按命名空间筛选（engram / synapse / skill / proposal） */
+    listByNamespace(namespace: "engram" | "synapse" | "skill" | "proposal"): readonly Tool[];
+}
+/**
+ * 创建默认工具注册表（含所有 P0 工具）
+ */
+export declare function createToolRegistry(): ToolRegistry;
+/**
+ * 默认 registry 单例（host 可直接 import）
+ */
+export declare const defaultRegistry: ToolRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOtC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY;IACZ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,aAAa;IACb,IAAI,IAAI,SAAS,IAAI,EAAE,CAAC;IACxB,mDAAmD;IACnD,eAAe,CACb,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GACrD,SAAS,IAAI,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAqBjD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,YAAmC,CAAC"}

package/dist/tools/registry.js

@@ -0,0 +1,43 @@
+/**
+ * 工具注册表
+ *
+ * 集中管理所有 Self-Editing Tools。
+ * host adapter 调用 createToolRegistry() 获取所有工具，
+ * 然后包装为各自的工具调用格式（MCP inputSchema / OpenClaw tool descriptor）。
+ *
+ * @module @co-engram/core/tools
+ */
+import { ALL_ENGRAM_TOOLS } from "./engram-tools.js";
+import { ALL_SYNAPSE_TOOLS } from "./synapse-tools.js";
+import { ALL_SKILL_TOOLS } from "./skill-tools.js";
+import { ALL_PROPOSAL_TOOLS } from "./proposal-tools.js";
+import { ALL_DOCTOR_TOOLS } from "./doctor-tools.js";
+/**
+ * 创建默认工具注册表（含所有 P0 工具）
+ */
+export function createToolRegistry() {
+    const all = [
+        ...ALL_ENGRAM_TOOLS,
+        ...ALL_SYNAPSE_TOOLS,
+        ...ALL_SKILL_TOOLS,
+        ...ALL_PROPOSAL_TOOLS,
+        ...ALL_DOCTOR_TOOLS,
+    ];
+    const map = new Map(all.map((t) => [t.name, t]));
+    return {
+        get(name) {
+            return map.get(name);
+        },
+        list() {
+            return all;
+        },
+        listByNamespace(namespace) {
+            return all.filter((t) => t.name.startsWith(`${namespace}_`));
+        },
+    };
+}
+/**
+ * 默认 registry 单例（host 可直接 import）
+ */
+export const defaultRegistry = createToolRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAgBrD;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAoB;QAC3B,GAAG,gBAAgB;QACnB,GAAG,iBAAiB;QACpB,GAAG,eAAe;QAClB,GAAG,kBAAkB;QACrB,GAAG,gBAAgB;KACpB,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAe,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/D,OAAO;QACL,GAAG,CAAC,IAAI;YACN,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QACD,IAAI;YACF,OAAO,GAAG,CAAC;QACb,CAAC;QACD,eAAe,CAAC,SAAS;YACvB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;QAC/D,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiB,kBAAkB,EAAE,CAAC"}