pi-harness-runtime 0.9.2 → 0.9.5

package/packages/context-manager/dist/compaction.js

@@ -0,0 +1,110 @@
+/**
+ * Context Manager — Compaction Engine (RFC-0010)
+ */
+import { DEFAULT_POLICY } from "./core.js";
+import { prioritize } from "./core.js";
+/** Extract decisions from messages (lines starting with DECISION markers). */
+function extractDecisions(messages) {
+    const decisions = [];
+    for (const msg of messages) {
+        for (const line of msg.content.split("\n")) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("- DECISION:") ||
+                trimmed.startsWith("**DECISION**") ||
+                /^(?:decision|decided):/i.test(trimmed)) {
+                decisions.push(trimmed.replace(/^[*>-]+\s*/i, "").trim());
+            }
+        }
+    }
+    return [...new Set(decisions)];
+}
+/** Extract open questions (lines with ?, TODO, TBD, OPEN markers). */
+function extractQuestions(messages) {
+    const questions = [];
+    for (const msg of messages) {
+        for (const line of msg.content.split("\n")) {
+            const trimmed = line.trim();
+            if (trimmed.includes("?") ||
+                /\bTODO\b/i.test(trimmed) ||
+                /\bTBD\b/i.test(trimmed)) {
+                const cleaned = trimmed.replace(/^[*>-]+\s*/, "").trim();
+                if (cleaned.length > 5)
+                    questions.push(cleaned);
+            }
+        }
+    }
+    return [...new Set(questions)];
+}
+/** Extract task progress from messages. */
+function extractTaskProgress(messages) {
+    const progress = {};
+    for (const msg of messages) {
+        for (const line of msg.content.split("\n")) {
+            const match = line.match(/^(?:progress|task|step)[:\s]+([^|]+)\|\s*(.+)/i);
+            if (match)
+                progress[match[1].trim()] = match[2].trim();
+        }
+    }
+    return progress;
+}
+/** Compact context by extracting durable state and keeping high-priority items. */
+export function compactContext(messages, maxTokens, policy = DEFAULT_POLICY) {
+    const decisions = extractDecisions(messages);
+    const openQuestions = extractQuestions(messages);
+    const taskProgress = extractTaskProgress(messages);
+    const prioritized = prioritize(messages, Math.floor(messages.length * 0.6));
+    let tokenCount = 0;
+    const kept = [];
+    for (const msg of prioritized) {
+        if (tokenCount + msg.tokens <=
+            Math.floor(maxTokens * policy.compactThreshold)) {
+            kept.push(msg.content);
+            tokenCount += msg.tokens;
+        }
+    }
+    return {
+        decisions,
+        openQuestions,
+        taskProgress,
+        remainingTokens: tokenCount,
+        compactedContent: kept.join("\n\n"),
+    };
+}
+/** Generate a resume prompt from compaction result. */
+export function generateResumePrompt(result, nextAction) {
+    const summary = [
+        "## Session Summary",
+        `Decisions: ${result.decisions.length > 0 ? result.decisions.join("; ") : "none"}`,
+        `Questions: ${result.openQuestions.length > 0 ? result.openQuestions.join("; ") : "none"}`,
+        `Context size: ${result.remainingTokens} tokens`,
+    ].join("\n");
+    return {
+        summary,
+        decisions: result.decisions,
+        openQuestions: result.openQuestions,
+        taskProgress: result.taskProgress,
+        nextAction: nextAction ?? "Continue from last position",
+    };
+}
+/** Format resume prompt as markdown string. */
+export function formatResumeMarkdown(prompt) {
+    const lines = [
+        "# Resume Prompt",
+        "",
+        prompt.summary,
+        "",
+        "## Decisions",
+        ...prompt.decisions.map((d) => `- ${d}`),
+        "",
+        "## Open Questions",
+        ...prompt.openQuestions.map((q) => `- ${q}`),
+        "",
+        "## Task Progress",
+        ...Object.entries(prompt.taskProgress).map(([k, v]) => `- **${k}**: ${v}`),
+        "",
+        "## Next Action",
+        `- ${prompt.nextAction}`,
+    ];
+    return lines.filter((l) => l).join("\n");
+}
+//# sourceMappingURL=compaction.js.map

package/packages/context-manager/dist/compaction.js.map

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

