@osovv/vv-opencode 1.4.5 → 1.6.0

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

@@ -2,6 +2,8 @@ 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";
+import type { CheckpointArgs, CloseArgs, DecideArgs, ListArgs } from "./schemas.js";
+export type { CheckpointArgs, DecideArgs } from "./schemas.js";
 export type WorkflowToolContext = {
     sessionId: string;
     /** Trusted absolute workspace root; required for generic execution registration. */
@@ -22,24 +24,14 @@ export interface DelegatedControlOptions {
         messageId: string;
     }) => Promise<AuthorityMessageSnapshot | undefined>;
 }
-type OpenInputItem = {
-    key?: unknown;
-    title?: unknown;
-    mode?: unknown;
-    requiredReviewers?: unknown;
-    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[];
+/**
+ * work_item_open wrapper input. Deliberately looser than the registered
+ * schema shape in schemas.ts: this wrapper is the defensive validator for
+ * partially-shaped caller input, so item and descriptor fields stay unknown
+ * here and are rejected by validateWorkflowToolInput before any dispatch.
+ */
+type OpenToolInput = {
+    items: unknown;
     /** Generic execution descriptor; mutually exclusive with runId. */
     execution?: unknown;
     /** Append tasks to an existing generic execution. */
@@ -47,69 +39,7 @@ type OpenArgs = {
     amendmentId?: unknown;
     rationale?: unknown;
 };
-type ListArgs = {
-    includeClosed?: boolean;
-};
-type CloseArgs = {
-    workItemId: string;
-};
-export type DecideArgs = {
-    workItemId: string;
-    attempt: number;
-    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" | "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 createWorkItemOpenTool(store: WorkItemStore): WorkflowToolDefinition<OpenToolInput, 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, options?: DelegatedControlOptions): WorkflowToolDefinition<DecideArgs, Promise<Record<string, unknown>>>;
@@ -145,4 +75,3 @@ export type WorkCheckpointExecuteContext = WorkflowToolContext & {
     }>;
 };
 export declare function createWorkCheckpointTool(store: WorkItemStore, options?: DelegatedControlOptions): WorkflowToolDefinition<CheckpointArgs, Promise<Record<string, unknown>>>;
-export {};