@sweny-ai/core 0.1.62 → 0.1.64

package/dist/schema.d.ts

@@ -333,6 +333,77 @@ export declare const skillZ: z.ZodEffects<z.ZodObject<{
         input_schema: Record<string, unknown>;
     }[] | undefined;
 }>;
+/**
+ * NodeSources: either an array of Sources (additive — inherits cascade)
+ * or an object `{ only?: boolean, sources: Source[] }` where `only: true`
+ * blocks the cascade for that field.
+ */
+export declare const nodeSourcesZ: z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    inline: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    inline: string;
+}, {
+    inline: string;
+}>, z.ZodObject<{
+    file: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    file: string;
+}, {
+    file: string;
+}>, z.ZodObject<{
+    url: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    url: string;
+    type?: string | undefined;
+}, {
+    url: string;
+    type?: string | undefined;
+}>]>, "many">, z.ZodObject<{
+    only: z.ZodOptional<z.ZodBoolean>;
+    sources: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        inline: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        inline: string;
+    }, {
+        inline: string;
+    }>, z.ZodObject<{
+        file: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        file: string;
+    }, {
+        file: string;
+    }>, z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        url: string;
+        type?: string | undefined;
+    }, {
+        url: string;
+        type?: string | undefined;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    sources: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[];
+    only?: boolean | undefined;
+}, {
+    sources: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[];
+    only?: boolean | undefined;
+}>]>;
 export declare const nodeZ: z.ZodObject<{
     name: z.ZodString;
     instruction: z.ZodUnion<[z.ZodString, z.ZodObject<{
@@ -360,6 +431,138 @@ export declare const nodeZ: z.ZodObject<{
     skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     output: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     max_turns: z.ZodOptional<z.ZodNumber>;
+    rules: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        inline: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        inline: string;
+    }, {
+        inline: string;
+    }>, z.ZodObject<{
+        file: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        file: string;
+    }, {
+        file: string;
+    }>, z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        url: string;
+        type?: string | undefined;
+    }, {
+        url: string;
+        type?: string | undefined;
+    }>]>, "many">, z.ZodObject<{
+        only: z.ZodOptional<z.ZodBoolean>;
+        sources: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            inline: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            inline: string;
+        }, {
+            inline: string;
+        }>, z.ZodObject<{
+            file: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            file: string;
+        }, {
+            file: string;
+        }>, z.ZodObject<{
+            url: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            url: string;
+            type?: string | undefined;
+        }, {
+            url: string;
+            type?: string | undefined;
+        }>]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        sources: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[];
+        only?: boolean | undefined;
+    }, {
+        sources: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[];
+        only?: boolean | undefined;
+    }>]>>;
+    context: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        inline: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        inline: string;
+    }, {
+        inline: string;
+    }>, z.ZodObject<{
+        file: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        file: string;
+    }, {
+        file: string;
+    }>, z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        url: string;
+        type?: string | undefined;
+    }, {
+        url: string;
+        type?: string | undefined;
+    }>]>, "many">, z.ZodObject<{
+        only: z.ZodOptional<z.ZodBoolean>;
+        sources: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            inline: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            inline: string;
+        }, {
+            inline: string;
+        }>, z.ZodObject<{
+            file: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            file: string;
+        }, {
+            file: string;
+        }>, z.ZodObject<{
+            url: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            url: string;
+            type?: string | undefined;
+        }, {
+            url: string;
+            type?: string | undefined;
+        }>]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        sources: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[];
+        only?: boolean | undefined;
+    }, {
+        sources: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[];
+        only?: boolean | undefined;
+    }>]>>;
 }, "strip", z.ZodTypeAny, {
     instruction: string | {
         inline: string;
@@ -371,6 +574,42 @@ export declare const nodeZ: z.ZodObject<{
     };
     name: string;
     skills: string[];
+    rules?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | {
+        sources: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[];
+        only?: boolean | undefined;
+    } | undefined;
+    context?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | {
+        sources: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[];
+        only?: boolean | undefined;
+    } | undefined;
     output?: Record<string, unknown> | undefined;
     max_turns?: number | undefined;
 }, {
@@ -383,6 +622,42 @@ export declare const nodeZ: z.ZodObject<{
         type?: string | undefined;
     };
     name: string;
+    rules?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | {
+        sources: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[];
+        only?: boolean | undefined;
+    } | undefined;
+    context?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | {
+        sources: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[];
+        only?: boolean | undefined;
+    } | undefined;
     output?: Record<string, unknown> | undefined;
     skills?: string[] | undefined;
     max_turns?: number | undefined;
@@ -434,6 +709,138 @@ export declare const workflowZ: z.ZodObject<{
         skills: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         output: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         max_turns: z.ZodOptional<z.ZodNumber>;
+        rules: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            inline: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            inline: string;
+        }, {
+            inline: string;
+        }>, z.ZodObject<{
+            file: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            file: string;
+        }, {
+            file: string;
+        }>, z.ZodObject<{
+            url: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            url: string;
+            type?: string | undefined;
+        }, {
+            url: string;
+            type?: string | undefined;
+        }>]>, "many">, z.ZodObject<{
+            only: z.ZodOptional<z.ZodBoolean>;
+            sources: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                inline: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                inline: string;
+            }, {
+                inline: string;
+            }>, z.ZodObject<{
+                file: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                file: string;
+            }, {
+                file: string;
+            }>, z.ZodObject<{
+                url: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                url: string;
+                type?: string | undefined;
+            }, {
+                url: string;
+                type?: string | undefined;
+            }>]>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        }, {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        }>]>>;
+        context: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            inline: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            inline: string;
+        }, {
+            inline: string;
+        }>, z.ZodObject<{
+            file: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            file: string;
+        }, {
+            file: string;
+        }>, z.ZodObject<{
+            url: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            url: string;
+            type?: string | undefined;
+        }, {
+            url: string;
+            type?: string | undefined;
+        }>]>, "many">, z.ZodObject<{
+            only: z.ZodOptional<z.ZodBoolean>;
+            sources: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+                inline: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                inline: string;
+            }, {
+                inline: string;
+            }>, z.ZodObject<{
+                file: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                file: string;
+            }, {
+                file: string;
+            }>, z.ZodObject<{
+                url: z.ZodString;
+                type: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                url: string;
+                type?: string | undefined;
+            }, {
+                url: string;
+                type?: string | undefined;
+            }>]>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        }, {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        }>]>>;
     }, "strip", z.ZodTypeAny, {
         instruction: string | {
             inline: string;
@@ -445,6 +852,42 @@ export declare const workflowZ: z.ZodObject<{
         };
         name: string;
         skills: string[];
+        rules?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
+        context?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
         output?: Record<string, unknown> | undefined;
         max_turns?: number | undefined;
     }, {
@@ -457,6 +900,42 @@ export declare const workflowZ: z.ZodObject<{
             type?: string | undefined;
         };
         name: string;
+        rules?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
+        context?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
         output?: Record<string, unknown> | undefined;
         skills?: string[] | undefined;
         max_turns?: number | undefined;
@@ -567,6 +1046,50 @@ export declare const workflowZ: z.ZodObject<{
             args?: string[] | undefined;
         } | undefined;
     }>>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        inline: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        inline: string;
+    }, {
+        inline: string;
+    }>, z.ZodObject<{
+        file: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        file: string;
+    }, {
+        file: string;
+    }>, z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        url: string;
+        type?: string | undefined;
+    }, {
+        url: string;
+        type?: string | undefined;
+    }>]>, "many">>;
+    context: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        inline: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        inline: string;
+    }, {
+        inline: string;
+    }>, z.ZodObject<{
+        file: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        file: string;
+    }, {
+        file: string;
+    }>, z.ZodObject<{
+        url: z.ZodString;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        url: string;
+        type?: string | undefined;
+    }, {
+        url: string;
+        type?: string | undefined;
+    }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     id: string;
@@ -595,6 +1118,42 @@ export declare const workflowZ: z.ZodObject<{
         };
         name: string;
         skills: string[];
