anantham-v2 2.0.0-alpha.1

package/dist/context/context-engine.js

@@ -0,0 +1,313 @@
+import { randomUUID } from "node:crypto";
+import { ContentGuards } from "../content/content-guards.js";
+import { RepresentationSelector } from "../content/representation-selector.js";
+import { ContextPlanSchema } from "../domain/context.js";
+import { ToolResultPruner } from "./tool-result-pruner.js";
+export class ContextEngine {
+    static DEFAULT_MAX_TOKENS = 128000;
+    static PRIORITY_WEIGHTS = {
+        CRITICAL: 100,
+        HIGH: 75,
+        NORMAL: 50,
+        LOW: 25,
+        DROP: 0,
+    };
+    /**
+     * Assembles a deterministic, capability-matched, and security-validated ContextPlan.
+     * PRD Part 1 Sections 76-78 & PRD Part 2 Section 50.
+     */
+    static async assembleContext(req) {
+        const maxTokens = req.maxTotalTokens ?? this.DEFAULT_MAX_TOKENS;
+        const planId = `cpl_${randomUUID().slice(0, 12)}`;
+        const now = new Date().toISOString();
+        const items = [];
+        const omitted = [];
+        const decisions = [];
+        let currentTokens = 0;
+        let systemTokens = 0;
+        let toolSchemaTokens = 0;
+        let toolResultTokens = 0;
+        let itemTokens = 0;
+        // 1. Process System Prompt (Always Highest Priority / Authority: system)
+        if (req.systemPrompt) {
+            systemTokens = ContentGuards.estimateTokens(req.systemPrompt);
+            if (currentTokens + systemTokens <= maxTokens) {
+                items.push({
+                    id: `ctx_sys_${randomUUID().slice(0, 8)}`,
+                    sourceType: "system",
+                    sourceId: "sys_core_prompt",
+                    representationType: "text",
+                    priority: "CRITICAL",
+                    estimatedTokens: systemTokens,
+                    selectedBecause: "Root system prompt and operational instructions",
+                    authority: "system",
+                    content: req.systemPrompt,
+                });
+                currentTokens += systemTokens;
+                decisions.push({
+                    decisionType: "include",
+                    rationale: "Included authoritative system prompt",
+                    affectedItems: ["sys_core_prompt"],
+                });
+            }
+        }
+        // 2. Process Tool Schemas
+        if (req.toolSchemas && req.toolSchemas.length > 0) {
+            for (const tool of req.toolSchemas) {
+                const schemaString = JSON.stringify(tool.schema);
+                const tokens = tool.estimatedTokens ?? ContentGuards.estimateTokens(schemaString);
+                if (currentTokens + tokens <= maxTokens) {
+                    items.push({
+                        id: `ctx_tool_${tool.name}`,
+                        sourceType: "tool-schema",
+                        sourceId: `tool_${tool.name}`,
+                        representationType: "json",
+                        priority: "HIGH",
+                        estimatedTokens: tokens,
+                        selectedBecause: `Tool schema for '${tool.name}'`,
+                        authority: "system",
+                        content: schemaString,
+                        metadata: { toolName: tool.name },
+                    });
+                    currentTokens += tokens;
+                    toolSchemaTokens += tokens;
+                }
+                else {
+                    omitted.push({
+                        sourceId: `tool_${tool.name}`,
+                        reason: "Tool schema exceeded context token budget",
+                        estimatedTokens: tokens,
+                    });
+                    decisions.push({
+                        decisionType: "defer-schema",
+                        rationale: `Deferred tool schema '${tool.name}' due to budget constraints`,
+                        affectedItems: [`tool_${tool.name}`],
+                    });
+                }
+            }
+        }
+        // 3. Process Tool Results with Pruning
+        if (req.toolResults && req.toolResults.length > 0) {
+            for (const res of req.toolResults) {
+                const pruneResult = ToolResultPruner.prune(res.rawOutput, {
+                    maxChars: 4000,
+                    artifactRefUri: res.artifactUri,
+                });
+                if (pruneResult.wasPruned) {
+                    decisions.push({
+                        decisionType: "prune-tool-result",
+                        rationale: `Pruned oversized output for tool '${res.toolName}' while preserving errors and diagnostics`,
+                        affectedItems: [`tool_res_${res.toolName}`],
+                    });
+                }
+                if (currentTokens + pruneResult.estimatedTokens <= maxTokens) {
+                    items.push({
+                        id: `ctx_res_${res.toolName}_${randomUUID().slice(0, 6)}`,
+                        sourceType: "task",
+                        sourceId: `tool_res_${res.toolName}`,
+                        representationType: "text",
+                        priority: "HIGH",
+                        estimatedTokens: pruneResult.estimatedTokens,
+                        selectedBecause: `Execution result from tool '${res.toolName}'`,
+                        authority: "tool-output",
+                        content: pruneResult.content,
+                        uri: res.artifactUri,
+                    });
+                    currentTokens += pruneResult.estimatedTokens;
+                    toolResultTokens += pruneResult.estimatedTokens;
+                }
+                else {
+                    omitted.push({
+                        sourceId: `tool_res_${res.toolName}`,
+                        reason: "Pruned tool result exceeded context token budget",
+                        estimatedTokens: pruneResult.estimatedTokens,
+                    });
+                }
+            }
+        }
+        // 4. Filter, Capability-Match, and Rank Candidates
+        const scoredCandidates = [];
+        for (const cand of req.candidates) {
+            // 4a. Project Isolation & Boundary Guard
+            if (cand.projectId && cand.projectId !== req.projectId) {
+                omitted.push({
+                    sourceId: cand.sourceId,
+                    reason: `Cross-project boundary violation: candidate project '${cand.projectId}' != requested '${req.projectId}'`,
+                    estimatedTokens: 0,
+                });
+                decisions.push({
+                    decisionType: "omit",
+                    rationale: `Rejected cross-project candidate '${cand.sourceId}'`,
+                    affectedItems: [cand.sourceId],
+                });
+                continue;
+            }
+            // 4b. Explicit DROP priority
+            if (cand.priority === "DROP") {
+                omitted.push({
+                    sourceId: cand.sourceId,
+                    reason: "Explicit DROP priority assigned",
+                    estimatedTokens: 0,
+                });
+                continue;
+            }
+            // 4c. Modality & Representation Resolution
+            let repType = "text";
+            let contentStr = cand.rawContent;
+            let uri = cand.uri;
+            let tokens = 0;
+            if (cand.contentObject) {
+                try {
+                    const selection = RepresentationSelector.selectOptimalRepresentation(cand.contentObject, req.modelProfile);
+                    repType = selection.representation.type;
+                    tokens = selection.estimatedTokens;
+                    if (typeof selection.representation.data === "string") {
+                        contentStr = selection.representation.data;
+                    }
+                    else if (selection.representation.uri) {
+                        uri = selection.representation.uri;
+                    }
+                }
+                catch {
+                    omitted.push({
+                        sourceId: cand.sourceId,
+                        reason: "No compatible representation found for model modality profile",
+                        estimatedTokens: 0,
+                    });
+                    decisions.push({
+                        decisionType: "omit",
+                        rationale: `Omitted candidate '${cand.sourceId}' due to unsupported modality`,
+                        affectedItems: [cand.sourceId],
+                    });
+                    continue;
+                }
+            }
+            else if (contentStr) {
+                tokens = ContentGuards.estimateTokens(contentStr);
+            }
+            const score = this.PRIORITY_WEIGHTS[cand.priority] ?? 50;
+            scoredCandidates.push({
+                candidate: cand,
+                representationType: repType,
+                content: contentStr,
+                uri,
+                tokens,
+                score,
+            });
+        }
+        // 5. Deterministic Sort: Highest Score first, then deterministic tie-breaker by sourceId
+        scoredCandidates.sort((a, b) => {
+            if (b.score !== a.score)
+                return b.score - a.score;
+            return a.candidate.sourceId.localeCompare(b.candidate.sourceId);
+        });
+        // 6. Token Budget Allocation for Candidates
+        for (const scored of scoredCandidates) {
+            if (currentTokens + scored.tokens <= maxTokens) {
+                items.push({
+                    id: scored.candidate.id || `ctx_${randomUUID().slice(0, 8)}`,
+                    sourceType: scored.candidate.sourceType,
+                    sourceId: scored.candidate.sourceId,
+                    representationType: scored.representationType,
+                    priority: scored.candidate.priority,
+                    estimatedTokens: scored.tokens,
+                    selectedBecause: scored.candidate.selectedBecause,
+                    authority: scored.candidate.authority,
+                    content: scored.content,
+                    uri: scored.uri,
+                    metadata: scored.candidate.metadata,
+                });
+                currentTokens += scored.tokens;
+                itemTokens += scored.tokens;
+                decisions.push({
+                    decisionType: "include",
+                    rationale: `Selected item '${scored.candidate.sourceId}' (priority: ${scored.candidate.priority})`,
+                    affectedItems: [scored.candidate.sourceId],
+                });
+            }
+            else {
+                omitted.push({
+                    sourceId: scored.candidate.sourceId,
+                    reason: `Exceeded context token budget (needed ${scored.tokens} tokens, remaining ${maxTokens - currentTokens})`,
+                    estimatedTokens: scored.tokens,
+                });
+                decisions.push({
+                    decisionType: "omit",
+                    rationale: `Omitted item '${scored.candidate.sourceId}' due to token budget overflow`,
+                    affectedItems: [scored.candidate.sourceId],
+                });
+            }
+        }
+        // 7. Assemble and Validate ContextPlan
+        const plan = {
+            id: planId,
+            items,
+            estimatedTokens: currentTokens,
+            modalityUsage: {
+                text: itemTokens + systemTokens + toolSchemaTokens + toolResultTokens,
+            },
+            omitted,
+            decisions,
+            checkpointSource: req.checkpointSource,
+            createdAt: now,
+        };
+        return Object.freeze(ContextPlanSchema.parse(plan));
+    }
+    /**
+     * Generates an operational inspection report for the /context command.
+     * PRD Part 1 Section 77.
+     */
+    static inspectContext(plan, budget = 128000) {
+        let systemTokens = 0;
+        let toolSchemasTokens = 0;
+        let toolResultsTokens = 0;
+        let itemTokens = 0;
+        for (const item of plan.items) {
+            if (item.sourceType === "system") {
+                systemTokens += item.estimatedTokens;
+            }
+            else if (item.sourceType === "tool-schema") {
+                toolSchemasTokens += item.estimatedTokens;
+            }
+            else if (item.authority === "tool-output") {
+                toolResultsTokens += item.estimatedTokens;
+            }
+            else {
+                itemTokens += item.estimatedTokens;
+            }
+        }
+        return {
+            planId: plan.id,
+            totalEstimatedTokens: plan.estimatedTokens,
+            budget,
+            remainingTokens: Math.max(0, budget - plan.estimatedTokens),
+            selectedItemsCount: plan.items.length,
+            omittedItemsCount: plan.omitted.length,
+            tokenBreakdown: {
+                system: systemTokens,
+                toolSchemas: toolSchemasTokens,
+                items: itemTokens,
+                toolResults: toolResultsTokens,
+            },
+            selectedItems: plan.items.map((i) => ({
+                id: i.id,
+                sourceType: i.sourceType,
+                priority: i.priority,
+                tokens: i.estimatedTokens,
+                because: i.selectedBecause,
+                authority: i.authority,
+            })),
+            omittedItems: plan.omitted.map((o) => ({
+                sourceId: o.sourceId,
+                reason: o.reason,
+                tokens: o.estimatedTokens,
+            })),
+            decisions: plan.decisions.map((d) => ({
+                decisionType: d.decisionType,
+                rationale: d.rationale,
+                affectedItems: d.affectedItems,
+            })),
+        };
+    }
+}
+//# sourceMappingURL=context-engine.js.map