package/packages/context-manager/dist/core.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Context Manager Core — pressure estimation, TTL, prioritization (RFC-0010)
+ */
+import type { PressureLevel, TriggerPolicy, ContextItem, SessionScope } from "./types.js";
+export declare const DEFAULT_POLICY: TriggerPolicy;
+/** Estimate context pressure as a ratio (0-1). */
+export declare function estimatePressure(currentTokens: number, maxTokens: number): number;
+/** Determine pressure level from a ratio. */
+export declare function getPressureLevel(pressure: number, policy?: TriggerPolicy): PressureLevel;
+/** Create a new session-scoped context bucket. */
+export declare function createSessionScope(id: string): SessionScope;
+/** Set TTL on a scope (in milliseconds). */
+export declare function setTTL(scope: SessionScope, ttlMs: number): SessionScope;
+/** Add an item to a session scope. */
+export declare function addToScope(scope: SessionScope, item: ContextItem): SessionScope;
+/** Remove expired items from a scope based on TTL. */
+export declare function evictExpired(scope: SessionScope): SessionScope;
+/** Prioritize items: lower priority number = higher importance. */
+export declare function prioritize(items: ContextItem[], limit?: number): ContextItem[];
+/** Count tokens using a simple word-based estimator (4 chars/token). */
+export declare function estimateTokens(text: string): number;
+/** Calculate total tokens in a list of items. */
+export declare function calculateTotalTokens(items: ContextItem[]): number;
+//# sourceMappingURL=core.d.ts.map

package/packages/context-manager/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,YAAY,EACZ,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,cAAc,EAAE,aAI5B,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,gBAAgB,CAC/B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GACf,MAAM,CAGR;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,aAA8B,GACpC,aAAa,CAKf;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAE3D;AAED,4CAA4C;AAC5C,wBAAgB,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAEvE;AAED,sCAAsC;AACtC,wBAAgB,UAAU,CACzB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,WAAW,GACf,YAAY,CAEd;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAS9D;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CACzB,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,CAAC,EAAE,MAAM,GACZ,WAAW,EAAE,CAGf;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,iDAAiD;AACjD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAEjE"}

package/packages/context-manager/dist/core.js

@@ -0,0 +1,62 @@
+/**
+ * Context Manager Core — pressure estimation, TTL, prioritization (RFC-0010)
+ */
+export const DEFAULT_POLICY = {
+    warningThreshold: 0.6,
+    compactThreshold: 0.7,
+    hardStopThreshold: 0.85,
+};
+/** Estimate context pressure as a ratio (0-1). */
+export function estimatePressure(currentTokens, maxTokens) {
+    if (maxTokens <= 0)
+        return 1;
+    return Math.min(currentTokens / maxTokens, 1);
+}
+/** Determine pressure level from a ratio. */
+export function getPressureLevel(pressure, policy = DEFAULT_POLICY) {
+    if (pressure >= policy.hardStopThreshold)
+        return "hard_stop";
+    if (pressure >= policy.compactThreshold)
+        return "compact";
+    if (pressure >= policy.warningThreshold)
+        return "warning";
+    return "normal";
+}
+/** Create a new session-scoped context bucket. */
+export function createSessionScope(id) {
+    return { id, items: [], ttlMs: 30 * 60 * 1000, createdAt: Date.now() };
+}
+/** Set TTL on a scope (in milliseconds). */
+export function setTTL(scope, ttlMs) {
+    return { ...scope, ttlMs };
+}
+/** Add an item to a session scope. */
+export function addToScope(scope, item) {
+    return { ...scope, items: [...scope.items, item] };
+}
+/** Remove expired items from a scope based on TTL. */
+export function evictExpired(scope) {
+    const now = Date.now();
+    return {
+        ...scope,
+        items: scope.items.filter((item) => {
+            if (!item.expiresAt)
+                return true;
+            return item.expiresAt > now;
+        }),
+    };
+}
+/** Prioritize items: lower priority number = higher importance. */
+export function prioritize(items, limit) {
+    const sorted = [...items].sort((a, b) => a.priority - b.priority);
+    return limit ? sorted.slice(0, limit) : sorted;
+}
+/** Count tokens using a simple word-based estimator (4 chars/token). */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/** Calculate total tokens in a list of items. */
+export function calculateTotalTokens(items) {
+    return items.reduce((sum, item) => sum + item.tokens, 0);
+}
+//# sourceMappingURL=core.js.map

