pulseed 0.4.18 → 0.4.19

package/dist/orchestrator/execution/agent-loop/task-agent-loop-worktree.js

@@ -0,0 +1,145 @@
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { mkdir, realpath, rm } from "node:fs/promises";
+import { execFileNoThrow } from "../../../base/utils/execFileNoThrow.js";
+export async function prepareTaskAgentLoopWorkspace(input) {
+    const requestedCwd = await realpath(input.cwd ?? process.cwd());
+    const policy = input.policy ?? {};
+    if (!policy.enabled) {
+        return {
+            requestedCwd,
+            executionCwd: requestedCwd,
+            isolated: false,
+            finalize: async () => ({
+                requestedCwd,
+                executionCwd: requestedCwd,
+                isolated: false,
+                cleanupStatus: "not_requested",
+            }),
+        };
+    }
+    const repoRoot = await resolveGitRepoRoot(requestedCwd);
+    if (!repoRoot) {
+        return {
+            requestedCwd,
+            executionCwd: requestedCwd,
+            isolated: false,
+            finalize: async () => ({
+                requestedCwd,
+                executionCwd: requestedCwd,
+                isolated: false,
+                cleanupStatus: "not_requested",
+                cleanupReason: "cwd is not inside a git repository",
+            }),
+        };
+    }
+    const headRef = await resolveHeadRef(repoRoot);
+    if (!headRef) {
+        return {
+            requestedCwd,
+            executionCwd: requestedCwd,
+            isolated: false,
+            finalize: async () => ({
+                requestedCwd,
+                executionCwd: requestedCwd,
+                isolated: false,
+                cleanupStatus: "not_requested",
+                cleanupReason: "git HEAD could not be resolved",
+            }),
+        };
+    }
+    const relativeCwd = path.relative(repoRoot, requestedCwd);
+    const baseDir = policy.baseDir ?? path.join(path.dirname(repoRoot), `${path.basename(repoRoot)}.pulseed-agentloop-worktrees`);
+    const worktreePath = path.join(baseDir, sanitizePathSegment(input.task.id), randomUUID().slice(0, 8));
+    await mkdir(path.dirname(worktreePath), { recursive: true });
+    const addResult = await execFileNoThrow("git", ["worktree", "add", "--detach", worktreePath, headRef], {
+        cwd: repoRoot,
+        timeoutMs: 60_000,
+    });
+    if ((addResult.exitCode ?? 1) !== 0) {
+        return {
+            requestedCwd,
+            executionCwd: requestedCwd,
+            isolated: false,
+            finalize: async () => ({
+                requestedCwd,
+                executionCwd: requestedCwd,
+                isolated: false,
+                cleanupStatus: "not_requested",
+                cleanupReason: `git worktree add failed: ${addResult.stderr || addResult.stdout}`.trim(),
+            }),
+        };
+    }
+    const executionCwd = relativeCwd && relativeCwd !== "."
+        ? path.join(worktreePath, relativeCwd)
+        : worktreePath;
+    return {
+        requestedCwd,
+        executionCwd,
+        isolated: true,
+        finalize: async ({ success, changedFiles }) => {
+            const cleanupPolicy = policy.cleanupPolicy ?? "on_success";
+            const shouldKeepForDebug = policy.keepForDebug === true;
+            const isDirty = changedFiles.length > 0 || await isGitWorktreeDirty(worktreePath);
+            if (shouldKeepForDebug) {
+                return {
+                    requestedCwd,
+                    executionCwd,
+                    isolated: true,
+                    cleanupStatus: "kept",
+                    cleanupReason: "keepForDebug enabled",
+                };
+            }
+            if (cleanupPolicy === "never") {
+                return {
+                    requestedCwd,
+                    executionCwd,
+                    isolated: true,
+                    cleanupStatus: "kept",
+                    cleanupReason: "cleanup policy set to never",
+                };
+            }
+            if (cleanupPolicy === "on_success" && (!success || isDirty)) {
+                return {
+                    requestedCwd,
+                    executionCwd,
+                    isolated: true,
+                    cleanupStatus: "kept",
+                    cleanupReason: !success ? "task did not succeed" : "worktree has changes",
+                };
+            }
+            await removeGitWorktree(repoRoot, worktreePath);
+            return {
+                requestedCwd,
+                executionCwd,
+                isolated: true,
+                cleanupStatus: "cleaned_up",
+            };
+        },
+    };
+}
+async function resolveGitRepoRoot(cwd) {
+    const result = await execFileNoThrow("git", ["rev-parse", "--show-toplevel"], { cwd, timeoutMs: 10_000 });
+    return (result.exitCode ?? 1) === 0 ? await realpath(result.stdout.trim()) : null;
+}
+async function resolveHeadRef(cwd) {
+    const result = await execFileNoThrow("git", ["rev-parse", "--verify", "HEAD"], { cwd, timeoutMs: 10_000 });
+    return (result.exitCode ?? 1) === 0 ? result.stdout.trim() : null;
+}
+async function isGitWorktreeDirty(cwd) {
+    const result = await execFileNoThrow("git", ["status", "--porcelain", "--untracked-files=all"], { cwd, timeoutMs: 10_000 });
+    return (result.exitCode ?? 1) === 0 ? result.stdout.trim().length > 0 : false;
+}
+async function removeGitWorktree(repoRoot, worktreePath) {
+    const removeResult = await execFileNoThrow("git", ["worktree", "remove", "--force", worktreePath], {
+        cwd: repoRoot,
+        timeoutMs: 60_000,
+    });
+    if ((removeResult.exitCode ?? 1) !== 0) {
+        await rm(worktreePath, { recursive: true, force: true });
+    }
+}
+function sanitizePathSegment(value) {
+    return value.replace(/[^a-zA-Z0-9._-]+/g, "-");
+}
+//# sourceMappingURL=task-agent-loop-worktree.js.map

