@qawolf/api-contracts 0.18.0 → 0.22.0

package/dist/v1/automate/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import type { PublicIdSchema, PublicIdSchemasOf } from "../ids.js";
 export declare const makeAutomateContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema, AutomationId extends PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId, AutomationId>) => {
-    readonly description: "Request an automation that builds the selected draft flows in an environment.";
+    readonly description: "Request automation for draft flows. First create a named local .flow.ts draft for every requested journey that does not already have a matching draft; never reuse a generic starter or placeholder. Each new draft must start with a JSDoc Goal: description, import flow from @qawolf/flows/web, and use export default flow(...); a comment-only file or direct test(...) call is not a valid draft. Commit and push all changes with Git to publish them, then list remote drafts to resolve every selected ID. Do not use patch to create or rename a selected flow. Finally make one automation request containing all requested flow IDs.";
     readonly input: z.ZodObject<{
         environmentId: PublicIdSchema;
         flowIds: z.ZodArray<FlowId>;

package/dist/v1/automate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/automate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnE,eAAO,MAAM,oBAAoB,GAC/B,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,YAAY,SAAS,cAAc,EAEnC,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC;;;;;;;;;;;;;CAyCnE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/automate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnE,eAAO,MAAM,oBAAoB,GAC/B,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,YAAY,SAAS,cAAc,EAEnC,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC;;;;;;;;;;;;;CA2CnE,CAAC"}

package/dist/v1/automate/index.js

@@ -9,17 +9,17 @@ export const makeAutomateContract = (ids) => {
             // Matches the server's maxJobsPerAiJobGroup cap.
             .max(300)
             .refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique")
-            .describe("Draft flows the automation builds."),
+            .describe("IDs of every requested draft flow the automation builds. Reuse an existing draft only when its name matches the requested journey; a generic starter or placeholder is not a match. After publishing, resolve the IDs with `qawolf --json flows list --remote --env <environment-id-or-alias> --include-drafts`."),
         patch: z
             .string()
             .min(1)
             .max(1_000_000)
             .optional()
-            .describe("Unified diff applied to the automation's working branch before it runs."),
+            .describe("Unified diff applied to the automation's working branch before it runs. It cannot create or rename a selected flow; publish selected flows with Git first."),
     });
     const output = resource({ automationId: ids.automation }, { urlFieldDescription: "Absolute URL of the automation review page." });
     return {
-        description: "Request an automation that builds the selected draft flows in an environment.",
+        description: "Request automation for draft flows. First create a named local .flow.ts draft for every requested journey that does not already have a matching draft; never reuse a generic starter or placeholder. Each new draft must start with a JSDoc Goal: description, import flow from @qawolf/flows/web, and use export default flow(...); a comment-only file or direct test(...) call is not a valid draft. Commit and push all changes with Git to publish them, then list remote drafts to resolve every selected ID. Do not use patch to create or rename a selected flow. Finally make one automation request containing all requested flow IDs.",
         input,
         kind: "write",
         name: "automate",

package/dist/v1/automate/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/automate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAMlC,GAAkE,EAClE,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;aACf,GAAG,CAAC,CAAC,CAAC;YACP,iDAAiD;aAChD,GAAG,CAAC,GAAG,CAAC;aACR,MAAM,CACL,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EACrD,wBAAwB,CACzB;aACA,QAAQ,CAAC,oCAAoC,CAAC;QACjD,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,SAAS,CAAC;aACd,QAAQ,EAAE;aACV,QAAQ,CACP,yEAAyE,CAC1E;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,QAAQ,CACrB,EAAE,YAAY,EAAE,GAAG,CAAC,UAAU,EAAE,EAChC,EAAE,mBAAmB,EAAE,6CAA6C,EAAE,CACvE,CAAC;IAEF,OAAO;QACL,WAAW,EACT,+EAA+E;QACjF,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/automate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAMlC,GAAkE,EAClE,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;aACf,GAAG,CAAC,CAAC,CAAC;YACP,iDAAiD;aAChD,GAAG,CAAC,GAAG,CAAC;aACR,MAAM,CACL,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EACrD,wBAAwB,CACzB;aACA,QAAQ,CACP,kTAAkT,CACnT;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,SAAS,CAAC;aACd,QAAQ,EAAE;aACV,QAAQ,CACP,4JAA4J,CAC7J;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,QAAQ,CACrB,EAAE,YAAY,EAAE,GAAG,CAAC,UAAU,EAAE,EAChC,EAAE,mBAAmB,EAAE,6CAA6C,EAAE,CACvE,CAAC;IAEF,OAAO;QACL,WAAW,EACT,knBAAknB;QACpnB,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

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

@@ -32,6 +32,7 @@ export declare const makeFindEnvironmentsContract: <EnvironmentId extends Public
                 preview: "preview";
             }>;
             name: z.ZodString;
+            runConcurrencyLimit: z.ZodString;
             status: z.ZodEnum<{
                 blocked: "blocked";
                 "needs-investigation": "needs-investigation";

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

@@ -1 +1 @@
-{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/v1/environment/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,4BAA4B,GACvC,aAAa,SAAS,cAAc,EACpC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;CAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCA,CAAC"}
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/v1/environment/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,4BAA4B,GACvC,aAAa,SAAS,cAAc,EACpC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;CAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCA,CAAC"}

package/dist/v1/environment/getVariable.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import type { PublicIdSchema, PublicIdSchemasOf } from "../ids.js";
+export declare const makeGetEnvironmentVariableContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId>) => {
+    readonly description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and do not fail the call.";
+    readonly input: z.ZodObject<{
+        environmentId: PublicIdSchema;
+        variableNames: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    readonly kind: "read";
+    readonly name: "environment.getVariable";
+    readonly output: z.ZodObject<{
+        missingNames: z.ZodArray<z.ZodString>;
+        variables: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=getVariable.d.ts.map

package/dist/v1/environment/getVariable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getVariable.d.ts","sourceRoot":"","sources":["../../../src/v1/environment/getVariable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnE,eAAO,MAAM,kCAAkC,GAC7C,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;;;;;;CA6CrD,CAAC"}

package/dist/v1/environment/getVariable.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export const makeGetEnvironmentVariableContract = (ids) => {
+    const input = z.object({
+        environmentId: ids.environmentRef,
+        variableNames: z
+            .array(z.string().min(1).max(255))
+            .min(1)
+            .max(100)
+            .describe("Names of the environment variables to read. Names match exactly as environment.listVariableNames returns them. Request every name you need in a single call, up to 100 names per call."),
+    });
+    const output = z.object({
+        missingNames: z
+            .array(z.string())
+            .describe("Requested names the environment does not have, sorted alphabetically."),
+        variables: z
+            .array(z.object({
+            name: z.string().describe("The stored variable name."),
+            value: z
+                .string()
+                .describe("The variable's secret value. Handle as a secret."),
+        }))
+            .describe("The found variables, sorted by name."),
+    });
+    return {
+        // A request that matches no names still succeeds. The caller reads the
+        // missing names from missingNames instead of an error.
+        description: "Read the values of named environment variables in one call. Values are secrets. Names that do not exist go to missingNames and do not fail the call.",
+        input,
+        kind: "read",
+        name: "environment.getVariable",
+        output,
+    };
+};
+//# sourceMappingURL=getVariable.js.map

package/dist/v1/environment/getVariable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getVariable.js","sourceRoot":"","sources":["../../../src/v1/environment/getVariable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAKhD,GAAoD,EACpD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,aAAa,EAAE,CAAC;aACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CACP,wLAAwL,CACzL;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,YAAY,EAAE,CAAC;aACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,uEAAuE,CACxE;QACH,SAAS,EAAE,CAAC;aACT,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACtD,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CAAC,kDAAkD,CAAC;SAChE,CAAC,CACH;aACA,QAAQ,CAAC,sCAAsC,CAAC;KACpD,CAAC,CAAC;IAEH,OAAO;QACL,uEAAuE;QACvE,uDAAuD;QACvD,WAAW,EACT,sJAAsJ;QACxJ,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,yBAAyB;QAC/B,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/dist/v1/environment/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import type { PublicIdSchema, PublicIdSchemasOf } from "../ids.js";
 export declare const makeGetEnvironmentContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId>) => {
-    readonly description: "Read a single environment's name, kind, health status, and termination state.";
+    readonly description: "Read a single environment's name, kind, health status, run concurrency limit, and termination state.";
     readonly input: z.ZodObject<{
         environmentId: PublicIdSchema;
     }, z.core.$strip>;
@@ -23,6 +23,7 @@ export declare const makeGetEnvironmentContract: <EnvironmentId extends PublicId
             preview: "preview";
         }>;
         name: z.ZodString;
+        runConcurrencyLimit: z.ZodString;
         status: z.ZodEnum<{
             blocked: "blocked";
             "needs-investigation": "needs-investigation";
@@ -34,7 +35,7 @@ export declare const makeGetEnvironmentContract: <EnvironmentId extends PublicId
     }, z.core.$strip>;
 };
 export declare const makeListEnvironmentVariableNamesContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId>) => {
-    readonly description: "List the names of an environment's variables, sorted. Names only — values never leave the server.";
+    readonly description: "Use this to answer which QA Wolf environment variables are available to test code. Returns names only; values never leave the server.";
     readonly input: z.ZodObject<{
         environmentId: PublicIdSchema;
     }, z.core.$strip>;
@@ -45,7 +46,7 @@ export declare const makeListEnvironmentVariableNamesContract: <EnvironmentId ex
     }, z.core.$strip>;
 };
 export declare const makeSetEnvironmentVariableContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId>) => {
-    readonly description: "Create or replace one environment variable by name and return its stored name. The value is never returned.";
+    readonly description: "Create or replace an environment variable. If the user asks to create one for \"my email\" without naming it, use DEFAULT_ENVIRONMENT_EMAIL. The value is never returned.";
     readonly input: z.ZodObject<{
         environmentId: PublicIdSchema;
         name: z.ZodString;
@@ -81,6 +82,7 @@ export declare const makeCreateEnvironmentContract: <EnvironmentId extends Publi
             preview: "preview";
         }>;
         name: z.ZodString;
+        runConcurrencyLimit: z.ZodString;
         status: z.ZodEnum<{
             blocked: "blocked";
             "needs-investigation": "needs-investigation";

package/dist/v1/environment/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAInE,eAAO,MAAM,0BAA0B,GACrC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBrD,CAAC;AAEF,eAAO,MAAM,wCAAwC,GACnD,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;CA8BrD,CAAC;AAEF,eAAO,MAAM,kCAAkC,GAC7C,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;;;CAuCrD,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,WAAW,SAAS,cAAc,GAAG,cAAc,EAEnD,KAAK,iBAAiB,CACpB,aAAa,EACb,MAAM,EACN,KAAK,EACL,cAAc,EACd,cAAc,EACd,WAAW,CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BF,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAInE,eAAO,MAAM,0BAA0B,GACrC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBrD,CAAC;AAEF,eAAO,MAAM,wCAAwC,GACnD,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;CA8BrD,CAAC;AAEF,eAAO,MAAM,kCAAkC,GAC7C,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;;;CAuCrD,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,WAAW,SAAS,cAAc,GAAG,cAAc,EAEnD,KAAK,iBAAiB,CACpB,aAAa,EACb,MAAM,EACN,KAAK,EACL,cAAc,EACd,cAAc,EACd,WAAW,CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BF,CAAC"}

package/dist/v1/environment/index.js

@@ -6,7 +6,7 @@ export const makeGetEnvironmentContract = (ids) => {
     });
     const output = makeEnvironmentResourceSchema(ids);
     return {
-        description: "Read a single environment's name, kind, health status, and termination state.",
+        description: "Read a single environment's name, kind, health status, run concurrency limit, and termination state.",
         input,
         kind: "read",
         name: "environment.get",
@@ -27,7 +27,7 @@ export const makeListEnvironmentVariableNamesContract = (ids) => {
             .describe("Names of the environment's variables, sorted alphabetically. Values are never returned."),
     });
     return {
-        description: "List the names of an environment's variables, sorted. Names only — values never leave the server.",
+        description: "Use this to answer which QA Wolf environment variables are available to test code. Returns names only; values never leave the server.",
         input,
         kind: "read",
         name: "environment.listVariableNames",
@@ -53,7 +53,7 @@ export const makeSetEnvironmentVariableContract = (ids) => {
             .describe("The stored variable name after whitespace is replaced with underscores and letters are uppercased."),
     });
     return {
-        description: "Create or replace one environment variable by name and return its stored name. The value is never returned.",
+        description: 'Create or replace an environment variable. If the user asks to create one for "my email" without naming it, use DEFAULT_ENVIRONMENT_EMAIL. The value is never returned.',
         input,
         kind: "write",
         name: "environment.setVariable",

package/dist/v1/environment/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAKxC,GAAoD,EACpD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;KAClC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAElD,OAAO;QACL,WAAW,EACT,+EAA+E;QACjF,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,iBAAiB;QACvB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAKtD,GAAoD,EACpD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;KAClC,CAAC,CAAC;IACH,wEAAwE;IACxE,0EAA0E;IAC1E,sEAAsE;IACtE,uEAAuE;IACvE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,aAAa,EAAE,CAAC;aACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,yFAAyF,CAC1F;KACJ,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,mGAAmG;QACrG,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,+BAA+B;QACrC,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAKhD,GAAoD,EACpD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,EAAE,4CAA4C,CAAC;aACpD,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CACP,mLAAmL,CACpL;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CACP,mEAAmE,CACpE;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,oGAAoG,CACrG;KACJ,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,6GAA6G;QAC/G,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,yBAAyB;QAC/B,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAM3C,GAOC,EACD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,KAAK,CAAC,IAAI,EAAE,mCAAmC,CAAC;aAChD,QAAQ,CAAC,sCAAsC,CAAC;QACnD,WAAW,EAAE,GAAG,CAAC,SAAS;aACvB,QAAQ,EAAE;aACV,QAAQ,CACP,wGAAwG,CACzG;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAElD,OAAO;QACL,WAAW,EACT,wFAAwF;QAC1F,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,oBAAoB;QAC1B,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAKxC,GAAoD,EACpD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;KAClC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAElD,OAAO;QACL,WAAW,EACT,sGAAsG;QACxG,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,iBAAiB;QACvB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAKtD,GAAoD,EACpD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;KAClC,CAAC,CAAC;IACH,wEAAwE;IACxE,0EAA0E;IAC1E,sEAAsE;IACtE,uEAAuE;IACvE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,aAAa,EAAE,CAAC;aACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,CACP,yFAAyF,CAC1F;KACJ,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,uIAAuI;QACzI,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,+BAA+B;QACrC,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAKhD,GAAoD,EACpD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,EAAE,4CAA4C,CAAC;aACpD,GAAG,CAAC,GAAG,CAAC;aACR,QAAQ,CACP,mLAAmL,CACpL;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CACP,mEAAmE,CACpE;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CACP,oGAAoG,CACrG;KACJ,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,yKAAyK;QAC3K,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,yBAAyB;QAC/B,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAM3C,GAOC,EACD,EAAE;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,GAAG,CAAC;aACR,KAAK,CAAC,IAAI,EAAE,mCAAmC,CAAC;aAChD,QAAQ,CAAC,sCAAsC,CAAC;QACnD,WAAW,EAAE,GAAG,CAAC,SAAS;aACvB,QAAQ,EAAE;aACV,QAAQ,CACP,wGAAwG,CACzG;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAElD,OAAO;QACL,WAAW,EACT,wFAAwF;QAC1F,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,oBAAoB;QAC1B,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/dist/v1/environment/resource.d.ts

@@ -18,6 +18,7 @@ export declare const makeEnvironmentResourceSchema: <EnvironmentId extends Publi
         preview: "preview";
     }>;
     name: z.ZodString;
+    runConcurrencyLimit: z.ZodString;
     status: z.ZodEnum<{
         blocked: "blocked";
         "needs-investigation": "needs-investigation";

package/dist/v1/environment/resource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/v1/environment/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,eAAO,MAAM,6BAA6B,GACxC,aAAa,SAAS,cAAc,EACpC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;CAC5B;;;;;;;;;;;;;;;;;;;;;;;;iBAwDE,CAAC"}
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../src/v1/environment/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,eAAO,MAAM,6BAA6B,GACxC,aAAa,SAAS,cAAc,EACpC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;CAC5B;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DE,CAAC"}

package/dist/v1/environment/resource.js

@@ -37,6 +37,9 @@ export const makeEnvironmentResourceSchema = (ids) => resource({
         .enum(["static", "preview"])
         .describe("Whether the environment is static or a preview."),
     name: z.string(),
+    runConcurrencyLimit: z
+        .string()
+        .describe('Maximum number of concurrent runs: a whole number, "unlimited", or a concurrency expression.'),
     // Environment-scoped health, aligned with the CI greenlight vocabulary
     // (deriveEffectiveEnvironmentStatus): "ready" is the greenlit state.
     status: z

package/dist/v1/environment/resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../src/v1/environment/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAE3C,GAED,EAAE,EAAE,CACH,QAAQ,CACN;IACE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+HAA+H,CAChI;IACH,iEAAiE;IACjE,kEAAkE;IAClE,0DAA0D;IAC1D,cAAc,EAAE,CAAC;SACd,kBAAkB,CAAC,YAAY,EAAE;QAChC,CAAC,CAAC,MAAM,CAAC;YACP,oBAAoB,EAAE,CAAC;iBACpB,MAAM,EAAE;iBACR,QAAQ,CAAC,uCAAuC,CAAC;YACpD,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,UAAU,EAAE,CAAC;iBACV,OAAO,CAAC,YAAY,CAAC;iBACrB,QAAQ,CAAC,gDAAgD,CAAC;SAC9D,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,UAAU,EAAE,CAAC;iBACV,OAAO,CAAC,gBAAgB,CAAC;iBACzB,QAAQ,CAAC,+CAA+C,CAAC;SAC7D,CAAC;KACH,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF,CACtF;IACH,EAAE,EAAE,GAAG,CAAC,WAAW;IACnB,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;SAC3B,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,uEAAuE;IACvE,qEAAqE;IACrE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,SAAS,EAAE,qBAAqB,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;SAC5D,QAAQ,CACP,yMAAyM,CAC1M;IACH,YAAY,EAAE,CAAC,CAAC,GAAG;SAChB,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;CACpE,EACD,EAAE,mBAAmB,EAAE,uCAAuC,EAAE,CACjE,CAAC"}
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../src/v1/environment/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAE3C,GAED,EAAE,EAAE,CACH,QAAQ,CACN;IACE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+HAA+H,CAChI;IACH,iEAAiE;IACjE,kEAAkE;IAClE,0DAA0D;IAC1D,cAAc,EAAE,CAAC;SACd,kBAAkB,CAAC,YAAY,EAAE;QAChC,CAAC,CAAC,MAAM,CAAC;YACP,oBAAoB,EAAE,CAAC;iBACpB,MAAM,EAAE;iBACR,QAAQ,CAAC,uCAAuC,CAAC;YACpD,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,UAAU,EAAE,CAAC;iBACV,OAAO,CAAC,YAAY,CAAC;iBACrB,QAAQ,CAAC,gDAAgD,CAAC;SAC9D,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,UAAU,EAAE,CAAC;iBACV,OAAO,CAAC,gBAAgB,CAAC;iBACzB,QAAQ,CAAC,+CAA+C,CAAC;SAC7D,CAAC;KACH,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF,CACtF;IACH,EAAE,EAAE,GAAG,CAAC,WAAW;IACnB,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;SAC3B,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,mBAAmB,EAAE,CAAC;SACnB,MAAM,EAAE;SACR,QAAQ,CACP,8FAA8F,CAC/F;IACH,uEAAuE;IACvE,qEAAqE;IACrE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,SAAS,EAAE,qBAAqB,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;SAC5D,QAAQ,CACP,yMAAyM,CAC1M;IACH,YAAY,EAAE,CAAC,CAAC,GAAG;SAChB,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;CACpE,EACD,EAAE,mBAAmB,EAAE,uCAAuC,EAAE,CACjE,CAAC"}

package/dist/v1/environment/update.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import type { PublicIdSchema, PublicIdSchemasOf } from "../ids.js";
+export declare const makeUpdateEnvironmentContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId>) => {
+    readonly description: "Update an environment owned by the caller's team and return it in the environment.get shape. Omitted fields remain unchanged.";
+    readonly input: z.ZodObject<{
+        environmentId: PublicIdSchema;
+        name: z.ZodOptional<z.ZodString>;
+        runConcurrencyLimit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly kind: "write";
+    readonly name: "environment.update";
+    readonly output: z.ZodObject<{
+        alias: z.ZodOptional<z.ZodString>;
+        flowCodeBranch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            lastSyncedCommitHash: z.ZodString;
+            name: z.ZodString;
+            syncStatus: z.ZodLiteral<"reconciled">;
+        }, z.core.$strip>, z.ZodObject<{
+            name: z.ZodString;
+            syncStatus: z.ZodLiteral<"not-reconciled">;
+        }, z.core.$strip>], "syncStatus">>;
+        id: EnvironmentId;
+        kind: z.ZodEnum<{
+            static: "static";
+            preview: "preview";
+        }>;
+        name: z.ZodString;
+        runConcurrencyLimit: z.ZodString;
+        status: z.ZodEnum<{
+            blocked: "blocked";
+            "needs-investigation": "needs-investigation";
+            ready: "ready";
+            running: "running";
+        }>;
+        terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+        url: z.ZodURL;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=update.d.ts.map

package/dist/v1/environment/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/v1/environment/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAInE,eAAO,MAAM,6BAA6B,GACxC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDrD,CAAC"}

package/dist/v1/environment/update.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { makeEnvironmentResourceSchema } from "./resource.js";
+export const makeUpdateEnvironmentContract = (ids) => {
+    const nameSchema = z
+        .string()
+        .trim()
+        .min(1)
+        .max(255)
+        .describe("New display name. Must be unique within the team.");
+    const runConcurrencyLimitSchema = z
+        .string()
+        .trim()
+        .min(1)
+        .max(255)
+        .describe('New run concurrency limit: a whole number, "unlimited", or a concurrency expression. The server validates the expression.');
+    // A refined object rather than a union of "one field is required" branches:
+    // a union converts to `anyOf`, which has no flat property set for the CLI to
+    // derive flags from. Compare makeUpdateIssueContract, which expresses the
+    // same "at least one of" rule this way.
+    const input = z
+        .object({
+        environmentId: ids.environmentRef,
+        name: nameSchema.optional(),
+        runConcurrencyLimit: runConcurrencyLimitSchema.optional(),
+    })
+        .refine((update) => update.name !== undefined || update.runConcurrencyLimit !== undefined, {
+        message: "At least one of name or runConcurrencyLimit is required.",
+    });
+    const output = makeEnvironmentResourceSchema(ids);
+    return {
+        description: "Update an environment owned by the caller's team and return it in the environment.get shape. Omitted fields remain unchanged.",
+        input,
+        kind: "write",
+        name: "environment.update",
+        output,
+    };
+};
+//# sourceMappingURL=update.js.map

package/dist/v1/environment/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/v1/environment/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAK3C,GAAoD,EACpD,EAAE;IACF,MAAM,UAAU,GAAG,CAAC;SACjB,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,mDAAmD,CAAC,CAAC;IACjE,MAAM,yBAAyB,GAAG,CAAC;SAChC,MAAM,EAAE;SACR,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,2HAA2H,CAC5H,CAAC;IACJ,4EAA4E;IAC5E,6EAA6E;IAC7E,0EAA0E;IAC1E,wCAAwC;IACxC,MAAM,KAAK,GAAG,CAAC;SACZ,MAAM,CAAC;QACN,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE;QAC3B,mBAAmB,EAAE,yBAAyB,CAAC,QAAQ,EAAE;KAC1D,CAAC;SACD,MAAM,CACL,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,mBAAmB,KAAK,SAAS,EACvE;QACE,OAAO,EAAE,0DAA0D;KACpE,CACF,CAAC;IACJ,MAAM,MAAM,GAAG,6BAA6B,CAAC,GAAG,CAAC,CAAC;IAElD,OAAO;QACL,WAAW,EACT,+HAA+H;QACjI,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,oBAAoB;QAC1B,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/dist/v1/flow/index.d.ts

@@ -17,6 +17,10 @@ export declare const makeListFlowsContract: <FlowId extends PublicIdSchema>(ids:
             flowId: FlowId;
             name: z.ZodString;
             path: z.ZodString;
+            readiness: z.ZodEnum<{
+                draft: "draft";
+                active: "active";
+            }>;
             tags: z.ZodArray<z.ZodString>;
             url: z.ZodURL;
         }, z.core.$strip>>;

package/dist/v1/flow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,eAAO,MAAM,qBAAqB,GAAI,MAAM,SAAS,cAAc,EAAE,KAAK;IACxE,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;;;;;;;;;;;;;;;;;;CA4CA,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,qBAAqB,GAAI,MAAM,SAAS,cAAc,EAAE,KAAK;IACxE,cAAc,EAAE,cAAc,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;;;;;;;;;;;;;;;;;;;;;;CA+CA,CAAC"}

package/dist/v1/flow/index.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { resource } from "../resource.js";
+import { flowReadinessSchema } from "./readiness.js";
 export const makeListFlowsContract = (ids) => {
     const input = z.object({
         environmentId: ids.environmentRef,
@@ -19,6 +20,7 @@ export const makeListFlowsContract = (ids) => {
             path: z
                 .string()
                 .describe("The flow file path, relative to the repo."),
+            readiness: flowReadinessSchema.describe("Whether the flow is a draft. Set it with flow.update."),
             tags: z.array(z.string()),
         }, {
             urlFieldDescription: "Absolute URL of the flow page in its environment.",

package/dist/v1/flow/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAgC,GAGpE,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,aAAa,EAAE,CAAC;aACb,OAAO,EAAE;aACT,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,qCAAqC,CAAC;KACnD,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,CAAC;SACtB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;SAC7D,QAAQ,CAAC,8DAA8D,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,QAAQ,CACN;YACE,eAAe;YACf,MAAM,EAAE,GAAG,CAAC,IAAI;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,2CAA2C,CAAC;YACxD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC1B,EACD;YACE,mBAAmB,EACjB,mDAAmD;SACtD,CACF,CACF;KACF,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,mEAAmE;QACrE,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,WAAW;QACjB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAgC,GAGpE,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,aAAa,EAAE,CAAC;aACb,OAAO,EAAE;aACT,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,qCAAqC,CAAC;KACnD,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,CAAC;SACtB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;SAC7D,QAAQ,CAAC,8DAA8D,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,QAAQ,CACN;YACE,eAAe;YACf,MAAM,EAAE,GAAG,CAAC,IAAI;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,2CAA2C,CAAC;YACxD,SAAS,EAAE,mBAAmB,CAAC,QAAQ,CACrC,uDAAuD,CACxD;YACD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SAC1B,EACD;YACE,mBAAmB,EACjB,mDAAmD;SACtD,CACF,CACF;KACF,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,mEAAmE;QACrE,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,WAAW;QACjB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/dist/v1/flow/readiness.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+/**
+ * A flow's readiness. Draft flows do not run in triggered suites.
+ *
+ * Readiness is not the flow status from `run.get`, which reports how a flow
+ * executed in one run.
+ */
+export declare const flowReadinessSchema: z.ZodEnum<{
+    draft: "draft";
+    active: "active";
+}>;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/v1/flow/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../../src/v1/flow/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAIH,eAAO,MAAM,mBAAmB;;;EAA8B,CAAC"}

package/dist/v1/flow/readiness.js

@@ -0,0 +1,12 @@
+import { z } from "zod";
+/**
+ * A flow's readiness. Draft flows do not run in triggered suites.
+ *
+ * Readiness is not the flow status from `run.get`, which reports how a flow
+ * executed in one run.
+ */
+// The app names this concept "readiness" and offers the same two values. The
+// richer statuses it shows (bug, maintenance) are derived per environment from
+// open issues, so they are not settable.
+export const flowReadinessSchema = z.enum(["draft", "active"]);
+//# sourceMappingURL=readiness.js.map

package/dist/v1/flow/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../../src/v1/flow/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,6EAA6E;AAC7E,+EAA+E;AAC/E,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC"}

package/dist/v1/flow/update.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeUpdateFlowContract: <FlowId extends PublicIdSchema>(ids: {
+    flow: FlowId;
+}) => {
+    readonly description: "Move a flow between draft and active readiness. The other statuses shown in the app are derived and cannot be set.";
+    readonly input: z.ZodObject<{
+        flowId: FlowId;
+        readiness: z.ZodEnum<{
+            draft: "draft";
+            active: "active";
+        }>;
+    }, z.core.$strip>;
+    readonly kind: "write";
+    readonly name: "flow.update";
+    readonly output: z.ZodObject<{
+        flow: z.ZodObject<{
+            flowId: FlowId;
+            name: z.ZodString;
+            readiness: z.ZodEnum<{
+                draft: "draft";
+                active: "active";
+            }>;
+            url: z.ZodURL;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=update.d.ts.map

package/dist/v1/flow/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/v1/flow/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,sBAAsB,GAAI,MAAM,SAAS,cAAc,EAAE,KAAK;IACzE,IAAI,EAAE,MAAM,CAAC;CACd;;;;;;;;;;;;;;;;;;;;;;CAmCA,CAAC"}

package/dist/v1/flow/update.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { resource } from "../resource.js";
+import { flowReadinessSchema } from "./readiness.js";
+export const makeUpdateFlowContract = (ids) => {
+    const input = z.object({
+        flowId: ids.flow,
+        readiness: flowReadinessSchema.describe("The readiness to set. Draft flows do not run in triggered suites."),
+    });
+    const output = z.object({
+        flow: resource({
+            flowId: ids.flow,
+            name: z.string(),
+            readiness: flowReadinessSchema.describe("The flow readiness after the update."),
+        }, {
+            urlFieldDescription: "Absolute URL of the flow page.",
+        }),
+    });
+    return {
+        description: "Move a flow between draft and active readiness. The other statuses shown in the app are derived and cannot be set.",
+        input,
+        kind: "write",
+        name: "flow.update",
+        output,
+    };
+};
+//# sourceMappingURL=update.js.map

package/dist/v1/flow/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/v1/flow/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAgC,GAErE,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,IAAI;QAChB,SAAS,EAAE,mBAAmB,CAAC,QAAQ,CACrC,mEAAmE,CACpE;KACF,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,IAAI,EAAE,QAAQ,CACZ;YACE,MAAM,EAAE,GAAG,CAAC,IAAI;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,SAAS,EAAE,mBAAmB,CAAC,QAAQ,CACrC,sCAAsC,CACvC;SACF,EACD;YACE,mBAAmB,EAAE,gCAAgC;SACtD,CACF;KACF,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,oHAAoH;QACtH,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,aAAa;QACnB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}