package/packages/context-manager/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC5C,gBAAgB,EAAE,GAAG;IACrB,gBAAgB,EAAE,GAAG;IACrB,iBAAiB,EAAE,IAAI;CACvB,CAAC;AAEF,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAC/B,aAAqB,EACrB,SAAiB;IAEjB,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,gBAAgB,CAC/B,QAAgB,EAChB,MAAM,GAAkB,cAAc;IAEtC,IAAI,QAAQ,IAAI,MAAM,CAAC,iBAAiB;QAAE,OAAO,WAAW,CAAC;IAC7D,IAAI,QAAQ,IAAI,MAAM,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAC1D,IAAI,QAAQ,IAAI,MAAM,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAC1D,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC5C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;AACxE,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,MAAM,CAAC,KAAmB,EAAE,KAAa;IACxD,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,UAAU,CACzB,KAAmB,EACnB,IAAiB;IAEjB,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACN,GAAG,KAAK;QACR,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YAClC,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC;YACjC,OAAO,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QAC7B,CAAC,CAAC;KACF,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,UAAU,CACzB,KAAoB,EACpB,KAAc;IAEd,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,oBAAoB,CAAC,KAAoB;IACxD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/packages/context-manager/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Context Manager — Main Entry (RFC-0010)
+ */
+export { DEFAULT_POLICY, estimatePressure, getPressureLevel, createSessionScope, setTTL, addToScope, evictExpired, prioritize, estimateTokens, calculateTotalTokens, } from "./core.js";
+export { compactContext, generateResumePrompt, formatResumeMarkdown, } from "./compaction.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/context-manager/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,oBAAoB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACpB,MAAM,iBAAiB,CAAC;AACzB,mBAAmB,YAAY,CAAC"}

package/packages/context-manager/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * Context Manager — Main Entry (RFC-0010)
+ */
+export { DEFAULT_POLICY, estimatePressure, getPressureLevel, createSessionScope, setTTL, addToScope, evictExpired, prioritize, estimateTokens, calculateTotalTokens, } from "./core.js";
+export { compactContext, generateResumePrompt, formatResumeMarkdown, } from "./compaction.js";
+//# sourceMappingURL=index.js.map

package/packages/context-manager/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,oBAAoB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACpB,MAAM,iBAAiB,CAAC"}

package/packages/context-manager/dist/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Context Manager Types (RFC-0010)
+ */
+export type PressureLevel = "normal" | "warning" | "compact" | "hard_stop";
+export interface TriggerPolicy {
+    warningThreshold: number;
+    compactThreshold: number;
+    hardStopThreshold: number;
+}
+export interface ContextItem {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    tokens: number;
+    priority: number;
+    timestamp: number;
+    expiresAt?: number;
+}
+export interface CompactionResult {
+    decisions: string[];
+    openQuestions: string[];
+    taskProgress: Record<string, string>;
+    remainingTokens: number;
+    compactedContent: string;
+}
+export interface SessionScope {
+    id: string;
+    items: ContextItem[];
+    ttlMs: number;
+    createdAt: number;
+}
+export interface ResumePrompt {
+    summary: string;
+    decisions: string[];
+    openQuestions: string[];
+    taskProgress: Record<string, string>;
+    nextAction: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/context-manager/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACnB"}

package/packages/context-manager/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Context Manager Types (RFC-0010)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/context-manager/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/context-manager/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi-harness/context-manager",
+  "version": "0.9.5",
+  "description": "Context Window Manager — prevents model context overflow via compaction and resume prompts (RFC-0010)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "bun-types": "^1.0.0"
+  }
+}

package/packages/context-manager/src/compaction.ts

