@tangle-network/agent-runtime 0.348.1 → 0.350.2

package/dist/index.js

@@ -1,15 +1,15 @@
-import { Dn as loopEventToOtelSpan, Er as ROUTER_PRICE_SOURCE, Mn as createRuntimeStreamEventCollector, Nn as sanitizeKnowledgeReadinessReport, On as padSpanId, Pn as sanitizeRuntimeStreamEvent, Ti as runtimeFailureCause, Tr as priceTokens, Xi as resolveRedactor, Yi as defaultRedactorIdentityMaterial, bn as buildLoopOtelSpans, da as providerMessageText, jn as createRuntimeEventCollector, kn as padTraceId, wn as createOtelExporter, xi as executableAgentProfileSnapshot } from "./supervisor-DDy0aEtR.js";
-import { a as JudgeError, f as RuntimeRunStateError, i as ConfigError, m as ValidationError, o as NotFoundError, r as BackendTransportError, t as AgentEvalError } from "./errors-DodWX-cb.js";
-import { B as InMemoryRuntimeSessionStore, C as optimizerMethod, H as nowIso, I as streamAgentTurn, L as createIterableBackend, R as createSandboxPromptBackend, U as startOrResumeRuntimeSession, V as newRuntimeSession, W as touchSession, z as normalizeBackendStreamEvent } from "./structural-rollout-Wl_rCuzM.js";
-import { L as embeddedCandidateArtifact, N as canonicalCandidateBytes$1, P as canonicalCandidateDigest$1, R as immutableCandidateValue, b as persistCandidateOutputArtifact, l as captureAgentCandidateWorkspace, ot as sleep, z as omitTopLevelDigest } from "./sandbox-profile-compat-_fEtHPCj.js";
-import { t as assertExecutableAgentProfile } from "./model-policy-CyCUwHed.js";
-import { c as withMethodRuntimeControls, d as commandVerifier, f as addRuntimeUsage, i as assertCandidateValidator, m as isUsageAmount, n as createCommandProfileTrainer, o as parseExecutionRef, p as createRuntimeUsageTotals, r as searchMethod, s as privateValuePaths, t as improve, u as agenticGenerator } from "./improve-wT11zteg.js";
-import { n as defineRuntimeHooks, t as composeRuntimeHooks } from "./runtime-hooks-tXpAarhW.js";
-import { n as createAgentImprovementActivationResult } from "./activation-BEGalhOL.js";
-import { l as sharedBoxLane, o as routerLane, r as dedicatedLane, t as SearchEnvironmentFault, u as subscriptionLane, y as decideSearchImprovement } from "./search-executor-COd2F2wp.js";
-import { t as sealAgentCandidateBundle } from "./bundle-DKQtOO9d.js";
-import { t as supervise } from "./supervise-BUOeThuB.js";
-import { n as auditLoopRunner } from "./loop-runner-CZzeeJTG.js";
+import { Dn as loopEventToOtelSpan, Ei as runtimeFailureCause, Er as ROUTER_PRICE_SOURCE, Mn as createRuntimeStreamEventCollector, Nn as sanitizeKnowledgeReadinessReport, On as padSpanId, Pn as sanitizeRuntimeStreamEvent, Qi as resolveRedactor, Si as executableAgentProfileSnapshot, Tr as priceTokens, Zi as defaultRedactorIdentityMaterial, bn as buildLoopOtelSpans, jn as createRuntimeEventCollector, kn as padTraceId, pa as providerMessageText, wn as createOtelExporter } from "./supervisor-C1OePYE-.js";
+import { a as JudgeError, f as RuntimeRunStateError, i as ConfigError, m as ValidationError, o as NotFoundError, r as BackendTransportError, t as AgentEvalError } from "./errors-wuhGvpE3.js";
+import { B as InMemoryRuntimeSessionStore, C as optimizerMethod, H as nowIso, I as streamAgentTurn, L as createIterableBackend, R as createSandboxPromptBackend, U as startOrResumeRuntimeSession, V as newRuntimeSession, W as touchSession, z as normalizeBackendStreamEvent } from "./structural-rollout-B86bSixU.js";
+import { L as embeddedCandidateArtifact, N as canonicalCandidateBytes$1, P as canonicalCandidateDigest$1, R as immutableCandidateValue, b as persistCandidateOutputArtifact, l as captureAgentCandidateWorkspace, st as sleep, z as omitTopLevelDigest } from "./sandbox-profile-compat-BxMQ1VXv.js";
+import { t as assertExecutableAgentProfile } from "./model-policy-GSxWwP-b.js";
+import { c as withMethodRuntimeControls, d as commandVerifier, f as addRuntimeUsage, i as assertCandidateValidator, m as isUsageAmount, n as createCommandProfileTrainer, o as parseExecutionRef, p as createRuntimeUsageTotals, r as searchMethod, s as privateValuePaths, t as improve, u as agenticGenerator } from "./improve-i0HU1-aa.js";
+import { n as defineRuntimeHooks, t as composeRuntimeHooks } from "./runtime-hooks-CsW2pfFk.js";
+import { n as createAgentImprovementActivationResult } from "./activation-CfJMyzEs.js";
+import { l as sharedBoxLane, o as routerLane, r as dedicatedLane, t as SearchEnvironmentFault, u as subscriptionLane, y as decideSearchImprovement } from "./search-executor-B7g_5Wjl.js";
+import { t as sealAgentCandidateBundle } from "./bundle-Ze8pd07a.js";
+import { t as supervise } from "./supervise-CaeZcgAW.js";
+import { n as auditLoopRunner } from "./loop-runner-BwN9MhdP.js";
 import { agentCandidateKnowledgeSchema, agentCandidateWorkspaceManifestMaterialSchema, agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest, sha256DigestSchema } from "@tangle-network/agent-interface";
 import { FAILURE_CLASSES, acquisitionPlansForKnowledgeGaps, blockingKnowledgeEval, canonicalJson, runAgentControlLoop, scoreKnowledgeReadiness, userQuestionsForKnowledgeGaps } from "@tangle-network/agent-eval";
 import { z } from "zod";
