@tangle-network/agent-runtime 0.99.0 → 0.101.0

package/dist/intelligence.d.ts

@@ -1,11 +1,12 @@
-import { AgentProfileDiff, AgentProfile, AgentProfileMcpServer, AgentImprovementActivationTarget, AgentImprovementSurface, AgentCandidateExperiment, AgentImprovementActivationIntent, AgentImprovementMeasuredComparison, AgentCandidateExperimentMeasurement, AgentImprovementProposal, AgentImprovementReviewDecision, AgentCandidateBenchmarkCellRef, Sha256Digest, AgentImprovementReview, AgentImprovementActivation, CandidateExecutionEvidence } from '@tangle-network/agent-interface';
+import { AgentProfileDiff, AgentProfile, AgentProfileMcpServer, AgentImprovementActivationTarget, Sha256Digest, AgentImprovementSurface, AgentCandidateExperiment, AgentImprovementActivationIntent, AgentImprovementMeasuredComparison, AgentCandidateExperimentMeasurement, AgentImprovementProposal, AgentImprovementReviewDecision, AgentCandidateBenchmarkCellRef, AgentImprovementReview, AgentImprovementActivation, CandidateExecutionEvidence, AgentImprovementActivationTargetState, AgentImprovementActivationTargetTransition } from '@tangle-network/agent-interface';
 export { AgentImprovementActivation, AgentImprovementActivationIntent, AgentImprovementActivationOutcome, AgentImprovementActivationResult, AgentImprovementMeasuredComparison, AgentImprovementProposal, AgentImprovementReview, AgentImprovementReviewDecision, CandidateExecutionEvidence, AgentCandidateProfileActivation as CandidateProfileMaterialization } from '@tangle-network/agent-interface';
 import { b as LoopTraceEvent } from './types-B3vAW0Oq.js';
 import { b as ToolSpec, c as RuntimeTelemetryOptions } from './sanitize-BTSsdBXw.js';
 import { R as RuntimeStreamEvent } from './types-BwoZWq-i.js';
 import { P as PrepareAgentCandidateExecutionOptions, E as ExecutePreparedAgentCandidateOptions, A as AgentCandidateExecutionClaimStore } from './profile-DbfaMTdk.js';
 export { p as parseCandidateProfileMaterialization } from './profile-DbfaMTdk.js';
-export { A as AgentImprovementActivationReconciliation, a as AgentImprovementActivationResultStore, b as AgentImprovementActivationTargetPlan, c as AgentImprovementActivationTransition, d as AgentImprovementActivationTransitionInput, C as CreateAgentImprovementActivationResultOptions, E as ExecuteAgentImprovementActivationInput, e as ExecuteAgentImprovementActivationOptions, f as createAgentImprovementActivationResult, g as executeAgentImprovementActivation, v as verifyAgentImprovementActivationResult } from './activation-Cdp4wKQ0.js';
+import { A as AgentImprovementActivationTargetPlan } from './activation-Cm-9MMX1.js';
+export { a as AgentImprovementActivationReconciliation, b as AgentImprovementActivationResultStore, c as AgentImprovementActivationTransition, d as AgentImprovementActivationTransitionInput, C as CreateAgentImprovementActivationResultOptions, E as ExecuteAgentImprovementActivationInput, e as ExecuteAgentImprovementActivationOptions, f as createAgentImprovementActivationResult, g as executeAgentImprovementActivation, v as verifyAgentImprovementActivationResult } from './activation-Cm-9MMX1.js';
 import { AnalystFinding } from '@tangle-network/agent-eval/analyst';
 import { CandidateExperimentExecutionInput, Scenario, CompareCandidateExperimentOptions } from '@tangle-network/agent-eval/contract';
 import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-CmYCMbFT.js';
@@ -645,6 +646,15 @@ type AgentImprovementActivationTargetIdentity = Pick<AgentImprovementActivationT
 declare function buildAgentImprovementActivationTargets(surfaces: readonly AgentImprovementSurface[], experiment: AgentCandidateExperiment, intent: AgentImprovementActivationIntent, identities: readonly AgentImprovementActivationTargetIdentity[]): [AgentImprovementActivationTarget, ...AgentImprovementActivationTarget[]];
 /** Return whether a measured surface can be delivered through an agent profile. */
 declare function isAgentImprovementProfileSurface(surface: AgentImprovementSurface): surface is AgentImprovementProfileSurface;