package/dist/context/context-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-engine.js","sourceRoot":"","sources":["../../src/context/context-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAA6B,MAAM,uCAAuC,CAAC;AAS1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAoF3D,MAAM,OAAO,aAAa;IAChB,MAAM,CAAU,kBAAkB,GAAG,MAAM,CAAC;IAC5C,MAAM,CAAU,gBAAgB,GAAoC;QAC1E,QAAQ,EAAE,GAAG;QACb,IAAI,EAAE,EAAE;QACR,MAAM,EAAE,EAAE;QACV,GAAG,EAAE,EAAE;QACP,IAAI,EAAE,CAAC;KACR,CAAC;IAEF;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,GAA2B;QAC7D,MAAM,SAAS,GAAG,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,kBAAkB,CAAC;QAChE,MAAM,MAAM,GAAG,OAAO,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,MAAM,KAAK,GAAkB,EAAE,CAAC;QAChC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,MAAM,SAAS,GAAsB,EAAE,CAAC;QAExC,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,yEAAyE;QACzE,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,YAAY,GAAG,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC9D,IAAI,aAAa,GAAG,YAAY,IAAI,SAAS,EAAE,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE,EAAE,WAAW,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;oBACzC,UAAU,EAAE,QAAQ;oBACpB,QAAQ,EAAE,iBAAiB;oBAC3B,kBAAkB,EAAE,MAAM;oBAC1B,QAAQ,EAAE,UAAU;oBACpB,eAAe,EAAE,YAAY;oBAC7B,eAAe,EAAE,iDAAiD;oBAClE,SAAS,EAAE,QAAQ;oBACnB,OAAO,EAAE,GAAG,CAAC,YAAY;iBAC1B,CAAC,CAAC;gBACH,aAAa,IAAI,YAAY,CAAC;gBAC9B,SAAS,CAAC,IAAI,CAAC;oBACb,YAAY,EAAE,SAAS;oBACvB,SAAS,EAAE,sCAAsC;oBACjD,aAAa,EAAE,CAAC,iBAAiB,CAAC;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACnC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACjD,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,IAAI,aAAa,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;gBAElF,IAAI,aAAa,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,YAAY,IAAI,CAAC,IAAI,EAAE;wBAC3B,UAAU,EAAE,aAAa;wBACzB,QAAQ,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;wBAC7B,kBAAkB,EAAE,MAAM;wBAC1B,QAAQ,EAAE,MAAM;wBAChB,eAAe,EAAE,MAAM;wBACvB,eAAe,EAAE,oBAAoB,IAAI,CAAC,IAAI,GAAG;wBACjD,SAAS,EAAE,QAAQ;wBACnB,OAAO,EAAE,YAAY;wBACrB,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE;qBAClC,CAAC,CAAC;oBACH,aAAa,IAAI,MAAM,CAAC;oBACxB,gBAAgB,IAAI,MAAM,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC;wBACX,QAAQ,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;wBAC7B,MAAM,EAAE,2CAA2C;wBACnD,eAAe,EAAE,MAAM;qBACxB,CAAC,CAAC;oBACH,SAAS,CAAC,IAAI,CAAC;wBACb,YAAY,EAAE,cAAc;wBAC5B,SAAS,EAAE,yBAAyB,IAAI,CAAC,IAAI,6BAA6B;wBAC1E,aAAa,EAAE,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;qBACrC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBAClC,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE;oBACxD,QAAQ,EAAE,IAAI;oBACd,cAAc,EAAE,GAAG,CAAC,WAAW;iBAChC,CAAC,CAAC;gBAEH,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;oBAC1B,SAAS,CAAC,IAAI,CAAC;wBACb,YAAY,EAAE,mBAAmB;wBACjC,SAAS,EAAE,qCAAqC,GAAG,CAAC,QAAQ,2CAA2C;wBACvG,aAAa,EAAE,CAAC,YAAY,GAAG,CAAC,QAAQ,EAAE,CAAC;qBAC5C,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,aAAa,GAAG,WAAW,CAAC,eAAe,IAAI,SAAS,EAAE,CAAC;oBAC7D,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,WAAW,GAAG,CAAC,QAAQ,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;wBACzD,UAAU,EAAE,MAAM;wBAClB,QAAQ,EAAE,YAAY,GAAG,CAAC,QAAQ,EAAE;wBACpC,kBAAkB,EAAE,MAAM;wBAC1B,QAAQ,EAAE,MAAM;wBAChB,eAAe,EAAE,WAAW,CAAC,eAAe;wBAC5C,eAAe,EAAE,+BAA+B,GAAG,CAAC,QAAQ,GAAG;wBAC/D,SAAS,EAAE,aAAa;wBACxB,OAAO,EAAE,WAAW,CAAC,OAAO;wBAC5B,GAAG,EAAE,GAAG,CAAC,WAAW;qBACrB,CAAC,CAAC;oBACH,aAAa,IAAI,WAAW,CAAC,eAAe,CAAC;oBAC7C,gBAAgB,IAAI,WAAW,CAAC,eAAe,CAAC;gBAClD,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC;wBACX,QAAQ,EAAE,YAAY,GAAG,CAAC,QAAQ,EAAE;wBACpC,MAAM,EAAE,kDAAkD;wBAC1D,eAAe,EAAE,WAAW,CAAC,eAAe;qBAC7C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,MAAM,gBAAgB,GAOjB,EAAE,CAAC;QAER,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAClC,yCAAyC;YACzC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,MAAM,EAAE,wDAAwD,IAAI,CAAC,SAAS,mBAAmB,GAAG,CAAC,SAAS,GAAG;oBACjH,eAAe,EAAE,CAAC;iBACnB,CAAC,CAAC;gBACH,SAAS,CAAC,IAAI,CAAC;oBACb,YAAY,EAAE,MAAM;oBACpB,SAAS,EAAE,qCAAqC,IAAI,CAAC,QAAQ,GAAG;oBAChE,aAAa,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;iBAC/B,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,6BAA6B;YAC7B,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,MAAM,EAAE,iCAAiC;oBACzC,eAAe,EAAE,CAAC;iBACnB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,2CAA2C;YAC3C,IAAI,OAAO,GAAG,MAAM,CAAC;YACrB,IAAI,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YACjC,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YACnB,IAAI,MAAM,GAAG,CAAC,CAAC;YAEf,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,sBAAsB,CAAC,2BAA2B,CAClE,IAAI,CAAC,aAAa,EAClB,GAAG,CAAC,YAAY,CACjB,CAAC;oBACF,OAAO,GAAG,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC;oBACxC,MAAM,GAAG,SAAS,CAAC,eAAe,CAAC;oBACnC,IAAI,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACtD,UAAU,GAAG,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC;oBAC7C,CAAC;yBAAM,IAAI,SAAS,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;wBACxC,GAAG,GAAG,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC;oBACrC,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,IAAI,CAAC;wBACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,MAAM,EAAE,+DAA+D;wBACvE,eAAe,EAAE,CAAC;qBACnB,CAAC,CAAC;oBACH,SAAS,CAAC,IAAI,CAAC;wBACb,YAAY,EAAE,MAAM;wBACpB,SAAS,EAAE,sBAAsB,IAAI,CAAC,QAAQ,+BAA+B;wBAC7E,aAAa,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;qBAC/B,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;YACH,CAAC;iBAAM,IAAI,UAAU,EAAE,CAAC;gBACtB,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YACpD,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEzD,gBAAgB,CAAC,IAAI,CAAC;gBACpB,SAAS,EAAE,IAAI;gBACf,kBAAkB,EAAE,OAAO;gBAC3B,OAAO,EAAE,UAAU;gBACnB,GAAG;gBACH,MAAM;gBACN,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAED,yFAAyF;QACzF,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC7B,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;gBAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YAClD,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,4CAA4C;QAC5C,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;YACtC,IAAI,aAAa,GAAG,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;gBAC/C,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,OAAO,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;oBAC5D,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU;oBACvC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ;oBACnC,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;oBAC7C,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ;oBACnC,eAAe,EAAE,MAAM,CAAC,MAAM;oBAC9B,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe;oBACjD,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS;oBACrC,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,GAAG,EAAE,MAAM,CAAC,GAAG;oBACf,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ;iBACpC,CAAC,CAAC;gBACH,aAAa,IAAI,MAAM,CAAC,MAAM,CAAC;gBAC/B,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC;gBAC5B,SAAS,CAAC,IAAI,CAAC;oBACb,YAAY,EAAE,SAAS;oBACvB,SAAS,EAAE,kBAAkB,MAAM,CAAC,SAAS,CAAC,QAAQ,gBAAgB,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG;oBAClG,aAAa,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;iBAC3C,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ;oBACnC,MAAM,EAAE,yCAAyC,MAAM,CAAC,MAAM,sBAAsB,SAAS,GAAG,aAAa,GAAG;oBAChH,eAAe,EAAE,MAAM,CAAC,MAAM;iBAC/B,CAAC,CAAC;gBACH,SAAS,CAAC,IAAI,CAAC;oBACb,YAAY,EAAE,MAAM;oBACpB,SAAS,EAAE,iBAAiB,MAAM,CAAC,SAAS,CAAC,QAAQ,gCAAgC;oBACrF,aAAa,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;iBAC3C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,MAAM,IAAI,GAAgB;YACxB,EAAE,EAAE,MAAM;YACV,KAAK;YACL,eAAe,EAAE,aAAa;YAC9B,aAAa,EAAE;gBACb,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,gBAAgB,GAAG,gBAAgB;aACtE;YACD,OAAO;YACP,SAAS;YACT,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,SAAS,EAAE,GAAG;SACf,CAAC;QAEF,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,cAAc,CAAC,IAAiB,EAAE,MAAM,GAAG,MAAM;QAC7D,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACjC,YAAY,IAAI,IAAI,CAAC,eAAe,CAAC;YACvC,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;gBAC7C,iBAAiB,IAAI,IAAI,CAAC,eAAe,CAAC;YAC5C,CAAC;iBAAM,IAAI,IAAI,CAAC,SAAS,KAAK,aAAa,EAAE,CAAC;gBAC5C,iBAAiB,IAAI,IAAI,CAAC,eAAe,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,UAAU,IAAI,IAAI,CAAC,eAAe,CAAC;YACrC,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,oBAAoB,EAAE,IAAI,CAAC,eAAe;YAC1C,MAAM;YACN,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC;YAC3D,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACrC,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YACtC,cAAc,EAAE;gBACd,MAAM,EAAE,YAAY;gBACpB,WAAW,EAAE,iBAAiB;gBAC9B,KAAK,EAAE,UAAU;gBACjB,WAAW,EAAE,iBAAiB;aAC/B;YACD,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,MAAM,EAAE,CAAC,CAAC,eAAe;gBACzB,OAAO,EAAE,CAAC,CAAC,eAAe;gBAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;aACvB,CAAC,CAAC;YACH,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrC,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,MAAM,EAAE,CAAC,CAAC,eAAe;aAC1B,CAAC,CAAC;YACH,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,aAAa,EAAE,CAAC,CAAC,aAAa;aAC/B,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC"}

