@tangle-network/agent-runtime 0.101.1 → 0.102.0

package/dist/candidate-execution/index.d.ts

@@ -3,8 +3,9 @@ import { AgentCandidateBundle, AgentCandidateCodeDisabled, AgentCandidateCodeNoO
 export { AgentCandidateBenchmarkGraderIdentity } from '@tangle-network/agent-interface';
 import { c as AgentCandidateExecutionClaim, A as AgentCandidateExecutionClaimStore, d as AgentCandidateExecutionClaimResult, b as AgentCandidateExecutionAttemptRef, a as AgentCandidateExecutionAttemptRecord, h as AgentCandidateExecutionLease, j as AgentCandidateExecutionPhaseResult, n as AgentCandidateExecutionTerminalResult, l as AgentCandidateExecutionStageResult, g as AgentCandidateExecutionFinishResult, k as AgentCandidateExecutionRecoveryEvidence } from '../profile-DbfaMTdk.js';
 export { e as AgentCandidateExecutionCleanupHandles, f as AgentCandidateExecutionFailureClass, i as AgentCandidateExecutionPhase, m as AgentCandidateExecutionTerminalRecord, o as AgentCandidatePreparationEvidence, q as AgentCandidateRetryRejection, E as ExecutePreparedAgentCandidateOptions, I as InMemoryAgentCandidateExecutionClaimStore, P as PrepareAgentCandidateExecutionOptions, r as applyExactAgentProfileDiff, s as executePreparedAgentCandidate, t as parseExactAgentProfile, u as parseExactAgentProfileDiff, v as prepareAgentCandidateExecution } from '../profile-DbfaMTdk.js';
-import { P as PreparedAgentCandidateExecution, b as AgentCandidateOutputArtifactPort, t as AgentCandidateOutputPurpose, s as AgentCandidateModelPort, v as AgentCandidateProtectedModelReservation, u as AgentCandidateProtectedModelActivation, w as AgentCandidateProtectedModelSettlement, A as AgentCandidateExecutorPort, e as AgentCandidateExecutionPorts, z as AgentCandidateVerificationPorts, V as VerifiedAgentCandidate, n as AgentCandidateExecutorWorkspaceFile, B as AgentCandidateWorkspacePort } from '../types-CWqfCO8s.js';
+import { P as PreparedAgentCandidateExecution, A as AgentCandidateExecutorPort, b as AgentCandidateOutputArtifactPort, t as AgentCandidateOutputPurpose, s as AgentCandidateModelPort, v as AgentCandidateProtectedModelReservation, u as AgentCandidateProtectedModelActivation, w as AgentCandidateProtectedModelSettlement, e as AgentCandidateExecutionPorts, z as AgentCandidateVerificationPorts, V as VerifiedAgentCandidate, n as AgentCandidateExecutorWorkspaceFile, B as AgentCandidateWorkspacePort } from '../types-CWqfCO8s.js';
 export { f as AgentCandidateArtifactPort, a as AgentCandidateBenchmarkGraderPort, g as AgentCandidateContainerPort, h as AgentCandidateExecutorFinalCapture, i as AgentCandidateExecutorMemoryCapture, j as AgentCandidateExecutorProfileFile, k as AgentCandidateExecutorRequest, l as AgentCandidateExecutorStopRequest, m as AgentCandidateExecutorTaskOutcomeCapture, o as AgentCandidateExecutorWorkspaceInput, p as AgentCandidateMemoryPort, q as AgentCandidateMemoryResetResult, r as AgentCandidateModelLimits, x as AgentCandidateProtectedRunCapture, y as AgentCandidateRepositoryPort, c as AgentCandidateRunFinalization, d as AgentCandidateTaskExecution, C as CANDIDATE_TRACE_ENV, D as CANDIDATE_TRACE_TAGS, E as CanonicalCandidateDocument, F as PreparedAgentCandidateInstruction, G as PreparedAgentCandidateKnowledge, H as PreparedAgentCandidateLaunch, I as PreparedAgentCandidateTrace, R as ResolvedAgentCandidateContainer, J as VerifiedAgentCandidateTaskOutcome } from '../types-CWqfCO8s.js';
+import { AgentEnvironmentProvider, AgentExactProcessResources } from '@tangle-network/agent-interface/environment-provider';
 import { TraceStore } from '@tangle-network/agent-eval';
 
 /** Exact candidate wire shape before the runtime computes its canonical digest. */
@@ -93,6 +94,16 @@ declare function disposePreparedAgentCandidateExecution(prepared: PreparedAgentC
     disposed: true;
 }>;
 
+interface ExactProcessCandidateExecutorOptions {
+    provider: AgentEnvironmentProvider;
+    resources: AgentExactProcessResources;
+    provisionTimeoutMs?: number;
+    recoveryRetentionMs?: number;
+    providerOptions?: Record<string, unknown>;
+}
+/** Adapt one neutral exact-process provider to Runtime's trusted candidate boundary. */
+declare function exactProcessProviderAsCandidateExecutor(options: ExactProcessCandidateExecutorOptions): AgentCandidateExecutorPort;
+
 /** Environment variable containing the materialized candidate knowledge root. */
 declare const CANDIDATE_KNOWLEDGE_ROOT_ENV = "TANGLE_CANDIDATE_KNOWLEDGE_ROOT";
 /** Environment variable containing the materialized retrieval configuration path. */
@@ -214,4 +225,4 @@ declare function captureAgentCandidateWorkspaceFiles(input: readonly AgentCandid
 /** Create the standard bounded materializer for candidate execution ports. */
 declare function createAgentCandidateWorkspacePort(options?: CreateAgentCandidateWorkspacePortOptions): AgentCandidateWorkspacePort;
 
-export { AGENT_CANDIDATE_EXECUTION_SUPPORT, type AgentCandidateBundleInput, type AgentCandidateCodeSource, type AgentCandidateCodeSurfaceSource, AgentCandidateExecutionAttemptRecord, AgentCandidateExecutionAttemptRef, AgentCandidateExecutionClaim, AgentCandidateExecutionClaimResult, AgentCandidateExecutionClaimStore, AgentCandidateExecutionFinishResult, AgentCandidateExecutionLease, AgentCandidateExecutionPhaseResult, AgentCandidateExecutionPorts, AgentCandidateExecutionRecoveryEvidence, AgentCandidateExecutionStageResult, AgentCandidateExecutionTerminalResult, AgentCandidateExecutorPort, AgentCandidateExecutorWorkspaceFile, type AgentCandidateModelGrantActivateInput, type AgentCandidateModelGrantClient, type AgentCandidateModelGrantReservation, type AgentCandidateModelGrantReserveInput, type AgentCandidateModelGrantSettleInput, AgentCandidateModelPort, AgentCandidateOutputArtifactPort, AgentCandidateOutputPurpose, type AgentCandidateProfileSource, AgentCandidateProtectedModelActivation, AgentCandidateProtectedModelReservation, AgentCandidateProtectedModelSettlement, AgentCandidateVerificationPorts, type AgentCandidateWorkspaceArchiveLimits, AgentCandidateWorkspacePort, type BuildAgentCandidateBundleInput, CANDIDATE_KNOWLEDGE_RETRIEVAL_CONFIG_ENV, CANDIDATE_KNOWLEDGE_ROOT_ENV, type CaptureAgentCandidateWorkspaceOptions, type CapturedAgentCandidateWorkspace, type CreateAgentCandidateWorkspacePortOptions, type CreateProtectedAgentCandidateModelPortOptions, type DisposePreparedAgentCandidateOptions, FileAgentCandidateExecutionClaimStore, type FileAgentCandidateExecutionClaimStoreOptions, PreparedAgentCandidateExecution, type RecoverExpiredAgentCandidateOptions, VerifiedAgentCandidate, buildAgentCandidateBundle, candidateExecutionClaim, candidateKnowledgeExecutionPaths, captureAgentCandidateWorkspace, captureAgentCandidateWorkspaceFiles, createAgentCandidateWorkspacePort, createProtectedAgentCandidateModelPort, disposePreparedAgentCandidateExecution, persistCandidateOutputArtifact, recoverExpiredAgentCandidateExecution, sealAgentCandidateBundle, verifyAgentCandidateBundle };
+export { AGENT_CANDIDATE_EXECUTION_SUPPORT, type AgentCandidateBundleInput, type AgentCandidateCodeSource, type AgentCandidateCodeSurfaceSource, AgentCandidateExecutionAttemptRecord, AgentCandidateExecutionAttemptRef, AgentCandidateExecutionClaim, AgentCandidateExecutionClaimResult, AgentCandidateExecutionClaimStore, AgentCandidateExecutionFinishResult, AgentCandidateExecutionLease, AgentCandidateExecutionPhaseResult, AgentCandidateExecutionPorts, AgentCandidateExecutionRecoveryEvidence, AgentCandidateExecutionStageResult, AgentCandidateExecutionTerminalResult, AgentCandidateExecutorPort, AgentCandidateExecutorWorkspaceFile, type AgentCandidateModelGrantActivateInput, type AgentCandidateModelGrantClient, type AgentCandidateModelGrantReservation, type AgentCandidateModelGrantReserveInput, type AgentCandidateModelGrantSettleInput, AgentCandidateModelPort, AgentCandidateOutputArtifactPort, AgentCandidateOutputPurpose, type AgentCandidateProfileSource, AgentCandidateProtectedModelActivation, AgentCandidateProtectedModelReservation, AgentCandidateProtectedModelSettlement, AgentCandidateVerificationPorts, type AgentCandidateWorkspaceArchiveLimits, AgentCandidateWorkspacePort, type BuildAgentCandidateBundleInput, CANDIDATE_KNOWLEDGE_RETRIEVAL_CONFIG_ENV, CANDIDATE_KNOWLEDGE_ROOT_ENV, type CaptureAgentCandidateWorkspaceOptions, type CapturedAgentCandidateWorkspace, type CreateAgentCandidateWorkspacePortOptions, type CreateProtectedAgentCandidateModelPortOptions, type DisposePreparedAgentCandidateOptions, type ExactProcessCandidateExecutorOptions, FileAgentCandidateExecutionClaimStore, type FileAgentCandidateExecutionClaimStoreOptions, PreparedAgentCandidateExecution, type RecoverExpiredAgentCandidateOptions, VerifiedAgentCandidate, buildAgentCandidateBundle, candidateExecutionClaim, candidateKnowledgeExecutionPaths, captureAgentCandidateWorkspace, captureAgentCandidateWorkspaceFiles, createAgentCandidateWorkspacePort, createProtectedAgentCandidateModelPort, disposePreparedAgentCandidateExecution, exactProcessProviderAsCandidateExecutor, persistCandidateOutputArtifact, recoverExpiredAgentCandidateExecution, sealAgentCandidateBundle, verifyAgentCandidateBundle };

package/dist/candidate-execution/index.js

@@ -4,13 +4,16 @@ import {
   createProtectedAgentCandidateModelPort,
   disposePreparedAgentCandidateExecution,
   recoverExpiredAgentCandidateExecution
-} from "../chunk-U4PRAATQ.js";
+} from "../chunk-DA7YL6I4.js";
+import {
+  exactProcessProviderAsCandidateExecutor
+} from "../chunk-SPCD4IQQ.js";
 import {
   captureAgentCandidateWorkspace,
   captureAgentCandidateWorkspaceFiles,
   createAgentCandidateWorkspacePort,
   sealAgentCandidateBundle
-} from "../chunk-BXZ7GPL4.js";
+} from "../chunk-AIBIRAJ6.js";
 import {
   AGENT_CANDIDATE_EXECUTION_SUPPORT,
   CANDIDATE_KNOWLEDGE_RETRIEVAL_CONFIG_ENV,
@@ -27,7 +30,7 @@ import {
   persistCandidateOutputArtifact,
   prepareAgentCandidateExecution,
   verifyAgentCandidateBundle
-} from "../chunk-HGSHPVJ6.js";
+} from "../chunk-TGDHHHH4.js";
 import "../chunk-IMSNJSXH.js";
 import "../chunk-3MDZX7YU.js";
 export {
@@ -47,6 +50,7 @@ export {
   createAgentCandidateWorkspacePort,
   createProtectedAgentCandidateModelPort,
   disposePreparedAgentCandidateExecution,
+  exactProcessProviderAsCandidateExecutor,
   executePreparedAgentCandidate,
   parseExactAgentProfile,
   parseExactAgentProfileDiff,

package/dist/{chunk-TA4RBJLE.js → chunk-23Z7N5IG.js}

@@ -4,16 +4,16 @@ import {
 import {
   captureAgentCandidateWorkspace,
   sealAgentCandidateBundle
-} from "./chunk-BXZ7GPL4.js";
+} from "./chunk-AIBIRAJ6.js";
 import {
   createAgentImprovementActivationResult
-} from "./chunk-DI677IPX.js";
+} from "./chunk-LKKIM5QD.js";
 import {
   canonicalCandidateBytes,
   embeddedCandidateArtifact,
   omitTopLevelDigest,
   persistCandidateOutputArtifact
-} from "./chunk-HGSHPVJ6.js";
+} from "./chunk-TGDHHHH4.js";
 import {
   supervise
 } from "./chunk-KVJQV342.js";
