@tangle-network/agent-runtime 0.101.1 → 0.102.0

package/dist/intelligence.d.ts

@@ -7,13 +7,16 @@ import { P as PrepareAgentCandidateExecutionOptions, E as ExecutePreparedAgentCa
 export { p as parseCandidateProfileMaterialization } from './profile-DbfaMTdk.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 { TraceStore } from '@tangle-network/agent-eval';
 import { CandidateExperimentExecutionInput, Scenario, CompareCandidateExperimentOptions } from '@tangle-network/agent-eval/contract';
-import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-CmYCMbFT.js';
+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 { I as ImproveOptions, a as ImproveResult } from './improve-g75IE2Cx.js';
-import { TraceStore } from '@tangle-network/agent-eval';
-import { SandboxClient, SandboxResources } from '@tangle-network/sandbox';
+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-CIml6hT3.js';
+import '@tangle-network/sandbox';
+import './types-CmnA2iL3.js';
 import '@tangle-network/agent-eval/campaign';
 import './local-harness-ZqCx51u7.js';
 import 'node:child_process';
@@ -777,6 +780,57 @@ declare function verifyAgentImprovementActivation(input: {
 /** Recheck one Runtime receipt against its exact signed experiment cell. */
 declare function verifyCandidateExecutionEvidence(input: unknown, options: VerifyCandidateExecutionEvidenceOptions): CandidateExecutionEvidence;
 
+/** Candidate surfaces implemented by the neutral exact-process executor. */
+declare const exactProcessCandidateExperimentExecutionSupport: Readonly<{
+    outcomes: readonly ["output"];
+    outputMediaTypes: readonly ["text/*", "application/json", "*+json"];
+    code: readonly ["disabled"];
+    memory: readonly ["disabled"];
+    knowledge: true;
+    profile: Readonly<{
+        mcpTransports: readonly ["stdio"];
+        remoteMcp: false;
+        tools: false;
+        permissions: false;
+        modes: false;
+        confidential: false;
+    }>;
+    isolation: Readonly<{
+        freshEnvironment: true;
+        exactProcess: true;
+        egress: readonly ["blocked", "strict"];
+    }>;
+}>;
+interface CreateExactProcessCandidateExperimentExecutorOptions {
+    provider: AgentEnvironmentProviderRef;
+    providerRegistry?: AgentEnvironmentProviderRegistry;
+    resources: AgentExactProcessResources;
+    providerOptions?: Record<string, unknown>;
+    provisionTimeoutMs?: number;
+    recoveryRetentionMs?: number;
+    ports: AgentCandidateExecutionPorts;
+    grader: AgentCandidateBenchmarkGraderPort;
+    outputArtifacts: AgentCandidateOutputArtifactPort;
+    traceStore: TraceStore;
+    claimStore: AgentCandidateExecutionClaimStore;
+    cleanupTimeoutMs?: number;
+    resultTimeoutMs?: number;
+}
+interface ExactProcessCandidateExperimentExecution extends CandidateExperimentExecutionInput {
+    executionId: string;
+    attempt?: number;
+    executionRoots: AgentCandidateExperimentCellPlacement['executionRoots'];
+    stagingRoots: AgentCandidateExperimentCellPlacement['stagingRoots'];
+    preparation?: PrepareAgentCandidateExecutionOptions;
+}
+interface ExactProcessCandidateExperimentExecutor {
+    /** Runtime's expired-attempt path reuses this port only to stop and dispose. */
+    readonly executor: AgentCandidateExecutorPort;
+    execute(input: ExactProcessCandidateExperimentExecution): Promise<CandidateExecutionEvidence>;
+}
+/** Execute one signed experiment cell through any declared exact-process provider. */
+declare function createExactProcessCandidateExperimentExecutor(options: CreateExactProcessCandidateExperimentExecutorOptions): ExactProcessCandidateExperimentExecutor;
+
 type AgentImprovementProfileActivationTarget = Omit<AgentImprovementActivationTargetPlan, 'surface'> & {
     surface: AgentImprovementProfileSurface;
 };
@@ -927,59 +981,6 @@ declare function composeCertifiedProfileFromWire(base: {
     systemPrompt: string;
 }, profile: CertifiedProfile | null, ctx?: ResolveCtx): Promise<ResolvedSurface>;
 
-type SandboxClientPort = Pick<SandboxClient, 'create' | 'get' | 'list'>;
-/** Declares the exact candidate surfaces the sandbox executor can run. */
-declare const sandboxCandidateExperimentExecutionSupport: Readonly<{
-    outcomes: readonly ["output"];
-    outputMediaTypes: readonly ["text/*", "application/json", "*+json"];
-    code: readonly ["disabled"];
-    memory: readonly ["disabled"];
-    knowledge: true;
-    profile: Readonly<{
-        mcpTransports: readonly ["stdio"];
-        remoteMcp: false;
-        tools: false;
-        permissions: false;
-        modes: false;
-        confidential: false;
-    }>;
-    isolation: Readonly<{
-        freshSandbox: true;
-        exactProcess: true;
-        egress: readonly ["blocked", "strict"];
-    }>;
-}>;
-interface CreateSandboxCandidateExperimentExecutorOptions {
-    client: SandboxClientPort;
-    ports: AgentCandidateExecutionPorts;
-    grader: AgentCandidateBenchmarkGraderPort;
-    outputArtifacts: AgentCandidateOutputArtifactPort;
-    traceStore: TraceStore;
-    claimStore: AgentCandidateExecutionClaimStore;
-    sandbox?: {
-        teamId?: string;
-        resources?: SandboxResources;
-        createTimeoutMs?: number;
-        evidenceRetentionSeconds?: number;
-    };
-    cleanupTimeoutMs?: number;
-    resultTimeoutMs?: number;
-}
-interface SandboxCandidateExperimentExecution extends CandidateExperimentExecutionInput {
-    executionId: string;
-    attempt?: number;
-    executionRoots: AgentCandidateExperimentCellPlacement['executionRoots'];
-    stagingRoots: AgentCandidateExperimentCellPlacement['stagingRoots'];
-    preparation?: PrepareAgentCandidateExecutionOptions;
-}
-interface SandboxCandidateExperimentExecutor {
-    /** The same port is usable by Runtime's expired-claim recovery path. */
-    readonly executor: AgentCandidateExecutorPort;
-    execute(input: SandboxCandidateExperimentExecution): Promise<CandidateExecutionEvidence>;
-}
-/** Execute one signed experiment cell inside a fresh Tangle sandbox. */
-declare function createSandboxCandidateExperimentExecutor(options: CreateSandboxCandidateExperimentExecutorOptions): SandboxCandidateExperimentExecutor;
-
 /**
  *
  * `withIntelligence` — the ONE agent-runtime hook that unifies Tangle
@@ -1367,4 +1368,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 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 };
+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 };