fakeplane 0.0.0-stage → 0.1.0

package/dist/scenario.d.ts

@@ -0,0 +1,270 @@
+import { z } from "zod";
+import { BACKEND_NAMES, type Seed } from "./backends/index.js";
+import type { FaultSpec } from "./world.js";
+export declare const AgentSchema: z.ZodObject<{
+    command: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    module: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AgentSpec = z.infer<typeof AgentSchema>;
+declare const TurnObject: z.ZodObject<{
+    via: z.ZodOptional<z.ZodEnum<{
+        linear: "linear";
+        slack: "slack";
+        zendesk: "zendesk";
+        none: "none";
+    }>>;
+    text: z.ZodOptional<z.ZodString>;
+    ticket: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    subject: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodString>;
+    user: z.ZodOptional<z.ZodString>;
+    thread_ts: z.ZodOptional<z.ZodString>;
+    mention: z.ZodOptional<z.ZodBoolean>;
+    issue: z.ZodOptional<z.ZodString>;
+    team: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    event: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    deliver: z.ZodOptional<z.ZodNumber>;
+    concurrent: z.ZodOptional<z.ZodBoolean>;
+    delayMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type TurnSpec = z.infer<typeof TurnObject>;
+export declare const AssertionSchema: z.ZodObject<{
+    state: z.ZodOptional<z.ZodString>;
+    match: z.ZodOptional<z.ZodUnknown>;
+    exists: z.ZodOptional<z.ZodBoolean>;
+    no_pii: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+        effects: z.ZodOptional<z.ZodString>;
+        allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        seeded: z.ZodOptional<z.ZodBoolean>;
+        types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            email: "email";
+            phone: "phone";
+            value: "value";
+            card: "card";
+            ssn: "ssn";
+            iban: "iban";
+        }>>>;
+    }, z.core.$strict>]>>;
+    no_duplicate_effects: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+        effects: z.ZodOptional<z.ZodString>;
+        ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>]>>;
+    agent_output: z.ZodOptional<z.ZodUnknown>;
+    script: z.ZodOptional<z.ZodString>;
+    count: z.ZodOptional<z.ZodNumber>;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+    effects: z.ZodOptional<z.ZodString>;
+    calls: z.ZodOptional<z.ZodString>;
+    where: z.ZodOptional<z.ZodUnknown>;
+    ok: z.ZodOptional<z.ZodBoolean>;
+    turn: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type Assertion = z.infer<typeof AssertionSchema>;
+export declare const ScenarioSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    clock: z.ZodOptional<z.ZodString>;
+    backends: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        generic: "generic";
+        linear: "linear";
+        slack: "slack";
+        zendesk: "zendesk";
+    }>>>;
+    agent: z.ZodOptional<z.ZodObject<{
+        command: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        module: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    seed: z.ZodOptional<z.ZodObject<{
+        zendesk: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        slack: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        linear: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        generic: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>;
+    turns: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        via: z.ZodOptional<z.ZodEnum<{
+            linear: "linear";
+            slack: "slack";
+            zendesk: "zendesk";
+            none: "none";
+        }>>;
+        text: z.ZodOptional<z.ZodString>;
+        ticket: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        subject: z.ZodOptional<z.ZodString>;
+        from: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        channel: z.ZodOptional<z.ZodString>;
+        user: z.ZodOptional<z.ZodString>;
+        thread_ts: z.ZodOptional<z.ZodString>;
+        mention: z.ZodOptional<z.ZodBoolean>;
+        issue: z.ZodOptional<z.ZodString>;
+        team: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        event: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        deliver: z.ZodOptional<z.ZodNumber>;
+        concurrent: z.ZodOptional<z.ZodBoolean>;
+        delayMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>>>;
+    faults: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        op: z.ZodOptional<z.ZodString>;
+        backend: z.ZodOptional<z.ZodEnum<{
+            generic: "generic";
+            linear: "linear";
+            slack: "slack";
+            zendesk: "zendesk";
+        }>>;
+        where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        kind: z.ZodEnum<{
+            timeout: "timeout";
+            rate_limit: "rate_limit";
+            error: "error";
+            partial: "partial";
+            latency: "latency";
+            duplicate_delivery: "duplicate_delivery";
+        }>;
+        after: z.ZodOptional<z.ZodNumber>;
+        times: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"always">]>>;
+        status: z.ZodOptional<z.ZodNumber>;
+        delayMs: z.ZodOptional<z.ZodNumber>;
+        retryAfter: z.ZodOptional<z.ZodNumber>;
+        committed: z.ZodOptional<z.ZodBoolean>;
+        drop: z.ZodOptional<z.ZodBoolean>;
+        message: z.ZodOptional<z.ZodString>;
+        turn: z.ZodOptional<z.ZodNumber>;
+        copies: z.ZodOptional<z.ZodNumber>;
+        concurrent: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    assert: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        state: z.ZodOptional<z.ZodString>;
+        match: z.ZodOptional<z.ZodUnknown>;
+        exists: z.ZodOptional<z.ZodBoolean>;
+        no_pii: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+            effects: z.ZodOptional<z.ZodString>;
+            allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            seeded: z.ZodOptional<z.ZodBoolean>;
+            types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                email: "email";
+                phone: "phone";
+                value: "value";
+                card: "card";
+                ssn: "ssn";
+                iban: "iban";
+            }>>>;
+        }, z.core.$strict>]>>;
+        no_duplicate_effects: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+            effects: z.ZodOptional<z.ZodString>;
+            ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>]>>;
+        agent_output: z.ZodOptional<z.ZodUnknown>;
+        script: z.ZodOptional<z.ZodString>;
+        count: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        effects: z.ZodOptional<z.ZodString>;
+        calls: z.ZodOptional<z.ZodString>;
+        where: z.ZodOptional<z.ZodUnknown>;
+        ok: z.ZodOptional<z.ZodBoolean>;
+        turn: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    repeat: z.ZodOptional<z.ZodNumber>;
+    min_pass_rate: z.ZodOptional<z.ZodNumber>;
+    allow_agent_errors: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const ConfigSchema: z.ZodObject<{
+    agent: z.ZodOptional<z.ZodObject<{
+        command: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        module: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    assert: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        state: z.ZodOptional<z.ZodString>;
+        match: z.ZodOptional<z.ZodUnknown>;
+        exists: z.ZodOptional<z.ZodBoolean>;
+        no_pii: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+            effects: z.ZodOptional<z.ZodString>;
+            allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            seeded: z.ZodOptional<z.ZodBoolean>;
+            types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                email: "email";
+                phone: "phone";
+                value: "value";
+                card: "card";
+                ssn: "ssn";
+                iban: "iban";
+            }>>>;
+        }, z.core.$strict>]>>;
+        no_duplicate_effects: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<true>, z.ZodObject<{
+            effects: z.ZodOptional<z.ZodString>;
+            ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>]>>;
+        agent_output: z.ZodOptional<z.ZodUnknown>;
+        script: z.ZodOptional<z.ZodString>;
+        count: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        name: z.ZodOptional<z.ZodString>;
+        effects: z.ZodOptional<z.ZodString>;
+        calls: z.ZodOptional<z.ZodString>;
+        where: z.ZodOptional<z.ZodUnknown>;
+        ok: z.ZodOptional<z.ZodBoolean>;
+        turn: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    repeat: z.ZodOptional<z.ZodNumber>;
+    scenarios: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strict>;
+export type FakeplaneConfig = z.infer<typeof ConfigSchema> & {
+    dir: string;
+};
+export interface Scenario {
+    name: string;
+    description?: string;
+    tags: string[];
+    clock?: string;
+    backends?: (typeof BACKEND_NAMES)[number][];
+    agent?: AgentSpec;
+    seed: Seed;
+    turns: (TurnSpec & {
+        via: NonNullable<TurnSpec["via"]>;
+    })[];
+    faults: FaultSpec[];
+    assert: Assertion[];
+    repeat: number;
+    minPassRate: number;
+    allowAgentErrors: boolean;
+}
+export interface LoadedScenario {
+    file: string;
+    dir: string;
+    index: number;
+    scenario: Scenario;
+}
+export declare class ScenarioError extends Error {
+    readonly file: string;
+    constructor(file: string, message: string);
+}
+export declare function normalizeScenario(raw: unknown, file: string, index?: number): Scenario;
+export declare function parseDocuments(text: string, file: string): unknown[];
+export declare function loadScenarioFile(file: string): LoadedScenario[];
+export declare function loadScenarios(paths: string[]): LoadedScenario[];
+export declare function loadConfig(explicit?: string, cwd?: string): FakeplaneConfig | undefined;
+export {};

