@tangle-network/agent-runtime 0.93.2 → 0.94.1

package/dist/intelligence.d.ts

@@ -1,16 +1,16 @@
 import { AgentProfile, AgentCandidateBundle, Sha256Digest, AgentProfileDiff, AgentProfileMcpServer } from '@tangle-network/agent-interface';
-import { g as LoopTraceEvent, b as RuntimeStreamEvent } from './types-B00NtbCs.js';
-import { b as ToolSpec, c as RuntimeTelemetryOptions } from './sanitize-C9go6tXj.js';
+import { f as LoopTraceEvent, a as RuntimeStreamEvent } from './types-DWA64rbJ.js';
+import { b as ToolSpec, c as RuntimeTelemetryOptions } from './sanitize-C2jicjNf.js';
 import { AnalystFinding } from '@tangle-network/agent-eval/analyst';
 import { Scenario, SelfImproveResult } from '@tangle-network/agent-eval/contract';
 import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-BC3bZpH0.js';
-import { A as AgentCandidateTaskExecution, a as AgentCandidateExecutionPorts, P as PrepareAgentCandidateExecutionOptions, E as ExecutePreparedAgentCandidateOptions, b as AgentCandidateRunFinalization, c as AgentCandidateBundleInput } from './prepare-DiVGKcwS.js';
-import { I as ImproveSurface, a as ImproveOptions, b as ImproveResult } from './improve-DDhQaaJT.js';
+import { A as AgentCandidateBundleInput, a as AgentCandidateTaskExecution, b as AgentCandidateExecutionPorts, P as PrepareAgentCandidateExecutionOptions, E as ExecutePreparedAgentCandidateOptions, c as AgentCandidateRunFinalization } from './prepare-BKxAiUcH.js';
+import { I as ImproveSurface, a as ImproveOptions, b as ImproveResult } from './improve-r8SvIxYv.js';
 import '@tangle-network/agent-eval';
 import '@tangle-network/sandbox';
-import './local-harness-dcD5WTTr.js';
+import './local-harness-B7bNuNJw.js';
 import 'node:child_process';
-import './agentic-generator-B8oeE2Yv.js';
+import './agentic-generator-D9ZmAuiL.js';
 import '@tangle-network/agent-eval/campaign';
 
 /**
@@ -133,6 +133,7 @@ interface AgentImprovementProposal<TScenario extends Scenario = Scenario, TArtif
     runId: string;
     surface: ImproveSurface;
     proposedAt: string;
+    baselineProfile: AgentProfile;
     baselineProfileHash: string;
     candidateProfile: AgentProfile;
     candidateProfileHash: string;
@@ -185,6 +186,16 @@ interface ProposeAgentImprovementResult<TScenario extends Scenario, TArtifact> {
     improvement: ImproveResult<TScenario, TArtifact>;
     proposal: AgentImprovementProposal<TScenario, TArtifact>;
 }
+interface CreateAgentImprovementProposalOptions<TScenario extends Scenario, TArtifact> {
+    runId: string;
+    surface: ImproveSurface;
+    baselineProfile: AgentProfile;
+    candidateProfile: AgentProfile;
+    findings: readonly AnalystFinding[];
+    evaluation: SelfImproveResult<TScenario, TArtifact>;
+    candidateBundle?: AgentCandidateBundleInput | AgentCandidateBundle;
+    now?: () => Date;
+}
 interface ReviewAgentImprovementInput {
     decision: AgentImprovementReviewDecision;
     reviewedBy: string;
@@ -208,6 +219,12 @@ interface ExecuteApprovedAgentCandidateResult {
 }
 /** Analyze one run and produce one measured, review-only improvement proposal. */
 declare function proposeAgentImprovement<TScenario extends Scenario, TArtifact>(options: ProposeAgentImprovementOptions<TScenario, TArtifact>): Promise<ProposeAgentImprovementResult<TScenario, TArtifact>>;
+/**
+ * Freeze an already-measured improvement into the one reviewable proposal
+ * contract. Products that run analysis or evaluation in separate workers use
+ * this constructor instead of rerunning either phase or rebuilding digests.
+ */
+declare function createAgentImprovementProposal<TScenario extends Scenario, TArtifact>(options: CreateAgentImprovementProposalOptions<TScenario, TArtifact>): AgentImprovementProposal<TScenario, TArtifact>;
 /** Persist an approve/reject/change-request decision bound to one exact proposal. */
 declare function reviewAgentImprovementProposal(inputProposal: AgentImprovementProposal, input: ReviewAgentImprovementInput): AgentImprovementReview;
 /** Verify, materialize, run, grade, and receipt only the exact approved bundle. */
