@tangle-network/agent-runtime 0.173.0 → 0.174.1

package/dist/{redact-6S20u4Ii.d.ts → redact-DvLf4x1m.d.ts}

@@ -49,11 +49,38 @@ interface CandidateGenerator {
 }
 //#endregion
 //#region src/improvement/agentic-generator.d.ts
-/** Outcome of verifying a candidate worktree. `feedback` (compiler errors,
- *  failing test output) is fed into the next shot when `ok` is false. */
+/**
+ * Outcome of verifying a candidate worktree.
+ *
+ * `ok` answers "is this tree shippable". `keepGoing` answers "should the budget
+ * stop here", and `score` ranks this tree against the other trees the same
+ * candidate produced — three separate questions, so a verifier can pass a tree
+ * and still spend the shots it was given.
+ *
+ * `feedback` (compiler errors, failing test output, or the reason a passing
+ * tree is being sent back) is fed into the next shot.
+ */
 interface VerifyResult {
   ok: boolean;
   feedback?: string;
+  /**
+   * Spend the remaining shots instead of returning this tree now.
+   *
+   * Read only when `ok` is true: a failed verification already spends the next
+   * shot. Omitted means the first passing tree ends the candidate.
+   */
+  keepGoing?: boolean;
+  /**
+   * How good this tree is, for ranking it against the other passing trees of
+   * this candidate. Higher wins; a tie keeps the LATER tree, which is the one
+   * already on disk and the one the author refined last.
+   *
+   * Only a passing tree is ranked — a tree that failed verification is never a
+   * candidate, whatever it scored. Score every passing tree or none of them: a
+   * scored tree cannot be ranked against an unscored one, and mixing the two
+   * fails the run rather than guessing an order.
+   */
+  score?: number;
 }
 /** Verifies the edited worktree. Sync or async; throws only on a setup fault
  *  (a candidate that fails verification returns `{ok:false}`, it does not
@@ -104,10 +131,25 @@ type AgenticGeneratorShotDisposition = {
   readonly worktreePath: string;
   readonly stage: 'raw-trace-evidence' | 'verification';
   readonly feedback: string | null;
+} | {
+  /** The tree passed verification and the verifier asked for another shot,
+   *  so it was snapshotted and the budget continues. */
+  readonly kind: 'kept';
+  readonly worktreePath: string;
+  /** The rank the verifier gave this tree, or null when it scored nothing. */
+  readonly score: number | null;
+  /** Whether this tree is now the best one this candidate has produced. */
+  readonly best: boolean;
+  readonly feedback: string | null;
 } | {
   readonly kind: 'accepted';
   readonly worktreePath: string;
   readonly verified: boolean;
+  /** One-based shot whose tree was put back into the worktree because it
+   *  outranked the tree on disk; null when the tree on disk is the one that
+   *  ships. Non-null is the record that best-of-n moved bytes rather than
+   *  only ranking them. */
+  readonly restoredFromShot: number | null;
 } | {
   readonly kind: 'setup-error';
   readonly worktreePath: string;
@@ -144,8 +186,10 @@ interface AgenticGeneratorOptions {
   /** Verify the worktree after each dirtying shot. When set, a candidate that
    *  fails verification is NOT returned — the failure feeds the next shot
    *  (verify-in-session), up to `maxShots`; a candidate that never verifies is
-   *  discarded (`applied:false`), never shipped. Omitted means the first dirty
-   *  shot is the candidate. See `commandVerifier`. */
+   *  discarded (`applied:false`), never shipped. A verifier that returns
+   *  `keepGoing` passes a tree AND spends the remaining shots, and the
+   *  best-scoring tree is the one that ships. Omitted means the first dirty
+   *  shot is the candidate. See `commandVerifier` and `VerifyResult`. */
   verify?: Verifier;
   /** Test seam — inject the worktree-dirty check (defaults to `git status`). */
   isDirty?: (worktreePath: string) => boolean;
@@ -550,4 +594,4 @@ declare function defaultRedactor(value: unknown): unknown;
 declare function resolveRedactor(redact: Redactor | false | undefined): Redactor;
 //#endregion
 export { agenticGenerator as $, ImprovementCandidate as A, ImprovementProfilePopulationLineage as B, ImproveProfileComponents as C, ImproveScenarioPartitions as D, ImproveRuntimeCodeGeneratorOptions as E, ImprovementProfileCandidatePopulationAvailable as F, ReadonlyAgentProfile as G, ImprovementProfilePopulationObservationSource as H, ImprovementProfileCandidatePopulationUnavailable as I, AgenticGeneratorShotDisposition as J, AgenticGeneratorExecutorForWorktree as K, ImprovementProfilePopulationArtifactSource as L, ImprovementMaterializedProfilePopulationCandidate as M, ImprovementProfileCandidate as N, ImproveSkillsOptions as O, ImprovementProfileCandidatePopulation as P, VerifyResult as Q, ImprovementProfilePopulationCandidate as R, ImproveProfileAgent as S, ImproveResult as T, ImprovementRefusedProfilePopulationCandidate as U, ImprovementProfilePopulationLineageNode as V, DeepReadonly as W, AgenticGeneratorShotReceipt as X, AgenticGeneratorShotExecution as Y, Verifier as Z, ImproveMethodOptions as _, ImproveCandidateValidationInput as a, ImproveOptimizationRunOptions as b, ImproveCodeOptions as c, ImproveCost as d, commandVerifier as et, ImproveCustomCodeGeneratorOptions as f, ImproveMethodLineage as g, ImproveMethodFactory as h, improve as i, ImprovementCodeCandidate as j, ImproveSurface as k, ImproveCodeResult as l, ImproveMethodContext as m, defaultRedactor as n, CandidateGenerator as nt, ImproveCandidateValidator as o, ImproveLineage as p, AgenticGeneratorOptions as q, resolveRedactor as r, ImproveCodeBaseOptions as s, Redactor as t, defaultBuildPrompt as tt, ImproveCodeRunOptions as u, ImproveMethodResult as v, ImproveProfileSurface as w, ImproveOptions as x, ImproveMethodSource as y, ImprovementProfilePopulationCandidateSource as z };
-//# sourceMappingURL=redact-6S20u4Ii.d.ts.map
+//# sourceMappingURL=redact-DvLf4x1m.d.ts.map

package/dist/{runtime-l9Q9-Dal.js → runtime-CojgP-hr.js}

@@ -9,14 +9,14 @@ import { i as redactProtectedValue, r as redactProtectedReason } from "./protect
 import { c as notifySandboxEventObserver, m as parseCanonicalTransportEvent, p as extractTransportEventIdentity } from "./sandbox-events-BVjstFgb.js";
 import { n as executableAgentSpecSnapshot, t as executableAgentProfileSnapshot } from "./executable-spec-CkGvdPds.js";
 import { c as profileModelExecutionSettings, i as concreteModelId, l as profileProviderModel, o as enforceTokenLimits, t as assertExecutableAgentProfile } from "./model-policy-Sw4ywhtL.js";
-import { Ct as createSandboxLineage, Dt as runBrainLoop, Et as routerBrain, K as createWorktreeCliExecutor, Ot as canonicalObservedModel, St as runAgentRounds, U as createExecutor, W as createExecutorRegistry, bt as defaultSelectWinner, et as createPushTraceSource, f as withDriverExecutor, k as rollingDispatch, n as createSupervisor, wt as probeSandboxCapabilities, y as settledToIteration } from "./supervisor-cAFpYJWF.js";
+import { Ct as createSandboxLineage, Dt as runBrainLoop, Et as routerBrain, K as createWorktreeCliExecutor, Ot as canonicalObservedModel, St as runAgentRounds, U as createExecutor, W as createExecutorRegistry, bt as defaultSelectWinner, et as createPushTraceSource, f as withDriverExecutor, k as rollingDispatch, n as createSupervisor, wt as probeSandboxCapabilities, y as settledToIteration } from "./supervisor-Bt1XLCVq.js";
 import "./environment-provider-Bn3652YU.js";
 import { i as notifyRuntimeHookEvent } from "./runtime-hooks-tXpAarhW.js";
-import { C as observe, O as strategyAuthorMethod, T as profileChatClient, b as sample, v as refine, x as sampleThenRefine, y as runAgentic } from "./structural-rollout-CIK7nvSH.js";
-import { At as gateOnDeliverable, jt as mapExecutorResult, n as supervise } from "./supervise-Dq_D3QbE.js";
+import { C as observe, O as strategyAuthorMethod, T as profileChatClient, b as sample, v as refine, x as sampleThenRefine, y as runAgentic } from "./structural-rollout-BUYA61iV.js";
+import { At as gateOnDeliverable, jt as mapExecutorResult, n as supervise } from "./supervise-Ci0RfWQF.js";
 import { t as assertAuthoredCode } from "./authored-code-DzYtiflw.js";
-import "./authoring-B4aR-Tea.js";
-import "./graph-CoSt0kup.js";
+import "./authoring-DsLNInAz.js";
+import "./graph-BbeHgLXH.js";
 import { AgentEnvironmentCapabilitiesSchema, AgentExactRunControlRefSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStatusSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentNativeContextContinuationResultSchema, AgentTurnResultSchema, InteractionAcknowledgementSchema, InteractionResponseCommandSchema, NativeContextBoundaryProofSchema, NativeContextContinuationRequestSchema, RuntimeEventEnvelopeSchema, TerminalReplayWindowSchema, TerminalSessionRefSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentNativeContextContinuationResultMatchesRequest, agentProfileSchema, canonicalAgentProfileDigest, canonicalCandidateDigest, exactAgentInteractiveSessionStart, nativeContextContinuationTurnDigest, validateAgentProfileSecurity } from "@tangle-network/agent-interface";
 import { CODING_HARNESSES, DEFAULT_TRACE_ANALYST_KINDS, InMemoryTraceStore, OUTPUT_VALUE, benjaminiHochberg, buildTrajectory, computeFindingId as computeFindingId$1, confidenceInterval, expandProfileAxes, makeFinding as makeFinding$1, pairedBootstrap, paretoFrontier, wilcoxonSignedRank, wilson } from "@tangle-network/agent-eval";
 import { heldoutSignificance, runProfileMatrix } from "@tangle-network/agent-eval/campaign";
@@ -7360,4 +7360,4 @@ function tail(s) {
 //#endregion
 export { equalKOnCost as $, chatWorkerSeam as A, completionAuthorizes as At, SandboxRunAbortError as B, auditIntent as Bt, withUntrackedArtifacts as C, defineLeaderboard as Ct, codeModeSupervisorTools as D, loopCampaignDispatch as Dt, runCoderChecks as E, inlineSandboxClient as Et, selectChampion as F, pairwiseSignificance as Ft, reconnectRetainedInteractiveRun as G, createMcpEnvironment as Gt, printBenchmarkReport as H, McpSpawnFault as Ht, assertStrategyContract as I, renderLeaderboardHtml as It, reconnectRetainedRun as J, mcpSecretEnvMetadataKey as Jt, recoverRetainedInteractiveRun as K, sanitizeMcpToolSchema as Kt, authorStrategy as L, renderLeaderboardMarkdown as Lt, discriminatingMeans as M, sentinelCompletion as Mt, pickChampion as N, stopSentinel as Nt, unsafeInProcessRunner as O, loopDispatch as Ot, runStrategyEvolution as P, leaderboard as Pt, promotionGate as Q, strategyAuthorContract as R, renderLeaderboardSvg as Rt, copyUntrackedIntoClone as S, harvestCorpus as St, patchDelivered as T, localSandboxClient as Tt, runBenchmark as U, connectStdioMcp as Ut, openSandboxRun as V, defaultAuditorInstruction as Vt, claimRetainedInteractiveControl as W, materializeLocalMcp as Wt, startRetainedRun as X, resolveSecretEnv as Xt, recoverRetainedRun as Y, resolveMcpServerLaunch as Yt, startRetainedRunInEnvironment as Z, secretEnvOfMcpServer as Zt, NOTE_MAX_CHARS as _, assertTraceDerivedFindings as _t, localShell as a, registerShape as at, composeWorkerEvidence as b, registryScopeAnalyst as bt, createVerifierEnvironment as c, renderCorpusToInstructions as ct, harvestSurfaceDiffs as d, loopUntil as dt, trajectoryReport as et, analystsFromRegistry as f, panel as ft, EVIDENCE_MAX_CHARS as g, widen as gt, worktreeFanout as h, verify as ht, jjWorkspace as i, createShapeRegistry as it, createChatSessionStore as j, deterministicCompletion as jt, chatTransportExecutor as k, superviseDispatch as kt, boxSurfaceReader as l, fanout as lt, superviseSurface as m, selectValidWinner as mt, makeFinding$1 as n, runPersonified as nt, runInWorkspace as o, FileCorpus as ot, failuresAnalyst as p, pipeline as pt, startRetainedInteractiveRun as q, envKeyProvider as qt, gitWorkspace as r, builtinShapes as rt, createWaterfallCollector as s, InMemoryCorpus as st, computeFindingId$1 as t, definePersona as tt, fsSurfaceReader as u, flatWidenGate as ut, VERIFY_TAIL_CHARS as v, buildSteerContext as vt, analyzeTrace as w, resolveSandboxClient as wt, settledWorkerOut as x, inProcessSandboxClient as xt, closingWorkerNote as y, createScopeAnalyst as yt, strategyAuthorSystemPrompt as z, renderPairwiseMarkdown as zt };
 
-//# sourceMappingURL=runtime-l9Q9-Dal.js.map
+//# sourceMappingURL=runtime-CojgP-hr.js.map