@qawolf/api-contracts 0.52.0 → 0.53.0

package/dist/v1/trigger/configuration.js

@@ -0,0 +1,125 @@
+import { z } from "zod";
+// The domain refines the same field with luxon. This package publishes to npm
+// and takes no such dependency, so it asks the runtime instead. A caller then
+// gets a field level error rather than a generic failure deeper in.
+//
+// `Intl.supportedValuesOf("timeZone")` lists canonical zones only, so it
+// refuses `UTC`, `GMT` and aliases such as `US/Pacific` that luxon accepts.
+// Making a formatter accepts every zone luxon does, and throws for the rest.
+const isTimezone = (value) => {
+    try {
+        Intl.DateTimeFormat("en-US", { timeZone: value });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * A trigger is "run this, when that". `action` carries the this, and the
+ * match fields carry the that.
+ *
+ * The domain stores both in a versioned `when`/`actions` envelope holding
+ * arrays of objects. The public shape carries one match and one action as
+ * scalars instead, because the QA Wolf CLI derives one flag per leaf field
+ * and cannot express an array of objects. Nesting is fine: `action.flowIds`
+ * becomes `--action-flow-ids`.
+ *
+ * The same fields appear in inputs and in the trigger resource, so a caller
+ * can read a trigger, change one field, and write it back.
+ */
+export const triggerCadenceSchema = z
+    .enum(["hourly", "daily"])
+    .describe("How often the schedule fires.");
+export const triggerActionKindSchema = z
+    .enum(["createSuite", "generativeSuite"])
+    .describe("createSuite runs the flows named by flowIds and tagNames. generativeSuite lets QA Wolf choose the flows from the deployment's changes, and is not available to a schedule.");
+/**
+ * What the trigger runs when it fires.
+ *
+ * One schema, shared verbatim by both trigger kinds. A schedule cannot use
+ * `generativeSuite`, but that is a rule rather than a separate shape: the CLI
+ * refuses a field whose object schema differs between union branches, so the
+ * two kinds must offer the same action.
+ */
+export const makeTriggerActionSchema = (ids) => z
+    .object({
+    flowIds: z
+        .array(ids.flow)
+        .default([])
+        .describe("Flows to run. Combined with tagNames."),
+    instructions: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Guidance for QA Wolf. Applies to generativeSuite only."),
+    investigateFailures: z
+        .boolean()
+        .optional()
+        .describe("Whether QA Wolf investigates failures in the resulting runs. Defaults to true."),
+    kind: triggerActionKindSchema.default("createSuite"),
+    tagNames: z
+        .array(z.string().min(1))
+        .default([])
+        .describe("Tags naming the flows to run. Combined with flowIds."),
+})
+    .describe("What the trigger runs when it fires.");
+/**
+ * Fields that say when a schedule trigger fires.
+ *
+ * `environmentId` takes whichever schema the caller types it with. A write
+ * input passes the reference schema, which also accepts an alias. The trigger
+ * resource passes the environment id schema, because a read reports the
+ * environment the reference resolved to.
+ */
+export const makeTriggerScheduleFields = (ids) => ({
+    action: makeTriggerActionSchema(ids),
+    cadence: triggerCadenceSchema,
+    environmentId: ids.environmentId.describe("The environment the scheduled runs happen in."),
+    minuteOfHour: z
+        .number()
+        .int()
+        .min(0)
+        .max(59)
+        .optional()
+        .describe("Minutes past the hour an hourly schedule fires. Defaults to 0."),
+    timeOfDay: z
+        .string()
+        .regex(/^([01]\d|2[0-3]):[0-5]\d$/)
+        .optional()
+        .describe('The wall clock time a daily schedule fires, as "HH:mm". Required when cadence is daily.'),
+    timezoneId: z
+        .string()
+        .min(1)
+        .refine(isTimezone, "Expected an IANA timezone, such as America/New_York.")
+        .optional()
+        .describe("The IANA timezone that timeOfDay is read in, such as America/New_York. Required when cadence is daily."),
+});
+/**
+ * Fields that say which deployments a deployment trigger fires for. Every
+ * pattern supplied must match, and supplying none fires on every deployment
+ * the team reports.
+ */
+export const makeTriggerDeploymentFields = (ids) => ({
+    action: makeTriggerActionSchema(ids),
+    branchPattern: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Only fire for deployments of a branch matching this pattern."),
+    deployTargetPattern: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Only fire for deployments of an app matching this pattern. A deploy target names one app within an environment."),
+    environmentIds: z
+        .array(ids.environment)
+        .default([])
+        .describe("Only fire for deployments to these environments. Mutually exclusive with environmentPattern."),
+    environmentPattern: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Only fire for deployments to environments matching this pattern. Mutually exclusive with environmentIds."),
+});
+//# sourceMappingURL=configuration.js.map

package/dist/v1/trigger/configuration.js.map

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

package/dist/v1/trigger/configurationRules.d.ts

@@ -0,0 +1,35 @@
+import type { z } from "zod";
+/**
+ * Cross field rules for a trigger configuration.
+ *
+ * These are the rules the domain enforces once the flat shape is assembled
+ * into a `when`/`actions` envelope. They are checked here so a caller gets a
+ * field-level validation error instead of a generic domain failure.
+ */
+type Action = {
+    flowIds: string[];
+    instructions?: string | undefined;
+    kind: "createSuite" | "generativeSuite";
+    tagNames: string[];
+};
+type ScheduleShape = {
+    action: Action;
+    cadence: "daily" | "hourly";
+    kind: "schedule";
+    minuteOfHour?: number | undefined;
+    timeOfDay?: string | undefined;
+    timezoneId?: string | undefined;
+};
+type DeploymentShape = {
+    action: Action;
+    environmentIds: string[];
+    environmentPattern?: string | undefined;
+    kind: "deployment";
+};
+/**
+ * Applies the rules for whichever kind the value carries. Written against a
+ * structural type so the create and the update input can share it.
+ */
+export declare const checkTriggerConfiguration: (value: DeploymentShape | ScheduleShape, ctx: z.RefinementCtx) => void;
+export {};
+//# sourceMappingURL=configurationRules.d.ts.map

package/dist/v1/trigger/configurationRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurationRules.d.ts","sourceRoot":"","sources":["../../../src/v1/trigger/configurationRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;;GAMG;AAEH,KAAK,MAAM,GAAG;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,IAAI,EAAE,aAAa,GAAG,iBAAiB,CAAC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,YAAY,CAAC;CACpB,CAAC;AA2FF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,eAAe,GAAG,aAAa,EACtC,KAAK,CAAC,CAAC,aAAa,KACnB,IAG8B,CAAC"}

package/dist/v1/trigger/configurationRules.js

@@ -0,0 +1,92 @@
+const checkAction = (action, ctx) => {
+    const namesFlows = action.flowIds.length + action.tagNames.length > 0;
+    if (action.kind === "generativeSuite") {
+        // QA Wolf picks the flows from the deployment, so naming them is a
+        // contradiction rather than a harmless extra.
+        if (namesFlows) {
+            ctx.addIssue({
+                code: "custom",
+                message: "flowIds and tagNames do not apply when the action is generativeSuite.",
+                path: ["action", "flowIds"],
+            });
+        }
+        return;
+    }
+    if (action.instructions !== undefined) {
+        ctx.addIssue({
+            code: "custom",
+            message: "instructions apply to a generativeSuite action only.",
+            path: ["action", "instructions"],
+        });
+    }
+    if (!namesFlows) {
+        ctx.addIssue({
+            code: "custom",
+            message: "At least one flow or tag is required.",
+            path: ["action", "flowIds"],
+        });
+    }
+};
+const checkSchedule = (value, ctx) => {
+    if (value.cadence === "daily") {
+        // The domain reads timeOfDay in timezoneId, so a daily cadence is
+        // ambiguous without both.
+        for (const field of ["timeOfDay", "timezoneId"]) {
+            if (value[field] === undefined) {
+                ctx.addIssue({
+                    code: "custom",
+                    message: `${field} is required when cadence is daily.`,
+                    path: [field],
+                });
+            }
+        }
+        if (value.minuteOfHour !== undefined) {
+            ctx.addIssue({
+                code: "custom",
+                message: "minuteOfHour applies to an hourly cadence only.",
+                path: ["minuteOfHour"],
+            });
+        }
+    }
+    else {
+        for (const field of ["timeOfDay", "timezoneId"]) {
+            if (value[field] !== undefined) {
+                ctx.addIssue({
+                    code: "custom",
+                    message: `${field} applies to a daily cadence only.`,
+                    path: [field],
+                });
+            }
+        }
+    }
+    // A schedule fire runs createSuite actions only: the generative action
+    // builds its run set from a deployment's changes, and a schedule has none.
+    if (value.action.kind === "generativeSuite") {
+        ctx.addIssue({
+            code: "custom",
+            message: "A schedule trigger cannot use a generativeSuite action.",
+            path: ["action", "kind"],
+        });
+        return;
+    }
+    checkAction(value.action, ctx);
+};
+const checkDeployment = (value, ctx) => {
+    if (value.environmentPattern !== undefined &&
+        value.environmentIds.length > 0) {
+        ctx.addIssue({
+            code: "custom",
+            message: "Supply environmentIds or environmentPattern, not both.",
+            path: ["environmentPattern"],
+        });
+    }
+    checkAction(value.action, ctx);
+};
+/**
+ * Applies the rules for whichever kind the value carries. Written against a
+ * structural type so the create and the update input can share it.
+ */
+export const checkTriggerConfiguration = (value, ctx) => value.kind === "schedule"
+    ? checkSchedule(value, ctx)
+    : checkDeployment(value, ctx);
+//# sourceMappingURL=configurationRules.js.map

package/dist/v1/trigger/configurationRules.js.map

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

package/dist/v1/trigger/create.d.ts

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeCreateTriggerContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, TriggerId extends PublicIdSchema, WorkspaceId extends PublicIdSchema>(ids: {
+    environment: EnvironmentId;
+    /** Accepts an id or an alias; the resource reports the id it resolved to. */
+    environmentRef: PublicIdSchema;
+    flow: FlowId;
+    trigger: TriggerId;
+    workspace: WorkspaceId;
+}) => {
+    readonly annotations: {
+        readonly destructiveHint: true;
+        readonly openWorldHint: true;
+        readonly readOnlyHint: false;
+    };
+    readonly description: string;
+    readonly input: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"schedule">;
+        action: z.ZodObject<{
+            flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+            instructions: z.ZodOptional<z.ZodString>;
+            investigateFailures: z.ZodOptional<z.ZodBoolean>;
+            kind: z.ZodDefault<z.ZodEnum<{
+                createSuite: "createSuite";
+                generativeSuite: "generativeSuite";
+            }>>;
+            tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        cadence: z.ZodEnum<{
+            hourly: "hourly";
+            daily: "daily";
+        }>;
+        environmentId: PublicIdSchema;
+        minuteOfHour: z.ZodOptional<z.ZodNumber>;
+        timeOfDay: z.ZodOptional<z.ZodString>;
+        timezoneId: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        workspaceId: z.ZodOptional<WorkspaceId>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"deployment">;
+        action: z.ZodObject<{
+            flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+            instructions: z.ZodOptional<z.ZodString>;
+            investigateFailures: z.ZodOptional<z.ZodBoolean>;
+            kind: z.ZodDefault<z.ZodEnum<{
+                createSuite: "createSuite";
+                generativeSuite: "generativeSuite";
+            }>>;
+            tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        branchPattern: z.ZodOptional<z.ZodString>;
+        deployTargetPattern: z.ZodOptional<z.ZodString>;
+        environmentIds: z.ZodDefault<z.ZodArray<EnvironmentId>>;
+        environmentPattern: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        workspaceId: z.ZodOptional<WorkspaceId>;
+    }, z.core.$strip>], "kind">;
+    readonly kind: "write";
+    readonly name: "trigger.create";
+    readonly output: z.ZodObject<{
+        trigger: z.ZodObject<{
+            configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"schedule">;
+                action: z.ZodObject<{
+                    flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+                    instructions: z.ZodOptional<z.ZodString>;
+                    investigateFailures: z.ZodOptional<z.ZodBoolean>;
+                    kind: z.ZodDefault<z.ZodEnum<{
+                        createSuite: "createSuite";
+                        generativeSuite: "generativeSuite";
+                    }>>;
+                    tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>;
+                cadence: z.ZodEnum<{
+                    hourly: "hourly";
+                    daily: "daily";
+                }>;
+                environmentId: EnvironmentId;
+                minuteOfHour: z.ZodOptional<z.ZodNumber>;
+                timeOfDay: z.ZodOptional<z.ZodString>;
+                timezoneId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"deployment">;
+                action: z.ZodObject<{
+                    flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+                    instructions: z.ZodOptional<z.ZodString>;
+                    investigateFailures: z.ZodOptional<z.ZodBoolean>;
+                    kind: z.ZodDefault<z.ZodEnum<{
+                        createSuite: "createSuite";
+                        generativeSuite: "generativeSuite";
+                    }>>;
+                    tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>;
+                branchPattern: z.ZodOptional<z.ZodString>;
+                deployTargetPattern: z.ZodOptional<z.ZodString>;
+                environmentIds: z.ZodDefault<z.ZodArray<EnvironmentId>>;
+                environmentPattern: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                actionCount: z.ZodNumber;
+                kind: z.ZodLiteral<"advanced">;
+                whenCount: z.ZodNumber;
+            }, z.core.$strip>], "kind">;
+            createdAt: z.ZodISODateTime;
+            id: TriggerId;
+            isPaused: z.ZodBoolean;
+            name: z.ZodString;
+            nextScheduledAt: z.ZodOptional<z.ZodISODateTime>;
+            pausedAt: z.ZodOptional<z.ZodISODateTime>;
+            updatedAt: z.ZodISODateTime;
+            url: z.ZodURL;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=create.d.ts.map

package/dist/v1/trigger/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/v1/trigger/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAShD,eAAO,MAAM,yBAAyB,GACpC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,SAAS,SAAS,cAAc,EAChC,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,6EAA6E;IAC7E,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CA,CAAC"}

package/dist/v1/trigger/create.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { makeTriggerDeploymentFields, makeTriggerScheduleFields, } from "./configuration.js";
+import { checkTriggerConfiguration } from "./configurationRules.js";
+import { makeTriggerResourceSchema } from "./resource.js";
+export const makeCreateTriggerContract = (ids) => {
+    const commonFields = {
+        name: z.string().trim().min(1).max(255),
+        workspaceId: ids.workspace
+            .optional()
+            .describe("The workspace to create the trigger in. Required when authenticating with an organization or user API key."),
+    };
+    const input = z
+        .discriminatedUnion("kind", [
+        z.object({
+            ...commonFields,
+            ...makeTriggerScheduleFields({
+                environmentId: ids.environmentRef,
+                flow: ids.flow,
+            }),
+            kind: z.literal("schedule"),
+        }),
+        z.object({
+            ...commonFields,
+            ...makeTriggerDeploymentFields(ids),
+            kind: z.literal("deployment"),
+        }),
+    ])
+        .superRefine(checkTriggerConfiguration);
+    const output = z.object({ trigger: makeTriggerResourceSchema(ids) });
+    return {
+        annotations: {
+            destructiveHint: true,
+            openWorldHint: true,
+            readOnlyHint: false,
+        },
+        description: "Create a trigger. A schedule trigger runs a named set of flows on a cadence; " +
+            "a deployment trigger runs when a matching deployment is reported.",
+        input,
+        kind: "write",
+        name: "trigger.create",
+        output,
+    };
+};
+//# sourceMappingURL=create.js.map

package/dist/v1/trigger/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/v1/trigger/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAKvC,GAOD,EAAE,EAAE;IACH,MAAM,YAAY,GAAG;QACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACvC,WAAW,EAAE,GAAG,CAAC,SAAS;aACvB,QAAQ,EAAE;aACV,QAAQ,CACP,4GAA4G,CAC7G;KACJ,CAAC;IACF,MAAM,KAAK,GAAG,CAAC;SACZ,kBAAkB,CAAC,MAAM,EAAE;QAC1B,CAAC,CAAC,MAAM,CAAC;YACP,GAAG,YAAY;YACf,GAAG,yBAAyB,CAAC;gBAC3B,aAAa,EAAE,GAAG,CAAC,cAAc;gBACjC,IAAI,EAAE,GAAG,CAAC,IAAI;aACf,CAAC;YACF,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;SAC5B,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,GAAG,YAAY;YACf,GAAG,2BAA2B,CAAC,GAAG,CAAC;YACnC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;SAC9B,CAAC;KACH,CAAC;SACD,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,yBAAyB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAErE,OAAO;QACL,WAAW,EAAE;YACX,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,IAAI;YACnB,YAAY,EAAE,KAAK;SACpB;QACD,WAAW,EACT,+EAA+E;YAC/E,mEAAmE;QACrE,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,gBAAgB;QACtB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/dist/v1/trigger/find.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeFindTriggersContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, TriggerId extends PublicIdSchema, WorkspaceId extends PublicIdSchema>(ids: {
+    environment: EnvironmentId;
+    flow: FlowId;
+    trigger: TriggerId;
+    workspace: WorkspaceId;
+}) => {
+    readonly annotations: {
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+        readonly readOnlyHint: true;
+    };
+    readonly description: "List the team's triggers, newest first.";
+    readonly input: z.ZodObject<{
+        isPaused: z.ZodOptional<z.ZodBoolean>;
+        workspaceId: z.ZodOptional<WorkspaceId>;
+    }, z.core.$strip>;
+    readonly kind: "read";
+    readonly name: "trigger.find";
+    readonly output: z.ZodObject<{
+        triggers: z.ZodArray<z.ZodObject<{
+            configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"schedule">;
+                action: z.ZodObject<{
+                    flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+                    instructions: z.ZodOptional<z.ZodString>;
+                    investigateFailures: z.ZodOptional<z.ZodBoolean>;
+                    kind: z.ZodDefault<z.ZodEnum<{
+                        createSuite: "createSuite";
+                        generativeSuite: "generativeSuite";
+                    }>>;
+                    tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>;
+                cadence: z.ZodEnum<{
+                    hourly: "hourly";
+                    daily: "daily";
+                }>;
+                environmentId: EnvironmentId;
+                minuteOfHour: z.ZodOptional<z.ZodNumber>;
+                timeOfDay: z.ZodOptional<z.ZodString>;
+                timezoneId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"deployment">;
+                action: z.ZodObject<{
+                    flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+                    instructions: z.ZodOptional<z.ZodString>;
+                    investigateFailures: z.ZodOptional<z.ZodBoolean>;
+                    kind: z.ZodDefault<z.ZodEnum<{
+                        createSuite: "createSuite";
+                        generativeSuite: "generativeSuite";
+                    }>>;
+                    tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>;
+                branchPattern: z.ZodOptional<z.ZodString>;
+                deployTargetPattern: z.ZodOptional<z.ZodString>;
+                environmentIds: z.ZodDefault<z.ZodArray<EnvironmentId>>;
+                environmentPattern: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                actionCount: z.ZodNumber;
+                kind: z.ZodLiteral<"advanced">;
+                whenCount: z.ZodNumber;
+            }, z.core.$strip>], "kind">;
+            createdAt: z.ZodISODateTime;
+            id: TriggerId;
+            isPaused: z.ZodBoolean;
+            name: z.ZodString;
+            nextScheduledAt: z.ZodOptional<z.ZodISODateTime>;
+            pausedAt: z.ZodOptional<z.ZodISODateTime>;
+            updatedAt: z.ZodISODateTime;
+            url: z.ZodURL;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=find.d.ts.map

package/dist/v1/trigger/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/v1/trigger/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,eAAO,MAAM,wBAAwB,GACnC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,SAAS,SAAS,cAAc,EAChC,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCA,CAAC"}

package/dist/v1/trigger/find.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { makeTriggerResourceSchema } from "./resource.js";
+export const makeFindTriggersContract = (ids) => {
+    const input = z.object({
+        isPaused: z
+            .boolean()
+            .optional()
+            .describe("Only list paused, or only unpaused, triggers. Omit for both."),
+        workspaceId: ids.workspace
+            .optional()
+            .describe("The workspace to list triggers from. Required when authenticating with an organization or user API key."),
+    });
+    const output = z.object({
+        // Every trigger the caller can see, with no page. A team holds few
+        // triggers, so a page would never fill. Adding one later must keep the
+        // limit opt in: a defaulted limit would silently truncate this response
+        // for callers written against it.
+        triggers: z
+            .array(makeTriggerResourceSchema(ids))
+            .describe("The team's triggers, newest first."),
+    });
+    return {
+        annotations: {
+            destructiveHint: false,
+            openWorldHint: false,
+            readOnlyHint: true,
+        },
+        description: "List the team's triggers, newest first.",
+        input,
+        kind: "read",
+        name: "trigger.find",
+        output,
+    };
+};
+//# sourceMappingURL=find.js.map

package/dist/v1/trigger/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../src/v1/trigger/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAKtC,GAKD,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,QAAQ,EAAE,CAAC;aACR,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,8DAA8D,CAAC;QAC3E,WAAW,EAAE,GAAG,CAAC,SAAS;aACvB,QAAQ,EAAE;aACV,QAAQ,CACP,yGAAyG,CAC1G;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,mEAAmE;QACnE,uEAAuE;QACvE,wEAAwE;QACxE,kCAAkC;QAClC,QAAQ,EAAE,CAAC;aACR,KAAK,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC;aACrC,QAAQ,CAAC,oCAAoC,CAAC;KAClD,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE;YACX,eAAe,EAAE,KAAK;YACtB,aAAa,EAAE,KAAK;YACpB,YAAY,EAAE,IAAI;SACnB;QACD,WAAW,EAAE,yCAAyC;QACtD,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,cAAc;QACpB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/dist/v1/trigger/get.d.ts

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeGetTriggerContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, TriggerId extends PublicIdSchema>(ids: {
+    environment: EnvironmentId;
+    flow: FlowId;
+    trigger: TriggerId;
+}) => {
+    readonly annotations: {
+        readonly destructiveHint: false;
+        readonly openWorldHint: false;
+        readonly readOnlyHint: true;
+    };
+    readonly description: "Get one trigger by id.";
+    readonly input: z.ZodObject<{
+        triggerId: TriggerId;
+    }, z.core.$strip>;
+    readonly kind: "read";
+    readonly name: "trigger.get";
+    readonly output: z.ZodObject<{
+        trigger: z.ZodObject<{
+            configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"schedule">;
+                action: z.ZodObject<{
+                    flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+                    instructions: z.ZodOptional<z.ZodString>;
+                    investigateFailures: z.ZodOptional<z.ZodBoolean>;
+                    kind: z.ZodDefault<z.ZodEnum<{
+                        createSuite: "createSuite";
+                        generativeSuite: "generativeSuite";
+                    }>>;
+                    tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>;
+                cadence: z.ZodEnum<{
+                    hourly: "hourly";
+                    daily: "daily";
+                }>;
+                environmentId: EnvironmentId;
+                minuteOfHour: z.ZodOptional<z.ZodNumber>;
+                timeOfDay: z.ZodOptional<z.ZodString>;
+                timezoneId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"deployment">;
+                action: z.ZodObject<{
+                    flowIds: z.ZodDefault<z.ZodArray<FlowId>>;
+                    instructions: z.ZodOptional<z.ZodString>;
+                    investigateFailures: z.ZodOptional<z.ZodBoolean>;
+                    kind: z.ZodDefault<z.ZodEnum<{
+                        createSuite: "createSuite";
+                        generativeSuite: "generativeSuite";
+                    }>>;
+                    tagNames: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                }, z.core.$strip>;
+                branchPattern: z.ZodOptional<z.ZodString>;
+                deployTargetPattern: z.ZodOptional<z.ZodString>;
+                environmentIds: z.ZodDefault<z.ZodArray<EnvironmentId>>;
+                environmentPattern: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>, z.ZodObject<{
+                actionCount: z.ZodNumber;
+                kind: z.ZodLiteral<"advanced">;
+                whenCount: z.ZodNumber;
+            }, z.core.$strip>], "kind">;
+            createdAt: z.ZodISODateTime;
+            id: TriggerId;
+            isPaused: z.ZodBoolean;
+            name: z.ZodString;
+            nextScheduledAt: z.ZodOptional<z.ZodISODateTime>;
+            pausedAt: z.ZodOptional<z.ZodISODateTime>;
+            updatedAt: z.ZodISODateTime;
+            url: z.ZodURL;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=get.d.ts.map

package/dist/v1/trigger/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/v1/trigger/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,eAAO,MAAM,sBAAsB,GACjC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,SAAS,SAAS,cAAc,EAChC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,CAAC;CACpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqBA,CAAC"}

package/dist/v1/trigger/get.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { makeTriggerResourceSchema } from "./resource.js";
+export const makeGetTriggerContract = (ids) => {
+    const input = z.object({ triggerId: ids.trigger });
+    const output = z.object({ trigger: makeTriggerResourceSchema(ids) });
+    return {
+        annotations: {
+            destructiveHint: false,
+            openWorldHint: false,
+            readOnlyHint: true,
+        },
+        description: "Get one trigger by id.",
+        input,
+        kind: "read",
+        name: "trigger.get",
+        output,
+    };
+};
+//# sourceMappingURL=get.js.map