@full-self-browsing/lattice 1.3.0-rc.0 → 1.4.0

package/dist/{runtime-CfZ-sGGk.js → runtime-D25ehzCj.js}

@@ -1,17 +1,6 @@
+import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
 import mime from "mime";
 import canonicalize from "canonicalize";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
 //#region src/artifacts/metadata.ts
 const textEncoder$1 = new TextEncoder();
 function inferMediaType(value, options) {
@@ -446,13 +435,16 @@ async function createReceipt(input, signer) {
 	const receiptId = input.receiptId ?? crypto.randomUUID();
 	const issuedAt = input.issuedAt ?? (/* @__PURE__ */ new Date()).toISOString();
 	const { body } = redactReceiptBody({
-		version: "lattice-receipt/v1.1",
+		version: "lattice-receipt/v1.3",
 		receiptId,
 		runId: input.runId,
 		issuedAt,
 		kid: signer.kid,
 		model: input.model,
 		route: input.route,
+		...input.modelClass !== void 0 ? { modelClass: input.modelClass } : {},
+		...input.parentReceiptCid !== void 0 ? { parentReceiptCid: input.parentReceiptCid } : {},
+		...input.lineageMerkleRoot !== void 0 ? { lineageMerkleRoot: input.lineageMerkleRoot } : {},
 		usage: usageToCanonical(input.usage),
 		contractVerdict: input.contractVerdict,
 		contractHash: input.contractHash,
@@ -597,51 +589,164 @@ function extractReceiptId(envelope) {
 	}
 }
 //#endregion
-//#region src/runtime/survivability.ts
+//#region src/agent/format-tools.ts
 /**
-* Reference implementation of SurvivabilityAdapter<TState>. Records
-* eviction events but does NOT persist; serialize / deserialize round-
-* trip via JSON.stringify / JSON.parse. Analog to createFakeProvider
-* in the providers/ module -- gives Lattice's vitest a complete shape-
-* conformance target before the real (FSB-side) adapter ships in
-* Plan 05-05.
-*
-* Per CONTEXT.md D-11 the noop adapter ships in Lattice (not FSB)
-* because it covers the contract surface in Lattice's own test suite;
-* FSB's real chrome.storage.session-backed adapter is glue layer.
+* Convert a Standard Schema to a JSON Schema-shaped descriptor suitable for
+* inclusion in an LLM tool description. Standard Schema vendors can
+* optionally expose `toJSONSchema` on their schema objects; when absent,
+* we fall back to a minimal structural description that lists the schema
+* vendor + version + a placeholder. Models tolerate placeholder schemas in
+* practice because the tool description is supplementary — what matters
+* is the envelope contract (`{tool_call: {name, args}}`).
 */
-function createNoopSurvivabilityAdapter(options = {}) {
-	const id = options.id ?? "noop-survivability";
-	const defaultPolicy = options.policy ?? "SAFE";
-	const hooks = /* @__PURE__ */ new Set();
+function toolSchemaToJsonSchema(schema) {
+	const standardSchema = schema["~standard"];
+	if (typeof standardSchema === "object" && standardSchema !== null && "vendor" in standardSchema) {
+		const vendor = standardSchema;
+		const maybeToJson = schema.toJSONSchema;
+		if (typeof maybeToJson === "function") try {
+			return maybeToJson();
+		} catch {}
+		return {
+			$comment: `standard-schema vendor: ${vendor.vendor}; toJSONSchema not available`,
+			type: "object"
+		};
+	}
 	return {
-		kind: "survivability-adapter",
-		id,
-		serialize(state) {
-			return {
-				kind: "survivability-snapshot",
-				version: "lattice-survivability/v1",
-				payload: JSON.stringify(state ?? null),
-				capturedAt: (/* @__PURE__ */ new Date()).toISOString()
-			};
-		},
-		deserialize(snapshot) {
-			return JSON.parse(snapshot.payload);
-		},
-		onEviction(hook) {
-			hooks.add(hook);
-			let unsubscribed = false;
-			return () => {
-				if (unsubscribed) return;
-				unsubscribed = true;
-				hooks.delete(hook);
-			};
-		},
-		async resume(_snapshot) {
-			return defaultPolicy;
+		$comment: "non-standard-schema input",
+		type: "object"
+	};
+}
+/**
+* Builds the prompt-reencoded tool-use protocol handle for any provider.
+*
+* Phase 19 ships a uniform implementation across all 7 logical providers
+* (openai, openai-compat, anthropic, gemini, xai, openrouter, lm-studio).
+* The `providerName` argument is accepted for forward compatibility but
+* does not branch the implementation in v1.2.
+*/
+function formatToolsForProvider(providerName, tools, options = {}) {
+	options.mode;
+	const system = options.system?.trim() ?? "";
+	const toolDescriptions = tools.map((tool) => {
+		const schemaDescriptor = toolSchemaToJsonSchema(tool.inputSchema);
+		const schemaJson = JSON.stringify(schemaDescriptor, null, 2);
+		const desc = tool.description?.trim() ?? "(no description)";
+		return `- name: ${tool.name}\n  description: ${desc}\n  args_schema: ${schemaJson}`;
+	}).join("\n");
+	const envelopeInstructions = [
+		"You are a single-agent loop. You can either:",
+		"  (a) answer the user directly with a final response, OR",
+		"  (b) request one or more tool calls.",
+		"",
+		"To request tool calls, respond with ONE JSON object on a line by itself:",
+		"  {\"tool_calls\": [{\"id\": \"...\", \"name\": \"tool_name\", \"args\": {...}}]}",
+		"Each tool_call needs a unique id (any string). The args MUST match the tool's args_schema.",
+		"",
+		"To answer directly, respond with a final answer in natural language with NO JSON envelope.",
+		"Do not mix a final answer and a tool_calls envelope in the same response."
+	].join("\n");
+	const systemBlock = [
+		system,
+		"",
+		"Available tools:",
+		toolDescriptions || "(none)",
+		"",
+		envelopeInstructions
+	].filter((s) => s !== "" || true).join("\n").replace(/^\n+/, "").trimEnd();
+	function assembleTask(conversation, includeSystemBlock) {
+		const lines = [];
+		if (includeSystemBlock) lines.push(systemBlock);
+		lines.push("");
+		lines.push("---");
+		lines.push("");
+		for (const turn of conversation) {
+			if (turn.role === "user") lines.push(`USER:\n${turn.content}`);
+			else if (turn.role === "assistant") lines.push(`ASSISTANT:\n${turn.content}`);
+			else {
+				const idHint = turn.toolCallId !== void 0 ? ` id=${turn.toolCallId}` : "";
+				const nameHint = turn.toolName !== void 0 ? ` name=${turn.toolName}` : "";
+				lines.push(`TOOL_RESULT (${nameHint.trim() || "tool"}${idHint}):\n${turn.content}`);
+			}
+			lines.push("");
 		}
+		lines.push("ASSISTANT:");
+		return lines.join("\n");
+	}
+	function buildTask(conversation) {
+		return assembleTask(conversation, true);
+	}
+	function buildTaskBody(conversation) {
+		return assembleTask(conversation, false);
+	}
+	function describeForSystem() {
+		return systemBlock;
+	}
+	return {
+		buildTask,
+		buildTaskBody,
+		parseToolUse: parseToolUseEnvelope,
+		describeForSystem,
+		mode: "prompt-reencoded"
 	};
 }
+function parseToolUseEnvelope(responseText) {
+	if (typeof responseText !== "string" || responseText.length === 0) return null;
+	const candidates = extractJsonCandidates(responseText);
+	for (const candidate of candidates) {
+		const parsed = tryParseEnvelope(candidate);
+		if (parsed !== null) return parsed;
+	}
+	return null;
+}
+/**
+* Extracts JSON-looking candidate substrings from a response text.
+*
+* Models routinely wrap JSON in markdown code fences (```json ... ```),
+* prepend explanatory prose ("I'll call the search tool: { ... }"), or
+* produce multiple JSON-shaped blobs. This extractor scans for plausible
+* candidates ordered by likelihood.
+*/
+function extractJsonCandidates(text) {
+	const candidates = [];
+	const fenceRegex = /```(?:json)?\s*([\s\S]*?)```/g;
+	let fenceMatch;
+	while ((fenceMatch = fenceRegex.exec(text)) !== null) {
+		const inner = fenceMatch[1];
+		if (inner !== void 0) candidates.push(inner.trim());
+	}
+	const braceStart = text.indexOf("{");
+	const braceEnd = text.lastIndexOf("}");
+	if (braceStart !== -1 && braceEnd > braceStart) candidates.push(text.slice(braceStart, braceEnd + 1));
+	candidates.push(text.trim());
+	return candidates;
+}
+function tryParseEnvelope(jsonLike) {
+	let parsed;
+	try {
+		parsed = JSON.parse(jsonLike);
+	} catch {
+		return null;
+	}
+	if (typeof parsed !== "object" || parsed === null) return null;
+	const toolCalls = parsed["tool_calls"];
+	if (!Array.isArray(toolCalls) || toolCalls.length === 0) return null;
+	const requests = [];
+	for (const call of toolCalls) {
+		if (typeof call !== "object" || call === null) return null;
+		const callRecord = call;
+		const id = callRecord["id"];
+		const name = callRecord["name"];
+		const args = callRecord["args"];
+		if (typeof id !== "string" || typeof name !== "string") return null;
+		requests.push({
+			id,
+			name,
+			args
+		});
+	}
+	return requests;
+}
 //#endregion
 //#region src/outputs/validate.ts
 async function validateSchemaOutput(name, schema, value) {
@@ -771,6 +876,52 @@ function normalizePathKey(key) {
 	return key;
 }
 //#endregion
+//#region src/runtime/survivability.ts
+/**
+* Reference implementation of SurvivabilityAdapter<TState>. Records
+* eviction events but does NOT persist; serialize / deserialize round-
+* trip via JSON.stringify / JSON.parse. Analog to createFakeProvider
+* in the providers/ module -- gives Lattice's vitest a complete shape-
+* conformance target before the real (FSB-side) adapter ships in
+* Plan 05-05.
+*
+* Per CONTEXT.md D-11 the noop adapter ships in Lattice (not FSB)
+* because it covers the contract surface in Lattice's own test suite;
+* FSB's real chrome.storage.session-backed adapter is glue layer.
+*/
+function createNoopSurvivabilityAdapter(options = {}) {
+	const id = options.id ?? "noop-survivability";
+	const defaultPolicy = options.policy ?? "SAFE";
+	const hooks = /* @__PURE__ */ new Set();
+	return {
+		kind: "survivability-adapter",
+		id,
+		serialize(state) {
+			return {
+				kind: "survivability-snapshot",
+				version: "lattice-survivability/v1",
+				payload: JSON.stringify(state ?? null),
+				capturedAt: (/* @__PURE__ */ new Date()).toISOString()
+			};
+		},
+		deserialize(snapshot) {
+			return JSON.parse(snapshot.payload);
+		},
+		onEviction(hook) {
+			hooks.add(hook);
+			let unsubscribed = false;
+			return () => {
+				if (unsubscribed) return;
+				unsubscribed = true;
+				hooks.delete(hook);
+			};
+		},
+		async resume(_snapshot) {
+			return defaultPolicy;
+		}
+	};
+}
+//#endregion
 //#region src/tools/tools.ts
 function defineTool(definition) {
 	return {
@@ -815,158 +966,6 @@ function createToolCallId() {
 	return `${Date.now()}:${Math.random().toString(16).slice(2)}`;
 }
 //#endregion
-//#region src/agent/format-tools.ts
-/**
-* Convert a Standard Schema to a JSON Schema-shaped descriptor suitable for
-* inclusion in an LLM tool description. Standard Schema vendors can
-* optionally expose `toJSONSchema` on their schema objects; when absent,
-* we fall back to a minimal structural description that lists the schema
-* vendor + version + a placeholder. Models tolerate placeholder schemas in
-* practice because the tool description is supplementary — what matters
-* is the envelope contract (`{tool_call: {name, args}}`).
-*/
-function toolSchemaToJsonSchema(schema) {
-	const standardSchema = schema["~standard"];
-	if (typeof standardSchema === "object" && standardSchema !== null && "vendor" in standardSchema) {
-		const vendor = standardSchema;
-		const maybeToJson = schema.toJSONSchema;
-		if (typeof maybeToJson === "function") try {
-			return maybeToJson();
-		} catch {}
-		return {
-			$comment: `standard-schema vendor: ${vendor.vendor}; toJSONSchema not available`,
-			type: "object"
-		};
-	}
-	return {
-		$comment: "non-standard-schema input",
-		type: "object"
-	};
-}
-/**
-* Builds the prompt-reencoded tool-use protocol handle for any provider.
-*
-* Phase 19 ships a uniform implementation across all 7 logical providers
-* (openai, openai-compat, anthropic, gemini, xai, openrouter, lm-studio).
-* The `providerName` argument is accepted for forward compatibility but
-* does not branch the implementation in v1.2.
-*/
-function formatToolsForProvider(providerName, tools, options = {}) {
-	options.mode;
-	const system = options.system?.trim() ?? "";
-	const toolDescriptions = tools.map((tool) => {
-		const schemaDescriptor = toolSchemaToJsonSchema(tool.inputSchema);
-		const schemaJson = JSON.stringify(schemaDescriptor, null, 2);
-		const desc = tool.description?.trim() ?? "(no description)";
-		return `- name: ${tool.name}\n  description: ${desc}\n  args_schema: ${schemaJson}`;
-	}).join("\n");
-	const envelopeInstructions = [
-		"You are a single-agent loop. You can either:",
-		"  (a) answer the user directly with a final response, OR",
-		"  (b) request one or more tool calls.",
-		"",
-		"To request tool calls, respond with ONE JSON object on a line by itself:",
-		"  {\"tool_calls\": [{\"id\": \"...\", \"name\": \"tool_name\", \"args\": {...}}]}",
-		"Each tool_call needs a unique id (any string). The args MUST match the tool's args_schema.",
-		"",
-		"To answer directly, respond with a final answer in natural language with NO JSON envelope.",
-		"Do not mix a final answer and a tool_calls envelope in the same response."
-	].join("\n");
-	const systemBlock = [
-		system,
-		"",
-		"Available tools:",
-		toolDescriptions || "(none)",
-		"",
-		envelopeInstructions
-	].filter((s) => s !== "" || true).join("\n").replace(/^\n+/, "").trimEnd();
-	function buildTask(conversation) {
-		const lines = [];
-		lines.push(systemBlock);
-		lines.push("");
-		lines.push("---");
-		lines.push("");
-		for (const turn of conversation) {
-			if (turn.role === "user") lines.push(`USER:\n${turn.content}`);
-			else if (turn.role === "assistant") lines.push(`ASSISTANT:\n${turn.content}`);
-			else {
-				const idHint = turn.toolCallId !== void 0 ? ` id=${turn.toolCallId}` : "";
-				const nameHint = turn.toolName !== void 0 ? ` name=${turn.toolName}` : "";
-				lines.push(`TOOL_RESULT (${nameHint.trim() || "tool"}${idHint}):\n${turn.content}`);
-			}
-			lines.push("");
-		}
-		lines.push("ASSISTANT:");
-		return lines.join("\n");
-	}
-	function parseToolUse(responseText) {
-		if (typeof responseText !== "string" || responseText.length === 0) return null;
-		const candidates = extractJsonCandidates(responseText);
-		for (const candidate of candidates) {
-			const parsed = tryParseEnvelope(candidate);
-			if (parsed !== null) return parsed;
-		}
-		return null;
-	}
-	function describeForSystem() {
-		return systemBlock;
-	}
-	return {
-		buildTask,
-		parseToolUse,
-		describeForSystem,
-		mode: "prompt-reencoded"
-	};
-}
-/**
-* Extracts JSON-looking candidate substrings from a response text.
-*
-* Models routinely wrap JSON in markdown code fences (```json ... ```),
-* prepend explanatory prose ("I'll call the search tool: { ... }"), or
-* produce multiple JSON-shaped blobs. This extractor scans for plausible
-* candidates ordered by likelihood.
-*/
-function extractJsonCandidates(text) {
-	const candidates = [];
-	const fenceRegex = /```(?:json)?\s*([\s\S]*?)```/g;
-	let fenceMatch;
-	while ((fenceMatch = fenceRegex.exec(text)) !== null) {
-		const inner = fenceMatch[1];
-		if (inner !== void 0) candidates.push(inner.trim());
-	}
-	const braceStart = text.indexOf("{");
-	const braceEnd = text.lastIndexOf("}");
-	if (braceStart !== -1 && braceEnd > braceStart) candidates.push(text.slice(braceStart, braceEnd + 1));
-	candidates.push(text.trim());
-	return candidates;
-}
-function tryParseEnvelope(jsonLike) {
-	let parsed;
-	try {
-		parsed = JSON.parse(jsonLike);
-	} catch {
-		return null;
-	}
-	if (typeof parsed !== "object" || parsed === null) return null;
-	const toolCalls = parsed["tool_calls"];
-	if (!Array.isArray(toolCalls) || toolCalls.length === 0) return null;
-	const requests = [];
-	for (const call of toolCalls) {
-		if (typeof call !== "object" || call === null) return null;
-		const callRecord = call;
-		const id = callRecord["id"];
-		const name = callRecord["name"];
-		const args = callRecord["args"];
-		if (typeof id !== "string" || typeof name !== "string") return null;
-		requests.push({
-			id,
-			name,
-			args
-		});
-	}
-	return requests;
-}
-//#endregion
 //#region src/agent/host.ts
 /**
 * Reference implementation suitable for Node tests + the Phase 19 default
@@ -1020,7 +1019,10 @@ var AgentDeniedError = class extends Error {
 };
 //#endregion
 //#region src/agent/runtime.ts
-var runtime_exports = /* @__PURE__ */ __exportAll({ runAgent: () => runAgent });
+var runtime_exports = /* @__PURE__ */ __exportAll({
+	runAgent: () => runAgent,
+	runAgentInternal: () => runAgentInternal
+});
 const ZERO_USAGE = {
 	promptTokens: 0,
 	completionTokens: 0,
@@ -1033,8 +1035,20 @@ const ZERO_USAGE = {
 * calling Promise), direct transport (provider.execute()), and in-memory
 * transcript (the `conversation` array). Phase 20 promotes scheduler /
 * transport / storage to the pluggable `AgentHost` adapter.
+*
+* Phase 39: `runAgent` is a thin public wrapper over `runAgentInternal`
+* with no internal options — the public signature and behavior are
+* unchanged.
 */
 async function runAgent(intent, config = {}) {
+	return runAgentInternal(intent, config);
+}
+/**
+* The agent-loop implementation with the internal dispatch seam (Phase 39).
+* In-package consumers (agent/crew/, 39-05) call this directly; it is NOT
+* part of the public package surface.
+*/
+async function runAgentInternal(intent, config = {}, internalOptions = {}) {
 	const startedAt = Date.now();
 	const cumulativeUsage = {
 		promptTokens: 0,
@@ -1169,8 +1183,12 @@ async function runAgent(intent, config = {}) {
 		const iterUsage = response.normalizedUsage ?? ZERO_USAGE;
 		accumulateUsage(cumulativeUsage, iterUsage);
 		const responseText = extractResponseText(response);
-		const toolUseRequests = handle.parseToolUse(responseText);
-		if (toolUseRequests === null) {
+		const toolUseRequests = response.toolCalls !== void 0 ? response.toolCalls.map((toolCall) => ({
+			id: toolCall.id,
+			name: toolCall.name,
+			args: toolCall.args
+		})) : handle.parseToolUse(responseText);
+		if (toolUseRequests === null || toolUseRequests.length === 0) {
 			const finalRecord = {
 				index: iterationIndex,
 				provider: providerName,
@@ -1195,9 +1213,11 @@ async function runAgent(intent, config = {}) {
 				previousStepName: `agent-iteration-${iterationIndex}-before`
 			});
 			await host.storage?.clear();
+			const artifactRefs = response.artifactRefs !== void 0 ? response.artifactRefs.map(toArtifactRef) : [];
 			return {
 				kind: "success",
 				output: { answer: responseText },
+				...artifactRefs.length > 0 ? { artifacts: artifactRefs } : {},
 				usage: snapshotUsage(cumulativeUsage),
 				iterations: Object.freeze([...iterations])
 			};
@@ -1208,28 +1228,41 @@ async function runAgent(intent, config = {}) {
 		});
 		const toolCallRecords = [];
 		for (const req of toolUseRequests) {
-			const tool = intent.tools.find((t) => t.name === req.name);
-			let toolResult = null;
-			let resultContent;
+			let resultContent = null;
 			let resultHash = "tool-not-found";
-			if (tool === void 0) resultContent = JSON.stringify({ error: `Unknown tool: ${req.name}` });
-			else try {
-				await pipeline.run("BEFORE_TOOL", {
+			if (internalOptions.dispatchToolUse !== void 0) {
+				const dispatched = await internalOptions.dispatchToolUse(req, {
 					iterationIndex,
-					toolName: req.name,
-					args: req.args
+					conversation,
+					pipeline
 				});
-				toolResult = await runTool(tool, req.args);
-				resultContent = stringifyArtifactValue(toolResult.artifact.value);
-				resultHash = toolResult.callId;
-				await pipeline.run("AFTER_TOOL", {
-					iterationIndex,
-					toolName: req.name,
-					args: req.args,
-					result: toolResult.artifact.value
-				});
-			} catch (error) {
-				resultContent = JSON.stringify({ error: error instanceof Error ? error.message : "Tool execution failed" });
+				if (dispatched !== void 0) {
+					resultContent = dispatched.content;
+					resultHash = stableHash(dispatched.content);
+				}
+			}
+			if (resultContent === null) {
+				const tool = intent.tools.find((t) => t.name === req.name);
+				let toolResult = null;
+				if (tool === void 0) resultContent = JSON.stringify({ error: `Unknown tool: ${req.name}` });
+				else try {
+					await pipeline.run("BEFORE_TOOL", {
+						iterationIndex,
+						toolName: req.name,
+						args: req.args
+					});
+					toolResult = await runTool(tool, req.args);
+					resultContent = stringifyArtifactValue(toolResult.artifact.value);
+					resultHash = toolResult.callId;
+					await pipeline.run("AFTER_TOOL", {
+						iterationIndex,
+						toolName: req.name,
+						args: req.args,
+						result: toolResult.artifact.value
+					});
+				} catch (error) {
+					resultContent = JSON.stringify({ error: error instanceof Error ? error.message : "Tool execution failed" });
+				}
 			}
 			conversation.push({
 				role: "tool",
@@ -1354,6 +1387,6 @@ function stableHash(input) {
 	}
 }
 //#endregion
-export { createHookPipeline as C, BAND as S, toArtifactRef as T, PAYLOAD_TYPE as _, formatToolsForProvider as a, decodeEnvelope as b, importMcpTools as c, validateOutputMap as d, createNoopSurvivabilityAdapter as f, createReceipt as g, createCheckpointHook as h, createNoopAgentHost as i, runTool as l, STEP_TRANSITION_EVENT_NAME as m, runtime_exports as n, toolSchemaToJsonSchema as o, DEFAULT_CHECKPOINT_BAND as p, AgentDeniedError as r, defineTool as s, runAgent as t, toolArtifactRef as u, base64Encode as v, artifact as w, canonicalizeReceiptBody as x, buildPae as y };
+export { decodeEnvelope as C, artifact as D, createHookPipeline as E, isArtifactRef as O, buildPae as S, BAND as T, STEP_TRANSITION_EVENT_NAME as _, createNoopAgentHost as a, PAYLOAD_TYPE as b, runTool as c, validateOutputMap as d, validateSchemaOutput as f, DEFAULT_CHECKPOINT_BAND as g, toolSchemaToJsonSchema as h, AgentDeniedError as i, toArtifactRef as k, toolArtifactRef as l, parseToolUseEnvelope as m, runAgentInternal as n, defineTool as o, formatToolsForProvider as p, runtime_exports as r, importMcpTools as s, runAgent as t, createNoopSurvivabilityAdapter as u, createCheckpointHook as v, canonicalizeReceiptBody as w, base64Encode as x, createReceipt as y };
 
-//# sourceMappingURL=runtime-CfZ-sGGk.js.map
+//# sourceMappingURL=runtime-D25ehzCj.js.map