@@ -0,0 +1,139 @@
+/**
+ * Context Manager — Compaction Engine (RFC-0010)
+ */
+
+import type {
+	ContextItem,
+	CompactionResult,
+	ResumePrompt,
+	TriggerPolicy,
+} from "./types.js";
+import { DEFAULT_POLICY } from "./core.js";
+import { prioritize } from "./core.js";
+
+/** Extract decisions from messages (lines starting with DECISION markers). */
+function extractDecisions(messages: ContextItem[]): string[] {
+	const decisions: string[] = [];
+	for (const msg of messages) {
+		for (const line of msg.content.split("\n")) {
+			const trimmed = line.trim();
+			if (
+				trimmed.startsWith("- DECISION:") ||
+				trimmed.startsWith("**DECISION**") ||
+				/^(?:decision|decided):/i.test(trimmed)
+			) {
+				decisions.push(trimmed.replace(/^[*>-]+\s*/i, "").trim());
+			}
+		}
+	}
+	return [...new Set(decisions)];
+}
+
+/** Extract open questions (lines with ?, TODO, TBD, OPEN markers). */
+function extractQuestions(messages: ContextItem[]): string[] {
+	const questions: string[] = [];
+	for (const msg of messages) {
+		for (const line of msg.content.split("\n")) {
+			const trimmed = line.trim();
+			if (
+				trimmed.includes("?") ||
+				/\bTODO\b/i.test(trimmed) ||
+				/\bTBD\b/i.test(trimmed)
+			) {
+				const cleaned = trimmed.replace(/^[*>-]+\s*/, "").trim();
+				if (cleaned.length > 5) questions.push(cleaned);
+			}
+		}
+	}
+	return [...new Set(questions)];
+}
+
+/** Extract task progress from messages. */
+function extractTaskProgress(messages: ContextItem[]): Record<string, string> {
+	const progress: Record<string, string> = {};
+	for (const msg of messages) {
+		for (const line of msg.content.split("\n")) {
+			const match = line.match(
+				/^(?:progress|task|step)[:\s]+([^|]+)\|\s*(.+)/i,
+			);
+			if (match) progress[match[1].trim()] = match[2].trim();
+		}
+	}
+	return progress;
+}
+
+/** Compact context by extracting durable state and keeping high-priority items. */
+export function compactContext(
+	messages: ContextItem[],
+	maxTokens: number,
+	policy: TriggerPolicy = DEFAULT_POLICY,
+): CompactionResult {
+	const decisions = extractDecisions(messages);
+	const openQuestions = extractQuestions(messages);
+	const taskProgress = extractTaskProgress(messages);
+
+	const prioritized = prioritize(messages, Math.floor(messages.length * 0.6));
+	let tokenCount = 0;
+	const kept: string[] = [];
+
+	for (const msg of prioritized) {
+		if (
+			tokenCount + msg.tokens <=
+			Math.floor(maxTokens * policy.compactThreshold)
+		) {
+			kept.push(msg.content);
+			tokenCount += msg.tokens;
+		}
+	}
+
+	return {
+		decisions,
+		openQuestions,
+		taskProgress,
+		remainingTokens: tokenCount,
+		compactedContent: kept.join("\n\n"),
+	};
+}
+
+/** Generate a resume prompt from compaction result. */
+export function generateResumePrompt(
+	result: CompactionResult,
+	nextAction?: string,
+): ResumePrompt {
+	const summary = [
+		"## Session Summary",
+		`Decisions: ${result.decisions.length > 0 ? result.decisions.join("; ") : "none"}`,
+		`Questions: ${result.openQuestions.length > 0 ? result.openQuestions.join("; ") : "none"}`,
+		`Context size: ${result.remainingTokens} tokens`,
+	].join("\n");
+
+	return {
+		summary,
+		decisions: result.decisions,
+		openQuestions: result.openQuestions,
+		taskProgress: result.taskProgress,
+		nextAction: nextAction ?? "Continue from last position",
+	};
+}
+
+/** Format resume prompt as markdown string. */
+export function formatResumeMarkdown(prompt: ResumePrompt): string {
+	const lines = [
+		"# Resume Prompt",
+		"",
+		prompt.summary,
+		"",
+		"## Decisions",
+		...prompt.decisions.map((d) => `- ${d}`),
+		"",
+		"## Open Questions",
+		...prompt.openQuestions.map((q) => `- ${q}`),
+		"",
+		"## Task Progress",
+		...Object.entries(prompt.taskProgress).map(([k, v]) => `- **${k}**: ${v}`),
+		"",
+		"## Next Action",
+		`- ${prompt.nextAction}`,
+	];
+	return lines.filter((l) => l).join("\n");
+}

package/packages/context-manager/src/core.ts