@@ -20,7 +20,7 @@ import { spawnSync } from "node:child_process";
 import { realpath } from "node:fs/promises";
 import { gepaOptimizationMethod, skillOptOptimizationMethod } from "@tangle-network/agent-eval/campaign";
 import { evaluateKnowledgeBaseReadiness, fromAgentCandidateKnowledgeRef, improveKnowledgeBase, knowledgeImprovementCandidateRef, loadKnowledgeImprovementActivationResult, normalizeKnowledgeStateScope, promoteKnowledgeCandidate, restoreKnowledgeCandidateBaseline, toAgentCandidateKnowledgeRef, withKnowledgeImprovementComparison } from "@tangle-network/agent-knowledge";
-//#region src/runtime/profile-execution-backend.ts
+// src/runtime/profile-execution-backend.ts
 /**
 * Bind one exact profile and Runtime executor to the stable `AgentExecutionBackend` contract used
 * by `runAgentTaskStream` and conversations.
@@ -100,8 +100,7 @@ function rebindEvent(event, context) {
 		session: context.session
 	};
 }
-//#endregion
-//#region src/conversation/headers.ts
+// src/conversation/headers.ts
 /**
 *
 * Cross-gateway forwarding headers — the wire-level contract that makes
@@ -179,8 +178,7 @@ function pickHeader(headers, name) {
 		return value;
 	}
 }
-//#endregion
-//#region src/conversation/call-policy.ts
+// src/conversation/call-policy.ts
 /** Thrown when the circuit breaker is open for a participant and no retry is allowed yet. */
 var CircuitOpenError = class extends Error {
 	constructor(participant, retryAfterMs) {
@@ -252,11 +250,13 @@ function makePerAttemptSignal(parentSignal, deadlineMs) {
 	const controller = new AbortController();
 	let deadlineError;
 	const cleanups = [];
-	if (parentSignal) if (parentSignal.aborted) controller.abort(parentSignal.reason);
-	else {
-		const onAbort = () => controller.abort(parentSignal.reason);
-		parentSignal.addEventListener("abort", onAbort, { once: true });
-		cleanups.push(() => parentSignal.removeEventListener("abort", onAbort));
+	if (parentSignal) {
+		if (parentSignal.aborted) controller.abort(parentSignal.reason);
+		else {
+			const onAbort = () => controller.abort(parentSignal.reason);
+			parentSignal.addEventListener("abort", onAbort, { once: true });
+			cleanups.push(() => parentSignal.removeEventListener("abort", onAbort));
+		}
 	}
 	if (deadlineMs !== void 0) {
 		const ms = deadlineMs;
@@ -286,8 +286,7 @@ function computeBackoff(spec, attempt) {
 	if (typeof spec === "function") return Math.max(0, spec(attempt));
 	return Math.max(0, spec);
 }
-//#endregion
-//#region src/conversation/turn-id.ts
+// src/conversation/turn-id.ts
 /**
 *
 * Deterministic turn identifier. Stable across retries of the same logical
@@ -313,8 +312,7 @@ function turnId(runId, index, speaker) {
 function slugifySpeaker(speaker) {
 	return speaker.normalize("NFKD").replace(/[^\w-]+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").toLowerCase() || "anon";
 }
-//#endregion
-//#region src/conversation/run-conversation.ts
+// src/conversation/run-conversation.ts
 /** Run a conversation to completion and return its terminal result. */
 async function runConversation(conversation, options) {
 	let result;
@@ -755,8 +753,7 @@ function passingReadiness(taskId) {
 		reason: "conversation-mode: readiness gating not applied per-turn"
 	};
 }
-//#endregion
-//#region src/conversation/conversation-backend.ts
+// src/conversation/conversation-backend.ts
 /**
 *
 * Wrap a `Conversation` so it satisfies `AgentExecutionBackend`. The result is
@@ -881,8 +878,7 @@ function describeHalt(halt) {
 		case "participant_error": return `participant_error[${halt.participant}]: ${halt.message}`;
 	}
 }
-//#endregion
-//#region src/conversation/define-conversation.ts
+// src/conversation/define-conversation.ts
 /**
 *
 * Declarative constructor for a multi-agent `Conversation`. Validates inputs
@@ -918,8 +914,7 @@ function normalizePolicy(policy, participantCount) {
 		turnOrder
 	};
 }
-//#endregion
-//#region src/conversation/run-persona.ts
+// src/conversation/run-persona.ts
 /** Adapt one exact profile + Runtime executor into the conversation stream protocol. */
 function profileRuntimeBackend(profile, factory, counter) {
 	const backend = createProfileExecutionBackend({
@@ -1047,8 +1042,7 @@ function runPersonaDispatch(config) {
 		return config.artifactOf(result.transcript, scenario);
 	};
 }
-//#endregion
-//#region src/improvement/official-optimizers.ts
+// src/improvement/official-optimizers.ts
 const defaultMaxFindingsChars = 5e4;
 const pythonClientDocs = "https://github.com/tangle-network/agent-eval/tree/main/clients/python";
 const bridgeInstall = "`python -m pip install \"agent-eval-rpc==0.145.0\"`";
@@ -1104,7 +1098,7 @@ function officialOptimizer(optimizer, options, create) {
 			describeArtifact,
 			authorizeSensitiveCandidate
 		});
-		return withMethodRuntimeControls(withDependencyHelp(optimizer, externalEvaluationRef, redactor, redactionPolicyRef, create({
+		const method = withDependencyHelp(optimizer, externalEvaluationRef, redactor, redactionPolicyRef, create({
 			...config,
 			objective,
 			evaluationId: externalEvaluationRef,
@@ -1119,7 +1113,8 @@ function officialOptimizer(optimizer, options, create) {
 			}),
 			...describeScenario ? { describeScenario: (scenario) => redactOptimizerEvidence(label, "scenario descriptor", describeScenario(scenario), redactor) } : {},
 			...describeArtifact ? { describeArtifact: (artifact, scenario) => redactOptimizerEvidence(label, "artifact descriptor", describeArtifact(artifact, scenario), redactor) } : {}
-		})), {
+		}));
+		return withMethodRuntimeControls(method, {
 			costAttribution: "optimizer-run",
 			validateCandidate: (input) => assertSafeOptimizerCandidate(label, input, authorizeSensitiveCandidate)
 		});
@@ -1330,8 +1325,7 @@ function isMissingDependency(optimizer, cause) {
 	];
 	return [...common, ...specific].some((fragment) => message.includes(fragment));
 }
-//#endregion
-//#region src/improvement/profile-improvement-harness.ts
+// src/improvement/profile-improvement-harness.ts
 /**
 * Bind one exact profile and executor into a repeatable self-improvement
 * harness. The returned `run` method remains generic over every existing
@@ -1373,8 +1367,7 @@ function createProfileImprovementHarness(options) {
 		}
 	});
 }
-//#endregion
-//#region src/improvement/reflective-generator.ts
+// src/improvement/reflective-generator.ts
 /**
 *
 * `reflectiveGenerator` — the cheap, no-sandbox `CandidateGenerator`. It drafts
@@ -1467,8 +1460,7 @@ function applyPatches(edits, cwd) {
 	if (result.error) throw result.error;
 	if (result.status !== 0) throw new Error(`reflectiveGenerator: patch batch failed: ${result.stderr.trim()}`);
 }
-//#endregion
-//#region src/improvement/reflective-profile-proposer.ts
+// src/improvement/reflective-profile-proposer.ts
 const OPERATOR = {
 	draft: "OPERATOR: draft. Write a substantially different approach from the parent below, not an edit of it.",
 	improve: "OPERATOR: improve. Edit the parent below to fix its dominant failure mode; keep what already works.",
@@ -1644,8 +1636,7 @@ function surfaceOf(value, shape, maxChars) {
 function defaultEvidence(parent) {
 	return parent.trainCells.map((cell) => `- train unit ${cell.unitId}: score ${cell.score}`);
 }
-//#endregion
-//#region src/knowledge/activation.ts
+// src/knowledge/activation.ts
 /** Apply or restore one local knowledge candidate through the shared activation contract. */
 function createKnowledgeImprovementActivationExecutor(options) {
 	if (!options.identity.trim()) throw new Error("knowledge activation identity is required");
@@ -1820,8 +1811,7 @@ function completionTime(transition, now) {
 	const completedAt = (now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
 	return Date.parse(completedAt) < Date.parse(transition.attemptedAt) ? transition.attemptedAt : completedAt;
 }
-//#endregion
-//#region src/knowledge/supervised-update.ts
+// src/knowledge/supervised-update.ts
 /** Build the completion check a supervised KB update uses to stop only when the KB is ready. */
 function knowledgeReadinessDeliverable(options) {
 	return {
@@ -1886,8 +1876,7 @@ function formatSupervisedKnowledgeTask(options) {
 		options.metadata && Object.keys(options.metadata).length > 0 ? `Metadata:\n${JSON.stringify(options.metadata, null, 2)}` : void 0
 	].filter((section) => Boolean(section)).join("\n\n")}\n\nUpdate files under the knowledge base root only. Stop when the readiness check passes.`;
 }
-//#endregion
-//#region src/knowledge/improvement-job.ts
+// src/knowledge/improvement-job.ts
 /** Build the default readiness check backed by `@tangle-network/agent-knowledge` validation and scoring. */
 function createAgentKnowledgeReadinessCheck(options) {
 	return async (input) => {
@@ -2052,8 +2041,7 @@ function addSpent(target, result) {
 	target.usd += spent.usd;
 	target.ms += spent.ms;
 }
-//#endregion
-//#region src/model-resolution.ts
+// src/model-resolution.ts
 /** Default Tangle Router base URL used when no env override is set. */
 const DEFAULT_ROUTER_BASE_URL = "https://router.tangle.tools";
 /** Resolve the router base URL from env, normalised — no trailing `/v1` or `/`. */
@@ -2147,8 +2135,7 @@ async function validateChatModelId(modelId, options = {}) {
 		value: cleaned
 	};
 }
-//#endregion
-//#region src/readiness.ts
+// src/readiness.ts
 const DEFAULT_MINIMUM_READINESS_SCORE = .7;
 /**
 * Map a `KnowledgeReadinessReport` to a three-state branch (`ready` / `blocked` / `caveat`) the runtime, route handlers, and UI shells all switch on.
@@ -2191,8 +2178,7 @@ function decideKnowledgeReadiness(report, options = {}) {
 		nonBlockingGapIds
 	};
 }
-//#endregion
-//#region src/run.ts
+// src/run.ts
 /**
 *
 * The two top-level entry points:
@@ -2670,8 +2656,7 @@ function toAgentContext(task, knowledge, ctx) {
 		abortSignal: ctx.abortSignal
 	};
 }
-//#endregion
-//#region src/runtime/isolated-check-result.ts
+// src/runtime/isolated-check-result.ts
 /** Decode the existing execution contract without widening or reinterpreting its evidence. */
 const isolatedCheckBoxEvidenceSchema = z.object({
 	sandboxId: z.string().min(1),
@@ -2711,8 +2696,7 @@ const isolatedCheckResultSchema = z.discriminatedUnion("succeeded", [z.object({
 	cleanupDiagnostic: z.string().optional(),
 	box: isolatedCheckBoxEvidenceSchema.optional()
 }).strict()]);
-//#endregion
-//#region src/runtime-run.ts
+// src/runtime-run.ts
 /**
 *
 * Production-run lifecycle: record what the agent did on behalf of a customer,
@@ -2838,8 +2822,7 @@ function mergeMetadata(base, extra) {
 function randomSuffix() {
 	return Math.random().toString(36).slice(2, 10);
 }
-//#endregion
-//#region src/sse.ts
+// src/sse.ts
 /** @stable */
 function encodeServerSentEvent(data, options = {}) {
 	const lines = [];
@@ -2874,7 +2857,6 @@ function runtimeStreamServerSentEvent(event, options = {}) {
 function stripNewlines(value) {
 	return value.replace(/[\r\n]/g, " ");
 }
-//#endregion
 export { AgentEvalError, BackendTransportError, ConfigError, DEFAULT_ROUTER_BASE_URL, InMemoryRuntimeSessionStore, JudgeError, NotFoundError, ROUTER_PRICE_SOURCE, SearchEnvironmentFault, ValidationError, agenticGenerator, auditLoopRunner, buildKnowledgeImprovementExperimentBundles, buildLoopOtelSpans, cleanModelId, commandVerifier, composeRuntimeHooks, createCommandProfileTrainer, createConversationBackend, createIterableBackend, createKnowledgeImprovementActivationExecutor, createOtelExporter, createProfileExecutionBackend, createProfileImprovementHarness, createRuntimeEventCollector, createRuntimeStreamEventCollector, createSandboxPromptBackend, decideKnowledgeReadiness, decideSearchImprovement, dedicatedLane, defineRuntimeHooks, getModels, improve, isolatedCheckBoxEvidenceSchema, isolatedCheckResultSchema, loopEventToOtelSpan, officialGepa, officialSkillOpt, optimizerMethod, padSpanId, padTraceId, priceTokens, readinessServerSentEvent, reflectiveGenerator, reflectiveProfileProposer, resolveChatModel, resolveRouterBaseUrl, routerLane, runAgentTask, runAgentTaskStream, runConversation, runConversationStream, runKnowledgeImprovementJob, runPersonaConversation, runPersonaDispatch, runtimeStreamServerSentEvent, sanitizeKnowledgeReadinessReport, searchMethod, sharedBoxLane, startRuntimeRun, subscriptionLane, validateChatModelId };
 
 //# sourceMappingURL=index.js.map