@qawolf/api-contracts 0.11.0 → 0.14.0

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

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeFindEnvironmentsContract: <EnvironmentId extends PublicIdSchema>(ids: {
+    environment: EnvironmentId;
+}) => {
+    readonly description: "List the team's environments, newest first.";
+    readonly input: z.ZodObject<{
+        cursor: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        includeTerminated: z.ZodDefault<z.ZodBoolean>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            static: "static";
+            preview: "preview";
+        }>>;
+    }, z.core.$strip>;
+    readonly kind: "read";
+    readonly name: "environment.find";
+    readonly output: z.ZodObject<{
+        environments: z.ZodArray<z.ZodObject<{
+            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;
+            status: z.ZodEnum<{
+                blocked: "blocked";
+                "needs-investigation": "needs-investigation";
+                ready: "ready";
+                running: "running";
+            }>;
+            terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+            url: z.ZodURL;
+        }, z.core.$strip>>;
+        nextCursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=find.d.ts.map

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

@@ -0,0 +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"}

package/dist/v1/environment/find.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { makePaginationInputFields, nextCursorSchema } from "../pagination.js";
+import { makeEnvironmentResourceSchema } from "./resource.js";
+export const makeFindEnvironmentsContract = (ids) => {
+    const input = z.object({
+        includeTerminated: z
+            .boolean()
+            .default(false)
+            .describe("Also list terminated environments. By default only environments that have not been terminated are listed."),
+        kind: z
+            .enum(["static", "preview"])
+            .optional()
+            .describe("Only list environments of this kind. Omit to list both."),
+        ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 100 }),
+    });
+    const output = z.object({
+        environments: z
+            .array(makeEnvironmentResourceSchema(ids))
+            .describe("The team's environments, newest first."),
+        nextCursor: nextCursorSchema,
+    });
+    return {
+        description: "List the team's environments, newest first.",
+        input,
+        kind: "read",
+        name: "environment.find",
+        output,
+    };
+};
+//# sourceMappingURL=find.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../src/v1/environment/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAE1C,GAED,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,iBAAiB,EAAE,CAAC;aACjB,OAAO,EAAE;aACT,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CACP,2GAA2G,CAC5G;QACH,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;aAC3B,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;QACtE,GAAG,yBAAyB,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;KAClE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,YAAY,EAAE,CAAC;aACZ,KAAK,CAAC,6BAA6B,CAAC,GAAG,CAAC,CAAC;aACzC,QAAQ,CAAC,wCAAwC,CAAC;QACrD,UAAU,EAAE,gBAAgB;KAC7B,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE,6CAA6C;QAC1D,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,kBAAkB;QACxB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

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

@@ -8,7 +8,6 @@ export declare const makeGetEnvironmentContract: <EnvironmentId extends PublicId
     readonly kind: "read";
     readonly name: "environment.get";
     readonly output: z.ZodObject<{
-        environmentId: EnvironmentId;
         flowCodeBranch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             lastSyncedCommitHash: z.ZodString;
             name: z.ZodString;
@@ -17,6 +16,7 @@ export declare const makeGetEnvironmentContract: <EnvironmentId extends PublicId
             name: z.ZodString;
             syncStatus: z.ZodLiteral<"not-reconciled">;
         }, z.core.$strip>], "syncStatus">>;
+        id: EnvironmentId;
         kind: z.ZodEnum<{
             static: "static";
             preview: "preview";
@@ -43,15 +43,28 @@ export declare const makeListEnvironmentVariableNamesContract: <EnvironmentId ex
         variableNames: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;
 };
