@tangle-network/agent-runtime 0.104.0 → 0.105.0

package/dist/intelligence.d.ts

@@ -1,10 +1,12 @@
 import { AgentProfileDiff, AgentProfile, AgentImprovementProposal, AgentProfileMcpServer, AgentImprovementActivationTarget, Sha256Digest, AgentImprovementSurface, AgentCandidateExperiment, AgentImprovementActivationIntent, AgentCandidateExperimentMaterial, AgentImprovementMeasuredComparison, AgentCandidateExperimentMeasurement, 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 { I as ImproveOptions, a as ImproveResult, b as ImproveMethodResult, R as Redactor } from './redact-BuFjxBUJ.js';
+export { d as defaultRedactor, r as resolveRedactor } from './redact-BuFjxBUJ.js';
 import { c as LoopTraceEvent } from './types-BCoemcXU.js';
 import { b as ToolSpec, c as RuntimeTelemetryOptions } from './sanitize-DEbPNtyI.js';
 import { R as RuntimeStreamEvent } from './types-BwoZWq-i.js';
-import { P as PrepareAgentCandidateExecutionOptions, E as ExecutePreparedAgentCandidateOptions, A as AgentCandidateExecutionClaimStore, C as CreateProtectedAgentCandidateModelPortOptions } from './protected-model-port-DzkUY3HQ.js';
-export { p as parseCandidateProfileMaterialization } from './protected-model-port-DzkUY3HQ.js';
+import { P as PrepareAgentCandidateExecutionOptions, E as ExecutePreparedAgentCandidateOptions, A as AgentCandidateExecutionClaimStore, C as CreateProtectedAgentCandidateModelPortOptions } from './protected-model-port-B4t-OQjL.js';
+export { p as parseCandidateProfileMaterialization } from './protected-model-port-B4t-OQjL.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 { TraceStore } from '@tangle-network/agent-eval';
@@ -14,12 +16,11 @@ import { c as AgentCandidateRunFinalization, d as AgentCandidateTaskExecution, e
 import { AgentEnvironmentProviderRef, AgentEnvironmentProviderRegistry } from './environment-provider.js';
 import { AnalystFinding } from '@tangle-network/agent-eval/analyst';
 import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-CmYCMbFT.js';
-import { I as ImproveOptions, a as ImproveResult } from './improve--2A0gK1-.js';
+import { OptimizationPackageSource, OptimizationMethodComparison, OptimizationTokenUsage } from '@tangle-network/agent-eval/campaign';
+import './local-harness-BDNcl6jI.js';
+import 'node:child_process';
 import '@tangle-network/sandbox';
 import './types-CvNwMzQt.js';
-import '@tangle-network/agent-eval/campaign';
-import './local-harness-CtK9dSny.js';
-import 'node:child_process';
 
 /**
  *
@@ -134,39 +135,6 @@ interface EffortOverridesCompiled {
  */
 declare function compileEffort(settings: EffortSettings): EffortOverridesCompiled;
 
-/**
- *
- * Redaction for Intelligence trace export. The trace carries the customer's
- * real input/output; before any of it leaves the process it passes through a
- * `Redactor`. The default scrubs the obvious leak classes (API keys, bearer
- * tokens, emails, private keys) from strings and walks nested objects/arrays,
- * but a customer with domain-specific PII supplies their own `redact` hook.
- *
- * This is intentionally narrower than `src/sanitize.ts` (which redacts the
- * runtime's *event envelope* field-by-field): here the value is opaque
- * customer payload, so the scrub is value-shaped, not schema-shaped.
- *
- * @experimental
- */
-/** A redactor maps an arbitrary trace value to a safe-to-export value. Pure;
- *  must not throw on cyclic input (the default tolerates cycles). */
-type Redactor = (value: unknown) => unknown;
-/**
- * The built-in redactor. Walks objects and arrays; replaces values under
- * secret-bearing keys wholesale; scrubs in-value patterns from every string.
- * Cycle-safe (a seen-set short-circuits self-referential payloads to
- * `'[circular]'`), depth-bounded, and total — never throws on customer input.
- */
-declare function defaultRedactor(value: unknown): unknown;
-/**
- * Resolve the redactor a client uses. A caller-supplied hook replaces the
- * default entirely (the customer owns their PII rules); absent one, the
- * built-in `defaultRedactor` runs. Returning `false` is the explicit opt-out —
- * NO redaction, for a caller who has already sanitized upstream and wants raw
- * fidelity. Opt-out is loud (an explicit `false`), never a silent default.
- */
-declare function resolveRedactor(redact: Redactor | false | undefined): Redactor;
-
 /**
  *
  * Tangle Intelligence — the RECEIVE half of the loop (pull-by-default).
@@ -886,6 +854,47 @@ declare function createExactProcessCandidateExperimentExecutor(options: CreateEx
 /** Compose host-owned execution ports with protected model access for one exact-process run. */
 declare function createProtectedExactProcessCandidateExperimentExecutor(options: CreateProtectedExactProcessCandidateExperimentExecutorOptions): ProtectedExactProcessCandidateExperimentExecutor;
 
+type OptimizationProvenance = NonNullable<OptimizationMethodComparison['best']['provenance']>;
+interface OptimizationActivationReceipt {
+    kind: 'optimization-activation-receipt';
+    method: string;
+    source: OptimizationPackageSource;
+    bridge?: OptimizationPackageSource;
+    modules?: OptimizationProvenance['modules'];
+    python?: OptimizationProvenance['python'];
+    models?: {
+        candidate?: NonNullable<AgentProfile['model']>;
+        optimizer?: string;
+    };
+    usage: {
+        optimizerEvaluations: number;
+        optimizerTokens?: OptimizationTokenUsage;
+    };
+    cost: {
+        optimization: OptimizationReceiptCost;
+        finalTest: OptimizationReceiptCost;
+        total: OptimizationReceiptCost;
+    };
+    invocation: {
+        runtimeInvocationId: string;
+        optimizerRunId: string;
+        compatibleOptimizerRunId?: string;
+        resumed: boolean;
+        artifactDir: string;
+    };
+    developmentDataDigest: Sha256Digest;
+    digest: Sha256Digest;
+}
+interface OptimizationReceiptCost {
+    totalUsd: number;
+    accountingComplete: boolean;
+    incompleteReasons: string[];
+}
+/** Build a detached receipt only for methods backed by an identified external optimizer. */
+declare function createOptimizationActivationReceipt(improvement: ImproveMethodResult): OptimizationActivationReceipt | undefined;
+/** Read and verify the optimizer evidence carried by a measured proposal. */
+declare function optimizationActivationReceiptFromMetadata(metadata: AgentImprovementMeasuredComparison['metadata']): OptimizationActivationReceipt | undefined;
+
 type AgentImprovementProfileActivationTarget = Omit<AgentImprovementActivationTargetPlan, 'surface'> & {
     surface: AgentImprovementProfileSurface;
 };
@@ -1423,4 +1432,4 @@ interface DoctorReport {
  */
 declare function createIntelligenceClient(config: IntelligenceConfig): IntelligenceClient;
 
-export { AGENT_IMPROVEMENT_PROFILE_SURFACES, type AgentCandidateExecutionHostPorts, AgentCandidateExperimentCellExecutionError, type AgentCandidateExperimentCellPlacement, type AgentImprovementActivationTargetIdentity, AgentImprovementActivationTargetPlan, type AgentImprovementExperimentMaterial, type AgentImprovementProfileActivationPreparation, type AgentImprovementProfileActivationTarget, type AgentImprovementProfileReplacement, type AgentImprovementProfileSurface, type AgentImprovementProfileTargetState, type AgentImprovementProfileTargetTransition, type AgentImprovementProposalSubmissionState, 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 CreateExactProcessCandidateExperimentExecutorOptions, type CreateProtectedExactProcessCandidateExperimentExecutorOptions, type CredentialRef, type DeliveryBinding, type DeliveryBindingKind, type DiffProvenance, type DoctorReport, type EffortOverrides, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExactProcessCandidateExperimentExecution, type ExactProcessCandidateExperimentExecutor, 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 ProtectedExactProcessCandidateExperimentExecutor, 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 SubmitAgentImprovementProposalOptions, type SubmitAgentImprovementProposalOutcome, type TraceHandle, type TraceMeta, type TraceOutcome, type UsageClass, type UsageSplit, type VerifyCandidateExecutionEvidenceOptions, agentImprovementProfileSurfaceDigest, agentImprovementProfileSurfaceInput, agentImprovementTargetProfileDiffs, buildAgentImprovementActivationTargets, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createAgentImprovementActivation, createAgentImprovementMeasuredComparison, createAgentImprovementProposal, createCertifiedPromptSource, createExactProcessCandidateExperimentExecutor, createIntelligenceClient, createProtectedExactProcessCandidateExperimentExecutor, defaultEffortTier, defaultRedactor, exactProcessCandidateExperimentExecutionSupport, executeAgentCandidateExperimentCell, isAgentImprovementProfileSurface, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, prepareAgentImprovementProfileActivation, proposeAgentImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, runAgentCandidateExperiment, submitAgentImprovementProposal, verifyAgentImprovementActivation, verifyAgentImprovementProposal, verifyAgentImprovementReview, verifyCandidateExecutionEvidence, withIntelligence };
+export { AGENT_IMPROVEMENT_PROFILE_SURFACES, type AgentCandidateExecutionHostPorts, AgentCandidateExperimentCellExecutionError, type AgentCandidateExperimentCellPlacement, type AgentImprovementActivationTargetIdentity, AgentImprovementActivationTargetPlan, type AgentImprovementExperimentMaterial, type AgentImprovementProfileActivationPreparation, type AgentImprovementProfileActivationTarget, type AgentImprovementProfileReplacement, type AgentImprovementProfileSurface, type AgentImprovementProfileTargetState, type AgentImprovementProfileTargetTransition, type AgentImprovementProposalSubmissionState, 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 CreateExactProcessCandidateExperimentExecutorOptions, type CreateProtectedExactProcessCandidateExperimentExecutorOptions, type CredentialRef, type DeliveryBinding, type DeliveryBindingKind, type DiffProvenance, type DoctorReport, type EffortOverrides, type EffortOverridesCompiled, type EffortSettings, type EffortTier, type ExactProcessCandidateExperimentExecution, type ExactProcessCandidateExperimentExecutor, type ExecuteAgentCandidateExperimentCellOptions, type HostSpec, type IntelligenceAgent, type IntelligenceClient, type IntelligenceConfig, type IntelligenceHookConfig, type IntelligenceWrapped, type JsonSchema, type ModeReadiness, type OptimizationActivationReceipt, type OptimizationReceiptCost, type ProposeAgentImprovementOptions, type ProposeAgentImprovementResult, type ProposedProfileDiff, type ProtectedExactProcessCandidateExperimentExecutor, type ProvisionedHost, type PullCertifiedOptions, type PullOutcome, type RecordTraceMeta, Redactor, type RepoConfig, type ResolveCtx, type ResolvedHook, type ResolvedRetrieval, type ResolvedSubagent, type ResolvedSurface, type ReviewAgentImprovementInput, type RunAgentCandidateExperimentOptions, type RunAgentCandidateExperimentResult, type RunRecord, type RunReport, type SubmitAgentImprovementProposalOptions, type SubmitAgentImprovementProposalOutcome, type TraceHandle, type TraceMeta, type TraceOutcome, type UsageClass, type UsageSplit, type VerifyCandidateExecutionEvidenceOptions, agentImprovementProfileSurfaceDigest, agentImprovementProfileSurfaceInput, agentImprovementTargetProfileDiffs, buildAgentImprovementActivationTargets, compileEffort, composeCertifiedProfile, composeCertifiedProfileFromWire, composeCertifiedPrompt, createAgentImprovementActivation, createAgentImprovementMeasuredComparison, createAgentImprovementProposal, createCertifiedPromptSource, createExactProcessCandidateExperimentExecutor, createIntelligenceClient, createOptimizationActivationReceipt, createProtectedExactProcessCandidateExperimentExecutor, defaultEffortTier, exactProcessCandidateExperimentExecutionSupport, executeAgentCandidateExperimentCell, isAgentImprovementProfileSurface, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, optimizationActivationReceiptFromMetadata, prepareAgentImprovementProfileActivation, proposeAgentImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, reviewAgentImprovementProposal, runAgentCandidateExperiment, submitAgentImprovementProposal, verifyAgentImprovementActivation, verifyAgentImprovementProposal, verifyAgentImprovementReview, verifyCandidateExecutionEvidence, withIntelligence };

package/dist/intelligence.js

@@ -1,12 +1,16 @@
+import {
+  defaultRedactor,
+  resolveRedactor
+} from "./chunk-OPVWXJ2H.js";
 import {
   createProtectedAgentCandidateModelPort,
   exactProcessProviderAsCandidateExecutor
-} from "./chunk-ZXICDSAK.js";
+} from "./chunk-H5QPIZNX.js";
 import {
   createAgentImprovementActivationResult,
   executeAgentImprovementActivation,
   verifyAgentImprovementActivationResult
-} from "./chunk-HAO4CXHP.js";
+} from "./chunk-VISA6CI3.js";
 import {
   AGENT_IMPROVEMENT_PROFILE_SURFACES,
   AgentCandidateExperimentCellExecutionError,
@@ -17,8 +21,10 @@ import {
   createAgentImprovementActivation,
   createAgentImprovementMeasuredComparison,
   createAgentImprovementProposal,
+  createOptimizationActivationReceipt,
   executeAgentCandidateExperimentCell,
   isAgentImprovementProfileSurface,
+  optimizationActivationReceiptFromMetadata,
   proposeAgentImprovement,
   reviewAgentImprovementProposal,
   runAgentCandidateExperiment,
@@ -26,7 +32,7 @@ import {
   verifyAgentImprovementProposal,
   verifyAgentImprovementReview,
   verifyCandidateExecutionEvidence
-} from "./chunk-FJI3EXU3.js";
+} from "./chunk-UHEZW5BU.js";
 import {
   AGENT_CANDIDATE_EXECUTION_SUPPORT,
   applyExactAgentProfileDiff,
@@ -34,8 +40,8 @@ import {
   omitUndefinedObjectFields,
   parseAgentCandidateProfileActivation,
   parseExactAgentProfile
-} from "./chunk-SBTWKPVR.js";
-import "./chunk-STJEHM5F.js";
+} from "./chunk-WSTRQZYQ.js";
+import "./chunk-YJZA2BIK.js";
 import "./chunk-UPWGXKXB.js";
 import {
   buildLoopOtelSpans,
@@ -43,7 +49,7 @@ import {
   createOtelExporter,
   flatOtelSpan
 } from "./chunk-2VZYRB55.js";
-import "./chunk-2X65HYMI.js";
+import "./chunk-HLKC4UYB.js";
 import "./chunk-ISPWRSEC.js";
 import {
   resolveAgentEnvironmentProvider
@@ -350,57 +356,6 @@ function compileEffort(settings) {
   };
 }
 
-// src/intelligence/redact.ts
-var redactedMarker = "[redacted]";
-var secretKeyPattern = /(api[-_]?key|secret|token|password|passwd|authorization|auth|private[-_]?key|credential|access[-_]?key|client[-_]?secret|session[-_]?(id|token)|cookie|bearer)/i;
-var valuePatterns = [
-  // Bearer tokens.
-  /\bBearer\s+[A-Za-z0-9._\-+/=]{8,}/gi,
-  // Provider-style API keys (sk-..., sk-tan-..., pk_live_..., ghp_...).
-  /\b(?:sk|pk|rk|ak)[-_][A-Za-z0-9_-]{12,}/g,
-  /\bgh[pousr]_[A-Za-z0-9]{20,}/g,
-  // AWS access key ids.
-  /\bAKIA[0-9A-Z]{16}\b/g,
-  // PEM private-key blocks.
-  /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
-  // Email addresses.
-  /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g
-];
-function scrubString(input) {
-  let out = input;
-  for (const pattern of valuePatterns) {
-    out = out.replace(pattern, redactedMarker);
-  }
-  return out;
-}
-function defaultRedactor(value) {
-  return walk(value, /* @__PURE__ */ new WeakSet(), 0);
-}
-var maxDepth = 32;
-function walk(value, seen, depth) {
-  if (depth > maxDepth) return "[truncated]";
-  if (typeof value === "string") return scrubString(value);
-  if (value === null || typeof value !== "object") return value;
-  if (seen.has(value)) return "[circular]";
-  seen.add(value);
-  if (Array.isArray(value)) {
-    return value.map((item) => walk(item, seen, depth + 1));
-  }
-  const out = {};
-  for (const [key, v] of Object.entries(value)) {
-    if (secretKeyPattern.test(key)) {
-      out[key] = redactedMarker;
-      continue;
-    }
-    out[key] = walk(v, seen, depth + 1);
-  }
-  return out;
-}
-function resolveRedactor(redact) {
-  if (redact === false) return (value) => value;
-  return redact ?? defaultRedactor;
-}
-
 // src/intelligence/capability.ts
 var CapabilityNotAdmittedError = class extends Error {
   kind;
@@ -1493,6 +1448,7 @@ export {
   createCertifiedPromptSource,
   createExactProcessCandidateExperimentExecutor,
   createIntelligenceClient,
+  createOptimizationActivationReceipt,
   createProtectedExactProcessCandidateExperimentExecutor,
   defaultEffortTier,
   defaultRedactor,
@@ -1503,6 +1459,7 @@ export {
   isIntelligenceOff,
   manifestFromProfile,
   normalizeCertifiedProfile,
+  optimizationActivationReceiptFromMetadata,
   parseAgentCandidateProfileActivation as parseCandidateProfileMaterialization,
   prepareAgentImprovementProfileActivation,
   proposeAgentImprovement,