@qawolf/api-contracts 0.39.0 → 0.42.0

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

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeAgentGetContract: <ChatSessionId extends PublicIdSchema, WorkspaceId extends PublicIdSchema>(ids: {
+    chatSession: ChatSessionId;
+    workspace: WorkspaceId;
+}) => {
+    readonly description: "Read what the QA Wolf AI has said and whether it is still working. Poll this after agent.send until the status settles. A status of \"waiting-for-you\" means the last reply is a question the work is blocked on, and answering it with agent.send is what unblocks it. Replies accumulate, so a caller that polls repeatedly sees the earlier ones again.";
+    readonly input: z.ZodObject<{
+        sessionId: ChatSessionId;
+    }, z.core.$strip>;
+    readonly kind: "read";
+    readonly name: "agent.get";
+    readonly output: z.ZodObject<{
+        replies: z.ZodArray<z.ZodObject<{
+            askedAt: z.ZodISODateTime;
+            choices: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            text: z.ZodString;
+        }, z.core.$strip>>;
+        sessionId: ChatSessionId;
+        status: z.ZodEnum<{
+            working: "working";
+            "waiting-for-you": "waiting-for-you";
+            completed: "completed";
+            failed: "failed";
+            cancelled: "cancelled";
+        }>;
+        url: z.ZodURL;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/v1/agent/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,oBAAoB,GAC/B,aAAa,SAAS,cAAc,EACpC,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;CA8BA,CAAC"}

package/dist/v1/agent/get.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { resource } from "../resource.js";
+import { agentReplySchema, agentSessionStatusSchema } from "./status.js";
+export const makeAgentGetContract = (ids) => {
+    const input = z.object({
+        sessionId: ids.chatSession.describe("The id agent.send answered with."),
+    });
+    const output = resource({
+        replies: z
+            .array(agentReplySchema)
+            .describe("Everything the AI has said so far, oldest first. A reply carrying choices is a question the work is blocked on."),
+        sessionId: ids.chatSession,
+        status: agentSessionStatusSchema,
+    }, { urlFieldDescription: "Absolute URL of the session in the QA Wolf app." });
+    return {
+        description: 'Read what the QA Wolf AI has said and whether it is still working. Poll this after agent.send until the status settles. A status of "waiting-for-you" means the last reply is a question the work is blocked on, and answering it with agent.send is what unblocks it. Replies accumulate, so a caller that polls repeatedly sees the earlier ones again.',
+        input,
+        kind: "read",
+        name: "agent.get",
+        output,
+    };
+};
+//# sourceMappingURL=get.js.map

package/dist/v1/agent/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/v1/agent/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAGlC,GAGD,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KACxE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,QAAQ,CACrB;QACE,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,gBAAgB,CAAC;aACvB,QAAQ,CACP,iHAAiH,CAClH;QACH,SAAS,EAAE,GAAG,CAAC,WAAW;QAC1B,MAAM,EAAE,wBAAwB;KACjC,EACD,EAAE,mBAAmB,EAAE,iDAAiD,EAAE,CAC3E,CAAC;IAEF,OAAO;QACL,WAAW,EACT,2VAA2V;QAC7V,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,WAAW;QACjB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/dist/v1/agent/send.d.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeAgentSendContract: <ChatSessionId extends PublicIdSchema, WorkspaceId extends PublicIdSchema>(ids: {
+    chatSession: ChatSessionId;
+    environmentRef: PublicIdSchema;
+    workspace: WorkspaceId;
+}) => {
+    readonly description: "Ask the QA Wolf AI to do a piece of work in plain language, such as covering a user journey, investigating a failing run, or fixing a broken flow. This is the one verb that starts work from nothing: every other write acts on a flow, run or issue that already exists. Answers as soon as the request is accepted, with the id to follow it by, because the work runs for minutes to tens of minutes. Poll agent.get for progress, and send here again to answer a question or add context to work already running.";
+    readonly input: z.ZodObject<{
+        environmentId: z.ZodOptional<PublicIdSchema>;
+        message: z.ZodString;
+        sessionId: z.ZodOptional<ChatSessionId>;
+        workspaceId: z.ZodOptional<WorkspaceId>;
+    }, z.core.$strip>;
+    readonly kind: "write";
+    readonly name: "agent.send";
+    readonly output: z.ZodObject<{
+        sessionId: ChatSessionId;
+        status: z.ZodEnum<{
+            working: "working";
+            "waiting-for-you": "waiting-for-you";
+            completed: "completed";
+            failed: "failed";
+            cancelled: "cancelled";
+        }>;
+        url: z.ZodURL;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=send.d.ts.map

package/dist/v1/agent/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/v1/agent/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,qBAAqB,GAChC,aAAa,SAAS,cAAc,EACpC,WAAW,SAAS,cAAc,EAClC,KAAK;IACL,WAAW,EAAE,aAAa,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,WAAW,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;CAiDA,CAAC"}

package/dist/v1/agent/send.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { resource } from "../resource.js";
+import { agentSessionStatusSchema } from "./status.js";
+export const makeAgentSendContract = (ids) => {
+    const input = z.object({
+        environmentId: ids.environmentRef
+            .optional()
+            .describe("The environment to work in. Omit to use the team's default environment. Ignored when sessionId is given, because a session keeps the environment it opened in."),
+        message: z
+            .string()
+            .trim()
+            .min(1)
+            .max(10_000)
+            .describe("What you want QA Wolf to do, in plain language. Name the journey, the part of the app it covers, and anything the AI cannot discover for itself, such as a test account, a feature flag, or how to reach a staging environment. When answering a question from agent.get, send the answer here."),
+        sessionId: ids.chatSession
+            .optional()
+            .describe("Continue the session with this id instead of opening a new one. Omit to start fresh. Send this to answer a question or to add context to work already running."),
+        workspaceId: ids.workspace
+            .optional()
+            .describe("The workspace to work in. Required when authenticating with an organization or user API key."),
+    });
+    const output = resource({
+        sessionId: ids.chatSession.describe("Follow the work by passing this to agent.get."),
+        status: agentSessionStatusSchema,
+    }, { urlFieldDescription: "Absolute URL of the session in the QA Wolf app." });
+    return {
+        description: "Ask the QA Wolf AI to do a piece of work in plain language, such as covering a user journey, investigating a failing run, or fixing a broken flow. This is the one verb that starts work from nothing: every other write acts on a flow, run or issue that already exists. Answers as soon as the request is accepted, with the id to follow it by, because the work runs for minutes to tens of minutes. Poll agent.get for progress, and send here again to answer a question or add context to work already running.",
+        input,
+        kind: "write",
+        name: "agent.send",
+        output,
+    };
+};
+//# sourceMappingURL=send.js.map

package/dist/v1/agent/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../../src/v1/agent/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAGnC,GAID,EAAE,EAAE;IACH,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;QACrB,aAAa,EAAE,GAAG,CAAC,cAAc;aAC9B,QAAQ,EAAE;aACV,QAAQ,CACP,gKAAgK,CACjK;QACH,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,MAAM,CAAC;aACX,QAAQ,CACP,iSAAiS,CAClS;QACH,SAAS,EAAE,GAAG,CAAC,WAAW;aACvB,QAAQ,EAAE;aACV,QAAQ,CACP,gKAAgK,CACjK;QACH,WAAW,EAAE,GAAG,CAAC,SAAS;aACvB,QAAQ,EAAE;aACV,QAAQ,CACP,8FAA8F,CAC/F;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,QAAQ,CACrB;QACE,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,QAAQ,CACjC,+CAA+C,CAChD;QACD,MAAM,EAAE,wBAAwB;KACjC,EACD,EAAE,mBAAmB,EAAE,iDAAiD,EAAE,CAC3E,CAAC;IAEF,OAAO;QACL,WAAW,EACT,yfAAyf;QAC3f,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,YAAY;QAClB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

package/dist/v1/agent/status.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export declare const agentSessionStatuses: readonly ["working", "waiting-for-you", "completed", "failed", "cancelled"];
+export declare const agentSessionStatusSchema: z.ZodEnum<{
+    working: "working";
+    "waiting-for-you": "waiting-for-you";
+    completed: "completed";
+    failed: "failed";
+    cancelled: "cancelled";
+}>;
+export declare const agentReplySchema: z.ZodObject<{
+    askedAt: z.ZodISODateTime;
+    choices: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export type AgentSessionStatus = z.infer<typeof agentSessionStatusSchema>;
+//# sourceMappingURL=status.d.ts.map

package/dist/v1/agent/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/v1/agent/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB,6EAMvB,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;EAIlC,CAAC;AAEJ,eAAO,MAAM,gBAAgB;;;;iBAW3B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/v1/agent/status.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export const agentSessionStatuses = [
+    "working",
+    "waiting-for-you",
+    "completed",
+    "failed",
+    "cancelled",
+];
+export const agentSessionStatusSchema = z
+    .enum(agentSessionStatuses)
+    .describe('Where the work stands. "working" means the AI is still on it. "waiting-for-you" means it asked a question and cannot continue until agent.send answers it. "completed", "failed" and "cancelled" are settled and will not change.');
+export const agentReplySchema = z.object({
+    askedAt: z.iso
+        .datetime()
+        .describe("When the AI wrote this, as an ISO 8601 timestamp."),
+    choices: z
+        .array(z.string())
+        .optional()
+        .describe("The answers the AI offered, when the reply is a question with a fixed set of them. Answer by sending one of these back through agent.send."),
+    text: z.string().describe("What the AI said."),
+});
+//# sourceMappingURL=status.js.map

package/dist/v1/agent/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/v1/agent/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,iBAAiB;IACjB,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,IAAI,CAAC,oBAAoB,CAAC;KAC1B,QAAQ,CACP,mOAAmO,CACpO,CAAC;AAEJ,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,GAAG;SACX,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAChE,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,4IAA4I,CAC7I;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CAC/C,CAAC,CAAC"}

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

@@ -3,7 +3,7 @@ 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 description: "Assign an existing tag to the selected flows. Create tags with tag.create. Flows that already carry the tag are reported in skippedFlows.";
     readonly input: z.ZodObject<{
         flowIds: z.ZodArray<FlowId>;
         tagName: z.ZodString;
@@ -14,6 +14,13 @@ export declare const makeAddTagToFlowsContract: <FlowId extends PublicIdSchema>(
         color: z.ZodString;
         name: z.ZodString;
         url: z.ZodURL;
+        skippedFlows: z.ZodArray<z.ZodObject<{
+            flowId: FlowId;
+            name: z.ZodString;
+            reason: z.ZodEnum<{
+                "already-tagged": "already-tagged";
+            }>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 };
 //# sourceMappingURL=addTag.d.ts.map

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

@@ -1 +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"}
+{"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;AAKhD,eAAO,MAAM,yBAAyB,GAAI,MAAM,SAAS,cAAc,EAAE,KAAK;IAC5E,IAAI,EAAE,MAAM,CAAC;CACd;;;;;;;;;;;;;;;;;;;;CA6CA,CAAC"}

package/dist/v1/flow/addTag.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { makeTagResourceSchema } from "../tag/index.js";
+import { makeSkippedFlowsSchema } from "./skippedFlows.js";
 export const makeAddTagToFlowsContract = (ids) => {
     const input = z.object({
         flowIds: z
@@ -17,9 +18,16 @@ export const makeAddTagToFlowsContract = (ids) => {
             .min(1)
             .describe("The name of an existing tag on the caller's team."),
     });
-    const output = makeTagResourceSchema();
+    const output = makeTagResourceSchema().extend({
+        skippedFlows: makeSkippedFlowsSchema(ids, {
+            description: "Requested flows that already carried the tag, so nothing changed for them.",
+            reason: z
+                .enum(["already-tagged"])
+                .describe('Why the flow was skipped: "already-tagged" means the flow already carried the tag.'),
+        }),
+    });
     return {
-        description: "Assign an existing tag to the selected flows. Create tags with tag.create.",
+        description: "Assign an existing tag to the selected flows. Create tags with tag.create. Flows that already carry the tag are reported in skippedFlows.",
         input,
         kind: "write",
         name: "flow.addTag",

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

@@ -1 +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"}
+{"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,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,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,MAAM,CAAC;QAC5C,YAAY,EAAE,sBAAsB,CAAC,GAAG,EAAE;YACxC,WAAW,EACT,4EAA4E;YAC9E,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,gBAAgB,CAAC,CAAC;iBACxB,QAAQ,CACP,oFAAoF,CACrF;SACJ,CAAC;KACH,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,2IAA2I;QAC7I,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,aAAa;QACnB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+export declare const makeRemoveTagFromFlowsContract: <FlowId extends PublicIdSchema>(ids: {
+    flow: FlowId;
+}) => {
+    readonly description: "Remove a tag from the selected flows. Succeeds whether or not each flow carried the tag; the flows that did not are reported in skippedFlows.";
+    readonly input: z.ZodObject<{
+        flowIds: z.ZodArray<FlowId>;
+        tagName: z.ZodString;
+    }, z.core.$strip>;
+    readonly kind: "write";
+    readonly name: "flow.removeTag";
+    readonly output: z.ZodObject<{
+        color: z.ZodString;
+        name: z.ZodString;
+        url: z.ZodURL;
+        skippedFlows: z.ZodArray<z.ZodObject<{
+            flowId: FlowId;
+            name: z.ZodString;
+            reason: z.ZodEnum<{
+                "not-tagged": "not-tagged";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+};
+//# sourceMappingURL=removeTag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"removeTag.d.ts","sourceRoot":"","sources":["../../../src/v1/flow/removeTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKhD,eAAO,MAAM,8BAA8B,GACzC,MAAM,SAAS,cAAc,EAC7B,KAAK;IACL,IAAI,EAAE,MAAM,CAAC;CACd;;;;;;;;;;;;;;;;;;;;CA6CA,CAAC"}

package/dist/v1/flow/removeTag.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { makeTagResourceSchema } from "../tag/index.js";
+import { makeSkippedFlowsSchema } from "./skippedFlows.js";
+export const makeRemoveTagFromFlowsContract = (ids) => {
+    const input = z.object({
+        flowIds: z
+            .array(ids.flow)
+            .min(1)
+            // Matches the flow.addTag selection cap.
+            .max(300)
+            .refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique")
+            .describe("The flows that lose 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().extend({
+        skippedFlows: makeSkippedFlowsSchema(ids, {
+            description: "Requested flows that did not carry the tag, so nothing changed for them.",
+            reason: z
+                .enum(["not-tagged"])
+                .describe('Why the flow was skipped: "not-tagged" means the flow did not carry the tag.'),
+        }),
+    });
+    return {
+        description: "Remove a tag from the selected flows. Succeeds whether or not each flow carried the tag; the flows that did not are reported in skippedFlows.",
+        input,
+        kind: "write",
+        name: "flow.removeTag",
+        output,
+    };
+};
+//# sourceMappingURL=removeTag.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"removeTag.js","sourceRoot":"","sources":["../../../src/v1/flow/removeTag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAE5C,GAED,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,yCAAyC;aACxC,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,8BAA8B,CAAC;QAC3C,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,MAAM,CAAC;QAC5C,YAAY,EAAE,sBAAsB,CAAC,GAAG,EAAE;YACxC,WAAW,EACT,0EAA0E;YAC5E,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC;iBACpB,QAAQ,CACP,8EAA8E,CAC/E;SACJ,CAAC;KACH,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EACT,+IAA+I;QACjJ,KAAK;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,gBAAgB;QACtB,MAAM;KAMP,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import type { PublicIdSchema } from "../ids.js";
+/**
+ * The flows a tag write left untouched, each with the reason.
+ *
+ * flow.addTag and flow.removeTag both report their receipt through this
+ * factory, so an agent parses one row shape for the pair.
+ */
+export declare const makeSkippedFlowsSchema: <FlowId extends PublicIdSchema, ReasonSchema extends z.ZodType>(ids: {
+    flow: FlowId;
+}, { description, reason }: {
+    description: string;
+    reason: ReasonSchema;
+}) => z.ZodArray<z.ZodObject<{
+    flowId: FlowId;
+    name: z.ZodString;
+    reason: ReasonSchema;
+}, z.core.$strip>>;
+//# sourceMappingURL=skippedFlows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skippedFlows.d.ts","sourceRoot":"","sources":["../../../src/v1/flow/skippedFlows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,SAAS,cAAc,EAC7B,YAAY,SAAS,CAAC,CAAC,OAAO,EAE9B,KAAK;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACrB,yBAAyB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE;;;;kBAU9C,CAAC"}

package/dist/v1/flow/skippedFlows.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+/**
+ * The flows a tag write left untouched, each with the reason.
+ *
+ * flow.addTag and flow.removeTag both report their receipt through this
+ * factory, so an agent parses one row shape for the pair.
+ */
+export const makeSkippedFlowsSchema = (ids, { description, reason }) => z
+    .array(z.object({
+    flowId: ids.flow,
+    name: z.string().describe("The name of the flow."),
+    reason,
+}))
+    .describe(description);
+//# sourceMappingURL=skippedFlows.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skippedFlows.js","sourceRoot":"","sources":["../../../src/v1/flow/skippedFlows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAIpC,GAAqB,EACrB,EAAE,WAAW,EAAE,MAAM,EAAiD,EACtE,EAAE,CACF,CAAC;KACE,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;IACP,MAAM,EAAE,GAAG,CAAC,IAAI;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IAClD,MAAM;CACP,CAAC,CACH;KACA,QAAQ,CAAC,WAAW,CAAC,CAAC"}