@tangle-network/agent-runtime 0.92.1 → 0.93.0

package/dist/intelligence.d.ts

@@ -1,11 +1,11 @@
-import { AgentCandidateBundle, AgentProfile, Sha256Digest, AgentProfileDiff, AgentProfileMcpServer } from '@tangle-network/agent-interface';
+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 { 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 } from './prepare-Z08a4heC.js';
-import { I as ImproveSurface, a as ImproveOptions, b as ImproveResult } from './improve-CUVCq7xg.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 '@tangle-network/agent-eval';
 import '@tangle-network/sandbox';
 import './local-harness-dcD5WTTr.js';
@@ -126,8 +126,6 @@ interface EffortOverridesCompiled {
  */
 declare function compileEffort(settings: EffortSettings): EffortOverridesCompiled;
 
-type AgentCandidateBundleInput = Omit<AgentCandidateBundle, 'digest'>;
-
 type AgentImprovementEvaluation<TScenario extends Scenario, TArtifact> = Pick<SelfImproveResult<TScenario, TArtifact>, 'baseline' | 'winner' | 'lift' | 'diff' | 'provenance' | 'gateDecision' | 'generationsExplored' | 'durationMs' | 'totalCostUsd' | 'insight' | 'power'>;
 interface AgentImprovementProposal<TScenario extends Scenario = Scenario, TArtifact = unknown> {
     schemaVersion: 1;
@@ -173,13 +171,13 @@ interface ProposeAgentImprovementOptions<TScenario extends Scenario, TArtifact>
     improvement: ImproveOptions<TScenario, TArtifact>;
     /**
      * Optional environment adapter that freezes an executable bundle after the
-     * measured comparison recommends the candidate. Runtime validates and
-     * computes the bundle digest; adapters never implement hashing themselves.
+     * measured comparison recommends the candidate. Return the sealed output of
+     * `buildAgentCandidateBundle` directly, or a low-level digest-free input.
      */
     buildCandidate?: (input: {
         analysis: RunAnalystLoopResult;
         improvement: ImproveResult<TScenario, TArtifact>;
-    }) => AgentCandidateBundleInput | Promise<AgentCandidateBundleInput>;
+    }) => AgentCandidateBundleInput | AgentCandidateBundle | Promise<AgentCandidateBundleInput | AgentCandidateBundle>;
     now?: () => Date;
 }
 interface ProposeAgentImprovementResult<TScenario extends Scenario, TArtifact> {

package/dist/intelligence.js

@@ -1,16 +1,18 @@
 import {
   improve
-} from "./chunk-4FPXIMSI.js";
+} from "./chunk-VMHKMNEU.js";
 import {
-  canonicalCandidateBytes,
+  assertCandidateProfileBinding,
   canonicalCandidateDigest,
   canonicalCandidateDocument,
   executePreparedAgentCandidate,
   immutableCandidateValue,
   omitTopLevelDigest,
+  parseExactAgentProfile,
   prepareAgentCandidateExecution,
+  sealAgentCandidateBundle,
   verifyAgentCandidateBundle
-} from "./chunk-A62TP7SK.js";
+} from "./chunk-26WCEARH.js";
 import "./chunk-FDJ7AHXG.js";
 import {
   runAnalystLoop
@@ -414,24 +416,13 @@ function isJsonSchema(v) {
 
 // src/intelligence/improvement-cycle.ts
 import { assertNoJudgeVerdict } from "@tangle-network/agent-eval/analyst";
-import { agentCandidateBundleSchema as agentCandidateBundleSchema2, agentProfileSchema } from "@tangle-network/agent-interface";
-
-// src/candidate-execution/bundle.ts
 import { agentCandidateBundleSchema } from "@tangle-network/agent-interface";
-function sealAgentCandidateBundle(input) {
-  const digest = canonicalCandidateDigest(input);
-  const parsed = agentCandidateBundleSchema.parse({ ...input, digest });
-  const parsedDigest = canonicalCandidateDigest(omitTopLevelDigest(parsed));
-  if (parsedDigest !== digest) {
-    throw new Error("candidate bundle changed while validating its canonical wire shape");
-  }
-  return immutableCandidateValue(parsed);
-}
-
-// src/intelligence/improvement-cycle.ts
 async function proposeAgentImprovement(options) {
-  if (options.improvement.skills?.writeBack) {
-    throw new Error("proposeAgentImprovement cannot write a skill before human approval");
+  const writeBackSurface = options.improvement.skills?.writeBack ? "skill" : options.improvement.memory?.writeBack ? "memory" : null;
+  if (writeBackSurface) {
+    throw new Error(
+      `proposeAgentImprovement cannot write ${writeBackSurface} before human approval`
+    );
   }
   const analysis = await runAnalystLoop({
     ...options.analysis,
@@ -442,7 +433,7 @@ async function proposeAgentImprovement(options) {
     "proposeAgentImprovement findings"
   );
   const improvement = await improve(options.profile, [...findings], options.improvement);
-  const candidateBundle = improvement.shipped && options.buildCandidate ? sealAgentCandidateBundle(await options.buildCandidate({ analysis, improvement })) : void 0;
+  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));
@@ -530,14 +521,17 @@ function verifyAgentImprovementProposal(input) {
     throw new Error("invalid agent improvement proposal");
   }
   const proposal = input;
-  const parsedProfile = parseExactAgentProfile(proposal.candidateProfile);
+  const parsedProfile = parseExactAgentProfile(
+    proposal.candidateProfile,
+    "proposal candidate profile"
+  );
   if (proposal.candidateProfileHash !== canonicalCandidateDigest(parsedProfile)) {
     throw new Error("proposal candidateProfileHash does not match candidateProfile");
   }
   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) {
-    const parsedBundle = agentCandidateBundleSchema2.parse(proposal.candidateBundle);
+    const parsedBundle = agentCandidateBundleSchema.parse(proposal.candidateBundle);
     const sealed = sealAgentCandidateBundle(omitTopLevelDigest(parsedBundle));
     if (sealed.digest !== parsedBundle.digest)
       throw new Error("proposal candidate bundle digest is invalid");
@@ -548,116 +542,14 @@ function verifyAgentImprovementProposal(input) {
     throw new Error("agent improvement proposal digest does not match");
   return immutableCandidateValue(proposal);
 }
-function parseExactAgentProfile(input) {
-  const parsed = agentProfileSchema.parse(input);
-  if (!Buffer.from(canonicalCandidateBytes(input)).equals(
-    Buffer.from(canonicalCandidateBytes(parsed))
-  )) {
-    throw new Error("proposal candidate profile contains fields unsupported by sealed candidates");
-  }
-  return parsed;
-}
-function assertCandidateProfileBinding(measuredInput, bundled) {
-  const measured = parseExactAgentProfile(measuredInput);
-  if (measured.connections || measured.metadata || measured.extensions) {
-    throw new Error("proposal candidate profile contains fields unsupported by sealed candidates");
-  }
-  const normalized = candidateProfileAsAgentProfile(bundled);
-  if (canonicalCandidateDigest(measured) !== canonicalCandidateDigest(normalized)) {
-    throw new Error("proposal candidateProfile does not match candidateBundle.profile");
-  }
-}
-function candidateProfileAsAgentProfile(candidate) {
-  const value = candidate;
-  const output = {};
-  for (const key of [
-    "name",
-    "description",
-    "version",
-    "tags",
-    "prompt",
-    "harness",
-    "permissions",
-    "tools",
-    "confidential"
-  ]) {
-    if (value[key] !== void 0) output[key] = value[key];
-  }
-  if (candidate.model) output.model = { ...candidate.model };
-  if (candidate.mcp) {
-    output.mcp = Object.fromEntries(
-      Object.entries(candidate.mcp).map(([name, server]) => [
-        name,
-        {
-          ...server,
-          ...server.args ? { args: server.args.map(publicValue) } : {},
-          ...server.env ? { env: mapPublicValues(server.env) } : {}
-        }
-      ])
-    );
-  }
-  if (candidate.subagents) output.subagents = mapRecord(candidate.subagents);
-  if (candidate.modes) output.modes = mapRecord(candidate.modes);
-  if (candidate.hooks) {
-    output.hooks = Object.fromEntries(
-      Object.entries(candidate.hooks).map(([event, hooks]) => [
-        event,
-        hooks.map((hook) => ({
-          ...hook,
-          command: [hook.executable, ...(hook.args ?? []).map(publicValue)].map(shellQuote).join(" "),
-          ...hook.env ? { env: mapPublicValues(hook.env) } : {}
-        }))
-      ])
-    );
-  }
-  if (candidate.resources) {
-    if (candidate.resources.failOnError !== true) {
-      throw new Error("proposal candidate profile contains fields unsupported by sealed candidates");
-    }
-    output.resources = {
-      failOnError: true,
-      ...candidate.resources.files ? {
-        files: candidate.resources.files.map((file) => ({
-          ...file,
-          resource: publicResource(file.resource)
-        }))
-      } : {},
-      ...candidate.resources.tools ? { tools: candidate.resources.tools.map(publicResource) } : {},
-      ...candidate.resources.skills ? { skills: candidate.resources.skills.map(publicResource) } : {},
-      ...candidate.resources.agents ? { agents: candidate.resources.agents.map(publicResource) } : {},
-      ...candidate.resources.commands ? { commands: candidate.resources.commands.map(publicResource) } : {},
-      ...candidate.resources.instructions !== void 0 ? {
-        instructions: typeof candidate.resources.instructions === "string" ? candidate.resources.instructions : publicResource(candidate.resources.instructions)
-      } : {}
-    };
-  }
-  return output;
-}
-function publicResource(resource) {
-  if (resource.kind === "inline") {
-    return { kind: "inline", name: resource.name, content: resource.content };
+function sealBuiltCandidate(input) {
+  if (!("digest" in input)) return sealAgentCandidateBundle(input);
+  const parsed = agentCandidateBundleSchema.parse(input);
+  const sealed = sealAgentCandidateBundle(omitTopLevelDigest(parsed));
+  if (sealed.digest !== parsed.digest) {
+    throw new Error("built candidate bundle digest is invalid");
   }
-  return {
-    kind: "github",
-    repository: `${resource.repository.owner}/${resource.repository.repo}`,
-    path: resource.path,
-    ref: resource.commit,
-    ...resource.name ? { name: resource.name } : {}
-  };
-}
-function publicValue(value) {
-  return value.value;
-}
-function mapPublicValues(values) {
-  return Object.fromEntries(Object.entries(values).map(([key, value]) => [key, publicValue(value)]));
-}
-function mapRecord(values) {
-  return Object.fromEntries(
-    Object.entries(values).map(([key, value]) => [key, { ...value }])
-  );
-}
-function shellQuote(value) {
-  return /^[A-Za-z0-9_./:@%+=,-]+$/.test(value) ? value : `'${value.replaceAll("'", `'"'"'`)}'`;
+  return sealed;
 }
 function verifyAgentImprovementReview(input) {
   if (!isRecord(input) || input.kind !== "agent-improvement-review" || input.schemaVersion !== 1) {