@fevex/core 0.1.0-alpha.5 → 0.1.0-alpha.7

package/dist/knowledge/index.d.mts

@@ -1,2 +1,2 @@
-import { a as MemoryQuery, c as MemoryWrite, d as defineContextProvider, f as defineSkill, i as KnowledgeContext, l as SkillDefinition, n as ContextBlock, o as MemoryRecord, r as ContextProvider, s as MemoryStore, t as InMemoryMemoryStore, u as createMemoryContextProvider } from "../index-aayvtf0J.mjs";
-export { ContextBlock, ContextProvider, InMemoryMemoryStore, KnowledgeContext, MemoryQuery, MemoryRecord, MemoryStore, MemoryWrite, SkillDefinition, createMemoryContextProvider, defineContextProvider, defineSkill };
+import { _ as defineContextProvider, a as AgentsMdOptions, c as ContextProvider, d as MemoryRecord, f as MemoryStore, g as createMemoryContextProvider, h as SkillDefinition, i as InMemoryMemoryStore, l as KnowledgeContext, m as ProgressiveSkillProvider, n as loadSkillFile, o as createAgentsMdContextProvider, p as MemoryWrite, r as loadSkillFiles, s as ContextBlock, t as LoadSkillFileOptions, u as MemoryQuery, v as defineSkill, y as isProgressiveSkillProvider } from "../index-B0AdFbgr.mjs";
+export { AgentsMdOptions, ContextBlock, ContextProvider, InMemoryMemoryStore, KnowledgeContext, LoadSkillFileOptions, MemoryQuery, MemoryRecord, MemoryStore, MemoryWrite, ProgressiveSkillProvider, SkillDefinition, createAgentsMdContextProvider, createMemoryContextProvider, defineContextProvider, defineSkill, isProgressiveSkillProvider, loadSkillFile, loadSkillFiles };

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-BPwkgdo3.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-BgKFd9yw.mjs";
 export { ModelGateway, ModelInput, ModelMetadata, ModelRef, ModelResult, ModelStreamEvent, ModelUsage, ReasoningEffort, ToolChoice };

package/dist/observability/index.d.mts

@@ -1,2 +1,2 @@
-import { a as TraceAnnotation, c as TraceContentPolicy, d as TraceRedactor, f as TraceRedactorInput, h as TraceStatus, i as RunTrace, l as TraceCost, m as TraceSpanKind, n as CostCalculatorInput, o as TraceContent, p as TraceSpan, r as ObservabilityOptions, s as TraceContentKind, t as CostCalculator, u as TraceExporter } from "../index-D6lnI92z.mjs";
-export { CostCalculator, CostCalculatorInput, ObservabilityOptions, RunTrace, TraceAnnotation, TraceContent, TraceContentKind, TraceContentPolicy, TraceCost, TraceExporter, TraceRedactor, TraceRedactorInput, TraceSpan, TraceSpanKind, TraceStatus };
+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";
+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-Cb3AB98n.mjs";
+import { i as definePolicy, n as PolicyDecision, r as PolicyDefinition, t as PolicyAuthorization } from "../index-CbACw6xZ.mjs";
 export { PolicyAuthorization, PolicyDecision, PolicyDefinition, definePolicy };

package/dist/runtime/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as validatePurgeRunsOptions, A as RunRecord, B as TimerResolution, C as PurgeRunsResult, D as RunCheckpoint, E as RetainableRunStore, F as Session, G as WorkflowCheckpoint, H as ToolExecutionResolution, I as SessionId, J as WorkflowStepRecord, K as WorkflowCompensationRecord, L as StoredRunCheckpoint, M as RunResult, N as RunStatus, O as RunLease, P as RunStore, Q as validateListEventsOptions, R as TeamCheckpoint, S as PurgeRunsOptions, T as RetainableRunStatus, U as ToolExecutionStatus, V as ToolExecutionRecord, W as WorkflowBudgetUsage, X as isDurableRunStore, Y as WorkflowWaitRecord, Z as isRetainableRunStore, _ as EventResolution, a as AgentRun, b as ListEventsOptions, c as ApprovalRequest, d as CoordinatorRun, f as CredentialStore, g as ElicitationResolution, h as ElicitationRequest, i as InMemoryRunStore, j as RunRequest, k as RunPause, l as ApprovalResolution, m as ElicitationMode, o as AgentRunPause, p as DurableRunStore, q as WorkflowRun, s as ApprovalMode, u as CoordinatorCheckpoint, v as ExecutionCommit, w as ResumeRunResolution, x as PendingToolExecution, y as ExecutionCreate, z as TeamRun } from "../index-CGmHXV31.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, 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 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 };

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-BFnWUu7j.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-Df84VWmN.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-Dsulk-n6.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-1cHr7KB_.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-BDVUoAU6.mjs";
-import { a as ModelResult, n as ModelInput, t as ModelGateway } from "../index-BPwkgdo3.mjs";
-import { h as ElicitationRequest, p as DurableRunStore } from "../index-CGmHXV31.mjs";
-import { s as MemoryStore } from "../index-aayvtf0J.mjs";
-import { d as ToolProvider } from "../index-CKQCNvJz.mjs";
-import { d as ChannelMessage, f as ChannelOutput, o as ChannelElicitationContext, r as ChannelAdapter } from "../index--_LdSEuF.mjs";
+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 { f as MemoryStore } from "../index-B0AdFbgr.mjs";
+import { d as ToolProvider } from "../index-5p3q2yIp.mjs";
+import { d as ChannelMessage, f as ChannelOutput, o as ChannelElicitationContext, r as ChannelAdapter } from "../index-BTD1c4Ys.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-BDVUoAU6.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-CKQCNvJz.mjs";
+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";
 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-BDVUoAU6.d.mts → types-B8laW1hM.d.mts}

