@kitman-sh/sdk 0.10.81 → 0.10.83

package/dist/build/index.js

@@ -4,7 +4,7 @@ import {
   KitDigest,
   AgentDeclaration,
   KitDeclarations
-} from "../chunk-9ff7wyqt.js";
+} from "../chunk-cqknxyv9.js";
 import {
   digestSha256,
   digestSha512,
@@ -13,7 +13,7 @@ import {
   RunnerRpcProtocolVersion,
   describeFlag2,
   Described2
-} from "../chunk-hrwq77a0.js";
+} from "../chunk-3pz068kn.js";
 
 // packages/core/src/json.ts
 import * as Schema from "effect/Schema";

package/dist/{chunk-hrwq77a0.js → chunk-3pz068kn.js}

@@ -22,6 +22,7 @@ import {
   ProgramWorkUnit,
   ApprovedCheck,
   MeasurePlan2,
+  ResolveSpec,
   WorkUnitClaimResult,
   WorkUnitClaimInput,
   WorkUnitHeartbeatInput,
@@ -29,11 +30,12 @@ import {
   WorkUnitReleaseInput,
   WorkUnitCompletion,
   measureDeferred2,
+  resolveDeferred2,
   loopWorkflow2,
   executeLoop2,
   LoopCheckError2,
   checkLoop2
-} from "./chunk-9ff7wyqt.js";
+} from "./chunk-cqknxyv9.js";
 // packages/core/src/agent-environment.ts
 import * as Schema from "effect/Schema";
 var AgentEnvironmentPolicy = Schema.Union([Schema.Literal("recommended"), Schema.Literal("required")]);
@@ -916,7 +918,8 @@ class RunnerCapabilityRpcs extends RpcGroup.make(Rpc.make("PutQuestion", {
       plan: MeasurePlan2,
       samples: Schema7.Int,
       calibrate: Schema7.Boolean
-    }))
+    })),
+    resolve: Schema7.optionalKey(ResolveSpec)
   },
   success: Schema7.Struct({ verificationId: Schema7.String }),
   error: RunnerRpcError