@@ -1213,4 +1230,4 @@ interface DoctorReport {
  */
 declare function createIntelligenceClient(config: IntelligenceConfig): IntelligenceClient;
 
-export { type AgentImprovementEvaluation, type AgentImprovementProposal, type AgentImprovementReview, type AgentImprovementReviewDecision, type AppliedIntelligence, type CandidateExecutionEvidence, type CapabilityAuth, type CapabilityInterface, type CapabilityManifest, CapabilityNotAdmittedError, type CapabilitySurface, type CertProvenance, type CertifiedArtifact, type CertifiedCapability, type CertifiedCapabilitySummary, type CertifiedProfile, type CertifiedPromptSource, type CertifiedPromptSourceOptions, type CertifiedPromptSurface, type ContentRef, type CorpusAccess, type CredentialRef, type DeliveryBinding, type DeliveryBindingKind, type DiffProvenance, type DoctorReport, type EffortOverrides, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExecuteApprovedAgentCandidateOptions, type ExecuteApprovedAgentCandidateResult, type HostSpec, type IntelligenceAgent, type IntelligenceClient, type IntelligenceConfig, type IntelligenceHookConfig, type IntelligenceWrapped, type JsonSchema, type ModeReadiness, type ProposeAgentImprovementOptions, type ProposeAgentImprovementResult, type ProposedProfileDiff, type ProvisionedHost, type PullCertifiedOptions, type PullOutcome, type RecordTraceMeta, type Redactor, type RepoConfig, type ResolveCtx, type ResolvedHook, type ResolvedRetrieval, type ResolvedSubagent, type ResolvedSurface, type ReviewAgentImprovementInput, type RunRecord, type RunReport, type TraceHandle, type TraceMeta, type TraceOutcome, type UsageClass, type UsageSplit, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createCertifiedPromptSource, createIntelligenceClient, defaultEffortTier, defaultRedactor, executeApprovedAgentCandidate, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, proposeAgentImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, verifyAgentImprovementProposal, verifyAgentImprovementReview, withIntelligence };
+export { type AgentImprovementEvaluation, type AgentImprovementProposal, type AgentImprovementReview, type AgentImprovementReviewDecision, type AppliedIntelligence, type CandidateExecutionEvidence, type CapabilityAuth, type CapabilityInterface, type CapabilityManifest, CapabilityNotAdmittedError, type CapabilitySurface, type CertProvenance, type CertifiedArtifact, type CertifiedCapability, type CertifiedCapabilitySummary, type CertifiedProfile, type CertifiedPromptSource, type CertifiedPromptSourceOptions, type CertifiedPromptSurface, type ContentRef, type CorpusAccess, type CreateAgentImprovementProposalOptions, type CredentialRef, type DeliveryBinding, type DeliveryBindingKind, type DiffProvenance, type DoctorReport, type EffortOverrides, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExecuteApprovedAgentCandidateOptions, type ExecuteApprovedAgentCandidateResult, type HostSpec, type IntelligenceAgent, type IntelligenceClient, type IntelligenceConfig, type IntelligenceHookConfig, type IntelligenceWrapped, type JsonSchema, type ModeReadiness, type ProposeAgentImprovementOptions, type ProposeAgentImprovementResult, type ProposedProfileDiff, type ProvisionedHost, type PullCertifiedOptions, type PullOutcome, type RecordTraceMeta, type Redactor, type RepoConfig, type ResolveCtx, type ResolvedHook, type ResolvedRetrieval, type ResolvedSubagent, type ResolvedSurface, type ReviewAgentImprovementInput, type RunRecord, type RunReport, type TraceHandle, type TraceMeta, type TraceOutcome, type UsageClass, type UsageSplit, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createAgentImprovementProposal, createCertifiedPromptSource, createIntelligenceClient, defaultEffortTier, defaultRedactor, executeApprovedAgentCandidate, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, proposeAgentImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, verifyAgentImprovementProposal, verifyAgentImprovementReview, withIntelligence };

package/dist/intelligence.js

@@ -1,6 +1,7 @@
 import {
+  applyImprovementWinnerToProfile,
   improve
-} from "./chunk-WGR6QJ5H.js";
+} from "./chunk-SJHFJOCY.js";
 import {
   assertCandidateProfileBinding,
   canonicalCandidateDigest,
@@ -12,22 +13,21 @@ import {
   prepareAgentCandidateExecution,
   sealAgentCandidateBundle,
   verifyAgentCandidateBundle
-} from "./chunk-OX3QRJOA.js";
-import "./chunk-FDJ7AHXG.js";
+} from "./chunk-KHLE3C5G.js";
 import {
   runAnalystLoop
 } from "./chunk-ZQZX77MM.js";