package/dist/orchestrator/execution/agent-loop/task-agent-loop-worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-agent-loop-worktree.js","sourceRoot":"","sources":["../../../../src/orchestrator/execution/agent-loop/task-agent-loop-worktree.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/execution/checkpoint-manager.d.ts

@@ -0,0 +1,49 @@
+import { StateManager } from '../../base/state/state-manager.js';
+import { Checkpoint, CheckpointIndex } from '../../base/types/checkpoint.js';
+import type { IPromptGateway } from '../../prompt/gateway.js';
+interface LLMClient {
+    chat(messages: Array<{
+        role: string;
+        content: string;
+    }>): Promise<{
+        content: string;
+    }>;
+}
+interface Logger {
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+interface CheckpointManagerDeps {
+    stateManager: StateManager;
+    llmClient?: LLMClient;
+    logger?: Logger;
+    gateway?: IPromptGateway;
+}
+export declare class CheckpointManager {
+    private readonly deps;
+    constructor(deps: CheckpointManagerDeps);
+    private indexPath;
+    private checkpointPath;
+    private readIndex;
+    private writeIndex;
+    saveCheckpoint(params: {
+        goalId: string;
+        taskId: string;
+        agentId: string;
+        sessionContextSnapshot: string;
+        intermediateResults?: string[];
+        metadata?: Record<string, unknown>;
+    }): Promise<Checkpoint>;
+    loadCheckpoint(goalId: string, taskId?: string): Promise<Checkpoint | null>;
+    loadAndAdaptCheckpoint(goalId: string, currentAgentId: string, taskId?: string): Promise<{
+        checkpoint: Checkpoint;
+        adaptedContext: string;
+        wasAdapted: boolean;
+    } | null>;
+    listCheckpoints(goalId: string): Promise<CheckpointIndex['checkpoints']>;
+    deleteCheckpoint(goalId: string, checkpointId: string): Promise<void>;
+    garbageCollect(goalId: string, maxAgeDays?: number): Promise<number>;
+}
+export {};
+//# sourceMappingURL=checkpoint-manager.d.ts.map

package/dist/orchestrator/execution/checkpoint-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/execution/checkpoint-manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EACL,UAAU,EAEV,eAAe,EAEhB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,UAAU,SAAS;IACjB,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxF;AAED,UAAU,MAAM;IACd,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAMD,UAAU,qBAAqB;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,qBAAqB;IAExD,OAAO,CAAC,SAAS,CAA0D;IAC3E,OAAO,CAAC,cAAc,CACyB;YAEjC,SAAS;YAWT,UAAU;IAIlB,cAAc,CAAC,MAAM,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,UAAU,CAAC;IAkCjB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAsB3E,sBAAsB,CAC1B,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAqCpF,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAKxE,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrE,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAwBtE"}

package/dist/orchestrator/execution/checkpoint-manager.js

@@ -0,0 +1,143 @@
+import { randomUUID } from 'node:crypto';
+import { promises as fsp } from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+import { CheckpointSchema, CheckpointIndexSchema, } from '../../base/types/checkpoint.js';
+const CheckpointAdaptResponseSchema = z.object({
+    adapted_context: z.string(),
+});
+export class CheckpointManager {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    indexPath = (goalId) => `checkpoints/${goalId}/index.json`;
+    checkpointPath = (goalId, checkpointId) => `checkpoints/${goalId}/${checkpointId}.json`;
+    async readIndex(goalId) {
+        const raw = await this.deps.stateManager.readRaw(this.indexPath(goalId));
+        if (!raw)
+            return { goal_id: goalId, checkpoints: [] };
+        try {
+            return CheckpointIndexSchema.parse(raw);
+        }
+        catch {
+            this.deps.logger?.warn('checkpoint index parse failed, resetting', { goalId });
+            return { goal_id: goalId, checkpoints: [] };
+        }
+    }
+    async writeIndex(index) {
+        await this.deps.stateManager.writeRaw(this.indexPath(index.goal_id), index);
+    }
+    async saveCheckpoint(params) {
+        const checkpoint = CheckpointSchema.parse({
+            checkpoint_id: randomUUID(),
+            goal_id: params.goalId,
+            task_id: params.taskId,
+            agent_id: params.agentId,
+            session_context_snapshot: params.sessionContextSnapshot,
+            intermediate_results: params.intermediateResults ?? [],
+            created_at: new Date().toISOString(),
+            metadata: params.metadata ?? {},
+        });
+        await this.deps.stateManager.writeRaw(this.checkpointPath(params.goalId, checkpoint.checkpoint_id), checkpoint);
+        const index = await this.readIndex(params.goalId);
+        index.checkpoints.push({
+            checkpoint_id: checkpoint.checkpoint_id,
+            task_id: checkpoint.task_id,
+            agent_id: checkpoint.agent_id,
+            created_at: checkpoint.created_at,
+        });
+        await this.writeIndex(index);
+        this.deps.logger?.info('checkpoint saved', {
+            checkpointId: checkpoint.checkpoint_id,
+            goalId: params.goalId,
+        });
+        return checkpoint;
+    }
+    async loadCheckpoint(goalId, taskId) {
+        const index = await this.readIndex(goalId);
+        let entries = index.checkpoints;
+        if (taskId)
+            entries = entries.filter((e) => e.task_id === taskId);
+        if (entries.length === 0)
+            return null;
+        const latest = entries.reduce((a, b) => (a.created_at > b.created_at ? a : b));
+        const raw = await this.deps.stateManager.readRaw(this.checkpointPath(goalId, latest.checkpoint_id));
+        if (!raw)
+            return null;
+        try {
+            return CheckpointSchema.parse(raw);
+        }
+        catch {
+            this.deps.logger?.warn('checkpoint parse failed', {
+                checkpointId: latest.checkpoint_id,
+            });
+            return null;
+        }
+    }
+    async loadAndAdaptCheckpoint(goalId, currentAgentId, taskId) {
+        const checkpoint = await this.loadCheckpoint(goalId, taskId);
+        if (!checkpoint)
+            return null;
+        if (checkpoint.agent_id === currentAgentId) {
+            return { checkpoint, adaptedContext: checkpoint.session_context_snapshot, wasAdapted: false };
+        }
+        if (!this.deps.llmClient && !this.deps.gateway) {
+            return { checkpoint, adaptedContext: checkpoint.session_context_snapshot, wasAdapted: false };
+        }
+        const prompt = `You are helping transfer context from agent '${checkpoint.agent_id}' to agent '${currentAgentId}'. ` +
+            `Summarize and adapt the following session context and intermediate results for the new agent to continue the work.\n\n` +
+            `Context:\n${checkpoint.session_context_snapshot}\n\n` +
+            `Intermediate Results:\n${checkpoint.intermediate_results.join('\n')}`;
+        try {
+            if (this.deps.gateway) {
+                const result = await this.deps.gateway.execute({
+                    purpose: "checkpoint_adapt",
+                    goalId,
+                    additionalContext: { adapt_prompt: prompt },
+                    responseSchema: CheckpointAdaptResponseSchema,
+                });
+                return { checkpoint, adaptedContext: result.adapted_context, wasAdapted: true };
+            }
+            else {
+                const response = await this.deps.llmClient.chat([{ role: 'user', content: prompt }]);
+                return { checkpoint, adaptedContext: response.content, wasAdapted: true };
+            }
+        }
+        catch (err) {
+            this.deps.logger?.error('context adaptation failed', { error: String(err) });
+            return { checkpoint, adaptedContext: checkpoint.session_context_snapshot, wasAdapted: false };
+        }
+    }
+    async listCheckpoints(goalId) {
+        const index = await this.readIndex(goalId);
+        return index.checkpoints;
+    }
+    async deleteCheckpoint(goalId, checkpointId) {
+        const filePath = path.join(this.deps.stateManager.getBaseDir(), this.checkpointPath(goalId, checkpointId));
+        await fsp.unlink(filePath).catch((err) => {
+            console.error("[CheckpointManager] failed to delete checkpoint file:", err instanceof Error ? err.message : err);
+        });
+        const index = await this.readIndex(goalId);
+        index.checkpoints = index.checkpoints.filter((e) => e.checkpoint_id !== checkpointId);
+        await this.writeIndex(index);
+        this.deps.logger?.info('checkpoint deleted', { checkpointId, goalId });
+    }
+    async garbageCollect(goalId, maxAgeDays = 7) {
+        const index = await this.readIndex(goalId);
+        const cutoff = Date.now() - maxAgeDays * 86_400_000;
+        const toDelete = index.checkpoints.filter((e) => new Date(e.created_at).getTime() < cutoff);
+        for (const entry of toDelete) {
+            const filePath = path.join(this.deps.stateManager.getBaseDir(), this.checkpointPath(goalId, entry.checkpoint_id));
+            await fsp.unlink(filePath).catch((err) => {
+                console.error("[CheckpointManager] failed to delete checkpoint file during GC:", err instanceof Error ? err.message : err);
+            });
+        }
+        const deletedIds = new Set(toDelete.map((e) => e.checkpoint_id));
+        index.checkpoints = index.checkpoints.filter((e) => !deletedIds.has(e.checkpoint_id));
+        await this.writeIndex(index);
+        this.deps.logger?.info('garbage collected checkpoints', { goalId, count: toDelete.length });
+        return toDelete.length;
+    }
+}
+//# sourceMappingURL=checkpoint-manager.js.map

package/dist/orchestrator/execution/checkpoint-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager.js","sourceRoot":"","sources":["../../../src/orchestrator/execution/checkpoint-manager.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/execution/context/context-budget.d.ts

@@ -0,0 +1,35 @@
+import type { TierBudget } from "../../../base/types/memory-lifecycle.js";
+/**
+ * Distributes a total token budget across memory tiers.
+ * - core: 50% (always included items)
+ * - recall: 35% (recent observations, strategy history)
+ * - archival: remaining (completed-goal knowledge)
+ */
+export declare function allocateTierBudget(totalTokens: number): TierBudget;
+export interface BudgetAllocation {
+    goalDefinition: number;
+    observations: number;
+    knowledge: number;
+    transferKnowledge: number;
+    meta: number;
+}
+export declare function allocateBudget(totalBudget: number): BudgetAllocation;
+/** Estimate token count. Heuristic: 1 token ≈ 4 characters. */
+export declare function estimateTokens(text: string): number;
+/**
+ * Select candidates greedily by similarity (descending) until the budget is exhausted.
+ * Assumes `candidates` is already sorted by similarity descending.
+ */
+export declare function selectWithinBudget<T extends {
+    text: string;
+    similarity: number;
+}>(candidates: T[], budgetTokens: number): T[];
+/**
+ * When total actual usage exceeds the budget, reduce allocations starting from
+ * the lowest-priority categories.
+ *
+ * Priority order (highest first): observations, knowledge, goalDefinition,
+ * transferKnowledge, meta.
+ */
+export declare function trimToBudget(allocation: BudgetAllocation, actualUsage: Record<keyof BudgetAllocation, number>, totalBudget: number): BudgetAllocation;
+//# sourceMappingURL=context-budget.d.ts.map

package/dist/orchestrator/execution/context/context-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/execution/context/context-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAI1E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAKlE;AAID,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAQpE;AAID,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAC/E,UAAU,EAAE,CAAC,EAAE,EACf,YAAY,EAAE,MAAM,GACnB,CAAC,EAAE,CAUL;AAID;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,gBAAgB,EAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,gBAAgB,EAAE,MAAM,CAAC,EACnD,WAAW,EAAE,MAAM,GAClB,gBAAgB,CAmBlB"}

package/dist/orchestrator/execution/context/context-budget.js

@@ -0,0 +1,73 @@
+// ─── Tier Budget Allocation ───
+/**
+ * Distributes a total token budget across memory tiers.
+ * - core: 50% (always included items)
+ * - recall: 35% (recent observations, strategy history)
+ * - archival: remaining (completed-goal knowledge)
+ */
+export function allocateTierBudget(totalTokens) {
+    const core = Math.floor(totalTokens * 0.50);
+    const recall = Math.floor(totalTokens * 0.35);
+    const archival = totalTokens - core - recall;
+    return { core, recall, archival };
+}
+export function allocateBudget(totalBudget) {
+    return {
+        goalDefinition: Math.floor(totalBudget * 0.20),
+        observations: Math.floor(totalBudget * 0.30),
+        knowledge: Math.floor(totalBudget * 0.30),
+        transferKnowledge: Math.floor(totalBudget * 0.15),
+        meta: Math.floor(totalBudget * 0.05),
+    };
+}
+// ─── Token Estimation ───
+/** Estimate token count. Heuristic: 1 token ≈ 4 characters. */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+// ─── Progressive Disclosure Selection ───
+/**
+ * Select candidates greedily by similarity (descending) until the budget is exhausted.
+ * Assumes `candidates` is already sorted by similarity descending.
+ */
+export function selectWithinBudget(candidates, budgetTokens) {
+    const selected = [];
+    let usedTokens = 0;
+    for (const candidate of candidates) {
+        const tokens = estimateTokens(candidate.text);
+        if (usedTokens + tokens > budgetTokens)
+            break;
+        selected.push(candidate);
+        usedTokens += tokens;
+    }
+    return selected;
+}
+// ─── Budget Trimming ───
+/**
+ * When total actual usage exceeds the budget, reduce allocations starting from
+ * the lowest-priority categories.
+ *
+ * Priority order (highest first): observations, knowledge, goalDefinition,
+ * transferKnowledge, meta.
+ */
+export function trimToBudget(allocation, actualUsage, totalBudget) {
+    const trimOrder = [
+        "meta",
+        "transferKnowledge",
+        "goalDefinition",
+        "knowledge",
+        "observations",
+    ];
+    const result = { ...allocation };
+    let totalUsed = Object.values(actualUsage).reduce((a, b) => a + b, 0);
+    for (const category of trimOrder) {
+        if (totalUsed <= totalBudget)
+            break;
+        const excess = totalUsed - totalBudget;
+        const reduction = Math.min(result[category], excess);
+        result[category] -= reduction;
+        totalUsed -= reduction;
+    }
+    return result;
+}
+//# sourceMappingURL=context-budget.js.map

package/dist/orchestrator/execution/context/context-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget.js","sourceRoot":"","sources":["../../../../src/orchestrator/execution/context/context-budget.ts"],"names":[],"mappings":"AAEA,iCAAiC;AAEjC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,WAAW,GAAG,IAAI,GAAG,MAAM,CAAC;IAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC;AAYD,MAAM,UAAU,cAAc,CAAC,WAAmB;IAChD,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QAC9C,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5C,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACzC,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACjD,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,2BAA2B;AAE3B,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,2CAA2C;AAE3C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAe,EACf,YAAoB;IAEpB,MAAM,QAAQ,GAAQ,EAAE,CAAC;IACzB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,UAAU,GAAG,MAAM,GAAG,YAAY;YAAE,MAAM;QAC9C,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzB,UAAU,IAAI,MAAM,CAAC;IACvB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0BAA0B;AAE1B;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA4B,EAC5B,WAAmD,EACnD,WAAmB;IAEnB,MAAM,SAAS,GAA+B;QAC5C,MAAM;QACN,mBAAmB;QACnB,gBAAgB;QAChB,WAAW;QACX,cAAc;KACf,CAAC;IACF,MAAM,MAAM,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;IACjC,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,SAAS,IAAI,WAAW;YAAE,MAAM;QACpC,MAAM,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;QAC9B,SAAS,IAAI,SAAS,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/orchestrator/execution/context/context-builder.d.ts

@@ -0,0 +1,52 @@
+import type { ContextSlot } from "../../../base/types/session.js";
+import type { KnowledgeEntry } from "../../../base/types/knowledge.js";
+import type { KnowledgeGraph } from "../../../platform/knowledge/knowledge-graph.js";
+import type { VectorIndex } from "../../../platform/knowledge/vector-index.js";
+import { estimateTokens } from "./context-budget.js";
+export { estimateTokens };
+export declare const DEFAULT_CONTEXT_BUDGET = 50000;
+/**
+ * Compresses a context slot to fit within maxTokens.
+ * Uses head + tail strategy: keeps first 60% and last 40% of allowed chars.
+ */
+export declare function compressSlot(slot: ContextSlot, maxTokens: number): ContextSlot;
+/**
+ * Filters context slots to fit within a token budget.
+ *
+ * Slots are sorted by priority (ascending = higher priority first).
+ * Slots are accumulated until the budget is exceeded; any slot that
+ * would push the total over budget is dropped along with all subsequent slots.
+ *
+ * The returned array preserves the original slot order.
+ */
+export declare function filterSlotsByBudget(slots: ContextSlot[], budget: number): ContextSlot[];
+/**
+ * Inject relevant KnowledgeEntry items into an existing set of context slots.
+ *
+ * Each non-superseded entry is formatted as structured text and appended as
+ * a new low-priority context slot (`domain_knowledge`). Empty entry arrays
+ * are a no-op — the original slots are returned unchanged.
+ */
+export declare function injectKnowledgeContext(slots: ContextSlot[], entries: KnowledgeEntry[]): ContextSlot[];
+export declare function mergeWorkingMemorySelections<T extends {
+    id: string;
+}>(tagSelected: T[], semanticSelected: T[], budget: number): T[];
+export declare function expandKnowledgeEntriesWithGraph(entries: KnowledgeEntry[], allEntries: KnowledgeEntry[], graph: KnowledgeGraph): {
+    relatedEntries: KnowledgeEntry[];
+    contradictionWarnings: string[];
+};
+/**
+ * Phase 2 (Progressive Disclosure): Inject knowledge context using semantic search.
+ * 1. searchMetadata() — fetch id+score for up to 20 candidates (no full text)
+ * 2. selectWithinBudget() — pick candidates that fit the knowledge budget
+ * 3. getEntryById() — load full text only for selected candidates
+ *
+ * Falls back to empty if no vectorIndex available.
+ */
+export declare function injectSemanticKnowledgeContext(slots: ContextSlot[], query: string, vectorIndex: VectorIndex | undefined, contextBudget?: number): Promise<ContextSlot[]>;
+/**
+ * Inject learning feedback into context slots.
+ * Adds a single "learning_feedback" slot containing all feedback strings.
+ */
+export declare function injectLearningFeedback(slots: ContextSlot[], feedback: string[]): ContextSlot[];
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/orchestrator/execution/context/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../src/orchestrator/execution/context/context-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAsC,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAI7C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAkB9E;AAID;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAmBvF;AAID;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,EAAE,cAAc,EAAE,GACxB,WAAW,EAAE,CAwBf;AAED,wBAAgB,4BAA4B,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACnE,WAAW,EAAE,CAAC,EAAE,EAChB,gBAAgB,EAAE,CAAC,EAAE,EACrB,MAAM,EAAE,MAAM,GACb,CAAC,EAAE,CAYL;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,cAAc,EAAE,EACzB,UAAU,EAAE,cAAc,EAAE,EAC5B,KAAK,EAAE,cAAc,GACpB;IAAE,cAAc,EAAE,cAAc,EAAE,CAAC;IAAC,qBAAqB,EAAE,MAAM,EAAE,CAAA;CAAE,CA6BvE;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,aAAa,GAAE,MAA+B,GAC7C,OAAO,CAAC,WAAW,EAAE,CAAC,CAoCxB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAkB9F"}