@fevex/core 0.1.0-alpha.6 → 0.1.0-alpha.8

package/dist/knowledge/index.mjs

@@ -1,39 +1,10 @@
-//#region src/knowledge/in-memory-memory-store.ts
-/** Volatile keyword-search memory store for tests and local development. */
-var InMemoryMemoryStore = class {
-	#records = /* @__PURE__ */ new Map();
-	async search(query, context) {
-		context.signal?.throwIfAborted();
-		const terms = query.query.toLowerCase().split(/\s+/).filter(Boolean);
-		const scored = [...this.#records.values()].filter((record) => matchesScope(record, query)).map((record) => ({
-			record,
-			score: score(record.content, terms)
-		})).filter(({ score }) => !terms.length || score > 0).sort((left, right) => right.score - left.score || right.record.createdAt.localeCompare(left.record.createdAt));
-		return scored.slice(0, query.limit ?? scored.length).map(({ record }) => structuredClone(record));
-	}
-	async write(record, context) {
-		context.signal?.throwIfAborted();
-		const saved = {
-			id: crypto.randomUUID(),
-			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-			...structuredClone(record)
-		};
-		this.#records.set(saved.id, saved);
-		return structuredClone(saved);
-	}
-};
-function matchesScope(record, query) {
-	return matches(record.agentName, query.agentName) && matches(record.sessionId, query.sessionId) && matches(record.namespace, query.namespace) && matches(record.actor?.id, query.actor?.id);
-}
-function matches(left, right) {
-	return right === void 0 || left === void 0 || left === right;
-}
-function score(content, terms) {
-	const text = content.toLowerCase();
-	return terms.reduce((total, term) => total + (text.includes(term) ? 1 : 0), 0);
-}
-//#endregion
+import { readFile, readdir, realpath, stat } from "node:fs/promises";
+import { dirname, isAbsolute, relative, resolve } from "node:path";
 //#region src/knowledge/knowledge.ts
+function isProgressiveSkillProvider(provider) {
+	const candidate = provider;
+	return typeof candidate.load === "function" && typeof candidate.description === "string";
+}
 function defineContextProvider(provider) {
 	return provider;
 }
@@ -86,4 +57,233 @@ function stringifyKnowledge(value) {
 	return typeof value === "string" ? value : JSON.stringify(value);
 }
 //#endregion