@@ -429,6 +429,7 @@ interface AgentEventPayloads {
     stepId: string;
     kind: 'agent' | 'parallel';
     agentName?: string;
+    childRunId?: string;
   };
   'workflow.step.completed': {
     stepId: string;
@@ -494,6 +495,7 @@ interface AgentEventPayloads {
     action: 'delegate' | 'handoff';
     expectedOutput?: string;
     constraints?: string[];
+    childRunId?: string;
   };
   'team.handoff.created': {
     delegationId: 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-Br-zPxZH.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-CseuTR-F.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.5",
+  "version": "0.1.0-alpha.7",
   "description": "Agent Engineering Framework for code-first, provider-neutral AI agents.",
   "type": "module",
   "license": "Apache-2.0",

package/dist/index-D6lnI92z.d.mts

@@ -1,80 +0,0 @@
-import { f as RunId, l as JsonValue, s as JsonObject } from "./types-BDVUoAU6.mjs";
-import { r as ModelMetadata, s as ModelUsage } from "./index-BPwkgdo3.mjs";
-import { I as SessionId } from "./index-CGmHXV31.mjs";
-//#region src/observability/trace.d.ts
-/** Final state represented by an exported run trace. */
-type TraceStatus = 'completed' | 'failed' | 'cancelled';
-type TraceSpanKind = 'model' | 'tool';
-type TraceContentKind = 'run.output' | 'model.output' | 'error.message';
-interface TraceCost {
-  amount: number;
-  currency: string;
-}
-interface TraceContent {
-  kind: TraceContentKind;
-  value: JsonValue;
-}
-interface TraceAnnotation {
-  name: string;
-  timestamp: string;
-  attributes?: JsonObject;
-}
-interface TraceSpan {
-  id: string;
-  parentId: string;
-  kind: TraceSpanKind;
-  name: string;
-  startedAt: string;
-  endedAt: string;
-  durationMs: number;
-  status: TraceStatus;
-  attributes: JsonObject;
-  annotations: TraceAnnotation[];
-  usage?: ModelUsage;
-  cost?: TraceCost;
-  content?: TraceContent[];
-}
-interface RunTrace {
-  schemaVersion: '1';
-  traceId: string;
-  runId: RunId;
-  sessionId: SessionId;
-  agentName: string;
-  modelRegistryName: string;
-  model?: ModelMetadata;
-  startedAt: string;
-  endedAt: string;
-  durationMs: number;
-  status: TraceStatus;
-  attributes: JsonObject;
-  annotations: TraceAnnotation[];
-  spans: TraceSpan[];
-  usage?: ModelUsage;
-  cost?: TraceCost;
-  content?: TraceContent[];
-}
-interface CostCalculatorInput {
-  modelRegistryName: string;
-  model?: ModelMetadata;
-  usage: ModelUsage;
-}
-type CostCalculator = (input: CostCalculatorInput) => TraceCost | undefined;
-interface TraceRedactorInput {
-  kind: TraceContentKind;
-  value: JsonValue;
-}
-type TraceRedactor = (input: TraceRedactorInput) => JsonValue | undefined;
-interface TraceContentPolicy {
-  include: readonly TraceContentKind[];
-  redact?: TraceRedactor;
-}
-interface TraceExporter {
-  export(trace: Readonly<RunTrace>): void | Promise<void>;
-}
-interface ObservabilityOptions {
-  exporters: readonly TraceExporter[];
-  calculateCost?: CostCalculator;
-  content?: TraceContentPolicy;
-}
-//#endregion
-export { TraceAnnotation as a, TraceContentPolicy as c, TraceRedactor as d, TraceRedactorInput as f, TraceStatus as h, RunTrace as i, TraceCost as l, TraceSpanKind as m, CostCalculatorInput as n, TraceContent as o, TraceSpan as p, ObservabilityOptions as r, TraceContentKind as s, CostCalculator as t, TraceExporter as u };

package/dist/index-aayvtf0J.d.mts

@@ -1,70 +0,0 @@
-import { l as JsonValue, o as ExecutionContext, s as JsonObject } from "./types-BDVUoAU6.mjs";
-import { I as SessionId } from "./index-CGmHXV31.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 };