@tangle-network/agent-runtime 0.102.2 → 0.103.0

package/dist/intelligence.d.ts

@@ -1,22 +1,22 @@
-import { AgentProfileDiff, AgentProfile, AgentProfileMcpServer, AgentImprovementActivationTarget, Sha256Digest, AgentImprovementSurface, AgentCandidateExperiment, AgentImprovementActivationIntent, AgentImprovementMeasuredComparison, AgentCandidateExperimentMeasurement, AgentImprovementProposal, AgentImprovementReviewDecision, AgentCandidateBenchmarkCellRef, AgentImprovementReview, AgentImprovementActivation, CandidateExecutionEvidence, AgentImprovementActivationTargetState, AgentImprovementActivationTargetTransition } from '@tangle-network/agent-interface';
+import { AgentProfileDiff, AgentProfile, AgentProfileMcpServer, AgentImprovementActivationTarget, Sha256Digest, AgentImprovementSurface, AgentCandidateExperiment, AgentImprovementActivationIntent, AgentCandidateExperimentMaterial, 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 { c as LoopTraceEvent } from './types-CLat4bT9.js';
+import { c as LoopTraceEvent } from './types-DK11_O4L.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 } from './profile-DbfaMTdk.js';
-export { p as parseCandidateProfileMaterialization } from './profile-DbfaMTdk.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 { 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';
 import { CandidateExperimentExecutionInput, Scenario, CompareCandidateExperimentOptions } from '@tangle-network/agent-eval/contract';
 import { AgentExactProcessResources } from '@tangle-network/agent-interface/environment-provider';
-import { c as AgentCandidateRunFinalization, d as AgentCandidateTaskExecution, e as AgentCandidateExecutionPorts, a as AgentCandidateBenchmarkGraderPort, b as AgentCandidateOutputArtifactPort, A as AgentCandidateExecutorPort } from './types-CWqfCO8s.js';
+import { c as AgentCandidateRunFinalization, d as AgentCandidateTaskExecution, e as AgentCandidateExecutionPorts, a as AgentCandidateBenchmarkGraderPort, b as AgentCandidateOutputArtifactPort, A as AgentCandidateExecutorPort } from './types-Cbp72qyu.js';
 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-B40dRu0X.js';
 import '@tangle-network/sandbox';
-import './types-D870JlH0.js';
+import './types-lZTE_LBd.js';
 import '@tangle-network/agent-eval/campaign';
 import './local-harness-CtK9dSny.js';
 import 'node:child_process';
@@ -738,7 +738,7 @@ interface ProposeAgentImprovementOptions<TScenario extends Scenario, TArtifact>
     buildExperiment: (input: {
         analysis: RunAnalystLoopResult;
         improvement: ImproveResult<TScenario, TArtifact>;
-    }) => AgentCandidateExperiment | Promise<AgentCandidateExperiment>;
+    }) => AgentImprovementExperimentMaterial | Promise<AgentImprovementExperimentMaterial>;
     placeCell: RunAgentCandidateExperimentOptions['placeCell'];
     maxConcurrency?: number;
     signal?: AbortSignal;
@@ -746,6 +746,8 @@ interface ProposeAgentImprovementOptions<TScenario extends Scenario, TArtifact>
     metadata?: AgentImprovementMeasuredComparison['metadata'];
     now?: () => Date;
 }