package/dist/scenario.js

@@ -0,0 +1,270 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { basename, dirname, extname, join, resolve } from "node:path";
+import { parseAllDocuments } from "yaml";
+import { z } from "zod";
+import { BACKEND_NAMES } from "./backends/index.js";
+const id = z.union([z.string(), z.number()]);
+const anyObject = z.record(z.string(), z.unknown());
+export const AgentSchema = z
+    .object({
+    command: z.string().optional(),
+    url: z.string().optional(),
+    module: z.string().optional(),
+    timeoutMs: z.number().int().positive().optional(),
+    env: z.record(z.string(), z.string()).optional(),
+    cwd: z.string().optional(),
+})
+    .strict();
+const TurnObject = z
+    .object({
+    via: z.enum(["zendesk", "slack", "linear", "none"]).optional(),
+    text: z.string().optional(),
+    // zendesk
+    ticket: id.optional(),
+    subject: z.string().optional(),
+    from: z.union([z.string(), anyObject]).optional(),
+    tags: z.array(z.string()).optional(),
+    // slack
+    channel: z.string().optional(),
+    user: z.string().optional(),
+    thread_ts: z.string().optional(),
+    mention: z.boolean().optional(),
+    // linear
+    issue: z.string().optional(),
+    team: z.string().optional(),
+    title: z.string().optional(),
+    /** Send this event payload verbatim instead of deriving one from the backend. */
+    event: anyObject.optional(),
+    /** Deliver the same event this many times (duplicate webhooks). */
+    deliver: z.number().int().min(1).max(20).optional(),
+    /** Deliver duplicates at the same time instead of one after another. */
+    concurrent: z.boolean().optional(),
+    delayMs: z.number().int().min(0).optional(),
+})
+    .strict();
+const FaultObject = z
+    .object({
+    op: z.string().optional(),
+    backend: z.enum(BACKEND_NAMES).optional(),
+    where: anyObject.optional(),
+    kind: z.enum(["timeout", "rate_limit", "error", "partial", "latency", "duplicate_delivery"]),
+    after: z.number().int().min(0).optional(),
+    times: z.union([z.number().int().min(1), z.literal("always")]).optional(),
+    status: z.number().int().min(100).max(599).optional(),
+    delayMs: z.number().int().min(0).optional(),
+    retryAfter: z.number().min(0).optional(),
+    committed: z.boolean().optional(),
+    drop: z.boolean().optional(),
+    message: z.string().optional(),
+    // duplicate_delivery
+    turn: z.number().int().min(1).optional(),
+    copies: z.number().int().min(2).max(20).optional(),
+    concurrent: z.boolean().optional(),
+})
+    .strict()
+    .superRefine((f, ctx) => {
+    if (f.kind === "duplicate_delivery" && f.turn === undefined)
+        ctx.addIssue({ code: "custom", message: "duplicate_delivery needs `turn`" });
+    if (f.kind !== "duplicate_delivery" && !f.op && !f.backend)
+        ctx.addIssue({ code: "custom", message: "fault needs `op` or `backend`" });
+});
+const matcher = z.unknown();
+const countFields = {
+    count: z.number().int().min(0).optional(),
+    min: z.number().int().min(0).optional(),
+    max: z.number().int().min(0).optional(),
+};
+export const AssertionSchema = z
+    .object({
+    name: z.string().optional(),
+    effects: z.string().optional(),
+    calls: z.string().optional(),
+    where: matcher.optional(),
+    ok: z.boolean().optional(),
+    turn: z.number().int().min(1).optional(),
+    ...countFields,
+    state: z.string().optional(),
+    match: matcher.optional(),
+    exists: z.boolean().optional(),
+    no_pii: z
+        .union([
+        z.literal(true),
+        z
+            .object({
+            effects: z.string().optional(),
+            allow: z.array(z.string()).optional(),
+            values: z.array(z.string()).optional(),
+            seeded: z.boolean().optional(),
+            types: z.array(z.enum(["email", "phone", "card", "ssn", "iban", "value"])).optional(),
+        })
+            .strict(),
+    ])
+        .optional(),
+    no_duplicate_effects: z.union([z.literal(true), z.object({ effects: z.string().optional(), ignore: z.array(z.string()).optional() }).strict()]).optional(),
+    agent_output: matcher.optional(),
+    script: z.string().optional(),
+})
+    .strict()
+    .superRefine((a, ctx) => {
+    const kinds = ["effects", "calls", "state", "no_pii", "no_duplicate_effects", "agent_output", "script"].filter((k) => a[k] !== undefined);
+    if (kinds.length !== 1) {
+        ctx.addIssue({ code: "custom", message: `each assertion needs exactly one of effects, calls, state, no_pii, no_duplicate_effects, agent_output, script (got ${kinds.join(", ") || "none"})` });
+    }
+    if (a.count !== undefined && (a.min !== undefined || a.max !== undefined))
+        ctx.addIssue({ code: "custom", message: "use `count` or `min`/`max`, not both" });
+});
+export const ScenarioSchema = z
+    .object({
+    name: z.string().optional(),
+    description: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    clock: z.string().optional(),
+    backends: z.array(z.enum(BACKEND_NAMES)).optional(),
+    agent: AgentSchema.optional(),
+    seed: z
+        .object({ zendesk: anyObject.optional(), slack: anyObject.optional(), linear: anyObject.optional(), generic: anyObject.optional() })
+        .strict()
+        .optional(),
+    turns: z.array(z.union([z.string(), TurnObject])).optional(),
+    faults: z.array(FaultObject).optional(),
+    assert: z.array(AssertionSchema).optional(),
+    repeat: z.number().int().min(1).max(100).optional(),
+    min_pass_rate: z.number().min(0).max(1).optional(),
+    allow_agent_errors: z.boolean().optional(),
+})
+    .strict();
+export const ConfigSchema = z
+    .object({
+    agent: AgentSchema.optional(),
+    assert: z.array(AssertionSchema).optional(),
+    repeat: z.number().int().min(1).max(100).optional(),
+    scenarios: z.union([z.string(), z.array(z.string())]).optional(),
+})
+    .strict();
+export class ScenarioError extends Error {
+    file;
+    constructor(file, message) {
+        super(`${file}: ${message}`);
+        this.file = file;
+    }
+}
+function formatZodError(err) {
+    return err.issues.map((i) => `  - ${i.path.length ? i.path.join(".") : "(root)"}: ${i.message}`).join("\n");
+}
+function inferVia(turn, seed) {
+    if (turn.via)
+        return turn.via;
+    if (turn.event)
+        return "none";
+    if (turn.ticket !== undefined || turn.subject !== undefined || turn.from !== undefined)
+        return "zendesk";
+    if (turn.channel !== undefined || turn.thread_ts !== undefined)
+        return "slack";
+    if (turn.issue !== undefined || turn.team !== undefined)
+        return "linear";
+    const seeded = ["zendesk", "slack", "linear"].filter((b) => seed[b] !== undefined);
+    return seeded.length === 1 ? seeded[0] : "none";
+}
+export function normalizeScenario(raw, file, index = 0) {
+    const parsed = ScenarioSchema.safeParse(raw ?? {});
+    if (!parsed.success)
+        throw new ScenarioError(file, `invalid scenario\n${formatZodError(parsed.error)}`);
+    const s = parsed.data;
+    const seed = (s.seed ?? {});
+    const turns = (s.turns ?? []).map((t) => (typeof t === "string" ? { text: t } : { ...t }));
+    const faults = [];
+    for (const f of s.faults ?? []) {
+        if (f.kind === "duplicate_delivery") {
+            const turn = turns[f.turn - 1];
+            if (!turn)
+                throw new ScenarioError(file, `duplicate_delivery refers to turn ${f.turn}, but there are ${turns.length} turns`);
+            turn.deliver = f.copies ?? 2;
+            if (f.concurrent !== undefined)
+                turn.concurrent = f.concurrent;
+            continue;
+        }
+        const { turn: _t, copies: _c, concurrent: _cc, ...rest } = f;
+        faults.push(rest);
+    }
+    const stem = basename(file, extname(file));
+    return {
+        name: s.name ?? (index > 0 ? `${stem} #${index + 1}` : stem),
+        description: s.description,
+        tags: s.tags ?? [],
+        clock: s.clock,
+        backends: s.backends,
+        agent: s.agent,
+        seed,
+        turns: turns.map((t) => ({ ...t, via: inferVia(t, seed) })),
+        faults,
+        assert: s.assert ?? [],
+        repeat: s.repeat ?? 1,
+        minPassRate: s.min_pass_rate ?? 1,
+        allowAgentErrors: s.allow_agent_errors ?? false,
+    };
+}
+const SCENARIO_EXT = new Set([".yaml", ".yml", ".json"]);
+const CONFIG_NAMES = ["fakeplane.config.yaml", "fakeplane.config.yml", "fakeplane.config.json"];
+function collectFiles(path, out) {
+    const st = statSync(path);
+    if (st.isDirectory()) {
+        for (const entry of readdirSync(path).sort()) {
+            if (entry.startsWith(".") || entry.startsWith("_") || entry === "node_modules")
+                continue;
+            const full = join(path, entry);
+            if (statSync(full).isDirectory())
+                collectFiles(full, out);
+            else if (SCENARIO_EXT.has(extname(entry)) && !CONFIG_NAMES.includes(entry))
+                out.push(full);
+        }
+    }
+    else {
+        out.push(path);
+    }
+}
+export function parseDocuments(text, file) {
+    if (file.endsWith(".json")) {
+        try {
+            return [JSON.parse(text)];
+        }
+        catch (err) {
+            throw new ScenarioError(file, `invalid JSON: ${err.message}`);
+        }
+    }
+    const docs = parseAllDocuments(text);
+    const list = Array.isArray(docs) ? docs : [docs];
+    return list
+        .map((doc) => {
+        if (doc.errors.length)
+            throw new ScenarioError(file, `invalid YAML: ${doc.errors[0].message}`);
+        return doc.toJS();
+    })
+        .filter((d) => d !== null && d !== undefined);
+}
+export function loadScenarioFile(file) {
+    const abs = resolve(file);
+    const docs = parseDocuments(readFileSync(abs, "utf8"), abs);
+    return docs.map((doc, index) => ({ file: abs, dir: dirname(abs), index, scenario: normalizeScenario(doc, abs, index) }));
+}
+export function loadScenarios(paths) {
+    const files = [];
+    for (const p of paths) {
+        if (!existsSync(p))
+            throw new ScenarioError(p, "no such file or directory");
+        collectFiles(resolve(p), files);
+    }
+    return files.flatMap((f) => loadScenarioFile(f));
+}
+export function loadConfig(explicit, cwd = process.cwd()) {
+    const file = explicit ? resolve(explicit) : CONFIG_NAMES.map((n) => join(cwd, n)).find((f) => existsSync(f));
+    if (!file)
+        return undefined;
+    if (!existsSync(file))
+        throw new ScenarioError(file, "config file not found");
+    const [doc] = parseDocuments(readFileSync(file, "utf8"), file);
+    const parsed = ConfigSchema.safeParse(doc ?? {});
+    if (!parsed.success)
+        throw new ScenarioError(file, `invalid config\n${formatZodError(parsed.error)}`);
+    return { ...parsed.data, dir: dirname(file) };
+}
+//# sourceMappingURL=scenario.js.map

