lastlight-workflow-engine 0.1.0

package/dist/core/schema.d.ts

@@ -0,0 +1,344 @@
+import { z } from "zod";
+declare const OutputRuleSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        fail: "fail";
+        continue: "continue";
+        pause: "pause";
+    }>;
+    message: z.ZodOptional<z.ZodString>;
+    unless_label: z.ZodOptional<z.ZodString>;
+    unless_title_matches: z.ZodOptional<z.ZodString>;
+    bypass_message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const PhaseLoopSchema: z.ZodObject<{
+    max_cycles: z.ZodNumber;
+    on_request_changes: z.ZodObject<{
+        fix_prompt: z.ZodString;
+        fix_model: z.ZodOptional<z.ZodString>;
+        fix_variant: z.ZodOptional<z.ZodString>;
+        re_review_prompt: z.ZodString;
+    }, z.core.$strip>;
+    approval_gate: z.ZodOptional<z.ZodString>;
+    approval_artifact: z.ZodOptional<z.ZodString>;
+    messages: z.ZodOptional<z.ZodObject<{
+        on_cycle_start: z.ZodOptional<z.ZodString>;
+        on_approved: z.ZodOptional<z.ZodString>;
+        on_request_changes: z.ZodOptional<z.ZodString>;
+        on_max_cycles: z.ZodOptional<z.ZodString>;
+        on_fix_start: z.ZodOptional<z.ZodString>;
+        on_fix_failed: z.ZodOptional<z.ZodString>;
+        on_pause_for_approval: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const GenericLoopSchema: z.ZodObject<{
+    max_iterations: z.ZodNumber;
+    until: z.ZodOptional<z.ZodString>;
+    until_bash: z.ZodOptional<z.ZodString>;
+    interactive: z.ZodDefault<z.ZodBoolean>;
+    gate_message: z.ZodOptional<z.ZodString>;
+    gate_kind: z.ZodOptional<z.ZodEnum<{
+        approve: "approve";
+        reply: "reply";
+    }>>;
+    scratch_key: z.ZodOptional<z.ZodString>;
+    fresh_context: z.ZodDefault<z.ZodBoolean>;
+    on_soft_failure: z.ZodOptional<z.ZodObject<{
+        retries: z.ZodDefault<z.ZodNumber>;
+        then: z.ZodDefault<z.ZodEnum<{
+            fail: "fail";
+            complete: "complete";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const PhaseDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<{
+        bash: "bash";
+        script: "script";
+        context: "context";
+        agent: "agent";
+        "post-review": "post-review";
+    }>>;
+    command: z.ZodOptional<z.ZodString>;
+    script: z.ZodOptional<z.ZodString>;
+    runtime: z.ZodOptional<z.ZodEnum<{
+        js: "js";
+        ts: "ts";
+        python: "python";
+    }>>;
+    timeout_seconds: z.ZodOptional<z.ZodNumber>;
+    prompt: z.ZodOptional<z.ZodString>;
+    skill: z.ZodOptional<z.ZodString>;
+    skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    model: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodString>;
+    unrestricted_egress: z.ZodOptional<z.ZodBoolean>;
+    web_search: z.ZodOptional<z.ZodBoolean>;
+    requires_sandbox: z.ZodOptional<z.ZodEnum<{
+        gondolin: "gondolin";
+        docker: "docker";
+        none: "none";
+    }>>;
+    sandbox_image: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        qa: "qa";
+    }>>;
+    approval_gate: z.ZodOptional<z.ZodString>;
+    approval_artifact: z.ZodOptional<z.ZodString>;
+    approval_gate_message: z.ZodOptional<z.ZodString>;
+    messages: z.ZodOptional<z.ZodObject<{
+        on_start: z.ZodOptional<z.ZodString>;
+        on_success: z.ZodOptional<z.ZodString>;
+        on_failure: z.ZodOptional<z.ZodString>;
+        on_skipped_done: z.ZodOptional<z.ZodString>;
+        on_blocked: z.ZodOptional<z.ZodString>;
+        on_blocked_bypassed: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    loop: z.ZodOptional<z.ZodObject<{
+        max_cycles: z.ZodNumber;
+        on_request_changes: z.ZodObject<{
+            fix_prompt: z.ZodString;
+            fix_model: z.ZodOptional<z.ZodString>;
+            fix_variant: z.ZodOptional<z.ZodString>;
+            re_review_prompt: z.ZodString;
+        }, z.core.$strip>;
+        approval_gate: z.ZodOptional<z.ZodString>;
+        approval_artifact: z.ZodOptional<z.ZodString>;
+        messages: z.ZodOptional<z.ZodObject<{
+            on_cycle_start: z.ZodOptional<z.ZodString>;
+            on_approved: z.ZodOptional<z.ZodString>;
+            on_request_changes: z.ZodOptional<z.ZodString>;
+            on_max_cycles: z.ZodOptional<z.ZodString>;
+            on_fix_start: z.ZodOptional<z.ZodString>;
+            on_fix_failed: z.ZodOptional<z.ZodString>;
+            on_pause_for_approval: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    generic_loop: z.ZodOptional<z.ZodObject<{
+        max_iterations: z.ZodNumber;
+        until: z.ZodOptional<z.ZodString>;
+        until_bash: z.ZodOptional<z.ZodString>;
+        interactive: z.ZodDefault<z.ZodBoolean>;
+        gate_message: z.ZodOptional<z.ZodString>;
+        gate_kind: z.ZodOptional<z.ZodEnum<{
+            approve: "approve";
+            reply: "reply";
+        }>>;
+        scratch_key: z.ZodOptional<z.ZodString>;
+        fresh_context: z.ZodDefault<z.ZodBoolean>;
+        on_soft_failure: z.ZodOptional<z.ZodObject<{
+            retries: z.ZodDefault<z.ZodNumber>;
+            then: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                complete: "complete";
+            }>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    on_output: z.ZodOptional<z.ZodObject<{
+        contains_BLOCKED: z.ZodOptional<z.ZodObject<{
+            action: z.ZodEnum<{
+                fail: "fail";
+                continue: "continue";
+                pause: "pause";
+            }>;
+            message: z.ZodOptional<z.ZodString>;
+            unless_label: z.ZodOptional<z.ZodString>;
+            unless_title_matches: z.ZodOptional<z.ZodString>;
+            bypass_message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        contains_READY: z.ZodOptional<z.ZodObject<{
+            action: z.ZodEnum<{
+                fail: "fail";
+                continue: "continue";
+                pause: "pause";
+            }>;
+            message: z.ZodOptional<z.ZodString>;
+            unless_label: z.ZodOptional<z.ZodString>;
+            unless_title_matches: z.ZodOptional<z.ZodString>;
+            bypass_message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    on_success: z.ZodOptional<z.ZodObject<{
+        set_phase: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    depends_on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    trigger_rule: z.ZodOptional<z.ZodEnum<{
+        all_success: "all_success";
+        one_success: "one_success";
+        none_failed_min_one_success: "none_failed_min_one_success";
+        all_done: "all_done";
+    }>>;
+    output_var: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PhaseDefinition = z.infer<typeof PhaseDefinitionSchema>;
+/**
+ * Normalize a phase's skill declaration to a single list of names.
+ * Returns `[]` for phases that have neither `skill` nor `skills`
+ * (e.g. `prompt:`-only or `context:` phases).
+ */
+export declare function phaseSkillNames(phase: PhaseDefinition): string[];
+export type PhaseLoop = z.infer<typeof PhaseLoopSchema>;
+export type GenericLoop = z.infer<typeof GenericLoopSchema>;
+export type OutputRule = z.infer<typeof OutputRuleSchema>;
+/**
+ * Intents owned by the harness itself (workflow gates / session control), not by
+ * any workflow. A workflow's `classification.intent` may not claim one of these.
+ * The classifier keeps their category text + examples in its base prompt template.
+ */
+export declare const RESERVED_CONTROL_INTENTS: readonly ["approve", "reject", "status", "reset", "chat"];
+/**
+ * Uppercase prompt token for an intent — the string the classifier emits on its
+ * `INTENT:` line and parses back. `qa-test` → `QATEST`, `incident` → `INCIDENT`.
+ * Kept here (workflows layer) so the loader's validation and the classifier's
+ * prompt/parser derive tokens the same way.
+ */
+export declare function intentToken(intent: string): string;
+export declare const AgentWorkflowSchema: z.ZodObject<{
+    kind: z.ZodDefault<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    trigger: z.ZodOptional<z.ZodString>;
+    status_checklist: z.ZodOptional<z.ZodBoolean>;
+    final_message: z.ZodOptional<z.ZodString>;
+    variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    classification: z.ZodOptional<z.ZodObject<{
+        intent: z.ZodString;
+        description: z.ZodString;
+        examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    phases: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodDefault<z.ZodEnum<{
+            bash: "bash";
+            script: "script";
+            context: "context";
+            agent: "agent";
+            "post-review": "post-review";
+        }>>;
+        command: z.ZodOptional<z.ZodString>;
+        script: z.ZodOptional<z.ZodString>;
+        runtime: z.ZodOptional<z.ZodEnum<{
+            js: "js";
+            ts: "ts";
+            python: "python";
+        }>>;
+        timeout_seconds: z.ZodOptional<z.ZodNumber>;
+        prompt: z.ZodOptional<z.ZodString>;
+        skill: z.ZodOptional<z.ZodString>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        model: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+        unrestricted_egress: z.ZodOptional<z.ZodBoolean>;
+        web_search: z.ZodOptional<z.ZodBoolean>;
+        requires_sandbox: z.ZodOptional<z.ZodEnum<{
+            gondolin: "gondolin";
+            docker: "docker";
+            none: "none";
+        }>>;
+        sandbox_image: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            qa: "qa";
+        }>>;
+        approval_gate: z.ZodOptional<z.ZodString>;
+        approval_artifact: z.ZodOptional<z.ZodString>;
+        approval_gate_message: z.ZodOptional<z.ZodString>;
+        messages: z.ZodOptional<z.ZodObject<{
+            on_start: z.ZodOptional<z.ZodString>;
+            on_success: z.ZodOptional<z.ZodString>;
+            on_failure: z.ZodOptional<z.ZodString>;
+            on_skipped_done: z.ZodOptional<z.ZodString>;
+            on_blocked: z.ZodOptional<z.ZodString>;
+            on_blocked_bypassed: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        loop: z.ZodOptional<z.ZodObject<{
+            max_cycles: z.ZodNumber;
+            on_request_changes: z.ZodObject<{
+                fix_prompt: z.ZodString;
+                fix_model: z.ZodOptional<z.ZodString>;
+                fix_variant: z.ZodOptional<z.ZodString>;
+                re_review_prompt: z.ZodString;
+            }, z.core.$strip>;
+            approval_gate: z.ZodOptional<z.ZodString>;
+            approval_artifact: z.ZodOptional<z.ZodString>;
+            messages: z.ZodOptional<z.ZodObject<{
+                on_cycle_start: z.ZodOptional<z.ZodString>;
+                on_approved: z.ZodOptional<z.ZodString>;
+                on_request_changes: z.ZodOptional<z.ZodString>;
+                on_max_cycles: z.ZodOptional<z.ZodString>;
+                on_fix_start: z.ZodOptional<z.ZodString>;
+                on_fix_failed: z.ZodOptional<z.ZodString>;
+                on_pause_for_approval: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        generic_loop: z.ZodOptional<z.ZodObject<{
+            max_iterations: z.ZodNumber;
+            until: z.ZodOptional<z.ZodString>;
+            until_bash: z.ZodOptional<z.ZodString>;
+            interactive: z.ZodDefault<z.ZodBoolean>;
+            gate_message: z.ZodOptional<z.ZodString>;
+            gate_kind: z.ZodOptional<z.ZodEnum<{
+                approve: "approve";
+                reply: "reply";
+            }>>;
+            scratch_key: z.ZodOptional<z.ZodString>;
+            fresh_context: z.ZodDefault<z.ZodBoolean>;
+            on_soft_failure: z.ZodOptional<z.ZodObject<{
+                retries: z.ZodDefault<z.ZodNumber>;
+                then: z.ZodDefault<z.ZodEnum<{
+                    fail: "fail";
+                    complete: "complete";
+                }>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        on_output: z.ZodOptional<z.ZodObject<{
+            contains_BLOCKED: z.ZodOptional<z.ZodObject<{
+                action: z.ZodEnum<{
+                    fail: "fail";
+                    continue: "continue";
+                    pause: "pause";
+                }>;
+                message: z.ZodOptional<z.ZodString>;
+                unless_label: z.ZodOptional<z.ZodString>;
+                unless_title_matches: z.ZodOptional<z.ZodString>;
+                bypass_message: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            contains_READY: z.ZodOptional<z.ZodObject<{
+                action: z.ZodEnum<{
+                    fail: "fail";
+                    continue: "continue";
+                    pause: "pause";
+                }>;
+                message: z.ZodOptional<z.ZodString>;
+                unless_label: z.ZodOptional<z.ZodString>;
+                unless_title_matches: z.ZodOptional<z.ZodString>;
+                bypass_message: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        on_success: z.ZodOptional<z.ZodObject<{
+            set_phase: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        depends_on: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        trigger_rule: z.ZodOptional<z.ZodEnum<{
+            all_success: "all_success";
+            one_success: "one_success";
+            none_failed_min_one_success: "none_failed_min_one_success";
+            all_done: "all_done";
+        }>>;
+        output_var: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AgentWorkflowDefinition = z.infer<typeof AgentWorkflowSchema>;
+export declare const CronWorkflowSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"cron">;
+    name: z.ZodString;
+    schedule: z.ZodString;
+    workflow: z.ZodString;
+    context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    condition: z.ZodOptional<z.ZodObject<{
+        unless: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CronWorkflowDefinition = z.infer<typeof CronWorkflowSchema>;
+export {};