@osovv/vv-opencode 1.4.2 → 1.4.3-rc.1

package/dist/plugins/workflow/tooling.d.ts

@@ -1,13 +1,27 @@
 import { type WorkItemStore } from "./state.js";
+import { type LookupRecoveryUserMessage } from "./delegated.js";
+import { type AuthorityMessageSnapshot } from "./authority.js";
 import type { LoadedDelegatedPlan } from "./checkpoint-io.js";
 export type WorkflowToolContext = {
     sessionId: string;
+    /** Trusted absolute workspace root; required for generic execution registration. */
+    workspaceRoot?: string;
 };
 export type WorkflowToolDefinition<TArgs, TResult> = {
     name: string;
     description: string;
     execute: (args: TArgs, context: WorkflowToolContext, store?: WorkItemStore) => TResult;
 };
+/** Optional read-only authorization lookup bound to the plugin SDK client. */
+export interface DelegatedControlOptions {
+    lookupUserMessage?: LookupRecoveryUserMessage;
+    /** Resolve one root-user message snapshot for advance-authority provenance. */
+    lookupAuthorityMessage?: (input: {
+        sessionId: string;
+        runId: string;
+        messageId: string;
+    }) => Promise<AuthorityMessageSnapshot | undefined>;
+}
 type OpenInputItem = {
     key?: unknown;
     title?: unknown;
@@ -16,9 +30,22 @@ type OpenInputItem = {
     writeScope?: unknown;
     planRunId?: unknown;
     planTaskId?: unknown;
+    /** Generic execution task-contract fields. */
+    taskId?: unknown;
+    goal?: unknown;
+    acceptanceCriteria?: unknown;
+    verification?: unknown;
+    dependsOn?: unknown;
+    blockedBy?: unknown;
 };
 type OpenArgs = {
     items: OpenInputItem[];
+    /** Generic execution descriptor; mutually exclusive with runId. */
+    execution?: unknown;
+    /** Append tasks to an existing generic execution. */
+    runId?: unknown;
+    amendmentId?: unknown;
+    rationale?: unknown;
 };
 type ListArgs = {
     includeClosed?: boolean;
@@ -29,24 +56,63 @@ type CloseArgs = {
 export type DecideArgs = {
     workItemId: string;
     attempt: number;
-    decision: "accept" | "request_changes" | "rework";
-    rationale: string;
-    evidence: string[];
+    decision: "accept" | "request_changes" | "rework" | "recover";
+    /** Required for accept, request_changes, and rework; unused by recover. */
+    rationale?: string;
+    /** Required for accept and request_changes; unused by rework and recover. */
+    evidence?: string[];
     concernsDisposition?: string;
     runId?: string;
     checkpointId?: string;
+    /** Recover-only bounded diagnosis, changed condition, and verification references. */
+    diagnosis?: string;
+    changedCondition?: string;
+    verification?: string[];
+    recoveryId?: string;
+    /** Recover-only fresh root-user message authorizing one further unit. */
+    userMessageId?: string;
+    /** Recover-only recorded advance authority authorizing one further unit. */
+    authorityId?: string;
 };
 export type CheckpointArgs = {
-    action: "register" | "start" | "verify";
+    action: "register" | "start" | "verify" | "recover" | "review" | "bind" | "complete" | "amend" | "authorize" | "record_approval" | "revoke_authority";
     planPath?: string;
     runId?: string;
     checkpointId?: string;
     complete?: boolean;
+    /** Recover-only bounded diagnosis, changed condition, and verification references. */
+    diagnosis?: string;
+    changedCondition?: string;
+    verification?: string[];
+    recoveryId?: string;
+    /** Recover-only fresh root-user message authorizing one further generation. */
+    userMessageId?: string;
+    /** Generic checkpoint append/registration payloads. */
+    checkpoints?: unknown;
+    tasks?: unknown;
+    amendmentId?: string;
+    rationale?: string;
+    startFingerprint?: string;
+    /** Generic reviewer result recording (status is read from the linked round). */
+    reviewer?: string;
+    /** Advance authority inputs. */
+    authorityId?: string;
+    messageId?: string;
+    approvalId?: string;
+    stage?: string;
+    artifactPath?: string;
+    artifactSha256?: string;
+    revocationId?: string;
+    /** Authority scope inputs. */
+    stages?: unknown;
+    decisionScope?: string;
+    fileBoundary?: unknown;
+    reservedStops?: unknown;
 };
 export declare function createWorkItemOpenTool(store: WorkItemStore): WorkflowToolDefinition<OpenArgs, Record<string, unknown>>;
 export declare function createWorkItemListTool(store: WorkItemStore): WorkflowToolDefinition<ListArgs, Record<string, unknown>>;
 export declare function createWorkItemCloseTool(store: WorkItemStore): WorkflowToolDefinition<CloseArgs, Record<string, unknown>>;
-export declare function createWorkItemDecideTool(store: WorkItemStore): WorkflowToolDefinition<DecideArgs, Record<string, unknown>>;
+export declare function createWorkItemDecideTool(store: WorkItemStore, options?: DelegatedControlOptions): WorkflowToolDefinition<DecideArgs, Promise<Record<string, unknown>>>;
 export interface WorkCheckpointRegisterInput {
     action: "register";
     planPath: string;
@@ -60,6 +126,15 @@ export type WorkCheckpointInput = WorkCheckpointRegisterInput | {
     runId: string;
     checkpointId: string;
     complete?: boolean;
+} | {
+    action: "recover";
+    runId: string;
+    checkpointId: string;
+    diagnosis: string;
+    changedCondition: string;
+    verification: string[];
+    recoveryId: string;
+    userMessageId?: string;
 };
 export type WorkCheckpointExecuteContext = WorkflowToolContext & {
     /** Trusted absolute workspace root used for plan loading and snapshots. */
@@ -69,5 +144,5 @@ export type WorkCheckpointExecuteContext = WorkflowToolContext & {
         loadError: string;
     }>;
 };
-export declare function createWorkCheckpointTool(store: WorkItemStore): WorkflowToolDefinition<CheckpointArgs, Promise<Record<string, unknown>>>;
+export declare function createWorkCheckpointTool(store: WorkItemStore, options?: DelegatedControlOptions): WorkflowToolDefinition<CheckpointArgs, Promise<Record<string, unknown>>>;
 export {};