@@ -0,0 +1,85 @@
+/**
+ * Context Manager Core — pressure estimation, TTL, prioritization (RFC-0010)
+ */
+
+import type {
+	PressureLevel,
+	TriggerPolicy,
+	ContextItem,
+	SessionScope,
+} from "./types.js";
+
+export const DEFAULT_POLICY: TriggerPolicy = {
+	warningThreshold: 0.6,
+	compactThreshold: 0.7,
+	hardStopThreshold: 0.85,
+};
+
+/** Estimate context pressure as a ratio (0-1). */
+export function estimatePressure(
+	currentTokens: number,
+	maxTokens: number,
+): number {
+	if (maxTokens <= 0) return 1;
+	return Math.min(currentTokens / maxTokens, 1);
+}
+
+/** Determine pressure level from a ratio. */
+export function getPressureLevel(
+	pressure: number,
+	policy: TriggerPolicy = DEFAULT_POLICY,
+): PressureLevel {
+	if (pressure >= policy.hardStopThreshold) return "hard_stop";
+	if (pressure >= policy.compactThreshold) return "compact";
+	if (pressure >= policy.warningThreshold) return "warning";
+	return "normal";
+}
+
+/** Create a new session-scoped context bucket. */
+export function createSessionScope(id: string): SessionScope {
+	return { id, items: [], ttlMs: 30 * 60 * 1000, createdAt: Date.now() };
+}
+
+/** Set TTL on a scope (in milliseconds). */
+export function setTTL(scope: SessionScope, ttlMs: number): SessionScope {
+	return { ...scope, ttlMs };
+}
+
+/** Add an item to a session scope. */
+export function addToScope(
+	scope: SessionScope,
+	item: ContextItem,
+): SessionScope {
+	return { ...scope, items: [...scope.items, item] };
+}
+
+/** Remove expired items from a scope based on TTL. */
+export function evictExpired(scope: SessionScope): SessionScope {
+	const now = Date.now();
+	return {
+		...scope,
+		items: scope.items.filter((item) => {
+			if (!item.expiresAt) return true;
+			return item.expiresAt > now;
+		}),
+	};
+}
+
+/** Prioritize items: lower priority number = higher importance. */
+export function prioritize(
+	items: ContextItem[],
+	limit?: number,
+): ContextItem[] {
+	const sorted = [...items].sort((a, b) => a.priority - b.priority);
+	return limit ? sorted.slice(0, limit) : sorted;
+}
+
+/** Count tokens using a simple word-based estimator (4 chars/token). */
+export function estimateTokens(text: string): number {
+	return Math.ceil(text.length / 4);
+}
+
+/** Calculate total tokens in a list of items. */
+export function calculateTotalTokens(items: ContextItem[]): number {
+	return items.reduce((sum, item) => sum + item.tokens, 0);
+}

package/packages/context-manager/src/index.ts

@@ -0,0 +1,22 @@
+/**
+ * Context Manager — Main Entry (RFC-0010)
+ */
+
+export {
+	DEFAULT_POLICY,
+	estimatePressure,
+	getPressureLevel,
+	createSessionScope,
+	setTTL,
+	addToScope,
+	evictExpired,
+	prioritize,
+	estimateTokens,
+	calculateTotalTokens,
+} from "./core.js";
+export {
+	compactContext,
+	generateResumePrompt,
+	formatResumeMarkdown,
+} from "./compaction.js";
+export type * from "./types.js";

package/packages/context-manager/src/types.ts

@@ -0,0 +1,44 @@
+/**
+ * Context Manager Types (RFC-0010)
+ */
+
+export type PressureLevel = "normal" | "warning" | "compact" | "hard_stop";
+
+export interface TriggerPolicy {
+	warningThreshold: number;
+	compactThreshold: number;
+	hardStopThreshold: number;
+}
+
+export interface ContextItem {
+	id: string;
+	role: "user" | "assistant" | "system";
+	content: string;
+	tokens: number;
+	priority: number;
+	timestamp: number;
+	expiresAt?: number;
+}
+
+export interface CompactionResult {
+	decisions: string[];
+	openQuestions: string[];
+	taskProgress: Record<string, string>;
+	remainingTokens: number;
+	compactedContent: string;
+}
+
+export interface SessionScope {
+	id: string;
+	items: ContextItem[];
+	ttlMs: number;
+	createdAt: number;
+}
+
+export interface ResumePrompt {
+	summary: string;
+	decisions: string[];
+	openQuestions: string[];
+	taskProgress: Record<string, string>;
+	nextAction: string;
+}