@tangle-network/agent-runtime 0.199.0 → 0.201.0

package/dist/index.js

@@ -1,16 +1,16 @@
-import { $n as createRuntimeEventCollector, $r as executableAgentProfileSnapshot, Bn as INTELLIGENCE_WIRE_VERSION, Gn as createOtelExporter, Hn as buildLoopSpanNodes, Jn as generateSpanId, Kn as exportEvalRuns, Mr as parseCommittedJsonLines, Nr as prepareJsonlAppend, Pr as writeAllBytes, Qn as toOtelAttributes, Un as buildRuntimeEventOtelSpans, Vn as buildLoopOtelSpans, Wn as createOpenInferenceFileExporter, Xn as padSpanId, Yn as loopEventToOtelSpan, Zn as padTraceId, er as createRuntimeStreamEventCollector, jr as isNoEntError, li as providerMessageText, n as defaultRedactorIdentityMaterial, nr as sanitizeKnowledgeReadinessReport, r as resolveRedactor, rr as sanitizeRuntimeStreamEvent, t as defaultRedactor, tr as sanitizeAgentRuntimeEvent } from "./redact-Dv8WcCKy.js";
+import { $n as buildRuntimeEventOtelSpans, Hr as parseCommittedJsonLines, Mi as providerMessageText, Qn as buildLoopSpanNodes, Ur as prepareJsonlAppend, Vr as isNoEntError, Wr as writeAllBytes, Xn as INTELLIGENCE_WIRE_VERSION, Zn as buildLoopOtelSpans, ar as loopEventToOtelSpan, cr as toOtelAttributes, dr as sanitizeAgentRuntimeEvent, er as createOpenInferenceFileExporter, fr as sanitizeKnowledgeReadinessReport, ir as generateSpanId, li as executableAgentProfileSnapshot, lr as createRuntimeEventCollector, n as defaultRedactorIdentityMaterial, nr as exportEvalRuns, or as padSpanId, pr as sanitizeRuntimeStreamEvent, r as resolveRedactor, sr as padTraceId, t as defaultRedactor, tr as createOtelExporter, ur as createRuntimeStreamEventCollector } from "./redact-h-oaw11Q.js";
 import { a as JudgeError, c as RetainedInteractiveAdmissionError, d as RetainedRunDispatchBindingError, f as RuntimeRunStateError, i as ConfigError, l as RetainedInteractiveBindingError, m as ValidationError, o as NotFoundError, r as BackendTransportError, s as PlannerError, t as AgentEvalError, u as RetainedRunAdmissionError } from "./errors-DodWX-cb.js";
-import { A as streamAgentTurn, D as optimizerMethod, F as newRuntimeSession, I as nowIso, L as startOrResumeRuntimeSession, M as createSandboxPromptBackend, N as normalizeBackendStreamEvent, O as strategyAuthorMethod, P as InMemoryRuntimeSessionStore, R as touchSession, j as createIterableBackend } from "./structural-rollout-DANCelu6.js";
+import { A as streamAgentTurn, D as optimizerMethod, F as newRuntimeSession, I as nowIso, L as startOrResumeRuntimeSession, M as createSandboxPromptBackend, N as normalizeBackendStreamEvent, O as strategyAuthorMethod, P as InMemoryRuntimeSessionStore, R as touchSession, j as createIterableBackend } from "./structural-rollout-BcMmrpv4.js";
 import { t as assertExecutableAgentProfile } from "./model-policy-DKDyr-fc.js";
-import { Ft as connectStdioMcp, Pt as McpSpawnFault } from "./runtime-BN16GbTA.js";
+import { Ft as connectStdioMcp, Pt as McpSpawnFault } from "./runtime-DeqdBVeC.js";
 import { i as notifyRuntimeHookEvent, n as defineRuntimeHooks, r as notifyRuntimeDecisionPoint, t as composeRuntimeHooks } from "./runtime-hooks-tXpAarhW.js";
-import { B as ROLLOUT_POLICY_EXTENSION, G as structuralRolloutPolicyFromProfile, H as normalizeRolloutPolicy, J as defaultBuildPrompt, K as agenticGenerator, L as improve, R as withMethodRuntimeControls, U as parseRolloutPolicy, V as applyRolloutPolicyToProfile, W as serializeRolloutPolicy, q as commandVerifier, z as rawTraceDistiller } from "./improvement-cycle-CxZKIbLD.js";
+import { B as ROLLOUT_POLICY_EXTENSION, G as structuralRolloutPolicyFromProfile, H as normalizeRolloutPolicy, J as defaultBuildPrompt, K as agenticGenerator, L as improve, R as withMethodRuntimeControls, U as parseRolloutPolicy, V as applyRolloutPolicyToProfile, W as serializeRolloutPolicy, q as commandVerifier, z as rawTraceDistiller } from "./improvement-cycle-VH_ZGcIj.js";
 import { a as canonicalCandidateBytes, d as omitTopLevelDigest, l as embeddedCandidateArtifact, o as canonicalCandidateDigest$1, u as immutableCandidateValue } from "./protected-redaction-wGo44k2K.js";
