@tangle-network/agent-runtime 0.138.1 → 0.139.0

package/dist/intelligence.js

@@ -1,12 +1,14 @@
-import { $ as parseExactAgentProfile, K as applyExactAgentProfileDiff, Q as parseAgentCandidateProfileActivation, Z as omitUndefinedObjectFields, rt as canonicalCandidateDigest$1, st as immutableCandidateValue, u as AGENT_CANDIDATE_EXECUTION_SUPPORT } from "./prepare-CYqGSYza.js";
-import { n as exactProcessProviderAsCandidateExecutor, t as createProtectedAgentCandidateModelPort } from "./protected-model-port-B6DW_x2I.js";
-import { Dt as buildRuntimeEventOtelSpans, Tt as buildLoopOtelSpans, jt as flatOtelSpan, kt as createOtelExporter } from "./supervisor-BoC2tFgH.js";
-import { i as resolveAgentEnvironmentProvider } from "./environment-provider-CLNVqp6H.js";
-import { D as buildAgentImprovementActivationTargets, E as assertProfileImprovementTargetsShareIdentity, O as isAgentImprovementProfileSurface, _ as AGENT_IMPROVEMENT_PROFILE_SURFACES, a as executeAgentCandidateExperimentCell, b as agentImprovementProfileSurfaceDigest, d as verifyAgentImprovementActivation, f as verifyAgentImprovementProposal, g as optimizationActivationReceiptFromMetadata, h as createOptimizationActivationReceipt, i as createAgentImprovementProposal, k as isAgentProfileMeasuredSurface, l as reviewAgentImprovementProposal, m as verifyCandidateExecutionEvidence, n as createAgentImprovementActivation, o as proposeAgentImprovement, p as verifyAgentImprovementReview, r as createAgentImprovementMeasuredComparison, s as proposeAgentProfileImprovement, t as AgentCandidateExperimentCellExecutionError, u as runAgentCandidateExperiment, v as AGENT_PROFILE_MEASURED_SURFACES, w as agentImprovementTargetProfileDiffs, x as agentImprovementProfileSurfaceInput, y as agentImprovementProfileDiffs } from "./improvement-cycle-hIOGxDtV.js";
+import { $ as parseExactAgentProfile, K as applyExactAgentProfileDiff, Q as parseAgentCandidateProfileActivation, Z as omitUndefinedObjectFields, rt as canonicalCandidateDigest$1, st as immutableCandidateValue, u as AGENT_CANDIDATE_EXECUTION_SUPPORT } from "./prepare-DK1qnk7-.js";
+import { n as exactProcessProviderAsCandidateExecutor, t as createProtectedAgentCandidateModelPort } from "./protected-model-port-DHeCm_UF.js";
+import { Dt as buildRuntimeEventOtelSpans, Tt as buildLoopOtelSpans, jt as flatOtelSpan, kt as createOtelExporter } from "./supervisor-BV72aDmP.js";
+import { i as resolveAgentEnvironmentProvider } from "./environment-provider-BAO8wt1_.js";
+import { C as optimizationActivationReceiptFromMetadata, D as agentImprovementProfileSurfaceDigest, E as agentImprovementProfileDiffs, F as isAgentImprovementProfileSurface, I as isAgentProfileMeasuredSurface, N as assertProfileImprovementTargetsShareIdentity, O as agentImprovementProfileSurfaceInput, P as buildAgentImprovementActivationTargets, S as createOptimizationActivationReceipt, T as AGENT_PROFILE_MEASURED_SURFACES, _ as profilePolicyWithBudget, a as executeAgentCandidateExperimentCell, b as profileTaskScenarioIdentity, d as verifyAgentImprovementActivation, f as verifyAgentImprovementProposal, g as profileImprovementMetadata, h as createProfileImprovementCostLedger, i as createAgentImprovementProposal, j as agentImprovementTargetProfileDiffs, l as reviewAgentImprovementProposal, m as verifyCandidateExecutionEvidence, n as createAgentImprovementActivation, o as proposeAgentImprovement, p as verifyAgentImprovementReview, r as createAgentImprovementMeasuredComparison, s as proposeAgentProfileImprovement, t as AgentCandidateExperimentCellExecutionError, u as runAgentCandidateExperiment, v as profilePreparationAccounting, w as AGENT_IMPROVEMENT_PROFILE_SURFACES, x as sealProfileImprovementBenchmark, y as profileStateDigest$1 } from "./improvement-cycle-D6rhMJR0.js";
 import { r as resolveRedactor, t as defaultRedactor } from "./redact-D-u-rrcn.js";