@@ -1057,6 +1060,7 @@ class RunnerCapabilityRpcs extends RpcGroup.make(Rpc.make("PutQuestion", {
     runnerChecks: Schema7.optionalKey(Schema7.Array(Schema7.String)),
     approved: Schema7.optionalKey(Schema7.String),
     repository: Schema7.optionalKey(Schema7.String),
+    targetBranch: Schema7.optionalKey(Schema7.String),
     conflicts: Schema7.optionalKey(Schema7.Boolean),
     needsRebase: Schema7.optionalKey(Schema7.Boolean),
     target: Schema7.optionalKey(Schema7.Struct({
@@ -1417,12 +1421,13 @@ var runnerHost = (capabilities) => ({
   })).pipe(Effect2.asVoid),
   startVerification: (launch) => requested2(launch.step, capabilities.startVerification({
     step: launch.step,
-    deferredName: (launch.measure === undefined ? verifyDeferred2 : measureDeferred2)(launch.step).name,
+    deferredName: (launch.resolve !== undefined ? resolveDeferred2 : launch.measure === undefined ? verifyDeferred2 : measureDeferred2)(launch.step).name,
     ...launch.revision === undefined ? undefined : { revision: launch.revision },
     ...launch.checks === undefined ? undefined : { checks: launch.checks },
     ...launch.suggested === undefined ? undefined : { suggested: launch.suggested },
     ...launch.rerunFailed === undefined ? undefined : { rerunFailed: launch.rerunFailed },
-    ...launch.measure === undefined ? undefined : { measure: launch.measure }
+    ...launch.measure === undefined ? undefined : { measure: launch.measure },
+    ...launch.resolve === undefined ? undefined : { resolve: launch.resolve }
   })).pipe(Effect2.asVoid),
   startAgentWork: (launch) => requested2(launch.step, capabilities.startAgentStep({
     step: launch.step,
@@ -1648,7 +1653,8 @@ var rpcProgramPorts2 = (rpc, work) => {
       ...verification.checks === undefined ? undefined : { checks: [...verification.checks] },
       ...verification.suggested === undefined ? undefined : { suggested: [...verification.suggested] },
       ...verification.rerunFailed === undefined ? undefined : { rerunFailed: verification.rerunFailed },
-      ...verification.measure === undefined ? undefined : { measure: verification.measure }
+      ...verification.measure === undefined ? undefined : { measure: verification.measure },
+      ...verification.resolve === undefined ? undefined : { resolve: { revisions: [...verification.resolve.revisions] } }
     }),
     startAgentStep: ({ secrets, ...step }) => rpc.startAgentStep({ lease, ...step, ...secrets === undefined ? undefined : { secrets: [...secrets] } }),
     awaitEvent: (wait) => rpc.awaitEvent({ lease, ...wait }),

package/dist/{chunk-9ff7wyqt.js → chunk-cqknxyv9.js}

@@ -3379,6 +3379,7 @@ var PipelineStatus2 = Schema20.Struct({
   runnerChecks: Schema20.optionalKey(Schema20.Array(Schema20.String)),
   approved: Schema20.optionalKey(Schema20.String),
   repository: Schema20.optionalKey(Schema20.String),
+  targetBranch: Schema20.optionalKey(Schema20.String),
   conflicts: Schema20.optionalKey(Schema20.Boolean),
   needsRebase: Schema20.optionalKey(Schema20.Boolean),
   target: Schema20.optionalKey(Schema20.Struct({ branch: Schema20.String, head: Schema20.String, jobs: Schema20.Array(PipelineJob2) }))
@@ -3608,13 +3609,13 @@ var draftUpdate2 = (name, request) => hostActivity(name, "draft_update", "draft_
 import * as ConfigProvider from "effect/ConfigProvider";
 import * as Context3 from "effect/Context";
 import * as Data2 from "effect/Data";
-import * as Effect8 from "effect/Effect";
+import * as Effect9 from "effect/Effect";
 import * as Exit3 from "effect/Exit";
 import * as Layer from "effect/Layer";
 import * as Option2 from "effect/Option";
 import * as Record12 from "effect/Record";
 import * as Schema28 from "effect/Schema";
-import { DurableDeferred as DurableDeferred4, Workflow, WorkflowEngine } from "effect/workflow";
+import { DurableDeferred as DurableDeferred5, Workflow, WorkflowEngine } from "effect/workflow";
 
 // packages/core/src/resource-claim.ts
 import * as Schema21 from "effect/Schema";
@@ -3946,6 +3947,12 @@ var MeasureEvidence = Schema26.Struct({
   head: MeasureSamples,
   baseAgain: Schema26.optionalKey(MeasureSamples)
 });
+var ResolveSpec = Schema26.Struct({
+  revisions: Schema26.Array(Schema26.String.check(Schema26.isMinLength(1), Schema26.isMaxLength(240))).check(Schema26.isMinLength(1), Schema26.isMaxLength(10))
+});
+var ResolvedRevisions2 = Schema26.Struct({
+  commits: Schema26.Array(Schema26.String.check(Schema26.isPattern(new RegExp("^[0-9a-f]{40}([0-9a-f]{24})?$", "u"))))
+});
 var VerificationWorkUnit = Schema26.Struct({
   kind: Schema26.Literal("verification"),
   id: Id,
@@ -3958,6 +3965,7 @@ var VerificationWorkUnit = Schema26.Struct({
   baseline: Schema26.optionalKey(Schema26.String.check(Schema26.isMinLength(1), Schema26.isMaxLength(300))),
   checks: Schema26.Array(RepositoryCheck).check(Schema26.isMaxLength(50)),
   measure: Schema26.optionalKey(MeasureSpec),
+  resolve: Schema26.optionalKey(ResolveSpec),
   hosts: Schema26.optionalKey(Schema26.Array(NetworkHost)),
   storageOrigin: StorageOrigin
 });
@@ -4006,7 +4014,8 @@ var TreeEvidence = Schema26.Struct({
 var VerificationEvidence = Schema26.Struct({
   head: TreeEvidence,
   baseline: Schema26.optionalKey(TreeEvidence),
-  measurement: Schema26.optionalKey(MeasureEvidence)
+  measurement: Schema26.optionalKey(MeasureEvidence),
+  resolved: Schema26.optionalKey(ResolvedRevisions2)
 });
 var BoundaryChange = Schema26.Struct({
   kind: Schema26.Literal("change"),
@@ -4049,6 +4058,7 @@ var WorkUnitOutcome = Schema26.Struct({
   evidence: Schema26.optionalKey(VerificationEvidence),
   boundary: Schema26.optionalKey(BoundaryChange),
   catchUp: Schema26.optionalKey(CatchUp),
+  syncedTarget: Schema26.optionalKey(Revision),
   harnessHold: Schema26.optionalKey(HarnessHold),
   restart: Schema26.optionalKey(StepRestart),
   failureSummary: Schema26.optionalKey(Schema26.String.check(Schema26.isMinLength(1), Schema26.isMaxLength(4000)))
@@ -4182,6 +4192,16 @@ var measure2 = (name, request) => takeStep2(name, "measure", "measure", Effect7.
   });
 }));
 
+// packages/sdk/src/loop/resolve.ts
+import * as Effect8 from "effect/Effect";
+import { DurableDeferred as DurableDeferred4 } from "effect/workflow";
+var resolveDeferred2 = (step) => DurableDeferred4.make(`resolve/${step}`, { success: ResolvedRevisions2, error: StepFailed2 });
+var resolveRevisions2 = (name, revisions) => takeStep2(name, "verify", "verify", Effect8.gen(function* () {
+  const deferred = resolveDeferred2(name);
+  yield* launch2(deferred, (host, token) => host.startVerification({ step: name, resolve: { revisions }, token }));
+  return (yield* DurableDeferred4.await(deferred)).commits;
+}));
+
 // packages/sdk/src/loop/test-loop.ts
 var LoopJournal2 = Schema28.Struct({
   activities: Schema28.Record(Schema28.String, Schema28.Json),
@@ -4193,56 +4213,56 @@ class ScriptedFailure2 extends Data2.TaggedClass("ScriptedFailure") {
 var scriptedFailure2 = (reason) => new ScriptedFailure2({ reason });
 var defaultActivities = {
   changeRequest: {
-    run: () => Effect8.succeed({ id: "change-request-1", number: "1", url: "test://change-requests/1" })
+    run: () => Effect9.succeed({ id: "change-request-1", number: "1", url: "test://change-requests/1" })
   },
-  writeBack: { run: () => Effect8.void },
-  artifact: { run: (request) => Effect8.succeed({ artifactId: request.title }) },
-  file: { run: (_request, step) => Effect8.succeed({ id: `file-${step}` }) },
-  note: { run: () => Effect8.void },
-  comment: { run: () => Effect8.void },
+  writeBack: { run: () => Effect9.void },
+  artifact: { run: (request) => Effect9.succeed({ artifactId: request.title }) },
+  file: { run: (_request, step) => Effect9.succeed({ id: `file-${step}` }) },
+  note: { run: () => Effect9.void },
+  comment: { run: () => Effect9.void },
   createTasks: {
-    run: (request) => Effect8.succeed({ tasks: request.tickets.map((ticket) => ({ key: ticket.key, taskId: `task-${ticket.key}` })) })
+    run: (request) => Effect9.succeed({ tasks: request.tickets.map((ticket) => ({ key: ticket.key, taskId: `task-${ticket.key}` })) })
   },
-  alertTask: { run: () => Effect8.succeed({ taskId: "task-alert", created: true }) },
+  alertTask: { run: () => Effect9.succeed({ taskId: "task-alert", created: true }) },
   integrationBranch: {
-    run: (request) => Effect8.succeed({
+    run: (request) => Effect9.succeed({
       repoBindingId: request.repoBindingId ?? "repo",
       branch: "kitman/run/integration",
       revision: "integration-head"
     })
   },
   mergeChangeRequest: {
-    run: (request) => Effect8.succeed({ status: "merged", revision: `merged-${request.changeRequestId}` }),
-    close: () => Effect8.succeed({ closed: true }),
-    rerun: () => Effect8.succeed({ head: "head", pipelines: 1 }),
-    report: () => Effect8.succeed({ head: "head", status: "success" }),
-    approve: (request) => Effect8.succeed({ approved: true, reviewId: `review-${request.changeRequestId}` })
+    run: (request) => Effect9.succeed({ status: "merged", revision: `merged-${request.changeRequestId}` }),
+    close: () => Effect9.succeed({ closed: true }),
+    rerun: () => Effect9.succeed({ head: "head", pipelines: 1 }),
+    report: () => Effect9.succeed({ head: "head", status: "success" }),
+    approve: (request) => Effect9.succeed({ approved: true, reviewId: `review-${request.changeRequestId}` })
   },
   release: {
-    run: (request) => Effect8.succeed({
+    run: (request) => Effect9.succeed({
       tag: request.tag,
       revision: request.revision ?? "base-head",
       url: `test://releases/${request.tag}`
     })
   },
-  transcripts: { run: () => Effect8.succeed({ runs: [] }) },
+  transcripts: { run: () => Effect9.succeed({ runs: [] }) },
   changeRequestRead: {
-    pipeline: () => Effect8.succeed({ head: "head", status: "success", source: "forge", jobs: [] }),
-    reviewThreads: () => Effect8.succeed({ threads: [] }),
-    opened: () => Effect8.succeed({ changeRequests: [] }),
-    own: () => Effect8.succeed({ changeRequests: [] })
+    pipeline: () => Effect9.succeed({ head: "head", status: "success", source: "forge", jobs: [], targetBranch: "main" }),
+    reviewThreads: () => Effect9.succeed({ threads: [] }),
+    opened: () => Effect9.succeed({ changeRequests: [] }),
+    own: () => Effect9.succeed({ changeRequests: [] })
   },
-  propose: { run: (request, step) => Effect8.succeed({ kind: request.kind, id: `${request.kind}-${step}` }) },
+  propose: { run: (request, step) => Effect9.succeed({ kind: request.kind, id: `${request.kind}-${step}` }) },
   projectActivity: {
-    run: (request) => Effect8.succeed({ project: { id: request.projectId, name: request.projectId }, runs: [], taskChanges: [] })
+    run: (request) => Effect9.succeed({ project: { id: request.projectId, name: request.projectId }, runs: [], taskChanges: [] })
   },
-  draftUpdate: { run: (_, step) => Effect8.succeed({ id: `draft-${step}` }) }
+  draftUpdate: { run: (_, step) => Effect9.succeed({ id: `draft-${step}` }) }
 };
-var withoutServices = (effect) => Effect8.orDie(Effect8.provide(effect, Context3.empty()));
+var withoutServices = (effect) => Effect9.orDie(Effect9.provide(effect, Context3.empty()));
 var deferredExit = (deferred) => Schema28.Exit(Schema28.toCodecJson(deferred.successSchema), Schema28.toCodecJson(deferred.errorSchema), Schema28.toCodecJson(Schema28.Defect()));
 var journaled = (engine, journal, ran) => ({
   ...engine,
-  activityExecute: (activity, attempt) => Effect8.gen(function* () {
+  activityExecute: (activity, attempt) => Effect9.gen(function* () {
     const key = `${activity.name}/${attempt}`;
     const recorded = journal.activities[key];
     if (recorded !== undefined)
@@ -4256,7 +4276,7 @@ var journaled = (engine, journal, ran) => ({
     }
     return result;
   }),
-  deferredResult: (deferred) => Effect8.gen(function* () {
+  deferredResult: (deferred) => Effect9.gen(function* () {
     const recorded = journal.deferreds[deferred.name];
     if (recorded !== undefined)
       return Option2.some(yield* withoutServices(Schema28.decodeEffect(Schema28.toCodecJson(deferredExit(deferred)))(recorded)));
@@ -4268,12 +4288,13 @@ var journaled = (engine, journal, ran) => ({
 });
 var scriptedExit = (scripted, failure) => scripted === undefined ? Exit3.fail(failure("nothing was scripted for this Step")) : scripted instanceof ScriptedFailure2 ? Exit3.fail(failure(scripted.reason)) : Exit3.succeed(scripted);
 var scriptedHost = (script, engine, agentLaunches, childLaunches, waits, verifyLaunches) => {
-  const resolve = (deferred, token, exit) => DurableDeferred4.done(deferred, { token, exit }).pipe(Effect8.provideService(WorkflowEngine.WorkflowEngine, engine));
+  const resolve = (deferred, token, exit) => DurableDeferred5.done(deferred, { token, exit }).pipe(Effect9.provideService(WorkflowEngine.WorkflowEngine, engine));
   return {
-    startAgentWork: (launch) => Effect8.andThen(Effect8.sync(() => agentLaunches.push({
+    startAgentWork: (launch) => Effect9.andThen(Effect9.sync(() => agentLaunches.push({
       step: launch.step,
       agent: launch.agent,
       prompt: launch.prompt,
+      output: launch.output,
       ...launch.skill === undefined ? undefined : { skill: launch.skill },
       ...launch.secrets === undefined ? undefined : { secrets: launch.secrets },
       ...launch.mergeTarget === undefined ? undefined : { mergeTarget: launch.mergeTarget }
@@ -4284,7 +4305,7 @@ var scriptedHost = (script, engine, agentLaunches, childLaunches, waits, verifyL
       const answer = script.answers?.[launch.step] ?? auto ?? (attended ? undefined : launch.default);
       return resolve(answerDeferred2(launch.step), launch.token, answer === undefined ? Exit3.fail(new StepFailed2({ step: launch.step, reason: "no answer was scripted" })) : Exit3.succeed(answer));
     },
-    admitChild: (launch) => Effect8.andThen(Effect8.sync(() => childLaunches.push({
+    admitChild: (launch) => Effect9.andThen(Effect9.sync(() => childLaunches.push({
       step: launch.step,
       loop: launch.loop,
       input: launch.input,
@@ -4301,9 +4322,17 @@ var scriptedHost = (script, engine, agentLaunches, childLaunches, waits, verifyL
       });
       return resolve(eventDeferred2(launch.step), launch.token, event === undefined ? Exit3.fail(new WaitTimedOut2({ step: launch.step, event: launch.event })) : Exit3.succeed(event));
     },
-    claimResource: (launch) => Effect8.flatMap(script.claimed?.({ step: launch.step, resource: launch.resource, action: launch.action }) ?? Effect8.undefined, (settled) => launch.action === "let_go" ? resolve(letGoDeferred2(launch.step), launch.token, Exit3.succeed(null)) : resolve(claimDeferred2(launch.step), launch.token, Exit3.succeed(settled ?? script.claims?.[launch.step] ?? { status: "granted", resource: launch.resource }))),
+    claimResource: (launch) => Effect9.flatMap(script.claimed?.({ step: launch.step, resource: launch.resource, action: launch.action }) ?? Effect9.undefined, (settled) => launch.action === "let_go" ? resolve(letGoDeferred2(launch.step), launch.token, Exit3.succeed(null)) : resolve(claimDeferred2(launch.step), launch.token, Exit3.succeed(settled ?? script.claims?.[launch.step] ?? { status: "granted", resource: launch.resource }))),
     startVerification: (launch) => {
       const scripted = script.verifications?.[launch.step];
+      if (launch.resolve !== undefined) {
+        const commits = launch.resolve.revisions.map((revision) => {
+          const scriptedCommit = script.commits?.[revision];
+          return scriptedCommit === undefined ? madeUpCommit(revision) : scriptedCommit;
+        });
+        const unnamed = launch.resolve.revisions.filter((_, index) => commits[index] === null);
+        return resolve(resolveDeferred2(launch.step), launch.token, unnamed.length > 0 ? Exit3.fail(new StepFailed2({ step: launch.step, reason: `No commit named ${unnamed.join(", ")}` })) : Exit3.succeed({ commits: commits.filter((commit) => commit !== null) }));
+      }
       if (launch.measure === undefined)
         verifyLaunches.push({
           step: launch.step,
@@ -4333,14 +4362,26 @@ var scriptedHost = (script, engine, agentLaunches, childLaunches, waits, verifyL
     }
   };
 };
+var fullSha = /^[0-9a-f]{40}$/u;
+var madeUpCommit = (revision) => {
+  if (fullSha.test(revision))
+    return revision;
+  const word = (seed) => {
+    let hash = seed;
+    for (const char of revision)
+      hash = Math.imul(hash ^ char.charCodeAt(0), 16777619) >>> 0;
+    return hash.toString(16).padStart(8, "0");
+  };
+  return [2166136261, 16777619, 1540483477, 668265263, 374761393].map(word).join("");
+};
 var loopWorkflow2 = (loop) => Workflow.make(`kitman-loop/${loop.id}`, {
   payload: { input: Schema28.Json },
   idempotencyKey: () => loop.id,
   success: loop.output,
   error: Schema28.declare((_error) => true)
 });
-var executeLoop2 = (loop, runtime) => ({ input }) => Effect8.gen(function* () {
-  const decoded = yield* Schema28.decodeEffect(Schema28.toCodecJson(loop.input))(input).pipe(Effect8.mapError((error) => new InputInvalid2({ loop: loop.id, message: error.message })));
+var executeLoop2 = (loop, runtime) => ({ input }) => Effect9.gen(function* () {
+  const decoded = yield* Schema28.decodeEffect(Schema28.toCodecJson(loop.input))(input).pipe(Effect9.mapError((error) => new InputInvalid2({ loop: loop.id, message: error.message })));
   const run = LoopRun2.of({
     loop: loop.id,
     agents: loop.agents,
@@ -4350,7 +4391,7 @@ var executeLoop2 = (loop, runtime) => ({ input }) => Effect8.gen(function* () {
     steps: []
   });
   runtime.onRun?.(run);
-  return yield* loop.run(decoded).pipe(Effect8.provideService(LoopRun2, run), Effect8.provideService(LoopHost2, runtime.host), Effect8.provideService(ChangeRequestActivity2, runtime.activities.changeRequest), Effect8.provideService(WriteBackActivity2, runtime.activities.writeBack), Effect8.provideService(ArtifactActivity2, runtime.activities.artifact), Effect8.provideService(FileActivity2, runtime.activities.file), Effect8.provideService(NoteActivity2, runtime.activities.note), Effect8.provideService(CommentActivity2, runtime.activities.comment), Effect8.provideService(CreateTasksActivity2, runtime.activities.createTasks), Effect8.provideService(AlertTaskActivity2, runtime.activities.alertTask), Effect8.provideService(IntegrationBranchActivity2, runtime.activities.integrationBranch), Effect8.provideService(MergeChangeRequestActivity2, runtime.activities.mergeChangeRequest), Effect8.provideService(ReleaseActivity2, runtime.activities.release), Effect8.provideService(TranscriptsActivity2, runtime.activities.transcripts), Effect8.provideService(ChangeRequestReadActivity2, runtime.activities.changeRequestRead), Effect8.provideService(ProposeActivity2, runtime.activities.propose), Effect8.provideService(ProjectActivityActivity2, runtime.activities.projectActivity), Effect8.provideService(DraftUpdateActivity2, runtime.activities.draftUpdate));
+  return yield* loop.run(decoded).pipe(Effect9.provideService(LoopRun2, run), Effect9.provideService(LoopHost2, runtime.host), Effect9.provideService(ChangeRequestActivity2, runtime.activities.changeRequest), Effect9.provideService(WriteBackActivity2, runtime.activities.writeBack), Effect9.provideService(ArtifactActivity2, runtime.activities.artifact), Effect9.provideService(FileActivity2, runtime.activities.file), Effect9.provideService(NoteActivity2, runtime.activities.note), Effect9.provideService(CommentActivity2, runtime.activities.comment), Effect9.provideService(CreateTasksActivity2, runtime.activities.createTasks), Effect9.provideService(AlertTaskActivity2, runtime.activities.alertTask), Effect9.provideService(IntegrationBranchActivity2, runtime.activities.integrationBranch), Effect9.provideService(MergeChangeRequestActivity2, runtime.activities.mergeChangeRequest), Effect9.provideService(ReleaseActivity2, runtime.activities.release), Effect9.provideService(TranscriptsActivity2, runtime.activities.transcripts), Effect9.provideService(ChangeRequestReadActivity2, runtime.activities.changeRequestRead), Effect9.provideService(ProposeActivity2, runtime.activities.propose), Effect9.provideService(ProjectActivityActivity2, runtime.activities.projectActivity), Effect9.provideService(DraftUpdateActivity2, runtime.activities.draftUpdate));
 });
 var testLoop2 = (loop, script) => {
   const journal = {
@@ -4371,7 +4412,7 @@ var testLoop2 = (loop, script) => {
     ...overrides[key]
   }));
   const workflow = loopWorkflow2(loop);
-  const execute = (payload) => Effect8.gen(function* () {
+  const execute = (payload) => Effect9.gen(function* () {
     const engine = yield* WorkflowEngine.WorkflowEngine;
     return yield* executeLoop2(loop, {
       host: scriptedHost(script, engine, agentLaunches, childLaunches, waits, verifyLaunches),
@@ -4380,12 +4421,12 @@ var testLoop2 = (loop, script) => {
       onRun: (run) => {
         latestSteps = run.steps;
       }
-    })(payload).pipe(Effect8.provideService(WorkflowEngine.WorkflowEngine, journaled(engine, journal, ran)));
+    })(payload).pipe(Effect9.provideService(WorkflowEngine.WorkflowEngine, journaled(engine, journal, ran)));
   });
-  return Effect8.gen(function* () {
-    const result = yield* Effect8.exit(workflow.execute({ input: script.input }).pipe(Effect8.provideService(ConfigProvider.ConfigProvider, ConfigProvider.fromUnknown(script.secrets ?? {}))));
+  return Effect9.gen(function* () {
+    const result = yield* Effect9.exit(workflow.execute({ input: script.input }).pipe(Effect9.provideService(ConfigProvider.ConfigProvider, ConfigProvider.fromUnknown(script.secrets ?? {}))));
     return { result, steps: latestSteps, journal, activities: ran, agentLaunches, childLaunches, waits, verifyLaunches };
-  }).pipe(Effect8.provide(workflow.toLayer(execute).pipe(Layer.provideMerge(WorkflowEngine.layerMemory))));
+  }).pipe(Effect9.provide(workflow.toLayer(execute).pipe(Layer.provideMerge(WorkflowEngine.layerMemory))));
 };
 // packages/sdk/src/loop/review.ts
 import * as Schema29 from "effect/Schema";
@@ -4458,7 +4499,7 @@ var rallyStop2 = (input) => {
 var sameIds = (left, right) => left.length === right.length && left.every((id) => right.includes(id));
 // packages/sdk/src/loop/check.ts
 import * as Cause2 from "effect/Cause";
-import * as Effect9 from "effect/Effect";
+import * as Effect10 from "effect/Effect";
 import * as Exit5 from "effect/Exit";
 import * as Predicate3 from "effect/Predicate";
 import * as Schema30 from "effect/Schema";
@@ -4504,7 +4545,7 @@ class ReplayDiverged2 extends Schema30.TaggedError()("ReplayDiverged", {
   }
 }
 var LoopCheckError2 = Schema30.Union([CheckFailed2, StepNamedTwice2, ReplayDiverged2]);
-var checkLoop2 = (loop, check) => Effect9.gen(function* () {
+var checkLoop2 = (loop, check) => Effect10.gen(function* () {
   const first = yield* testLoop2(loop, check.script);
   if (Exit5.isFailure(first.result)) {
     const error = Cause2.squash(first.result.cause);
@@ -4542,10 +4583,11 @@ var merged = {
   settled: Schema31.Array(Schema31.String)
 };
 var SyncAnswer = Schema31.Union([UpToDate, Schema31.Struct(merged), Conflict]);
+var reported = { base: Schema31.optionalKey(Schema31.String) };
 var BaseSync2 = Schema31.Union([
-  UpToDate,
-  Schema31.Struct({ ...merged, catchUp: Schema31.optionalKey(CatchUp) }),
-  Conflict
+  Schema31.Struct({ ...UpToDate.fields, ...reported }),
+  Schema31.Struct({ ...merged, catchUp: Schema31.optionalKey(CatchUp), ...reported }),
+  Schema31.Struct({ ...Conflict.fields, ...reported })
 ]);
 var afterMerge = "One thing comes before any answer of merged, a clean merge included, and stopping above means stopping after it: before you answer merged, do what the repository's agent instructions say to do once the target branch is merged in, such as regenerating this branch's database migrations on top of the target's. Leave what that changes in the workspace: Kitman commits it.";
 var prompt = (target) => [
@@ -4588,4 +4630,4 @@ var continuingBrief2 = (continuing) => [
   "The ChangeRequest's description lists what was left unsettled; settle those first."
 ].join(`
 `);
-export { Numeric, isWholeNumber, guard, Id, Timestamp, canonicalJson, KitDigest, unansweredQuestionReason2, isUnansweredQuestion2, LoopCapabilities2, LoopManifest, AgentDeclaration, KitDeclarations, LoopOutcome2, capabilitiesOf2, defineLoop2, ManifestInvalid2, jsonSchemaOf2, loopManifest2, questionAdvice, EvidenceCheck2, VerifyResult2, OutcomeTable2, failsOn2, testsNotRunReasons2, evidenceGate2, StepFailed2, OutputInvalid2, QuestionRefused2, WaitTimedOut2, ChangeRequestClosed2, ChildFailed2, CapabilityDenied2, DuplicateStep2, InputInvalid2, LoopEvent2, LoopRun2, LoopHost2, agentDeferredNamed2, agentWorkDeferred2, syncDeferred2, answerDeferred2, childDeferred2, eventDeferred2, verifyDeferred2, takeStep2, launch2, agentWork2, agentWorkAs2, agentWorkOnce2, ask2, call2, waitFor2, verify2, suggestVerification2, PlanTicket2, PlanTickets2, BlockingCycle2, planWaves2, ChangeRequestRequest2, ChangeRequestResult2, WriteBackMilestones2, WriteBackRequest2, RunFile2, FileRequest2, ArtifactRequest2, ArtifactResult2, NoteRequest2, CreateTasksRequest2, CreateTasksResult2, AlertTaskRequest2, AlertTaskResult2, IntegrationBranchRequest2, IntegrationBranch2, MergeChangeRequestRequest2, MergeResult2, ApproveChangeRequestRequest2, ApproveChangeRequestResult2, CloseChangeRequestRequest2, CloseChangeRequestResult2, RerunPipelineRequest2, RerunPipelineResult2, ReportPipelineRequest2, ReportPipelineResult2, CommentRequest2, ReleaseRequest2, ReleaseResult2, ChangeRequestReadRequest2, PipelineJob2, PipelineStatus2, ReviewThread2, ReviewThreads2, OpenChangeRequestsRequest2, OpenChangeRequest2, OpenChangeRequests2, OwnChangeRequest2, OwnChangeRequests2, TranscriptPoint2, TranscriptsRequest2, TranscriptsResult2, ProposeRequest2, ProposeResult2, ProjectActivityRequest2, ProjectActivityResult2, DraftUpdateRequest2, DraftUpdateResult2, ChangeRequestActivity2, WriteBackActivity2, ArtifactActivity2, FileActivity2, NoteActivity2, CommentActivity2, CreateTasksActivity2, AlertTaskActivity2, IntegrationBranchActivity2, MergeChangeRequestActivity2, ReleaseActivity2, TranscriptsActivity2, ProposeActivity2, ProjectActivityActivity2, DraftUpdateActivity2, ChangeRequestReadActivity2, changeRequest2, writeBack2, artifact2, file2, note2, comment2, createTasks2, alertTask2, integrationBranch2, mergeChangeRequest2, approveChangeRequest2, closeChangeRequest2, pipelineMoved2, rerunPipeline2, reportPipeline2, release2, transcripts2, propose2, projectActivity2, pipelineStatus2, reviewThreads2, openChangeRequests2, ownChangeRequests2, draftUpdate2, ResourceName, ClaimResult2, claimDeferred2, letGoDeferred2, claim2, letGo2, WorkUnitRepoBinding, ProgramWorkUnit, CheckName2, ApprovedCheck, MeasurePlan2, WorkUnitClaimResult, WorkUnitClaimInput, WorkUnitHeartbeatInput, WorkUnitHeartbeatResult, WorkUnitReleaseInput, WorkUnitCompletion, MetricStats2, MeasureVerdict2, Measurement2, measureDeferred2, noiseFloor2, judgeMeasurement2, measure2, LoopJournal2, ScriptedFailure2, scriptedFailure2, loopWorkflow2, executeLoop2, testLoop2, Severity2, Finding2, MergedFinding2, Rebuttal2, RebuttalVerdict2, ScopeJudgement2, isBlocking2, mergeFindings2, splitDisputed2, settleRound2, rallyStop2, CheckFailed2, StepNamedTwice2, ReplayDiverged2, LoopCheckError2, checkLoop2, defineKit2, BaseSync2, syncBase2, Continuing2, continuingBrief2 };
+export { Numeric, isWholeNumber, guard, Id, Timestamp, canonicalJson, KitDigest, unansweredQuestionReason2, isUnansweredQuestion2, LoopCapabilities2, LoopManifest, AgentDeclaration, KitDeclarations, LoopOutcome2, capabilitiesOf2, defineLoop2, ManifestInvalid2, jsonSchemaOf2, loopManifest2, questionAdvice, EvidenceCheck2, VerifyResult2, OutcomeTable2, failsOn2, testsNotRunReasons2, evidenceGate2, StepFailed2, OutputInvalid2, QuestionRefused2, WaitTimedOut2, ChangeRequestClosed2, ChildFailed2, CapabilityDenied2, DuplicateStep2, InputInvalid2, LoopEvent2, LoopRun2, LoopHost2, agentDeferredNamed2, agentWorkDeferred2, syncDeferred2, answerDeferred2, childDeferred2, eventDeferred2, verifyDeferred2, takeStep2, launch2, agentWork2, agentWorkAs2, agentWorkOnce2, ask2, call2, waitFor2, verify2, suggestVerification2, PlanTicket2, PlanTickets2, BlockingCycle2, planWaves2, ChangeRequestRequest2, ChangeRequestResult2, WriteBackMilestones2, WriteBackRequest2, RunFile2, FileRequest2, ArtifactRequest2, ArtifactResult2, NoteRequest2, CreateTasksRequest2, CreateTasksResult2, AlertTaskRequest2, AlertTaskResult2, IntegrationBranchRequest2, IntegrationBranch2, MergeChangeRequestRequest2, MergeResult2, ApproveChangeRequestRequest2, ApproveChangeRequestResult2, CloseChangeRequestRequest2, CloseChangeRequestResult2, RerunPipelineRequest2, RerunPipelineResult2, ReportPipelineRequest2, ReportPipelineResult2, CommentRequest2, ReleaseRequest2, ReleaseResult2, ChangeRequestReadRequest2, PipelineJob2, PipelineStatus2, ReviewThread2, ReviewThreads2, OpenChangeRequestsRequest2, OpenChangeRequest2, OpenChangeRequests2, OwnChangeRequest2, OwnChangeRequests2, TranscriptPoint2, TranscriptsRequest2, TranscriptsResult2, ProposeRequest2, ProposeResult2, ProjectActivityRequest2, ProjectActivityResult2, DraftUpdateRequest2, DraftUpdateResult2, ChangeRequestActivity2, WriteBackActivity2, ArtifactActivity2, FileActivity2, NoteActivity2, CommentActivity2, CreateTasksActivity2, AlertTaskActivity2, IntegrationBranchActivity2, MergeChangeRequestActivity2, ReleaseActivity2, TranscriptsActivity2, ProposeActivity2, ProjectActivityActivity2, DraftUpdateActivity2, ChangeRequestReadActivity2, changeRequest2, writeBack2, artifact2, file2, note2, comment2, createTasks2, alertTask2, integrationBranch2, mergeChangeRequest2, approveChangeRequest2, closeChangeRequest2, pipelineMoved2, rerunPipeline2, reportPipeline2, release2, transcripts2, propose2, projectActivity2, pipelineStatus2, reviewThreads2, openChangeRequests2, ownChangeRequests2, draftUpdate2, ResourceName, ClaimResult2, claimDeferred2, letGoDeferred2, claim2, letGo2, WorkUnitRepoBinding, ProgramWorkUnit, CheckName2, ApprovedCheck, MeasurePlan2, ResolveSpec, ResolvedRevisions2, WorkUnitClaimResult, WorkUnitClaimInput, WorkUnitHeartbeatInput, WorkUnitHeartbeatResult, WorkUnitReleaseInput, WorkUnitCompletion, MetricStats2, MeasureVerdict2, Measurement2, measureDeferred2, noiseFloor2, judgeMeasurement2, measure2, resolveDeferred2, resolveRevisions2, LoopJournal2, ScriptedFailure2, scriptedFailure2, loopWorkflow2, executeLoop2, testLoop2, Severity2, Finding2, MergedFinding2, Rebuttal2, RebuttalVerdict2, ScopeJudgement2, isBlocking2, mergeFindings2, splitDisputed2, settleRound2, rallyStop2, CheckFailed2, StepNamedTwice2, ReplayDiverged2, LoopCheckError2, checkLoop2, defineKit2, BaseSync2, syncBase2, Continuing2, continuingBrief2 };

package/dist/loop/index.js

@@ -142,6 +142,7 @@ import {
   letGo2,
   CheckName2,
   MeasurePlan2,
+  ResolvedRevisions2,
   MetricStats2,
   MeasureVerdict2,
   Measurement2,
@@ -149,6 +150,8 @@ import {
   noiseFloor2,
   judgeMeasurement2,
   measure2,
+  resolveDeferred2,
+  resolveRevisions2,
   LoopJournal2,
   ScriptedFailure2,
   scriptedFailure2,
@@ -176,7 +179,7 @@ import {
   syncBase2,
   Continuing2,
   continuingBrief2
-} from "../chunk-9ff7wyqt.js";
+} from "../chunk-cqknxyv9.js";
 export {
   AlertTaskActivity2 as AlertTaskActivity,
   AlertTaskRequest2 as AlertTaskRequest,
@@ -265,6 +268,7 @@ export {
   ReportPipelineResult2 as ReportPipelineResult,
   RerunPipelineRequest2 as RerunPipelineRequest,
   RerunPipelineResult2 as RerunPipelineResult,
+  ResolvedRevisions2 as ResolvedRevisions,
   ReviewThread2 as ReviewThread,
   ReviewThreads2 as ReviewThreads,
   RunFile2 as RunFile,
@@ -338,6 +342,8 @@ export {
   release2 as release,
   reportPipeline2 as reportPipeline,
   rerunPipeline2 as rerunPipeline,
+  resolveDeferred2 as resolveDeferred,
+  resolveRevisions2 as resolveRevisions,
   reviewThreads2 as reviewThreads,
   scriptedFailure2 as scriptedFailure,
   settleRound2 as settleRound,

package/dist/program/index.js

@@ -1,5 +1,5 @@
 // @bun
-import"../chunk-9ff7wyqt.js";
+import"../chunk-cqknxyv9.js";
 import {
   JournalWriteFailed2,
   refusedStep2,
@@ -17,7 +17,7 @@ import {
   networkGuard2,
   carriedKits2,
   runKit2
-} from "../chunk-hrwq77a0.js";
+} from "../chunk-3pz068kn.js";
 export {
   Described2 as Described,
   JournalWriteFailed2 as JournalWriteFailed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitman-sh/sdk",
-  "version": "0.10.81",
+  "version": "0.10.83",
   "type": "module",
   "license": "UNLICENSED",
   "exports": {

package/types/packages/core/src/runner.d.ts

@@ -150,6 +150,8 @@ export declare const RunnerCapabilities: Schema.Struct<{
     }>>;
     /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
     readonly measure: Schema.optionalKey<Schema.Boolean>;
+    /** It resolves a verification's revisions to commits; a Runner without it is offered none. */
+    readonly resolve: Schema.optionalKey<Schema.Boolean>;
 }>;
 export declare const Runner: Schema.Struct<{
     readonly id: Schema.String;
@@ -261,6 +263,8 @@ export declare const Runner: Schema.Struct<{
         }>>;
         /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
         readonly measure: Schema.optionalKey<Schema.Boolean>;
+        /** It resolves a verification's revisions to commits; a Runner without it is offered none. */
+        readonly resolve: Schema.optionalKey<Schema.Boolean>;
     }>;
     /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
     readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;
@@ -603,6 +607,8 @@ export declare const RunnerCreate: Schema.Struct<{
         }>>;
         /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
         readonly measure: Schema.optionalKey<Schema.Boolean>;
+        /** It resolves a verification's revisions to commits; a Runner without it is offered none. */
+        readonly resolve: Schema.optionalKey<Schema.Boolean>;
     }>>;
     readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
 }>;
@@ -720,6 +726,8 @@ export declare const RunnerRegistrationResult: Schema.Struct<{
             }>>;
             /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
             readonly measure: Schema.optionalKey<Schema.Boolean>;
+            /** It resolves a verification's revisions to commits; a Runner without it is offered none. */
+            readonly resolve: Schema.optionalKey<Schema.Boolean>;
         }>;
         /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
         readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;
@@ -833,6 +841,8 @@ export declare const RunnerHeartbeatInput: Schema.Struct<{
         }>>;
         /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
         readonly measure: Schema.optionalKey<Schema.Boolean>;
+        /** It resolves a verification's revisions to commits; a Runner without it is offered none. */
+        readonly resolve: Schema.optionalKey<Schema.Boolean>;
     }>>;
     readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
 }>;
@@ -912,6 +922,8 @@ export declare const RunnerCapabilitiesUpdate: Schema.Struct<{
         }>>;
         /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
         readonly measure: Schema.optionalKey<Schema.Boolean>;
+        /** It resolves a verification's revisions to commits; a Runner without it is offered none. */
+        readonly resolve: Schema.optionalKey<Schema.Boolean>;
     }>;
     readonly labels: Schema.optionalKey<Schema.$Array<Schema.String>>;
 }>;
@@ -1604,6 +1616,8 @@ export declare const RunnerOperationsOverview: Schema.Struct<{
             }>>;
             /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
             readonly measure: Schema.optionalKey<Schema.Boolean>;
+            /** It resolves a verification's revisions to commits; a Runner without it is offered none. */
+            readonly resolve: Schema.optionalKey<Schema.Boolean>;
         }>;
         /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
         readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;
@@ -1834,6 +1848,8 @@ export declare const RunnerOperationsLiveSnapshot: Schema.Struct<{
                 }>>;
                 /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
                 readonly measure: Schema.optionalKey<Schema.Boolean>;
+                /** It resolves a verification's revisions to commits; a Runner without it is offered none. */
+                readonly resolve: Schema.optionalKey<Schema.Boolean>;
             }>;
             /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
             readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;
@@ -2635,6 +2651,8 @@ export declare const RunnerList: Schema.Struct<{
             }>>;
             /** It benchmarks a verification's measure; a Runner without it is offered none, as one from before measures was. */
             readonly measure: Schema.optionalKey<Schema.Boolean>;
+            /** It resolves a verification's revisions to commits; a Runner without it is offered none. */
+            readonly resolve: Schema.optionalKey<Schema.Boolean>;
         }>;
         /** The owner's choice of default Harness; `capabilities.defaultHarness` is the one in effect. */
         readonly preferredHarness: Schema.optionalKey<Schema.Literals<readonly ["pi", "claude", "codex"]>>;

package/types/packages/core/src/step-brief.d.ts

@@ -48,8 +48,7 @@ export declare function programStepContext(input: {
     readonly steering?: readonly string[];
 }): string | undefined;
 /**
- * The skill the Step runs, then the program's prompt, then the Kitman tools every Step has: its trail for a retry,
- * asking, files and skills.
+ * The skill the Step runs, then the program's prompt, then the Kitman tools every Step has: asking, files and skills.
  */
 export declare const programStepInstruction: (prompt: string, options?: {
     readonly missingSkills?: readonly string[];