package/dist/context/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./tool-result-pruner.js";
+export * from "./context-engine.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}

package/dist/context/index.js

@@ -0,0 +1,3 @@
+export * from "./tool-result-pruner.js";
+export * from "./context-engine.js";
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}

package/dist/context/tool-result-pruner.d.ts

@@ -0,0 +1,22 @@
+export interface ToolPruneOptions {
+    maxChars?: number;
+    artifactRefUri?: string;
+    preserveErrors?: boolean;
+}
+export interface ToolPruneResult {
+    content: string;
+    wasPruned: boolean;
+    estimatedTokens: number;
+    originalSizeBytes: number;
+    prunedSizeBytes: number;
+}
+export declare class ToolResultPruner {
+    private static readonly DEFAULT_MAX_CHARS;
+    /**
+     * Intelligently prunes large tool execution results while preserving critical status,
+     * error messages, diagnostic traces, and artifact references.
+     * PRD Part 1 Section 78.
+     */
+    static prune(rawResult: string | Record<string, unknown>, options?: ToolPruneOptions): ToolPruneResult;
+}
+//# sourceMappingURL=tool-result-pruner.d.ts.map

package/dist/context/tool-result-pruner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-pruner.d.ts","sourceRoot":"","sources":["../../src/context/tool-result-pruner.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAEjD;;;;OAIG;WACW,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe;CAiD9G"}