-import { d as persistCandidateOutputArtifact } from "./prepare-CAO1yXov.js";
-import { t as createAgentImprovementActivationResult } from "./activation-zQWmiiPg.js";
-import { i as sealAgentCandidateBundle, t as captureAgentCandidateWorkspace } from "./workspace-archive-BMOnloFf.js";
-import { n as supervise } from "./supervise-BGNXB8No.js";
-import { a as isDelegatedLoopMode, c as worktreeLoopRunner, i as auditLoopRunner, n as runLoopRunnerCli, o as researchLoopRunner, r as DELEGATED_LOOP_MODES, s as runDelegatedLoop, t as parseLoopRunnerArgv } from "./loop-runner-bin-SNrh585k.js";
+import { d as persistCandidateOutputArtifact } from "./prepare-Dc30WRB0.js";
+import { t as createAgentImprovementActivationResult } from "./activation-C_FN2aqK.js";
+import { i as sealAgentCandidateBundle, t as captureAgentCandidateWorkspace } from "./workspace-archive-CBX0hwL_.js";
+import { n as supervise } from "./supervise-DmFO50N6.js";
+import { a as isDelegatedLoopMode, c as worktreeLoopRunner, i as auditLoopRunner, n as runLoopRunnerCli, o as researchLoopRunner, r as DELEGATED_LOOP_MODES, s as runDelegatedLoop, t as parseLoopRunnerArgv } from "./loop-runner-bin-jQ8hXO9J.js";
 import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "./openai-tools-DoQ32vpe.js";
 import { agentCandidateKnowledgeSchema, agentProfileSchema, canonicalAgentProfileDigest, sha256DigestSchema } from "@tangle-network/agent-interface";
 import { FAILURE_CLASSES, acquisitionPlansForKnowledgeGaps, blockingKnowledgeEval, canonicalJson, runAgentControlLoop, scoreKnowledgeReadiness, userQuestionsForKnowledgeGaps } from "@tangle-network/agent-eval";
@@ -21,7 +21,7 @@ import { isAbsolute, relative, resolve, sep } from "node:path";
 import { realpath } from "node:fs/promises";
 import { isDeepStrictEqual } from "node:util";
 import { gepaOptimizationMethod, skillOptOptimizationMethod } from "@tangle-network/agent-eval/campaign";