+/**
+ * Return the canonical current-state input for one profile-deliverable improvement target.
+ * Missing slots become `null`; tools and subagents include both their direct and resource slots.
+ * Unrelated profile fields are excluded. The result matches `agentImprovementTargetInput` for the
+ * same profile inside a candidate bundle.
+ */
+declare function agentImprovementProfileSurfaceInput(profile: AgentProfile, surface: AgentImprovementProfileSurface): unknown;
+/** Return the `Sha256Digest` of one profile surface using Runtime's canonical candidate digest. */
+declare function agentImprovementProfileSurfaceDigest(profile: AgentProfile, surface: AgentImprovementProfileSurface): Sha256Digest;
 /**
  * Replace one measured profile surface exactly, including array-valued resources.
  * Apply the returned diffs in order: a diff applies its set before its removal,
@@ -767,6 +777,48 @@ declare function verifyAgentImprovementActivation(input: {
 /** Recheck one Runtime receipt against its exact signed experiment cell. */
 declare function verifyCandidateExecutionEvidence(input: unknown, options: VerifyCandidateExecutionEvidenceOptions): CandidateExecutionEvidence;
 
+type AgentImprovementProfileActivationTarget = Omit<AgentImprovementActivationTargetPlan, 'surface'> & {
+    surface: AgentImprovementProfileSurface;
+};
+type AgentImprovementProfileTargetState = Omit<AgentImprovementActivationTargetState, 'surface'> & {
+    surface: AgentImprovementProfileSurface;
+};
+type AgentImprovementProfileTargetTransition = Omit<AgentImprovementActivationTargetTransition, 'surface'> & {
+    surface: AgentImprovementProfileSurface;
+};
+interface AgentImprovementProfileReplacement {
+    identity: string;
+    profile: AgentProfile;
+}
+type AgentImprovementProfileActivationPreparation = {
+    status: 'missing';
+    identities: readonly string[];
+} | {
+    status: 'already-applied' | 'conflict';
+    targets: [AgentImprovementProfileTargetState, ...AgentImprovementProfileTargetState[]];
+} | {
+    status: 'apply';
+    replacements: [AgentImprovementProfileReplacement, ...AgentImprovementProfileReplacement[]];
+    targets: [
+        AgentImprovementProfileTargetTransition,
+        ...AgentImprovementProfileTargetTransition[]
+    ];
+};
+/**
+ * Compare product-owned profiles with an exact measured transition and prepare
+ * the all-or-none replacements. The caller owns locking, persistence, and the
+ * durable activation receipt; this function owns profile semantics only.
+ * Profiles stay in product-owned stores, so this returns replacements instead
+ * of owning the transition callbacks used by Runtime-owned knowledge stores.
+ */
+declare function prepareAgentImprovementProfileActivation(input: {
+    currentByIdentity: ReadonlyMap<string, AgentProfile>;
+    targets: readonly [
+        AgentImprovementProfileActivationTarget,
+        ...AgentImprovementProfileActivationTarget[]
+    ];
+}): AgentImprovementProfileActivationPreparation;
+
 /**
  *
  * The capability resolver — the ONLY place that knows binding kinds. It lowers a
@@ -1315,4 +1367,4 @@ interface DoctorReport {
  */
 declare function createIntelligenceClient(config: IntelligenceConfig): IntelligenceClient;
 