-import { n as executeAgentImprovementActivation, r as verifyAgentImprovementActivationResult, t as createAgentImprovementActivationResult } from "./activation-AyIFaunX.js";
+import { n as executeAgentImprovementActivation, r as verifyAgentImprovementActivationResult, t as createAgentImprovementActivationResult } from "./activation-eLJ6uRlP.js";
+import { agentImprovementSourceSchema, agentProfileImprovementArmSchema, applyAgentProfileDiff, defineAgentProfilePublicConfig } from "@tangle-network/agent-interface";
 import { contentHash } from "@tangle-network/agent-eval";
-import { agentProfileImprovementArmSchema, applyAgentProfileDiff, defineAgentProfilePublicConfig } from "@tangle-network/agent-interface";
+import { assertProposalFindings } from "@tangle-network/agent-eval/analyst";
+import { measuredComparisonFromAgentProfileImprovementExperiment, runAgentProfileImprovementExperiment, sealAgentProfileImprovementExperiment, verifyAgentProfileImprovementExperimentComparison } from "@tangle-network/agent-eval/contract";
 //#region src/intelligence/delivery.ts
 const defaultPlaneBaseUrl = "https://intelligence.tangle.tools";
 const defaultRefreshMs = 3e5;
@@ -369,6 +371,109 @@ function compileEffort(settings) {
 	};
 }
 //#endregion
