@tangle-network/agent-runtime 0.173.0 → 0.174.0

package/dist/index.d.ts

@@ -9,7 +9,7 @@ import { A as BuildAgentCandidateBundleInput, C as DisposePreparedAgentCandidate
 import { A as AgentCandidateExecutionPhase, B as AgentCandidatePreparationEvidence, C as AgentCandidateExecutionClaim, D as AgentCandidateExecutionFailureClass, E as AgentCandidateExecutionCleanupHandles, F as AgentCandidateExecutionTerminalResult, I as AgentCandidateRetryRejection, L as InMemoryAgentCandidateExecutionClaimStore, M as AgentCandidateExecutionRecoveryEvidence, N as AgentCandidateExecutionStageResult, O as AgentCandidateExecutionFinishResult, P as AgentCandidateExecutionTerminalRecord, R as InMemoryAgentCandidateExecutionClaimStoreOptions, S as AgentCandidateExecutionAttemptRef, T as AgentCandidateExecutionClaimStore, _ as PrepareAgentCandidateExecutionOptions, a as AgentCandidateModelGrantSettleInput, b as executePreparedAgentCandidate, c as agentCandidateProfileAsAgentProfile, d as freezeGenericAgentCandidateProfile, f as omitUndefinedObjectFields, g as parseExactCandidateProfile, h as parseExactAgentProfileDiff, i as AgentCandidateModelGrantReserveInput, j as AgentCandidateExecutionPhaseResult, k as AgentCandidateExecutionLease, l as applyExactAgentProfileDiff, m as parseExactAgentProfile, n as AgentCandidateModelGrantClient, o as CreateProtectedAgentCandidateModelPortOptions, r as AgentCandidateModelGrantReservation, s as createProtectedAgentCandidateModelPort, t as AgentCandidateModelGrantActivateInput, u as assertCandidateProfileBinding, v as prepareAgentCandidateExecution, w as AgentCandidateExecutionClaimResult, x as AgentCandidateExecutionAttemptRecord, y as ExecutePreparedAgentCandidateOptions, z as candidateExecutionClaim } from "./protected-model-port-B8ssMyUg.js";
 import { A as AgentCandidateWorkspacePort, B as ResolvedAgentCandidateContainer, C as AgentCandidateProtectedModelSettlement, D as AgentCandidateRunFinalization, E as AgentCandidateRepositoryPort, F as PreparedAgentCandidateExecution, H as VerifiedAgentCandidateTaskOutcome, I as PreparedAgentCandidateInstruction, L as PreparedAgentCandidateKnowledge, M as CANDIDATE_TRACE_TAGS, N as CanonicalCandidateDocument, O as AgentCandidateTaskExecution, P as PersistedTaskOutcomeEvidence, R as PreparedAgentCandidateLaunch, S as AgentCandidateProtectedModelReservation, T as AgentCandidateProtectedRunCapture, V as VerifiedAgentCandidate, _ as AgentCandidateModelLimits, a as AgentCandidateExecutionPorts, b as AgentCandidateOutputPurpose, c as AgentCandidateExecutorPort, d as AgentCandidateExecutorStopRequest, f as AgentCandidateExecutorTaskOutcomeCapture, g as AgentCandidateMemoryResetResult, h as AgentCandidateMemoryPort, i as AgentCandidateContainerPort, j as CANDIDATE_TRACE_ENV, k as AgentCandidateVerificationPorts, l as AgentCandidateExecutorProfileFile, m as AgentCandidateExecutorWorkspaceInput, n as AgentCandidateBenchmarkGraderIdentity, o as AgentCandidateExecutorFinalCapture, p as AgentCandidateExecutorWorkspaceFile, r as AgentCandidateBenchmarkGraderPort, s as AgentCandidateExecutorMemoryCapture, t as AgentCandidateArtifactPort, u as AgentCandidateExecutorRequest, v as AgentCandidateModelPort, w as AgentCandidateProtectedModelSettlementCall, x as AgentCandidateProtectedModelActivation, y as AgentCandidateOutputArtifactPort, z as PreparedAgentCandidateTrace } from "./types-19ZOddS3.js";
 import { $ as sleep, A as RunConversationOptions, B as buildForwardHeaders, C as ConversationResult, D as HaltPredicate, E as HaltContext, F as InMemoryConversationJournal, G as CircuitBreakerState, H as readDepth, I as DEFAULT_MAX_DEPTH, J as RetryBackoff, K as CircuitOpenError, L as FORWARD_HEADERS, M as ConversationJournal, N as ConversationJournalEntry, O as HaltReason, P as FileConversationJournal, Q as makePerAttemptSignal, R as ForwardHeaderName, S as ConversationPolicy, T as ConversationTurn, U as BackendCallPolicy, V as isDepthExceeded, W as CircuitBreakerConfig, X as computeBackoff, Y as RetryableErrorPredicate, Z as defaultIsRetryable, _ as createConversationBackend, a as RunPersonaConfig, b as ConversationDriveState, c as runPersonaDispatch, d as D1DatabaseLike, et as createProfileExecutionBackend, f as D1StmtLike, g as defineConversation, h as d1ToSqlAdapter, i as PersonaDriver, j as TurnOrder, k as HaltSignal, l as runConversation, m as SqlConversationJournal, n as turnId, o as RunPersonaConversationOptions, p as SqlAdapter, q as DeadlineExceededError, r as PersonaConversationResult, s as runPersonaConversation, t as slugifySpeaker, u as runConversationStream, v as AuthSource, w as ConversationStreamEvent, x as ConversationParticipant, y as Conversation, z as PropagatedHeaders } from "./index-CFMB9ux3.js";
-import { $ as agenticGenerator, A as ImprovementCandidate, B as ImprovementProfilePopulationLineage, C as ImproveProfileComponents, D as ImproveScenarioPartitions, E as ImproveRuntimeCodeGeneratorOptions, F as ImprovementProfileCandidatePopulationAvailable, G as ReadonlyAgentProfile, H as ImprovementProfilePopulationObservationSource, I as ImprovementProfileCandidatePopulationUnavailable, J as AgenticGeneratorShotDisposition, K as AgenticGeneratorExecutorForWorktree, L as ImprovementProfilePopulationArtifactSource, M as ImprovementMaterializedProfilePopulationCandidate, N as ImprovementProfileCandidate, O as ImproveSkillsOptions, P as ImprovementProfileCandidatePopulation, Q as VerifyResult, R as ImprovementProfilePopulationCandidate, S as ImproveProfileAgent, T as ImproveResult, U as ImprovementRefusedProfilePopulationCandidate, V as ImprovementProfilePopulationLineageNode, W as DeepReadonly, X as AgenticGeneratorShotReceipt, Y as AgenticGeneratorShotExecution, Z as Verifier, _ as ImproveMethodOptions, a as ImproveCandidateValidationInput, b as ImproveOptimizationRunOptions, c as ImproveCodeOptions, d as ImproveCost, et as commandVerifier, f as ImproveCustomCodeGeneratorOptions, g as ImproveMethodLineage, h as ImproveMethodFactory, i as improve, j as ImprovementCodeCandidate, k as ImproveSurface, l as ImproveCodeResult, m as ImproveMethodContext, nt as CandidateGenerator, o as ImproveCandidateValidator, p as ImproveLineage, q as AgenticGeneratorOptions, s as ImproveCodeBaseOptions, t as Redactor, tt as defaultBuildPrompt, u as ImproveCodeRunOptions, v as ImproveMethodResult, w as ImproveProfileSurface, x as ImproveOptions, y as ImproveMethodSource, z as ImprovementProfilePopulationCandidateSource } from "./redact-6S20u4Ii.js";
+import { $ as agenticGenerator, A as ImprovementCandidate, B as ImprovementProfilePopulationLineage, C as ImproveProfileComponents, D as ImproveScenarioPartitions, E as ImproveRuntimeCodeGeneratorOptions, F as ImprovementProfileCandidatePopulationAvailable, G as ReadonlyAgentProfile, H as ImprovementProfilePopulationObservationSource, I as ImprovementProfileCandidatePopulationUnavailable, J as AgenticGeneratorShotDisposition, K as AgenticGeneratorExecutorForWorktree, L as ImprovementProfilePopulationArtifactSource, M as ImprovementMaterializedProfilePopulationCandidate, N as ImprovementProfileCandidate, O as ImproveSkillsOptions, P as ImprovementProfileCandidatePopulation, Q as VerifyResult, R as ImprovementProfilePopulationCandidate, S as ImproveProfileAgent, T as ImproveResult, U as ImprovementRefusedProfilePopulationCandidate, V as ImprovementProfilePopulationLineageNode, W as DeepReadonly, X as AgenticGeneratorShotReceipt, Y as AgenticGeneratorShotExecution, Z as Verifier, _ as ImproveMethodOptions, a as ImproveCandidateValidationInput, b as ImproveOptimizationRunOptions, c as ImproveCodeOptions, d as ImproveCost, et as commandVerifier, f as ImproveCustomCodeGeneratorOptions, g as ImproveMethodLineage, h as ImproveMethodFactory, i as improve, j as ImprovementCodeCandidate, k as ImproveSurface, l as ImproveCodeResult, m as ImproveMethodContext, nt as CandidateGenerator, o as ImproveCandidateValidator, p as ImproveLineage, q as AgenticGeneratorOptions, s as ImproveCodeBaseOptions, t as Redactor, tt as defaultBuildPrompt, u as ImproveCodeRunOptions, v as ImproveMethodResult, w as ImproveProfileSurface, x as ImproveOptions, y as ImproveMethodSource, z as ImprovementProfilePopulationCandidateSource } from "./redact-DvLf4x1m.js";
 import { C as KnowledgeImprovementActivationExecutor, S as CreateKnowledgeImprovementActivationExecutorOptions, _ as SupervisedKnowledgeUpdater, a as KnowledgeImprovementJobResult, b as knowledgeReadinessDeliverable, c as createAgentKnowledgeReadinessCheck, d as KnowledgeReadinessCheckInput, f as KnowledgeReadinessCheckResult, g as SupervisedKnowledgeUpdateResult, h as SupervisedKnowledgeUpdateOptions, i as KnowledgeImprovementJobMeasurement, l as runKnowledgeImprovementJob, m as SupervisedKnowledgeUpdateInput, n as KnowledgeImprovementCandidatePair, o as RunKnowledgeImprovementJobOptions, p as RESEARCH_SUPERVISOR_SYSTEM_PROMPT, r as KnowledgeImprovementExperimentBundles, s as buildKnowledgeImprovementExperimentBundles, t as AgentKnowledgeReadinessCheckOptions, u as KnowledgeReadinessCheck, v as createSupervisedKnowledgeUpdater, w as createKnowledgeImprovementActivationExecutor, x as runSupervisedKnowledgeUpdate, y as formatSupervisedKnowledgeTask } from "./index-Dk5X9eKg.js";
 import { _ as researchLoopRunner, a as DELEGATED_LOOP_MODES, c as DelegatedLoopResult, d as ResearchLoopRunnerOptions, f as RunDelegatedLoopOptions, g as isDelegatedLoopMode, h as auditLoopRunner, i as runLoopRunnerCli, l as DelegatedLoopRunner, m as WorktreeLoopRunnerOptions, n as LoopRunnerCliResult, o as DelegatedLoopMode, p as VetoedFact, r as parseLoopRunnerArgv, s as DelegatedLoopRegistry, t as LoopRunnerCliArgs, u as ResearchLoopResult, v as runDelegatedLoop, y as worktreeLoopRunner } from "./loop-runner-bin-DRYApMiu.js";
 import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "./openai-tools-wkxQ2aEw.js";

package/dist/index.js

@@ -8,10 +8,10 @@ import { C as makePerAttemptSignal, S as defaultIsRetryable, T as createProfileE
 import { Bt as exportEvalRuns, Ft as buildLoopOtelSpans, Gt as padTraceId, Ht as generateSpanId, It as buildLoopSpanNodes, Jt as createRuntimeStreamEventCollector, Kt as toOtelAttributes, Lt as buildRuntimeEventOtelSpans, Pt as INTELLIGENCE_WIRE_VERSION, Rt as createOpenInferenceFileExporter, Ut as loopEventToOtelSpan, Wt as padSpanId, Xt as sanitizeKnowledgeReadinessReport, Yt as sanitizeAgentRuntimeEvent, Zt as sanitizeRuntimeStreamEvent, qt as createRuntimeEventCollector, zt as createOtelExporter } from "./supervisor-cAFpYJWF.js";
 import { i as notifyRuntimeHookEvent, n as defineRuntimeHooks, r as notifyRuntimeDecisionPoint, t as composeRuntimeHooks } from "./runtime-hooks-tXpAarhW.js";
 import { D as optimizerMethod, O as strategyAuthorMethod } from "./structural-rollout-CIK7nvSH.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-lP-F7B60.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-BZH9dewp.js";
 import { Ht as McpSpawnFault, Ut as connectStdioMcp } from "./runtime-l9Q9-Dal.js";
 import { n as defaultRedactorIdentityMaterial, r as resolveRedactor, t as defaultRedactor } from "./redact-D-u-rrcn.js";
-import { a as createSupervisedKnowledgeUpdater, c as runSupervisedKnowledgeUpdate, i as RESEARCH_SUPERVISOR_SYSTEM_PROMPT, l as createKnowledgeImprovementActivationExecutor, n as createAgentKnowledgeReadinessCheck, o as formatSupervisedKnowledgeTask, r as runKnowledgeImprovementJob, s as knowledgeReadinessDeliverable, t as buildKnowledgeImprovementExperimentBundles } from "./knowledge-DCepYOlH.js";
+import { a as createSupervisedKnowledgeUpdater, c as runSupervisedKnowledgeUpdate, i as RESEARCH_SUPERVISOR_SYSTEM_PROMPT, l as createKnowledgeImprovementActivationExecutor, n as createAgentKnowledgeReadinessCheck, o as formatSupervisedKnowledgeTask, r as runKnowledgeImprovementJob, s as knowledgeReadinessDeliverable, t as buildKnowledgeImprovementExperimentBundles } from "./knowledge-DjWWfbfX.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-CTCi_rSV.js";
 import { n as mcpToolsForRuntimeMcpSubset, t as mcpToolsForRuntimeMcp } from "./openai-tools-B4BPplKi.js";
 import { agentProfileSchema, canonicalAgentProfileDigest } from "@tangle-network/agent-interface";

package/dist/intelligence.d.ts

@@ -5,7 +5,7 @@ import { vt as ToolSpec } from "./runtime-D5u1M6T5.js";
 import { a as AgentEnvironmentProviderRef, o as AgentEnvironmentProviderRegistry } from "./environment-provider-DWjbGH8W.js";
 import { T as AgentCandidateExecutionClaimStore, _ as PrepareAgentCandidateExecutionOptions, o as CreateProtectedAgentCandidateModelPortOptions, p as parseAgentCandidateProfileActivation, y as ExecutePreparedAgentCandidateOptions } from "./protected-model-port-B8ssMyUg.js";
 import { D as AgentCandidateRunFinalization, O as AgentCandidateTaskExecution, a as AgentCandidateExecutionPorts, c as AgentCandidateExecutorPort, r as AgentCandidateBenchmarkGraderPort, y as AgentCandidateOutputArtifactPort } from "./types-19ZOddS3.js";
-import { D as ImproveScenarioPartitions, T as ImproveResult, _ as ImproveMethodOptions, n as defaultRedactor, r as resolveRedactor, t as Redactor, v as ImproveMethodResult, x as ImproveOptions } from "./redact-6S20u4Ii.js";
+import { D as ImproveScenarioPartitions, T as ImproveResult, _ as ImproveMethodOptions, n as defaultRedactor, r as resolveRedactor, t as Redactor, v as ImproveMethodResult, x as ImproveOptions } from "./redact-DvLf4x1m.js";
 import { a as AgentImprovementActivationTransitionInput, c as CreateAgentImprovementActivationResultOptions, d as ProfileImprovementActivationTransitionInput, f as SealedCandidateActivationTransitionInput, h as verifyAgentImprovementActivationResult, i as AgentImprovementActivationTransition, l as ExecuteAgentImprovementActivationInput, m as executeAgentImprovementActivation, n as AgentImprovementActivationResultStore, o as AgentProfileImprovementActivationOperation, p as createAgentImprovementActivationResult, r as AgentImprovementActivationTargetPlan, s as AgentProfileImprovementActivationTargetPlan, t as AgentImprovementActivationReconciliation, u as ExecuteAgentImprovementActivationOptions } from "./activation-DyWB0K6E.js";
 import { AgentCandidateBenchmarkCellRef, AgentCandidateBundle, AgentCandidateEvaluationPolicy, AgentCandidateExperiment, AgentCandidateExperimentMaterial, AgentCandidateExperimentMeasurement, AgentCandidateLineage, AgentCandidateProfileActivation as CandidateProfileMaterialization, AgentImprovementActivation, AgentImprovementActivation as AgentImprovementActivation$1, AgentImprovementActivationIntent, AgentImprovementActivationIntent as AgentImprovementActivationIntent$1, AgentImprovementActivationOutcome, AgentImprovementActivationResult, AgentImprovementActivationTarget, AgentImprovementActivationTargetState, AgentImprovementActivationTargetTransition, AgentImprovementEvaluation, AgentImprovementEvaluation as AgentImprovementEvaluation$1, AgentImprovementMeasuredComparison, AgentImprovementMeasuredComparison as AgentImprovementMeasuredComparison$1, AgentImprovementProposal, AgentImprovementProposal as AgentImprovementProposal$1, AgentImprovementReview, AgentImprovementReview as AgentImprovementReview$1, AgentImprovementReviewDecision, AgentImprovementReviewDecision as AgentImprovementReviewDecision$1, AgentImprovementSource, AgentImprovementSurface, AgentProfile, AgentProfileDiff, AgentProfileImprovementChange, AgentProfileImprovementExecutionRef, AgentProfileImprovementExperiment, AgentProfileImprovementMeasuredComparison, AgentProfileImprovementMeasurement, AgentProfileImprovementRunReceipt, AgentProfileImprovementTaskMaterial, AgentProfileMcpServer, CandidateExecutionEvidence, CandidateExecutionEvidence as CandidateExecutionEvidence$1, Sha256Digest } from "@tangle-network/agent-interface";
 import { CostLedgerHandle, TraceStore } from "@tangle-network/agent-eval";

package/dist/intelligence.js

@@ -2,9 +2,9 @@ import { $ as parseAgentCandidateProfileActivation, Q as omitUndefinedObjectFiel
 import { n as exactProcessProviderAsCandidateExecutor, t as createProtectedAgentCandidateModelPort } from "./protected-model-port-T2UWrDNQ.js";
 import { Ft as buildLoopOtelSpans, Lt as buildRuntimeEventOtelSpans, Vt as flatOtelSpan, zt as createOtelExporter } from "./supervisor-cAFpYJWF.js";
 import { i as resolveAgentEnvironmentProvider } from "./environment-provider-Bn3652YU.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-lP-F7B60.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-BZH9dewp.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-DkZiIzqK.js";
+import { n as executeAgentImprovementActivation, r as verifyAgentImprovementActivationResult, t as createAgentImprovementActivationResult } from "./activation-DQo7-oIF.js";
 import { agentImprovementSourceSchema, agentProfileImprovementArmSchema, applyAgentProfileDiff, defineAgentProfilePublicConfig } from "@tangle-network/agent-interface";
 import { contentHash } from "@tangle-network/agent-eval";
 import { assertProposalFindings } from "@tangle-network/agent-eval/analyst";

package/dist/{knowledge-DCepYOlH.js → knowledge-DjWWfbfX.js}

@@ -1,7 +1,7 @@
 import { a as persistCandidateOutputArtifact, lt as omitTopLevelDigest, rt as canonicalCandidateBytes, st as embeddedCandidateArtifact } from "./prepare-BAyaNoZu.js";
 import { i as sealAgentCandidateBundle, t as captureAgentCandidateWorkspace } from "./workspace-archive-B0Hqp2eJ.js";
 import { t as assertExecutableAgentProfile } from "./model-policy-Sw4ywhtL.js";
-import { t as createAgentImprovementActivationResult } from "./activation-DkZiIzqK.js";
+import { t as createAgentImprovementActivationResult } from "./activation-DQo7-oIF.js";
 import { t as RESEARCHER_SYSTEM_PROMPT } from "./researcher-BMFFPwKb.js";
 import { n as supervise } from "./supervise-Dq_D3QbE.js";
 import { agentCandidateKnowledgeSchema, agentProfileSchema, sha256DigestSchema } from "@tangle-network/agent-interface";
@@ -435,4 +435,4 @@ function addSpent(target, result) {
 //#endregion
 export { createSupervisedKnowledgeUpdater as a, runSupervisedKnowledgeUpdate as c, RESEARCH_SUPERVISOR_SYSTEM_PROMPT as i, createKnowledgeImprovementActivationExecutor as l, createAgentKnowledgeReadinessCheck as n, formatSupervisedKnowledgeTask as o, runKnowledgeImprovementJob as r, knowledgeReadinessDeliverable as s, buildKnowledgeImprovementExperimentBundles as t };
 
-//# sourceMappingURL=knowledge-DCepYOlH.js.map
+//# sourceMappingURL=knowledge-DjWWfbfX.js.map

package/dist/{knowledge-DCepYOlH.js.map → knowledge-DjWWfbfX.js.map}

@@ -1 +1 @@
-{"version":3,"file":"knowledge-DCepYOlH.js","names":[],"sources":["../src/knowledge/activation.ts","../src/knowledge/supervised-update.ts","../src/knowledge/improvement-job.ts"],"sourcesContent":["import type {\n  AgentImprovementActivationOutcome,\n  AgentImprovementActivationResult,\n  AgentImprovementActivationTarget,\n  Sha256Digest,\n} from '@tangle-network/agent-interface'\nimport { sha256DigestSchema } from '@tangle-network/agent-interface'\nimport {\n  fromAgentCandidateKnowledgeRef,\n  type KnowledgeImprovementMutationReceipt,\n  loadKnowledgeImprovementActivationResult,\n  type PromoteKnowledgeCandidateOptions,\n  promoteKnowledgeCandidate,\n  restoreKnowledgeCandidateBaseline,\n} from '@tangle-network/agent-knowledge'\n\nimport {\n  type AgentImprovementActivationReconciliation,\n  type AgentImprovementActivationResultStore,\n  type AgentImprovementActivationTransition,\n  type AgentImprovementActivationTransitionInput,\n  createAgentImprovementActivationResult,\n} from '../intelligence/activation'\n\nexport interface CreateKnowledgeImprovementActivationExecutorOptions\n  extends Omit<PromoteKnowledgeCandidateOptions, 'root' | 'candidate'> {\n  root: string\n  identity: string\n  results: AgentImprovementActivationResultStore\n}\n\nexport interface KnowledgeImprovementActivationExecutor {\n  transition: AgentImprovementActivationTransition\n  reconcile: AgentImprovementActivationReconciliation\n}\n\n/** Apply or restore one local knowledge candidate through the shared activation contract. */\nexport function createKnowledgeImprovementActivationExecutor(\n  options: CreateKnowledgeImprovementActivationExecutorOptions,\n): KnowledgeImprovementActivationExecutor {\n  if (!options.identity.trim()) throw new Error('knowledge activation identity is required')\n  return {\n    reconcile: async (transition) => {\n      const inspected = await inspectKnowledgeActivation(options, transition)\n      return inspected.settled ? inspected.result : undefined\n    },\n    transition: async (transition) => {\n      if (transition.expired) {\n        throw new Error('knowledge write transition cannot run after authorization expires')\n      }\n      const inspected = await inspectKnowledgeActivation(options, transition)\n      if (inspected.settled) return inspected.result\n\n      const mutationOptions = {\n        root: options.root,\n        candidate: inspected.candidate,\n        activation: {\n          activation: transition.activation,\n          attemptedAt: transition.attemptedAt,\n          identity: options.identity,\n          createResult: (receipt: KnowledgeImprovementMutationReceipt) =>\n            inspected.create(\n              knowledgeMutationOutcome(receipt, inspected, transition.activation.intent),\n            ),\n        },\n        ...(options.ownerId ? { ownerId: options.ownerId } : {}),\n        ...(options.leaseTtlMs === undefined ? {} : { leaseTtlMs: options.leaseTtlMs }),\n        ...(options.now ? { now: options.now } : {}),\n        ...(options.onState ? { onState: options.onState } : {}),\n      }\n      const improvement =\n        transition.activation.intent === 'activate-candidate'\n          ? await promoteKnowledgeCandidate(mutationOptions)\n          : await restoreKnowledgeCandidateBaseline(mutationOptions)\n      if (!improvement.activationResult) {\n        throw new Error('knowledge mutation did not persist its shared activation result')\n      }\n      return options.results.putIfAbsent(improvement.activationResult)\n    },\n  }\n}\n\ntype CreateKnowledgeActivation = (\n  outcome: AgentImprovementActivationOutcome,\n) => AgentImprovementActivationResult\n\ntype InspectedKnowledgeActivation =\n  | { settled: true; result: unknown | undefined }\n  | {\n      settled: false\n      target: AgentImprovementActivationTransitionInput['targets'][number]\n      candidate: PromoteKnowledgeCandidateOptions['candidate']\n      expectedDigest: Sha256Digest\n      desiredDigest: Sha256Digest\n      create: CreateKnowledgeActivation\n    }\n\nasync function inspectKnowledgeActivation(\n  options: CreateKnowledgeImprovementActivationExecutorOptions,\n  transition: AgentImprovementActivationTransitionInput,\n): Promise<InspectedKnowledgeActivation> {\n  const stored = await options.results.load(transition.activation.digest)\n  if (stored !== undefined) return { settled: true, result: stored }\n\n  const create: CreateKnowledgeActivation = (outcome) =>\n    createAgentImprovementActivationResult(transition, {\n      completedAt: completionTime(transition, options.now),\n      outcome,\n    })\n  const store = (outcome: AgentImprovementActivationOutcome) =>\n    options.results.putIfAbsent(create(outcome))\n  if (transition.kind !== 'sealed-candidate') {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'unsupported',\n        code: 'KNOWLEDGE_PROFILE_TRANSITION_UNSUPPORTED',\n        message: 'The knowledge adapter accepts only sealed knowledge candidates.',\n      }),\n    }\n  }\n  const target = supportedKnowledgeTarget(transition, options.identity)\n  if (!target) {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'unsupported',\n        code: 'KNOWLEDGE_TARGET_SET_UNSUPPORTED',\n        message: 'The knowledge adapter requires exactly one matching knowledge target.',\n      }),\n    }\n  }\n  const knowledge = transition.candidateBundle.knowledge\n  if (!knowledge) {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'unsupported',\n        code: 'KNOWLEDGE_CANDIDATE_MISSING',\n        message: 'The measured candidate bundle does not contain a knowledge candidate.',\n      }),\n    }\n  }\n  const candidate = fromAgentCandidateKnowledgeRef(knowledge.candidate)\n  const expectedDigest =\n    transition.activation.intent === 'activate-candidate'\n      ? knowledge.candidate.baseHash\n      : knowledge.candidate.candidateHash\n  const desiredDigest =\n    transition.activation.intent === 'activate-candidate'\n      ? knowledge.candidate.candidateHash\n      : knowledge.candidate.baseHash\n  if (target.expectedBaseDigest !== expectedDigest || target.desiredDigest !== desiredDigest) {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'failed',\n        code: 'KNOWLEDGE_TARGET_MISMATCH',\n        message: 'The activation target does not match the measured knowledge candidate.',\n      }),\n    }\n  }\n\n  const durable = await loadKnowledgeImprovementActivationResult({\n    root: options.root,\n    candidate,\n    activation: transition.activation,\n    identity: options.identity,\n  })\n  if (durable) {\n    return {\n      settled: true,\n      result: await options.results.putIfAbsent(durable),\n    }\n  }\n  if (transition.expired) return { settled: true, result: undefined }\n  return { settled: false, target, candidate, expectedDigest, desiredDigest, create }\n}\n\nfunction supportedKnowledgeTarget(\n  transition: AgentImprovementActivationTransitionInput,\n  identity: string,\n): AgentImprovementActivationTransitionInput['targets'][number] | undefined {\n  if (transition.targets.length !== 1) return undefined\n  const target = transition.targets[0]\n  return target.surface === 'knowledge' && target.identity === identity ? target : undefined\n}\n\nfunction knowledgeMutationOutcome(\n  receipt: KnowledgeImprovementMutationReceipt,\n  inspected: Extract<InspectedKnowledgeActivation, { settled: false }>,\n  intent: AgentImprovementActivationTransitionInput['activation']['intent'],\n): AgentImprovementActivationOutcome {\n  const expectedTarget = intent === 'activate-candidate' ? 'candidate' : 'baseline'\n  const beforeDigest = prefixedDigest(receipt.beforeHash)\n  const afterDigest = prefixedDigest(receipt.afterHash)\n  if (\n    receipt.target !== expectedTarget ||\n    receipt.changed !== (beforeDigest !== afterDigest) ||\n    (!receipt.changed && (receipt.transactionId !== null || receipt.recovered))\n  ) {\n    throw new Error('knowledge mutation returned inconsistent state evidence')\n  }\n  if (receipt.changed) {\n    if (\n      receipt.transactionId === null ||\n      beforeDigest !== inspected.expectedDigest ||\n      afterDigest !== inspected.desiredDigest\n    ) {\n      throw new Error('knowledge activation did not apply its authorized content transition')\n    }\n    return {\n      status: 'applied',\n      transactionId: receipt.transactionId,\n      targets: [\n        {\n          surface: inspected.target.surface,\n          identity: inspected.target.identity,\n          beforeDigest,\n          afterDigest,\n        },\n      ],\n    }\n  }\n  if (afterDigest === inspected.desiredDigest) {\n    return {\n      status: 'already-applied',\n      targets: [targetState(inspected.target, afterDigest)],\n    }\n  }\n  if (afterDigest === inspected.expectedDigest) {\n    throw new Error('knowledge activation did not attempt its authorized content transition')\n  }\n  return {\n    status: 'conflict',\n    targets: [targetState(inspected.target, afterDigest)],\n  }\n}\n\nfunction targetState(target: AgentImprovementActivationTarget, currentDigest: Sha256Digest) {\n  return {\n    surface: target.surface,\n    identity: target.identity,\n    currentDigest,\n  }\n}\n\nfunction prefixedDigest(hash: string): Sha256Digest {\n  return sha256DigestSchema.parse(`sha256:${hash}`)\n}\n\nfunction completionTime(\n  transition: AgentImprovementActivationTransitionInput,\n  now: (() => Date) | undefined,\n): string {\n  const completedAt = (now ?? (() => new Date()))().toISOString()\n  return Date.parse(completedAt) < Date.parse(transition.attemptedAt)\n    ? transition.attemptedAt\n    : completedAt\n}\n","import { agentProfileSchema } from '@tangle-network/agent-interface'\nimport type { RagKnowledgeUpdateResult } from '@tangle-network/agent-knowledge'\nimport { RESEARCHER_SYSTEM_PROMPT } from '../profiles/researcher'\nimport type { DeliverableSpec } from '../runtime/supervise/completion-gate'\nimport { assertExecutableAgentProfile } from '../runtime/supervise/model-policy'\nimport type { ExecutorConfig } from '../runtime/supervise/runtime'\nimport { type SuperviseOptions, supervise } from '../runtime/supervise/supervise'\nimport type { SupervisorProfile } from '../runtime/supervise/supervisor-agent'\nimport type { Budget, SupervisedResult } from '../runtime/supervise/types'\n\n/** Standing prompt for a supervisor that grows a shared knowledge base through spawned researchers. */\nexport const RESEARCH_SUPERVISOR_SYSTEM_PROMPT = [\n  'You are a research supervisor. You do not answer the research question yourself.',\n  'You create and manage researcher workers that improve one shared knowledge base until it is ready.',\n  '',\n  'Each round:',\n  '1. Read the goal and the gaps the readiness check still reports.',\n  '2. Decompose the open work into independent sub-topics.',\n  '3. Spawn one researcher per sub-topic; split by sub-topic, never duplicate work.',\n  '4. Wait for researchers to settle, steer or re-spawn thin sub-topics, then stop when the check passes.',\n  '',\n  'Conserve the shared budget. Prefer a small number of well-scoped researchers over a large fanout that re-covers the same ground.',\n].join('\\n')\n\nexport interface KnowledgeReadinessCheckInput {\n  root: string\n  goal: string\n  readinessSpecs?: readonly unknown[]\n  readinessTaskId?: string\n  readiness?: unknown\n}\n\nexport type KnowledgeReadinessCheckResult =\n  | boolean\n  | {\n      ready: boolean\n      summary?: string\n      metadata?: Record<string, unknown>\n    }\n\nexport type KnowledgeReadinessCheck = (\n  input: KnowledgeReadinessCheckInput,\n) => Promise<KnowledgeReadinessCheckResult> | KnowledgeReadinessCheckResult\n\nexport interface SupervisedKnowledgeUpdateInput {\n  goal?: string\n  root?: string\n  candidateRoot?: string\n  findings?: readonly unknown[]\n  metadata?: Record<string, unknown>\n}\n\nexport interface SupervisedKnowledgeUpdateResult {\n  applied: boolean\n  summary: string\n  supervised: SupervisedResult<unknown>\n  metadata: NonNullable<RagKnowledgeUpdateResult['metadata']>\n}\n\nexport interface SupervisedKnowledgeUpdateOptions {\n  root: string\n  goal: string\n  readiness: KnowledgeReadinessCheck\n  readinessSpecs?: readonly unknown[]\n  readinessTaskId?: string\n  readinessOptions?: unknown\n  findings?: readonly unknown[]\n  metadata?: Record<string, unknown>\n  budget: Budget\n  backend?: ExecutorConfig\n  makeWorkerAgent?: SuperviseOptions['makeWorkerAgent']\n  /** Caller-owned exact supervisor harness/provider/model identity. */\n  supervisorProfile: SupervisorProfile\n  superviseOptions?: Partial<\n    Omit<\n      SuperviseOptions,\n      'budget' | 'backend' | 'deliverable' | 'makeWorkerAgent' | 'allowedModels'\n    >\n  >\n  allowedModels?: readonly string[]\n  runSupervised?: (\n    profile: SupervisorProfile,\n    task: unknown,\n    opts: SuperviseOptions,\n  ) => Promise<SupervisedResult<unknown>>\n}\n\nexport type SupervisedKnowledgeUpdater = (\n  input: SupervisedKnowledgeUpdateInput,\n) => Promise<SupervisedKnowledgeUpdateResult>\n\n/** Build the completion check a supervised KB update uses to stop only when the KB is ready. */\nexport function knowledgeReadinessDeliverable(\n  options: Pick<\n    SupervisedKnowledgeUpdateOptions,\n    'root' | 'goal' | 'readiness' | 'readinessSpecs' | 'readinessTaskId' | 'readinessOptions'\n  >,\n): DeliverableSpec<unknown> {\n  return {\n    describe: `knowledge base at ${options.root} is ready for: ${options.goal}`,\n    async check() {\n      const result = await options.readiness({\n        root: options.root,\n        goal: options.goal,\n        readinessSpecs: options.readinessSpecs,\n        readinessTaskId: options.readinessTaskId,\n        readiness: options.readinessOptions,\n      })\n      return typeof result === 'boolean' ? result : result.ready\n    },\n  }\n}\n\n/** Create an `improveKnowledgeBase` update callback backed by runtime supervision. */\nexport function createSupervisedKnowledgeUpdater(\n  options: SupervisedKnowledgeUpdateOptions,\n): SupervisedKnowledgeUpdater {\n  return (input) =>\n    runSupervisedKnowledgeUpdate({\n      ...options,\n      root: input.candidateRoot ?? input.root ?? options.root,\n      goal: input.goal ?? options.goal,\n      findings: input.findings ?? options.findings,\n      metadata: { ...options.metadata, ...input.metadata },\n    })\n}\n\n/** Run a runtime supervisor that updates one candidate knowledge base and stops on readiness. */\nexport async function runSupervisedKnowledgeUpdate(\n  options: SupervisedKnowledgeUpdateOptions,\n): Promise<SupervisedKnowledgeUpdateResult> {\n  const exactSupervisor = agentProfileSchema.parse(options.supervisorProfile) as SupervisorProfile\n  assertExecutableAgentProfile(exactSupervisor, 'runSupervisedKnowledgeUpdate')\n  const baseInstructions = exactSupervisor.prompt?.systemPrompt ?? RESEARCH_SUPERVISOR_SYSTEM_PROMPT\n  const workerContract = RESEARCHER_SYSTEM_PROMPT\n  const systemPrompt = workerContract\n    ? `${baseInstructions}\\n\\nEach researcher worker you spawn follows this contract:\\n${workerContract}`\n    : baseInstructions\n\n  const profile: SupervisorProfile = {\n    ...exactSupervisor,\n    prompt: { ...exactSupervisor.prompt, systemPrompt },\n  }\n  const run = options.runSupervised ?? supervise\n  const task = formatSupervisedKnowledgeTask(options)\n  const supervised = await run(profile, task, {\n    ...options.superviseOptions,\n    budget: options.budget,\n    backend: options.backend,\n    deliverable: knowledgeReadinessDeliverable(options),\n    makeWorkerAgent: options.makeWorkerAgent,\n    allowedModels: options.allowedModels,\n  })\n  return {\n    applied: supervised.kind === 'winner',\n    summary:\n      supervised.kind === 'winner'\n        ? 'research supervisor completed and the knowledge base passed readiness'\n        : `research supervisor stopped without a ready knowledge base: ${supervised.reason}`,\n    supervised,\n    metadata: {\n      supervised: true,\n      root: options.root,\n      goal: options.goal,\n      result: supervised.kind,\n    },\n  }\n}\n\n/** Format the supervisor task with the KB root, readiness requirements, current findings, and metadata. */\nexport function formatSupervisedKnowledgeTask(\n  options: Pick<\n    SupervisedKnowledgeUpdateOptions,\n    'root' | 'goal' | 'readinessSpecs' | 'readinessTaskId' | 'findings' | 'metadata'\n  >,\n): string {\n  const sections = [\n    `Goal: ${options.goal}`,\n    `Knowledge base root: ${options.root}`,\n    options.readinessTaskId ? `Readiness task id: ${options.readinessTaskId}` : undefined,\n    options.readinessSpecs?.length\n      ? `Readiness specs:\\n${JSON.stringify(options.readinessSpecs, null, 2)}`\n      : undefined,\n    options.findings?.length\n      ? `Current findings:\\n${JSON.stringify(options.findings, null, 2)}`\n      : undefined,\n    options.metadata && Object.keys(options.metadata).length > 0\n      ? `Metadata:\\n${JSON.stringify(options.metadata, null, 2)}`\n      : undefined,\n  ].filter((section): section is string => Boolean(section))\n  return `${sections.join('\\n\\n')}\\n\\nUpdate files under the knowledge base root only. Stop when the readiness check passes.`\n}\n","import { realpath } from 'node:fs/promises'\nimport {\n  type AgentCandidateBundle,\n  type AgentCandidateCapturedArtifact,\n  type AgentCandidateKnowledge,\n  agentCandidateKnowledgeSchema,\n} from '@tangle-network/agent-interface'\nimport {\n  type BuildEvalKnowledgeBundleOptions,\n  evaluateKnowledgeBaseReadiness,\n  improveKnowledgeBase,\n  type KnowledgeBaseQualityOptions,\n  type KnowledgeImprovementOptions,\n  type KnowledgeImprovementResult,\n  type KnowledgeReadinessSpec,\n  knowledgeImprovementCandidateRef,\n  toAgentCandidateKnowledgeRef,\n  withKnowledgeImprovementComparison,\n} from '@tangle-network/agent-knowledge'\nimport { sealAgentCandidateBundle } from '../candidate-execution/bundle'\nimport {\n  canonicalCandidateBytes,\n  embeddedCandidateArtifact,\n  omitTopLevelDigest,\n} from '../candidate-execution/digest'\nimport { persistCandidateOutputArtifact } from '../candidate-execution/output-artifacts'\nimport type { AgentCandidateOutputArtifactPort } from '../candidate-execution/types'\nimport { captureAgentCandidateWorkspace } from '../candidate-execution/workspace-archive'\nimport type { ExecutorConfig } from '../runtime/supervise/runtime'\nimport type { SuperviseOptions } from '../runtime/supervise/supervise'\nimport type { SupervisorProfile } from '../runtime/supervise/supervisor-agent'\nimport type { Budget, SupervisedResult } from '../runtime/supervise/types'\nimport {\n  createSupervisedKnowledgeUpdater,\n  type KnowledgeReadinessCheck,\n  type KnowledgeReadinessCheckResult,\n  type SupervisedKnowledgeUpdateOptions,\n} from './supervised-update'\n\nexport interface RunKnowledgeImprovementJobOptions\n  extends Omit<KnowledgeImprovementOptions, 'updateKnowledge'> {\n  budget: Budget\n  readinessCheck?: KnowledgeReadinessCheck\n  backend?: ExecutorConfig\n  makeWorkerAgent?: SuperviseOptions['makeWorkerAgent']\n  supervisorProfile: SupervisorProfile\n  superviseOptions?: Partial<\n    Omit<\n      SuperviseOptions,\n      'budget' | 'backend' | 'deliverable' | 'makeWorkerAgent' | 'allowedModels'\n    >\n  >\n  allowedModels?: readonly string[]\n  runSupervised?: (\n    profile: SupervisorProfile,\n    task: unknown,\n    opts: SuperviseOptions,\n  ) => Promise<SupervisedResult<unknown>>\n  candidateArtifacts?: AgentCandidateOutputArtifactPort\n  onMeasurement?: (measurement: KnowledgeImprovementJobMeasurement) => Promise<void> | void\n}\n\nexport interface KnowledgeImprovementJobMeasurement {\n  startedAt: string\n  finishedAt: string\n  durationMs: number\n  updateCalls: number\n  updateDurationMs: number\n  supervisedSpent: {\n    iterations: number\n    inputTokens: number\n    outputTokens: number\n    usdKnown: boolean\n    usd: number\n    ms: number\n  }\n}\n\nexport interface KnowledgeImprovementJobResult {\n  improvement: KnowledgeImprovementResult\n  knowledge?: KnowledgeImprovementCandidatePair\n  measurement: KnowledgeImprovementJobMeasurement\n  blocked: boolean\n}\n\nexport interface KnowledgeImprovementCandidatePair {\n  reference: AgentCandidateKnowledge['candidate']\n  evaluation: AgentCandidateCapturedArtifact\n  baseline: AgentCandidateKnowledge['snapshot']\n  candidate: AgentCandidateKnowledge['snapshot']\n}\n\nexport interface KnowledgeImprovementExperimentBundles {\n  baseline: AgentCandidateBundle\n  candidate: AgentCandidateBundle\n}\n\nexport interface AgentKnowledgeReadinessCheckOptions {\n  goal: string\n  readinessSpecs?: readonly KnowledgeReadinessSpec[]\n  readinessTaskId?: string\n  readiness?: Omit<BuildEvalKnowledgeBundleOptions, 'taskId' | 'index' | 'specs'>\n  strict?: boolean\n  kbQuality?: KnowledgeBaseQualityOptions\n}\n\n/** Build the default readiness check backed by `@tangle-network/agent-knowledge` validation and scoring. */\nexport function createAgentKnowledgeReadinessCheck(\n  options: AgentKnowledgeReadinessCheckOptions,\n): KnowledgeReadinessCheck {\n  return async (input): Promise<KnowledgeReadinessCheckResult> => {\n    const readiness = await evaluateKnowledgeBaseReadiness({\n      root: input.root,\n      goal: input.goal ?? options.goal,\n      readinessSpecs:\n        (input.readinessSpecs as readonly KnowledgeReadinessSpec[] | undefined) ??\n        options.readinessSpecs,\n      readinessTaskId: input.readinessTaskId ?? options.readinessTaskId,\n      readiness:\n        (input.readiness as AgentKnowledgeReadinessCheckOptions['readiness'] | undefined) ??\n        options.readiness,\n      strict: options.strict,\n      kbQuality: options.kbQuality,\n    })\n    return {\n      ready: readiness.ready,\n      summary: readiness.summary,\n      metadata: {\n        dimensions: readiness.dimensions,\n        validationOk: readiness.validation.ok,\n        kbQualityOk: readiness.kbQuality.ok,\n        blockingMissing: readiness.readiness?.report.blockingMissingRequirements.length ?? 0,\n      },\n    }\n  }\n}\n\n/** Produce a frozen KB candidate while leaving live knowledge content unchanged. */\nexport async function runKnowledgeImprovementJob(\n  options: RunKnowledgeImprovementJobOptions,\n): Promise<KnowledgeImprovementJobResult> {\n  const {\n    allowedModels,\n    backend,\n    budget,\n    candidateArtifacts,\n    makeWorkerAgent,\n    onMeasurement,\n    readinessCheck,\n    runSupervised,\n    supervisorProfile,\n    superviseOptions,\n    ...knowledgeOptions\n  } = options\n  const startedAtMs = Date.now()\n  const startedAt = new Date(startedAtMs).toISOString()\n  const supervisedSpent = emptySpent()\n  let updateCalls = 0\n  let updateDurationMs = 0\n\n  const readiness = readinessCheck ?? createAgentKnowledgeReadinessCheck(options)\n  const updateKnowledge = createSupervisedKnowledgeUpdater({\n    root: options.root,\n    goal: options.goal,\n    readiness,\n    readinessSpecs: options.readinessSpecs,\n    readinessTaskId: options.readinessTaskId,\n    readinessOptions: options.readiness,\n    budget,\n    backend,\n    makeWorkerAgent,\n    supervisorProfile,\n    superviseOptions,\n    allowedModels,\n    runSupervised,\n  } satisfies SupervisedKnowledgeUpdateOptions)\n\n  const instrumentedUpdateKnowledge: KnowledgeImprovementOptions['updateKnowledge'] = async (\n    input,\n  ) => {\n    const updateStartedAt = Date.now()\n    updateCalls += 1\n    const result = await updateKnowledge(input)\n    updateDurationMs += Date.now() - updateStartedAt\n    addSpent(supervisedSpent, result.supervised)\n    return result\n  }\n  const resolvedImprovement = await improveKnowledgeBase({\n    ...knowledgeOptions,\n    updateKnowledge: instrumentedUpdateKnowledge,\n  })\n  let knowledge: KnowledgeImprovementCandidatePair | undefined\n  if (\n    resolvedImprovement.candidate?.status === 'candidate-ready' ||\n    resolvedImprovement.candidate?.status === 'promoted'\n  ) {\n    knowledge = await freezeKnowledgeCandidatePair(\n      options.root,\n      resolvedImprovement,\n      candidateArtifacts,\n      knowledgeOptions.signal,\n    )\n  }\n  const finishedAtMs = Date.now()\n  const measurement: KnowledgeImprovementJobMeasurement = {\n    startedAt,\n    finishedAt: new Date(finishedAtMs).toISOString(),\n    durationMs: finishedAtMs - startedAtMs,\n    updateCalls,\n    updateDurationMs,\n    supervisedSpent,\n  }\n  await onMeasurement?.(measurement)\n  return {\n    improvement: resolvedImprovement,\n    ...(knowledge ? { knowledge } : {}),\n    measurement,\n    blocked: resolvedImprovement.blocked,\n  }\n}\n\n/** Attach both frozen knowledge inputs to one otherwise-identical bundle pair. */\nexport function buildKnowledgeImprovementExperimentBundles(\n  bundle: AgentCandidateBundle,\n  knowledge: KnowledgeImprovementCandidatePair,\n): KnowledgeImprovementExperimentBundles {\n  const input = omitTopLevelDigest(bundle)\n  const withSnapshot = (snapshot: AgentCandidateKnowledge['snapshot']) =>\n    agentCandidateKnowledgeSchema.parse({\n      candidate: knowledge.reference,\n      snapshot,\n      evaluation: knowledge.evaluation,\n    })\n  return Object.freeze({\n    baseline: sealAgentCandidateBundle({ ...input, knowledge: withSnapshot(knowledge.baseline) }),\n    candidate: sealAgentCandidateBundle({ ...input, knowledge: withSnapshot(knowledge.candidate) }),\n  })\n}\n\nasync function freezeKnowledgeCandidatePair(\n  root: string,\n  improvement: KnowledgeImprovementResult,\n  artifacts: AgentCandidateOutputArtifactPort | undefined,\n  signal: AbortSignal | undefined,\n): Promise<KnowledgeImprovementCandidatePair> {\n  const candidate = knowledgeImprovementCandidateRef(improvement)\n  const candidateRef = toAgentCandidateKnowledgeRef(candidate)\n  return withKnowledgeImprovementComparison({ root, candidate }, async (comparison) => {\n    const freeze = async (\n      target: 'baseline' | 'candidate',\n    ): Promise<AgentCandidateKnowledge['snapshot']> => {\n      const executionId = `knowledge-${candidate.candidateId}-${target}`\n      const captured = await captureAgentCandidateWorkspace(\n        await realpath(comparison[target].root),\n        {\n          ...(artifacts\n            ? {\n                artifactPersistence: {\n                  executionId,\n                  outputArtifacts: artifacts,\n                  ...(signal ? { signal } : {}),\n                },\n              }\n            : {}),\n        },\n      )\n      return captured.snapshot\n    }\n    const evaluation = await captureKnowledgeEvidence(\n      canonicalCandidateBytes({\n        kind: 'agent-knowledge-candidate-evaluation',\n        candidate: candidateRef,\n        metric: comparison.evaluation,\n      }),\n      'knowledge-evaluation',\n      `knowledge-${candidate.candidateId}`,\n      artifacts,\n      signal,\n    )\n    const baseline = await freeze('baseline')\n    const proposed = await freeze('candidate')\n    return Object.freeze({\n      reference: candidateRef,\n      evaluation,\n      baseline,\n      candidate: proposed,\n    })\n  })\n}\n\nasync function captureKnowledgeEvidence(\n  bytes: Uint8Array,\n  purpose: 'knowledge-evaluation',\n  executionId: string,\n  artifacts: AgentCandidateOutputArtifactPort | undefined,\n  signal: AbortSignal | undefined,\n): Promise<AgentCandidateCapturedArtifact> {\n  if (!artifacts) return embeddedCandidateArtifact(bytes)\n  return persistCandidateOutputArtifact(artifacts, {\n    executionId,\n    purpose,\n    bytes,\n    ...(signal ? { signal } : {}),\n  })\n}\n\n/** The starting accumulator, before any supervised run has been folded in. Zero iterations means\n *  nothing ran, so a zero dollar total IS the measured amount; `addSpent` lowers `usdKnown` as\n *  soon as it folds a run whose own dollars were not proven. */\nfunction emptySpent(): KnowledgeImprovementJobMeasurement['supervisedSpent'] {\n  return { iterations: 0, inputTokens: 0, outputTokens: 0, usdKnown: true, usd: 0, ms: 0 }\n}\n\nfunction addSpent(\n  target: KnowledgeImprovementJobMeasurement['supervisedSpent'],\n  result: SupervisedResult<unknown>,\n): void {\n  const spent = result.spentTotal\n  target.iterations += spent.iterations\n  target.inputTokens += spent.tokens.input\n  target.outputTokens += spent.tokens.output\n  target.usdKnown = target.usdKnown && spent.usdKnown !== false\n  target.usd += spent.usd\n  target.ms += spent.ms\n}\n"],"mappings":"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"}
+{"version":3,"file":"knowledge-DjWWfbfX.js","names":[],"sources":["../src/knowledge/activation.ts","../src/knowledge/supervised-update.ts","../src/knowledge/improvement-job.ts"],"sourcesContent":["import type {\n  AgentImprovementActivationOutcome,\n  AgentImprovementActivationResult,\n  AgentImprovementActivationTarget,\n  Sha256Digest,\n} from '@tangle-network/agent-interface'\nimport { sha256DigestSchema } from '@tangle-network/agent-interface'\nimport {\n  fromAgentCandidateKnowledgeRef,\n  type KnowledgeImprovementMutationReceipt,\n  loadKnowledgeImprovementActivationResult,\n  type PromoteKnowledgeCandidateOptions,\n  promoteKnowledgeCandidate,\n  restoreKnowledgeCandidateBaseline,\n} from '@tangle-network/agent-knowledge'\n\nimport {\n  type AgentImprovementActivationReconciliation,\n  type AgentImprovementActivationResultStore,\n  type AgentImprovementActivationTransition,\n  type AgentImprovementActivationTransitionInput,\n  createAgentImprovementActivationResult,\n} from '../intelligence/activation'\n\nexport interface CreateKnowledgeImprovementActivationExecutorOptions\n  extends Omit<PromoteKnowledgeCandidateOptions, 'root' | 'candidate'> {\n  root: string\n  identity: string\n  results: AgentImprovementActivationResultStore\n}\n\nexport interface KnowledgeImprovementActivationExecutor {\n  transition: AgentImprovementActivationTransition\n  reconcile: AgentImprovementActivationReconciliation\n}\n\n/** Apply or restore one local knowledge candidate through the shared activation contract. */\nexport function createKnowledgeImprovementActivationExecutor(\n  options: CreateKnowledgeImprovementActivationExecutorOptions,\n): KnowledgeImprovementActivationExecutor {\n  if (!options.identity.trim()) throw new Error('knowledge activation identity is required')\n  return {\n    reconcile: async (transition) => {\n      const inspected = await inspectKnowledgeActivation(options, transition)\n      return inspected.settled ? inspected.result : undefined\n    },\n    transition: async (transition) => {\n      if (transition.expired) {\n        throw new Error('knowledge write transition cannot run after authorization expires')\n      }\n      const inspected = await inspectKnowledgeActivation(options, transition)\n      if (inspected.settled) return inspected.result\n\n      const mutationOptions = {\n        root: options.root,\n        candidate: inspected.candidate,\n        activation: {\n          activation: transition.activation,\n          attemptedAt: transition.attemptedAt,\n          identity: options.identity,\n          createResult: (receipt: KnowledgeImprovementMutationReceipt) =>\n            inspected.create(\n              knowledgeMutationOutcome(receipt, inspected, transition.activation.intent),\n            ),\n        },\n        ...(options.ownerId ? { ownerId: options.ownerId } : {}),\n        ...(options.leaseTtlMs === undefined ? {} : { leaseTtlMs: options.leaseTtlMs }),\n        ...(options.now ? { now: options.now } : {}),\n        ...(options.onState ? { onState: options.onState } : {}),\n      }\n      const improvement =\n        transition.activation.intent === 'activate-candidate'\n          ? await promoteKnowledgeCandidate(mutationOptions)\n          : await restoreKnowledgeCandidateBaseline(mutationOptions)\n      if (!improvement.activationResult) {\n        throw new Error('knowledge mutation did not persist its shared activation result')\n      }\n      return options.results.putIfAbsent(improvement.activationResult)\n    },\n  }\n}\n\ntype CreateKnowledgeActivation = (\n  outcome: AgentImprovementActivationOutcome,\n) => AgentImprovementActivationResult\n\ntype InspectedKnowledgeActivation =\n  | { settled: true; result: unknown | undefined }\n  | {\n      settled: false\n      target: AgentImprovementActivationTransitionInput['targets'][number]\n      candidate: PromoteKnowledgeCandidateOptions['candidate']\n      expectedDigest: Sha256Digest\n      desiredDigest: Sha256Digest\n      create: CreateKnowledgeActivation\n    }\n\nasync function inspectKnowledgeActivation(\n  options: CreateKnowledgeImprovementActivationExecutorOptions,\n  transition: AgentImprovementActivationTransitionInput,\n): Promise<InspectedKnowledgeActivation> {\n  const stored = await options.results.load(transition.activation.digest)\n  if (stored !== undefined) return { settled: true, result: stored }\n\n  const create: CreateKnowledgeActivation = (outcome) =>\n    createAgentImprovementActivationResult(transition, {\n      completedAt: completionTime(transition, options.now),\n      outcome,\n    })\n  const store = (outcome: AgentImprovementActivationOutcome) =>\n    options.results.putIfAbsent(create(outcome))\n  if (transition.kind !== 'sealed-candidate') {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'unsupported',\n        code: 'KNOWLEDGE_PROFILE_TRANSITION_UNSUPPORTED',\n        message: 'The knowledge adapter accepts only sealed knowledge candidates.',\n      }),\n    }\n  }\n  const target = supportedKnowledgeTarget(transition, options.identity)\n  if (!target) {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'unsupported',\n        code: 'KNOWLEDGE_TARGET_SET_UNSUPPORTED',\n        message: 'The knowledge adapter requires exactly one matching knowledge target.',\n      }),\n    }\n  }\n  const knowledge = transition.candidateBundle.knowledge\n  if (!knowledge) {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'unsupported',\n        code: 'KNOWLEDGE_CANDIDATE_MISSING',\n        message: 'The measured candidate bundle does not contain a knowledge candidate.',\n      }),\n    }\n  }\n  const candidate = fromAgentCandidateKnowledgeRef(knowledge.candidate)\n  const expectedDigest =\n    transition.activation.intent === 'activate-candidate'\n      ? knowledge.candidate.baseHash\n      : knowledge.candidate.candidateHash\n  const desiredDigest =\n    transition.activation.intent === 'activate-candidate'\n      ? knowledge.candidate.candidateHash\n      : knowledge.candidate.baseHash\n  if (target.expectedBaseDigest !== expectedDigest || target.desiredDigest !== desiredDigest) {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'failed',\n        code: 'KNOWLEDGE_TARGET_MISMATCH',\n        message: 'The activation target does not match the measured knowledge candidate.',\n      }),\n    }\n  }\n\n  const durable = await loadKnowledgeImprovementActivationResult({\n    root: options.root,\n    candidate,\n    activation: transition.activation,\n    identity: options.identity,\n  })\n  if (durable) {\n    return {\n      settled: true,\n      result: await options.results.putIfAbsent(durable),\n    }\n  }\n  if (transition.expired) return { settled: true, result: undefined }\n  return { settled: false, target, candidate, expectedDigest, desiredDigest, create }\n}\n\nfunction supportedKnowledgeTarget(\n  transition: AgentImprovementActivationTransitionInput,\n  identity: string,\n): AgentImprovementActivationTransitionInput['targets'][number] | undefined {\n  if (transition.targets.length !== 1) return undefined\n  const target = transition.targets[0]\n  return target.surface === 'knowledge' && target.identity === identity ? target : undefined\n}\n\nfunction knowledgeMutationOutcome(\n  receipt: KnowledgeImprovementMutationReceipt,\n  inspected: Extract<InspectedKnowledgeActivation, { settled: false }>,\n  intent: AgentImprovementActivationTransitionInput['activation']['intent'],\n): AgentImprovementActivationOutcome {\n  const expectedTarget = intent === 'activate-candidate' ? 'candidate' : 'baseline'\n  const beforeDigest = prefixedDigest(receipt.beforeHash)\n  const afterDigest = prefixedDigest(receipt.afterHash)\n  if (\n    receipt.target !== expectedTarget ||\n    receipt.changed !== (beforeDigest !== afterDigest) ||\n    (!receipt.changed && (receipt.transactionId !== null || receipt.recovered))\n  ) {\n    throw new Error('knowledge mutation returned inconsistent state evidence')\n  }\n  if (receipt.changed) {\n    if (\n      receipt.transactionId === null ||\n      beforeDigest !== inspected.expectedDigest ||\n      afterDigest !== inspected.desiredDigest\n    ) {\n      throw new Error('knowledge activation did not apply its authorized content transition')\n    }\n    return {\n      status: 'applied',\n      transactionId: receipt.transactionId,\n      targets: [\n        {\n          surface: inspected.target.surface,\n          identity: inspected.target.identity,\n          beforeDigest,\n          afterDigest,\n        },\n      ],\n    }\n  }\n  if (afterDigest === inspected.desiredDigest) {\n    return {\n      status: 'already-applied',\n      targets: [targetState(inspected.target, afterDigest)],\n    }\n  }\n  if (afterDigest === inspected.expectedDigest) {\n    throw new Error('knowledge activation did not attempt its authorized content transition')\n  }\n  return {\n    status: 'conflict',\n    targets: [targetState(inspected.target, afterDigest)],\n  }\n}\n\nfunction targetState(target: AgentImprovementActivationTarget, currentDigest: Sha256Digest) {\n  return {\n    surface: target.surface,\n    identity: target.identity,\n    currentDigest,\n  }\n}\n\nfunction prefixedDigest(hash: string): Sha256Digest {\n  return sha256DigestSchema.parse(`sha256:${hash}`)\n}\n\nfunction completionTime(\n  transition: AgentImprovementActivationTransitionInput,\n  now: (() => Date) | undefined,\n): string {\n  const completedAt = (now ?? (() => new Date()))().toISOString()\n  return Date.parse(completedAt) < Date.parse(transition.attemptedAt)\n    ? transition.attemptedAt\n    : completedAt\n}\n","import { agentProfileSchema } from '@tangle-network/agent-interface'\nimport type { RagKnowledgeUpdateResult } from '@tangle-network/agent-knowledge'\nimport { RESEARCHER_SYSTEM_PROMPT } from '../profiles/researcher'\nimport type { DeliverableSpec } from '../runtime/supervise/completion-gate'\nimport { assertExecutableAgentProfile } from '../runtime/supervise/model-policy'\nimport type { ExecutorConfig } from '../runtime/supervise/runtime'\nimport { type SuperviseOptions, supervise } from '../runtime/supervise/supervise'\nimport type { SupervisorProfile } from '../runtime/supervise/supervisor-agent'\nimport type { Budget, SupervisedResult } from '../runtime/supervise/types'\n\n/** Standing prompt for a supervisor that grows a shared knowledge base through spawned researchers. */\nexport const RESEARCH_SUPERVISOR_SYSTEM_PROMPT = [\n  'You are a research supervisor. You do not answer the research question yourself.',\n  'You create and manage researcher workers that improve one shared knowledge base until it is ready.',\n  '',\n  'Each round:',\n  '1. Read the goal and the gaps the readiness check still reports.',\n  '2. Decompose the open work into independent sub-topics.',\n  '3. Spawn one researcher per sub-topic; split by sub-topic, never duplicate work.',\n  '4. Wait for researchers to settle, steer or re-spawn thin sub-topics, then stop when the check passes.',\n  '',\n  'Conserve the shared budget. Prefer a small number of well-scoped researchers over a large fanout that re-covers the same ground.',\n].join('\\n')\n\nexport interface KnowledgeReadinessCheckInput {\n  root: string\n  goal: string\n  readinessSpecs?: readonly unknown[]\n  readinessTaskId?: string\n  readiness?: unknown\n}\n\nexport type KnowledgeReadinessCheckResult =\n  | boolean\n  | {\n      ready: boolean\n      summary?: string\n      metadata?: Record<string, unknown>\n    }\n\nexport type KnowledgeReadinessCheck = (\n  input: KnowledgeReadinessCheckInput,\n) => Promise<KnowledgeReadinessCheckResult> | KnowledgeReadinessCheckResult\n\nexport interface SupervisedKnowledgeUpdateInput {\n  goal?: string\n  root?: string\n  candidateRoot?: string\n  findings?: readonly unknown[]\n  metadata?: Record<string, unknown>\n}\n\nexport interface SupervisedKnowledgeUpdateResult {\n  applied: boolean\n  summary: string\n  supervised: SupervisedResult<unknown>\n  metadata: NonNullable<RagKnowledgeUpdateResult['metadata']>\n}\n\nexport interface SupervisedKnowledgeUpdateOptions {\n  root: string\n  goal: string\n  readiness: KnowledgeReadinessCheck\n  readinessSpecs?: readonly unknown[]\n  readinessTaskId?: string\n  readinessOptions?: unknown\n  findings?: readonly unknown[]\n  metadata?: Record<string, unknown>\n  budget: Budget\n  backend?: ExecutorConfig\n  makeWorkerAgent?: SuperviseOptions['makeWorkerAgent']\n  /** Caller-owned exact supervisor harness/provider/model identity. */\n  supervisorProfile: SupervisorProfile\n  superviseOptions?: Partial<\n    Omit<\n      SuperviseOptions,\n      'budget' | 'backend' | 'deliverable' | 'makeWorkerAgent' | 'allowedModels'\n    >\n  >\n  allowedModels?: readonly string[]\n  runSupervised?: (\n    profile: SupervisorProfile,\n    task: unknown,\n    opts: SuperviseOptions,\n  ) => Promise<SupervisedResult<unknown>>\n}\n\nexport type SupervisedKnowledgeUpdater = (\n  input: SupervisedKnowledgeUpdateInput,\n) => Promise<SupervisedKnowledgeUpdateResult>\n\n/** Build the completion check a supervised KB update uses to stop only when the KB is ready. */\nexport function knowledgeReadinessDeliverable(\n  options: Pick<\n    SupervisedKnowledgeUpdateOptions,\n    'root' | 'goal' | 'readiness' | 'readinessSpecs' | 'readinessTaskId' | 'readinessOptions'\n  >,\n): DeliverableSpec<unknown> {\n  return {\n    describe: `knowledge base at ${options.root} is ready for: ${options.goal}`,\n    async check() {\n      const result = await options.readiness({\n        root: options.root,\n        goal: options.goal,\n        readinessSpecs: options.readinessSpecs,\n        readinessTaskId: options.readinessTaskId,\n        readiness: options.readinessOptions,\n      })\n      return typeof result === 'boolean' ? result : result.ready\n    },\n  }\n}\n\n/** Create an `improveKnowledgeBase` update callback backed by runtime supervision. */\nexport function createSupervisedKnowledgeUpdater(\n  options: SupervisedKnowledgeUpdateOptions,\n): SupervisedKnowledgeUpdater {\n  return (input) =>\n    runSupervisedKnowledgeUpdate({\n      ...options,\n      root: input.candidateRoot ?? input.root ?? options.root,\n      goal: input.goal ?? options.goal,\n      findings: input.findings ?? options.findings,\n      metadata: { ...options.metadata, ...input.metadata },\n    })\n}\n\n/** Run a runtime supervisor that updates one candidate knowledge base and stops on readiness. */\nexport async function runSupervisedKnowledgeUpdate(\n  options: SupervisedKnowledgeUpdateOptions,\n): Promise<SupervisedKnowledgeUpdateResult> {\n  const exactSupervisor = agentProfileSchema.parse(options.supervisorProfile) as SupervisorProfile\n  assertExecutableAgentProfile(exactSupervisor, 'runSupervisedKnowledgeUpdate')\n  const baseInstructions = exactSupervisor.prompt?.systemPrompt ?? RESEARCH_SUPERVISOR_SYSTEM_PROMPT\n  const workerContract = RESEARCHER_SYSTEM_PROMPT\n  const systemPrompt = workerContract\n    ? `${baseInstructions}\\n\\nEach researcher worker you spawn follows this contract:\\n${workerContract}`\n    : baseInstructions\n\n  const profile: SupervisorProfile = {\n    ...exactSupervisor,\n    prompt: { ...exactSupervisor.prompt, systemPrompt },\n  }\n  const run = options.runSupervised ?? supervise\n  const task = formatSupervisedKnowledgeTask(options)\n  const supervised = await run(profile, task, {\n    ...options.superviseOptions,\n    budget: options.budget,\n    backend: options.backend,\n    deliverable: knowledgeReadinessDeliverable(options),\n    makeWorkerAgent: options.makeWorkerAgent,\n    allowedModels: options.allowedModels,\n  })\n  return {\n    applied: supervised.kind === 'winner',\n    summary:\n      supervised.kind === 'winner'\n        ? 'research supervisor completed and the knowledge base passed readiness'\n        : `research supervisor stopped without a ready knowledge base: ${supervised.reason}`,\n    supervised,\n    metadata: {\n      supervised: true,\n      root: options.root,\n      goal: options.goal,\n      result: supervised.kind,\n    },\n  }\n}\n\n/** Format the supervisor task with the KB root, readiness requirements, current findings, and metadata. */\nexport function formatSupervisedKnowledgeTask(\n  options: Pick<\n    SupervisedKnowledgeUpdateOptions,\n    'root' | 'goal' | 'readinessSpecs' | 'readinessTaskId' | 'findings' | 'metadata'\n  >,\n): string {\n  const sections = [\n    `Goal: ${options.goal}`,\n    `Knowledge base root: ${options.root}`,\n    options.readinessTaskId ? `Readiness task id: ${options.readinessTaskId}` : undefined,\n    options.readinessSpecs?.length\n      ? `Readiness specs:\\n${JSON.stringify(options.readinessSpecs, null, 2)}`\n      : undefined,\n    options.findings?.length\n      ? `Current findings:\\n${JSON.stringify(options.findings, null, 2)}`\n      : undefined,\n    options.metadata && Object.keys(options.metadata).length > 0\n      ? `Metadata:\\n${JSON.stringify(options.metadata, null, 2)}`\n      : undefined,\n  ].filter((section): section is string => Boolean(section))\n  return `${sections.join('\\n\\n')}\\n\\nUpdate files under the knowledge base root only. Stop when the readiness check passes.`\n}\n","import { realpath } from 'node:fs/promises'\nimport {\n  type AgentCandidateBundle,\n  type AgentCandidateCapturedArtifact,\n  type AgentCandidateKnowledge,\n  agentCandidateKnowledgeSchema,\n} from '@tangle-network/agent-interface'\nimport {\n  type BuildEvalKnowledgeBundleOptions,\n  evaluateKnowledgeBaseReadiness,\n  improveKnowledgeBase,\n  type KnowledgeBaseQualityOptions,\n  type KnowledgeImprovementOptions,\n  type KnowledgeImprovementResult,\n  type KnowledgeReadinessSpec,\n  knowledgeImprovementCandidateRef,\n  toAgentCandidateKnowledgeRef,\n  withKnowledgeImprovementComparison,\n} from '@tangle-network/agent-knowledge'\nimport { sealAgentCandidateBundle } from '../candidate-execution/bundle'\nimport {\n  canonicalCandidateBytes,\n  embeddedCandidateArtifact,\n  omitTopLevelDigest,\n} from '../candidate-execution/digest'\nimport { persistCandidateOutputArtifact } from '../candidate-execution/output-artifacts'\nimport type { AgentCandidateOutputArtifactPort } from '../candidate-execution/types'\nimport { captureAgentCandidateWorkspace } from '../candidate-execution/workspace-archive'\nimport type { ExecutorConfig } from '../runtime/supervise/runtime'\nimport type { SuperviseOptions } from '../runtime/supervise/supervise'\nimport type { SupervisorProfile } from '../runtime/supervise/supervisor-agent'\nimport type { Budget, SupervisedResult } from '../runtime/supervise/types'\nimport {\n  createSupervisedKnowledgeUpdater,\n  type KnowledgeReadinessCheck,\n  type KnowledgeReadinessCheckResult,\n  type SupervisedKnowledgeUpdateOptions,\n} from './supervised-update'\n\nexport interface RunKnowledgeImprovementJobOptions\n  extends Omit<KnowledgeImprovementOptions, 'updateKnowledge'> {\n  budget: Budget\n  readinessCheck?: KnowledgeReadinessCheck\n  backend?: ExecutorConfig\n  makeWorkerAgent?: SuperviseOptions['makeWorkerAgent']\n  supervisorProfile: SupervisorProfile\n  superviseOptions?: Partial<\n    Omit<\n      SuperviseOptions,\n      'budget' | 'backend' | 'deliverable' | 'makeWorkerAgent' | 'allowedModels'\n    >\n  >\n  allowedModels?: readonly string[]\n  runSupervised?: (\n    profile: SupervisorProfile,\n    task: unknown,\n    opts: SuperviseOptions,\n  ) => Promise<SupervisedResult<unknown>>\n  candidateArtifacts?: AgentCandidateOutputArtifactPort\n  onMeasurement?: (measurement: KnowledgeImprovementJobMeasurement) => Promise<void> | void\n}\n\nexport interface KnowledgeImprovementJobMeasurement {\n  startedAt: string\n  finishedAt: string\n  durationMs: number\n  updateCalls: number\n  updateDurationMs: number\n  supervisedSpent: {\n    iterations: number\n    inputTokens: number\n    outputTokens: number\n    usdKnown: boolean\n    usd: number\n    ms: number\n  }\n}\n\nexport interface KnowledgeImprovementJobResult {\n  improvement: KnowledgeImprovementResult\n  knowledge?: KnowledgeImprovementCandidatePair\n  measurement: KnowledgeImprovementJobMeasurement\n  blocked: boolean\n}\n\nexport interface KnowledgeImprovementCandidatePair {\n  reference: AgentCandidateKnowledge['candidate']\n  evaluation: AgentCandidateCapturedArtifact\n  baseline: AgentCandidateKnowledge['snapshot']\n  candidate: AgentCandidateKnowledge['snapshot']\n}\n\nexport interface KnowledgeImprovementExperimentBundles {\n  baseline: AgentCandidateBundle\n  candidate: AgentCandidateBundle\n}\n\nexport interface AgentKnowledgeReadinessCheckOptions {\n  goal: string\n  readinessSpecs?: readonly KnowledgeReadinessSpec[]\n  readinessTaskId?: string\n  readiness?: Omit<BuildEvalKnowledgeBundleOptions, 'taskId' | 'index' | 'specs'>\n  strict?: boolean\n  kbQuality?: KnowledgeBaseQualityOptions\n}\n\n/** Build the default readiness check backed by `@tangle-network/agent-knowledge` validation and scoring. */\nexport function createAgentKnowledgeReadinessCheck(\n  options: AgentKnowledgeReadinessCheckOptions,\n): KnowledgeReadinessCheck {\n  return async (input): Promise<KnowledgeReadinessCheckResult> => {\n    const readiness = await evaluateKnowledgeBaseReadiness({\n      root: input.root,\n      goal: input.goal ?? options.goal,\n      readinessSpecs:\n        (input.readinessSpecs as readonly KnowledgeReadinessSpec[] | undefined) ??\n        options.readinessSpecs,\n      readinessTaskId: input.readinessTaskId ?? options.readinessTaskId,\n      readiness:\n        (input.readiness as AgentKnowledgeReadinessCheckOptions['readiness'] | undefined) ??\n        options.readiness,\n      strict: options.strict,\n      kbQuality: options.kbQuality,\n    })\n    return {\n      ready: readiness.ready,\n      summary: readiness.summary,\n      metadata: {\n        dimensions: readiness.dimensions,\n        validationOk: readiness.validation.ok,\n        kbQualityOk: readiness.kbQuality.ok,\n        blockingMissing: readiness.readiness?.report.blockingMissingRequirements.length ?? 0,\n      },\n    }\n  }\n}\n\n/** Produce a frozen KB candidate while leaving live knowledge content unchanged. */\nexport async function runKnowledgeImprovementJob(\n  options: RunKnowledgeImprovementJobOptions,\n): Promise<KnowledgeImprovementJobResult> {\n  const {\n    allowedModels,\n    backend,\n    budget,\n    candidateArtifacts,\n    makeWorkerAgent,\n    onMeasurement,\n    readinessCheck,\n    runSupervised,\n    supervisorProfile,\n    superviseOptions,\n    ...knowledgeOptions\n  } = options\n  const startedAtMs = Date.now()\n  const startedAt = new Date(startedAtMs).toISOString()\n  const supervisedSpent = emptySpent()\n  let updateCalls = 0\n  let updateDurationMs = 0\n\n  const readiness = readinessCheck ?? createAgentKnowledgeReadinessCheck(options)\n  const updateKnowledge = createSupervisedKnowledgeUpdater({\n    root: options.root,\n    goal: options.goal,\n    readiness,\n    readinessSpecs: options.readinessSpecs,\n    readinessTaskId: options.readinessTaskId,\n    readinessOptions: options.readiness,\n    budget,\n    backend,\n    makeWorkerAgent,\n    supervisorProfile,\n    superviseOptions,\n    allowedModels,\n    runSupervised,\n  } satisfies SupervisedKnowledgeUpdateOptions)\n\n  const instrumentedUpdateKnowledge: KnowledgeImprovementOptions['updateKnowledge'] = async (\n    input,\n  ) => {\n    const updateStartedAt = Date.now()\n    updateCalls += 1\n    const result = await updateKnowledge(input)\n    updateDurationMs += Date.now() - updateStartedAt\n    addSpent(supervisedSpent, result.supervised)\n    return result\n  }\n  const resolvedImprovement = await improveKnowledgeBase({\n    ...knowledgeOptions,\n    updateKnowledge: instrumentedUpdateKnowledge,\n  })\n  let knowledge: KnowledgeImprovementCandidatePair | undefined\n  if (\n    resolvedImprovement.candidate?.status === 'candidate-ready' ||\n    resolvedImprovement.candidate?.status === 'promoted'\n  ) {\n    knowledge = await freezeKnowledgeCandidatePair(\n      options.root,\n      resolvedImprovement,\n      candidateArtifacts,\n      knowledgeOptions.signal,\n    )\n  }\n  const finishedAtMs = Date.now()\n  const measurement: KnowledgeImprovementJobMeasurement = {\n    startedAt,\n    finishedAt: new Date(finishedAtMs).toISOString(),\n    durationMs: finishedAtMs - startedAtMs,\n    updateCalls,\n    updateDurationMs,\n    supervisedSpent,\n  }\n  await onMeasurement?.(measurement)\n  return {\n    improvement: resolvedImprovement,\n    ...(knowledge ? { knowledge } : {}),\n    measurement,\n    blocked: resolvedImprovement.blocked,\n  }\n}\n\n/** Attach both frozen knowledge inputs to one otherwise-identical bundle pair. */\nexport function buildKnowledgeImprovementExperimentBundles(\n  bundle: AgentCandidateBundle,\n  knowledge: KnowledgeImprovementCandidatePair,\n): KnowledgeImprovementExperimentBundles {\n  const input = omitTopLevelDigest(bundle)\n  const withSnapshot = (snapshot: AgentCandidateKnowledge['snapshot']) =>\n    agentCandidateKnowledgeSchema.parse({\n      candidate: knowledge.reference,\n      snapshot,\n      evaluation: knowledge.evaluation,\n    })\n  return Object.freeze({\n    baseline: sealAgentCandidateBundle({ ...input, knowledge: withSnapshot(knowledge.baseline) }),\n    candidate: sealAgentCandidateBundle({ ...input, knowledge: withSnapshot(knowledge.candidate) }),\n  })\n}\n\nasync function freezeKnowledgeCandidatePair(\n  root: string,\n  improvement: KnowledgeImprovementResult,\n  artifacts: AgentCandidateOutputArtifactPort | undefined,\n  signal: AbortSignal | undefined,\n): Promise<KnowledgeImprovementCandidatePair> {\n  const candidate = knowledgeImprovementCandidateRef(improvement)\n  const candidateRef = toAgentCandidateKnowledgeRef(candidate)\n  return withKnowledgeImprovementComparison({ root, candidate }, async (comparison) => {\n    const freeze = async (\n      target: 'baseline' | 'candidate',\n    ): Promise<AgentCandidateKnowledge['snapshot']> => {\n      const executionId = `knowledge-${candidate.candidateId}-${target}`\n      const captured = await captureAgentCandidateWorkspace(\n        await realpath(comparison[target].root),\n        {\n          ...(artifacts\n            ? {\n                artifactPersistence: {\n                  executionId,\n                  outputArtifacts: artifacts,\n                  ...(signal ? { signal } : {}),\n                },\n              }\n            : {}),\n        },\n      )\n      return captured.snapshot\n    }\n    const evaluation = await captureKnowledgeEvidence(\n      canonicalCandidateBytes({\n        kind: 'agent-knowledge-candidate-evaluation',\n        candidate: candidateRef,\n        metric: comparison.evaluation,\n      }),\n      'knowledge-evaluation',\n      `knowledge-${candidate.candidateId}`,\n      artifacts,\n      signal,\n    )\n    const baseline = await freeze('baseline')\n    const proposed = await freeze('candidate')\n    return Object.freeze({\n      reference: candidateRef,\n      evaluation,\n      baseline,\n      candidate: proposed,\n    })\n  })\n}\n\nasync function captureKnowledgeEvidence(\n  bytes: Uint8Array,\n  purpose: 'knowledge-evaluation',\n  executionId: string,\n  artifacts: AgentCandidateOutputArtifactPort | undefined,\n  signal: AbortSignal | undefined,\n): Promise<AgentCandidateCapturedArtifact> {\n  if (!artifacts) return embeddedCandidateArtifact(bytes)\n  return persistCandidateOutputArtifact(artifacts, {\n    executionId,\n    purpose,\n    bytes,\n    ...(signal ? { signal } : {}),\n  })\n}\n\n/** The starting accumulator, before any supervised run has been folded in. Zero iterations means\n *  nothing ran, so a zero dollar total IS the measured amount; `addSpent` lowers `usdKnown` as\n *  soon as it folds a run whose own dollars were not proven. */\nfunction emptySpent(): KnowledgeImprovementJobMeasurement['supervisedSpent'] {\n  return { iterations: 0, inputTokens: 0, outputTokens: 0, usdKnown: true, usd: 0, ms: 0 }\n}\n\nfunction addSpent(\n  target: KnowledgeImprovementJobMeasurement['supervisedSpent'],\n  result: SupervisedResult<unknown>,\n): void {\n  const spent = result.spentTotal\n  target.iterations += spent.iterations\n  target.inputTokens += spent.tokens.input\n  target.outputTokens += spent.tokens.output\n  target.usdKnown = target.usdKnown && spent.usdKnown !== false\n  target.usd += spent.usd\n  target.ms += spent.ms\n}\n"],"mappings":"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"}

package/dist/knowledge.js

@@ -1,2 +1,2 @@
-import { a as createSupervisedKnowledgeUpdater, c as runSupervisedKnowledgeUpdate, i as RESEARCH_SUPERVISOR_SYSTEM_PROMPT, l as createKnowledgeImprovementActivationExecutor, n as createAgentKnowledgeReadinessCheck, o as formatSupervisedKnowledgeTask, r as runKnowledgeImprovementJob, s as knowledgeReadinessDeliverable, t as buildKnowledgeImprovementExperimentBundles } from "./knowledge-DCepYOlH.js";
+import { a as createSupervisedKnowledgeUpdater, c as runSupervisedKnowledgeUpdate, i as RESEARCH_SUPERVISOR_SYSTEM_PROMPT, l as createKnowledgeImprovementActivationExecutor, n as createAgentKnowledgeReadinessCheck, o as formatSupervisedKnowledgeTask, r as runKnowledgeImprovementJob, s as knowledgeReadinessDeliverable, t as buildKnowledgeImprovementExperimentBundles } from "./knowledge-DjWWfbfX.js";
 export { RESEARCH_SUPERVISOR_SYSTEM_PROMPT, buildKnowledgeImprovementExperimentBundles, createAgentKnowledgeReadinessCheck, createKnowledgeImprovementActivationExecutor, createSupervisedKnowledgeUpdater, formatSupervisedKnowledgeTask, knowledgeReadinessDeliverable, runKnowledgeImprovementJob, runSupervisedKnowledgeUpdate };

package/dist/{redact-6S20u4Ii.d.ts → redact-DvLf4x1m.d.ts}

@@ -49,11 +49,38 @@ interface CandidateGenerator {
 }
 //#endregion
 //#region src/improvement/agentic-generator.d.ts
-/** Outcome of verifying a candidate worktree. `feedback` (compiler errors,
- *  failing test output) is fed into the next shot when `ok` is false. */
+/**
+ * Outcome of verifying a candidate worktree.
+ *
+ * `ok` answers "is this tree shippable". `keepGoing` answers "should the budget
+ * stop here", and `score` ranks this tree against the other trees the same
+ * candidate produced — three separate questions, so a verifier can pass a tree
+ * and still spend the shots it was given.
+ *
+ * `feedback` (compiler errors, failing test output, or the reason a passing
+ * tree is being sent back) is fed into the next shot.
+ */
 interface VerifyResult {
   ok: boolean;
   feedback?: string;
+  /**
+   * Spend the remaining shots instead of returning this tree now.
+   *
+   * Read only when `ok` is true: a failed verification already spends the next
+   * shot. Omitted means the first passing tree ends the candidate.
+   */
+  keepGoing?: boolean;
+  /**
+   * How good this tree is, for ranking it against the other passing trees of
+   * this candidate. Higher wins; a tie keeps the LATER tree, which is the one
+   * already on disk and the one the author refined last.
+   *
+   * Only a passing tree is ranked — a tree that failed verification is never a
+   * candidate, whatever it scored. Score every passing tree or none of them: a
+   * scored tree cannot be ranked against an unscored one, and mixing the two
+   * fails the run rather than guessing an order.
+   */
+  score?: number;
 }
 /** Verifies the edited worktree. Sync or async; throws only on a setup fault
  *  (a candidate that fails verification returns `{ok:false}`, it does not
@@ -104,10 +131,25 @@ type AgenticGeneratorShotDisposition = {
   readonly worktreePath: string;
   readonly stage: 'raw-trace-evidence' | 'verification';
   readonly feedback: string | null;
+} | {
+  /** The tree passed verification and the verifier asked for another shot,
+   *  so it was snapshotted and the budget continues. */
+  readonly kind: 'kept';
+  readonly worktreePath: string;
+  /** The rank the verifier gave this tree, or null when it scored nothing. */
+  readonly score: number | null;
+  /** Whether this tree is now the best one this candidate has produced. */
+  readonly best: boolean;
+  readonly feedback: string | null;
 } | {
   readonly kind: 'accepted';
   readonly worktreePath: string;
   readonly verified: boolean;
+  /** One-based shot whose tree was put back into the worktree because it
+   *  outranked the tree on disk; null when the tree on disk is the one that
+   *  ships. Non-null is the record that best-of-n moved bytes rather than
+   *  only ranking them. */
+  readonly restoredFromShot: number | null;
 } | {
   readonly kind: 'setup-error';
   readonly worktreePath: string;
@@ -144,8 +186,10 @@ interface AgenticGeneratorOptions {
   /** Verify the worktree after each dirtying shot. When set, a candidate that
    *  fails verification is NOT returned — the failure feeds the next shot
    *  (verify-in-session), up to `maxShots`; a candidate that never verifies is
-   *  discarded (`applied:false`), never shipped. Omitted means the first dirty
-   *  shot is the candidate. See `commandVerifier`. */
+   *  discarded (`applied:false`), never shipped. A verifier that returns
+   *  `keepGoing` passes a tree AND spends the remaining shots, and the
+   *  best-scoring tree is the one that ships. Omitted means the first dirty
+   *  shot is the candidate. See `commandVerifier` and `VerifyResult`. */
   verify?: Verifier;
   /** Test seam — inject the worktree-dirty check (defaults to `git status`). */
   isDirty?: (worktreePath: string) => boolean;
@@ -550,4 +594,4 @@ declare function defaultRedactor(value: unknown): unknown;
 declare function resolveRedactor(redact: Redactor | false | undefined): Redactor;
 //#endregion
 export { agenticGenerator as $, ImprovementCandidate as A, ImprovementProfilePopulationLineage as B, ImproveProfileComponents as C, ImproveScenarioPartitions as D, ImproveRuntimeCodeGeneratorOptions as E, ImprovementProfileCandidatePopulationAvailable as F, ReadonlyAgentProfile as G, ImprovementProfilePopulationObservationSource as H, ImprovementProfileCandidatePopulationUnavailable as I, AgenticGeneratorShotDisposition as J, AgenticGeneratorExecutorForWorktree as K, ImprovementProfilePopulationArtifactSource as L, ImprovementMaterializedProfilePopulationCandidate as M, ImprovementProfileCandidate as N, ImproveSkillsOptions as O, ImprovementProfileCandidatePopulation as P, VerifyResult as Q, ImprovementProfilePopulationCandidate as R, ImproveProfileAgent as S, ImproveResult as T, ImprovementRefusedProfilePopulationCandidate as U, ImprovementProfilePopulationLineageNode as V, DeepReadonly as W, AgenticGeneratorShotReceipt as X, AgenticGeneratorShotExecution as Y, Verifier as Z, ImproveMethodOptions as _, ImproveCandidateValidationInput as a, ImproveOptimizationRunOptions as b, ImproveCodeOptions as c, ImproveCost as d, commandVerifier as et, ImproveCustomCodeGeneratorOptions as f, ImproveMethodLineage as g, ImproveMethodFactory as h, improve as i, ImprovementCodeCandidate as j, ImproveSurface as k, ImproveCodeResult as l, ImproveMethodContext as m, defaultRedactor as n, CandidateGenerator as nt, ImproveCandidateValidator as o, ImproveLineage as p, AgenticGeneratorOptions as q, resolveRedactor as r, ImproveCodeBaseOptions as s, Redactor as t, defaultBuildPrompt as tt, ImproveCodeRunOptions as u, ImproveMethodResult as v, ImproveProfileSurface as w, ImproveOptions as x, ImproveMethodSource as y, ImprovementProfilePopulationCandidateSource as z };
-//# sourceMappingURL=redact-6S20u4Ii.d.ts.map
+//# sourceMappingURL=redact-DvLf4x1m.d.ts.map

package/dist/testing.js

@@ -1,12 +1,12 @@
 import { ct as immutableCandidateValue, et as parseExactAgentProfile, it as canonicalCandidateDigest$1, q as applyExactAgentProfileDiff } from "./prepare-BAyaNoZu.js";
-import { f as verifyAgentImprovementProposal } from "./improvement-cycle-lP-F7B60.js";
+import { f as verifyAgentImprovementProposal } from "./improvement-cycle-BZH9dewp.js";
 import { c as supervisorAgentWithTestBrain, ft as driverAgent, r as superviseWithTestBrain } from "./supervise-Dq_D3QbE.js";
 import { i as runGraphWithTestBrain } from "./graph-CoSt0kup.js";
 import { SANDBOX_SIZE_PRESET_NAMES } from "@tangle-network/agent-interface";
 //#region src/testing/fixtures/agent-improvement-proposal.json
 var agent_improvement_proposal_default = {
 	changedSurfaces: ["prompt"],
-	digest: "sha256:3c686da480353cc11747a45c7250f7cc49f081cdb98ac9b1108540ac19513468",
+	digest: "sha256:fb623d9857d9aa2e1655ec5b1b773f4ba1722af5d41381a6877a6707b8f8fefa",
 	evaluation: {
 		"decision": {
 			"contributingChecks": [
@@ -4577,7 +4577,7 @@ var agent_improvement_proposal_default = {
 		],
 		"metadata": {
 			"fixture": "agent-improvement-proposal",
-			"runtimeVersion": "0.173.0"
+			"runtimeVersion": "0.174.0"
 		},
 		"objectives": [
 			{
@@ -4688,8 +4688,8 @@ var agent_improvement_proposal_default = {
 			"baselineContentHash": "sha256:5c21ee53e513fc604cb09754e21c392b24a424da0ef37dbf8f1ee4a8a0b08f09",
 			"candidateContentHash": "sha256:60fcbb1c728194bd51d7d19cb732d1c3f1881dce7e0a6266b41c8b98cfd65693",
 			"kind": "agent-eval-loop",
-			"recordDigest": "sha256:cf79cfe76194bd2d120d247945b3f4af2ca24f05f7300d1dd829e92ae058babd",
-			"runId": "agent-runtime-0.173.0-proposal-fixture",
+			"recordDigest": "sha256:230b0be2647416eda41912e403fb94ba81bb2e2acb3026985b3e9a085f2c615d",
+			"runId": "agent-runtime-0.174.0-proposal-fixture",
 			"schema": "agent-candidate-experiment"
 		}
 	},
@@ -4712,13 +4712,13 @@ var agent_improvement_proposal_default = {
 	}],
 	kind: "agent-improvement-proposal",
 	proposedAt: "2026-07-10T01:00:00.000Z",
-	runId: "agent-runtime-0.173.0-proposal-fixture"
+	runId: "agent-runtime-0.174.0-proposal-fixture"
 };
 //#endregion
 //#region src/testing/fixtures/agent-profile-improvement-proposal.json
 var agent_profile_improvement_proposal_default = {
 	changedSurfaces: ["prompt", "skills"],
-	digest: "sha256:24ef0f56f54f5f1cf2a8eae14b5d7375494566ae00bfeaf38e60fb0fede31387",
+	digest: "sha256:d190ec44331b7a6223e18a5b6dd0bfb8281dc998365c09dde811b4c94acf6100",
 	evaluation: {
 		"decision": {
 			"contributingChecks": [
@@ -6352,7 +6352,7 @@ var agent_profile_improvement_proposal_default = {
 		],
 		"metadata": {
 			"fixture": "agent-profile-improvement-proposal",
-			"runtimeVersion": "0.173.0"
+			"runtimeVersion": "0.174.0"
 		},
 		"objectives": [
 			{
@@ -6463,7 +6463,7 @@ var agent_profile_improvement_proposal_default = {
 			"baselineContentHash": "sha256:21c495a37c418c10bde64fbaa188beddeed31f1f051ea60a6a6582a9ee0db704",
 			"candidateContentHash": "sha256:103f77bc8481601eef1ad5fe6ba84a40dffabc3a44f421f8c8559121edab84e9",
 			"kind": "agent-eval-loop",
-			"recordDigest": "sha256:9c90c1b08e40421738f375cffb0aa5f3755ead1ce49e6f5c4b540a3efd8c51f3",
+			"recordDigest": "sha256:d88298a446b40eea656d343f6f80169c04df2725c21bdceb22ce21b38c2958e2",
 			"runId": "profile-improvement-1",
 			"schema": "agent-profile-improvement-experiment"
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-runtime",
-  "version": "0.173.0",
+  "version": "0.174.0",
   "description": "Shared task-lifecycle skeleton for agents: a recursive loop kernel for chat turns, one-shot tasks, and multi-attempt loops, with trace capture and eval-gated self-improvement. Domain behavior lives in adapters; scoring and ship-gates in @tangle-network/agent-eval.",
   "homepage": "https://github.com/tangle-network/agent-runtime#readme",
   "repository": {