@barnum/barnum 0.0.0-main-20fffb47 → 0.0.0-main-eb8c5afe

package/barnum-config-schema.json

@@ -52,7 +52,7 @@
       "description": "How a step processes tasks. Set `\"kind\": \"Pool\"` to send tasks to AI agents, or `\"kind\": \"Command\"` to run a local shell script.",
       "oneOf": [
         {
-          "description": "Send the task to the agent pool. An AI agent receives the task's `value` along with the `instructions` (markdown prompt) and produces a JSON array of follow-up tasks.",
+          "description": "Send the task to the agent pool for processing.",
           "type": "object",
           "required": [
             "instructions",
@@ -76,7 +76,7 @@
           }
         },
         {
-          "description": "Run a local shell command instead of sending to an agent. Use this for deterministic transformations, fan-out, or glue logic.",
+          "description": "Run a local shell command.",
           "type": "object",
           "required": [
             "kind",
@@ -115,7 +115,7 @@
               ]
             },
             "script": {
-              "description": "Shell script to execute. Receives the task's original value as JSON on stdin, must write a JSON array of follow-up tasks on stdout.",
+              "description": "Shell script to execute.",
               "type": "string"
             }
           }
@@ -211,71 +211,29 @@
       },
       "additionalProperties": false
     },
-    "PostHook": {
-      "description": "Post-action hook. Inspects or modifies the action's outcome.\n\nIn JSON: `{\"kind\": \"Command\", \"script\": \"./post-hook.sh\"}`\n\n**stdin:** Tagged JSON describing the outcome (`\"kind\": \"Success\"`, `\"Timeout\"`, `\"Error\"`, or `\"PreHookError\"`). On success, includes an `input`, `output`, and `next` (follow-up tasks) field. **stdout:** Same tagged JSON, possibly modified (e.g., filtering `next`).",
-      "oneOf": [
-        {
-          "description": "Run a shell command as the post hook.",
-          "type": "object",
-          "required": [
-            "kind",
-            "script"
-          ],
-          "properties": {
-            "kind": {
-              "type": "string",
-              "enum": [
-                "Command"
-              ]
-            },
-            "script": {
-              "description": "Shell script to execute. Receives the action outcome as JSON on stdin, must write the (possibly modified) outcome as JSON on stdout.",
-              "type": "string"
-            }
-          }
-        }
-      ]
-    },
-    "PreHook": {
-      "description": "Pre-action hook. Transforms the task value before the action runs.\n\nIn JSON: `{\"kind\": \"Command\", \"script\": \"./pre-hook.sh\"}`\n\n**stdin:** Task value payload (e.g., `{\"path\": \"/src\"}`). **stdout:** Modified value payload (same shape).",
-      "oneOf": [
-        {
-          "description": "Run a shell command as the pre hook.",
-          "type": "object",
-          "required": [
-            "kind",
-            "script"
-          ],
-          "properties": {
-            "kind": {
-              "type": "string",
-              "enum": [
-                "Command"
-              ]
-            },
-            "script": {
-              "description": "Shell script to execute. Receives the task's value as JSON on stdin, must write the (possibly modified) value as JSON on stdout.",
-              "type": "string"
-            }
-          }
+    "SchemaLink": {
+      "description": "Reference to an external JSON Schema file.",
+      "type": "object",
+      "required": [
+        "link"
+      ],
+      "properties": {
+        "link": {
+          "description": "Relative path to the JSON Schema file (e.g., `\"schemas/task.json\"`).",
+          "type": "string"
         }
-      ]
+      }
     },
     "SchemaRef": {
       "description": "A JSON Schema for validating task payloads. Can be provided inline or loaded from a file.\n\n- Inline: write the JSON Schema object directly, e.g. `{\"type\": \"object\", \"properties\": {...}}` - Linked: `{\"link\": \"path/to/schema.json\"}` to load from a file (path relative to config file)",
       "anyOf": [
         {
           "description": "Reference to an external JSON Schema file. The path is relative to the config file's directory.",
-          "type": "object",
-          "required": [
-            "link"
-          ],
-          "properties": {
-            "link": {
-              "description": "Relative path to the JSON Schema file (e.g., `\"schemas/task.json\"`).",
-              "type": "string"
+          "allOf": [
+            {
+              "$ref": "#/definitions/SchemaLink"
             }
-          }
+          ]
         },
         {
           "description": "Inline JSON Schema object (any valid JSON Schema)."
@@ -283,7 +241,7 @@
       ]
     },
     "StepFile": {
-      "description": "A named step in the workflow. Steps are the nodes of the task graph.\n\nExecution order for each task: `pre` hook → `action` → `post` hook. The `finally` hook runs after the task **and all of its descendant tasks** complete.",
+      "description": "A named step in the workflow. Steps are the nodes of the task graph.\n\nThe `finally` hook runs after the task **and all of its descendant tasks** complete.",
       "type": "object",
       "required": [
         "action",
@@ -336,30 +294,6 @@
             }
           ]
         },
-        "post": {
-          "description": "Shell script that runs **after** the action completes (or fails).\n\n**stdin:** A tagged JSON object describing the outcome. The `kind` field indicates what happened:\n\n- `{\"kind\": \"Success\", \"input\": <value>, \"output\": <agent_output>, \"next\": [<tasks>]}` — Action succeeded. `next` contains the follow-up tasks to spawn. - `{\"kind\": \"Timeout\", \"input\": <value>}` — Action timed out. - `{\"kind\": \"Error\", \"input\": <value>, \"error\": \"<message>\"}` — Action failed. - `{\"kind\": \"PreHookError\", \"input\": <value>, \"error\": \"<message>\"}` — Pre hook failed.\n\n**stdout:** The same tagged JSON object, possibly modified. Typically you modify the `next` array in `Success` to filter, rewrite, or add follow-up tasks.",
-          "default": null,
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PostHook"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
-        "pre": {
-          "description": "Shell script that runs **before** the action.\n\n**stdin:** The task's `value` payload as JSON (e.g., `{\"path\": \"/src\"}`). This is just the value — not the full `{\"kind\": ..., \"value\": ...}` wrapper.\n\n**stdout:** The (possibly modified) value payload as JSON. Must be the same shape. The modified value is what the action receives.\n\nUse this to enrich or transform the task before the action sees it (e.g., adding timestamps, resolving paths, fetching metadata).",
-          "default": null,
-          "anyOf": [
-            {
-              "$ref": "#/definitions/PreHook"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
         "value_schema": {
           "description": "JSON Schema that validates the `value` payload for tasks on this step. When set, tasks whose `value` doesn't conform are rejected. When omitted, any JSON value is accepted.",
           "default": null,

package/barnum-config-schema.zod.ts

@@ -15,17 +15,17 @@ const ActionFile = z.discriminatedUnion("kind", [
   z.object({
     instructions: MaybeLinked_for_String.describe("Markdown prompt shown to the agent processing this task. This is the core of what tells the agent what to do. Use `{\"kind\": \"Inline\", \"value\": \"...\"}` to write the markdown directly, or `{\"kind\": \"Link\", \"path\": \"path/to/file.md\"}` to reference an external file."),
     kind: z.literal("Pool"),
-  }).describe("Send the task to the agent pool. An AI agent receives the task's `value` along with the `instructions` (markdown prompt) and produces a JSON array of follow-up tasks."),
+  }).describe("Send the task to the agent pool for processing."),
   z.object({
     kind: z.literal("Command"),
     script: z.string().describe("Shell script to execute.\n\n**Input (stdin):** JSON object: `{\"kind\": \"<step name>\", \"value\": <payload>}`. Use `jq '.value'` to extract the payload, or `jq -r '.value.fieldName'` for a specific field.\n\n**Output (stdout):** JSON array of follow-up tasks to spawn: `[{\"kind\": \"NextStep\", \"value\": {...}}, ...]`. Each `kind` must be a step name listed in this step's `next` array. Return `[]` to spawn no follow-ups."),
-  }).describe("Run a local shell command instead of sending to an agent. Use this for deterministic transformations, fan-out, or glue logic."),
+  }).describe("Run a local shell command."),
 ]).describe("How a step processes tasks. Set `\"kind\": \"Pool\"` to send tasks to AI agents, or `\"kind\": \"Command\"` to run a local shell script.");
 
 const FinallyHook = z.discriminatedUnion("kind", [
   z.object({
     kind: z.literal("Command"),
-    script: z.string().describe("Shell script to execute. Receives the task's original value as JSON on stdin, must write a JSON array of follow-up tasks on stdout."),
+    script: z.string().describe("Shell script to execute."),
   }).describe("Run a shell command as the finally hook."),
 ]).describe("Finally hook. Runs after a task and all its descendants complete.\n\nIn JSON: `{\"kind\": \"Command\", \"script\": \"./finally-hook.sh\"}`\n\n**stdin:** The task's original value payload as JSON. **stdout:** JSON array of follow-up tasks: `[{\"kind\": \"StepName\", \"value\": {...}}, ...]`. Return `[]` for no follow-ups.");
 
@@ -37,24 +37,12 @@ const Options = z.object({
   timeout: z.number().int().nonnegative().nullable().optional().default(null).describe("Timeout in seconds for each task (None = no timeout)."),
 }).strict().describe("Global runtime options for task execution. All fields have sensible defaults.");
 
-const PostHook = z.discriminatedUnion("kind", [
-  z.object({
-    kind: z.literal("Command"),
-    script: z.string().describe("Shell script to execute. Receives the action outcome as JSON on stdin, must write the (possibly modified) outcome as JSON on stdout."),
-  }).describe("Run a shell command as the post hook."),
-]).describe("Post-action hook. Inspects or modifies the action's outcome.\n\nIn JSON: `{\"kind\": \"Command\", \"script\": \"./post-hook.sh\"}`\n\n**stdin:** Tagged JSON describing the outcome (`\"kind\": \"Success\"`, `\"Timeout\"`, `\"Error\"`, or `\"PreHookError\"`). On success, includes an `input`, `output`, and `next` (follow-up tasks) field. **stdout:** Same tagged JSON, possibly modified (e.g., filtering `next`).");
-
-const PreHook = z.discriminatedUnion("kind", [
-  z.object({
-    kind: z.literal("Command"),
-    script: z.string().describe("Shell script to execute. Receives the task's value as JSON on stdin, must write the (possibly modified) value as JSON on stdout."),
-  }).describe("Run a shell command as the pre hook."),
-]).describe("Pre-action hook. Transforms the task value before the action runs.\n\nIn JSON: `{\"kind\": \"Command\", \"script\": \"./pre-hook.sh\"}`\n\n**stdin:** Task value payload (e.g., `{\"path\": \"/src\"}`). **stdout:** Modified value payload (same shape).");
+const SchemaLink = z.object({
+  link: z.string().describe("Relative path to the JSON Schema file (e.g., `\"schemas/task.json\"`)."),
+}).describe("Reference to an external JSON Schema file.");
 
 const SchemaRef = z.union([
-  z.object({
-    link: z.string().describe("Relative path to the JSON Schema file (e.g., `\"schemas/task.json\"`)."),
-  }).describe("Reference to an external JSON Schema file. The path is relative to the config file's directory."),
+  SchemaLink.describe("Reference to an external JSON Schema file. The path is relative to the config file's directory."),
   z.any().describe("Inline JSON Schema object (any valid JSON Schema)."),
 ]).describe("A JSON Schema for validating task payloads. Can be provided inline or loaded from a file.\n\n- Inline: write the JSON Schema object directly, e.g. `{\"type\": \"object\", \"properties\": {...}}` - Linked: `{\"link\": \"path/to/schema.json\"}` to load from a file (path relative to config file)");
 
@@ -71,10 +59,8 @@ const StepFile = z.object({
   name: z.string().describe("Unique name for this step (e.g., `\"Analyze\"`, `\"Implement\"`, `\"Review\"`). This is the string used as `kind` when creating tasks: `{\"kind\": \"ThisStepName\", \"value\": {...}}`."),
   next: z.array(z.string()).optional().default([]).describe("Step names this step is allowed to spawn follow-up tasks on. Each string must match the `name` of another step in this config. An empty array means this is a terminal step (no follow-ups)."),
   options: StepOptions.optional().default({"max_retries": null, "retry_on_invalid_response": null, "retry_on_timeout": null, "timeout": null}).describe("Per-step options that override the global `options`. Only the fields you set here take effect; everything else falls through to the global defaults."),
-  post: PostHook.nullable().optional().default(null).describe("Shell script that runs **after** the action completes (or fails).\n\n**stdin:** A tagged JSON object describing the outcome. The `kind` field indicates what happened:\n\n- `{\"kind\": \"Success\", \"input\": <value>, \"output\": <agent_output>, \"next\": [<tasks>]}` — Action succeeded. `next` contains the follow-up tasks to spawn. - `{\"kind\": \"Timeout\", \"input\": <value>}` — Action timed out. - `{\"kind\": \"Error\", \"input\": <value>, \"error\": \"<message>\"}` — Action failed. - `{\"kind\": \"PreHookError\", \"input\": <value>, \"error\": \"<message>\"}` — Pre hook failed.\n\n**stdout:** The same tagged JSON object, possibly modified. Typically you modify the `next` array in `Success` to filter, rewrite, or add follow-up tasks."),
-  pre: PreHook.nullable().optional().default(null).describe("Shell script that runs **before** the action.\n\n**stdin:** The task's `value` payload as JSON (e.g., `{\"path\": \"/src\"}`). This is just the value — not the full `{\"kind\": ..., \"value\": ...}` wrapper.\n\n**stdout:** The (possibly modified) value payload as JSON. Must be the same shape. The modified value is what the action receives.\n\nUse this to enrich or transform the task before the action sees it (e.g., adding timestamps, resolving paths, fetching metadata)."),
   value_schema: SchemaRef.nullable().optional().default(null).describe("JSON Schema that validates the `value` payload for tasks on this step. When set, tasks whose `value` doesn't conform are rejected. When omitted, any JSON value is accepted."),
-}).strict().describe("A named step in the workflow. Steps are the nodes of the task graph.\n\nExecution order for each task: `pre` hook → `action` → `post` hook. The `finally` hook runs after the task **and all of its descendant tasks** complete.");
+}).strict().describe("A named step in the workflow. Steps are the nodes of the task graph.\n\nThe `finally` hook runs after the task **and all of its descendant tasks** complete.");
 
 export const configFileSchema = z.object({
   "$schema": z.string().nullable().optional().describe("Optional JSON Schema URL for editor validation (e.g., `\"./node_modules/@barnum/barnum/barnum-config-schema.json\"`). Ignored at runtime."),
@@ -88,8 +74,7 @@ export type MaybeLinked_for_String = z.infer<typeof MaybeLinked_for_String>;
 export type ActionFile = z.infer<typeof ActionFile>;
 export type FinallyHook = z.infer<typeof FinallyHook>;
 export type Options = z.infer<typeof Options>;
-export type PostHook = z.infer<typeof PostHook>;
-export type PreHook = z.infer<typeof PreHook>;
+export type SchemaLink = z.infer<typeof SchemaLink>;
 export type SchemaRef = z.infer<typeof SchemaRef>;
 export type StepOptions = z.infer<typeof StepOptions>;
 export type StepFile = z.infer<typeof StepFile>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barnum/barnum",
-  "version": "0.0.0-main-20fffb47",
+  "version": "0.0.0-main-eb8c5afe",
   "type": "module",
   "description": "Barnum CLI - workflow engine for agents.",
   "main": "index.ts",