package/dist/scenario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.js","sourceRoot":"","sources":["../src/scenario.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,40 @@
+import { McpHandler } from "./mcp.js";
+import type { World } from "./world.js";
+export interface ControlHooks {
+    /** Rebuild the world from its seed. */
+    reset?: () => World;
+    /** Evaluate assertions against the current world (used by `fakeplane report --assert`). */
+    assert?: (world: World, assertions: unknown[]) => unknown | Promise<unknown>;
+    /** Apply a user turn to the world and return the event the agent would receive. */
+    injectTurn?: (world: World, turn: Record<string, unknown>) => unknown;
+}
+export interface FakeServerOptions {
+    host?: string;
+    port?: number;
+    hooks?: ControlHooks;
+}
+export interface ServerUrls {
+    base: string;
+    mcp: string;
+    zendesk: string;
+    slack: string;
+    linear: string;
+    generic: string;
+}
+export declare class FakeServer {
+    world: World;
+    readonly mcp: McpHandler;
+    private server?;
+    private readonly hooks;
+    private readonly options;
+    constructor(world: World, options?: FakeServerOptions);
+    start(): Promise<ServerUrls>;
+    urls(): ServerUrls;
+    stop(): Promise<void>;
+    private handle;
+    private tryBackend;
+    private send;
+    private handleMcp;
+    private control;
+}
+export declare function matchPath(pattern: string, path: string): Record<string, string> | null;