package/dist/context/tool-result-pruner.js

@@ -0,0 +1,48 @@
+import { ContentGuards } from "../content/content-guards.js";
+export class ToolResultPruner {
+    static DEFAULT_MAX_CHARS = 4000;
+    /**
+     * Intelligently prunes large tool execution results while preserving critical status,
+     * error messages, diagnostic traces, and artifact references.
+     * PRD Part 1 Section 78.
+     */
+    static prune(rawResult, options) {
+        const maxChars = options?.maxChars ?? this.DEFAULT_MAX_CHARS;
+        const text = typeof rawResult === "string" ? rawResult : JSON.stringify(rawResult, null, 2);
+        const originalSizeBytes = Buffer.byteLength(text, "utf8");
+        if (text.length <= maxChars) {
+            return {
+                content: text,
+                wasPruned: false,
+                estimatedTokens: ContentGuards.estimateTokens(text),
+                originalSizeBytes,
+                prunedSizeBytes: originalSizeBytes,
+            };
+        }
+        // Extract error traces if present
+        const lines = text.split("\n");
+        const errorLines = lines.filter((l) => /error|fail|exception|fatal|panic|traceback|syntaxerror|typeerror/i.test(l));
+        const headChars = Math.floor(maxChars * 0.4);
+        const tailChars = Math.floor(maxChars * 0.4);
+        const head = text.slice(0, headChars);
+        const tail = text.slice(text.length - tailChars);
+        let summaryBlock = `\n... [TRUNCATED: ${text.length - headChars - tailChars} characters pruned due to token budget] ...\n`;
+        if (options?.artifactRefUri) {
+            summaryBlock += `[Full tool output persisted at: ${options.artifactRefUri}]\n`;
+        }
+        if (errorLines.length > 0 && options?.preserveErrors !== false) {
+            const distinctErrors = Array.from(new Set(errorLines)).slice(0, 10).join("\n");
+            summaryBlock += `\n[Extracted Error Highlights]:\n${distinctErrors}\n`;
+        }
+        const prunedContent = `${head}${summaryBlock}${tail}`;
+        const prunedSizeBytes = Buffer.byteLength(prunedContent, "utf8");
+        return {
+            content: prunedContent,
+            wasPruned: true,
+            estimatedTokens: ContentGuards.estimateTokens(prunedContent),
+            originalSizeBytes,
+            prunedSizeBytes,
+        };
+    }
+}
+//# sourceMappingURL=tool-result-pruner.js.map