-export { AGENT_IMPROVEMENT_PROFILE_SURFACES, AgentCandidateExperimentCellExecutionError, type AgentCandidateExperimentCellPlacement, type AgentImprovementActivationTargetIdentity, type AgentImprovementProfileSurface, type AgentImprovementTargetProfileDiffOptions, type AppliedIntelligence, 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 CreateAgentImprovementActivationOptions, type CreateAgentImprovementProposalOptions, type CreateSandboxCandidateExperimentExecutorOptions, type CredentialRef, type DeliveryBinding, type DeliveryBindingKind, type DiffProvenance, type DoctorReport, type EffortOverrides, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExecuteAgentCandidateExperimentCellOptions, 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 RunAgentCandidateExperimentOptions, type RunAgentCandidateExperimentResult, type RunRecord, type RunReport, type SandboxCandidateExperimentExecution, type SandboxCandidateExperimentExecutor, type TraceHandle, type TraceMeta, type TraceOutcome, type UsageClass, type UsageSplit, type VerifyCandidateExecutionEvidenceOptions, agentImprovementTargetProfileDiffs, buildAgentImprovementActivationTargets, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createAgentImprovementActivation, createAgentImprovementMeasuredComparison, createAgentImprovementProposal, createCertifiedPromptSource, createIntelligenceClient, createSandboxCandidateExperimentExecutor, defaultEffortTier, defaultRedactor, executeAgentCandidateExperimentCell, isAgentImprovementProfileSurface, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, proposeAgentImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, runAgentCandidateExperiment, sandboxCandidateExperimentExecutionSupport, verifyAgentImprovementActivation, verifyAgentImprovementProposal, verifyAgentImprovementReview, verifyCandidateExecutionEvidence, withIntelligence };
+export { AGENT_IMPROVEMENT_PROFILE_SURFACES, AgentCandidateExperimentCellExecutionError, type AgentCandidateExperimentCellPlacement, type AgentImprovementActivationTargetIdentity, AgentImprovementActivationTargetPlan, type AgentImprovementProfileActivationPreparation, type AgentImprovementProfileActivationTarget, type AgentImprovementProfileReplacement, type AgentImprovementProfileSurface, type AgentImprovementProfileTargetState, type AgentImprovementProfileTargetTransition, type AgentImprovementTargetProfileDiffOptions, type AppliedIntelligence, 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 CreateAgentImprovementActivationOptions, type CreateAgentImprovementProposalOptions, type CreateSandboxCandidateExperimentExecutorOptions, type CredentialRef, type DeliveryBinding, type DeliveryBindingKind, type DiffProvenance, type DoctorReport, type EffortOverrides, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExecuteAgentCandidateExperimentCellOptions, 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 RunAgentCandidateExperimentOptions, type RunAgentCandidateExperimentResult, type RunRecord, type RunReport, type SandboxCandidateExperimentExecution, type SandboxCandidateExperimentExecutor, type TraceHandle, type TraceMeta, type TraceOutcome, type UsageClass, type UsageSplit, type VerifyCandidateExecutionEvidenceOptions, agentImprovementProfileSurfaceDigest, agentImprovementProfileSurfaceInput, agentImprovementTargetProfileDiffs, buildAgentImprovementActivationTargets, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createAgentImprovementActivation, createAgentImprovementMeasuredComparison, createAgentImprovementProposal, createCertifiedPromptSource, createIntelligenceClient, createSandboxCandidateExperimentExecutor, defaultEffortTier, defaultRedactor, executeAgentCandidateExperimentCell, isAgentImprovementProfileSurface, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, prepareAgentImprovementProfileActivation, proposeAgentImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, runAgentCandidateExperiment, sandboxCandidateExperimentExecutionSupport, verifyAgentImprovementActivation, verifyAgentImprovementProposal, verifyAgentImprovementReview, verifyCandidateExecutionEvidence, withIntelligence };

package/dist/intelligence.js

