@mhingston5/lasso 0.1.0 → 0.2.0

package/src/spec/schema.ts

@@ -35,7 +35,9 @@ export const harnessSpecSchema = {
                   label: { type: "string" },
                   executionPolicy: { $ref: "#/$defs/executionPolicy" },
                   retryPolicy: { $ref: "#/$defs/retryPolicy" },
-                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" }
+                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" },
+                  guardrails: { $ref: "#/$defs/nodeGuardrails" },
+                  verificationHooks: { $ref: "#/$defs/verificationHooks" }
                 }
               },
               {
@@ -54,7 +56,9 @@ export const harnessSpecSchema = {
                   label: { type: "string" },
                   executionPolicy: { $ref: "#/$defs/executionPolicy" },
                   retryPolicy: { $ref: "#/$defs/retryPolicy" },
-                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" }
+                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" },
+                  guardrails: { $ref: "#/$defs/nodeGuardrails" },
+                  verificationHooks: { $ref: "#/$defs/verificationHooks" }
                 }
               },
               {
@@ -70,7 +74,9 @@ export const harnessSpecSchema = {
                   timeout: { type: "number" },
                   label: { type: "string" },
                   executionPolicy: { $ref: "#/$defs/executionPolicy" },
-                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" }
+                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" },
+                  guardrails: { $ref: "#/$defs/nodeGuardrails" },
+                  verificationHooks: { $ref: "#/$defs/verificationHooks" }
                 }
               },
               {
@@ -85,7 +91,9 @@ export const harnessSpecSchema = {
                   elseNodeId: { type: "string", minLength: 1 },
                   label: { type: "string" },
                   executionPolicy: { $ref: "#/$defs/executionPolicy" },
-                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" }
+                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" },
+                  guardrails: { $ref: "#/$defs/nodeGuardrails" },
+                  verificationHooks: { $ref: "#/$defs/verificationHooks" }
                 }
               },
               {
@@ -99,7 +107,9 @@ export const harnessSpecSchema = {
                   strategy: { enum: ["all", "any", "majority"] },
                   label: { type: "string" },
                   executionPolicy: { $ref: "#/$defs/executionPolicy" },
-                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" }
+                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" },
+                  guardrails: { $ref: "#/$defs/nodeGuardrails" },
+                  verificationHooks: { $ref: "#/$defs/verificationHooks" }
                 }
               },
               {
@@ -114,7 +124,9 @@ export const harnessSpecSchema = {
                   label: { type: "string" },
                   executionPolicy: { $ref: "#/$defs/executionPolicy" },
                   retryPolicy: { $ref: "#/$defs/retryPolicy" },
-                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" }
+                  verificationPolicy: { $ref: "#/$defs/verificationPolicy" },
+                  guardrails: { $ref: "#/$defs/nodeGuardrails" },
+                  verificationHooks: { $ref: "#/$defs/verificationHooks" }
                 }
               }
             ]
@@ -249,6 +261,34 @@ export const harnessSpecSchema = {
           items: { type: "string" }
         }
       }
+    },
+    nodeGuardrails: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        timeoutSeconds: { type: "number", exclusiveMinimum: 0 },
+        maxRetries: { type: "number", minimum: 0 },
+        maxCostUsd: { type: "number", exclusiveMinimum: 0 },
+        constraints: {
+          type: "array",
+          items: { type: "string", minLength: 1 }
+        }
+      }
+    },
+    verificationHooks: {
+      type: "array",
+      items: {
+        type: "object",
+        required: ["name", "kind", "check", "onFail"],
+        additionalProperties: false,
+        properties: {
+          name: { type: "string", minLength: 1 },
+          kind: { enum: ["tool", "llm", "expression"] },
+          check: { type: "string", minLength: 1 },
+          onFail: { enum: ["block", "warn", "retry"] },
+          maxAttempts: { type: "number", minimum: 1 }
+        }
+      }
     }
   }
 };

package/src/spec/types.ts

@@ -75,6 +75,45 @@ export interface BaseNode {
 
   /** Verification policy for this node */
   verificationPolicy?: VerificationPolicy;
+
+  /** Per-node guardrails — limits that apply only during this node's execution */
+  guardrails?: NodeGuardrails;
+
+  /** Per-node verification hooks — run after this specific node completes */
+  verificationHooks?: VerificationHook[];
+}
+
+export interface NodeGuardrails {
+  /** Max execution time for this node in seconds */
+  timeoutSeconds?: number;
+  /** Max retries for this node (overrides global retryPolicy) */
+  maxRetries?: number;
+  /** Max cost in USD for this node (for LLM nodes) */
+  maxCostUsd?: number;
+  /** Custom guardrail expressions that must hold true */
+  constraints?: string[];
+}
+
+/**
+ * Inline verification hook that runs after the declaring node completes.
+ * Unlike {@link VerificationRule}, which references a separate verifier node
+ * in the graph (node-based verification), a VerificationHook defines an
+ * inline check (string expression, LLM prompt, or tool call) that executes
+ * as part of the same node's lifecycle. Both serve similar purposes through
+ * different mechanisms: hooks are lightweight and co-located, while rules
+ * allow full graph-node verification logic with independent inputs/outputs.
+ */
+export interface VerificationHook {
+  /** Hook name for identification */
+  name: string;
+  /** Kind of verification */
+  kind: "tool" | "llm" | "expression";
+  /** The check to run (tool name, prompt, or expression) */
+  check: string;
+  /** What to do on failure */
+  onFail: "block" | "warn" | "retry";
+  /** Max verification attempts (optional) */
+  maxAttempts?: number;
 }
 
 /** Execute a tool command */