@@ -471,4 +471,4 @@ export {
   runKnowledgeImprovementJob,
   buildKnowledgeImprovementExperimentBundles
 };
-//# sourceMappingURL=chunk-TA4RBJLE.js.map
+//# sourceMappingURL=chunk-23Z7N5IG.js.map

package/dist/{chunk-RJPQLUDA.js → chunk-4AMAFNUD.js}

@@ -16,7 +16,7 @@ import {
   verifiedResourceTextByDigest,
   verifyAgentCandidateBundle,
   verifyCanonicalCandidateDocument
-} from "./chunk-HGSHPVJ6.js";
+} from "./chunk-TGDHHHH4.js";
 import {
   assertModelAllowed,
   harnessInvocation,
@@ -244,7 +244,7 @@ ${attemptNote}` : basePrompt;
             worktreePath,
             verified: false
           });
-          return { applied: true, summary: summarize(findings) };
+          return acceptedCandidate(findings);
         }
         let result;
         try {
@@ -264,7 +264,7 @@ ${attemptNote}` : basePrompt;
             worktreePath,
             verified: true
           });
-          return { applied: true, summary: summarize(findings) };
+          return acceptedCandidate(findings);
         }
         await emitShotDisposition(opts.onShotDisposition, receipt, {
           kind: "rejected",
@@ -619,6 +619,26 @@ function summarize(findings) {
   if (findings.length === 1) return `agentic: ${truncate(findings[0].claim, 64)}`;
   return `agentic: ${findings.length} findings addressed`;
 }
+function acceptedCandidate(findings) {
+  const summary = summarize(findings);
+  return {
+    applied: true,
+    summary,
+    label: slugify(summary.split("\n", 1)[0] ?? summary),
+    rationale: boundedRationale(summary, findings)
+  };
+}
+function slugify(line) {
+  const slug = line.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return truncate(slug || "agentic-improvement", 48);
+}
+function boundedRationale(summary, findings) {
+  if (findings.length === 0) return summary;
+  return truncate(
+    findings.map((finding) => `(${finding.severity}) ${finding.claim}`).join("; "),
+    400
+  );
+}
 function truncate(s, n) {
   return s.length <= n ? s : `${s.slice(0, n - 1)}\u2026`;
 }
@@ -688,7 +708,7 @@ function improvementDriver(opts) {
         owned.set(wt.path, wt);
         try {
           if (incumbent) advanceToIncumbent(wt, incumbent);
-          const { applied, summary } = await opts.generator.generate({
+          const { applied, summary, label, rationale } = await opts.generator.generate({
             worktreePath: wt.path,
             report: ctx.report,
             findings,
@@ -706,7 +726,9 @@ function improvementDriver(opts) {
             continue;
           }
           const surface = await opts.worktree.finalize(wt, summary);
-          surfaces.push(surface);
+          surfaces.push(
+            label || rationale ? { surface, label: label ?? "", rationale: rationale ?? "" } : surface
+          );
           owned.delete(wt.path);
           owned.set(surface.worktreeRef, wt);
         } catch (err) {
@@ -2042,4 +2064,4 @@ export {
   verifyAgentImprovementActivation,
   verifyCandidateExecutionEvidence
 };
-//# sourceMappingURL=chunk-RJPQLUDA.js.map
+//# sourceMappingURL=chunk-4AMAFNUD.js.map