@@ -1,6 +1,8 @@
 import {
   AGENT_IMPROVEMENT_PROFILE_SURFACES,
   AgentCandidateExperimentCellExecutionError,
+  agentImprovementProfileSurfaceDigest,
+  agentImprovementProfileSurfaceInput,
   agentImprovementTargetProfileDiffs,
   buildAgentImprovementActivationTargets,
   createAgentImprovementActivation,
@@ -18,15 +20,19 @@ import {
   verifyAgentImprovementProposal,
   verifyAgentImprovementReview,
   verifyCandidateExecutionEvidence
-} from "./chunk-JSPW2Y3P.js";
+} from "./chunk-VOPHC4LB.js";
 import {
   AGENT_CANDIDATE_EXECUTION_SUPPORT,
   CANDIDATE_KNOWLEDGE_RETRIEVAL_CONFIG_ENV,
   CANDIDATE_KNOWLEDGE_ROOT_ENV,
+  applyExactAgentProfileDiff,
   candidateKnowledgeExecutionPaths,
   canonicalCandidateBytes,
-  parseAgentCandidateProfileActivation
-} from "./chunk-YOLKCWRV.js";
+  immutableCandidateValue,
+  omitUndefinedObjectFields,
+  parseAgentCandidateProfileActivation,
+  parseExactAgentProfile
+} from "./chunk-HGSHPVJ6.js";
 import {
   buildLoopOtelSpans,
   buildRuntimeEventOtelSpans,
@@ -422,6 +428,83 @@ function isJsonSchema(v) {
   return typeof v === "object" && v !== null && !Array.isArray(v);
 }
 
+// src/intelligence/profile-activation.ts
+function prepareAgentImprovementProfileActivation(input) {
+  const targetKeys = input.targets.map((target) => `${target.identity}\0${target.surface}`);
+  if (new Set(targetKeys).size !== targetKeys.length) {
+    throw new Error("agent profile activation repeats a target");
+  }
+  const identities = [...new Set(input.targets.map((target) => target.identity))].sort();
+  const missing = identities.filter((identity) => !input.currentByIdentity.has(identity));
+  if (missing.length > 0) {
+    return immutableCandidateValue({ status: "missing", identities: missing });
+  }
+  const currentProfiles = new Map(
+    identities.map((identity) => {
+      const profile = input.currentByIdentity.get(identity);
+      if (!profile) throw new Error(`missing agent profile ${identity}`);
+      const label = `agent profile activation ${identity}`;
+      return [identity, parseExactAgentProfile(omitUndefinedObjectFields(profile, label), label)];
+    })
+  );
+  const current = input.targets.map((target) => {
+    const profile = currentProfiles.get(target.identity);
+    if (!profile) throw new Error(`missing agent profile ${target.identity}`);
+    return {
+      target,
+      currentDigest: agentImprovementProfileSurfaceDigest(profile, target.surface)
+    };
+  });
+  const states = current.map(({ target, currentDigest }) => ({
+    surface: target.surface,
+    identity: target.identity,
+    currentDigest
+  }));
+  if (current.every(({ target, currentDigest }) => currentDigest === target.desiredDigest)) {
+    return immutableCandidateValue({ status: "already-applied", targets: states });
+  }
+  if (current.some(({ target, currentDigest }) => currentDigest !== target.expectedBaseDigest)) {
+    return immutableCandidateValue({ status: "conflict", targets: states });
+  }
+  const profiles = /* @__PURE__ */ new Map();
+  for (const identity of identities) {
+    const currentProfile = currentProfiles.get(identity);
+    if (!currentProfile) throw new Error(`missing agent profile ${identity}`);
+    const profile = input.targets.filter((target) => target.identity === identity).flatMap(
+      (target) => agentImprovementTargetProfileDiffs(target, {
+        id: `${target.identity}:${target.desiredDigest}`,
+        metadata: { identity }
+      })
+    ).reduce(
+      (value, diff) => applyExactAgentProfileDiff(value, diff, `agent profile activation ${identity}`),
+      currentProfile
+    );
+    profiles.set(identity, immutableCandidateValue(profile));
+  }
+  for (const target of input.targets) {
+    const profile = profiles.get(target.identity);
+    if (!profile || agentImprovementProfileSurfaceDigest(profile, target.surface) !== target.desiredDigest) {
+      throw new Error(
+        `agent profile activation did not produce ${target.identity}:${target.surface}`
+      );
+    }
+  }
+  return immutableCandidateValue({
+    status: "apply",
+    replacements: identities.map((identity) => {
+      const profile = profiles.get(identity);
+      if (!profile) throw new Error(`missing prepared agent profile ${identity}`);
+      return { identity, profile };
+    }),
+    targets: input.targets.map((target) => ({
+      surface: target.surface,
+      identity: target.identity,
+      beforeDigest: target.expectedBaseDigest,
+      afterDigest: target.desiredDigest
+    }))
+  });
+}
+
 // src/intelligence/resolver.ts
 function emptyAccumulator() {
   return {
@@ -1689,6 +1772,8 @@ export {
   AGENT_IMPROVEMENT_PROFILE_SURFACES,
   AgentCandidateExperimentCellExecutionError,
   CapabilityNotAdmittedError,
+  agentImprovementProfileSurfaceDigest,
+  agentImprovementProfileSurfaceInput,
   agentImprovementTargetProfileDiffs,
   buildAgentImprovementActivationTargets,
   compileEffort,
@@ -1711,6 +1796,7 @@ export {
   manifestFromProfile,
   normalizeCertifiedProfile,
   parseAgentCandidateProfileActivation as parseCandidateProfileMaterialization,
+  prepareAgentImprovementProfileActivation,
   proposeAgentImprovement,
   pullCertified,
   resolveEffort,