@bastani/atomic 0.5.29 → 0.5.30-0

package/dist/sdk/components/workflow-picker-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-picker-panel.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/workflow-picker-panel.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-picker-panel.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/workflow-picker-panel.tsx"],"names":[],"mappings":"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"}

package/dist/sdk/define-workflow.d.ts

@@ -11,16 +11,17 @@
  *     .compile()
  */
 import type { AgentType, WorkflowOptions, WorkflowContext, WorkflowDefinition, WorkflowInput } from "./types.ts";
+type AnyInputs = readonly WorkflowInput[];
 /**
  * Chainable workflow builder. Records the run callback,
  * then .compile() seals it into a WorkflowDefinition.
  */
-export declare class WorkflowBuilder<A extends AgentType = AgentType, N extends string = string> {
+export declare class WorkflowBuilder<A extends AgentType = AgentType, I extends AnyInputs = AnyInputs> {
     /** @internal Brand for detection across package boundaries */
     readonly __brand: "WorkflowBuilder";
     private readonly options;
     private runFn;
-    constructor(options: WorkflowOptions);
+    constructor(options: WorkflowOptions<I>);
     /**
      * Narrow the agent type for this workflow while preserving typed inputs.
      *
@@ -43,7 +44,7 @@ export declare class WorkflowBuilder<A extends AgentType = AgentType, N extends
      *   .compile();
      * ```
      */
-    for<B extends AgentType>(): WorkflowBuilder<B, N>;
+    for<B extends AgentType>(): WorkflowBuilder<B, I>;
     /**
      * Set the workflow's entry point.
      *
@@ -52,14 +53,14 @@ export declare class WorkflowBuilder<A extends AgentType = AgentType, N extends
      * reading completed session outputs. Use native TypeScript control flow
      * (loops, conditionals, `Promise.all()`) for orchestration.
      */
-    run(fn: (ctx: WorkflowContext<A, N>) => Promise<void>): this;
+    run(fn: (ctx: WorkflowContext<A, I>) => Promise<void>): this;
     /**
      * Compile the workflow into a sealed WorkflowDefinition.
      *
      * After calling compile(), the returned object is consumed by the
      * Atomic CLI runtime.
      */
-    compile(): WorkflowDefinition<A, N>;
+    compile(): WorkflowDefinition<A, I>;
 }
 /**
  * Entry point for defining a workflow.
@@ -87,5 +88,6 @@ export declare class WorkflowBuilder<A extends AgentType = AgentType, N extends
  *   .compile();
  * ```
  */
-export declare function defineWorkflow<const I extends readonly WorkflowInput[] = readonly WorkflowInput[]>(options: WorkflowOptions<I>): WorkflowBuilder<AgentType, I[number]["name"]>;
+export declare function defineWorkflow<const I extends readonly WorkflowInput[] = readonly WorkflowInput[]>(options: WorkflowOptions<I>): WorkflowBuilder<AgentType, I>;
+export {};
 //# sourceMappingURL=define-workflow.d.ts.map

package/dist/sdk/define-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../src/sdk/define-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAsCpB;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IACrF,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAG,iBAAiB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,KAAK,CAAgE;gBAEjE,OAAO,EAAE,eAAe;IAIpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,CAAC,SAAS,SAAS,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAIjD;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAW5D;;;;;OAKG;IACH,OAAO,IAAI,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CAoCpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,SAAS,aAAa,EAAE,EAEnE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAK/C"}
+{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../src/sdk/define-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,KAAK,SAAS,GAAG,SAAS,aAAa,EAAE,CAAC;AA0D1C;;;GAGG;AACH,qBAAa,eAAe,CAC1B,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,CAAC,SAAS,SAAS,GAAG,SAAS;IAE/B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAG,iBAAiB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,KAAK,CAAgE;gBAEjE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IAIvC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,CAAC,SAAS,SAAS,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAIjD;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAW5D;;;;;OAKG;IACH,OAAO,IAAI,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CAoCpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,SAAS,aAAa,EAAE,EAEnE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAK/B"}

package/dist/sdk/runtime/executor.d.ts

@@ -13,7 +13,7 @@
  * dual-module-identity issue: Bun evaluates a file twice when it is both
  * the entry point and reached through package.json `exports` self-referencing.
  */
-import type { WorkflowDefinition, AgentType, SavedMessage } from "../types.ts";
+import type { WorkflowDefinition, WorkflowInput, AgentType, SavedMessage } from "../types.ts";
 export { errorMessage } from "../errors.ts";
 export interface WorkflowRunOptions {
     /** The compiled workflow definition */
@@ -92,6 +92,16 @@ export declare function escPwsh(s: string): string;
  * prevent free-form workflows from running.
  */
 export declare function parseInputsEnv(raw: string | undefined): Record<string, string>;
+/**
+ * Coerce raw string inputs to their declared runtime types. Integer inputs
+ * become `number`; every other declared type passes through as `string`.
+ * Unknown keys (not in the schema) are preserved as strings.
+ *
+ * Invalid integer strings fall back to the key being dropped — validation
+ * already runs upstream (in `validateInputsAgainstSchema`), so reaching
+ * this path with garbage means the executor was invoked out-of-band.
+ */
+export declare function coerceInputsBySchema(inputs: Record<string, string>, schema: readonly WorkflowInput[]): Record<string, string | number>;
 /**
  * Called by `atomic workflow -n <name> -a <agent> <prompt>`.
  *

package/dist/sdk/runtime/executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/executor.ts"],"names":[],"mappings":"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"}

package/dist/sdk/types.d.ts

@@ -86,11 +86,12 @@ export declare function createProviderValidator(rules: readonly ValidationRule[]
 /**
  * Supported field types for a workflow's declared inputs.
  *
- * - `"string"` — single-line free-form input (short values, identifiers, paths)
- * - `"text"`   — multi-line free-form input (long prose, prompts, specs)
- * - `"enum"`   — one of a fixed list of allowed `values`
+ * - `"string"`  — single-line free-form input (short values, identifiers, paths)
+ * - `"text"`    — multi-line free-form input (long prose, prompts, specs)
+ * - `"enum"`    — one of a fixed list of allowed `values`
+ * - `"integer"` — whole number; parsed to `number` in `ctx.inputs`
  */
-export type WorkflowInputType = "string" | "text" | "enum";
+export type WorkflowInputType = "string" | "text" | "enum" | "integer";
 /**
  * A declared input for a workflow. When a workflow provides an `inputs`
  * array, the CLI materialises one `--<name>` flag per input (and the
@@ -112,11 +113,34 @@ export interface WorkflowInput {
     description?: string;
     /** Placeholder text shown when the field is empty. */
     placeholder?: string;
-    /** Default value pre-filled into the field. Enums use this to pick their initial value. */
-    default?: string;
+    /**
+     * Default value pre-filled into the field. Enums use this to pick
+     * their initial value. Integer inputs accept either a `number` or its
+     * decimal string representation.
+     */
+    default?: string | number;
     /** Allowed values — required when `type` is `"enum"`. */
     values?: readonly string[];
 }
+/**
+ * Map a {@link WorkflowInputType} to the runtime value type observed in
+ * `ctx.inputs`. Integer inputs are parsed to `number` at the executor
+ * boundary; everything else stays a `string`.
+ */
+export type WorkflowInputValue<T extends WorkflowInputType> = T extends "integer" ? number : string;
+/**
+ * Compute the typed `ctx.inputs` shape from a workflow's declared input
+ * schema. Each declared field becomes an optional key whose value type
+ * is determined by {@link WorkflowInputValue}.
+ *
+ * Free-form workflows (no declared schema) fall back to a loose
+ * string-keyed record so authors can still read `ctx.inputs.prompt`.
+ */
+export type InputsOf<I extends readonly WorkflowInput[]> = WorkflowInput extends I[number] ? Record<string, string | undefined> : I[number] extends never ? Record<string, string | undefined> : {
+    [K in I[number]["name"]]?: WorkflowInputValue<Extract<I[number], {
+        name: K;
+    }>["type"]>;
+};
 /**
  * A transcript from a completed session.
  * Provides both the file path and rendered text content.
@@ -191,7 +215,7 @@ export interface SessionRunOptions {
  * Created by `ctx.stage(opts, clientOpts, sessionOpts, fn)` — the callback
  * receives this as its argument with pre-initialized `client` and `session`.
  */
-export interface SessionContext<A extends AgentType = AgentType, N extends string = string> {
+export interface SessionContext<A extends AgentType = AgentType, I extends readonly WorkflowInput[] = readonly WorkflowInput[]> {
     /** Provider-specific SDK client (auto-created by runtime) */
     client: ProviderClient<A>;
     /** Provider-specific session (auto-created by runtime) */
@@ -202,12 +226,11 @@ export interface SessionContext<A extends AgentType = AgentType, N extends strin
      *
      * When the workflow declares an `inputs` schema, only the declared
      * field names are valid keys — accessing undeclared fields is a
-     * compile-time error. Free-form workflows (no declared schema)
-     * allow any key, including the conventional `prompt` key.
+     * compile-time error. Each field's value type is determined by its
+     * declared `type` (integer inputs surface as `number`). Free-form
+     * workflows (no declared schema) allow any key.
      */
-    inputs: {
-        [K in N]?: string;
-    };
+    inputs: InputsOf<I>;
     /** Which agent is running */
     agent: A;
     /**
@@ -236,25 +259,24 @@ export interface SessionContext<A extends AgentType = AgentType, N extends strin
      * The sub-session is a child of this session in the graph.
      * The callback's return value is available as `handle.result`.
      */
-    stage<T = void>(options: SessionRunOptions, clientOpts: StageClientOptions<A>, sessionOpts: StageSessionOptions<A>, run: (ctx: SessionContext<A, N>) => Promise<T>): Promise<SessionHandle<T>>;
+    stage<T = void>(options: SessionRunOptions, clientOpts: StageClientOptions<A>, sessionOpts: StageSessionOptions<A>, run: (ctx: SessionContext<A, I>) => Promise<T>): Promise<SessionHandle<T>>;
 }
 /**
  * Top-level context provided to the workflow's `.run()` callback.
  * Does not have session-specific fields (paneId, save, etc.).
  */
-export interface WorkflowContext<A extends AgentType = AgentType, N extends string = string> {
+export interface WorkflowContext<A extends AgentType = AgentType, I extends readonly WorkflowInput[] = readonly WorkflowInput[]> {
     /**
      * Structured inputs for this workflow run. Populated from CLI flags
      * (`--<name>=<value>`) or the interactive picker.
      *
      * When the workflow declares an `inputs` schema, only the declared
      * field names are valid keys — accessing undeclared fields is a
-     * compile-time error. Free-form workflows (no declared schema)
-     * allow any key, including the conventional `prompt` key.
+     * compile-time error. Each field's value type is determined by its
+     * declared `type` (integer inputs surface as `number`). Free-form
+     * workflows (no declared schema) allow any key.
      */
-    inputs: {
-        [K in N]?: string;
-    };
+    inputs: InputsOf<I>;
     /** Which agent is running */
     agent: A;
     /**
@@ -263,7 +285,7 @@ export interface WorkflowContext<A extends AgentType = AgentType, N extends stri
      * run callback → cleanup. The callback's return value is available as
      * `handle.result`.
      */
-    stage<T = void>(options: SessionRunOptions, clientOpts: StageClientOptions<A>, sessionOpts: StageSessionOptions<A>, run: (ctx: SessionContext<A, N>) => Promise<T>): Promise<SessionHandle<T>>;
+    stage<T = void>(options: SessionRunOptions, clientOpts: StageClientOptions<A>, sessionOpts: StageSessionOptions<A>, run: (ctx: SessionContext<A, I>) => Promise<T>): Promise<SessionHandle<T>>;
     /**
      * Get a completed session's transcript as rendered text.
      * Accepts a SessionHandle (recommended) or session name string.
@@ -313,7 +335,7 @@ export interface WorkflowOptions<I extends readonly WorkflowInput[] = readonly W
 /**
  * A compiled workflow definition — the sealed output of defineWorkflow().compile().
  */
-export interface WorkflowDefinition<A extends AgentType = AgentType, N extends string = string> {
+export interface WorkflowDefinition<A extends AgentType = AgentType, I extends readonly WorkflowInput[] = readonly WorkflowInput[]> {
     readonly __brand: "WorkflowDefinition";
     readonly name: string;
     readonly description: string;
@@ -325,6 +347,6 @@ export interface WorkflowDefinition<A extends AgentType = AgentType, N extends s
      */
     readonly minSDKVersion: string | null;
     /** The workflow's entry point. Called by the executor with a WorkflowContext. */
-    readonly run: (ctx: WorkflowContext<A, N>) => Promise<void>;
+    readonly run: (ctx: WorkflowContext<A, I>) => Promise<void>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/sdk/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":"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"}

package/dist/sdk/workflows/builtin/deep-research-codebase/claude/index.d.ts

@@ -56,6 +56,11 @@
  * so they are transparent to the workflow graph. The visible nodes are just:
  *   parent → [codebase-scout] → aggregator
  */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"claude", "prompt">;
+declare const _default: import("../../../index.ts").WorkflowDefinition<"claude", readonly [{
+    readonly name: "prompt";
+    readonly type: "text";
+    readonly required: true;
+    readonly description: "research question";
+}]>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/deep-research-codebase/claude/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/deep-research-codebase/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;;AAsCH,wBAwTa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/deep-research-codebase/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;;;;;;;AAsCH,wBAwTa"}

package/dist/sdk/workflows/builtin/deep-research-codebase/copilot/index.d.ts

@@ -25,6 +25,11 @@
  *
  * See claude/index.ts for the full design rationale and topology diagram.
  */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"copilot", "prompt">;
+declare const _default: import("../../../index.ts").WorkflowDefinition<"copilot", readonly [{
+    readonly name: "prompt";
+    readonly type: "text";
+    readonly required: true;
+    readonly description: "research question";
+}]>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/deep-research-codebase/copilot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/deep-research-codebase/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;AA6CH,wBA4Ra"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/deep-research-codebase/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;;;;;AA6CH,wBA4Ra"}

package/dist/sdk/workflows/builtin/deep-research-codebase/opencode/index.d.ts

@@ -25,6 +25,11 @@
  *
  * See claude/index.ts for the full design rationale and topology diagram.
  */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"opencode", "prompt">;
+declare const _default: import("../../../index.ts").WorkflowDefinition<"opencode", readonly [{
+    readonly name: "prompt";
+    readonly type: "text";
+    readonly required: true;
+    readonly description: "research question";
+}]>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/deep-research-codebase/opencode/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/deep-research-codebase/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;AAsCH,wBA8Ua"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/deep-research-codebase/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;;;;;AAsCH,wBA8Ua"}

package/dist/sdk/workflows/builtin/open-claude-design/claude/index.d.ts

@@ -41,6 +41,28 @@
  *
  * Run: atomic workflow -n open-claude-design -a claude "design a dashboard"
  */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"claude", "prompt" | "reference" | "output-type" | "design-system">;
+declare const _default: import("../../../index.ts").WorkflowDefinition<"claude", readonly [{
+    readonly name: "prompt";
+    readonly type: "text";
+    readonly required: true;
+    readonly description: "What to design (e.g., 'a dashboard for monitoring API latency')";
+}, {
+    readonly name: "reference";
+    readonly type: "text";
+    readonly required: false;
+    readonly description: "URL, file path, or codebase path to import as design reference";
+}, {
+    readonly name: "output-type";
+    readonly type: "enum";
+    readonly required: false;
+    readonly values: readonly ["prototype", "wireframe", "page", "component"];
+    readonly default: "prototype";
+    readonly description: "Type of design output to generate";
+}, {
+    readonly name: "design-system";
+    readonly type: "text";
+    readonly required: false;
+    readonly description: "Path to existing Design.md (skips onboarding if provided)";
+}]>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/claude/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;;AA8CH,wBA0Za"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;;;;;;;;;;;;;;;;;;;;;;;;AA8CH,wBA0Za"}

package/dist/sdk/workflows/builtin/open-claude-design/copilot/index.d.ts

@@ -29,6 +29,28 @@
  *
  * Run: atomic workflow -n open-claude-design -a copilot "design a dashboard"
  */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"copilot", "prompt" | "reference" | "output-type" | "design-system">;
+declare const _default: import("../../../index.ts").WorkflowDefinition<"copilot", readonly [{
+    readonly name: "prompt";
+    readonly type: "text";
+    readonly required: true;
+    readonly description: "What to design (e.g., 'a dashboard for monitoring API latency')";
+}, {
+    readonly name: "reference";
+    readonly type: "text";
+    readonly required: false;
+    readonly description: "URL, file path, or codebase path to import as design reference";
+}, {
+    readonly name: "output-type";
+    readonly type: "enum";
+    readonly required: false;
+    readonly values: readonly ["prototype", "wireframe", "page", "component"];
+    readonly default: "prototype";
+    readonly description: "Type of design output to generate";
+}, {
+    readonly name: "design-system";
+    readonly type: "text";
+    readonly required: false;
+    readonly description: "Path to existing Design.md (skips onboarding if provided)";
+}]>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/copilot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;AA2DH,wBAiaa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;;;;;;;;;;;;;;;;;;;;;;AA2DH,wBAiaa"}

package/dist/sdk/workflows/builtin/open-claude-design/opencode/index.d.ts

@@ -31,6 +31,28 @@
  *
  * Run: atomic workflow -n open-claude-design -a opencode "design a dashboard"
  */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"opencode", "prompt" | "reference" | "output-type" | "design-system">;
+declare const _default: import("../../../index.ts").WorkflowDefinition<"opencode", readonly [{
+    readonly name: "prompt";
+    readonly type: "text";
+    readonly required: true;
+    readonly description: "What to design (e.g., 'a dashboard for monitoring API latency')";
+}, {
+    readonly name: "reference";
+    readonly type: "text";
+    readonly required: false;
+    readonly description: "URL, file path, or codebase path to import as design reference";
+}, {
+    readonly name: "output-type";
+    readonly type: "enum";
+    readonly required: false;
+    readonly values: readonly ["prototype", "wireframe", "page", "component"];
+    readonly default: "prototype";
+    readonly description: "Type of design output to generate";
+}, {
+    readonly name: "design-system";
+    readonly type: "text";
+    readonly required: false;
+    readonly description: "Path to existing Design.md (skips onboarding if provided)";
+}]>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/open-claude-design/opencode/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;AAoDH,wBAqea"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/open-claude-design/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;;;;;;;;;;;;;;;;;;;;;;;AAoDH,wBAqea"}

package/dist/sdk/workflows/builtin/ralph/claude/index.d.ts

@@ -4,7 +4,7 @@
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
- *   - {@link MAX_LOOPS} iterations have completed, OR
+ *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
  *   - Two parallel reviewer passes both return zero findings.
  *
  * The reviewer stages run the `reviewer` sub-agent in a visible TUI via the
@@ -17,6 +17,16 @@
  *
  * Run: atomic workflow -n ralph -a claude "<your spec>"
  */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"claude", "prompt">;
+declare const _default: import("../../../index.ts").WorkflowDefinition<"claude", readonly [{
+    readonly name: "prompt";
+    readonly type: "text";
+    readonly required: true;
+    readonly description: "task prompt";
+}, {
+    readonly name: "max_loops";
+    readonly type: "integer";
+    readonly description: "maximum number of plan/orchestrate/review iterations";
+    readonly default: 10;
+}]>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/ralph/claude/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;;AAmCH,wBAkMa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;AAmCH,wBAyMa"}

package/dist/sdk/workflows/builtin/ralph/copilot/index.d.ts

@@ -4,7 +4,7 @@
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
- *   - {@link MAX_LOOPS} iterations have completed, OR
+ *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
  *   - Two parallel reviewer passes both return zero findings.
  *
  * The reviewer stages use a `submit_review` custom tool (defined via
@@ -14,6 +14,16 @@
  *
  * Run: atomic workflow -n ralph -a copilot "<your spec>"
  */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"copilot", "prompt">;
+declare const _default: import("../../../index.ts").WorkflowDefinition<"copilot", readonly [{
+    readonly name: "prompt";
+    readonly type: "text";
+    readonly required: true;
+    readonly description: "task prompt";
+}, {
+    readonly name: "max_loops";
+    readonly type: "integer";
+    readonly description: "maximum number of plan/orchestrate/review iterations";
+    readonly default: 10;
+}]>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/ralph/copilot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;;AA6DH,wBAmMa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;AA6DH,wBA0Ma"}

package/dist/sdk/workflows/builtin/ralph/opencode/index.d.ts

@@ -4,7 +4,7 @@
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
- *   - {@link MAX_LOOPS} iterations have completed, OR
+ *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
  *   - Two parallel reviewer passes both return zero findings.
  *
  * The reviewer stages use the OpenCode SDK's structured output
@@ -13,6 +13,16 @@
  *
  * Run: atomic workflow -n ralph -a opencode "<your spec>"
  */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"opencode", "prompt">;
+declare const _default: import("../../../index.ts").WorkflowDefinition<"opencode", readonly [{
+    readonly name: "prompt";
+    readonly type: "text";
+    readonly required: true;
+    readonly description: "task prompt";
+}, {
+    readonly name: "max_loops";
+    readonly type: "integer";
+    readonly description: "maximum number of plan/orchestrate/review iterations";
+    readonly default: 10;
+}]>;
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/ralph/opencode/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;;AAqDH,wBA4La"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;AAqDH,wBAmMa"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.5.29",
+  "version": "0.5.30-0",
   "description": "Configuration management CLI and SDK for coding agents",
   "type": "module",
   "license": "MIT",

package/src/commands/cli/workflow-inputs.ts

@@ -114,7 +114,9 @@ export function renderInputsText(payload: WorkflowInputsResult): string {
     }
     if (field.default !== undefined) {
       lines.push(
-        "      " + paint("dim", "default: ") + paint("text", field.default),
+        "      " +
+          paint("dim", "default: ") +
+          paint("text", String(field.default)),
       );
     }
     if (field.placeholder) {

package/src/commands/cli/workflow.ts

@@ -110,9 +110,11 @@ export function validateInputsAgainstSchema(
 
   for (const field of schema) {
     const raw = inputs[field.name];
+    const defaultStr =
+      field.default !== undefined ? String(field.default) : undefined;
     const value =
       raw === undefined || raw === ""
-        ? field.default ?? (field.type === "enum" ? field.values?.[0] ?? "" : "")
+        ? defaultStr ?? (field.type === "enum" ? field.values?.[0] ?? "" : "")
         : raw;
 
     if (field.required) {
@@ -136,6 +138,19 @@ export function validateInputsAgainstSchema(
         );
       }
     }
+
+    if (field.type === "integer" && value !== "") {
+      const parsed = Number.parseInt(value, 10);
+      if (
+        !Number.isFinite(parsed) ||
+        !Number.isInteger(parsed) ||
+        String(parsed) !== value.trim()
+      ) {
+        errors.push(
+          `Invalid value for --${field.name}: "${value}". Expected an integer.`,
+        );
+      }
+    }
   }
 
   for (const name of Object.keys(inputs)) {
@@ -166,7 +181,7 @@ export function resolveInputs(
     if (raw !== undefined && raw !== "") {
       out[field.name] = raw;
     } else if (field.default !== undefined) {
-      out[field.name] = field.default;
+      out[field.name] = String(field.default);
     } else if (field.type === "enum" && field.values && field.values.length > 0) {
       out[field.name] = field.values[0]!;
     }

package/src/sdk/components/workflow-picker-panel.tsx

@@ -296,6 +296,16 @@ function isRunnable(wf: WorkflowWithMetadata): boolean {
 // ─── Validation ─────────────────────────────────
 
 export function isFieldValid(field: WorkflowInput, value: string): boolean {
+  if (field.type === "integer") {
+    const trimmed = value.trim();
+    if (trimmed === "") return !field.required;
+    const parsed = Number.parseInt(trimmed, 10);
+    return (
+      Number.isFinite(parsed) &&
+      Number.isInteger(parsed) &&
+      String(parsed) === trimmed
+    );
+  }
   if (!field.required) return true;
   if (field.type === "enum") return value !== "";
   return value.trim() !== "";
@@ -864,7 +874,7 @@ const Field = memo(function Field({
             focused={focused}
             onInput={onInput}
           />
-        ) : field.type === "string" ? (
+        ) : field.type === "string" || field.type === "integer" ? (
           <StringContent
             value={value}
             placeholder={field.placeholder ?? ""}
@@ -1397,8 +1407,11 @@ function usePickerKeyboard(state: PickerKeyboardState): void {
         const initial: Record<string, string> = {};
         for (const f of wf.inputs) {
           initial[f.name] =
-            f.default ??
-            (f.type === "enum" ? (f.values?.[0] ?? "") : "");
+            f.default !== undefined
+              ? String(f.default)
+              : f.type === "enum"
+                ? (f.values?.[0] ?? "")
+                : "";
         }
         setFieldValues(initial);
         setFocusedFieldIdx(0);
@@ -1453,7 +1466,10 @@ function usePickerKeyboard(state: PickerKeyboardState): void {
       return;
     }
 
-    if (field.type === "string" && key.name === "return") {
+    if (
+      (field.type === "string" || field.type === "integer") &&
+      key.name === "return"
+    ) {
       key.stopPropagation();
       setFocusedFieldIdx((i: number) =>
         Math.min(currentFieldsRef.current.length - 1, i + 1),

package/src/sdk/define-workflow.ts

@@ -19,6 +19,8 @@ import type {
   WorkflowInput,
 } from "./types.ts";
 
+type AnyInputs = readonly WorkflowInput[];
+
 /**
  * Validate a single declared workflow input, throwing on authoring
  * mistakes that would otherwise surface as confusing runtime errors
@@ -45,11 +47,31 @@ function validateWorkflowInput(input: WorkflowInput, workflowName: string): void
           `declares no \`values\`.`,
       );
     }
-    if (input.default !== undefined && !input.values.includes(input.default)) {
+    if (input.default !== undefined) {
+      if (typeof input.default !== "string") {
+        throw new Error(
+          `Workflow "${workflowName}" input "${input.name}" (enum) has a ` +
+            `non-string default ${JSON.stringify(input.default)}.`,
+        );
+      }
+      if (!input.values.includes(input.default)) {
+        throw new Error(
+          `Workflow "${workflowName}" input "${input.name}" has a default ` +
+            `"${input.default}" that is not one of its declared values: ` +
+            `${input.values.join(", ")}.`,
+        );
+      }
+    }
+  }
+  if (input.type === "integer" && input.default !== undefined) {
+    const n =
+      typeof input.default === "number"
+        ? input.default
+        : Number.parseInt(input.default, 10);
+    if (!Number.isFinite(n) || !Number.isInteger(n)) {
       throw new Error(
-        `Workflow "${workflowName}" input "${input.name}" has a default ` +
-          `"${input.default}" that is not one of its declared values: ` +
-          `${input.values.join(", ")}.`,
+        `Workflow "${workflowName}" input "${input.name}" (integer) has a ` +
+          `non-integer default ${JSON.stringify(input.default)}.`,
       );
     }
   }
@@ -59,13 +81,16 @@ function validateWorkflowInput(input: WorkflowInput, workflowName: string): void
  * Chainable workflow builder. Records the run callback,
  * then .compile() seals it into a WorkflowDefinition.
  */
-export class WorkflowBuilder<A extends AgentType = AgentType, N extends string = string> {
+export class WorkflowBuilder<
+  A extends AgentType = AgentType,
+  I extends AnyInputs = AnyInputs,
+> {
   /** @internal Brand for detection across package boundaries */
   readonly __brand = "WorkflowBuilder" as const;
-  private readonly options: WorkflowOptions;
-  private runFn: ((ctx: WorkflowContext<A, N>) => Promise<void>) | null = null;
+  private readonly options: WorkflowOptions<I>;
+  private runFn: ((ctx: WorkflowContext<A, I>) => Promise<void>) | null = null;
 
-  constructor(options: WorkflowOptions) {
+  constructor(options: WorkflowOptions<I>) {
     this.options = options;
   }
 
@@ -91,8 +116,8 @@ export class WorkflowBuilder<A extends AgentType = AgentType, N extends string =
    *   .compile();
    * ```
    */
-  for<B extends AgentType>(): WorkflowBuilder<B, N> {
-    return this as unknown as WorkflowBuilder<B, N>;
+  for<B extends AgentType>(): WorkflowBuilder<B, I> {
+    return this as unknown as WorkflowBuilder<B, I>;
   }
 
   /**
@@ -103,7 +128,7 @@ export class WorkflowBuilder<A extends AgentType = AgentType, N extends string =
    * reading completed session outputs. Use native TypeScript control flow
    * (loops, conditionals, `Promise.all()`) for orchestration.
    */
-  run(fn: (ctx: WorkflowContext<A, N>) => Promise<void>): this {
+  run(fn: (ctx: WorkflowContext<A, I>) => Promise<void>): this {
     if (this.runFn) {
       throw new Error("run() can only be called once per workflow.");
     }
@@ -120,7 +145,7 @@ export class WorkflowBuilder<A extends AgentType = AgentType, N extends string =
    * After calling compile(), the returned object is consumed by the
    * Atomic CLI runtime.
    */
-  compile(): WorkflowDefinition<A, N> {
+  compile(): WorkflowDefinition<A, I> {
     if (!this.runFn) {
       throw new Error(
         `Workflow "${this.options.name}" has no run callback. ` +
@@ -188,9 +213,9 @@ export function defineWorkflow<
   const I extends readonly WorkflowInput[] = readonly WorkflowInput[],
 >(
   options: WorkflowOptions<I>,
-): WorkflowBuilder<AgentType, I[number]["name"]> {
+): WorkflowBuilder<AgentType, I> {
   if (!options.name || options.name.trim() === "") {
     throw new Error("Workflow name is required.");
   }
-  return new WorkflowBuilder<AgentType, I[number]["name"]>(options);
+  return new WorkflowBuilder<AgentType, I>(options);
 }

package/src/sdk/runtime/executor.ts

@@ -21,6 +21,7 @@ import { statSync, accessSync, constants as fsConstants } from "node:fs";
 import type {
   WorkflowDefinition,
   WorkflowContext,
+  WorkflowInput,
   SessionContext,
   SessionRunOptions,
   SessionHandle,
@@ -418,6 +419,35 @@ export function parseInputsEnv(
   }
 }
 
+/**
+ * Coerce raw string inputs to their declared runtime types. Integer inputs
+ * become `number`; every other declared type passes through as `string`.
+ * Unknown keys (not in the schema) are preserved as strings.
+ *
+ * Invalid integer strings fall back to the key being dropped — validation
+ * already runs upstream (in `validateInputsAgainstSchema`), so reaching
+ * this path with garbage means the executor was invoked out-of-band.
+ */
+export function coerceInputsBySchema(
+  inputs: Record<string, string>,
+  schema: readonly WorkflowInput[],
+): Record<string, string | number> {
+  const byName = new Map(schema.map((f) => [f.name, f]));
+  const out: Record<string, string | number> = {};
+  for (const [k, v] of Object.entries(inputs)) {
+    const field = byName.get(k);
+    if (field?.type === "integer") {
+      const parsed = Number.parseInt(v, 10);
+      if (Number.isFinite(parsed) && Number.isInteger(parsed)) {
+        out[k] = parsed;
+      }
+      continue;
+    }
+    out[k] = v;
+  }
+  return out;
+}
+
 // ============================================================================
 // Entry point called by the CLI command
 // ============================================================================
@@ -1138,10 +1168,10 @@ interface SharedRunnerState {
   /**
    * Structured inputs for this workflow run. Free-form workflows use
    * `{ prompt: "..." }`; structured workflows use their declared field
-   * names. Workflow authors read both shapes via `ctx.inputs` — and
-   * specifically via `ctx.inputs.prompt` for the free-form case.
+   * names. Workflow authors read both shapes via `ctx.inputs` — integer
+   * inputs are parsed to `number`, everything else stays a `string`.
    */
-  inputs: Record<string, string>;
+  inputs: Record<string, string | number>;
   /** User-configured provider overrides (global + local merged). */
   providerOverrides: ProviderOverrides;
   /**
@@ -1662,7 +1692,7 @@ function createSessionRunner(
       const ctx: SessionContext = {
         client: providerClient,
         session: providerSession,
-        inputs: shared.inputs,
+        inputs: shared.inputs as SessionContext["inputs"],
         agent: shared.agent,
         sessionDir,
         paneId,
@@ -1904,6 +1934,11 @@ export async function runOrchestrator(): Promise<void> {
     }
     const definition = loaded.value.definition;
 
+    // Parse integer inputs to numbers so `ctx.inputs.<name>` matches the
+    // declared type. Do this after loading (when the schema is known) and
+    // mutate shared.inputs so per-stage SessionContexts see the same shape.
+    shared.inputs = coerceInputsBySchema(inputs, definition.inputs);
+
     await Bun.write(
       join(sessionsBaseDir, "metadata.json"),
       JSON.stringify(
@@ -1926,7 +1961,7 @@ export async function runOrchestrator(): Promise<void> {
     const sessionRunner = createSessionRunner(shared, "orchestrator");
 
     const workflowCtx: WorkflowContext = {
-      inputs,
+      inputs: shared.inputs as WorkflowContext["inputs"],
       agent,
       stage: sessionRunner as WorkflowContext["stage"],
       transcript: createTranscriptReader(shared.completedRegistry),

package/src/sdk/types.ts

@@ -143,11 +143,12 @@ export function createProviderValidator(
 /**
  * Supported field types for a workflow's declared inputs.
  *
- * - `"string"` — single-line free-form input (short values, identifiers, paths)
- * - `"text"`   — multi-line free-form input (long prose, prompts, specs)
- * - `"enum"`   — one of a fixed list of allowed `values`
+ * - `"string"`  — single-line free-form input (short values, identifiers, paths)
+ * - `"text"`    — multi-line free-form input (long prose, prompts, specs)
+ * - `"enum"`    — one of a fixed list of allowed `values`
+ * - `"integer"` — whole number; parsed to `number` in `ctx.inputs`
  */
-export type WorkflowInputType = "string" | "text" | "enum";
+export type WorkflowInputType = "string" | "text" | "enum" | "integer";
 
 /**
  * A declared input for a workflow. When a workflow provides an `inputs`
@@ -170,12 +171,46 @@ export interface WorkflowInput {
   description?: string;
   /** Placeholder text shown when the field is empty. */
   placeholder?: string;
-  /** Default value pre-filled into the field. Enums use this to pick their initial value. */
-  default?: string;
+  /**
+   * Default value pre-filled into the field. Enums use this to pick
+   * their initial value. Integer inputs accept either a `number` or its
+   * decimal string representation.
+   */
+  default?: string | number;
   /** Allowed values — required when `type` is `"enum"`. */
   values?: readonly string[];
 }
 
+/**
+ * Map a {@link WorkflowInputType} to the runtime value type observed in
+ * `ctx.inputs`. Integer inputs are parsed to `number` at the executor
+ * boundary; everything else stays a `string`.
+ */
+export type WorkflowInputValue<T extends WorkflowInputType> =
+  T extends "integer" ? number : string;
+
+/**
+ * Compute the typed `ctx.inputs` shape from a workflow's declared input
+ * schema. Each declared field becomes an optional key whose value type
+ * is determined by {@link WorkflowInputValue}.
+ *
+ * Free-form workflows (no declared schema) fall back to a loose
+ * string-keyed record so authors can still read `ctx.inputs.prompt`.
+ */
+export type InputsOf<I extends readonly WorkflowInput[]> =
+  // Non-literal schema (default `I = readonly WorkflowInput[]`) or empty
+  // tuple — no type-level info about individual fields, so fall back to a
+  // loose string record that preserves the prior free-form behaviour.
+  WorkflowInput extends I[number]
+    ? Record<string, string | undefined>
+    : I[number] extends never
+      ? Record<string, string | undefined>
+      : {
+          [K in I[number]["name"]]?: WorkflowInputValue<
+            Extract<I[number], { name: K }>["type"]
+          >;
+        };
+
 // ─── Core types ─────────────────────────────────────────────────────────────
 
 /**
@@ -252,7 +287,10 @@ export interface SessionRunOptions {
  * Created by `ctx.stage(opts, clientOpts, sessionOpts, fn)` — the callback
  * receives this as its argument with pre-initialized `client` and `session`.
  */
-export interface SessionContext<A extends AgentType = AgentType, N extends string = string> {
+export interface SessionContext<
+  A extends AgentType = AgentType,
+  I extends readonly WorkflowInput[] = readonly WorkflowInput[],
+> {
   /** Provider-specific SDK client (auto-created by runtime) */
   client: ProviderClient<A>;
   /** Provider-specific session (auto-created by runtime) */
@@ -263,10 +301,11 @@ export interface SessionContext<A extends AgentType = AgentType, N extends strin
    *
    * When the workflow declares an `inputs` schema, only the declared
    * field names are valid keys — accessing undeclared fields is a
-   * compile-time error. Free-form workflows (no declared schema)
-   * allow any key, including the conventional `prompt` key.
+   * compile-time error. Each field's value type is determined by its
+   * declared `type` (integer inputs surface as `number`). Free-form
+   * workflows (no declared schema) allow any key.
    */
-  inputs: { [K in N]?: string };
+  inputs: InputsOf<I>;
   /** Which agent is running */
   agent: A;
   /**
@@ -299,7 +338,7 @@ export interface SessionContext<A extends AgentType = AgentType, N extends strin
     options: SessionRunOptions,
     clientOpts: StageClientOptions<A>,
     sessionOpts: StageSessionOptions<A>,
-    run: (ctx: SessionContext<A, N>) => Promise<T>,
+    run: (ctx: SessionContext<A, I>) => Promise<T>,
   ): Promise<SessionHandle<T>>;
 }
 
@@ -307,17 +346,21 @@ export interface SessionContext<A extends AgentType = AgentType, N extends strin
  * Top-level context provided to the workflow's `.run()` callback.
  * Does not have session-specific fields (paneId, save, etc.).
  */
-export interface WorkflowContext<A extends AgentType = AgentType, N extends string = string> {
+export interface WorkflowContext<
+  A extends AgentType = AgentType,
+  I extends readonly WorkflowInput[] = readonly WorkflowInput[],
+> {
   /**
    * Structured inputs for this workflow run. Populated from CLI flags
    * (`--<name>=<value>`) or the interactive picker.
    *
    * When the workflow declares an `inputs` schema, only the declared
    * field names are valid keys — accessing undeclared fields is a
-   * compile-time error. Free-form workflows (no declared schema)
-   * allow any key, including the conventional `prompt` key.
+   * compile-time error. Each field's value type is determined by its
+   * declared `type` (integer inputs surface as `number`). Free-form
+   * workflows (no declared schema) allow any key.
    */
-  inputs: { [K in N]?: string };
+  inputs: InputsOf<I>;
   /** Which agent is running */
   agent: A;
   /**
@@ -330,7 +373,7 @@ export interface WorkflowContext<A extends AgentType = AgentType, N extends stri
     options: SessionRunOptions,
     clientOpts: StageClientOptions<A>,
     sessionOpts: StageSessionOptions<A>,
-    run: (ctx: SessionContext<A, N>) => Promise<T>,
+    run: (ctx: SessionContext<A, I>) => Promise<T>,
   ): Promise<SessionHandle<T>>;
   /**
    * Get a completed session's transcript as rendered text.
@@ -385,7 +428,10 @@ export interface WorkflowOptions<
 /**
  * A compiled workflow definition — the sealed output of defineWorkflow().compile().
  */
-export interface WorkflowDefinition<A extends AgentType = AgentType, N extends string = string> {
+export interface WorkflowDefinition<
+  A extends AgentType = AgentType,
+  I extends readonly WorkflowInput[] = readonly WorkflowInput[],
+> {
   readonly __brand: "WorkflowDefinition";
   readonly name: string;
   readonly description: string;
@@ -397,5 +443,5 @@ export interface WorkflowDefinition<A extends AgentType = AgentType, N extends s
    */
   readonly minSDKVersion: string | null;
   /** The workflow's entry point. Called by the executor with a WorkflowContext. */
-  readonly run: (ctx: WorkflowContext<A, N>) => Promise<void>;
+  readonly run: (ctx: WorkflowContext<A, I>) => Promise<void>;
 }

package/src/sdk/workflows/builtin/ralph/claude/index.ts

@@ -4,7 +4,7 @@
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
- *   - {@link MAX_LOOPS} iterations have completed, OR
+ *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
  *   - Two parallel reviewer passes both return zero findings.
  *
  * The reviewer stages run the `reviewer` sub-agent in a visible TUI via the
@@ -34,7 +34,7 @@ import {
 import { hasActionableFindings } from "../helpers/review.ts";
 import { captureBranchChangeset } from "../helpers/git.ts";
 
-const MAX_LOOPS = 10;
+const DEFAULT_MAX_LOOPS = 10;
 
 // The orchestrator stage implements the actual code changes and can run for
 // a very long time on large tasks. Completion is detected via session file
@@ -62,14 +62,21 @@ export default defineWorkflow({
       required: true,
       description: "task prompt",
     },
+    {
+      name: "max_loops",
+      type: "integer",
+      description: "maximum number of plan/orchestrate/review iterations",
+      default: DEFAULT_MAX_LOOPS,
+    },
   ],
 })
   .for<"claude">()
   .run(async (ctx) => {
     const prompt = ctx.inputs.prompt ?? "";
+    const maxLoops = ctx.inputs.max_loops ?? DEFAULT_MAX_LOOPS;
     let debuggerReport = "";
 
-    for (let iteration = 1; iteration <= MAX_LOOPS; iteration++) {
+    for (let iteration = 1; iteration <= maxLoops; iteration++) {
       // ── Plan ────────────────────────────────────────────────────────────
       await ctx.stage(
         { name: `planner-${iteration}` },
@@ -217,7 +224,7 @@ export default defineWorkflow({
       if (!hasActionableFindings(parsed, reviewRaw)) break;
 
       // ── Debug (only if another iteration is allowed) ────────────────────
-      if (iteration < MAX_LOOPS) {
+      if (iteration < maxLoops) {
         const debugger_ = await ctx.stage(
           { name: `debugger-${iteration}` },
           {

package/src/sdk/workflows/builtin/ralph/copilot/index.ts

@@ -4,7 +4,7 @@
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
- *   - {@link MAX_LOOPS} iterations have completed, OR
+ *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
  *   - Two parallel reviewer passes both return zero findings.
  *
  * The reviewer stages use a `submit_review` custom tool (defined via
@@ -35,7 +35,7 @@ import {
 import { hasActionableFindings } from "../helpers/review.ts";
 import { captureBranchChangeset } from "../helpers/git.ts";
 
-const MAX_LOOPS = 10;
+const DEFAULT_MAX_LOOPS = 10;
 
 const SUBMIT_REVIEW_DESCRIPTION =
   "Submit the structured code review result. You MUST call this tool " +
@@ -85,14 +85,21 @@ export default defineWorkflow({
       required: true,
       description: "task prompt",
     },
+    {
+      name: "max_loops",
+      type: "integer",
+      description: "maximum number of plan/orchestrate/review iterations",
+      default: DEFAULT_MAX_LOOPS,
+    },
   ],
 })
   .for<"copilot">()
   .run(async (ctx) => {
     const userPromptText = ctx.inputs.prompt ?? "";
+    const maxLoops = ctx.inputs.max_loops ?? DEFAULT_MAX_LOOPS;
     let debuggerReport = "";
 
-    for (let iteration = 1; iteration <= MAX_LOOPS; iteration++) {
+    for (let iteration = 1; iteration <= maxLoops; iteration++) {
       // ── Plan ──────────────────────────────────────────────────────────
       const planner = await ctx.stage(
         { name: `planner-${iteration}` },
@@ -247,7 +254,7 @@ export default defineWorkflow({
       if (!hasActionableFindings(parsed, reviewRaw)) break;
 
       // ── Debug (only if another iteration is allowed) ──────────────────
-      if (iteration < MAX_LOOPS) {
+      if (iteration < maxLoops) {
         const debugger_ = await ctx.stage(
           { name: `debugger-${iteration}` },
           {},

package/src/sdk/workflows/builtin/ralph/opencode/index.ts

@@ -4,7 +4,7 @@
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
- *   - {@link MAX_LOOPS} iterations have completed, OR
+ *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
  *   - Two parallel reviewer passes both return zero findings.
  *
  * The reviewer stages use the OpenCode SDK's structured output
@@ -32,7 +32,7 @@ import {
 import { hasActionableFindings } from "../helpers/review.ts";
 import { captureBranchChangeset } from "../helpers/git.ts";
 
-const MAX_LOOPS = 10;
+const DEFAULT_MAX_LOOPS = 10;
 
 /** Concatenate the text-typed parts of an OpenCode response. */
 function extractResponseText(
@@ -71,14 +71,21 @@ export default defineWorkflow({
     "Plan → orchestrate → review → debug loop with bounded iteration",
   inputs: [
     { name: "prompt", type: "text", required: true, description: "task prompt" },
+    {
+      name: "max_loops",
+      type: "integer",
+      description: "maximum number of plan/orchestrate/review iterations",
+      default: DEFAULT_MAX_LOOPS,
+    },
   ],
 })
   .for<"opencode">()
   .run(async (ctx) => {
     const prompt = ctx.inputs.prompt ?? "";
+    const maxLoops = ctx.inputs.max_loops ?? DEFAULT_MAX_LOOPS;
     let debuggerReport = "";
 
-    for (let iteration = 1; iteration <= MAX_LOOPS; iteration++) {
+    for (let iteration = 1; iteration <= maxLoops; iteration++) {
       // ── Plan ────────────────────────────────────────────────────────────
       const planner = await ctx.stage(
         { name: `planner-${iteration}` },
@@ -225,7 +232,7 @@ export default defineWorkflow({
       if (!hasActionableFindings(parsed, reviewRaw)) break;
 
       // ── Debug (only if another iteration is allowed) ────────────────────
-      if (iteration < MAX_LOOPS) {
+      if (iteration < maxLoops) {
         const debugger_ = await ctx.stage(
           { name: `debugger-${iteration}` },
           {},