@roarpeng/graphflow 1.1.0 → 1.3.0

package/dist/core/triage.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.triageTaskExplain = triageTaskExplain;
 exports.triageTask = triageTask;
 exports.triageTaskLlm = triageTaskLlm;
 const logger_1 = require("../utils/logger");
@@ -15,13 +16,31 @@ const COMPLEX_HINTS = [
     "graph",
     "and",
 ];
-function triageTask(task) {
+/**
+ * 带原因说明的 triage 启发式判定。
+ * 既返回 simple/complex 决策，也返回匹配到的关键词、任务长度与触发来源，
+ * 供 triage 准确率数据收集使用。
+ */
+function triageTaskExplain(task) {
     const normalized = task.toLowerCase();
-    const hitCount = COMPLEX_HINTS.filter((hint) => normalized.includes(hint)).length;
-    if (task.length > 80 || hitCount >= 2) {
-        return "complex";
-    }
-    return "simple";
+    const matchedKeywords = COMPLEX_HINTS.filter((hint) => normalized.includes(hint));
+    const longEnough = task.length > 80;
+    const keywordHit = matchedKeywords.length >= 2;
+    const isComplex = longEnough || keywordHit;
+    let triggeredBy = "default";
+    if (longEnough && keywordHit)
+        triggeredBy = "both";
+    else if (longEnough)
+        triggeredBy = "length";
+    else if (keywordHit)
+        triggeredBy = "keywords";
+    return {
+        decision: isComplex ? "complex" : "simple",
+        reason: { matchedKeywords, taskLength: task.length, triggeredBy },
+    };
+}
+function triageTask(task) {
+    return triageTaskExplain(task).decision;
 }
 async function triageTaskLlm(task, selection, context) {
     if (!task.trim()) {

package/dist/core/triage.js.map

@@ -1 +1 @@
-{"version":3,"file":"triage.js","sourceRoot":"","sources":["../../src/core/triage.ts"],"names":[],"mappings":";;AAkBA,gCASC;AAED,sCAyCC;AAtED,4CAAyC;AAEzC,oEAAqF;AAIrF,MAAM,aAAa,GAAG;IACpB,OAAO;IACP,QAAQ;IACR,UAAU;IACV,cAAc;IACd,QAAQ;IACR,UAAU;IACV,KAAK;IACL,OAAO;IACP,KAAK;CACN,CAAC;AAEF,SAAgB,UAAU,CAAC,IAAY;IACrC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAElF,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,SAAyB,EACzB,OAAuB;IAEvB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG;QACb,oFAAoF;QACpF,2GAA2G;QAC3G,sGAAsG;QACtG,8FAA8F;QAC9F,SAAS,IAAI,EAAE;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAA,qCAAiB,EAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEzC,IACE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC5B,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAC3D,CAAC;YACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,cAAc,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}
+{"version":3,"file":"triage.js","sourceRoot":"","sources":["../../src/core/triage.ts"],"names":[],"mappings":";;AAwCA,8CAgBC;AAED,gCAEC;AAED,sCAyCC;AAvGD,4CAAyC;AAEzC,oEAAqF;AAIrF,MAAM,aAAa,GAAG;IACpB,OAAO;IACP,QAAQ;IACR,UAAU;IACV,cAAc;IACd,QAAQ;IACR,UAAU;IACV,KAAK;IACL,OAAO;IACP,KAAK;CACN,CAAC;AAmBF;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACpC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,IAAI,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,UAAU,IAAI,UAAU,CAAC;IAE3C,IAAI,WAAW,GAAgC,SAAS,CAAC;IACzD,IAAI,UAAU,IAAI,UAAU;QAAE,WAAW,GAAG,MAAM,CAAC;SAC9C,IAAI,UAAU;QAAE,WAAW,GAAG,QAAQ,CAAC;SACvC,IAAI,UAAU;QAAE,WAAW,GAAG,UAAU,CAAC;IAE9C,OAAO;QACL,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;QAC1C,MAAM,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE;KAClE,CAAC;AACJ,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;AAC1C,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,SAAyB,EACzB,OAAuB;IAEvB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG;QACb,oFAAoF;QACpF,2GAA2G;QAC3G,sGAAsG;QACtG,8FAA8F;QAC9F,SAAS,IAAI,EAAE;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAA,qCAAiB,EAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEzC,IACE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC5B,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAC3D,CAAC;YACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,cAAc,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/core/types.d.ts

@@ -1,5 +1,15 @@
+import type { GraphClient } from "../graph/client-factory.js";
 export type TaskStatus = "PENDING" | "RUNNING" | "VALIDATING" | "COMPLETED" | "FAILED" | "HUMAN_REVIEW_REQUIRED" | "DELEGATED";
 export type AgentRole = "planner" | "worker" | "validator" | "enricher" | "evolver" | "compressor";
+/**
+ * Agent 专业领域类型，用于多 Agent 协作编排时标注建议的执行角色。
+ * - frontend: 前端相关（ui/component/css/style）
+ * - backend: 后端相关（api/server/database/model）
+ * - testing: 测试相关（test/testing）
+ * - docs: 文档相关（doc/readme/changelog）
+ * - general: 通用任务（默认）
+ */
+export type AgentSpecialty = "frontend" | "backend" | "testing" | "docs" | "general";
 export interface ValidationResult {
     passed: boolean;
     feedback: string;
@@ -49,6 +59,11 @@ export interface TaskRunResult {
             expectedFormat: string;
         }>;
         insightSummary?: string;
+        /** 多 Agent 协作编排：每个任务节点建议的 agent 专业领域映射 */
+        agentAssignments?: Array<{
+            taskId: string;
+            specialty: AgentSpecialty;
+        }>;
     };
 }
 export interface TaskNode {
@@ -58,11 +73,49 @@ export interface TaskNode {
     status: TaskStatus;
     contextQuery: string;
     retryCount: number;
+    /** 指定执行该节点的 agent 角色（AgentSpecialty），用于多 Agent 协作编排 */
+    assignedAgent?: AgentSpecialty;
 }
 export interface OrchestrationInput {
     task: string;
     maxRetries?: number;
 }
+export interface OrchestrateOptions {
+    graphClient?: GraphClient;
+    enableAutoGraphSync?: boolean;
+    enableNearLosslessMode?: boolean;
+    nearLosslessQuery?: string;
+    maxContextTokens?: number;
+    layerQuota?: {
+        l1: number;
+        l2: number;
+        l3: number;
+    };
+    onContextPackage?: (pkg: import("../graph/context-slicer").LayeredContextPackage) => void;
+    providerHealth?: import("../routing/model-router").ProviderHealthMap;
+    providerFallbackChain?: import("../routing/model-router").ProviderName[];
+    enableSkillFlywheel?: boolean;
+    skillHintsLimit?: number;
+    /** 预置种子技能：在技能飞轮启用时，于 orchestrator 首次运行时写入常见工程技能基线（幂等）。 */
+    enableSeedSkills?: boolean;
+    enableLlmAgents?: boolean;
+    enableDriftReplan?: boolean;
+    maxReplanRounds?: number;
+    enableGraphContextInPrompt?: boolean;
+    enableEpisodicMemory?: boolean;
+    enableLlmTriage?: boolean;
+    embeddingProvider?: import("../learning/embeddings").EmbeddingProvider;
+    configPath?: string;
+    executionMode?: "bridge" | "llm";
+    /** Enable zero-cost graph-structure compression (edge weights + PageRank). Default true. */
+    enableGraphCompression?: boolean;
+    /** Adaptively size the context token budget from task complexity. Auto-enabled for complex tasks unless false. */
+    enableAdaptiveBudget?: boolean;
+    /** Return module-level RepoMap overview when budget is tight. Default false. */
+    enableRepoMapFallback?: boolean;
+    /** Run Six Hats plan_insight before complex DAG planning. Default true for complex tasks. */
+    enablePlanInsight?: boolean;
+}
 export interface GraphNode {
     id: string;
     type: "File" | "Symbol" | "Module" | "TaskRun" | "Decision" | "Skill";

package/dist/core/types.d.ts.map

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

package/dist/graph/context-slicer-types.d.ts

@@ -0,0 +1,62 @@
+import type { GraphEdge, GraphNode } from "../core/types.js";
+import type { EmbeddingProvider } from "../learning/embeddings.js";
+import type { ConnectedSubgraphOptions } from "./graph-compression.js";
+import type { ClusteringOptions, SummarizerOptions, DensifierOptions } from "./semantic-compression.js";
+import type { TaskMode } from "./adaptive-budget.js";
+import type { CompressionModelHandle } from "./compression-model.js";
+export interface ContextSlice {
+    items: string[];
+    tokenEstimate: number;
+}
+export type ContextLayer = "L1" | "L2" | "L3";
+export interface ContextAnchorItem {
+    id: string;
+    type: GraphNode["type"];
+    layer: ContextLayer;
+}
+export interface LayeredContextPackage {
+    summaryChannel: string[];
+    anchorChannel: ContextAnchorItem[];
+    tokenEstimate: number;
+    truncated: boolean;
+}
+export interface LayeredPackageOptions {
+    layerQuota?: {
+        l1: number;
+        l2: number;
+        l3: number;
+    };
+    enableEdgeExpansion?: boolean;
+    enableVectorRecall?: boolean;
+    embeddingProvider?: EmbeddingProvider;
+    vectorTopK?: number;
+    vectorMinSimilarity?: number;
+    /** Use HNSW ANN index for large candidate sets (>=200 nodes). Default true. */
+    enableHnsw?: boolean;
+    /** Enable graph-structure compression (edge weights, PageRank, connected subgraph). */
+    enableGraphCompression?: boolean;
+    graphCompressionOptions?: ConnectedSubgraphOptions;
+    /** Enable semantic compression via minicpm-1b (clustering, summarization, densification). */
+    enableSemanticCompression?: boolean;
+    clusteringOptions?: ClusteringOptions;
+    summarizerOptions?: SummarizerOptions;
+    densifierOptions?: DensifierOptions;
+    /** Unified compression model handle (auto-selects external economy tier or embedded minicpm). */
+    compressionModel?: CompressionModelHandle;
+    /** Return RepoMap overview if token budget is low. */
+    enableRepoMapFallback?: boolean;
+    /** Adaptive budget estimation based on task complexity. */
+    taskMode?: TaskMode;
+}
+export interface SubgraphExpansionOptions {
+    hops?: number;
+    maxNodes?: number;
+    relations?: GraphEdge["relation"][];
+}
+export interface ContextRefillManager {
+    initialPackage(query: string): Promise<LayeredContextPackage>;
+    refill(evidenceHints: string[]): Promise<string[]>;
+}
+export declare const DEFAULT_EXPANSION_RELATIONS: GraphEdge["relation"][];
+export declare const ARCHITECTURE_QUERY: RegExp;
+//# sourceMappingURL=context-slicer-types.d.ts.map

package/dist/graph/context-slicer-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-slicer-types.d.ts","sourceRoot":"","sources":["../../src/graph/context-slicer-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACxG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uFAAuF;IACvF,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,uBAAuB,CAAC,EAAE,wBAAwB,CAAC;IACnD,6FAA6F;IAC7F,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC9D,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,2BAA2B,EAAE,SAAS,CAAC,UAAU,CAAC,EAO9D,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAA+C,CAAC"}

package/dist/graph/context-slicer-types.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARCHITECTURE_QUERY = exports.DEFAULT_EXPANSION_RELATIONS = void 0;
+exports.DEFAULT_EXPANSION_RELATIONS = [
+    "references",
+    "imports",
+    "depends_on",
+    "prerequisite",
+    "calls",
+    "defines",
+];
+exports.ARCHITECTURE_QUERY = /architecture|refactor|module|design|架构|模块/i;
+//# sourceMappingURL=context-slicer-types.js.map

package/dist/graph/context-slicer-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-slicer-types.js","sourceRoot":"","sources":["../../src/graph/context-slicer-types.ts"],"names":[],"mappings":";;;AAmEa,QAAA,2BAA2B,GAA4B;IAClE,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,cAAc;IACd,OAAO;IACP,SAAS;CACV,CAAC;AAEW,QAAA,kBAAkB,GAAG,4CAA4C,CAAC"}

package/dist/graph/context-slicer-utils.d.ts

@@ -0,0 +1,24 @@
+import type { GraphNode } from "../core/types.js";
+import type { ContextLayer, ContextAnchorItem } from "./context-slicer-types.js";
+export declare function getEncoder(): ((text: string) => number[]) | null;
+export declare function estimateTokens(text: string): number;
+export declare function summarizeNodes(nodes: GraphNode[]): string[];
+export declare function classifyLayer(node: GraphNode): ContextLayer;
+export declare function canUseLayer(layer: ContextLayer, quota: {
+    l1: number;
+    l2: number;
+    l3: number;
+}, used: {
+    l1: number;
+    l2: number;
+    l3: number;
+}): boolean;
+export declare function markLayerUsed(layer: ContextLayer, used: {
+    l1: number;
+    l2: number;
+    l3: number;
+}): void;
+export declare function modulePathKey(relPath: string): string;
+export declare function deriveModuleId(anchor: ContextAnchorItem, node?: GraphNode): string | undefined;
+export declare function extractFileFromSymbolId(id: string): string | undefined;
+//# sourceMappingURL=context-slicer-utils.d.ts.map

package/dist/graph/context-slicer-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-slicer-utils.d.ts","sourceRoot":"","sources":["../../src/graph/context-slicer-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAKjF,wBAAgB,UAAU,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC,GAAG,IAAI,CAyBhE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYnD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAE3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,CAU3D;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAC7C,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAUT;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYrG;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAgB9F;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUtE"}

package/dist/graph/context-slicer-utils.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEncoder = getEncoder;
+exports.estimateTokens = estimateTokens;
+exports.summarizeNodes = summarizeNodes;
+exports.classifyLayer = classifyLayer;
+exports.canUseLayer = canUseLayer;
+exports.markLayerUsed = markLayerUsed;
+exports.modulePathKey = modulePathKey;
+exports.deriveModuleId = deriveModuleId;
+exports.extractFileFromSymbolId = extractFileFromSymbolId;
+const logger_js_1 = require("../utils/logger.js");
+let encoderFn = null;
+let encoderLoaded = false;
+function getEncoder() {
+    if (encoderLoaded)
+        return encoderFn;
+    encoderLoaded = true;
+    try {
+        const mod = require("gpt-tokenizer/encoding/o200k_base");
+        if (typeof mod.encode === "function") {
+            encoderFn = mod.encode.bind(mod);
+            return encoderFn;
+        }
+    }
+    catch (error) {
+        logger_js_1.logger.error({ error }, "Caught error");
+        // fall through
+    }
+    try {
+        const mod = require("gpt-tokenizer");
+        if (typeof mod.encode === "function") {
+            encoderFn = mod.encode.bind(mod);
+            return encoderFn;
+        }
+    }
+    catch (error) {
+        logger_js_1.logger.error({ error }, "Caught error");
+        // fall through
+    }
+    encoderFn = null;
+    return null;
+}
+function estimateTokens(text) {
+    const enc = getEncoder();
+    if (enc) {
+        try {
+            const n = enc(text).length;
+            return Math.max(1, n);
+        }
+        catch (error) {
+            logger_js_1.logger.error({ error }, "Caught error");
+            // fall back below
+        }
+    }
+    return Math.max(1, Math.ceil(text.length / 4));
+}
+function summarizeNodes(nodes) {
+    return nodes.map((node) => `${node.type}(${node.id})`);
+}
+function classifyLayer(node) {
+    if (node.type === "File" || node.type === "Symbol") {
+        return "L1";
+    }
+    if (node.type === "Module") {
+        return "L2";
+    }
+    return "L3";
+}
+function canUseLayer(layer, quota, used) {
+    if (layer === "L1") {
+        return used.l1 < quota.l1;
+    }
+    if (layer === "L2") {
+        return used.l2 < quota.l2;
+    }
+    return used.l3 < quota.l3;
+}
+function markLayerUsed(layer, used) {
+    if (layer === "L1") {
+        used.l1 += 1;
+        return;
+    }
+    if (layer === "L2") {
+        used.l2 += 1;
+        return;
+    }
+    used.l3 += 1;
+}
+function modulePathKey(relPath) {
+    return relPath.replace(/\.(ts|tsx|js|jsx|md|json|py|rs|go|hpp|hxx|cpp|cxx|cc|h|c|java|rb|rake|gemspec)$/i, "");
+}
+function deriveModuleId(anchor, node) {
+    if (anchor.type === "File" && anchor.id.startsWith("file:")) {
+        return `module:${modulePathKey(anchor.id.slice("file:".length))}`;
+    }
+    if (anchor.type === "Symbol") {
+        const filePath = typeof node?.metadata?.file === "string"
+            ? node.metadata.file
+            : extractFileFromSymbolId(anchor.id);
+        if (filePath) {
+            return `module:${modulePathKey(filePath)}`;
+        }
+    }
+    return undefined;
+}
+function extractFileFromSymbolId(id) {
+    if (!id.startsWith("symbol:")) {
+        return undefined;
+    }
+    const body = id.slice("symbol:".length);
+    const hashIndex = body.lastIndexOf(":");
+    if (hashIndex > 0) {
+        return body.slice(0, hashIndex);
+    }
+    return undefined;
+}
+//# sourceMappingURL=context-slicer-utils.js.map

package/dist/graph/context-slicer-utils.js.map

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

package/dist/graph/context-slicer.d.ts

@@ -1,69 +1,14 @@
-import type { GraphEdge, GraphNode } from "../core/types";
-import { type EmbeddingProvider } from "../learning/embeddings";
-import type { GraphClient } from "./client-factory";
-import { type ConnectedSubgraphOptions } from "./graph-compression";
-import { type ClusteringOptions, type SummarizerOptions, type DensifierOptions } from "./semantic-compression";
-import { type TaskMode } from "./adaptive-budget";
-import type { CompressionModelHandle } from "./compression-model";
-export interface ContextSlice {
-    items: string[];
-    tokenEstimate: number;
-}
-export type ContextLayer = "L1" | "L2" | "L3";
-export interface ContextAnchorItem {
-    id: string;
-    type: GraphNode["type"];
-    layer: ContextLayer;
-}
-export interface LayeredContextPackage {
-    summaryChannel: string[];
-    anchorChannel: ContextAnchorItem[];
-    tokenEstimate: number;
-    truncated: boolean;
-}
-export interface LayeredPackageOptions {
-    layerQuota?: {
-        l1: number;
-        l2: number;
-        l3: number;
-    };
-    enableEdgeExpansion?: boolean;
-    enableVectorRecall?: boolean;
-    embeddingProvider?: EmbeddingProvider;
-    vectorTopK?: number;
-    vectorMinSimilarity?: number;
-    /** Use HNSW ANN index for large candidate sets (>=200 nodes). Default true. */
-    enableHnsw?: boolean;
-    /** Enable graph-structure compression (edge weights, PageRank, connected subgraph). */
-    enableGraphCompression?: boolean;
-    graphCompressionOptions?: ConnectedSubgraphOptions;
-    /** Enable semantic compression via minicpm-1b (clustering, summarization, densification). */
-    enableSemanticCompression?: boolean;
-    clusteringOptions?: ClusteringOptions;
-    summarizerOptions?: SummarizerOptions;
-    densifierOptions?: DensifierOptions;
-    /** Unified compression model handle (auto-selects external economy tier or embedded minicpm). */
-    compressionModel?: CompressionModelHandle;
-    /** Return RepoMap overview if token budget is low. */
-    enableRepoMapFallback?: boolean;
-    /** Adaptive budget estimation based on task complexity. */
-    taskMode?: TaskMode;
-}
-export interface SubgraphExpansionOptions {
-    hops?: number;
-    maxNodes?: number;
-    relations?: GraphEdge["relation"][];
-}
+import type { GraphNode } from "../core/types.js";
+import type { GraphClient } from "./client-factory.js";
+export type { ContextSlice, ContextLayer, ContextAnchorItem, LayeredContextPackage, LayeredPackageOptions, SubgraphExpansionOptions, ContextRefillManager, } from "./context-slicer-types.js";
+export { DEFAULT_EXPANSION_RELATIONS, ARCHITECTURE_QUERY, } from "./context-slicer-types.js";
+export { getEncoder, estimateTokens, summarizeNodes, classifyLayer, canUseLayer, markLayerUsed, modulePathKey, deriveModuleId, extractFileFromSymbolId, } from "./context-slicer-utils.js";
+import type { ContextSlice, LayeredContextPackage, LayeredPackageOptions, SubgraphExpansionOptions, ContextRefillManager } from "./context-slicer-types.js";
 export declare function expandSubgraph(client: GraphClient, seedIds: string[], options?: SubgraphExpansionOptions): Promise<GraphNode[]>;
 export declare function buildContextSlice(client: GraphClient, query: string, maxTokens: number): Promise<ContextSlice>;
 export declare function vectorRecall(nodes: GraphNode[], queryEmbedding: number[], topK: number, minSimilarity: number): GraphNode[];
 export declare function buildLayeredContextPackage(client: GraphClient, query: string, maxTokens: number, options?: LayeredPackageOptions): Promise<LayeredContextPackage>;
-export interface ContextRefillManager {
-    initialPackage(query: string): Promise<LayeredContextPackage>;
-    refill(evidenceHints: string[]): Promise<string[]>;
-}
 export declare function createContextRefillManager(client: GraphClient, maxTokens: number, options?: LayeredPackageOptions): ContextRefillManager;
-export declare function summarizeNodes(nodes: GraphNode[]): string[];
 /**
  * Enhanced context packaging with graph-structure compression, semantic
  * compression (minicpm-1b), and adaptive budgeting.

package/dist/graph/context-slicer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-slicer.d.ts","sourceRoot":"","sources":["../../src/graph/context-slicer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context-slicer.d.ts","sourceRoot":"","sources":["../../src/graph/context-slicer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAMlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAcvD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,UAAU,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAYnC,OAAO,KAAK,EACV,YAAY,EAEZ,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAGnC,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,SAAS,EAAE,CAAC,CAyBtB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAGvB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,EAAE,EAClB,cAAc,EAAE,MAAM,EAAE,EACxB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GACpB,SAAS,EAAE,CAWb;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAoJhC;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAsCtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAyJhC"}