+/** Product-supplied experiment material. Runtime supplies optimizer ancestry and the final digest. */
+type AgentImprovementExperimentMaterial = Omit<AgentCandidateExperimentMaterial, 'candidateLineage'>;
 interface ProposeAgentImprovementResult<TScenario extends Scenario, TArtifact> {
     analysis: RunAnalystLoopResult;
     improvement: ImproveResult<TScenario, TArtifact>;
@@ -816,6 +818,16 @@ interface CreateExactProcessCandidateExperimentExecutorOptions {
     cleanupTimeoutMs?: number;
     resultTimeoutMs?: number;
 }
+/** Product-owned candidate ports other than protected model access. */
+type AgentCandidateExecutionHostPorts = Omit<AgentCandidateExecutionPorts, 'models'>;
+/**
+ * Builds the standard exact-process executor with model access that is scoped,
+ * metered, and settled by the caller's grant service.
+ */
+interface CreateProtectedExactProcessCandidateExperimentExecutorOptions extends Omit<CreateExactProcessCandidateExperimentExecutorOptions, 'ports'> {
+    hostPorts: AgentCandidateExecutionHostPorts;
+    model: CreateProtectedAgentCandidateModelPortOptions;
+}
 interface ExactProcessCandidateExperimentExecution extends CandidateExperimentExecutionInput {
     executionId: string;
     attempt?: number;
@@ -828,8 +840,14 @@ interface ExactProcessCandidateExperimentExecutor {
     readonly executor: AgentCandidateExecutorPort;
     execute(input: ExactProcessCandidateExperimentExecution): Promise<CandidateExecutionEvidence>;
 }
+/** Exact-process executor plus the ports required for durable recovery. */
+interface ProtectedExactProcessCandidateExperimentExecutor extends ExactProcessCandidateExperimentExecutor {
+    readonly recoveryPorts: Pick<AgentCandidateExecutionPorts, 'models' | 'memory'>;
+}
 /** Execute one signed experiment cell through any declared exact-process provider. */
 declare function createExactProcessCandidateExperimentExecutor(options: CreateExactProcessCandidateExperimentExecutorOptions): ExactProcessCandidateExperimentExecutor;
+/** Compose host-owned execution ports with protected model access for one exact-process run. */
+declare function createProtectedExactProcessCandidateExperimentExecutor(options: CreateProtectedExactProcessCandidateExperimentExecutorOptions): ProtectedExactProcessCandidateExperimentExecutor;
 
 type AgentImprovementProfileActivationTarget = Omit<AgentImprovementActivationTargetPlan, 'surface'> & {
     surface: AgentImprovementProfileSurface;
@@ -1368,4 +1386,4 @@ interface DoctorReport {
  */
 declare function createIntelligenceClient(config: IntelligenceConfig): IntelligenceClient;
 
-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 CreateExactProcessCandidateExperimentExecutorOptions, 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 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 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, defaultEffortTier, defaultRedactor, exactProcessCandidateExperimentExecutionSupport, executeAgentCandidateExperimentCell, isAgentImprovementProfileSurface, isIntelligenceOff, manifestFromProfile, normalizeCertifiedProfile, prepareAgentImprovementProfileActivation, proposeAgentImprovement, pullCertified, resolveEffort, resolveIntelligenceBaseUrl, resolveRedactor, reviewAgentImprovementProposal, runAgentCandidateExperiment, 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 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 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, verifyAgentImprovementActivation, verifyAgentImprovementProposal, verifyAgentImprovementReview, verifyCandidateExecutionEvidence, withIntelligence };

package/dist/intelligence.js

@@ -1,11 +1,12 @@
 import {
+  createProtectedAgentCandidateModelPort,
   exactProcessProviderAsCandidateExecutor
-} from "./chunk-377GOJHJ.js";
+} from "./chunk-ZXICDSAK.js";
 import {
   createAgentImprovementActivationResult,
   executeAgentImprovementActivation,
   verifyAgentImprovementActivationResult
-} from "./chunk-3DW5DEKQ.js";
+} from "./chunk-5AITUUHO.js";
 import {
   AGENT_IMPROVEMENT_PROFILE_SURFACES,
   AgentCandidateExperimentCellExecutionError,
@@ -25,7 +26,7 @@ import {
   verifyAgentImprovementProposal,
   verifyAgentImprovementReview,
   verifyCandidateExecutionEvidence
-} from "./chunk-7FJJUC73.js";
+} from "./chunk-LFM4JBRW.js";
 import {
   AGENT_CANDIDATE_EXECUTION_SUPPORT,
   applyExactAgentProfileDiff,
@@ -33,8 +34,8 @@ import {
   omitUndefinedObjectFields,
   parseAgentCandidateProfileActivation,
   parseExactAgentProfile
-} from "./chunk-LJLG734E.js";
-import "./chunk-ROILMKDL.js";
+} from "./chunk-SBTWKPVR.js";
+import "./chunk-QYCKIV6C.js";
 import "./chunk-UPWGXKXB.js";
 import {
   buildLoopOtelSpans,
@@ -42,8 +43,8 @@ import {
   createOtelExporter,
   flatOtelSpan
 } from "./chunk-2VZYRB55.js";
-import "./chunk-SQ3ZJH3Y.js";
-import "./chunk-IMSNJSXH.js";
+import "./chunk-6WZZXQV5.js";
+import "./chunk-ISPWRSEC.js";
 import {
   resolveAgentEnvironmentProvider
 } from "./chunk-M6MD6JBS.js";
@@ -482,6 +483,21 @@ function createExactProcessCandidateExperimentExecutor(options) {
     }
   });
 }
+function createProtectedExactProcessCandidateExperimentExecutor(options) {
+  const { hostPorts, model, ...exactProcess } = options;
+  const ports = Object.freeze({
+    ...hostPorts,
+    models: createProtectedAgentCandidateModelPort(model)
+  });
+  const execution = createExactProcessCandidateExperimentExecutor({
+    ...exactProcess,
+    ports
+  });
+  return Object.freeze({
+    ...execution,
+    recoveryPorts: Object.freeze({ models: ports.models, memory: ports.memory })
+  });
+}
 
 // src/intelligence/profile-activation.ts
 function prepareAgentImprovementProfileActivation(input) {
@@ -1381,6 +1397,7 @@ export {
   createCertifiedPromptSource,
   createExactProcessCandidateExperimentExecutor,
   createIntelligenceClient,
+  createProtectedExactProcessCandidateExperimentExecutor,
   defaultEffortTier,
   defaultRedactor,
   exactProcessCandidateExperimentExecutionSupport,