+//#region src/intelligence/authored-profile-improvement.ts
+/**
+* Put a complete authored/imported profile through the canonical profile
+* experiment and proposal path without invoking `improve()`.
+*/
+async function proposeAuthoredAgentProfileImprovement(options) {
+	const source = agentImprovementSourceSchema.parse(options.source);
+	const metadata = profileImprovementMetadata(options.metadata, source);
+	const inputLineage = options.candidateLineage;
+	if (inputLineage.source === "optimizer") throw new Error("authored profile improvement refuses optimizer lineage; use improve()");
+	if (Object.hasOwn(inputLineage, "profileDiffIds")) throw new Error("authored profile improvement derives candidateLineage.profileDiffIds");
+	const findings = immutableCandidateValue([...assertProposalFindings(options.findings ?? [], "authored profile improvement findings")]);
+	const costLedger = createProfileImprovementCostLedger(options.budgetUsd, "authored profile improvement");
+	const preparationStartedAt = performance.now();
+	const baselineProfile = parseExactAgentProfile(options.profile, "authored profile baseline");
+	const candidateProfile = parseExactAgentProfile(options.candidateProfile, "authored profile candidate");
+	const baselineStateDigest = profileStateDigest$1(options.stateDigest, source.sourceIdentity, baselineProfile);
+	if (baselineStateDigest !== source.sourceDigest) throw new Error("authored profile source digest does not match the measured profile state");
+	const candidateStateDigest = profileStateDigest$1(options.stateDigest, source.sourceIdentity, candidateProfile);
+	if (candidateStateDigest === baselineStateDigest) throw new Error("authored profile candidate state digest matches the baseline");
+	const change = agentImprovementProfileDiffs(baselineProfile, candidateProfile, {
+		...options.diff,
+		id: options.diff?.id ?? `profile-improvement:${candidateStateDigest}`,
+		metadata: {
+			...options.diff?.metadata,
+			sourceIdentity: source.sourceIdentity,
+			sourceRevision: source.sourceRevision
+		}
+	});
+	const profileDiffIds = change.map((step) => {
+		if (!step.id) throw new Error("authored profile change requires an exact diff id");
+		return step.id;
+	});
+	const candidateLineage = immutableCandidateValue({
+		...inputLineage,
+		profileDiffIds
+	});
+	const policy = profilePolicyWithBudget(options.benchmark.policy, options.budgetUsd, "authored profile");
+	const benchmark = sealProfileImprovementBenchmark({
+		...options.benchmark,
+		policy
+	});
+	assertDirectCandidateReleaseWorkIsFresh(benchmark, candidateLineage, options.developmentScenarios);
+	const experiment = sealAgentProfileImprovementExperiment({
+		kind: "agent-profile-improvement-experiment",
+		digestAlgorithm: "rfc8785-sha256",
+		source,
+		executionRef: options.executor.executionRef,
+		baseline: { stateDigest: baselineStateDigest },
+		candidate: { stateDigest: candidateStateDigest },
+		change,
+		candidateLineage,
+		benchmark,
+		policy
+	});
+	const profilesByStateDigest = /* @__PURE__ */ new Map([[baselineStateDigest, baselineProfile], [candidateStateDigest, candidateProfile]]);
+	const preparation = profilePreparationAccounting(costLedger, preparationStartedAt);
+	const run = await runAgentProfileImprovementExperiment({
+		experiment,
+		...options.maxConcurrency === void 0 ? {} : { maxConcurrency: options.maxConcurrency },
+		costLedger,
+		...options.signal ? { signal: options.signal } : {},
+		execute: async (input) => {
+			const measuredProfile = profilesByStateDigest.get(input.stateDigest);
+			if (!measuredProfile) throw new Error("authored profile execution requested an unknown profile state");
+			return options.executor.measure({
+				...input,
+				profile: measuredProfile
+			});
+		}
+	});
+	const evaluation = verifyAgentProfileImprovementExperimentComparison(measuredComparisonFromAgentProfileImprovementExperiment({
+		experiment,
+		measurements: run.measurements,
+		runId: options.runId,
+		...options.candidate ? { candidate: options.candidate } : {},
+		generationsExplored: 0,
+		preparation,
+		measurement: run.measurement,
+		metadata
+	}));
+	const proposal = createAgentImprovementProposal({
+		runId: options.runId,
+		findings,
+		evaluation,
+		...options.now ? { now: options.now } : {}
+	});
+	return {
+		candidateProfile,
+		candidateLineage,
+		experiment,
+		measurements: run.measurements,
+		proposal
+	};
+}
+function assertDirectCandidateReleaseWorkIsFresh(benchmark, lineage, developmentScenarios) {
+	if (lineage.developmentSplitDigest === benchmark.suite.splitDigest) throw new Error("authored profile development and held-out splits must be disjoint");
+	if (!developmentScenarios || developmentScenarios.length === 0) return;
+	const development = new Set(developmentScenarios.map(canonicalCandidateDigest$1));
+	const reused = benchmark.tasks.map(profileTaskScenarioIdentity).filter((scenario) => development.has(canonicalCandidateDigest$1(scenario))).map((scenario) => scenario.id);
+	if (reused.length > 0) throw new Error(`authored profile release reuses development scenario(s): [${reused.join(", ")}]`);
+}
+//#endregion
 //#region src/intelligence/capability.ts
 /**
 * A binding kind whose resolver case is typed but not yet admitted (rag-index,
@@ -1611,6 +1716,6 @@ function createIntelligenceClient(config) {
 	};
 }
 //#endregion
-export { AGENT_IMPROVEMENT_PROFILE_SURFACES, AGENT_PROFILE_MEASURED_SURFACES, AgentCandidateExperimentCellExecutionError, CapabilityNotAdmittedError, agentImprovementProfileDiffs, agentImprovementProfileSurfaceDigest, agentImprovementProfileSurfaceInput, agentImprovementTargetProfileDiffs, buildAgentImprovementActivationTargets, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createAgentImprovementActivation, createAgentImprovementActivationResult, createAgentImprovementMeasuredComparison, createAgentImprovementProposal, createCertifiedPromptSource, createExactProcessCandidateExperimentExecutor, createIntelligenceClient, createOptimizationActivationReceipt, createProtectedExactProcessCandidateExperimentExecutor, defaultEffortTier, defaultRedactor, exactProcessCandidateExperimentExecutionSupport, executeAgentCandidateExperimentCell, executeAgentImprovementActivation, isAgentImprovementProfileSurface, isAgentProfileMeasuredSurface, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, optimizationActivationReceiptFromMetadata, parseAgentCandidateProfileActivation as parseCandidateProfileMaterialization, prepareAgentImprovementProfileActivation, proposeAgentImprovement, proposeAgentProfileImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, runAgentCandidateExperiment, submitAgentImprovementProposal, verifyAgentImprovementActivation, verifyAgentImprovementActivationResult, verifyAgentImprovementProposal, verifyAgentImprovementReview, verifyCandidateExecutionEvidence, withIntelligence };
+export { AGENT_IMPROVEMENT_PROFILE_SURFACES, AGENT_PROFILE_MEASURED_SURFACES, AgentCandidateExperimentCellExecutionError, CapabilityNotAdmittedError, agentImprovementProfileDiffs, agentImprovementProfileSurfaceDigest, agentImprovementProfileSurfaceInput, agentImprovementTargetProfileDiffs, buildAgentImprovementActivationTargets, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createAgentImprovementActivation, createAgentImprovementActivationResult, createAgentImprovementMeasuredComparison, createAgentImprovementProposal, createCertifiedPromptSource, createExactProcessCandidateExperimentExecutor, createIntelligenceClient, createOptimizationActivationReceipt, createProtectedExactProcessCandidateExperimentExecutor, defaultEffortTier, defaultRedactor, exactProcessCandidateExperimentExecutionSupport, executeAgentCandidateExperimentCell, executeAgentImprovementActivation, isAgentImprovementProfileSurface, isAgentProfileMeasuredSurface, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, optimizationActivationReceiptFromMetadata, parseAgentCandidateProfileActivation as parseCandidateProfileMaterialization, prepareAgentImprovementProfileActivation, proposeAgentImprovement, proposeAgentProfileImprovement, proposeAuthoredAgentProfileImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, runAgentCandidateExperiment, submitAgentImprovementProposal, verifyAgentImprovementActivation, verifyAgentImprovementActivationResult, verifyAgentImprovementProposal, verifyAgentImprovementReview, verifyCandidateExecutionEvidence, withIntelligence };
 
 //# sourceMappingURL=intelligence.js.map