package/dist/context/tool-result-pruner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-pruner.js","sourceRoot":"","sources":["../../src/context/tool-result-pruner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAgB7D,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAU,iBAAiB,GAAG,IAAI,CAAC;IAEjD;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,SAA2C,EAAE,OAA0B;QACzF,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,iBAAiB,CAAC;QAC7D,MAAM,IAAI,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5F,MAAM,iBAAiB,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAE1D,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,KAAK;gBAChB,eAAe,EAAE,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC;gBACnD,iBAAiB;gBACjB,eAAe,EAAE,iBAAiB;aACnC,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,mEAAmE,CAAC,IAAI,CAAC,CAAC,CAAC,CACnF,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;QAE7C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QAEjD,IAAI,YAAY,GAAG,qBAAqB,IAAI,CAAC,MAAM,GAAG,SAAS,GAAG,SAAS,+CAA+C,CAAC;QAE3H,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;YAC5B,YAAY,IAAI,mCAAmC,OAAO,CAAC,cAAc,KAAK,CAAC;QACjF,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,EAAE,cAAc,KAAK,KAAK,EAAE,CAAC;YAC/D,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/E,YAAY,IAAI,oCAAoC,cAAc,IAAI,CAAC;QACzE,CAAC;QAED,MAAM,aAAa,GAAG,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,EAAE,CAAC;QACtD,MAAM,eAAe,GAAG,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAEjE,OAAO;YACL,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,IAAI;YACf,eAAe,EAAE,aAAa,CAAC,cAAc,CAAC,aAAa,CAAC;YAC5D,iBAAiB;YACjB,eAAe;SAChB,CAAC;IACJ,CAAC"}