-export declare const makeCreateEnvironmentContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId>) => {
+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 input: z.ZodObject<{
+        environmentId: EnvironmentId;
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>;
+    readonly kind: "write";
+    readonly name: "environment.setVariable";
+    readonly output: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>;
+};
+export declare const makeCreateEnvironmentContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema, WorkspaceId extends PublicIdSchema = PublicIdSchema>(ids: PublicIdSchemasOf<EnvironmentId, FlowId, RunId, PublicIdSchema, PublicIdSchema, WorkspaceId>) => {
     readonly description: "Create an environment on the caller's team and return it in the environment.get shape.";
     readonly input: z.ZodObject<{
         name: z.ZodString;
+        workspaceId: z.ZodOptional<WorkspaceId>;
     }, z.core.$strip>;
     readonly kind: "write";
     readonly name: "environment.create";
     readonly output: z.ZodObject<{
-        environmentId: EnvironmentId;
         flowCodeBranch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             lastSyncedCommitHash: z.ZodString;
             name: z.ZodString;
@@ -60,6 +73,7 @@ export declare const makeCreateEnvironmentContract: <EnvironmentId extends Publi
             name: z.ZodString;
             syncStatus: z.ZodLiteral<"not-reconciled">;
         }, z.core.$strip>], "syncStatus">>;
+        id: EnvironmentId;
         kind: z.ZodEnum<{
             static: "static";
             preview: "preview";

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;AA2DnE,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,6BAA6B,GACxC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAE5B,KAAK,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBrD,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

@@ -1,55 +1,10 @@
 import { z } from "zod";
-import { resource } from "../resource.js";
-// Both environment contracts return this one resource. The read and write
-// shapes cannot drift apart.
-const makeEnvironmentResource = (environmentId) => resource({
-    environmentId,
-    // Named after the branch, not "status": the object describes the
-    // environment's flow code branch. "flowCode" marks it as ours, so
-    // consumers don't read it as the status of their own git.
-    flowCodeBranch: z
-        .discriminatedUnion("syncStatus", [
-        z.object({
-            lastSyncedCommitHash: z
-                .string()
-                .describe("Hash of the latest reconciled commit."),
-            name: z
-                .string()
-                .describe("The name of the environment's flow code branch."),
-            syncStatus: z
-                .literal("reconciled")
-                .describe("The branch has reconciled at least one commit."),
-        }),
-        z.object({
-            name: z
-                .string()
-                .describe("The name of the environment's flow code branch."),
-            syncStatus: z
-                .literal("not-reconciled")
-                .describe("The branch has not reconciled any commit yet."),
-        }),
-    ])
-        .optional()
-        .describe("The environment's flow code branch and its git reconciliation state, if it has one."),
-    kind: z
-        .enum(["static", "preview"])
-        .describe("Whether the environment is static or a preview."),
-    name: z.string(),
-    // Environment-scoped health, aligned with the CI greenlight vocabulary
-    // (deriveEffectiveEnvironmentStatus): "ready" is the greenlit state.
-    status: z
-        .enum(["blocked", "needs-investigation", "ready", "running"])
-        .describe("Standing health across the environment's runs: blocked (open blocking bugs), needs-investigation (failures awaiting triage), running (flows executing), ready (none of the above — the greenlit state)."),
-    terminatedAt: z.iso
-        .datetime()
-        .optional()
-        .describe("When the environment was terminated, if it has been."),
-}, { urlFieldDescription: "Absolute URL of the environment page." });
+import { makeEnvironmentResourceSchema } from "./resource.js";
 export const makeGetEnvironmentContract = (ids) => {
     const input = z.object({
         environmentId: ids.environment,
     });
-    const output = makeEnvironmentResource(ids.environment);
+    const output = makeEnvironmentResourceSchema(ids);
     return {
         description: "Read a single environment's name, kind, health status, and termination state.",
         input,
@@ -79,6 +34,32 @@ export const makeListEnvironmentVariableNamesContract = (ids) => {
         output,
     };
 };
+export const makeSetEnvironmentVariableContract = (ids) => {
+    const input = z.object({
+        environmentId: ids.environment,
+        name: z
+            .string()
+            .trim()
+            .min(1, "Environment variable name cannot be blank.")
+            .max(255)
+            .describe("Name of the environment variable to create or replace. Leading and trailing whitespace is removed, remaining whitespace is replaced with underscores, and letters are uppercased."),
+        value: z
+            .string()
+            .describe("Value to store. This secret value is accepted but never returned."),
+    });
+    const output = z.object({
+        name: z
+            .string()
+            .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.",
+        input,
+        kind: "write",
+        name: "environment.setVariable",
+        output,
+    };
+};
 export const makeCreateEnvironmentContract = (ids) => {
     const input = z.object({
         name: z
@@ -87,8 +68,11 @@ export const makeCreateEnvironmentContract = (ids) => {
             .max(255)
             .regex(/\S/, "Environment name cannot be blank.")
             .describe("Display name of the new environment."),
+        workspaceId: ids.workspace
+            .optional()
+            .describe("The workspace to create the environment in. Required when authenticating with an organization API key."),
     });
-    const output = makeEnvironmentResource(ids.environment);
+    const output = makeEnvironmentResourceSchema(ids);
     return {
         description: "Create an environment on the caller's team and return it in the environment.get shape.",
         input,

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1/environment/index.ts"],"names":[],"mappings":"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"}
+{"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,WAAW;KAC/B,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,WAAW;KAC/B,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,WAAW;QAC9B,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"}

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

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeEnvironmentResourceSchema: <EnvironmentId extends PublicIdSchema>(ids: {
+    environment: EnvironmentId;
+}) => z.ZodObject<{
+    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;
+    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=resource.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;iBAkDE,CAAC"}

package/dist/v1/environment/resource.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { resource } from "../resource.js";
+export const makeEnvironmentResourceSchema = (ids) => resource({
+    // Named after the branch, not "status": the object describes the
+    // environment's flow code branch. "flowCode" marks it as ours, so
+    // consumers don't read it as the status of their own git.
+    flowCodeBranch: z
+        .discriminatedUnion("syncStatus", [
+        z.object({
+            lastSyncedCommitHash: z
+                .string()
+                .describe("Hash of the latest reconciled commit."),
+            name: z
+                .string()
+                .describe("The name of the environment's flow code branch."),
+            syncStatus: z
+                .literal("reconciled")
+                .describe("The branch has reconciled at least one commit."),
+        }),
+        z.object({
+            name: z
+                .string()
+                .describe("The name of the environment's flow code branch."),
+            syncStatus: z
+                .literal("not-reconciled")
+                .describe("The branch has not reconciled any commit yet."),
+        }),
+    ])
+        .optional()
+        .describe("The environment's flow code branch and its git reconciliation state, if it has one."),
+    id: ids.environment,
+    kind: z
+        .enum(["static", "preview"])
+        .describe("Whether the environment is static or a preview."),
+    name: z.string(),
+    // Environment-scoped health, aligned with the CI greenlight vocabulary
+    // (deriveEffectiveEnvironmentStatus): "ready" is the greenlit state.
+    status: z
+        .enum(["blocked", "needs-investigation", "ready", "running"])
+        .describe("Standing health across the environment's runs: blocked (open blocking bugs), needs-investigation (failures awaiting triage), running (flows executing), ready (none of the above — the greenlit state)."),
+    terminatedAt: z.iso
+        .datetime()
+        .optional()
+        .describe("When the environment was terminated, if it has been."),
+}, { urlFieldDescription: "Absolute URL of the environment page." });
+//# sourceMappingURL=resource.js.map

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

@@ -0,0 +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,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"}

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

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeAddTagToFlowsContract: <FlowId extends PublicIdSchema>(ids: {
+    flow: FlowId;
+}) => {
+    readonly description: "Assign an existing tag to the selected flows. Create tags with tag.create.";
+    readonly input: z.ZodObject<{
+        flowIds: z.ZodArray<FlowId>;
+        tagName: z.ZodString;
+    }, z.core.$strip>;
+    readonly kind: "write";
+    readonly name: "flow.addTag";
+    readonly output: z.ZodObject<{
+        color: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodURL;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=addTag.d.ts.map

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

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

package/dist/v1/flow/addTag.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { makeTagResourceSchema } from "../tag/index.js";
+export const makeAddTagToFlowsContract = (ids) => {
+    const input = z.object({
+        flowIds: z
+            .array(ids.flow)
+            .min(1)
+            // Matches the automate contract's flow selection cap.
+            .max(300)
+            .refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique")
+            .describe("The flows that receive the tag."),
+        // A lookup, not an insert: a name that cannot exist simply misses and
+        // returns the not-found error, so no format rules apply here.
+        tagName: z
+            .string()
+            .trim()
+            .min(1)
+            .describe("The name of an existing tag on the caller's team."),
+    });
+    const output = makeTagResourceSchema();
+    return {
+        description: "Assign an existing tag to the selected flows. Create tags with tag.create.",
+        input,
+        kind: "write",
+        name: "flow.addTag",
+        output,
+    };
+};
+//# sourceMappingURL=addTag.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"addTag.js","sourceRoot":"","sources":["../../../src/v1/flow/addTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAgC,GAExE,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;aACf,GAAG,CAAC,CAAC,CAAC;YACP,sDAAsD;aACrD,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,iCAAiC,CAAC;QAC9C,sEAAsE;QACtE,8DAA8D;QAC9D,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,mDAAmD,CAAC;KACjE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IAEvC,OAAO;QACL,WAAW,EACT,4EAA4E;QAC9E,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,aAAa;QACnB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/dist/v1/index.d.ts

@@ -33,11 +33,11 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
             readonly description: "Create an environment on the caller's team and return it in the environment.get shape.";
             readonly input: z.ZodObject<{
                 name: z.ZodString;
+                workspaceId: z.ZodOptional<WorkspaceId>;
             }, z.core.$strip>;
             readonly kind: "write";
             readonly name: "environment.create";
             readonly output: z.ZodObject<{
-                environmentId: EnvironmentId;
                 flowCodeBranch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     lastSyncedCommitHash: z.ZodString;
                     name: z.ZodString;
@@ -46,6 +46,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     name: z.ZodString;
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
+                id: EnvironmentId;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -61,6 +62,47 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
+        find: {
+            readonly description: "List the team's environments, newest first.";
+            readonly input: z.ZodObject<{
+                cursor: z.ZodOptional<z.ZodString>;
+                limit: z.ZodDefault<z.ZodNumber>;
+                includeTerminated: z.ZodDefault<z.ZodBoolean>;
+                kind: z.ZodOptional<z.ZodEnum<{
+                    static: "static";
+                    preview: "preview";
+                }>>;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "environment.find";
+            readonly output: z.ZodObject<{
+                environments: z.ZodArray<z.ZodObject<{
+                    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;
+                    status: z.ZodEnum<{
+                        blocked: "blocked";
+                        "needs-investigation": "needs-investigation";
+                        ready: "ready";
+                        running: "running";
+                    }>;
+                    terminatedAt: z.ZodOptional<z.ZodISODateTime>;
+                    url: z.ZodURL;
+                }, z.core.$strip>>;
+                nextCursor: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        };
         get: {
             readonly description: "Read a single environment's name, kind, health status, and termination state.";
             readonly input: z.ZodObject<{
@@ -69,7 +111,6 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
             readonly kind: "read";
             readonly name: "environment.get";
             readonly output: z.ZodObject<{
-                environmentId: EnvironmentId;
                 flowCodeBranch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     lastSyncedCommitHash: z.ZodString;
                     name: z.ZodString;
@@ -78,6 +119,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     name: z.ZodString;
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
+                id: EnvironmentId;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -104,8 +146,35 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                 variableNames: z.ZodArray<z.ZodString>;
             }, z.core.$strip>;
         };
+        setVariable: {
+            readonly description: "Create or replace one environment variable by name and return its stored name. The value is never returned.";
+            readonly input: z.ZodObject<{
+                environmentId: EnvironmentId;
+                name: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>;
+            readonly kind: "write";
+            readonly name: "environment.setVariable";
+            readonly output: z.ZodObject<{
+                name: z.ZodString;
+            }, z.core.$strip>;
+        };
     };
     flow: {
+        addTag: {
+            readonly description: "Assign an existing tag to the selected flows. Create tags with tag.create.";
+            readonly input: z.ZodObject<{
+                flowIds: z.ZodArray<FlowId>;
+                tagName: z.ZodString;
+            }, z.core.$strip>;
+            readonly kind: "write";
+            readonly name: "flow.addTag";
+            readonly output: z.ZodObject<{
+                color: z.ZodString;
+                name: z.ZodString;
+                url: z.ZodURL;
+            }, z.core.$strip>;
+        };
         list: {
             readonly description: "List the flows of an environment at its latest reconciled commit.";
             readonly input: z.ZodObject<{
@@ -140,6 +209,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     high: "high";
                     urgent: "urgent";
                 }>>;
+                workspaceId: z.ZodOptional<WorkspaceId>;
             }, z.core.$strip>, z.ZodObject<{
                 estimatedDueDate: z.ZodOptional<z.ZodISODate>;
                 type: z.ZodLiteral<"coverageRequest">;
@@ -152,6 +222,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     high: "high";
                     urgent: "urgent";
                 }>>;
+                workspaceId: z.ZodOptional<WorkspaceId>;
             }, z.core.$strip>], "type">;
             readonly kind: "write";
             readonly name: "issue.create";
@@ -209,6 +280,7 @@ export declare const makeContractsV1: <EnvironmentId extends PublicIdSchema, Flo
                     coverageRequest: "coverageRequest";
                     maintenance: "maintenance";
                 }>;
+                workspaceId: z.ZodOptional<WorkspaceId>;
                 cursor: z.ZodOptional<z.ZodString>;
                 limit: z.ZodDefault<z.ZodNumber>;
             }, z.core.$strip>;
@@ -433,11 +505,11 @@ export declare const publicContractsV1: {
             readonly description: "Create an environment on the caller's team and return it in the environment.get shape.";
             readonly input: z.ZodObject<{
                 name: z.ZodString;
+                workspaceId: z.ZodOptional<PublicIdSchema>;
             }, z.core.$strip>;
             readonly kind: "write";
             readonly name: "environment.create";
             readonly output: z.ZodObject<{
-                environmentId: PublicIdSchema;
                 flowCodeBranch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     lastSyncedCommitHash: z.ZodString;
                     name: z.ZodString;
@@ -446,6 +518,7 @@ export declare const publicContractsV1: {
                     name: z.ZodString;
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
+                id: PublicIdSchema;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -461,6 +534,47 @@ export declare const publicContractsV1: {
                 url: z.ZodURL;
             }, z.core.$strip>;
         };
+        find: {
+            readonly description: "List the team's environments, newest first.";
+            readonly input: z.ZodObject<{
+                cursor: z.ZodOptional<z.ZodString>;
+                limit: z.ZodDefault<z.ZodNumber>;
+                includeTerminated: z.ZodDefault<z.ZodBoolean>;
+                kind: z.ZodOptional<z.ZodEnum<{
+                    static: "static";
+                    preview: "preview";
+                }>>;
+            }, z.core.$strip>;
+            readonly kind: "read";
+            readonly name: "environment.find";
+            readonly output: z.ZodObject<{
+                environments: z.ZodArray<z.ZodObject<{
+                    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: PublicIdSchema;
+                    kind: z.ZodEnum<{
+                        static: "static";
+                        preview: "preview";
+                    }>;
+                    name: 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>>;
+                nextCursor: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+        };
         get: {
             readonly description: "Read a single environment's name, kind, health status, and termination state.";
             readonly input: z.ZodObject<{
@@ -469,7 +583,6 @@ export declare const publicContractsV1: {
             readonly kind: "read";
             readonly name: "environment.get";
             readonly output: z.ZodObject<{
-                environmentId: PublicIdSchema;
                 flowCodeBranch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     lastSyncedCommitHash: z.ZodString;
                     name: z.ZodString;
@@ -478,6 +591,7 @@ export declare const publicContractsV1: {
                     name: z.ZodString;
                     syncStatus: z.ZodLiteral<"not-reconciled">;
                 }, z.core.$strip>], "syncStatus">>;
+                id: PublicIdSchema;
                 kind: z.ZodEnum<{
                     static: "static";
                     preview: "preview";
@@ -504,8 +618,35 @@ export declare const publicContractsV1: {
                 variableNames: z.ZodArray<z.ZodString>;
             }, z.core.$strip>;
         };
+        setVariable: {
+            readonly description: "Create or replace one environment variable by name and return its stored name. The value is never returned.";
+            readonly input: z.ZodObject<{
+                environmentId: PublicIdSchema;
+                name: z.ZodString;
+                value: z.ZodString;
+            }, z.core.$strip>;
+            readonly kind: "write";
+            readonly name: "environment.setVariable";
+            readonly output: z.ZodObject<{
+                name: z.ZodString;
+            }, z.core.$strip>;
+        };
     };
     flow: {
+        addTag: {
+            readonly description: "Assign an existing tag to the selected flows. Create tags with tag.create.";
+            readonly input: z.ZodObject<{
+                flowIds: z.ZodArray<PublicIdSchema>;
+                tagName: z.ZodString;
+            }, z.core.$strip>;
+            readonly kind: "write";
+            readonly name: "flow.addTag";
+            readonly output: z.ZodObject<{
+                color: z.ZodString;
+                name: z.ZodString;
+                url: z.ZodURL;
+            }, z.core.$strip>;
+        };
         list: {
             readonly description: "List the flows of an environment at its latest reconciled commit.";
             readonly input: z.ZodObject<{
@@ -540,6 +681,7 @@ export declare const publicContractsV1: {
                     high: "high";
                     urgent: "urgent";
                 }>>;
+                workspaceId: z.ZodOptional<PublicIdSchema>;
             }, z.core.$strip>, z.ZodObject<{
                 estimatedDueDate: z.ZodOptional<z.ZodISODate>;
                 type: z.ZodLiteral<"coverageRequest">;
@@ -552,6 +694,7 @@ export declare const publicContractsV1: {
                     high: "high";
                     urgent: "urgent";
                 }>>;
+                workspaceId: z.ZodOptional<PublicIdSchema>;
             }, z.core.$strip>], "type">;
             readonly kind: "write";
             readonly name: "issue.create";
@@ -609,6 +752,7 @@ export declare const publicContractsV1: {
                     coverageRequest: "coverageRequest";
                     maintenance: "maintenance";
                 }>;
+                workspaceId: z.ZodOptional<PublicIdSchema>;
                 cursor: z.ZodOptional<z.ZodString>;
                 limit: z.ZodDefault<z.ZodNumber>;
             }, z.core.$strip>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAO5D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAEvB,MAAM,UAAU,CAAC;AAQlB,MAAM,MAAM,cAAc,CAAC,GAAG,SAAS,oBAAoB,IAAI,CAAC,CAAC,KAAK,CACpE,GAAG,CAAC,OAAO,CAAC,CACb,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,GAAG,SAAS,oBAAoB,IAAI,CAAC,CAAC,KAAK,CACrE,GAAG,CAAC,QAAQ,CAAC,CACd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,YAAY,SAAS,cAAc,GAAG,cAAc,EACpD,OAAO,SAAS,cAAc,GAAG,cAAc,EAC/C,WAAW,SAAS,cAAc,GAAG,cAAc,EAEnD,KAAK,iBAAiB,CACpB,aAAa,EACb,MAAM,EACN,KAAK,EACL,YAAY,EACZ,OAAO,EACP,WAAW,CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BF,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,YAAY,EACV,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAU5D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAEvB,MAAM,UAAU,CAAC;AAQlB,MAAM,MAAM,cAAc,CAAC,GAAG,SAAS,oBAAoB,IAAI,CAAC,CAAC,KAAK,CACpE,GAAG,CAAC,OAAO,CAAC,CACb,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,GAAG,SAAS,oBAAoB,IAAI,CAAC,CAAC,KAAK,CACrE,GAAG,CAAC,QAAQ,CAAC,CACd,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,YAAY,SAAS,cAAc,GAAG,cAAc,EACpD,OAAO,SAAS,cAAc,GAAG,cAAc,EAC/C,WAAW,SAAS,cAAc,GAAG,cAAc,EAEnD,KAAK,iBAAiB,CACpB,aAAa,EACb,MAAM,EACN,KAAK,EACL,YAAY,EACZ,OAAO,EACP,WAAW,CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCF,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAoC,CAAC"}

package/dist/v1/index.js

@@ -1,7 +1,9 @@
 export { defaultIdSchemas, } from "./ids.js";
 export { makeFlowSelectionSchema } from "./run/index.js";
 import { makeAutomateContract } from "./automate/index.js";
-import { makeCreateEnvironmentContract, makeGetEnvironmentContract, makeListEnvironmentVariableNamesContract, } from "./environment/index.js";
+import { makeFindEnvironmentsContract } from "./environment/find.js";
+import { makeCreateEnvironmentContract, makeGetEnvironmentContract, makeListEnvironmentVariableNamesContract, makeSetEnvironmentVariableContract, } from "./environment/index.js";
+import { makeAddTagToFlowsContract } from "./flow/addTag.js";
 import { makeListFlowsContract } from "./flow/index.js";
 import { defaultIdSchemas, } from "./ids.js";
 import { makeCreateIssueContract } from "./issue/create.js";
@@ -25,10 +27,13 @@ export const makeContractsV1 = (ids) => {
         automate: makeAutomateContract(resolvedIds),
         environment: {
             create: makeCreateEnvironmentContract(resolvedIds),
+            find: makeFindEnvironmentsContract(resolvedIds),
             get: makeGetEnvironmentContract(resolvedIds),
             listVariableNames: makeListEnvironmentVariableNamesContract(resolvedIds),
+            setVariable: makeSetEnvironmentVariableContract(resolvedIds),
         },
         flow: {
+            addTag: makeAddTagToFlowsContract(resolvedIds),
             list: makeListFlowsContract(resolvedIds),
         },
         issue: {

package/dist/v1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,wCAAwC,GACzC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAGL,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAUvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAQ7B,GAOC,EACD,EAAE;IACF,MAAM,WAAW,GAAG,EAAE,GAAG,gBAAgB,EAAE,GAAG,GAAG,EAAE,CAAC;IACpD,OAAO;QACL,qEAAqE;QACrE,0CAA0C;QAC1C,QAAQ,EAAE,oBAAoB,CAAC,WAAW,CAAC;QAC3C,WAAW,EAAE;YACX,MAAM,EAAE,6BAA6B,CAAC,WAAW,CAAC;YAClD,GAAG,EAAE,0BAA0B,CAAC,WAAW,CAAC;YAC5C,iBAAiB,EAAE,wCAAwC,CAAC,WAAW,CAAC;SACzE;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,qBAAqB,CAAC,WAAW,CAAC;SACzC;QACD,KAAK,EAAE;YACL,MAAM,EAAE,uBAAuB,CAAC,WAAW,CAAC;YAC5C,IAAI,EAAE,sBAAsB,CAAC,WAAW,CAAC;YACzC,GAAG,EAAE,oBAAoB,CAAC,WAAW,CAAC;SACvC;QACD,GAAG,EAAE;YACH,MAAM,EAAE,qBAAqB,CAAC,WAAW,CAAC;YAC1C,IAAI,EAAE,oBAAoB,CAAC,WAAW,CAAC;YACvC,GAAG,EAAE,kBAAkB,CAAC,WAAW,CAAC;SACrC;QACD,GAAG,EAAE;YACH,MAAM,EAAE,qBAAqB,EAAE;SAChC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,wCAAwC,EACxC,kCAAkC,GACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAGL,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAUvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAQ7B,GAOC,EACD,EAAE;IACF,MAAM,WAAW,GAAG,EAAE,GAAG,gBAAgB,EAAE,GAAG,GAAG,EAAE,CAAC;IACpD,OAAO;QACL,qEAAqE;QACrE,0CAA0C;QAC1C,QAAQ,EAAE,oBAAoB,CAAC,WAAW,CAAC;QAC3C,WAAW,EAAE;YACX,MAAM,EAAE,6BAA6B,CAAC,WAAW,CAAC;YAClD,IAAI,EAAE,4BAA4B,CAAC,WAAW,CAAC;YAC/C,GAAG,EAAE,0BAA0B,CAAC,WAAW,CAAC;YAC5C,iBAAiB,EAAE,wCAAwC,CAAC,WAAW,CAAC;YACxE,WAAW,EAAE,kCAAkC,CAAC,WAAW,CAAC;SAC7D;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,yBAAyB,CAAC,WAAW,CAAC;YAC9C,IAAI,EAAE,qBAAqB,CAAC,WAAW,CAAC;SACzC;QACD,KAAK,EAAE;YACL,MAAM,EAAE,uBAAuB,CAAC,WAAW,CAAC;YAC5C,IAAI,EAAE,sBAAsB,CAAC,WAAW,CAAC;YACzC,GAAG,EAAE,oBAAoB,CAAC,WAAW,CAAC;SACvC;QACD,GAAG,EAAE;YACH,MAAM,EAAE,qBAAqB,CAAC,WAAW,CAAC;YAC1C,IAAI,EAAE,oBAAoB,CAAC,WAAW,CAAC;YACvC,GAAG,EAAE,kBAAkB,CAAC,WAAW,CAAC;SACrC;QACD,GAAG,EAAE;YACH,MAAM,EAAE,qBAAqB,EAAE;SAChC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC"}

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

@@ -1,10 +1,11 @@
 import { z } from "zod";
 import type { PublicIdSchema } from "../ids.js";
-export declare const makeCreateIssueContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema, IssueId extends PublicIdSchema>(ids: {
+export declare const makeCreateIssueContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema, IssueId extends PublicIdSchema, WorkspaceId extends PublicIdSchema>(ids: {
     environment: EnvironmentId;
     flow: FlowId;
     issue: IssueId;
     run: RunId;
+    workspace: WorkspaceId;
 }) => {
     readonly description: string;
     readonly input: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -18,6 +19,7 @@ export declare const makeCreateIssueContract: <EnvironmentId extends PublicIdSch
             high: "high";
             urgent: "urgent";
         }>>;
+        workspaceId: z.ZodOptional<WorkspaceId>;
     }, z.core.$strip>, z.ZodObject<{
         estimatedDueDate: z.ZodOptional<z.ZodISODate>;
         type: z.ZodLiteral<"coverageRequest">;
@@ -30,6 +32,7 @@ export declare const makeCreateIssueContract: <EnvironmentId extends PublicIdSch
             high: "high";
             urgent: "urgent";
         }>>;
+        workspaceId: z.ZodOptional<WorkspaceId>;
     }, z.core.$strip>], "type">;
     readonly kind: "write";
     readonly name: "issue.create";

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

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/v1/issue/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,eAAO,MAAM,uBAAuB,GAClC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,OAAO,SAAS,cAAc,EAC9B,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDA,CAAC"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/v1/issue/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,eAAO,MAAM,uBAAuB,GAClC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,OAAO,SAAS,cAAc,EAC9B,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;IACX,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDA,CAAC"}

package/dist/v1/issue/create.js

@@ -11,6 +11,9 @@ export const makeCreateIssueContract = (ids) => {
         priority: issuePrioritySchema
             .optional()
             .describe('Defaults to "unprioritized".'),
+        workspaceId: ids.workspace
+            .optional()
+            .describe("The workspace to create the issue in. Required when authenticating with an organization API key."),
     };
     const input = z.discriminatedUnion("type", [
         z.object({

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

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/v1/issue/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAKrC,GAKD,EAAE,EAAE;IACH,MAAM,YAAY,GAAG;QACnB,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6FAA6F,CAC9F;QACH,wEAAwE;QACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACvC,QAAQ,EAAE,mBAAmB;aAC1B,QAAQ,EAAE;aACV,QAAQ,CAAC,8BAA8B,CAAC;KAC5C,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACzC,CAAC,CAAC,MAAM,CAAC;YACP,GAAG,YAAY;YACf,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;SACvB,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,GAAG,YAAY;YACf,gBAAgB,EAAE,CAAC,CAAC,GAAG;iBACpB,IAAI,EAAE;iBACN,QAAQ,EAAE;iBACV,QAAQ,CACP,4EAA4E,CAC7E;YACH,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;SACnC,CAAC;KACH,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,KAAK,EAAE,uBAAuB,CAAC,GAAG,CAAC;KACpC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,gEAAgE;YAChE,8DAA8D;QAChE,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,cAAc;QACpB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/v1/issue/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAMrC,GAMD,EAAE,EAAE;IACH,MAAM,YAAY,GAAG;QACnB,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6FAA6F,CAC9F;QACH,wEAAwE;QACxE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACvC,QAAQ,EAAE,mBAAmB;aAC1B,QAAQ,EAAE;aACV,QAAQ,CAAC,8BAA8B,CAAC;QAC3C,WAAW,EAAE,GAAG,CAAC,SAAS;aACvB,QAAQ,EAAE;aACV,QAAQ,CACP,kGAAkG,CACnG;KACJ,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;QACzC,CAAC,CAAC,MAAM,CAAC;YACP,GAAG,YAAY;YACf,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;SACvB,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,GAAG,YAAY;YACf,gBAAgB,EAAE,CAAC,CAAC,GAAG;iBACpB,IAAI,EAAE;iBACN,QAAQ,EAAE;iBACV,QAAQ,CACP,4EAA4E,CAC7E;YACH,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;SACnC,CAAC;KACH,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,KAAK,EAAE,uBAAuB,CAAC,GAAG,CAAC;KACpC,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,gEAAgE;YAChE,8DAA8D;QAChE,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,cAAc;QACpB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

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

@@ -47,11 +47,12 @@ export declare const makeIssueResourceSchema: <EnvironmentId extends PublicIdSch
     }>;
     url: z.ZodURL;
 }, z.core.$strip>;
-export declare const makeFindIssuesContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema, IssueId extends PublicIdSchema>(ids: {
+export declare const makeFindIssuesContract: <EnvironmentId extends PublicIdSchema, FlowId extends PublicIdSchema, RunId extends PublicIdSchema, IssueId extends PublicIdSchema, WorkspaceId extends PublicIdSchema>(ids: {
     environment: EnvironmentId;
     flow: FlowId;
     issue: IssueId;
     run: RunId;
+    workspace: WorkspaceId;
 }) => {
     readonly description: "List the team's bug reports, maintenance reports, or coverage requests, newest first.";
     readonly input: z.ZodObject<{
@@ -68,6 +69,7 @@ export declare const makeFindIssuesContract: <EnvironmentId extends PublicIdSche
             coverageRequest: "coverageRequest";
             maintenance: "maintenance";
         }>;
+        workspaceId: z.ZodOptional<WorkspaceId>;
         cursor: z.ZodOptional<z.ZodString>;
         limit: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/issue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,eAAO,MAAM,mBAAmB;;;;;;EAM9B,CAAC;AAeH,eAAO,MAAM,uBAAuB,GAClC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,OAAO,SAAS,cAAc,EAC9B,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BE,CAAC;AAEJ,eAAO,MAAM,sBAAsB,GACjC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,OAAO,SAAS,cAAc,EAC9B,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCA,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,OAAO,SAAS,cAAc,EAC9B,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBA,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/v1/issue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,eAAO,MAAM,mBAAmB;;;;;;EAM9B,CAAC;AAeH,eAAO,MAAM,uBAAuB,GAClC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,OAAO,SAAS,cAAc,EAC9B,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0BE,CAAC;AAEJ,eAAO,MAAM,sBAAsB,GACjC,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,OAAO,SAAS,cAAc,EAC9B,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;IACX,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCA,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,aAAa,SAAS,cAAc,EACpC,MAAM,SAAS,cAAc,EAC7B,KAAK,SAAS,cAAc,EAC5B,OAAO,SAAS,cAAc,EAC9B,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,KAAK,CAAC;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBA,CAAC"}

package/dist/v1/issue/index.js

@@ -46,6 +46,9 @@ export const makeFindIssuesContract = (ids) => {
             .default([...openIssueStatuses])
             .describe("Issue statuses to include. Defaults to pending, in-progress, and paused issues."),
         type: publicIssueTypeSchema.describe("The issue type to include: bug report, maintenance report, or coverage request."),
+        workspaceId: ids.workspace
+            .optional()
+            .describe("The workspace whose issues to list. Required when authenticating with an organization API key."),
     });
     const output = z.object({
         issues: z

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

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

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "@qawolf/api-contracts",
-  "version": "0.11.0",
+  "version": "0.14.0",
   "private": false,
   "description": "Versioned contracts for the QA Wolf public API",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/qawolf/platform.git"
   },
-  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -19,9 +22,9 @@
       "import": "./dist/v1/index.js"
     }
   },
-  "files": [
-    "dist"
-  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "rm -rf ./dist && tsc -p tsconfig.build.json",
     "lint:ci": "npm run lint:non-fixable; NON_FIXABLE_EXIT=$?; npm run lint:fixable && exit $NON_FIXABLE_EXIT",
@@ -45,8 +48,5 @@
   },
   "engines": {
     "node": ">=22.22.0 <25"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }