@themoltnet/pi-runtime 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -498,18 +498,11 @@ export declare interface ExecutePiTaskOptions {
      */
     maxBashTimeouts?: number;
     /**
-     * Number of correction turns allowed after the first invalid submit-output
-     * tool call. A value of 2 permits three invalid submit calls total before
-     * the attempt fails with output_validation_failed.
-     */
-    maxSubmitValidationRetries?: number;
-    /**
-     * Number of same-session re-prompts when the model ends its turn WITHOUT
-     * calling the submit-output tool at all (no captured payload and no
-     * exhausted validation budget). Distinct from
-     * `maxSubmitValidationRetries`, which recovers *invalid-args* submit calls.
-     * Each re-prompt names the submit tool and forbids a prose reply. When the
-     * budget is spent the attempt still fails with `submit_output_missing`.
+     * Number of same-session re-prompts when the model ends its turn without a
+     * valid submit-output call. A missing call receives the ordinary submit
+     * reminder; an invalid call receives its latest validation failure. When the
+     * budget is spent the attempt fails with the latest validation error, or
+     * `submit_output_missing` if the tool was never called.
      * Only applies to task types that register a submit tool. Default `3`. Set
      * to `0` to disable. See #1528.
      */
@@ -956,10 +949,16 @@ export declare interface PiTaskExecutionPlan {
      */
     workspaceId: string | null;
     /**
-     * Branch to create or reopen for the workspace. `null` means no dedicated
-     * worktree is required.
+     * Branch to create or reopen for the workspace. `null` may instead mean a
+     * detached dedicated worktree when `workspaceRevision` is present.
      */
     worktreeBranch: string | null;
+    /**
+     * Immutable commit that must back the selected workspace. Shared mounts are
+     * verified against it; dedicated review worktrees are created detached at
+     * it. `null` preserves the existing branch-oriented behavior.
+     */
+    workspaceRevision?: string | null;
     /**
      * Base ref a NEW `worktreeBranch` is cut from. Used by `fork` continuations
      * to branch from the parent's tip instead of the default (main/HEAD). Ignored
@@ -1149,6 +1148,7 @@ declare interface RuntimeInstructorContext {
 
 declare interface RuntimeInstructorSandbox {
     workspaceMode: 'shared_mount' | 'dedicated_worktree' | 'scratch_mount';
+    workspaceRevision?: string | null;
     vfsShadowMode: 'none' | 'deny' | 'tmpfs';
     vfsShadowPatterns: readonly string[];
     nodeModulesWriteMode?: 'tmpfs';