@co-engram/core 0.1.0

package/dist/tools/engram-tools.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Engram 工具集
+ *
+ * 11 个工具（P0 六个 + P1 五个：三信号 + 生命周期）：
+ *   - engram_create / engram_get / engram_update / engram_delete
+ *   - engram_search / engram_list
+ *   - engram_reinforce / engram_report_failure（三信号）
+ *   - engram_archive / engram_restore / engram_forget（生命周期）
+ *
+ * @module @co-engram/core/tools
+ */
+import type { EngramView } from "../types/disclosure.js";
+import type { EngramCatalogEntry } from "../types/engram.js";
+import type { EngramRepository } from "../storage/repository.js";
+import type { Tool } from "./tool.js";
+import { type EngramCreateToolInput, type EngramGetToolInput, type EngramUpdateToolInput, type EngramDeleteToolInput, type EngramSearchToolInput, type EngramListToolInput, type EngramReinforceToolInput, type EngramReportFailureToolInput, type EngramArchiveToolInput, type EngramRestoreToolInput, type EngramForgetToolInput, type EngramRecomputeImportanceToolInput, type ContradictionResolveToolInput, type CloseLearningLoopToolInput, type UpgradeVerificationToolInput, type GetEvolutionLineageToolInput } from "./schemas.js";
+export interface EngramCreateResult {
+    readonly id: string;
+    readonly verdict: "NEW" | "DUPLICATE" | "UPDATE";
+    readonly targetId?: string;
+    readonly reason?: string;
+    readonly confidence?: number;
+    readonly candidatesConsidered?: number;
+}
+export declare const engramCreateTool: Tool<EngramCreateToolInput, EngramCreateResult>;
+export declare const engramGetTool: Tool<EngramGetToolInput, EngramView>;
+/**
+ * 读取 EngramView（被工具 / adapter 共用）
+ */
+export declare function readEngramView(repo: EngramRepository, id: string, tier: "catalog" | "digest" | "content" | "meta" | "synapses"): EngramView;
+export declare const engramUpdateTool: Tool<EngramUpdateToolInput, {
+    id: string;
+    version: number;
+}>;
+export declare const engramDeleteTool: Tool<EngramDeleteToolInput, {
+    id: string;
+    deleted: true;
+}>;
+export declare const engramSearchTool: Tool<EngramSearchToolInput, {
+    results: Array<{
+        id: string;
+        score: number;
+        title: string;
+        kind: string;
+        domainTags: readonly string[];
+    }>;
+    total: number;
+}>;
+export declare const engramListTool: Tool<EngramListToolInput, {
+    results: EngramCatalogEntry[];
+    total: number;
+}>;
+export declare const engramReinforceTool: Tool<EngramReinforceToolInput, {
+    id: string;
+    retrievalCount: number;
+    effectiveRetrievals: number;
+    reinforcementScore: number;
+    importance: number;
+    importanceDelta: number;
+    lastEffectiveAt: string;
+    reinforcedNeighborIds: readonly string[];
+}>;
+export declare const engramReportFailureTool: Tool<EngramReportFailureToolInput, {
+    id: string;
+    failedUses: number;
+    retrievalCount: number;
+    importance: number;
+    importanceDelta: number;
+    shouldArchive: boolean;
+    shouldForget: boolean;
+}>;
+export declare const engramArchiveTool: Tool<EngramArchiveToolInput, {
+    id: string;
+    status: "archived";
+    freshness: string;
+}>;
+export declare const engramRestoreTool: Tool<EngramRestoreToolInput, {
+    id: string;
+    status: "active";
+    freshness: string;
+    restoredFromTrash?: boolean;
+}>;
+export declare const engramForgetTool: Tool<EngramForgetToolInput, {
+    id: string;
+    status: "forgotten";
+    freshness: "forgotten";
+}>;
+export declare const engramRecomputeImportanceTool: Tool<EngramRecomputeImportanceToolInput, {
+    id: string;
+    previous?: {
+        personal: number;
+        team: number;
+        project: number;
+        network: number;
+        temporal: number;
+        composite: number;
+    };
+    next: {
+        personal: number;
+        team: number;
+        project: number;
+        network: number;
+        temporal: number;
+        composite: number;
+    };
+    persisted: boolean;
+}>;
+export declare const contradictionResolveTool: Tool<ContradictionResolveToolInput, {
+    fromId: string;
+    synapseId: string;
+    status: string;
+    resolved: true;
+}>;
+export declare const closeLearningLoopTool: Tool<CloseLearningLoopToolInput, {
+    engramId: string;
+    outcome: string;
+    importance: number;
+    importanceDelta: number;
+    hebbianTriggered: boolean;
+    provenanceTriggered: boolean;
+    shouldArchive: boolean;
+    shouldForget: boolean;
+}>;
+export declare const upgradeVerificationTool: Tool<UpgradeVerificationToolInput, {
+    engramId: string;
+    previousStatus: string | undefined;
+    newStatus: string;
+    eligible: boolean;
+    applied: boolean;
+    evidenceAppended: boolean;
+    synapseIds: readonly string[];
+    reason: string;
+    checks: ReadonlyArray<{
+        key: string;
+        required: string;
+        actual: string;
+        passed: boolean;
+    }>;
+}>;
+export declare const getEvolutionLineageTool: Tool<GetEvolutionLineageToolInput, {
+    rootId: string;
+    nodes: ReadonlyArray<{
+        engramId: string;
+        title: string;
+        kind: string;
+        depth: number;
+        relation: string;
+        viaSynapseId?: string;
+        createdAt: string;
+        createdBy: string;
+    }>;
+    edges: ReadonlyArray<{
+        from: string;
+        to: string;
+        kind: string;
+        synapseId: string;
+        direction: string;
+    }>;
+    maxDepth: number;
+    totalNodes: number;
+    origins: readonly string[];
+    terminals: readonly string[];
+    hasCycle: boolean;
+}>;
+export declare const ALL_ENGRAM_TOOLS: readonly Tool[];
+//# sourceMappingURL=engram-tools.d.ts.map

package/dist/tools/engram-tools.d.ts.map

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