-import { evaluateKnowledgeBaseReadiness, fromAgentCandidateKnowledgeRef, improveKnowledgeBase, knowledgeImprovementCandidateRef, loadKnowledgeImprovementActivationResult, promoteKnowledgeCandidate, restoreKnowledgeCandidateBaseline, toAgentCandidateKnowledgeRef, withKnowledgeImprovementComparison } from "@tangle-network/agent-knowledge";
+import { evaluateKnowledgeBaseReadiness, fromAgentCandidateKnowledgeRef, improveKnowledgeBase, knowledgeImprovementCandidateRef, loadKnowledgeImprovementActivationResult, normalizeKnowledgeStateScope, promoteKnowledgeCandidate, restoreKnowledgeCandidateBaseline, toAgentCandidateKnowledgeRef, withKnowledgeImprovementComparison } from "@tangle-network/agent-knowledge";
 //#region src/runtime/profile-execution-backend.ts
 /**
 * Bind one exact profile and Runtime executor to the stable `AgentExecutionBackend` contract used
@@ -1522,46 +1522,20 @@ var OfficialOptimizerUnavailableError = class extends ConfigError {
 * `adaptive-sequential`, `best-of`, `vote`, or `omni` explicitly.
 */
 function officialGepa(options) {
-	const { background, includeFindings = true, maxFindingsChars, describeScenario, describeArtifact, redact, authorizeSensitiveCandidate, ...config } = options;
-	const redactor = resolveRedactor(redact);
-	const redactionPolicyRef = optimizerRedactionPolicyRef(redact);
-	assertMaxFindingsChars("officialGepa", maxFindingsChars);
-	const objective = redactOptimizerText("officialGepa", "objective", config.objective, redactor);
-	return (context) => {
-		const externalEvaluationRef = optimizerEvidencePolicyRef({
-			runtimeEvaluationRef: context.evaluationRef,
-			redactionPolicyRef,
-			describeScenario,
-			describeArtifact,
-			authorizeSensitiveCandidate
-		});
-		return withMethodRuntimeControls(withDependencyHelp("gepa", externalEvaluationRef, redactor, redactionPolicyRef, gepaOptimizationMethod({
-			...config,
-			objective,
-			evaluationId: externalEvaluationRef,
-			background: methodBackground({
-				context,
-				background,
-				includeFindings,
-				maxFindingsChars,
-				label: "officialGepa",
-				redactor
-			}),
-			...describeScenario ? { describeScenario: (scenario) => redactOptimizerEvidence("officialGepa", "scenario descriptor", describeScenario(scenario), redactor) } : {},
-			...describeArtifact ? { describeArtifact: (artifact, scenario) => redactOptimizerEvidence("officialGepa", "artifact descriptor", describeArtifact(artifact, scenario), redactor) } : {}
-		})), {
-			costAttribution: "optimizer-run",
-			validateCandidate: (input) => assertSafeOptimizerCandidate("officialGepa", input, authorizeSensitiveCandidate)
-		});
-	};
+	return officialOptimizer("gepa", options, (config) => gepaOptimizationMethod(config));
 }
 /** Build a complete method backed by Microsoft's official SkillOpt trainer. */
 function officialSkillOpt(options) {
+	return officialOptimizer("skillopt", options, (config) => skillOptOptimizationMethod(config));
+}
+/** Keep evidence redaction, identity, dependency errors, and candidate controls identical for both wrappers. */
+function officialOptimizer(optimizer, options, create) {
+	const label = optimizer === "gepa" ? "officialGepa" : "officialSkillOpt";
 	const { background, includeFindings = true, maxFindingsChars, describeScenario, describeArtifact, redact, authorizeSensitiveCandidate, ...config } = options;
 	const redactor = resolveRedactor(redact);
 	const redactionPolicyRef = optimizerRedactionPolicyRef(redact);
-	assertMaxFindingsChars("officialSkillOpt", maxFindingsChars);
-	const objective = redactOptimizerText("officialSkillOpt", "objective", config.objective, redactor);
+	assertMaxFindingsChars(label, maxFindingsChars);
+	const objective = redactOptimizerText(label, "objective", config.objective, redactor);
 	return (context) => {
 		const externalEvaluationRef = optimizerEvidencePolicyRef({
 			runtimeEvaluationRef: context.evaluationRef,
@@ -1570,7 +1544,7 @@ function officialSkillOpt(options) {
 			describeArtifact,
 			authorizeSensitiveCandidate
 		});
-		return withMethodRuntimeControls(withDependencyHelp("skillopt", externalEvaluationRef, redactor, redactionPolicyRef, skillOptOptimizationMethod({
+		return withMethodRuntimeControls(withDependencyHelp(optimizer, externalEvaluationRef, redactor, redactionPolicyRef, create({
 			...config,
 			objective,
 			evaluationId: externalEvaluationRef,
@@ -1579,14 +1553,14 @@ function officialSkillOpt(options) {
 				background,
 				includeFindings,
 				maxFindingsChars,
-				label: "officialSkillOpt",
+				label,
 				redactor
 			}),
-			...describeScenario ? { describeScenario: (scenario) => redactOptimizerEvidence("officialSkillOpt", "scenario descriptor", describeScenario(scenario), redactor) } : {},
-			...describeArtifact ? { describeArtifact: (artifact, scenario) => redactOptimizerEvidence("officialSkillOpt", "artifact descriptor", describeArtifact(artifact, scenario), redactor) } : {}
+			...describeScenario ? { describeScenario: (scenario) => redactOptimizerEvidence(label, "scenario descriptor", describeScenario(scenario), redactor) } : {},
+			...describeArtifact ? { describeArtifact: (artifact, scenario) => redactOptimizerEvidence(label, "artifact descriptor", describeArtifact(artifact, scenario), redactor) } : {}
 		})), {
 			costAttribution: "optimizer-run",
-			validateCandidate: (input) => assertSafeOptimizerCandidate("officialSkillOpt", input, authorizeSensitiveCandidate)
+			validateCandidate: (input) => assertSafeOptimizerCandidate(label, input, authorizeSensitiveCandidate)
 		});
 	};
 }
@@ -2276,6 +2250,7 @@ function buildKnowledgeImprovementExperimentBundles(bundle, knowledge) {
 	const input = omitTopLevelDigest(bundle);
 	const withSnapshot = (snapshot) => agentCandidateKnowledgeSchema.parse({
 		candidate: knowledge.reference,
+		...knowledge.stateScope ? { stateScope: knowledge.stateScope } : {},
 		snapshot,
 		evaluation: knowledge.evaluation
 	});
@@ -2310,10 +2285,14 @@ async function freezeKnowledgeCandidatePair(root, improvement, artifacts, signal
 			candidate: candidateRef,
 			metric: comparison.evaluation
 		}), "knowledge-evaluation", `knowledge-${candidate.candidateId}`, artifacts, signal);
+		const normalizedScope = normalizeKnowledgeStateScope(comparison.stateScope);
+		const defaultScope = normalizeKnowledgeStateScope();
+		const stateScope = normalizedScope.pagesDirectory === defaultScope.pagesDirectory && normalizedScope.researchState === defaultScope.researchState ? void 0 : Object.freeze(normalizedScope);
 		const baseline = await freeze("baseline");
 		const proposed = await freeze("candidate");
 		return Object.freeze({
 			reference: candidateRef,
+			...stateScope ? { stateScope } : {},
 			evaluation,
 			baseline,
 			candidate: proposed