-export { InMemoryMemoryStore, createMemoryContextProvider, defineContextProvider, defineSkill };
+//#region src/knowledge/agents-md.ts
+const DEFAULT_MAX_BYTES$1 = 256 * 1024;
+/**
+* Reads one explicit `AGENTS.md` file as context.
+*
+* Fevex never walks the filesystem looking for `AGENTS.md`; register one
+* provider per file and reference its name from `agent.context`.
+*/
+function createAgentsMdContextProvider(options) {
+	const path = typeof options === "string" ? options : options.path;
+	const name = ((typeof options === "string" ? void 0 : options.name) ?? "agents-md").trim();
+	const maxBytes = (typeof options === "string" ? void 0 : options.maxBytes) ?? DEFAULT_MAX_BYTES$1;
+	if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) throw new TypeError("AGENTS.md maxBytes must be a positive safe integer");
+	if (!name.trim()) throw new TypeError("AGENTS.md provider name cannot be empty");
+	return defineContextProvider({
+		name,
+		async read() {
+			if ((await stat(path)).size > maxBytes) throw new Error(`AGENTS.md file "${path}" exceeds ${maxBytes} bytes`);
+			const content = await readFile(path, "utf8");
+			if (Buffer.byteLength(content) > maxBytes) throw new Error(`AGENTS.md file "${path}" exceeds ${maxBytes} bytes`);
+			return content.trim() ? [{
+				id: "agents-md",
+				content
+			}] : [];
+		}
+	});
+}
+//#endregion
+//#region src/knowledge/in-memory-memory-store.ts
+/** Volatile keyword-search memory store for tests and local development. */
+var InMemoryMemoryStore = class {
+	#records = /* @__PURE__ */ new Map();
+	async search(query, context) {
+		context.signal?.throwIfAborted();
+		const terms = query.query.toLowerCase().split(/\s+/).filter(Boolean);
+		const scored = [...this.#records.values()].filter((record) => matchesScope(record, query)).map((record) => ({
+			record,
+			score: score(record.content, terms)
+		})).filter(({ score }) => !terms.length || score > 0).sort((left, right) => right.score - left.score || right.record.createdAt.localeCompare(left.record.createdAt));
+		return scored.slice(0, query.limit ?? scored.length).map(({ record }) => structuredClone(record));
+	}
+	async write(record, context) {
+		context.signal?.throwIfAborted();
+		const saved = {
+			id: crypto.randomUUID(),
+			createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+			...structuredClone(record)
+		};
+		this.#records.set(saved.id, saved);
+		return structuredClone(saved);
+	}
+};
+function matchesScope(record, query) {
+	return matches(record.agentName, query.agentName) && matches(record.sessionId, query.sessionId) && matches(record.namespace, query.namespace) && matches(record.actor?.id, query.actor?.id);
+}
+function matches(left, right) {
+	return right === void 0 || left === void 0 || left === right;
+}
+function score(content, terms) {
+	const text = content.toLowerCase();
+	return terms.reduce((total, term) => total + (text.includes(term) ? 1 : 0), 0);
+}
+//#endregion
+//#region src/knowledge/skill-file.ts
+const DEFAULT_MAX_BYTES = 256 * 1024;
+const DEFAULT_MAX_RESOURCE_BYTES = 256 * 1024;
+const MAX_RESOURCES = 200;
+const SKILL_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const RESOURCE_DIRECTORIES = [
+	"references",
+	"scripts",
+	"assets"
+];
+/**
+* Loads one explicit `SKILL.md` file.
+*
+* Only `name` and `description` are advertised up front. The body and any
+* files under `references/`, `scripts/` or `assets/` load on demand.
+*/
+async function loadSkillFile(path, options = {}) {
+	const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+	const maxResourceBytes = options.maxResourceBytes ?? DEFAULT_MAX_RESOURCE_BYTES;
+	assertPositiveInteger(maxBytes, "maxBytes");
+	assertPositiveInteger(maxResourceBytes, "maxResourceBytes");
+	const absolute = await realpath(resolve(path));
+	if ((await stat(absolute)).size > maxBytes) throw new Error(`Skill file "${path}" exceeds ${maxBytes} bytes`);
+	const source = (await readFile(absolute, "utf8")).replace(/^\uFEFF/, "");
+	if (Buffer.byteLength(source) > maxBytes) throw new Error(`Skill file "${path}" exceeds ${maxBytes} bytes`);
+	const skill = parseSkillFile(source, path);
+	const root = dirname(absolute);
+	return defineContextProvider({
+		name: skill.name,
+		description: skill.description,
+		async read() {
+			return [{
+				id: `${skill.name}:metadata`,
+				content: skill.description
+			}];
+		},
+		async load(_context, resource) {
+			if (resource !== void 0) return [{
+				id: `${skill.name}:resource:${resource}`,
+				content: await readResource(root, resource, maxResourceBytes)
+			}];
+			const blocks = [{
+				id: `${skill.name}:instructions`,
+				content: skill.instructions
+			}];
+			const resources = await listResources(root);
+			if (resources.length) blocks.push({
+				id: `${skill.name}:resources`,
+				content: [
+					"Resources:",
+					...resources.map((item) => `- ${item.path} (${formatBytes(item.size)})`),
+					"Load one by passing its path as the resource argument.",
+					...resources.some((item) => item.path.startsWith("scripts/")) ? ["Scripts are for reference only and are not executed by this runtime."] : []
+				].join("\n")
+			});
+			return blocks;
+		}
+	});
+}
+/** Loads several explicit `SKILL.md` files; it never scans directories. */
+function loadSkillFiles(paths, options = {}) {
+	return Promise.all(paths.map((path) => loadSkillFile(path, options)));
+}
+function parseSkillFile(source, path) {
+	const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)([\s\S]*)$/.exec(source);
+	if (!match) throw new Error(`Skill file "${path}" must start with --- frontmatter`);
+	const fields = parseFrontmatter(match[1]);
+	const name = fields.name?.trim();
+	const description = fields.description?.trim();
+	const instructions = match[2].trim();
+	if (!name) throw new Error(`Skill file "${path}" must define a name`);
+	if (name.length > 64 || !SKILL_NAME.test(name) || name.startsWith("fevex__")) throw new Error(`Skill file "${path}" has an invalid name; use lowercase letters, numbers and hyphens, up to 64 characters`);
+	if (!description) throw new Error(`Skill file "${path}" must define a description`);
+	if (!instructions) throw new Error(`Skill file "${path}" must contain instructions`);
+	return {
+		name,
+		description,
+		instructions
+	};
+}
+function parseFrontmatter(source) {
+	const fields = {};
+	const lines = source.split(/\r?\n/);
+	for (let index = 0; index < lines.length; index += 1) {
+		const line = lines[index];
+		if (!line.trim() || line.trimStart().startsWith("#")) continue;
+		if (/^\s/.test(line)) continue;
+		const colon = line.indexOf(":");
+		if (colon <= 0) continue;
+		const key = line.slice(0, colon).trim();
+		let value = line.slice(colon + 1).trim();
+		if (value === "|" || value === ">" || value === "|-" || value === ">-") {
+			const block = [];
+			while (index + 1 < lines.length) {
+				const next = lines[index + 1];
+				if (next.trim() && !/^\s/.test(next)) break;
+				index += 1;
+				block.push(next.replace(/^\s+/, ""));
+			}
+			while (block.length && !block[block.length - 1]) block.pop();
+			value = value.startsWith(">") ? block.filter(Boolean).join(" ") : block.join("\n");
+		} else if (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'")) value = value.slice(1, -1);
+		fields[key] = value;
+	}
+	return fields;
+}
+async function listResources(root) {
+	const resources = [];
+	for (const directory of RESOURCE_DIRECTORIES) await walkResources(resolve(root, directory), root, resources);
+	return resources.sort((left, right) => left.path.localeCompare(right.path)).slice(0, MAX_RESOURCES);
+}
+async function walkResources(directory, root, resources) {
+	if (resources.length >= MAX_RESOURCES) return;
+	let entries;
+	try {
+		entries = await readdir(directory, { withFileTypes: true });
+	} catch (error) {
+		if (isMissing(error)) return;
+		throw error;
+	}
+	for (const entry of entries) {
+		if (resources.length >= MAX_RESOURCES) return;
+		if (entry.isSymbolicLink()) continue;
+		const target = resolve(directory, entry.name);
+		if (entry.isDirectory()) {
+			await walkResources(target, root, resources);
+			continue;
+		}
+		if (!entry.isFile()) continue;
+		const info = await stat(target);
+		resources.push({
+			path: relative(root, target).split("\\").join("/"),
+			size: info.size
+		});
+	}
+}
+async function readResource(root, resource, maxBytes) {
+	if (resource.includes("\0")) throw new Error("Skill resource path is invalid");
+	const requested = resolve(root, resource);
+	const requestedPath = relative(root, requested);
+	if (!requestedPath || requestedPath.startsWith("..") || isAbsolute(requestedPath)) throw new Error(`Skill resource "${resource}" is outside the skill directory`);
+	let target;
+	try {
+		target = await realpath(requested);
+	} catch {
+		throw new Error(`Skill resource "${resource}" was not found`);
+	}
+	const path = relative(root, target);
+	if (!path || path.startsWith("..") || isAbsolute(path)) throw new Error(`Skill resource "${resource}" is outside the skill directory`);
+	const info = await stat(target);
+	if (!info.isFile()) throw new Error(`Skill resource "${resource}" is not a file`);
+	if (info.size > maxBytes) throw new Error(`Skill resource "${resource}" exceeds ${maxBytes} bytes`);
+	const buffer = await readFile(target);
+	if (buffer.includes(0)) throw new Error(`Skill resource "${resource}" is not UTF-8 text`);
+	return buffer.toString("utf8");
+}
+function formatBytes(bytes) {
+	return bytes < 1024 ? `${bytes} B` : `${(bytes / 1024).toFixed(1)} KB`;
+}
+function assertPositiveInteger(value, name) {
+	if (!Number.isSafeInteger(value) || value <= 0) throw new TypeError(`Skill ${name} must be a positive safe integer`);
+}
+function isMissing(error) {
+	return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+//#endregion
+export { InMemoryMemoryStore, createAgentsMdContextProvider, createMemoryContextProvider, defineContextProvider, defineSkill, isProgressiveSkillProvider, loadSkillFile, loadSkillFiles };

package/dist/models/index.d.mts

@@ -1,2 +1,2 @@
-import { a as ModelResult, c as ReasoningEffort, i as ModelRef, l as ToolChoice, n as ModelInput, o as ModelStreamEvent, r as ModelMetadata, s as ModelUsage, t as ModelGateway } from "../index-BgKFd9yw.mjs";
+import { a as ModelResult, c as ReasoningEffort, i as ModelRef, l as ToolChoice, n as ModelInput, o as ModelStreamEvent, r as ModelMetadata, s as ModelUsage, t as ModelGateway } from "../index-BfYzemR8.mjs";
 export { ModelGateway, ModelInput, ModelMetadata, ModelRef, ModelResult, ModelStreamEvent, ModelUsage, ReasoningEffort, ToolChoice };

package/dist/observability/index.d.mts

@@ -1,2 +1,2 @@
-import { _ as TraceSpanKind, a as RunTrace, c as TraceContentKind, d as TraceExportQueueOptions, f as TraceExporter, g as TraceSpan, h as TraceRunKind, i as ObservabilityStats, l as TraceContentPolicy, m as TraceRedactorInput, n as CostCalculatorInput, o as TraceAnnotation, p as TraceRedactor, r as ObservabilityOptions, s as TraceContent, t as CostCalculator, u as TraceCost, v as TraceStatus } from "../index-CpLDt6Rw.mjs";
+import { _ as TraceSpanKind, a as RunTrace, c as TraceContentKind, d as TraceExportQueueOptions, f as TraceExporter, g as TraceSpan, h as TraceRunKind, i as ObservabilityStats, l as TraceContentPolicy, m as TraceRedactorInput, n as CostCalculatorInput, o as TraceAnnotation, p as TraceRedactor, r as ObservabilityOptions, s as TraceContent, t as CostCalculator, u as TraceCost, v as TraceStatus } from "../index-CecXoEbs.mjs";
 export { CostCalculator, CostCalculatorInput, ObservabilityOptions, ObservabilityStats, RunTrace, TraceAnnotation, TraceContent, TraceContentKind, TraceContentPolicy, TraceCost, TraceExportQueueOptions, TraceExporter, TraceRedactor, TraceRedactorInput, TraceRunKind, TraceSpan, TraceSpanKind, TraceStatus };

package/dist/policies/index.d.mts

@@ -1,2 +1,2 @@
-import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "../index-CbACw6xZ.mjs";
+import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "../index-Bl0hR7EC.mjs";
 export { PolicyAuthorization, PolicyDecision, PolicyDefinition, definePolicy };

package/dist/runtime/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as validateListEventsOptions, A as RunPause, B as TeamRun, C as PurgeRunsResult, D as RunCheckpoint, E as RetainableRunStore, F as RunStore, G as WorkflowBudgetUsage, H as ToolExecutionRecord, I as Session, J as WorkflowRun, K as WorkflowCheckpoint, L as SessionId, M as RunRequest, N as RunResult, O as RunCorrelation, P as RunStatus, Q as isRetainableRunStore, R as StoredRunCheckpoint, S as PurgeRunsOptions, T as RetainableRunStatus, U as ToolExecutionResolution, V as TimerResolution, W as ToolExecutionStatus, X as WorkflowWaitRecord, Y as WorkflowStepRecord, Z as isDurableRunStore, _ as EventResolution, a as AgentRun, b as ListEventsOptions, c as ApprovalRequest, d as CoordinatorRun, et as validatePurgeRunsOptions, f as CredentialStore, g as ElicitationResolution, h as ElicitationRequest, i as InMemoryRunStore, j as RunRecord, k as RunLease, l as ApprovalResolution, m as ElicitationMode, o as AgentRunPause, p as DurableRunStore, q as WorkflowCompensationRecord, s as ApprovalMode, u as CoordinatorCheckpoint, v as ExecutionCommit, w as ResumeRunResolution, x as PendingToolExecution, y as ExecutionCreate, z as TeamCheckpoint } from "../index-CzAi2Y_Z.mjs";
-export { AgentRun, AgentRunPause, ApprovalMode, ApprovalRequest, ApprovalResolution, CoordinatorCheckpoint, CoordinatorRun, CredentialStore, DurableRunStore, ElicitationMode, ElicitationRequest, ElicitationResolution, EventResolution, ExecutionCommit, ExecutionCreate, InMemoryRunStore, ListEventsOptions, PendingToolExecution, PurgeRunsOptions, PurgeRunsResult, ResumeRunResolution, RetainableRunStatus, RetainableRunStore, RunCheckpoint, RunCorrelation, RunLease, RunPause, RunRecord, RunRequest, RunResult, RunStatus, RunStore, Session, SessionId, StoredRunCheckpoint, TeamCheckpoint, TeamRun, TimerResolution, ToolExecutionRecord, ToolExecutionResolution, ToolExecutionStatus, WorkflowBudgetUsage, WorkflowCheckpoint, WorkflowCompensationRecord, WorkflowRun, WorkflowStepRecord, WorkflowWaitRecord, isDurableRunStore, isRetainableRunStore, validateListEventsOptions, validatePurgeRunsOptions };
+import { $ as ToolExecutionRecord, A as ListEventsOptions, B as RunPause, C as DurableRunStore, D as EventResolution, E as ElicitationResolution, F as RetainableRunStatus, G as RunStore, H as RunRequest, I as RetainableRunStore, J as SessionId, K as Session, L as RunCheckpoint, M as PurgeRunsOptions, N as PurgeRunsResult, O as ExecutionCommit, P as ResumeRunResolution, Q as TimerResolution, R as RunCorrelation, S as CredentialStore, T as ElicitationRequest, U as RunResult, V as RunRecord, W as RunStatus, X as TeamCheckpoint, Y as StoredRunCheckpoint, Z as TeamRun, _ as ApprovalMode, a as InMemoryRunStore, at as WorkflowRun, b as CoordinatorCheckpoint, c as ContextCompactor, ct as isDurableRunStore, d as ResolvedContextBudget, dt as validatePurgeRunsOptions, et as ToolExecutionResolution, f as createDigestContextCompactor, g as AgentRunPause, h as AgentRun, it as WorkflowCompensationRecord, j as PendingToolExecution, k as ExecutionCreate, l as ContextTokenEstimator, lt as isRetainableRunStore, m as resolveContextBudget, nt as WorkflowBudgetUsage, o as ContextCompactionInput, ot as WorkflowStepRecord, p as estimateContextTokens, q as SessionCompaction, rt as WorkflowCheckpoint, s as ContextCompactionOptions, st as WorkflowWaitRecord, tt as ToolExecutionStatus, u as DigestContextCompactorOptions, ut as validateListEventsOptions, v as ApprovalRequest, w as ElicitationMode, x as CoordinatorRun, y as ApprovalResolution, z as RunLease } from "../index-B8molngu.mjs";
+export { AgentRun, AgentRunPause, ApprovalMode, ApprovalRequest, ApprovalResolution, ContextCompactionInput, ContextCompactionOptions, ContextCompactor, ContextTokenEstimator, CoordinatorCheckpoint, CoordinatorRun, CredentialStore, DigestContextCompactorOptions, DurableRunStore, ElicitationMode, ElicitationRequest, ElicitationResolution, EventResolution, ExecutionCommit, ExecutionCreate, InMemoryRunStore, ListEventsOptions, PendingToolExecution, PurgeRunsOptions, PurgeRunsResult, ResolvedContextBudget, ResumeRunResolution, RetainableRunStatus, RetainableRunStore, RunCheckpoint, RunCorrelation, RunLease, RunPause, RunRecord, RunRequest, RunResult, RunStatus, RunStore, Session, SessionCompaction, SessionId, StoredRunCheckpoint, TeamCheckpoint, TeamRun, TimerResolution, ToolExecutionRecord, ToolExecutionResolution, ToolExecutionStatus, WorkflowBudgetUsage, WorkflowCheckpoint, WorkflowCompensationRecord, WorkflowRun, WorkflowStepRecord, WorkflowWaitRecord, createDigestContextCompactor, estimateContextTokens, isDurableRunStore, isRetainableRunStore, resolveContextBudget, validateListEventsOptions, validatePurgeRunsOptions };

package/dist/runtime/index.mjs

@@ -1,4 +1,108 @@
 import { t as FevexRunError } from "../run-error-Cr17wPGH.mjs";
+//#region src/runtime/compaction.ts
+/** Validates a context budget and fills in defaults. */
+function resolveContextBudget(budget, label) {
+	if (budget === void 0) return void 0;
+	if (!isRecord(budget)) throw new TypeError(`${label} must be an object`);
+	const contextWindow = budget.contextWindow;
+	if (!Number.isSafeInteger(contextWindow) || contextWindow <= 0) throw new TypeError(`${label}.contextWindow must be a positive safe integer`);
+	const reserveOutputTokens = budget.reserveOutputTokens ?? 0;
+	if (!Number.isSafeInteger(reserveOutputTokens) || reserveOutputTokens < 0 || reserveOutputTokens >= contextWindow) throw new TypeError(`${label}.reserveOutputTokens must be a non-negative safe integer below contextWindow`);
+	const usable = contextWindow - reserveOutputTokens;
+	const compactAt = budget.compactAt ?? .8;
+	if (typeof compactAt !== "number" || !Number.isFinite(compactAt) || compactAt <= 0 || compactAt > 1) throw new TypeError(`${label}.compactAt must be greater than 0 and at most 1`);
+	const targetTokens = budget.targetTokens ?? Math.max(1, Math.floor(usable * Math.min(.5, compactAt * .9)));
+	if (!Number.isSafeInteger(targetTokens) || targetTokens <= 0 || targetTokens >= usable) throw new TypeError(`${label}.targetTokens must be a positive safe integer below the usable window`);
+	if (targetTokens > Math.floor(usable * compactAt)) throw new TypeError(`${label}.targetTokens must not exceed the compaction threshold`);
+	const safetyFactor = budget.safetyFactor ?? 1.1;
+	if (typeof safetyFactor !== "number" || !Number.isFinite(safetyFactor) || safetyFactor < 1 || safetyFactor > 2) throw new TypeError(`${label}.safetyFactor must be between 1 and 2`);
+	return {
+		contextWindow,
+		reserveOutputTokens,
+		compactAt,
+		targetTokens,
+		safetyFactor
+	};
+}
+/**
+* Rough provider-neutral estimate: about four characters per token plus
+* message and tool framing. Hosts can inject a real tokenizer instead.
+*/
+function estimateContextTokens(input) {
+	let characters = 0;
+	for (const message of input.messages) {
+		characters += message.role.length + message.content.length + 16;
+		if (message.name !== void 0) characters += message.name.length;
+		if (message.toolCallId !== void 0) characters += message.toolCallId.length;
+		if (message.toolCalls !== void 0) characters += JSON.stringify(message.toolCalls).length;
+	}
+	if (input.tools?.length) characters += JSON.stringify(input.tools).length;
+	return Math.max(1, Math.ceil(characters / 4));
+}
+/**
+* Deterministic compactor used when the host does not inject one. It keeps
+* role-aware excerpts of older messages and drops the oldest excerpts first.
+* It never calls a model.
+*/
+function createDigestContextCompactor(options = {}) {
+	const maxChars = options.maxCharsPerMessage ?? 400;
+	if (!Number.isSafeInteger(maxChars) || maxChars < 40) throw new TypeError("Digest compactor maxCharsPerMessage must be a safe integer of at least 40");
+	return { compact(input) {
+		if (input.messages.length === 0) return [{
+			role: "system",
+			content: "[Compacted earlier conversation]"
+		}];
+		let perMessage = maxChars;
+		let lines = input.messages.flatMap((message) => digestMessage(message, perMessage));
+		while (input.estimateTokens([{
+			role: "system",
+			content: digestContent(lines, input.messages.length)
+		}]) > input.targetTokens && perMessage > 40) {
+			perMessage = Math.max(40, Math.floor(perMessage * .7));
+			lines = input.messages.flatMap((message) => digestMessage(message, perMessage));
+		}
+		let selected = lines;
+		let content = digestContent(selected, input.messages.length);
+		while (input.estimateTokens([{
+			role: "system",
+			content
+		}]) > input.targetTokens && selected.length > 1) {
+			selected = selected.slice(1);
+			content = digestContent(selected, input.messages.length);
+		}
+		const limit = Math.max(80, input.targetTokens * 4);
+		if (content.length > limit) content = `${content.slice(0, Math.max(0, limit - 1))}…`;
+		return [{
+			role: "system",
+			content
+		}];
+	} };
+}
+function digestContent(lines, totalMessages) {
+	const omitted = Math.max(0, totalMessages - lines.length);
+	return [`[Compacted conversation: ${totalMessages} earlier messages${omitted ? `, ${omitted} omitted` : ""}]`, ...lines].join("\n");
+}
+function digestMessage(message, maxChars) {
+	const content = truncate(message.content, maxChars);
+	if (message.role === "user") return content ? [`User: ${content}`] : [];
+	if (message.role === "assistant") {
+		const lines = [];
+		if (content) lines.push(`Assistant: ${content}`);
+		for (const call of message.toolCalls ?? []) lines.push(`Tool call ${call.name}: ${truncate(JSON.stringify(call.input), Math.min(maxChars, 200))}`);
+		return lines;
+	}
+	if (message.role === "tool") return content ? [`Tool result${message.name === void 0 ? "" : ` (${message.name})`}: ${content}`] : [];
+	return content ? [`System: ${content}`] : [];
+}
+function truncate(value, maxChars) {
+	const normalized = value.replace(/\s+/g, " ").trim();
+	if (normalized.length <= maxChars) return normalized;
+	return `${normalized.slice(0, Math.max(0, maxChars - 1))}…`;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region src/runtime/run-store.ts
 function validateListEventsOptions(options) {
 	if (options.limit !== void 0 && (!Number.isSafeInteger(options.limit) || options.limit < 1)) throw new TypeError("Event limit must be a positive safe integer");
@@ -180,4 +284,4 @@ var InMemoryRunStore = class {
 	}
 };
 //#endregion
-export { InMemoryRunStore, isDurableRunStore, isRetainableRunStore, validateListEventsOptions, validatePurgeRunsOptions };
+export { InMemoryRunStore, createDigestContextCompactor, estimateContextTokens, isDurableRunStore, isRetainableRunStore, resolveContextBudget, validateListEventsOptions, validatePurgeRunsOptions };

package/dist/sandbox/index.d.mts

@@ -1,2 +1,2 @@
-import { a as SandboxError, c as sandboxResultToJson, i as SandboxCapabilities, n as createLocalSandbox, o as SandboxRunRequest, r as Sandbox, s as SandboxRunResult, t as LocalSandboxOptions } from "../index-Df84VWmN.mjs";
+import { a as SandboxError, c as sandboxResultToJson, i as SandboxCapabilities, n as createLocalSandbox, o as SandboxRunRequest, r as Sandbox, s as SandboxRunResult, t as LocalSandboxOptions } from "../index-CL7mu_x9.mjs";
 export { LocalSandboxOptions, Sandbox, SandboxCapabilities, SandboxError, SandboxRunRequest, SandboxRunResult, createLocalSandbox, sandboxResultToJson };

package/dist/teams/index.d.mts

@@ -1,2 +1,2 @@
-import { a as TeamMember, c as defineTeam, i as TeamLimits, n as TeamDelegation, o as TeamStep, r as TeamHandoff, s as TeamTaskResult, t as TeamDefinition } from "../index-1cHr7KB_.mjs";
+import { a as TeamMember, c as defineTeam, i as TeamLimits, n as TeamDelegation, o as TeamStep, r as TeamHandoff, s as TeamTaskResult, t as TeamDefinition } from "../index-CODYPevS.mjs";
 export { type TeamDefinition, type TeamDelegation, type TeamHandoff, type TeamLimits, type TeamMember, type TeamStep, type TeamTaskResult, defineTeam };

package/dist/testing/index.d.mts

@@ -1,9 +1,9 @@
-import { m as ToolCall } from "../types-B8laW1hM.mjs";
-import { a as ModelResult, n as ModelInput, t as ModelGateway } from "../index-BgKFd9yw.mjs";
-import { h as ElicitationRequest, p as DurableRunStore } from "../index-CzAi2Y_Z.mjs";
-import { s as MemoryStore } from "../index-BJktlD4E.mjs";
-import { d as ToolProvider } from "../index-5p3q2yIp.mjs";
-import { d as ChannelMessage, f as ChannelOutput, o as ChannelElicitationContext, r as ChannelAdapter } from "../index-DVw0zOc_.mjs";
+import { m as ToolCall } from "../types-CckDlhYo.mjs";
+import { a as ModelResult, n as ModelInput, t as ModelGateway } from "../index-BfYzemR8.mjs";
+import { C as DurableRunStore, T as ElicitationRequest } from "../index-B8molngu.mjs";
+import { f as MemoryStore } from "../index-CAyAoOW0.mjs";
+import { d as ToolProvider } from "../index-DtMxzCqj.mjs";
+import { d as ChannelMessage, f as ChannelOutput, o as ChannelElicitationContext, r as ChannelAdapter } from "../index-CuaetTLQ.mjs";
 //#region src/testing/contracts.d.ts
 interface ModelGatewayContract {
   output?: unknown;

package/dist/tools/index.d.mts

@@ -1,3 +1,3 @@
-import { g as ToolSpec, m as ToolCall } from "../types-B8laW1hM.mjs";
-import { C as toToolSpec, S as defineTool, _ as ToolExecutionContext, a as compileFevexJsonSchema, b as ToolRetryPolicy, c as ConnectionToolPolicy, d as ToolProvider, f as ToolProviderContext, g as ToolDefinition, h as ToolApproval, i as FevexJsonSchemaValidator, l as IntegrationError, m as defineConnection, n as FevexJsonSchemaProfileLimits, o as validateFevexJsonSchemaProfile, p as ToolProviderTool, r as FevexJsonSchemaProfileOptions, s as ConnectionDefinition, t as FEVEX_JSON_SCHEMA_PROFILE_VERSION, u as IntegrationErrorCategory, v as ToolIdempotency, x as ToolRisk, y as ToolResult } from "../index-5p3q2yIp.mjs";
+import { g as ToolSpec, m as ToolCall } from "../types-CckDlhYo.mjs";
+import { C as toToolSpec, S as defineTool, _ as ToolExecutionContext, a as compileFevexJsonSchema, b as ToolRetryPolicy, c as ConnectionToolPolicy, d as ToolProvider, f as ToolProviderContext, g as ToolDefinition, h as ToolApproval, i as FevexJsonSchemaValidator, l as IntegrationError, m as defineConnection, n as FevexJsonSchemaProfileLimits, o as validateFevexJsonSchemaProfile, p as ToolProviderTool, r as FevexJsonSchemaProfileOptions, s as ConnectionDefinition, t as FEVEX_JSON_SCHEMA_PROFILE_VERSION, u as IntegrationErrorCategory, v as ToolIdempotency, x as ToolRisk, y as ToolResult } from "../index-DtMxzCqj.mjs";
 export { ConnectionDefinition, ConnectionToolPolicy, FEVEX_JSON_SCHEMA_PROFILE_VERSION, FevexJsonSchemaProfileLimits, FevexJsonSchemaProfileOptions, FevexJsonSchemaValidator, IntegrationError, IntegrationErrorCategory, ToolApproval, type ToolCall, ToolDefinition, ToolExecutionContext, ToolIdempotency, ToolProvider, ToolProviderContext, ToolProviderTool, ToolResult, ToolRetryPolicy, ToolRisk, type ToolSpec, compileFevexJsonSchema, defineConnection, defineTool, toToolSpec, validateFevexJsonSchemaProfile };

package/dist/{types-B8laW1hM.d.mts → types-CckDlhYo.d.mts}

@@ -258,7 +258,7 @@ interface ToolEventSource {
   connectionName: string;
   remoteToolName: string;
 }
-type AgentEventType = 'run.started' | 'run.recovered' | 'run.paused' | 'run.resumed' | 'model.started' | 'model.output.delta' | 'model.completed' | 'tool.started' | 'tool.completed' | 'tool.failed' | 'tool.retrying' | 'tool.execution_unknown' | 'artifact.created' | 'elicitation.requested' | 'elicitation.resolved' | 'approval.requested' | 'approval.resolved' | 'run.completed' | 'run.failed' | 'run.cancelled' | 'workflow.run.started' | 'workflow.run.recovered' | 'workflow.step.started' | 'workflow.step.completed' | 'workflow.step.failed' | 'workflow.compensation.started' | 'workflow.compensation.completed' | 'workflow.compensation.failed' | 'workflow.wait.started' | 'workflow.wait.completed' | 'workflow.run.paused' | 'workflow.run.resumed' | 'workflow.run.completed' | 'workflow.run.failed' | 'workflow.run.cancelled' | 'team.run.started' | 'team.run.recovered' | 'team.agent.assigned' | 'team.handoff.created' | 'team.task.completed' | 'team.task.failed' | 'team.merge.started' | 'team.merge.completed' | 'team.merge.failed' | 'team.run.paused' | 'team.run.resumed' | 'team.run.completed' | 'team.run.failed' | 'team.run.cancelled';
+type AgentEventType = 'run.started' | 'run.recovered' | 'run.paused' | 'run.resumed' | 'model.started' | 'model.output.delta' | 'model.completed' | 'context.compacted' | 'tool.started' | 'tool.completed' | 'tool.failed' | 'tool.retrying' | 'tool.execution_unknown' | 'artifact.created' | 'elicitation.requested' | 'elicitation.resolved' | 'approval.requested' | 'approval.resolved' | 'run.completed' | 'run.failed' | 'run.cancelled' | 'workflow.run.started' | 'workflow.run.recovered' | 'workflow.step.started' | 'workflow.step.completed' | 'workflow.step.failed' | 'workflow.compensation.started' | 'workflow.compensation.completed' | 'workflow.compensation.failed' | 'workflow.wait.started' | 'workflow.wait.completed' | 'workflow.run.paused' | 'workflow.run.resumed' | 'workflow.run.completed' | 'workflow.run.failed' | 'workflow.run.cancelled' | 'team.run.started' | 'team.run.recovered' | 'team.agent.assigned' | 'team.handoff.created' | 'team.task.completed' | 'team.task.failed' | 'team.merge.started' | 'team.merge.completed' | 'team.merge.failed' | 'team.run.paused' | 'team.run.resumed' | 'team.run.completed' | 'team.run.failed' | 'team.run.cancelled';
 interface AgentEventPayloads {
   'run.started': undefined;
   'run.recovered': {
@@ -292,6 +292,20 @@ interface AgentEventPayloads {
     teamDelegationId?: string;
     teamAgentName?: string;
   };
+  'context.compacted': {
+    step: number;
+    removedMessages: number;
+    estimatedTokens: number;
+    compactedTokens: number;
+    targetTokens: number;
+    contextWindow: number;
+    summary: string;
+    summaryTruncated?: boolean;
+    workflowStepId?: string;
+    workflowAgentName?: string;
+    teamDelegationId?: string;
+    teamAgentName?: string;
+  };
   'tool.started': {
     step: number;
     toolCallId: string;

package/dist/workflows/index.d.mts

@@ -1,2 +1,2 @@
-import { a as WorkflowStep, c as defineWorkflow, i as WorkflowEventResult, n as WorkflowDefinition, o as WorkflowStepContext, r as WorkflowEventDefinition, s as WorkflowStepOptions, t as WorkflowAgentResult } from "../index-CseuTR-F.mjs";
+import { a as WorkflowStep, c as defineWorkflow, i as WorkflowEventResult, n as WorkflowDefinition, o as WorkflowStepContext, r as WorkflowEventDefinition, s as WorkflowStepOptions, t as WorkflowAgentResult } from "../index-RKE3-CKs.mjs";
 export { WorkflowAgentResult, WorkflowDefinition, WorkflowEventDefinition, WorkflowEventResult, WorkflowStep, WorkflowStepContext, WorkflowStepOptions, defineWorkflow };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fevex/core",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.8",
   "description": "Agent Engineering Framework for code-first, provider-neutral AI agents.",
   "type": "module",
   "license": "Apache-2.0",

package/dist/index-BJktlD4E.d.mts

@@ -1,70 +0,0 @@
-import { l as JsonValue, o as ExecutionContext, s as JsonObject } from "./types-B8laW1hM.mjs";
-import { L as SessionId } from "./index-CzAi2Y_Z.mjs";
-//#region src/knowledge/knowledge.d.ts
-/** Runtime context supplied to knowledge providers and memory stores. */
-interface KnowledgeContext {
-  agentName: string;
-  input: string;
-  sessionId: SessionId;
-  context?: ExecutionContext;
-  signal?: AbortSignal;
-}
-interface ContextBlock {
-  id: string;
-  content: string;
-  metadata?: JsonObject;
-}
-interface ContextProvider {
-  name: string;
-  read(context: KnowledgeContext): Promise<ContextBlock[]>;
-}
-interface MemoryQuery {
-  query: string;
-  limit?: number;
-  agentName?: string;
-  sessionId?: SessionId;
-  namespace?: string;
-  actor?: ExecutionContext['actor'];
-}
-interface MemoryWrite {
-  content: string;
-  agentName?: string;
-  sessionId?: SessionId;
-  namespace?: string;
-  actor?: ExecutionContext['actor'];
-  metadata?: JsonObject;
-}
-interface MemoryRecord extends MemoryWrite {
-  id: string;
-  createdAt: string;
-}
-interface MemoryStore {
-  search(query: MemoryQuery, context: KnowledgeContext): Promise<MemoryRecord[]>;
-  write(record: MemoryWrite, context: KnowledgeContext): Promise<MemoryRecord>;
-}
-interface SkillDefinition {
-  name: string;
-  instructions: string;
-  resources?: Array<string | JsonValue | {
-    id?: string;
-    content: string | JsonValue;
-    metadata?: JsonObject;
-  }>;
-}
-declare function defineContextProvider<T extends ContextProvider>(provider: T): T;
-declare function defineSkill(skill: SkillDefinition): ContextProvider;
-declare function createMemoryContextProvider(options: {
-  name?: string;
-  store: MemoryStore;
-  limit?: number;
-}): ContextProvider;
-//#endregion
-//#region src/knowledge/in-memory-memory-store.d.ts
-/** Volatile keyword-search memory store for tests and local development. */
-declare class InMemoryMemoryStore implements MemoryStore {
-  #private;
-  search(query: MemoryQuery, context: KnowledgeContext): Promise<MemoryRecord[]>;
-  write(record: MemoryWrite, context: KnowledgeContext): Promise<MemoryRecord>;
-}
-//#endregion
-export { MemoryQuery as a, MemoryWrite as c, defineContextProvider as d, defineSkill as f, KnowledgeContext as i, SkillDefinition as l, ContextBlock as n, MemoryRecord as o, ContextProvider as r, MemoryStore as s, InMemoryMemoryStore as t, createMemoryContextProvider as u };