ai-ctrl-workflow-contract 0.1.0

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "ai-ctrl-workflow-contract",
+  "version": "0.1.0",
+  "private": false,
+  "description": "AI Ctrl Workflow contracts backed by WorkCtrlFlow runtime state",
+  "type": "module",
+  "main": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "ai-workflow-contract": "0.1.0",
+    "work-ctrl-flow-contract": "0.1.0"
+  },
+  "files": [
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.com"
+  }
+}

package/src/index.ts

@@ -0,0 +1,53 @@
+import type {
+  AICtrlWorkflowDefinitionBinding,
+  AIWorkflowRuntimeContext,
+} from 'ai-workflow-contract';
+import type {
+  ResumeSignal,
+  TickOutcome,
+  WaitHandle,
+  WorkCtrlFlowSnapshot,
+  WorkCtrlFlowStartOptions,
+  WorkCtrlFlowStore,
+} from 'work-ctrl-flow-contract';
+
+export type AICtrlWorkflowRunStatus = 'Waiting' | 'Completed' | 'Failed';
+
+export type AICtrlWorkflowNodeStatus = 'Succeeded' | 'Failed' | 'Waiting';
+
+export interface AICtrlWorkflowDefinition {
+  readonly binding: AICtrlWorkflowDefinitionBinding;
+  readonly resourceRef?: string;
+}
+
+export interface AICtrlWorkflowNodeRecord {
+  readonly nodeId: string;
+  readonly invocationKey: string;
+  readonly status: AICtrlWorkflowNodeStatus;
+}
+
+export interface AICtrlWorkflowRunRecord {
+  readonly treeId: string;
+  readonly fqn: string;
+  readonly status: AICtrlWorkflowRunStatus;
+  readonly tickNo: number;
+  readonly openWaitHandles: readonly WaitHandle[];
+  readonly nodes: readonly AICtrlWorkflowNodeRecord[];
+}
+
+export interface AICtrlWorkflowController {
+  readonly store: WorkCtrlFlowStore;
+  start(treeId: string, options?: WorkCtrlFlowStartOptions): Promise<TickOutcome>;
+  resume(treeId: string, signal: ResumeSignal): Promise<TickOutcome>;
+  refresh(treeId: string): Promise<TickOutcome>;
+  getOutcome(treeId: string): Promise<TickOutcome | undefined>;
+}
+
+export interface AICtrlWorkflowRuntimeContextBinding {
+  readonly ai: AIWorkflowRuntimeContext;
+}
+
+export interface AICtrlWorkflowSnapshotProjectionInput {
+  readonly snapshot: WorkCtrlFlowSnapshot;
+  readonly outcome?: TickOutcome;
+}