-import "./chunk-RTVVH2KL.js";
+import "./chunk-JEP2WM24.js";
 import {
   buildLoopOtelSpans,
   buildRuntimeEventOtelSpans,
   createOtelExporter,
   flatOtelSpan
-} from "./chunk-J2K6WIG6.js";
-import "./chunk-3D2RHC4K.js";
+} from "./chunk-ISTDY47H.js";
+import "./chunk-WIPGQ4GT.js";
 import "./chunk-3MDZX7YU.js";
 import "./chunk-FVJ7M3DA.js";
-import "./chunk-PX6SXX3M.js";
+import "./chunk-PJNGPWTA.js";
 import "./chunk-YEJR7IXO.js";
 import "./chunk-DGUM43GV.js";
 
@@ -433,26 +433,61 @@ async function proposeAgentImprovement(options) {
     "proposeAgentImprovement findings"
   );
   const improvement = await improve(options.profile, [...findings], options.improvement);
-  const candidateBundle = improvement.shipped && options.buildCandidate ? sealBuiltCandidate(await options.buildCandidate({ analysis, improvement })) : void 0;
-  if (candidateBundle) assertCandidateProfileBinding(improvement.profile, candidateBundle.profile);
-  const surface = options.improvement.surface ?? "prompt";
-  const evaluation = canonicalJsonValue(improvementEvaluation(improvement.raw));
-  const proposalFindings = canonicalJsonValue([...findings]);
+  const candidateBundle = improvement.shipped && options.buildCandidate ? await options.buildCandidate({ analysis, improvement }) : void 0;
+  const proposal = createAgentImprovementProposal({
+    runId: options.runId,
+    surface: options.improvement.surface ?? "prompt",
+    baselineProfile: options.profile,
+    candidateProfile: improvement.profile,
+    findings,
+    evaluation: improvement.raw,
+    ...candidateBundle ? { candidateBundle } : {},
+    ...options.now ? { now: options.now } : {}
+  });
+  return { analysis, improvement, proposal };
+}
+function createAgentImprovementProposal(options) {
+  const findings = assertNoJudgeVerdict(
+    [...options.findings],
+    "createAgentImprovementProposal findings"
+  );
+  const candidateBundle = options.candidateBundle ? sealBuiltCandidate(options.candidateBundle) : void 0;
+  const baselineProfile = parseExactAgentProfile(
+    options.baselineProfile,
+    "proposal baseline profile"
+  );
+  const candidateProfile = parseExactAgentProfile(
+    options.candidateProfile,
+    "proposal candidate profile"
+  );
+  assertMeasuredProfileBinding({
+    surface: options.surface,
+    baselineProfile,
+    candidateProfile,
+    evaluation: options.evaluation,
+    hasExecutableBundle: candidateBundle !== void 0
+  });
+  if (candidateBundle) {
+    if (options.evaluation.gateDecision !== "ship") {
+      throw new Error("executable candidate bundle requires a passing measured comparison");
+    }
+    assertCandidateProfileBinding(candidateProfile, candidateBundle.profile);
+  }
   const withoutDigest = {
     schemaVersion: 1,
     kind: "agent-improvement-proposal",
     runId: options.runId,
-    surface,
+    surface: options.surface,
     proposedAt: (options.now ?? (() => /* @__PURE__ */ new Date()))().toISOString(),
-    baselineProfileHash: canonicalCandidateDigest(options.profile),
-    candidateProfile: improvement.profile,
-    candidateProfileHash: canonicalCandidateDigest(improvement.profile),
-    findings: proposalFindings,
-    evaluation,
+    baselineProfile,
+    baselineProfileHash: canonicalCandidateDigest(baselineProfile),
+    candidateProfile,
+    candidateProfileHash: canonicalCandidateDigest(candidateProfile),
+    findings: canonicalJsonValue([...findings]),
+    evaluation: canonicalJsonValue(improvementEvaluation(options.evaluation)),
     ...candidateBundle ? { candidateBundle } : {}
   };
-  const proposal = canonicalCandidateDocument(withoutDigest).value;
-  return { analysis, improvement, proposal };
+  return canonicalCandidateDocument(withoutDigest).value;
 }
 function reviewAgentImprovementProposal(inputProposal, input) {
   const proposal = verifyAgentImprovementProposal(inputProposal);
@@ -521,6 +556,13 @@ function verifyAgentImprovementProposal(input) {
     throw new Error("invalid agent improvement proposal");
   }
   const proposal = input;
+  const parsedBaselineProfile = parseExactAgentProfile(
+    proposal.baselineProfile,
+    "proposal baseline profile"
+  );
+  if (proposal.baselineProfileHash !== canonicalCandidateDigest(parsedBaselineProfile)) {
+    throw new Error("proposal baselineProfileHash does not match baselineProfile");
+  }
   const parsedProfile = parseExactAgentProfile(
     proposal.candidateProfile,
     "proposal candidate profile"
@@ -528,6 +570,13 @@ function verifyAgentImprovementProposal(input) {
   if (proposal.candidateProfileHash !== canonicalCandidateDigest(parsedProfile)) {
     throw new Error("proposal candidateProfileHash does not match candidateProfile");
   }
+  assertMeasuredProfileBinding({
+    surface: proposal.surface,
+    baselineProfile: parsedBaselineProfile,
+    candidateProfile: parsedProfile,
+    evaluation: proposal.evaluation,
+    hasExecutableBundle: proposal.candidateBundle !== void 0
+  });
   if (!Array.isArray(proposal.findings)) throw new Error("proposal findings must be an array");
   if (!isSha256Digest(proposal.digest)) throw new Error("proposal digest is invalid");
   if (proposal.candidateBundle) {
@@ -542,6 +591,50 @@ function verifyAgentImprovementProposal(input) {
     throw new Error("agent improvement proposal digest does not match");
   return immutableCandidateValue(proposal);
 }
+function assertMeasuredProfileBinding(input) {
+  const baselineDigest = canonicalCandidateDigest(input.baselineProfile);
+  if (input.evaluation.gateDecision !== "ship") {
+    if (canonicalCandidateDigest(input.candidateProfile) !== baselineDigest) {
+      throw new Error("non-shipping evaluation must retain the baseline candidate profile");
+    }
+    return;
+  }
+  const measured = measuredWinnerProfile(
+    input.baselineProfile,
+    input.surface,
+    input.evaluation.winner.surface
+  );
+  if (!measured) {
+    if (input.hasExecutableBundle) {
+      throw new Error(
+        `executable '${input.surface}' candidate cannot be bound to its measured winner surface`
+      );
+    }
+    if (canonicalCandidateDigest(input.candidateProfile) !== baselineDigest) {
+      throw new Error(
+        `unbound '${input.surface}' improvement must retain the baseline candidate profile`
+      );
+    }
+    return;
+  }
+  if (canonicalCandidateDigest(input.candidateProfile) !== canonicalCandidateDigest(measured)) {
+    throw new Error("proposal candidate profile does not match the measured winner surface");
+  }
+}
+function measuredWinnerProfile(baselineProfile, surface, winner) {
+  if (surface === "code" || surface === "memory") return null;
+  if (typeof winner !== "string") {
+    throw new Error(`measured '${surface}' winner is not a serializable profile surface`);
+  }
+  if (surface !== "skills") {
+    return applyImprovementWinnerToProfile(baselineProfile, surface, winner);
+  }
+  try {
+    return applyImprovementWinnerToProfile(baselineProfile, surface, winner);
+  } catch {
+    return null;
+  }
+}
 function sealBuiltCandidate(input) {
   if (!("digest" in input)) return sealAgentCandidateBundle(input);
   const parsed = agentCandidateBundleSchema.parse(input);
@@ -1420,6 +1513,7 @@ export {
   composeCertifiedProfile,
   composeCertifiedProfileFromWire,
   composeCertifiedPrompt,
+  createAgentImprovementProposal,
   createCertifiedPromptSource,
   createIntelligenceClient,
   defaultEffortTier,