@hasna/workflows 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/workflows",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Universal graph workflow app — graph language (start/step/decision/while/end), three-table store, session WAL, daemon with claims/leases, four lane adapters (claude/codex/cursor/grok), and a full CLI on four surfaces",
   "type": "module",
   "main": "./dist/index.js",
@@ -76,9 +76,9 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.3.234",
     "@cursor/sdk": "^1.0.28",
-    "@openai/codex-sdk": "0.147.0",
-    "commander": "^13.1.0",
     "@hasna/contracts": "1.3.3",
+    "@openai/codex-sdk": "0.160.0",
+    "commander": "^13.1.0",
     "pg": "^8.16.3"
   },
   "devDependencies": {

package/types/graph.d.ts

@@ -2,6 +2,8 @@ export declare const GRAPH_NODE_TYPES: readonly ["start", "step", "decision", "w
 export type GraphNodeType = (typeof GRAPH_NODE_TYPES)[number];
 export declare const LANE_KINDS: readonly ["claude", "codex", "cursor", "grok"];
 export type LaneKind = (typeof LANE_KINDS)[number];
+export declare const CODEX_EXECUTION_MODES: readonly ["repository", "read-only"];
+export type CodexExecutionMode = (typeof CODEX_EXECUTION_MODES)[number];
 export interface StartNode {
     id: string;
     type: "start";
@@ -16,6 +18,10 @@ export interface StepNode {
     prompt?: string;
     /** Shell command alternative to a lane prompt. */
     command?: string;
+    /** Working directory on the executor, shared by shell and model lanes. */
+    cwd?: string;
+    /** Codex prompts only. Read-only permits nonrepository work without writes or approvals. */
+    codexMode?: CodexExecutionMode;
     next?: string;
     /** Retries on lane failure. Default 0. */
     maxRetries?: number;

package/types/lanes/codex.d.ts

@@ -1,9 +1,3 @@
-/**
- * codex lane adapter — @openai/codex-sdk.
- *
- * `new Codex({ config, env })` -> `thread.run(prompt)` -> `Turn` whose
- * `finalResponse` is the completed agent output. CLI fallback: `codex exec`.
- */
 import { type LaneAdapter } from "./types.js";
 export interface CodexAdapterDeps {
     sdkLoader?: () => Promise<unknown>;

package/types/lanes/types.d.ts

@@ -1,3 +1,4 @@
+import type { CodexExecutionMode } from "../graph.js";
 export declare const LANE_KINDS: readonly ["claude", "codex", "cursor", "grok"];
 export type LaneKind = (typeof LANE_KINDS)[number];
 export interface LaneJob {
@@ -7,6 +8,8 @@ export interface LaneJob {
     /** Shell command alternative (handled by the daemon's built-in executor). */
     command?: string;
     cwd?: string;
+    /** Repository checks remain native defaults unless read-only is explicitly selected. */
+    codexMode?: CodexExecutionMode;
     /** Environment for the lane process — never credentials from the vault. */
     env?: Record<string, string>;
     /** Per-invocation budget in ms. Default 120000. */
@@ -70,4 +73,5 @@ export declare function spawnCli(cmd: string[], opts: {
     timeoutMs?: number;
     binaryName: string;
     packageHint: string;
+    stdoutOnly?: boolean;
 }): Promise<LaneResult>;

package/types/sdk/generated-api.d.ts

@@ -36,6 +36,8 @@ export interface StepNode {
     "lane"?: "claude" | "codex" | "cursor" | "grok";
     "prompt"?: string;
     "command"?: string;
+    "cwd"?: string;
+    "codexMode"?: "repository" | "read-only";
     "maxRetries"?: number;
     "memo"?: boolean;
     "timeoutMs"?: number;