+        rules?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
+        context?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
         output?: Record<string, unknown> | undefined;
         max_turns?: number | undefined;
     }>;
@@ -605,6 +1164,22 @@ export declare const workflowZ: z.ZodObject<{
         max_iterations?: number | undefined;
     }[];
     entry: string;
+    rules?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | undefined;
+    context?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | undefined;
 }, {
     name: string;
     id: string;
@@ -618,6 +1193,42 @@ export declare const workflowZ: z.ZodObject<{
             type?: string | undefined;
         };
         name: string;
+        rules?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
+        context?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
         output?: Record<string, unknown> | undefined;
         skills?: string[] | undefined;
         max_turns?: number | undefined;
@@ -629,6 +1240,22 @@ export declare const workflowZ: z.ZodObject<{
         max_iterations?: number | undefined;
     }[];
     entry: string;
+    rules?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | undefined;
+    context?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | undefined;
     description?: string | undefined;
     skills?: Record<string, {
         instruction?: string | undefined;
@@ -673,6 +1300,42 @@ export declare function parseWorkflow(raw: unknown): {
         };
         name: string;
         skills: string[];
+        rules?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
+        context?: (string | {
+            inline: string;
+        } | {
+            file: string;
+        } | {
+            url: string;
+            type?: string | undefined;
+        })[] | {
+            sources: (string | {
+                inline: string;
+            } | {
+                file: string;
+            } | {
+                url: string;
+                type?: string | undefined;
+            })[];
+            only?: boolean | undefined;
+        } | undefined;
         output?: Record<string, unknown> | undefined;
         max_turns?: number | undefined;
     }>;
@@ -683,6 +1346,22 @@ export declare function parseWorkflow(raw: unknown): {
         max_iterations?: number | undefined;
     }[];
     entry: string;
+    rules?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | undefined;
+    context?: (string | {
+        inline: string;
+    } | {
+        file: string;
+    } | {
+        url: string;
+        type?: string | undefined;
+    })[] | undefined;
 };
 export interface WorkflowError {
     code: "MISSING_ENTRY" | "UNKNOWN_EDGE_SOURCE" | "UNKNOWN_EDGE_TARGET" | "UNREACHABLE_NODE" | "UNKNOWN_SKILL" | "SELF_LOOP" | "UNBOUNDED_CYCLE" | "INVALID_INLINE_SKILL";
@@ -752,6 +1431,29 @@ export declare const workflowJsonSchema: {
                 readonly additionalProperties: false;
             }];
         };
