toolroll 0.9.34 → 0.9.36

package/dist/contracts/flow-propose.d.ts

@@ -0,0 +1,325 @@
+/**
+ * The lead's `propose_flow` input (docs/plans/zod-revamp.md, item 3): one schema, built from the flow contract's own
+ * step and trigger schemas, that is both the JSON Schema the lead is given and the check its call is read with
+ * (mate-tools.ts). The lead-tools contract (item 5) imports it from here rather than restating it.
+ */
+import { z } from "zod";
+export declare const PROPOSE_FLOW_OPERATIONS: readonly ["create", "edit", "add_card", "move_card", "approve", "send_back", "choose", "cancel_card", "comment", "assign", "follow", "unfollow", "save_script", "add_trigger", "pause_trigger", "resume_trigger", "remove_trigger", "kit", "starter"];
+export declare const proposeFlowInputSchema: z.ZodObject<{
+    operation: z.ZodEnum<{
+        add_card: "add_card";
+        add_trigger: "add_trigger";
+        approve: "approve";
+        assign: "assign";
+        cancel_card: "cancel_card";
+        choose: "choose";
+        comment: "comment";
+        create: "create";
+        edit: "edit";
+        follow: "follow";
+        kit: "kit";
+        move_card: "move_card";
+        pause_trigger: "pause_trigger";
+        remove_trigger: "remove_trigger";
+        resume_trigger: "resume_trigger";
+        save_script: "save_script";
+        send_back: "send_back";
+        starter: "starter";
+        unfollow: "unfollow";
+    }>;
+    repo: z.ZodOptional<z.ZodString>;
+    flow: z.ZodOptional<z.ZodInt>;
+    card: z.ZodOptional<z.ZodInt>;
+    kit: z.ZodOptional<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+    starter: z.ZodOptional<z.ZodEnum<{
+        "ci-fix": "ci-fix";
+        "issue-task": "issue-task";
+        overnight: "overnight";
+        "plane-review": "plane-review";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+    template: z.ZodOptional<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"inbox">;
+        ifFails: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        thenMoveTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"task">;
+        ifFails: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        planning: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            required: "required";
+            skip: "skip";
+        }>>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        repo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"report">;
+        ifFails: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"approval">;
+        decider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        ifFails: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        teammate: z.ZodOptional<z.ZodString>;
+        thenMoveTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"check">;
+        ifFails: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            answer: z.ZodString;
+            goesTo: z.ZodString;
+        }, z.core.$strict>>>;
+        runIn: z.ZodOptional<z.ZodEnum<{
+            copy: "copy";
+            folder: "folder";
+        }>>;
+        script: z.ZodOptional<z.ZodString>;
+        secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"pull-request">;
+        ifFails: z.ZodOptional<z.ZodString>;
+        merge: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+            merge: "merge";
+            rebase: "rebase";
+            squash: "squash";
+        }>]>>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"update">;
+        close: z.ZodOptional<z.ZodBoolean>;
+        ifFails: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"notify">;
+        ifFails: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"sort">;
+        alsoNote: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            question: z.ZodString;
+            kind: z.ZodOptional<z.ZodEnum<{
+                score: "score";
+                "yes-no": "yes-no";
+            }>>;
+            levels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+        answers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            answer: z.ZodString;
+            means: z.ZodOptional<z.ZodString>;
+            goesTo: z.ZodString;
+        }, z.core.$strict>>>;
+        ifNotSure: z.ZodOptional<z.ZodString>;
+        question: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        sureAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"draft">;
+        ifFails: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"request">;
+        body: z.ZodOptional<z.ZodString>;
+        headers: z.ZodOptional<z.ZodObject<{}, z.core.$catchall<z.ZodString>>>;
+        ifFails: z.ZodOptional<z.ZodString>;
+        method: z.ZodOptional<z.ZodEnum<{
+            DELETE: "DELETE";
+            GET: "GET";
+            PATCH: "PATCH";
+            POST: "POST";
+            PUT: "PUT";
+        }>>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"email">;
+        body: z.ZodOptional<z.ZodString>;
+        ifFails: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        subject: z.ZodOptional<z.ZodString>;
+        to: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"tool">;
+        args: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{}, z.core.$catchall<z.ZodUnknown>>, z.ZodString]>>;
+        ifFails: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        server: z.ZodOptional<z.ZodString>;
+        tool: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"wait">;
+        from: z.ZodOptional<z.ZodString>;
+        ifNoReply: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        until: z.ZodOptional<z.ZodString>;
+        wait: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        waitFor: z.ZodOptional<z.ZodEnum<{
+            hours: "hours";
+            reply: "reply";
+            time: "time";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"teammate">;
+        ifFails: z.ZodOptional<z.ZodString>;
+        instructions: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        reply: z.ZodOptional<z.ZodBoolean>;
+        routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            answer: z.ZodString;
+            goesTo: z.ZodString;
+        }, z.core.$strict>>>;
+        teammate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"send">;
+        ifFails: z.ZodOptional<z.ZodString>;
+        next: z.ZodOptional<z.ZodString>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"choose">;
+        ifNoReply: z.ZodOptional<z.ZodString>;
+        ifReplied: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            goesTo: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        remindAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        thenMoveTo: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        kind: z.ZodLiteral<"done">;
+    }, z.core.$strict>], "kind">>>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    zone: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    choice: z.ZodOptional<z.ZodInt>;
+    trigger: z.ZodOptional<z.ZodInt>;
+    owner: z.ZodOptional<z.ZodString>;
+    script: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        about: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodString>;
+        timeoutMinutes: z.ZodOptional<z.ZodInt>;
+        language: z.ZodOptional<z.ZodEnum<{
+            node: "node";
+            python: "python";
+            shell: "shell";
+        }>>;
+        file: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    settings: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        zone: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"button">;
+        label: z.ZodString;
+        questions: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        zone: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"schedule">;
+        schedule: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        script: z.ZodOptional<z.ZodString>;
+        secrets: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>;
+    }, z.core.$strict>, z.ZodObject<{
+        zone: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"github">;
+        repo: z.ZodOptional<z.ZodString>;
+        watch: z.ZodOptional<z.ZodEnum<{
+            checks: "checks";
+            issues: "issues";
+            pulls: "pulls";
+        }>>;
+        label: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        from: z.ZodOptional<z.ZodEnum<{
+            anyone: "anyone";
+            team: "team";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        zone: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"linear">;
+        team: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        zone: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"flow">;
+        when: z.ZodOptional<z.ZodString>;
+        follow: z.ZodInt;
+    }, z.core.$strict>, z.ZodObject<{
+        zone: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"email">;
+        folder: z.ZodOptional<z.ZodString>;
+        sender: z.ZodOptional<z.ZodString>;
+        subject: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        zone: z.ZodOptional<z.ZodString>;
+        kind: z.ZodLiteral<"plane-review">;
+        at: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>;
+export type ProposeFlowInput = z.infer<typeof proposeFlowInputSchema>;
+/** What the lead is told propose_flow takes: exactly the schema its call is read with. */
+export declare const PROPOSE_FLOW_MODEL_SCHEMA: Readonly<Record<string, unknown>>;

package/dist/contracts/flow-propose.js

@@ -0,0 +1,41 @@
+/**
+ * The lead's `propose_flow` input (docs/plans/zod-revamp.md, item 3): one schema, built from the flow contract's own
+ * step and trigger schemas, that is both the JSON Schema the lead is given and the check its call is read with
+ * (mate-tools.ts). The lead-tools contract (item 5) imports it from here rather than restating it.
+ */
+import { z } from "zod";
+import { LIMITS } from "../decision.js";
+import { STARTER_IDS } from "../flow-starters.js";
+import { FLOW_TEMPLATES } from "../flows.js";
+import { KITS } from "../kits.js";
+import { TEXT_LIMITS } from "../text-limits.js";
+import { toModelSchema } from "./contract.js";
+import { flowStepsSchema, leadTriggerSchema, SCRIPT_LANGUAGES, SCRIPT_NAME } from "./flow.js";
+export const PROPOSE_FLOW_OPERATIONS = ["create", "edit", "add_card", "move_card", "approve", "send_back", "choose", "cancel_card", "comment", "assign", "follow", "unfollow", "save_script", "add_trigger", "pause_trigger", "resume_trigger", "remove_trigger", "kit", "starter"];
+const id = z.int().min(1);
+const enumOf = (values) => z.enum(values);
+export const proposeFlowInputSchema = z.strictObject({
+    operation: z.enum(PROPOSE_FLOW_OPERATIONS),
+    /** A project as list_repos names it (r1, r2). */
+    repo: z.string().regex(/^r[0-9]{1,3}$/, { error: "must be a project from list_repos, like r1" }).optional(),
+    flow: id.optional(), card: id.optional(),
+    kit: enumOf(KITS.map(one => one.id)).optional(),
+    starter: z.enum(STARTER_IDS).optional(),
+    name: z.string().max(TEXT_LIMITS.flowName).optional(),
+    template: enumOf(FLOW_TEMPLATES.map(one => one.id)).optional(),
+    steps: flowStepsSchema.shape.steps.optional(),
+    title: z.string().max(TEXT_LIMITS.flowCardTitle).optional(),
+    description: z.string().max(TEXT_LIMITS.flowCardDescription).optional(),
+    zone: z.string().max(TEXT_LIMITS.flowRef).optional(),
+    note: z.string().max(LIMITS.note).describe(`At most ${LIMITS.note} characters; longer is refused with its length, not cut.`).optional(),
+    choice: z.int().min(1).max(4).optional(),
+    trigger: id.optional(),
+    owner: z.string().max(TEXT_LIMITS.flowDecider).optional(),
+    script: z.strictObject({
+        name: z.string().regex(SCRIPT_NAME, { error: "must be a script's name: lowercase letters, numbers and dashes" }).optional(), about: z.string().max(TEXT_LIMITS.flowScriptAbout).optional(), body: z.string().max(TEXT_LIMITS.flowScriptInline).optional(),
+        timeoutMinutes: z.int().min(1).max(60).optional(), language: z.enum(SCRIPT_LANGUAGES).optional(), file: z.string().max(TEXT_LIMITS.flowScriptFile).optional(),
+    }).optional(),
+    settings: leadTriggerSchema.optional(),
+});
+/** What the lead is told propose_flow takes: exactly the schema its call is read with. */
+export const PROPOSE_FLOW_MODEL_SCHEMA = toModelSchema(proposeFlowInputSchema);