@co-engram/core 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +167 -0
- package/dist/config/defaults.d.ts +45 -0
- package/dist/config/defaults.d.ts.map +1 -0
- package/dist/config/defaults.js +70 -0
- package/dist/config/defaults.js.map +1 -0
- package/dist/config/index.d.ts +84 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +230 -0
- package/dist/config/index.js.map +1 -0
- package/dist/config/types.d.ts +145 -0
- package/dist/config/types.d.ts.map +1 -0
- package/dist/config/types.js +14 -0
- package/dist/config/types.js.map +1 -0
- package/dist/contradiction/arbiter.d.ts +51 -0
- package/dist/contradiction/arbiter.d.ts.map +1 -0
- package/dist/contradiction/arbiter.js +112 -0
- package/dist/contradiction/arbiter.js.map +1 -0
- package/dist/contradiction/auto-degrade.d.ts +53 -0
- package/dist/contradiction/auto-degrade.d.ts.map +1 -0
- package/dist/contradiction/auto-degrade.js +79 -0
- package/dist/contradiction/auto-degrade.js.map +1 -0
- package/dist/contradiction/detector.d.ts +33 -0
- package/dist/contradiction/detector.d.ts.map +1 -0
- package/dist/contradiction/detector.js +76 -0
- package/dist/contradiction/detector.js.map +1 -0
- package/dist/contradiction/index.d.ts +11 -0
- package/dist/contradiction/index.d.ts.map +1 -0
- package/dist/contradiction/index.js +11 -0
- package/dist/contradiction/index.js.map +1 -0
- package/dist/contradiction/resolver.d.ts +45 -0
- package/dist/contradiction/resolver.d.ts.map +1 -0
- package/dist/contradiction/resolver.js +196 -0
- package/dist/contradiction/resolver.js.map +1 -0
- package/dist/contradiction/types.d.ts +73 -0
- package/dist/contradiction/types.d.ts.map +1 -0
- package/dist/contradiction/types.js +7 -0
- package/dist/contradiction/types.js.map +1 -0
- package/dist/dedup/dedupe.d.ts +49 -0
- package/dist/dedup/dedupe.d.ts.map +1 -0
- package/dist/dedup/dedupe.js +111 -0
- package/dist/dedup/dedupe.js.map +1 -0
- package/dist/dedup/hash.d.ts +27 -0
- package/dist/dedup/hash.d.ts.map +1 -0
- package/dist/dedup/hash.js +43 -0
- package/dist/dedup/hash.js.map +1 -0
- package/dist/dedup/index.d.ts +12 -0
- package/dist/dedup/index.d.ts.map +1 -0
- package/dist/dedup/index.js +12 -0
- package/dist/dedup/index.js.map +1 -0
- package/dist/dedup/llm-triage.d.ts +48 -0
- package/dist/dedup/llm-triage.d.ts.map +1 -0
- package/dist/dedup/llm-triage.js +100 -0
- package/dist/dedup/llm-triage.js.map +1 -0
- package/dist/dedup/merge.d.ts +41 -0
- package/dist/dedup/merge.d.ts.map +1 -0
- package/dist/dedup/merge.js +55 -0
- package/dist/dedup/merge.js.map +1 -0
- package/dist/dedup/similar.d.ts +45 -0
- package/dist/dedup/similar.d.ts.map +1 -0
- package/dist/dedup/similar.js +103 -0
- package/dist/dedup/similar.js.map +1 -0
- package/dist/dedup/types.d.ts +72 -0
- package/dist/dedup/types.d.ts.map +1 -0
- package/dist/dedup/types.js +18 -0
- package/dist/dedup/types.js.map +1 -0
- package/dist/disclosure/adaptive.d.ts +86 -0
- package/dist/disclosure/adaptive.d.ts.map +1 -0
- package/dist/disclosure/adaptive.js +196 -0
- package/dist/disclosure/adaptive.js.map +1 -0
- package/dist/disclosure/budget.d.ts +51 -0
- package/dist/disclosure/budget.d.ts.map +1 -0
- package/dist/disclosure/budget.js +91 -0
- package/dist/disclosure/budget.js.map +1 -0
- package/dist/disclosure/index.d.ts +11 -0
- package/dist/disclosure/index.d.ts.map +1 -0
- package/dist/disclosure/index.js +11 -0
- package/dist/disclosure/index.js.map +1 -0
- package/dist/disclosure/tier-loader.d.ts +58 -0
- package/dist/disclosure/tier-loader.d.ts.map +1 -0
- package/dist/disclosure/tier-loader.js +205 -0
- package/dist/disclosure/tier-loader.js.map +1 -0
- package/dist/dreaming/decay.d.ts +46 -0
- package/dist/dreaming/decay.d.ts.map +1 -0
- package/dist/dreaming/decay.js +69 -0
- package/dist/dreaming/decay.js.map +1 -0
- package/dist/dreaming/deep.d.ts +48 -0
- package/dist/dreaming/deep.d.ts.map +1 -0
- package/dist/dreaming/deep.js +41 -0
- package/dist/dreaming/deep.js.map +1 -0
- package/dist/dreaming/index.d.ts +12 -0
- package/dist/dreaming/index.d.ts.map +1 -0
- package/dist/dreaming/index.js +12 -0
- package/dist/dreaming/index.js.map +1 -0
- package/dist/dreaming/light.d.ts +54 -0
- package/dist/dreaming/light.d.ts.map +1 -0
- package/dist/dreaming/light.js +114 -0
- package/dist/dreaming/light.js.map +1 -0
- package/dist/dreaming/rem.d.ts +128 -0
- package/dist/dreaming/rem.d.ts.map +1 -0
- package/dist/dreaming/rem.js +228 -0
- package/dist/dreaming/rem.js.map +1 -0
- package/dist/dreaming/scheduler.d.ts +75 -0
- package/dist/dreaming/scheduler.d.ts.map +1 -0
- package/dist/dreaming/scheduler.js +138 -0
- package/dist/dreaming/scheduler.js.map +1 -0
- package/dist/dreaming/trash.d.ts +174 -0
- package/dist/dreaming/trash.d.ts.map +1 -0
- package/dist/dreaming/trash.js +466 -0
- package/dist/dreaming/trash.js.map +1 -0
- package/dist/evolution/category.d.ts +127 -0
- package/dist/evolution/category.d.ts.map +1 -0
- package/dist/evolution/category.js +271 -0
- package/dist/evolution/category.js.map +1 -0
- package/dist/evolution/index.d.ts +8 -0
- package/dist/evolution/index.d.ts.map +1 -0
- package/dist/evolution/index.js +8 -0
- package/dist/evolution/index.js.map +1 -0
- package/dist/evolution/triggered.d.ts +107 -0
- package/dist/evolution/triggered.d.ts.map +1 -0
- package/dist/evolution/triggered.js +278 -0
- package/dist/evolution/triggered.js.map +1 -0
- package/dist/generative/cross-pollinate.d.ts +144 -0
- package/dist/generative/cross-pollinate.d.ts.map +1 -0
- package/dist/generative/cross-pollinate.js +390 -0
- package/dist/generative/cross-pollinate.js.map +1 -0
- package/dist/generative/gap-detector.d.ts +80 -0
- package/dist/generative/gap-detector.d.ts.map +1 -0
- package/dist/generative/gap-detector.js +250 -0
- package/dist/generative/gap-detector.js.map +1 -0
- package/dist/generative/hypothesis.d.ts +161 -0
- package/dist/generative/hypothesis.d.ts.map +1 -0
- package/dist/generative/hypothesis.js +356 -0
- package/dist/generative/hypothesis.js.map +1 -0
- package/dist/generative/index.d.ts +9 -0
- package/dist/generative/index.d.ts.map +1 -0
- package/dist/generative/index.js +9 -0
- package/dist/generative/index.js.map +1 -0
- package/dist/graph/clustering.d.ts +117 -0
- package/dist/graph/clustering.d.ts.map +1 -0
- package/dist/graph/clustering.js +196 -0
- package/dist/graph/clustering.js.map +1 -0
- package/dist/graph/index.d.ts +13 -0
- package/dist/graph/index.d.ts.map +1 -0
- package/dist/graph/index.js +13 -0
- package/dist/graph/index.js.map +1 -0
- package/dist/graph/layout.d.ts +46 -0
- package/dist/graph/layout.d.ts.map +1 -0
- package/dist/graph/layout.js +269 -0
- package/dist/graph/layout.js.map +1 -0
- package/dist/graph/presets.d.ts +134 -0
- package/dist/graph/presets.d.ts.map +1 -0
- package/dist/graph/presets.js +190 -0
- package/dist/graph/presets.js.map +1 -0
- package/dist/graph/registry.d.ts +42 -0
- package/dist/graph/registry.d.ts.map +1 -0
- package/dist/graph/registry.js +158 -0
- package/dist/graph/registry.js.map +1 -0
- package/dist/graph/snapshot.d.ts +113 -0
- package/dist/graph/snapshot.d.ts.map +1 -0
- package/dist/graph/snapshot.js +194 -0
- package/dist/graph/snapshot.js.map +1 -0
- package/dist/graph/traverse.d.ts +84 -0
- package/dist/graph/traverse.d.ts.map +1 -0
- package/dist/graph/traverse.js +190 -0
- package/dist/graph/traverse.js.map +1 -0
- package/dist/graph/view-config.d.ts +99 -0
- package/dist/graph/view-config.d.ts.map +1 -0
- package/dist/graph/view-config.js +208 -0
- package/dist/graph/view-config.js.map +1 -0
- package/dist/host/detect-git-author.d.ts +26 -0
- package/dist/host/detect-git-author.d.ts.map +1 -0
- package/dist/host/detect-git-author.js +53 -0
- package/dist/host/detect-git-author.js.map +1 -0
- package/dist/host/index.d.ts +7 -0
- package/dist/host/index.d.ts.map +1 -0
- package/dist/host/index.js +7 -0
- package/dist/host/index.js.map +1 -0
- package/dist/i18n/en.d.ts +8 -0
- package/dist/i18n/en.d.ts.map +1 -0
- package/dist/i18n/en.js +211 -0
- package/dist/i18n/en.js.map +1 -0
- package/dist/i18n/field-names.d.ts +95 -0
- package/dist/i18n/field-names.d.ts.map +1 -0
- package/dist/i18n/field-names.js +329 -0
- package/dist/i18n/field-names.js.map +1 -0
- package/dist/i18n/index.d.ts +92 -0
- package/dist/i18n/index.d.ts.map +1 -0
- package/dist/i18n/index.js +135 -0
- package/dist/i18n/index.js.map +1 -0
- package/dist/i18n/types.d.ts +92 -0
- package/dist/i18n/types.d.ts.map +1 -0
- package/dist/i18n/types.js +7 -0
- package/dist/i18n/types.js.map +1 -0
- package/dist/i18n/zh.d.ts +197 -0
- package/dist/i18n/zh.d.ts.map +1 -0
- package/dist/i18n/zh.js +216 -0
- package/dist/i18n/zh.js.map +1 -0
- package/dist/importance/index.d.ts +7 -0
- package/dist/importance/index.d.ts.map +1 -0
- package/dist/importance/index.js +7 -0
- package/dist/importance/index.js.map +1 -0
- package/dist/importance/vector.d.ts +113 -0
- package/dist/importance/vector.d.ts.map +1 -0
- package/dist/importance/vector.js +202 -0
- package/dist/importance/vector.js.map +1 -0
- package/dist/index/digest-builder.d.ts +59 -0
- package/dist/index/digest-builder.d.ts.map +1 -0
- package/dist/index/digest-builder.js +195 -0
- package/dist/index/digest-builder.js.map +1 -0
- package/dist/index/graph-builder.d.ts +32 -0
- package/dist/index/graph-builder.d.ts.map +1 -0
- package/dist/index/graph-builder.js +104 -0
- package/dist/index/graph-builder.js.map +1 -0
- package/dist/index/incremental.d.ts +31 -0
- package/dist/index/incremental.d.ts.map +1 -0
- package/dist/index/incremental.js +47 -0
- package/dist/index/incremental.js.map +1 -0
- package/dist/index/index.d.ts +11 -0
- package/dist/index/index.d.ts.map +1 -0
- package/dist/index/index.js +11 -0
- package/dist/index/index.js.map +1 -0
- package/dist/index/orchestrator.d.ts +60 -0
- package/dist/index/orchestrator.d.ts.map +1 -0
- package/dist/index/orchestrator.js +99 -0
- package/dist/index/orchestrator.js.map +1 -0
- package/dist/index/types.d.ts +116 -0
- package/dist/index/types.d.ts.map +1 -0
- package/dist/index/types.js +10 -0
- package/dist/index/types.js.map +1 -0
- package/dist/index.d.ts +37 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +37 -0
- package/dist/index.js.map +1 -0
- package/dist/learning/index.d.ts +7 -0
- package/dist/learning/index.d.ts.map +1 -0
- package/dist/learning/index.js +7 -0
- package/dist/learning/index.js.map +1 -0
- package/dist/learning/loop.d.ts +79 -0
- package/dist/learning/loop.d.ts.map +1 -0
- package/dist/learning/loop.js +116 -0
- package/dist/learning/loop.js.map +1 -0
- package/dist/lifecycle/freshness.d.ts +35 -0
- package/dist/lifecycle/freshness.d.ts.map +1 -0
- package/dist/lifecycle/freshness.js +60 -0
- package/dist/lifecycle/freshness.js.map +1 -0
- package/dist/lifecycle/index.d.ts +7 -0
- package/dist/lifecycle/index.d.ts.map +1 -0
- package/dist/lifecycle/index.js +7 -0
- package/dist/lifecycle/index.js.map +1 -0
- package/dist/lineage/index.d.ts +10 -0
- package/dist/lineage/index.d.ts.map +1 -0
- package/dist/lineage/index.js +10 -0
- package/dist/lineage/index.js.map +1 -0
- package/dist/lineage/trace.d.ts +142 -0
- package/dist/lineage/trace.d.ts.map +1 -0
- package/dist/lineage/trace.js +316 -0
- package/dist/lineage/trace.js.map +1 -0
- package/dist/maintenance/engine.d.ts +78 -0
- package/dist/maintenance/engine.d.ts.map +1 -0
- package/dist/maintenance/engine.js +291 -0
- package/dist/maintenance/engine.js.map +1 -0
- package/dist/maintenance/index.d.ts +8 -0
- package/dist/maintenance/index.d.ts.map +1 -0
- package/dist/maintenance/index.js +8 -0
- package/dist/maintenance/index.js.map +1 -0
- package/dist/maintenance/types.d.ts +111 -0
- package/dist/maintenance/types.d.ts.map +1 -0
- package/dist/maintenance/types.js +24 -0
- package/dist/maintenance/types.js.map +1 -0
- package/dist/observability/audit-log.d.ts +77 -0
- package/dist/observability/audit-log.d.ts.map +1 -0
- package/dist/observability/audit-log.js +101 -0
- package/dist/observability/audit-log.js.map +1 -0
- package/dist/observability/effectiveness-tracker.d.ts +162 -0
- package/dist/observability/effectiveness-tracker.d.ts.map +1 -0
- package/dist/observability/effectiveness-tracker.js +251 -0
- package/dist/observability/effectiveness-tracker.js.map +1 -0
- package/dist/observability/index.d.ts +16 -0
- package/dist/observability/index.d.ts.map +1 -0
- package/dist/observability/index.js +16 -0
- package/dist/observability/index.js.map +1 -0
- package/dist/observability/necessity-evaluator.d.ts +116 -0
- package/dist/observability/necessity-evaluator.d.ts.map +1 -0
- package/dist/observability/necessity-evaluator.js +487 -0
- package/dist/observability/necessity-evaluator.js.map +1 -0
- package/dist/observability/proposal-engine.d.ts +224 -0
- package/dist/observability/proposal-engine.d.ts.map +1 -0
- package/dist/observability/proposal-engine.js +651 -0
- package/dist/observability/proposal-engine.js.map +1 -0
- package/dist/perspectives/index.d.ts +7 -0
- package/dist/perspectives/index.d.ts.map +1 -0
- package/dist/perspectives/index.js +7 -0
- package/dist/perspectives/index.js.map +1 -0
- package/dist/perspectives/multi-view.d.ts +81 -0
- package/dist/perspectives/multi-view.d.ts.map +1 -0
- package/dist/perspectives/multi-view.js +221 -0
- package/dist/perspectives/multi-view.js.map +1 -0
- package/dist/prompt-builder/builder.d.ts +47 -0
- package/dist/prompt-builder/builder.d.ts.map +1 -0
- package/dist/prompt-builder/builder.js +136 -0
- package/dist/prompt-builder/builder.js.map +1 -0
- package/dist/prompt-builder/index.d.ts +8 -0
- package/dist/prompt-builder/index.d.ts.map +1 -0
- package/dist/prompt-builder/index.js +8 -0
- package/dist/prompt-builder/index.js.map +1 -0
- package/dist/prompt-builder/types.d.ts +42 -0
- package/dist/prompt-builder/types.d.ts.map +1 -0
- package/dist/prompt-builder/types.js +10 -0
- package/dist/prompt-builder/types.js.map +1 -0
- package/dist/prompt-signals/cache.d.ts +36 -0
- package/dist/prompt-signals/cache.d.ts.map +1 -0
- package/dist/prompt-signals/cache.js +70 -0
- package/dist/prompt-signals/cache.js.map +1 -0
- package/dist/prompt-signals/index.d.ts +12 -0
- package/dist/prompt-signals/index.d.ts.map +1 -0
- package/dist/prompt-signals/index.js +11 -0
- package/dist/prompt-signals/index.js.map +1 -0
- package/dist/prompt-signals/stats.d.ts +45 -0
- package/dist/prompt-signals/stats.d.ts.map +1 -0
- package/dist/prompt-signals/stats.js +119 -0
- package/dist/prompt-signals/stats.js.map +1 -0
- package/dist/prompt-signals/types.d.ts +53 -0
- package/dist/prompt-signals/types.d.ts.map +1 -0
- package/dist/prompt-signals/types.js +34 -0
- package/dist/prompt-signals/types.js.map +1 -0
- package/dist/provenance/index.d.ts +7 -0
- package/dist/provenance/index.d.ts.map +1 -0
- package/dist/provenance/index.js +7 -0
- package/dist/provenance/index.js.map +1 -0
- package/dist/provenance/reliability.d.ts +133 -0
- package/dist/provenance/reliability.d.ts.map +1 -0
- package/dist/provenance/reliability.js +213 -0
- package/dist/provenance/reliability.js.map +1 -0
- package/dist/reinforcement/config.d.ts +34 -0
- package/dist/reinforcement/config.d.ts.map +1 -0
- package/dist/reinforcement/config.js +43 -0
- package/dist/reinforcement/config.js.map +1 -0
- package/dist/reinforcement/index.d.ts +12 -0
- package/dist/reinforcement/index.d.ts.map +1 -0
- package/dist/reinforcement/index.js +12 -0
- package/dist/reinforcement/index.js.map +1 -0
- package/dist/reinforcement/ltd.d.ts +59 -0
- package/dist/reinforcement/ltd.d.ts.map +1 -0
- package/dist/reinforcement/ltd.js +90 -0
- package/dist/reinforcement/ltd.js.map +1 -0
- package/dist/reinforcement/ltp.d.ts +63 -0
- package/dist/reinforcement/ltp.d.ts.map +1 -0
- package/dist/reinforcement/ltp.js +99 -0
- package/dist/reinforcement/ltp.js.map +1 -0
- package/dist/reinforcement/related.d.ts +39 -0
- package/dist/reinforcement/related.d.ts.map +1 -0
- package/dist/reinforcement/related.js +92 -0
- package/dist/reinforcement/related.js.map +1 -0
- package/dist/retrieval/filter.d.ts +18 -0
- package/dist/retrieval/filter.d.ts.map +1 -0
- package/dist/retrieval/filter.js +68 -0
- package/dist/retrieval/filter.js.map +1 -0
- package/dist/retrieval/fts.d.ts +44 -0
- package/dist/retrieval/fts.d.ts.map +1 -0
- package/dist/retrieval/fts.js +120 -0
- package/dist/retrieval/fts.js.map +1 -0
- package/dist/retrieval/index.d.ts +10 -0
- package/dist/retrieval/index.d.ts.map +1 -0
- package/dist/retrieval/index.js +10 -0
- package/dist/retrieval/index.js.map +1 -0
- package/dist/retrieval/orchestrator.d.ts +78 -0
- package/dist/retrieval/orchestrator.d.ts.map +1 -0
- package/dist/retrieval/orchestrator.js +156 -0
- package/dist/retrieval/orchestrator.js.map +1 -0
- package/dist/retrieval/scoring.d.ts +105 -0
- package/dist/retrieval/scoring.d.ts.map +1 -0
- package/dist/retrieval/scoring.js +165 -0
- package/dist/retrieval/scoring.js.map +1 -0
- package/dist/signals/extract.d.ts +98 -0
- package/dist/signals/extract.d.ts.map +1 -0
- package/dist/signals/extract.js +388 -0
- package/dist/signals/extract.js.map +1 -0
- package/dist/signals/file-sink.d.ts +81 -0
- package/dist/signals/file-sink.d.ts.map +1 -0
- package/dist/signals/file-sink.js +227 -0
- package/dist/signals/file-sink.js.map +1 -0
- package/dist/signals/index.d.ts +12 -0
- package/dist/signals/index.d.ts.map +1 -0
- package/dist/signals/index.js +12 -0
- package/dist/signals/index.js.map +1 -0
- package/dist/signals/rpe.d.ts +60 -0
- package/dist/signals/rpe.d.ts.map +1 -0
- package/dist/signals/rpe.js +68 -0
- package/dist/signals/rpe.js.map +1 -0
- package/dist/signals/types.d.ts +80 -0
- package/dist/signals/types.d.ts.map +1 -0
- package/dist/signals/types.js +14 -0
- package/dist/signals/types.js.map +1 -0
- package/dist/storage/engram-index.d.ts +73 -0
- package/dist/storage/engram-index.d.ts.map +1 -0
- package/dist/storage/engram-index.js +215 -0
- package/dist/storage/engram-index.js.map +1 -0
- package/dist/storage/engram-store.d.ts +147 -0
- package/dist/storage/engram-store.d.ts.map +1 -0
- package/dist/storage/engram-store.js +221 -0
- package/dist/storage/engram-store.js.map +1 -0
- package/dist/storage/git-stage.d.ts +56 -0
- package/dist/storage/git-stage.d.ts.map +1 -0
- package/dist/storage/git-stage.js +147 -0
- package/dist/storage/git-stage.js.map +1 -0
- package/dist/storage/git.d.ts +57 -0
- package/dist/storage/git.d.ts.map +1 -0
- package/dist/storage/git.js +156 -0
- package/dist/storage/git.js.map +1 -0
- package/dist/storage/hash.d.ts +23 -0
- package/dist/storage/hash.d.ts.map +1 -0
- package/dist/storage/hash.js +31 -0
- package/dist/storage/hash.js.map +1 -0
- package/dist/storage/index.d.ts +14 -0
- package/dist/storage/index.d.ts.map +1 -0
- package/dist/storage/index.js +14 -0
- package/dist/storage/index.js.map +1 -0
- package/dist/storage/path.d.ts +51 -0
- package/dist/storage/path.d.ts.map +1 -0
- package/dist/storage/path.js +72 -0
- package/dist/storage/path.js.map +1 -0
- package/dist/storage/repository.d.ts +342 -0
- package/dist/storage/repository.d.ts.map +1 -0
- package/dist/storage/repository.js +1221 -0
- package/dist/storage/repository.js.map +1 -0
- package/dist/storage/synapse-store.d.ts +113 -0
- package/dist/storage/synapse-store.d.ts.map +1 -0
- package/dist/storage/synapse-store.js +279 -0
- package/dist/storage/synapse-store.js.map +1 -0
- package/dist/tools/doctor-tools.d.ts +53 -0
- package/dist/tools/doctor-tools.d.ts.map +1 -0
- package/dist/tools/doctor-tools.js +97 -0
- package/dist/tools/doctor-tools.js.map +1 -0
- package/dist/tools/engram-tools.d.ts +166 -0
- package/dist/tools/engram-tools.d.ts.map +1 -0
- package/dist/tools/engram-tools.js +834 -0
- package/dist/tools/engram-tools.js.map +1 -0
- package/dist/tools/index.d.ts +16 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +16 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/llm-descriptions.d.ts +61 -0
- package/dist/tools/llm-descriptions.d.ts.map +1 -0
- package/dist/tools/llm-descriptions.js +556 -0
- package/dist/tools/llm-descriptions.js.map +1 -0
- package/dist/tools/proposal-tools.d.ts +40 -0
- package/dist/tools/proposal-tools.d.ts.map +1 -0
- package/dist/tools/proposal-tools.js +99 -0
- package/dist/tools/proposal-tools.js.map +1 -0
- package/dist/tools/registry.d.ts +30 -0
- package/dist/tools/registry.d.ts.map +1 -0
- package/dist/tools/registry.js +43 -0
- package/dist/tools/registry.js.map +1 -0
- package/dist/tools/schemas.d.ts +715 -0
- package/dist/tools/schemas.d.ts.map +1 -0
- package/dist/tools/schemas.js +383 -0
- package/dist/tools/schemas.js.map +1 -0
- package/dist/tools/skill-tools.d.ts +26 -0
- package/dist/tools/skill-tools.d.ts.map +1 -0
- package/dist/tools/skill-tools.js +84 -0
- package/dist/tools/skill-tools.js.map +1 -0
- package/dist/tools/synapse-tools.d.ts +28 -0
- package/dist/tools/synapse-tools.d.ts.map +1 -0
- package/dist/tools/synapse-tools.js +177 -0
- package/dist/tools/synapse-tools.js.map +1 -0
- package/dist/tools/tool.d.ts +84 -0
- package/dist/tools/tool.d.ts.map +1 -0
- package/dist/tools/tool.js +22 -0
- package/dist/tools/tool.js.map +1 -0
- package/dist/tools/wrapped.d.ts +28 -0
- package/dist/tools/wrapped.d.ts.map +1 -0
- package/dist/tools/wrapped.js +172 -0
- package/dist/tools/wrapped.js.map +1 -0
- package/dist/types/disclosure.d.ts +70 -0
- package/dist/types/disclosure.d.ts.map +1 -0
- package/dist/types/disclosure.js +9 -0
- package/dist/types/disclosure.js.map +1 -0
- package/dist/types/engram.d.ts +203 -0
- package/dist/types/engram.d.ts.map +1 -0
- package/dist/types/engram.js +7 -0
- package/dist/types/engram.js.map +1 -0
- package/dist/types/index.d.ts +15 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +15 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/intention.d.ts +91 -0
- package/dist/types/intention.d.ts.map +1 -0
- package/dist/types/intention.js +9 -0
- package/dist/types/intention.js.map +1 -0
- package/dist/types/repository-types.d.ts +113 -0
- package/dist/types/repository-types.d.ts.map +1 -0
- package/dist/types/repository-types.js +18 -0
- package/dist/types/repository-types.js.map +1 -0
- package/dist/types/scene.d.ts +52 -0
- package/dist/types/scene.d.ts.map +1 -0
- package/dist/types/scene.js +12 -0
- package/dist/types/scene.js.map +1 -0
- package/dist/types/skill.d.ts +107 -0
- package/dist/types/skill.d.ts.map +1 -0
- package/dist/types/skill.js +10 -0
- package/dist/types/skill.js.map +1 -0
- package/dist/types/slugify.d.ts +34 -0
- package/dist/types/slugify.d.ts.map +1 -0
- package/dist/types/slugify.js +55 -0
- package/dist/types/slugify.js.map +1 -0
- package/dist/types/synapse-id.d.ts +22 -0
- package/dist/types/synapse-id.d.ts.map +1 -0
- package/dist/types/synapse-id.js +34 -0
- package/dist/types/synapse-id.js.map +1 -0
- package/dist/types/synapse.d.ts +99 -0
- package/dist/types/synapse.d.ts.map +1 -0
- package/dist/types/synapse.js +9 -0
- package/dist/types/synapse.js.map +1 -0
- package/dist/verification/index.d.ts +11 -0
- package/dist/verification/index.d.ts.map +1 -0
- package/dist/verification/index.js +11 -0
- package/dist/verification/index.js.map +1 -0
- package/dist/verification/metacognition.d.ts +102 -0
- package/dist/verification/metacognition.d.ts.map +1 -0
- package/dist/verification/metacognition.js +284 -0
- package/dist/verification/metacognition.js.map +1 -0
- package/dist/verification/state-machine.d.ts +77 -0
- package/dist/verification/state-machine.d.ts.map +1 -0
- package/dist/verification/state-machine.js +126 -0
- package/dist/verification/state-machine.js.map +1 -0
- package/dist/verification/upgrade.d.ts +133 -0
- package/dist/verification/upgrade.d.ts.map +1 -0
- package/dist/verification/upgrade.js +364 -0
- package/dist/verification/upgrade.js.map +1 -0
- package/package.json +70 -0
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Synapse 工具集(P0)
|
|
3
|
+
*
|
|
4
|
+
* 4 个工具:
|
|
5
|
+
* - synapse_create: 创建(含双方缓存更新)
|
|
6
|
+
* - synapse_get: 读取单条
|
|
7
|
+
* - synapse_delete: 删除(同步更新双方缓存)
|
|
8
|
+
* - synapse_list: 列出某 engram 的所有 synapses(出/入/双向)
|
|
9
|
+
*
|
|
10
|
+
* @module @co-engram/core/tools
|
|
11
|
+
*/
|
|
12
|
+
import { validateInput } from "./tool.js";
|
|
13
|
+
import { randomUUID } from "node:crypto";
|
|
14
|
+
import { SynapseCreateInputSchema, SynapseGetInputSchema, SynapseDeleteInputSchema, SynapseListInputSchema, } from "./schemas.js";
|
|
15
|
+
// ============================================================
|
|
16
|
+
// synapse_create
|
|
17
|
+
// ============================================================
|
|
18
|
+
export const synapseCreateTool = {
|
|
19
|
+
name: "synapse_create",
|
|
20
|
+
description: '在两个 Engram 之间创建 Synapse(连接)。自动更新双方的 incoming/outgoing 缓存。createdBy 可选,缺省时回退到 ToolContext.defaultCreatedBy,再缺省回退到 "unknown"。',
|
|
21
|
+
inputSchema: SynapseCreateInputSchema,
|
|
22
|
+
execute(input, ctx) {
|
|
23
|
+
const parsed = validateInput(SynapseCreateInputSchema, input);
|
|
24
|
+
const createdBy = parsed.createdBy ?? ctx.defaultCreatedBy ?? "unknown";
|
|
25
|
+
// 校验端点存在
|
|
26
|
+
if (!ctx.repository.exists(parsed.from)) {
|
|
27
|
+
throw new Error(`Source engram not found: ${parsed.from}`);
|
|
28
|
+
}
|
|
29
|
+
if (!ctx.repository.exists(parsed.to)) {
|
|
30
|
+
throw new Error(`Target engram not found: ${parsed.to}`);
|
|
31
|
+
}
|
|
32
|
+
if (parsed.from === parsed.to) {
|
|
33
|
+
throw new Error("Self-synapse not allowed in P0");
|
|
34
|
+
}
|
|
35
|
+
const timestamp = new Date().toISOString();
|
|
36
|
+
const synapseId = randomUUID();
|
|
37
|
+
const evidence = (parsed.evidence ?? []).map((e) => ({
|
|
38
|
+
description: e.description,
|
|
39
|
+
source: e.source,
|
|
40
|
+
confidence: e.confidence,
|
|
41
|
+
addedAt: timestamp,
|
|
42
|
+
addedBy: e.addedBy,
|
|
43
|
+
}));
|
|
44
|
+
const synapse = {
|
|
45
|
+
id: synapseId,
|
|
46
|
+
from: parsed.from,
|
|
47
|
+
to: parsed.to,
|
|
48
|
+
kind: parsed.kind,
|
|
49
|
+
weight: parsed.weight,
|
|
50
|
+
direction: parsed.direction,
|
|
51
|
+
evidence,
|
|
52
|
+
createdBy,
|
|
53
|
+
createdAt: timestamp,
|
|
54
|
+
updatedAt: timestamp,
|
|
55
|
+
retrievalWeight: parsed.weight,
|
|
56
|
+
sourceSemantic: parsed.sourceSemantic,
|
|
57
|
+
targetSemantic: parsed.targetSemantic,
|
|
58
|
+
};
|
|
59
|
+
const stored = ctx.repository.addOutgoingSynapse(parsed.from, synapse);
|
|
60
|
+
const storedId = stored.id;
|
|
61
|
+
// audit:synapse_create 复用 'create' action,通过 synapseId 标记是 synapse
|
|
62
|
+
ctx.auditLog?.append({
|
|
63
|
+
actor: "user",
|
|
64
|
+
action: "create",
|
|
65
|
+
engramId: parsed.from,
|
|
66
|
+
metadata: {
|
|
67
|
+
target: "synapse",
|
|
68
|
+
synapseId: storedId,
|
|
69
|
+
from: parsed.from,
|
|
70
|
+
to: parsed.to,
|
|
71
|
+
kind: parsed.kind,
|
|
72
|
+
weight: parsed.weight,
|
|
73
|
+
direction: parsed.direction,
|
|
74
|
+
createdBy,
|
|
75
|
+
},
|
|
76
|
+
});
|
|
77
|
+
// M1: contradicts synapse 触发有效性信号(双方都记一次)
|
|
78
|
+
if (parsed.kind === "contradicts") {
|
|
79
|
+
ctx.auditLog?.append({
|
|
80
|
+
actor: "user",
|
|
81
|
+
action: "contradicted",
|
|
82
|
+
engramId: parsed.from,
|
|
83
|
+
metadata: { synapseId: storedId, contradictedBy: parsed.to, createdBy },
|
|
84
|
+
});
|
|
85
|
+
ctx.auditLog?.append({
|
|
86
|
+
actor: "user",
|
|
87
|
+
action: "contradicted",
|
|
88
|
+
engramId: parsed.to,
|
|
89
|
+
metadata: {
|
|
90
|
+
synapseId: storedId,
|
|
91
|
+
contradictedBy: parsed.from,
|
|
92
|
+
createdBy,
|
|
93
|
+
},
|
|
94
|
+
});
|
|
95
|
+
}
|
|
96
|
+
return { id: storedId };
|
|
97
|
+
},
|
|
98
|
+
};
|
|
99
|
+
// ============================================================
|
|
100
|
+
// synapse_get
|
|
101
|
+
// ============================================================
|
|
102
|
+
export const synapseGetTool = {
|
|
103
|
+
name: "synapse_get",
|
|
104
|
+
description: "读取单条 Synapse(通过 from engramId + synapseId)。",
|
|
105
|
+
inputSchema: SynapseGetInputSchema,
|
|
106
|
+
execute(input, ctx) {
|
|
107
|
+
const parsed = validateInput(SynapseGetInputSchema, input);
|
|
108
|
+
const file = ctx.repository.readSynapses(parsed.from);
|
|
109
|
+
const found = file.outgoing.find((s) => s.id === parsed.synapseId);
|
|
110
|
+
if (!found) {
|
|
111
|
+
throw new Error(`Synapse not found: from=${parsed.from} synapseId=${parsed.synapseId}`);
|
|
112
|
+
}
|
|
113
|
+
return found;
|
|
114
|
+
},
|
|
115
|
+
};
|
|
116
|
+
// ============================================================
|
|
117
|
+
// synapse_delete
|
|
118
|
+
// ============================================================
|
|
119
|
+
export const synapseDeleteTool = {
|
|
120
|
+
name: "synapse_delete",
|
|
121
|
+
description: "删除一条 Synapse(同步更新双方缓存)。",
|
|
122
|
+
inputSchema: SynapseDeleteInputSchema,
|
|
123
|
+
execute(input, ctx) {
|
|
124
|
+
const parsed = validateInput(SynapseDeleteInputSchema, input);
|
|
125
|
+
// 删前先读出原 synapse 信息(audit 用)
|
|
126
|
+
const before = ctx.repository
|
|
127
|
+
.readSynapses(parsed.from)
|
|
128
|
+
.outgoing.find((s) => s.id === parsed.synapseId);
|
|
129
|
+
ctx.repository.removeOutgoingSynapse(parsed.from, parsed.synapseId);
|
|
130
|
+
ctx.auditLog?.append({
|
|
131
|
+
actor: "user",
|
|
132
|
+
action: "purge",
|
|
133
|
+
engramId: parsed.from,
|
|
134
|
+
metadata: {
|
|
135
|
+
target: "synapse",
|
|
136
|
+
synapseId: parsed.synapseId,
|
|
137
|
+
from: parsed.from,
|
|
138
|
+
to: before?.to,
|
|
139
|
+
kind: before?.kind,
|
|
140
|
+
weight: before?.weight,
|
|
141
|
+
direction: before?.direction,
|
|
142
|
+
},
|
|
143
|
+
});
|
|
144
|
+
return { id: parsed.synapseId, deleted: true };
|
|
145
|
+
},
|
|
146
|
+
};
|
|
147
|
+
// ============================================================
|
|
148
|
+
// synapse_list
|
|
149
|
+
// ============================================================
|
|
150
|
+
export const synapseListTool = {
|
|
151
|
+
name: "synapse_list",
|
|
152
|
+
description: "列出某 Engram 的所有 Synapses(出边 / 入边 / 双向)。",
|
|
153
|
+
inputSchema: SynapseListInputSchema,
|
|
154
|
+
execute(input, ctx) {
|
|
155
|
+
const parsed = validateInput(SynapseListInputSchema, input);
|
|
156
|
+
const outgoing = parsed.direction === "outgoing" || parsed.direction === "both"
|
|
157
|
+
? ctx.repository.readSynapses(parsed.engramId).outgoing
|
|
158
|
+
: [];
|
|
159
|
+
const incoming = parsed.direction === "incoming" || parsed.direction === "both"
|
|
160
|
+
? ctx.repository
|
|
161
|
+
.collectAllSynapses()
|
|
162
|
+
.filter(({ synapse }) => synapse.to === parsed.engramId)
|
|
163
|
+
.map(({ synapse }) => synapse)
|
|
164
|
+
: [];
|
|
165
|
+
return {
|
|
166
|
+
outgoing: [...outgoing],
|
|
167
|
+
incoming,
|
|
168
|
+
};
|
|
169
|
+
},
|
|
170
|
+
};
|
|
171
|
+
export const ALL_SYNAPSE_TOOLS = [
|
|
172
|
+
synapseCreateTool,
|
|
173
|
+
synapseGetTool,
|
|
174
|
+
synapseDeleteTool,
|
|
175
|
+
synapseListTool,
|
|
176
|
+
];
|
|
177
|
+
//# sourceMappingURL=synapse-tools.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"synapse-tools.js","sourceRoot":"","sources":["../../src/tools/synapse-tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工具协议
|
|
3
|
+
*
|
|
4
|
+
* 统一的 Tool 接口,所有 Self-Editing Tool 都实现此接口。
|
|
5
|
+
* host adapter(OpenClaw / MCP)只需把 Tool 包装为各自的工具调用格式。
|
|
6
|
+
*
|
|
7
|
+
* @module @co-engram/core/tools
|
|
8
|
+
*/
|
|
9
|
+
import type { ZodTypeAny } from "zod";
|
|
10
|
+
/**
|
|
11
|
+
* 工具元信息(可暴露给 host 用于注册)
|
|
12
|
+
*/
|
|
13
|
+
export interface ToolMeta {
|
|
14
|
+
/** 工具名(snake_case,宿主中立) */
|
|
15
|
+
readonly name: string;
|
|
16
|
+
/** 工具描述(host 可展示给 LLM) */
|
|
17
|
+
readonly description: string;
|
|
18
|
+
/** 输入 schema(JSON Schema 友好,host 可直接转 MCP inputSchema) */
|
|
19
|
+
readonly inputSchema: ZodTypeAny;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* 工具执行上下文
|
|
23
|
+
*
|
|
24
|
+
* 包含 repository / index / graph 等运行时依赖,
|
|
25
|
+
* 由 host 在调用时注入(依赖注入,避免工具直接 new)。
|
|
26
|
+
*/
|
|
27
|
+
export interface ToolContext {
|
|
28
|
+
readonly repository: import("../storage/repository.js").EngramRepository;
|
|
29
|
+
readonly indexOrchestrator?: import("../index/orchestrator.js").IndexOrchestrator;
|
|
30
|
+
readonly searchOrchestrator?: import("../retrieval/orchestrator.js").SearchOrchestrator;
|
|
31
|
+
readonly graphTraverser?: import("../graph/traverse.js").GraphTraverser;
|
|
32
|
+
/**
|
|
33
|
+
* 当前会话 id(用于 behavioral signals 追踪)。
|
|
34
|
+
*
|
|
35
|
+
* 宿主每次工具调用注入新 UUID;维护引擎用 sliding window 替代会话边界。
|
|
36
|
+
*/
|
|
37
|
+
readonly sessionId?: string;
|
|
38
|
+
/**
|
|
39
|
+
* 信号收集器(行为追踪)。
|
|
40
|
+
*
|
|
41
|
+
* 如果注入,tools/wrapped.ts 包装的工具会自动 append ToolCallEvent;
|
|
42
|
+
* 否则工具正常运行(不影响功能)。
|
|
43
|
+
*/
|
|
44
|
+
readonly signalSink?: import("../signals/types.js").SignalSink;
|
|
45
|
+
/**
|
|
46
|
+
* 审计日志(可选,状态变更 + 有效性信号)。
|
|
47
|
+
*
|
|
48
|
+
* 如果注入,工具会在 create/update/reinforce/report_failure 等关键路径
|
|
49
|
+
* 自动 append 审计事件;否则不记录。
|
|
50
|
+
*/
|
|
51
|
+
readonly auditLog?: import("../observability/audit-log.js").AuditLog;
|
|
52
|
+
/**
|
|
53
|
+
* 有效性追踪器(可选)。
|
|
54
|
+
*
|
|
55
|
+
* engram_search 命中时 openWindow;engram_reinforce 时 closeAsEffective;
|
|
56
|
+
* engram_report_failure 时 closeAsFailure。
|
|
57
|
+
*/
|
|
58
|
+
readonly effectivenessTracker?: import("../observability/effectiveness-tracker.js").EffectivenessTracker;
|
|
59
|
+
/**
|
|
60
|
+
* 候选提案引擎(可选,用于 engram_list_proposals 等工具)。
|
|
61
|
+
*/
|
|
62
|
+
readonly proposalEngine?: import("../observability/proposal-engine.js").ProposalEngine;
|
|
63
|
+
/**
|
|
64
|
+
* 默认作者标识(可选,用于 engram_create 的 createdBy 回退)。
|
|
65
|
+
*
|
|
66
|
+
* 工具调用方未显式传 createdBy 时,工具会用此值;
|
|
67
|
+
* 若此值也缺省,最终回退到 'unknown'。
|
|
68
|
+
* MCP 适配器从 CO_ENGRAM_DEFAULT_CREATED_BY 环境变量或持久化配置读取;
|
|
69
|
+
* OpenClaw 适配器从 plugin config.defaultCreatedBy 读取。
|
|
70
|
+
*/
|
|
71
|
+
readonly defaultCreatedBy?: string;
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* 统一 Tool 接口
|
|
75
|
+
*/
|
|
76
|
+
export interface Tool<I = unknown, O = unknown> extends ToolMeta {
|
|
77
|
+
/** 执行工具,返回结果或抛错 */
|
|
78
|
+
execute(input: I, ctx: ToolContext): Promise<O> | O;
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* 校验并解析输入(host adapter 通常在 execute 前调用)
|
|
82
|
+
*/
|
|
83
|
+
export declare function validateInput<T>(schema: ZodTypeAny, raw: unknown): T;
|
|
84
|
+
//# sourceMappingURL=tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,0BAA0B,EAAE,gBAAgB,CAAC;IACzE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,0BAA0B,EAAE,iBAAiB,CAAC;IAClF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,8BAA8B,EAAE,kBAAkB,CAAC;IACxF,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,sBAAsB,EAAE,cAAc,CAAC;IACxE;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,qBAAqB,EAAE,UAAU,CAAC;IAC/D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,+BAA+B,EAAE,QAAQ,CAAC;IACrE;;;;;OAKG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,2CAA2C,EAAE,oBAAoB,CAAC;IACzG;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,qCAAqC,EAAE,cAAc,CAAC;IACvF;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,QAAQ;IAC9D,mBAAmB;IACnB,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CASpE"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工具协议
|
|
3
|
+
*
|
|
4
|
+
* 统一的 Tool 接口,所有 Self-Editing Tool 都实现此接口。
|
|
5
|
+
* host adapter(OpenClaw / MCP)只需把 Tool 包装为各自的工具调用格式。
|
|
6
|
+
*
|
|
7
|
+
* @module @co-engram/core/tools
|
|
8
|
+
*/
|
|
9
|
+
/**
|
|
10
|
+
* 校验并解析输入(host adapter 通常在 execute 前调用)
|
|
11
|
+
*/
|
|
12
|
+
export function validateInput(schema, raw) {
|
|
13
|
+
const result = schema.safeParse(raw);
|
|
14
|
+
if (!result.success) {
|
|
15
|
+
const issues = result.error.issues
|
|
16
|
+
.map((i) => `${i.path.join(".")}: ${i.message}`)
|
|
17
|
+
.join("; ");
|
|
18
|
+
throw new Error(`Invalid input: ${issues}`);
|
|
19
|
+
}
|
|
20
|
+
return result.data;
|
|
21
|
+
}
|
|
22
|
+
//# sourceMappingURL=tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tools/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6EH;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,MAAkB,EAAE,GAAY;IAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC,IAAS,CAAC;AAC1B,CAAC"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工具包装层:行为信号收集(P4 A.2)
|
|
3
|
+
*
|
|
4
|
+
* 在 Tool.execute 前后插入 SignalSink.append,自动捕获工具调用事件,
|
|
5
|
+
* 不依赖 agent 主动上报。
|
|
6
|
+
*
|
|
7
|
+
* 工作流:
|
|
8
|
+
* 1. host 创建 ToolContext 时注入 sessionId + signalSink
|
|
9
|
+
* 2. 调 wrapToolWithSignalSink(tool) 得到包装版本
|
|
10
|
+
* 3. 包装版本在 execute 前后 append ToolCallEvent
|
|
11
|
+
*
|
|
12
|
+
* 关键:append 是 fire-and-forget;失败不阻塞工具执行本身。
|
|
13
|
+
*
|
|
14
|
+
* @module @co-engram/core/tools
|
|
15
|
+
*/
|
|
16
|
+
import type { Tool } from "./tool.js";
|
|
17
|
+
/**
|
|
18
|
+
* 包装一个工具:自动收集行为信号
|
|
19
|
+
*
|
|
20
|
+
* @param tool 原始工具
|
|
21
|
+
* @returns 包装后的工具(接口相同)
|
|
22
|
+
*/
|
|
23
|
+
export declare function wrapToolWithSignalSink<I, O>(tool: Tool<I, O>): Tool<I, O>;
|
|
24
|
+
/**
|
|
25
|
+
* 批量包装工具注册表里的所有工具
|
|
26
|
+
*/
|
|
27
|
+
export declare function wrapAllToolsWithSignalSink<I, O>(tools: readonly Tool<I, O>[]): readonly Tool<I, O>[];
|
|
28
|
+
//# sourceMappingURL=wrapped.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"wrapped.d.ts","sourceRoot":"","sources":["../../src/tools/wrapped.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,WAAW,CAAC;AAGnD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAuCzE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,CAAC,EAC7C,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAC3B,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAEvB"}
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工具包装层:行为信号收集(P4 A.2)
|
|
3
|
+
*
|
|
4
|
+
* 在 Tool.execute 前后插入 SignalSink.append,自动捕获工具调用事件,
|
|
5
|
+
* 不依赖 agent 主动上报。
|
|
6
|
+
*
|
|
7
|
+
* 工作流:
|
|
8
|
+
* 1. host 创建 ToolContext 时注入 sessionId + signalSink
|
|
9
|
+
* 2. 调 wrapToolWithSignalSink(tool) 得到包装版本
|
|
10
|
+
* 3. 包装版本在 execute 前后 append ToolCallEvent
|
|
11
|
+
*
|
|
12
|
+
* 关键:append 是 fire-and-forget;失败不阻塞工具执行本身。
|
|
13
|
+
*
|
|
14
|
+
* @module @co-engram/core/tools
|
|
15
|
+
*/
|
|
16
|
+
import { randomUUID } from "node:crypto";
|
|
17
|
+
/**
|
|
18
|
+
* 包装一个工具:自动收集行为信号
|
|
19
|
+
*
|
|
20
|
+
* @param tool 原始工具
|
|
21
|
+
* @returns 包装后的工具(接口相同)
|
|
22
|
+
*/
|
|
23
|
+
export function wrapToolWithSignalSink(tool) {
|
|
24
|
+
return {
|
|
25
|
+
...tool,
|
|
26
|
+
async execute(input, ctx) {
|
|
27
|
+
const startedAt = Date.now();
|
|
28
|
+
let result;
|
|
29
|
+
let error;
|
|
30
|
+
let retrievedEngramIds;
|
|
31
|
+
try {
|
|
32
|
+
result = await tool.execute(input, ctx);
|
|
33
|
+
retrievedEngramIds = extractEngramIds(tool.name, input, result);
|
|
34
|
+
return result;
|
|
35
|
+
}
|
|
36
|
+
catch (err) {
|
|
37
|
+
error = err;
|
|
38
|
+
throw err;
|
|
39
|
+
}
|
|
40
|
+
finally {
|
|
41
|
+
// 即使出错也记录事件(失败也是信号)
|
|
42
|
+
if (ctx.signalSink) {
|
|
43
|
+
const event = {
|
|
44
|
+
toolName: tool.name,
|
|
45
|
+
input: sanitizeInput(input),
|
|
46
|
+
outputSummary: error
|
|
47
|
+
? `error: ${summarizeError(error)}`
|
|
48
|
+
: summarizeResult(result),
|
|
49
|
+
retrievedEngramIds,
|
|
50
|
+
sessionId: ctx.sessionId ?? randomUUID(),
|
|
51
|
+
at: startedAt,
|
|
52
|
+
};
|
|
53
|
+
// fire-and-forget:失败不阻塞工具调用本身
|
|
54
|
+
try {
|
|
55
|
+
ctx.signalSink.append(event);
|
|
56
|
+
}
|
|
57
|
+
catch {
|
|
58
|
+
// intentional no-op
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
},
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* 批量包装工具注册表里的所有工具
|
|
67
|
+
*/
|
|
68
|
+
export function wrapAllToolsWithSignalSink(tools) {
|
|
69
|
+
return tools.map((t) => wrapToolWithSignalSink(t));
|
|
70
|
+
}
|
|
71
|
+
// ============================================================
|
|
72
|
+
// 工具特定的输出解析
|
|
73
|
+
// ============================================================
|
|
74
|
+
/**
|
|
75
|
+
* 从工具调用结果中提取涉及的 engram id 列表
|
|
76
|
+
*
|
|
77
|
+
* 不同工具的输出结构不同:
|
|
78
|
+
* - engram_get / engram_create:直接返回 EngramView / { id }
|
|
79
|
+
* - engram_search / engram_list:返回 { hits: [{ id }] } 或 [{ id }]
|
|
80
|
+
* - synapse_create:返回 { id }(synapse id,不是 engram id)
|
|
81
|
+
* - 其他:无
|
|
82
|
+
*/
|
|
83
|
+
function extractEngramIds(toolName, input, result) {
|
|
84
|
+
if (result === null || result === undefined)
|
|
85
|
+
return undefined;
|
|
86
|
+
// engram_get / engram_update:input.id 即为 engram id
|
|
87
|
+
if (toolName === "engram_get" || toolName === "engram_update") {
|
|
88
|
+
const id = input?.id;
|
|
89
|
+
return typeof id === "string" ? [id] : undefined;
|
|
90
|
+
}
|
|
91
|
+
// engram_create:result.id 即为新建 engram id
|
|
92
|
+
if (toolName === "engram_create") {
|
|
93
|
+
const id = result?.id;
|
|
94
|
+
return typeof id === "string" ? [id] : undefined;
|
|
95
|
+
}
|
|
96
|
+
// engram_search / engram_list:result.hits[].id 或 result[].id
|
|
97
|
+
if (toolName === "engram_search" || toolName === "engram_list") {
|
|
98
|
+
if (typeof result === "object" &&
|
|
99
|
+
result !== null &&
|
|
100
|
+
!Array.isArray(result)) {
|
|
101
|
+
const hits = result.hits;
|
|
102
|
+
if (Array.isArray(hits)) {
|
|
103
|
+
const ids = hits
|
|
104
|
+
.map((h) => h?.id)
|
|
105
|
+
.filter((id) => typeof id === "string");
|
|
106
|
+
return ids.length > 0 ? ids : undefined;
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
if (Array.isArray(result)) {
|
|
110
|
+
const ids = result
|
|
111
|
+
.map((r) => r?.id)
|
|
112
|
+
.filter((id) => typeof id === "string");
|
|
113
|
+
return ids.length > 0 ? ids : undefined;
|
|
114
|
+
}
|
|
115
|
+
return undefined;
|
|
116
|
+
}
|
|
117
|
+
// 其他工具:不提取 engram id
|
|
118
|
+
return undefined;
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* 简化 input(去掉可能的 binary / 大字段,只保留可序列化部分)
|
|
122
|
+
*/
|
|
123
|
+
function sanitizeInput(input) {
|
|
124
|
+
if (input === null || typeof input !== "object") {
|
|
125
|
+
return { value: input };
|
|
126
|
+
}
|
|
127
|
+
// 只保留顶层 string / number / boolean 字段;嵌套对象/array 保留引用但不深拷
|
|
128
|
+
const sanitized = {};
|
|
129
|
+
for (const [k, v] of Object.entries(input)) {
|
|
130
|
+
if (typeof v === "string") {
|
|
131
|
+
// 截断长字符串(避免 signals.jsonl 膨胀)
|
|
132
|
+
sanitized[k] = v.length > 500 ? v.slice(0, 500) + "..." : v;
|
|
133
|
+
}
|
|
134
|
+
else if (typeof v === "number" || typeof v === "boolean") {
|
|
135
|
+
sanitized[k] = v;
|
|
136
|
+
}
|
|
137
|
+
else if (Array.isArray(v)) {
|
|
138
|
+
// 数组只保留 length
|
|
139
|
+
sanitized[k] = `<array:${v.length}>`;
|
|
140
|
+
}
|
|
141
|
+
else if (v !== null && typeof v === "object") {
|
|
142
|
+
sanitized[k] = "<object>";
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
return sanitized;
|
|
146
|
+
}
|
|
147
|
+
function summarizeResult(result) {
|
|
148
|
+
if (result === null || result === undefined)
|
|
149
|
+
return "null";
|
|
150
|
+
if (typeof result === "string") {
|
|
151
|
+
return result.length > 200 ? result.slice(0, 200) + "..." : result;
|
|
152
|
+
}
|
|
153
|
+
if (typeof result !== "object")
|
|
154
|
+
return String(result);
|
|
155
|
+
// 对象:取前几个 key 的概要
|
|
156
|
+
const keys = Object.keys(result);
|
|
157
|
+
if (keys.length === 0)
|
|
158
|
+
return "{}";
|
|
159
|
+
// 如果有 hits 字段,重点摘要
|
|
160
|
+
const hits = result.hits;
|
|
161
|
+
if (Array.isArray(hits)) {
|
|
162
|
+
return `{hits: ${hits.length}}`;
|
|
163
|
+
}
|
|
164
|
+
// 否则只返回 key 列表
|
|
165
|
+
return `{${keys.slice(0, 5).join(",")}}`;
|
|
166
|
+
}
|
|
167
|
+
function summarizeError(err) {
|
|
168
|
+
if (err instanceof Error)
|
|
169
|
+
return err.message.slice(0, 200);
|
|
170
|
+
return String(err).slice(0, 200);
|
|
171
|
+
}
|
|
172
|
+
//# sourceMappingURL=wrapped.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"wrapped.js","sourceRoot":"","sources":["../../src/tools/wrapped.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 渐进式披露类型定义
|
|
3
|
+
*
|
|
4
|
+
* Tier 0/1/2/3/4 数据单元(按粒度递增,不固定分层)
|
|
5
|
+
*
|
|
6
|
+
* @module @co-engram/core/types
|
|
7
|
+
*/
|
|
8
|
+
import type { EngramCatalogEntry, EngramDigest, EngramId } from "./engram.js";
|
|
9
|
+
import type { Synapse } from "./synapse.js";
|
|
10
|
+
/** 披露层级 */
|
|
11
|
+
export type DisclosureTier = "catalog" | "digest" | "content" | "meta" | "synapses";
|
|
12
|
+
/** Context Window 预算 */
|
|
13
|
+
export interface ContextBudget {
|
|
14
|
+
readonly totalTokens: number;
|
|
15
|
+
readonly remaining: number;
|
|
16
|
+
readonly reserved: number;
|
|
17
|
+
}
|
|
18
|
+
/** Synapse Bundle(Tier 4,扩展联想) */
|
|
19
|
+
export interface SynapseBundle {
|
|
20
|
+
readonly engramId: EngramId;
|
|
21
|
+
readonly outgoing: readonly Synapse[];
|
|
22
|
+
readonly incoming: readonly Synapse[];
|
|
23
|
+
readonly neighborDigests: readonly EngramDigest[];
|
|
24
|
+
}
|
|
25
|
+
/** 加载的 Engram 视图(可处于不同披露层级) */
|
|
26
|
+
export type EngramView = {
|
|
27
|
+
readonly tier: "catalog";
|
|
28
|
+
readonly entry: EngramCatalogEntry;
|
|
29
|
+
} | {
|
|
30
|
+
readonly tier: "digest";
|
|
31
|
+
readonly digest: EngramDigest;
|
|
32
|
+
} | {
|
|
33
|
+
readonly tier: "content";
|
|
34
|
+
readonly entry: EngramCatalogEntry;
|
|
35
|
+
readonly content: string;
|
|
36
|
+
} | {
|
|
37
|
+
readonly tier: "meta";
|
|
38
|
+
readonly entry: EngramCatalogEntry;
|
|
39
|
+
readonly meta: Record<string, unknown>;
|
|
40
|
+
} | {
|
|
41
|
+
readonly tier: "synapses";
|
|
42
|
+
readonly bundle: SynapseBundle;
|
|
43
|
+
};
|
|
44
|
+
/** 检索过滤器 */
|
|
45
|
+
export interface SearchFilter {
|
|
46
|
+
readonly domainTags?: readonly string[];
|
|
47
|
+
readonly kinds?: readonly string[];
|
|
48
|
+
readonly status?: readonly string[];
|
|
49
|
+
readonly freshness?: readonly string[];
|
|
50
|
+
readonly emotionalValence?: readonly string[];
|
|
51
|
+
readonly createdBy?: readonly string[];
|
|
52
|
+
readonly createdAfter?: string;
|
|
53
|
+
readonly createdBefore?: string;
|
|
54
|
+
readonly minImportance?: number;
|
|
55
|
+
}
|
|
56
|
+
/** 检索请求 */
|
|
57
|
+
export interface SearchRequest {
|
|
58
|
+
readonly query: string;
|
|
59
|
+
readonly filter?: SearchFilter;
|
|
60
|
+
readonly contextBudget?: ContextBudget;
|
|
61
|
+
readonly limit?: number;
|
|
62
|
+
}
|
|
63
|
+
/** 检索结果(带 score 和 tier) */
|
|
64
|
+
export interface SearchResult {
|
|
65
|
+
readonly id: EngramId;
|
|
66
|
+
readonly score: number;
|
|
67
|
+
readonly view: EngramView;
|
|
68
|
+
readonly matchedBy: readonly ("fts" | "vector" | "recency" | "importance")[];
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=disclosure.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"disclosure.d.ts","sourceRoot":"","sources":["../../src/types/disclosure.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"disclosure.js","sourceRoot":"","sources":["../../src/types/disclosure.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
|