+        readonly NodeSources: {
+            readonly oneOf: readonly [{
+                readonly type: "array";
+                readonly items: {
+                    readonly $ref: "#/$defs/Source";
+                };
+            }, {
+                readonly type: "object";
+                readonly required: readonly ["sources"];
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly only: {
+                        readonly type: "boolean";
+                    };
+                    readonly sources: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/Source";
+                        };
+                    };
+                };
+            }];
+        };
     };
     readonly properties: {
         readonly id: {
@@ -770,6 +1472,20 @@ export declare const workflowJsonSchema: {
             readonly minLength: 1;
             readonly description: "ID of the entry node";
         };
+        readonly rules: {
+            readonly type: "array";
+            readonly items: {
+                readonly $ref: "#/$defs/Source";
+            };
+            readonly description: "Directives prepended to every node's instruction.";
+        };
+        readonly context: {
+            readonly type: "array";
+            readonly items: {
+                readonly $ref: "#/$defs/Source";
+            };
+            readonly description: "Background knowledge prepended to every node's instruction.";
+        };
         readonly nodes: {
             readonly type: "object";
             readonly additionalProperties: {
@@ -801,6 +1517,14 @@ export declare const workflowJsonSchema: {
                         readonly minimum: 1;
                         readonly description: "Max AI model turns for this node. When absent, the executor's default applies.";
                     };
+                    readonly rules: {
+                        readonly $ref: "#/$defs/NodeSources";
+                        readonly description: "Per-node rules. Additive by default; set { only: true } to block cascade.";
+                    };
+                    readonly context: {
+                        readonly $ref: "#/$defs/NodeSources";
+                        readonly description: "Per-node context. Additive by default; set { only: true } to block cascade.";
+                    };
                 };
             };
         };