@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,196 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Adaptive Disclosure:按预算自动选择 tier
|
|
3
|
+
*
|
|
4
|
+
* 实现 spec 3.2 的 adaptiveDisclosure 伪代码:
|
|
5
|
+
*
|
|
6
|
+
* candidates = semanticSearch(query)
|
|
7
|
+
* loaded = { c.id: c.toCatalogEntry() for c in candidates } // 阶段 1
|
|
8
|
+
* for c in sortByScore(candidates): // 阶段 2
|
|
9
|
+
* if budget.remaining > c.digestSize:
|
|
10
|
+
* upgrade(c, 'digest')
|
|
11
|
+
* for c in topK(candidates, k=adaptive): // 阶段 3
|
|
12
|
+
* if budget.remaining > c.contentSize:
|
|
13
|
+
* upgrade(c, 'content')
|
|
14
|
+
* // 阶段 4:meta/synapse 由 agent 显式请求
|
|
15
|
+
*
|
|
16
|
+
* 关键特性:
|
|
17
|
+
* - 每个 engram 独立决定 tier(不是全量分层)
|
|
18
|
+
* - budget 不可用时(remaining ≤ 0)停止升级
|
|
19
|
+
* - 相同输入产生相同输出(prompt cache 友好)
|
|
20
|
+
*
|
|
21
|
+
* @module @co-engram/core/disclosure
|
|
22
|
+
*/
|
|
23
|
+
import { consume, hasBudget } from "./budget.js";
|
|
24
|
+
import { estimateViewSize, loadView, viewIdOf } from "./tier-loader.js";
|
|
25
|
+
const EMPTY_BREAKDOWN = {
|
|
26
|
+
catalog: 0,
|
|
27
|
+
digest: 0,
|
|
28
|
+
content: 0,
|
|
29
|
+
meta: 0,
|
|
30
|
+
synapses: 0,
|
|
31
|
+
};
|
|
32
|
+
/**
|
|
33
|
+
* 执行自适应披露
|
|
34
|
+
*
|
|
35
|
+
* 算法(严格按 spec 顺序):
|
|
36
|
+
* 1. 所有候选加载为 catalog
|
|
37
|
+
* 2. 按 score 倒序,逐个升级到 digest(若预算够)
|
|
38
|
+
* 3. Top-K(默认 min(5, len))升级到 content(若预算够)
|
|
39
|
+
* 4. meta/synapse 留给 agent 显式请求
|
|
40
|
+
*
|
|
41
|
+
* 顺序稳定性:同 score 的 candidates 保持原数组顺序(稳定排序)。
|
|
42
|
+
*/
|
|
43
|
+
export function adaptiveDisclosure(input) {
|
|
44
|
+
const { repository, candidates, digestLines, budget, topK, maxDigestUpgrades, } = input;
|
|
45
|
+
const breakdown = { ...EMPTY_BREAKDOWN };
|
|
46
|
+
// 候选索引,便于阶段 2/3 复用
|
|
47
|
+
const workingBudget = { ...budget };
|
|
48
|
+
const views = new Map();
|
|
49
|
+
let tokensUsed = 0;
|
|
50
|
+
// ---- 阶段 1:全部 catalog ----
|
|
51
|
+
for (const c of candidates) {
|
|
52
|
+
const line = digestLines[c.id];
|
|
53
|
+
const size = estimateViewSize("catalog", line ?? {});
|
|
54
|
+
if (!hasBudget(workingBudget, size)) {
|
|
55
|
+
// 预算不足以容纳 catalog:直接跳过(不入结果)
|
|
56
|
+
continue;
|
|
57
|
+
}
|
|
58
|
+
const view = safeLoad(repository, c.id, "catalog");
|
|
59
|
+
if (!view)
|
|
60
|
+
continue;
|
|
61
|
+
views.set(c.id, view);
|
|
62
|
+
workingBudget.remaining -= size;
|
|
63
|
+
tokensUsed += size;
|
|
64
|
+
breakdown.catalog += 1;
|
|
65
|
+
}
|
|
66
|
+
let reachedStage = 1;
|
|
67
|
+
if (views.size === 0) {
|
|
68
|
+
return finalize(views, candidates, tokensUsed, workingBudget.remaining, breakdown, reachedStage);
|
|
69
|
+
}
|
|
70
|
+
// ---- 阶段 2:digest 升级 ----
|
|
71
|
+
const sortedByScore = stableSortByScoreDesc(candidates);
|
|
72
|
+
const digestCap = maxDigestUpgrades !== undefined
|
|
73
|
+
? Math.max(0, maxDigestUpgrades)
|
|
74
|
+
: Number.POSITIVE_INFINITY;
|
|
75
|
+
let digestUpgraded = 0;
|
|
76
|
+
for (const c of sortedByScore) {
|
|
77
|
+
if (digestUpgraded >= digestCap)
|
|
78
|
+
break;
|
|
79
|
+
const line = digestLines[c.id];
|
|
80
|
+
const size = estimateViewSize("digest", line ?? {});
|
|
81
|
+
if (!hasBudget(workingBudget, size))
|
|
82
|
+
break;
|
|
83
|
+
const view = safeLoad(repository, c.id, "digest");
|
|
84
|
+
if (!view)
|
|
85
|
+
continue;
|
|
86
|
+
// catalog → digest:补差额(digest 大小 - catalog 大小)
|
|
87
|
+
const catalogSize = estimateViewSize("catalog", line ?? {});
|
|
88
|
+
workingBudget.remaining -= size - catalogSize;
|
|
89
|
+
tokensUsed += size - catalogSize;
|
|
90
|
+
views.set(c.id, view);
|
|
91
|
+
breakdown.catalog -= 1;
|
|
92
|
+
breakdown.digest += 1;
|
|
93
|
+
digestUpgraded += 1;
|
|
94
|
+
}
|
|
95
|
+
if (breakdown.digest > 0) {
|
|
96
|
+
reachedStage = 2;
|
|
97
|
+
}
|
|
98
|
+
// ---- 阶段 3:top-K content 升级 ----
|
|
99
|
+
const k = Math.min(topK ?? DEFAULT_TOP_K, sortedByScore.length);
|
|
100
|
+
for (let i = 0; i < k; i++) {
|
|
101
|
+
const c = sortedByScore[i];
|
|
102
|
+
if (!c)
|
|
103
|
+
break;
|
|
104
|
+
const line = digestLines[c.id];
|
|
105
|
+
const size = estimateViewSize("content", line ?? {});
|
|
106
|
+
if (!hasBudget(workingBudget, size))
|
|
107
|
+
break;
|
|
108
|
+
const view = safeLoad(repository, c.id, "content");
|
|
109
|
+
if (!view)
|
|
110
|
+
continue;
|
|
111
|
+
// digest → content:补差额
|
|
112
|
+
const digestSize = estimateViewSize("digest", line ?? {});
|
|
113
|
+
workingBudget.remaining -= size - digestSize;
|
|
114
|
+
tokensUsed += size - digestSize;
|
|
115
|
+
views.set(c.id, view);
|
|
116
|
+
breakdown.digest -= 1;
|
|
117
|
+
breakdown.content += 1;
|
|
118
|
+
}
|
|
119
|
+
if (breakdown.content > 0) {
|
|
120
|
+
reachedStage = 3;
|
|
121
|
+
}
|
|
122
|
+
return finalize(views, candidates, tokensUsed, workingBudget.remaining, breakdown, reachedStage);
|
|
123
|
+
}
|
|
124
|
+
const DEFAULT_TOP_K = 5;
|
|
125
|
+
function safeLoad(repo, id, tier) {
|
|
126
|
+
try {
|
|
127
|
+
return loadView(repo, id, tier);
|
|
128
|
+
}
|
|
129
|
+
catch {
|
|
130
|
+
return null;
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
function stableSortByScoreDesc(candidates) {
|
|
134
|
+
return [...candidates]
|
|
135
|
+
.map((c, idx) => ({ c, idx }))
|
|
136
|
+
.sort((a, b) => {
|
|
137
|
+
if (a.c.score !== b.c.score)
|
|
138
|
+
return b.c.score - a.c.score;
|
|
139
|
+
return a.idx - b.idx; // 稳定排序
|
|
140
|
+
})
|
|
141
|
+
.map((x) => x.c);
|
|
142
|
+
}
|
|
143
|
+
function finalize(views, candidates, tokensUsed, budgetRemaining, breakdown, reachedStage) {
|
|
144
|
+
const loaded = [];
|
|
145
|
+
for (const c of candidates) {
|
|
146
|
+
const view = views.get(c.id);
|
|
147
|
+
if (view) {
|
|
148
|
+
loaded.push({ id: c.id, score: c.score, view });
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
return {
|
|
152
|
+
loaded,
|
|
153
|
+
tokensUsed,
|
|
154
|
+
budgetRemaining,
|
|
155
|
+
tierBreakdown: breakdown,
|
|
156
|
+
reachedStage,
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
/**
|
|
160
|
+
* 在自适应结果之上,按 agent 请求升级单个 engram 到指定 tier
|
|
161
|
+
*
|
|
162
|
+
* 用于阶段 4(meta / synapse)的按需请求。
|
|
163
|
+
*/
|
|
164
|
+
export function upgradeSingle(repository, current, target, budget) {
|
|
165
|
+
const size = estimateViewSize(target, viewPreview(current));
|
|
166
|
+
if (!hasBudget(budget, size)) {
|
|
167
|
+
return { view: current, budget, tierChanged: false };
|
|
168
|
+
}
|
|
169
|
+
const id = viewIdOf(current);
|
|
170
|
+
if (!id) {
|
|
171
|
+
return { view: current, budget, tierChanged: false };
|
|
172
|
+
}
|
|
173
|
+
try {
|
|
174
|
+
const view = loadView(repository, id, target);
|
|
175
|
+
return { view, budget: consume(budget, size), tierChanged: true };
|
|
176
|
+
}
|
|
177
|
+
catch {
|
|
178
|
+
return { view: current, budget, tierChanged: false };
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
function viewPreview(view) {
|
|
182
|
+
switch (view.tier) {
|
|
183
|
+
case "digest":
|
|
184
|
+
return { contentSize: view.digest.contentSize };
|
|
185
|
+
case "content":
|
|
186
|
+
return { contentSize: view.content.length };
|
|
187
|
+
case "synapses":
|
|
188
|
+
return {
|
|
189
|
+
outgoingCount: view.bundle.outgoing.length,
|
|
190
|
+
incomingCount: view.bundle.incoming.length,
|
|
191
|
+
};
|
|
192
|
+
default:
|
|
193
|
+
return {};
|
|
194
|
+
}
|
|
195
|
+
}
|
|
196
|
+
//# sourceMappingURL=adaptive.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"adaptive.js","sourceRoot":"","sources":["../../src/disclosure/adaptive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAUH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAuCxE,MAAM,eAAe,GAAmC;IACtD,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAA8B;IAE9B,MAAM,EACJ,UAAU,EACV,UAAU,EACV,WAAW,EACX,MAAM,EACN,IAAI,EACJ,iBAAiB,GAClB,GAAG,KAAK,CAAC;IACV,MAAM,SAAS,GAAmC,EAAE,GAAG,eAAe,EAAE,CAAC;IAEzE,mBAAmB;IACnB,MAAM,aAAa,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC9C,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,4BAA4B;IAC5B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC;YACpC,6BAA6B;YAC7B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACtB,aAAa,CAAC,SAAS,IAAI,IAAI,CAAC;QAChC,UAAU,IAAI,IAAI,CAAC;QACnB,SAAS,CAAC,OAAO,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,YAAY,GAAc,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,QAAQ,CACb,KAAK,EACL,UAAU,EACV,UAAU,EACV,aAAa,CAAC,SAAS,EACvB,SAAS,EACT,YAAY,CACb,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,aAAa,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IACxD,MAAM,SAAS,GACb,iBAAiB,KAAK,SAAS;QAC7B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,CAAC;QAChC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;IAC/B,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,IAAI,cAAc,IAAI,SAAS;YAAE,MAAM;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC;YAAE,MAAM;QAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,+CAA+C;QAC/C,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC5D,aAAa,CAAC,SAAS,IAAI,IAAI,GAAG,WAAW,CAAC;QAC9C,UAAU,IAAI,IAAI,GAAG,WAAW,CAAC;QACjC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACtB,SAAS,CAAC,OAAO,IAAI,CAAC,CAAC;QACvB,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;QACtB,cAAc,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,YAAY,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,kCAAkC;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC;YAAE,MAAM;QACd,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC;YAAE,MAAM;QAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,uBAAuB;QACvB,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,SAAS,IAAI,IAAI,GAAG,UAAU,CAAC;QAC7C,UAAU,IAAI,IAAI,GAAG,UAAU,CAAC;QAChC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACtB,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;QACtB,SAAS,CAAC,OAAO,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,SAAS,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAC1B,YAAY,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,QAAQ,CACb,KAAK,EACL,UAAU,EACV,UAAU,EACV,aAAa,CAAC,SAAS,EACvB,SAAS,EACT,YAAY,CACb,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,SAAS,QAAQ,CACf,IAAsB,EACtB,EAAY,EACZ,IAAoB;IAEpB,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,UAA4B;IAE5B,OAAO,CAAC,GAAG,UAAU,CAAC;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;SAC7B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC1D,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO;IAC/B,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,QAAQ,CACf,KAAgC,EAChC,UAA0D,EAC1D,UAAkB,EAClB,eAAuB,EACvB,SAAyC,EACzC,YAAuB;IAEvB,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO;QACL,MAAM;QACN,UAAU;QACV,eAAe;QACf,aAAa,EAAE,SAAS;QACxB,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,UAA4B,EAC5B,OAAmB,EACnB,MAAsB,EACtB,MAAqB;IAErB,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACvD,CAAC;IACD,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACvD,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAgB;IAKnC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAClD,KAAK,SAAS;YACZ,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC9C,KAAK,UAAU;YACb,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM;gBAC1C,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM;aAC3C,CAAC;QACJ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Window 预算管理
|
|
3
|
+
*
|
|
4
|
+
* 用于 adaptiveDisclosure 的预算跟踪:每个 tier 升级都要消耗 token,
|
|
5
|
+
* 一旦超出预算就停留在当前层。
|
|
6
|
+
*
|
|
7
|
+
* P1 简化策略:
|
|
8
|
+
* - 中文按 1 char ≈ 1 token 估算
|
|
9
|
+
* - 英文/数字按 ~4 char ≈ 1 token 估算
|
|
10
|
+
* - 结构化字段(id/title/tags)额外计入 ~10 token 的 wrapper 开销
|
|
11
|
+
*
|
|
12
|
+
* 后续可换成准确的 tokenizer(如 tiktoken / @anthropic-ai/tokenizer)。
|
|
13
|
+
*
|
|
14
|
+
* @module @co-engram/core/disclosure
|
|
15
|
+
*/
|
|
16
|
+
/**
|
|
17
|
+
* 估算字符串消耗的 token 数(向上取整)
|
|
18
|
+
*
|
|
19
|
+
* - 中文字符:1 char ≈ 1 token
|
|
20
|
+
* - 其他字符(含空格标点):4 char ≈ 1 token
|
|
21
|
+
*/
|
|
22
|
+
export declare function estimateTokens(text: string): number;
|
|
23
|
+
/**
|
|
24
|
+
* 创建预算
|
|
25
|
+
*
|
|
26
|
+
* @param totalTokens - 总预算(如 4096 / 32768 / 128000)
|
|
27
|
+
* @param reserved - 已被其他内容占用(系统提示词、历史对话)
|
|
28
|
+
*/
|
|
29
|
+
export declare function createBudget(totalTokens: number, reserved?: number): ContextBudget;
|
|
30
|
+
/**
|
|
31
|
+
* 消耗一定 token,返回新预算(不修改原对象)
|
|
32
|
+
*
|
|
33
|
+
* remaining 不会变负,最低为 0
|
|
34
|
+
*/
|
|
35
|
+
export declare function consume(budget: ContextBudget, tokens: number): ContextBudget;
|
|
36
|
+
/**
|
|
37
|
+
* 判断预算是否够用
|
|
38
|
+
*/
|
|
39
|
+
export declare function hasBudget(budget: ContextBudget, tokens: number): boolean;
|
|
40
|
+
/**
|
|
41
|
+
* 预算耗尽
|
|
42
|
+
*/
|
|
43
|
+
export declare function isExhausted(budget: ContextBudget): boolean;
|
|
44
|
+
/**
|
|
45
|
+
* 预算使用率 [0,1]
|
|
46
|
+
*/
|
|
47
|
+
export declare function utilization(budget: ContextBudget): number;
|
|
48
|
+
/** 重新导出类型,避免调用方跨包 import */
|
|
49
|
+
export type { ContextBudget } from "../types/disclosure.js";
|
|
50
|
+
import type { ContextBudget } from "../types/disclosure.js";
|
|
51
|
+
//# sourceMappingURL=budget.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/disclosure/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,aAAa,CAY7E;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAM5E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAIzD;AAED,4BAA4B;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Context Window 预算管理
|
|
3
|
+
*
|
|
4
|
+
* 用于 adaptiveDisclosure 的预算跟踪:每个 tier 升级都要消耗 token,
|
|
5
|
+
* 一旦超出预算就停留在当前层。
|
|
6
|
+
*
|
|
7
|
+
* P1 简化策略:
|
|
8
|
+
* - 中文按 1 char ≈ 1 token 估算
|
|
9
|
+
* - 英文/数字按 ~4 char ≈ 1 token 估算
|
|
10
|
+
* - 结构化字段(id/title/tags)额外计入 ~10 token 的 wrapper 开销
|
|
11
|
+
*
|
|
12
|
+
* 后续可换成准确的 tokenizer(如 tiktoken / @anthropic-ai/tokenizer)。
|
|
13
|
+
*
|
|
14
|
+
* @module @co-engram/core/disclosure
|
|
15
|
+
*/
|
|
16
|
+
/** CJK 字符检测(包含常见汉字扩展区) */
|
|
17
|
+
const CJK_REGEX = /[㐀-鿿豈-\u{20000}-\u{2a6df}\u{2a700}-\u{2ebef}]/u;
|
|
18
|
+
/**
|
|
19
|
+
* 估算字符串消耗的 token 数(向上取整)
|
|
20
|
+
*
|
|
21
|
+
* - 中文字符:1 char ≈ 1 token
|
|
22
|
+
* - 其他字符(含空格标点):4 char ≈ 1 token
|
|
23
|
+
*/
|
|
24
|
+
export function estimateTokens(text) {
|
|
25
|
+
if (!text)
|
|
26
|
+
return 0;
|
|
27
|
+
let cjk = 0;
|
|
28
|
+
let other = 0;
|
|
29
|
+
for (const ch of text) {
|
|
30
|
+
if (CJK_REGEX.test(ch)) {
|
|
31
|
+
cjk += 1;
|
|
32
|
+
}
|
|
33
|
+
else {
|
|
34
|
+
other += 1;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
return Math.ceil(cjk + other / 4);
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* 创建预算
|
|
41
|
+
*
|
|
42
|
+
* @param totalTokens - 总预算(如 4096 / 32768 / 128000)
|
|
43
|
+
* @param reserved - 已被其他内容占用(系统提示词、历史对话)
|
|
44
|
+
*/
|
|
45
|
+
export function createBudget(totalTokens, reserved = 0) {
|
|
46
|
+
if (totalTokens < 0) {
|
|
47
|
+
throw new Error(`totalTokens must be >= 0, got ${totalTokens}`);
|
|
48
|
+
}
|
|
49
|
+
if (reserved < 0 || reserved > totalTokens) {
|
|
50
|
+
throw new Error(`reserved must be in [0, totalTokens], got ${reserved}`);
|
|
51
|
+
}
|
|
52
|
+
return {
|
|
53
|
+
totalTokens,
|
|
54
|
+
reserved,
|
|
55
|
+
remaining: totalTokens - reserved,
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* 消耗一定 token,返回新预算(不修改原对象)
|
|
60
|
+
*
|
|
61
|
+
* remaining 不会变负,最低为 0
|
|
62
|
+
*/
|
|
63
|
+
export function consume(budget, tokens) {
|
|
64
|
+
if (tokens < 0) {
|
|
65
|
+
throw new Error(`tokens to consume must be >= 0, got ${tokens}`);
|
|
66
|
+
}
|
|
67
|
+
const remaining = Math.max(0, budget.remaining - tokens);
|
|
68
|
+
return { ...budget, remaining };
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* 判断预算是否够用
|
|
72
|
+
*/
|
|
73
|
+
export function hasBudget(budget, tokens) {
|
|
74
|
+
return budget.remaining >= tokens;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* 预算耗尽
|
|
78
|
+
*/
|
|
79
|
+
export function isExhausted(budget) {
|
|
80
|
+
return budget.remaining <= 0;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* 预算使用率 [0,1]
|
|
84
|
+
*/
|
|
85
|
+
export function utilization(budget) {
|
|
86
|
+
if (budget.totalTokens <= 0)
|
|
87
|
+
return 0;
|
|
88
|
+
const used = budget.totalTokens - budget.remaining;
|
|
89
|
+
return used / budget.totalTokens;
|
|
90
|
+
}
|
|
91
|
+
//# sourceMappingURL=budget.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/disclosure/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,0BAA0B;AAC1B,MAAM,SAAS,GAAG,iDAAiD,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,GAAG,IAAI,CAAC,CAAC;QACX,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,QAAQ,GAAG,CAAC;IAC5D,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO;QACL,WAAW;QACX,QAAQ;QACR,SAAS,EAAE,WAAW,GAAG,QAAQ;KAClC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,MAAqB,EAAE,MAAc;IAC3D,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;IACzD,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAqB,EAAE,MAAc;IAC7D,OAAO,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC/C,OAAO,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC/C,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC;IACnD,OAAO,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;AACnC,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Disclosure 模块 barrel
|
|
3
|
+
*
|
|
4
|
+
* adaptiveDisclosure + tier-loader + budget
|
|
5
|
+
*
|
|
6
|
+
* @module @co-engram/core/disclosure
|
|
7
|
+
*/
|
|
8
|
+
export * from "./budget.js";
|
|
9
|
+
export * from "./tier-loader.js";
|
|
10
|
+
export * from "./adaptive.js";
|
|
11
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/disclosure/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Disclosure 模块 barrel
|
|
3
|
+
*
|
|
4
|
+
* adaptiveDisclosure + tier-loader + budget
|
|
5
|
+
*
|
|
6
|
+
* @module @co-engram/core/disclosure
|
|
7
|
+
*/
|
|
8
|
+
export * from "./budget.js";
|
|
9
|
+
export * from "./tier-loader.js";
|
|
10
|
+
export * from "./adaptive.js";
|
|
11
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/disclosure/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tier Loader:按需加载 EngramView
|
|
3
|
+
*
|
|
4
|
+
* 把 engram-tools 里的 readEngramView 逻辑提取出来,
|
|
5
|
+
* 给 disclosure 模块复用,并加 token 估算。
|
|
6
|
+
*
|
|
7
|
+
* 升级路径:Catalog → Digest → Content → Meta → Synapse
|
|
8
|
+
* - Catalog:仅 id/title/kind/domainTags(~50 token)
|
|
9
|
+
* - Digest:+ summary/importance/freshness(~120 token)
|
|
10
|
+
* - Content:+ 完整 Markdown(变长)
|
|
11
|
+
* - Meta:+ 全部 meta 字段(除 content)
|
|
12
|
+
* - Synapse:+ outgoing/incoming/neighborDigests
|
|
13
|
+
*
|
|
14
|
+
* @module @co-engram/core/disclosure
|
|
15
|
+
*/
|
|
16
|
+
import type { EngramId } from "../types/engram.js";
|
|
17
|
+
import type { DisclosureTier, EngramView } from "../types/disclosure.js";
|
|
18
|
+
import type { EngramRepository } from "../storage/repository.js";
|
|
19
|
+
/**
|
|
20
|
+
* 视图大小估算(单位:token)
|
|
21
|
+
*
|
|
22
|
+
* 用于 budget 检查;与实际序列化后的 token 数会有误差,
|
|
23
|
+
* 但数量级一致。
|
|
24
|
+
*/
|
|
25
|
+
export declare function estimateViewSize(tier: DisclosureTier, preview: {
|
|
26
|
+
contentSize?: number;
|
|
27
|
+
outgoingCount?: number;
|
|
28
|
+
incomingCount?: number;
|
|
29
|
+
}): number;
|
|
30
|
+
/**
|
|
31
|
+
* 按 tier 加载 EngramView
|
|
32
|
+
*
|
|
33
|
+
* 与 engram-tools.readEngramView 行为一致,
|
|
34
|
+
* 但单独导出便于 disclosure 模块和未来 agent 复用。
|
|
35
|
+
*/
|
|
36
|
+
export declare function loadView(repo: EngramRepository, id: EngramId, tier: DisclosureTier): EngramView;
|
|
37
|
+
/**
|
|
38
|
+
* 比较两个 tier 的"粒度等级"
|
|
39
|
+
*
|
|
40
|
+
* 返回:负数表示 a < b,0 表示相等,正数表示 a > b
|
|
41
|
+
*/
|
|
42
|
+
export declare function compareTier(a: DisclosureTier, b: DisclosureTier): number;
|
|
43
|
+
/**
|
|
44
|
+
* 从 EngramView 提取 engram id
|
|
45
|
+
*/
|
|
46
|
+
export declare function viewIdOf(view: EngramView): EngramId;
|
|
47
|
+
/**
|
|
48
|
+
* 升级视图到更高 tier
|
|
49
|
+
*
|
|
50
|
+
* 若 target 粒度低于或等于 current,直接返回 current(不降级)。
|
|
51
|
+
*/
|
|
52
|
+
export declare function upgradeView(repo: EngramRepository, current: EngramView, target: DisclosureTier): {
|
|
53
|
+
view: EngramView;
|
|
54
|
+
tierChanged: boolean;
|
|
55
|
+
};
|
|
56
|
+
/** 估算已加载视图的 token 数(实际序列化后) */
|
|
57
|
+
export declare function estimateLoadedTokens(view: EngramView): number;
|
|
58
|
+
//# sourceMappingURL=tier-loader.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tier-loader.d.ts","sourceRoot":"","sources":["../../src/disclosure/tier-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAIV,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EAEX,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,MAAM,CAuBR;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,cAAc,GACnB,UAAU,CA+CZ;AAWD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAYnD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,cAAc,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAS5C;AAED,+BAA+B;AAC/B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAgC7D"}
|
|
@@ -0,0 +1,205 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Tier Loader:按需加载 EngramView
|
|
3
|
+
*
|
|
4
|
+
* 把 engram-tools 里的 readEngramView 逻辑提取出来,
|
|
5
|
+
* 给 disclosure 模块复用,并加 token 估算。
|
|
6
|
+
*
|
|
7
|
+
* 升级路径:Catalog → Digest → Content → Meta → Synapse
|
|
8
|
+
* - Catalog:仅 id/title/kind/domainTags(~50 token)
|
|
9
|
+
* - Digest:+ summary/importance/freshness(~120 token)
|
|
10
|
+
* - Content:+ 完整 Markdown(变长)
|
|
11
|
+
* - Meta:+ 全部 meta 字段(除 content)
|
|
12
|
+
* - Synapse:+ outgoing/incoming/neighborDigests
|
|
13
|
+
*
|
|
14
|
+
* @module @co-engram/core/disclosure
|
|
15
|
+
*/
|
|
16
|
+
import { estimateTokens } from "./budget.js";
|
|
17
|
+
/**
|
|
18
|
+
* 视图大小估算(单位:token)
|
|
19
|
+
*
|
|
20
|
+
* 用于 budget 检查;与实际序列化后的 token 数会有误差,
|
|
21
|
+
* 但数量级一致。
|
|
22
|
+
*/
|
|
23
|
+
export function estimateViewSize(tier, preview) {
|
|
24
|
+
const contentTokens = preview.contentSize
|
|
25
|
+
? Math.ceil(preview.contentSize / 2)
|
|
26
|
+
: 0;
|
|
27
|
+
const edgeTokens = (preview.outgoingCount ?? 0) + (preview.incomingCount ?? 0);
|
|
28
|
+
switch (tier) {
|
|
29
|
+
case "catalog":
|
|
30
|
+
// id + title + kind + domainTags ~ 30-60 token
|
|
31
|
+
return 50;
|
|
32
|
+
case "digest":
|
|
33
|
+
// + summary + importance + freshness
|
|
34
|
+
return 120;
|
|
35
|
+
case "content":
|
|
36
|
+
// digest + 完整正文
|
|
37
|
+
return 120 + contentTokens;
|
|
38
|
+
case "meta":
|
|
39
|
+
// digest + 所有 meta 字段
|
|
40
|
+
return 300;
|
|
41
|
+
case "synapses":
|
|
42
|
+
// digest + edges + neighbor digests
|
|
43
|
+
return 120 + edgeTokens * 20;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* 按 tier 加载 EngramView
|
|
48
|
+
*
|
|
49
|
+
* 与 engram-tools.readEngramView 行为一致,
|
|
50
|
+
* 但单独导出便于 disclosure 模块和未来 agent 复用。
|
|
51
|
+
*/
|
|
52
|
+
export function loadView(repo, id, tier) {
|
|
53
|
+
switch (tier) {
|
|
54
|
+
case "catalog": {
|
|
55
|
+
const entry = repo.readCatalogEntry(id);
|
|
56
|
+
if (!entry)
|
|
57
|
+
throw new Error(`Engram not found: ${id}`);
|
|
58
|
+
return { tier: "catalog", entry };
|
|
59
|
+
}
|
|
60
|
+
case "digest": {
|
|
61
|
+
const digest = repo.readDigest(id);
|
|
62
|
+
if (!digest)
|
|
63
|
+
throw new Error(`Engram not found: ${id}`);
|
|
64
|
+
return { tier: "digest", digest };
|
|
65
|
+
}
|
|
66
|
+
case "content": {
|
|
67
|
+
const engram = repo.readEngram(id);
|
|
68
|
+
return {
|
|
69
|
+
tier: "content",
|
|
70
|
+
entry: toCatalogEntry(engram),
|
|
71
|
+
content: engram.content,
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
case "meta": {
|
|
75
|
+
const engram = repo.readEngram(id);
|
|
76
|
+
return {
|
|
77
|
+
tier: "meta",
|
|
78
|
+
entry: toCatalogEntry(engram),
|
|
79
|
+
meta: stripContentFromMeta(engram),
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
case "synapses": {
|
|
83
|
+
const entry = repo.readCatalogEntry(id);
|
|
84
|
+
if (!entry)
|
|
85
|
+
throw new Error(`Engram not found: ${id}`);
|
|
86
|
+
const outgoingFile = repo.readSynapses(id);
|
|
87
|
+
const incoming = collectIncoming(repo, id);
|
|
88
|
+
const neighborDigests = collectNeighborDigests(repo, outgoingFile.outgoing, incoming);
|
|
89
|
+
const bundle = {
|
|
90
|
+
engramId: id,
|
|
91
|
+
outgoing: outgoingFile.outgoing,
|
|
92
|
+
incoming,
|
|
93
|
+
neighborDigests,
|
|
94
|
+
};
|
|
95
|
+
return { tier: "synapses", bundle };
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
/** tier 排序:catalog < digest < content/meta < synapses */
|
|
100
|
+
const TIER_ORDER = [
|
|
101
|
+
"catalog",
|
|
102
|
+
"digest",
|
|
103
|
+
"content",
|
|
104
|
+
"meta",
|
|
105
|
+
"synapses",
|
|
106
|
+
];
|
|
107
|
+
/**
|
|
108
|
+
* 比较两个 tier 的"粒度等级"
|
|
109
|
+
*
|
|
110
|
+
* 返回:负数表示 a < b,0 表示相等,正数表示 a > b
|
|
111
|
+
*/
|
|
112
|
+
export function compareTier(a, b) {
|
|
113
|
+
return TIER_ORDER.indexOf(a) - TIER_ORDER.indexOf(b);
|
|
114
|
+
}
|
|
115
|
+
/**
|
|
116
|
+
* 从 EngramView 提取 engram id
|
|
117
|
+
*/
|
|
118
|
+
export function viewIdOf(view) {
|
|
119
|
+
switch (view.tier) {
|
|
120
|
+
case "catalog":
|
|
121
|
+
return view.entry.id;
|
|
122
|
+
case "digest":
|
|
123
|
+
return view.digest.id;
|
|
124
|
+
case "content":
|
|
125
|
+
case "meta":
|
|
126
|
+
return view.entry.id;
|
|
127
|
+
case "synapses":
|
|
128
|
+
return view.bundle.engramId;
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* 升级视图到更高 tier
|
|
133
|
+
*
|
|
134
|
+
* 若 target 粒度低于或等于 current,直接返回 current(不降级)。
|
|
135
|
+
*/
|
|
136
|
+
export function upgradeView(repo, current, target) {
|
|
137
|
+
const currentId = viewIdOf(current);
|
|
138
|
+
if (compareTier(target, current.tier) <= 0) {
|
|
139
|
+
return { view: current, tierChanged: false };
|
|
140
|
+
}
|
|
141
|
+
return {
|
|
142
|
+
view: loadView(repo, currentId, target),
|
|
143
|
+
tierChanged: true,
|
|
144
|
+
};
|
|
145
|
+
}
|
|
146
|
+
/** 估算已加载视图的 token 数(实际序列化后) */
|
|
147
|
+
export function estimateLoadedTokens(view) {
|
|
148
|
+
switch (view.tier) {
|
|
149
|
+
case "catalog":
|
|
150
|
+
return (estimateTokens(view.entry.id) + estimateTokens(view.entry.title) + 10);
|
|
151
|
+
case "digest":
|
|
152
|
+
return (estimateTokens(view.digest.id) +
|
|
153
|
+
estimateTokens(view.digest.title) +
|
|
154
|
+
estimateTokens(view.digest.summary) +
|
|
155
|
+
20);
|
|
156
|
+
case "content":
|
|
157
|
+
return (estimateTokens(view.entry.id) +
|
|
158
|
+
estimateTokens(view.entry.title) +
|
|
159
|
+
estimateTokens(view.content) +
|
|
160
|
+
20);
|
|
161
|
+
case "meta":
|
|
162
|
+
return estimateTokens(JSON.stringify(view.meta));
|
|
163
|
+
case "synapses": {
|
|
164
|
+
const neighborTokens = view.bundle.neighborDigests.reduce((sum, d) => sum + estimateTokens(d.title) + estimateTokens(d.summary), 0);
|
|
165
|
+
const edgeTokens = (view.bundle.outgoing.length + view.bundle.incoming.length) * 15;
|
|
166
|
+
return neighborTokens + edgeTokens + 30;
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
// ============================================================
|
|
171
|
+
// 内部辅助(与 engram-tools.ts 保持一致,未来可合并)
|
|
172
|
+
// ============================================================
|
|
173
|
+
function toCatalogEntry(engram) {
|
|
174
|
+
return {
|
|
175
|
+
id: engram.id,
|
|
176
|
+
title: engram.title,
|
|
177
|
+
kind: engram.kind,
|
|
178
|
+
domainTags: engram.domainTags,
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
function stripContentFromMeta(engram) {
|
|
182
|
+
const { content: _content, ...rest } = engram;
|
|
183
|
+
return rest;
|
|
184
|
+
}
|
|
185
|
+
function collectIncoming(repo, id) {
|
|
186
|
+
const all = repo.collectAllSynapses();
|
|
187
|
+
return all
|
|
188
|
+
.filter(({ synapse }) => synapse.to === id)
|
|
189
|
+
.map(({ synapse }) => synapse);
|
|
190
|
+
}
|
|
191
|
+
function collectNeighborDigests(repo, outgoing, incoming) {
|
|
192
|
+
const neighborIds = new Set();
|
|
193
|
+
for (const s of outgoing)
|
|
194
|
+
neighborIds.add(s.to);
|
|
195
|
+
for (const s of incoming)
|
|
196
|
+
neighborIds.add(s.from);
|
|
197
|
+
const digests = [];
|
|
198
|
+
for (const nid of neighborIds) {
|
|
199
|
+
const d = repo.readDigest(nid);
|
|
200
|
+
if (d)
|
|
201
|
+
digests.push(d);
|
|
202
|
+
}
|
|
203
|
+
return digests;
|
|
204
|
+
}
|
|
205
|
+
//# sourceMappingURL=tier-loader.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tier-loader.js","sourceRoot":"","sources":["../../src/disclosure/tier-loader.ts"],"names":[],"mappings":"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"}
|