@qawolf/cli 1.23.0 → 1.24.0

package/dist/cli.js

@@ -8800,7 +8800,8 @@ var lifecycleMessages = {
 
 // src/core/messages/interactiveRunner/list.ts
 var listMessages = {
-  noRunners: "This directory has no runner running. Launch one with qawolf runner launch, or pass --runner to address a runner started elsewhere.",
+  noRunners: "Your team has no runner running. Launch one with qawolf runner launch.",
+  noRunnersHere: "This directory has no runner running. Launch one with qawolf runner launch, or drop --here to see the whole team's runners.",
   runnerCount: (count) => count === 1 ? "1 runner" : `${String(count)} runners`,
   title: "Runners"
 };
@@ -13779,6 +13780,9 @@ var ZodEmail = /* @__PURE__ */ $constructor("ZodEmail", (inst, def) => {
   $ZodEmail.init(inst, def);
   ZodStringFormat.init(inst, def);
 });
+function email2(params) {
+  return _email(ZodEmail, params);
+}
 var ZodGUID = /* @__PURE__ */ $constructor("ZodGUID", (inst, def) => {
   $ZodGUID.init(inst, def);
   ZodStringFormat.init(inst, def);
@@ -13842,6 +13846,9 @@ var ZodBase64 = /* @__PURE__ */ $constructor("ZodBase64", (inst, def) => {
   $ZodBase64.init(inst, def);
   ZodStringFormat.init(inst, def);
 });
+function base642(params) {
+  return _base64(ZodBase64, params);
+}
 var ZodBase64URL = /* @__PURE__ */ $constructor("ZodBase64URL", (inst, def) => {
   $ZodBase64URL.init(inst, def);
   ZodStringFormat.init(inst, def);
@@ -15751,6 +15758,44 @@ var agentReplySchema = object({
   text: string2().describe("What the AI said.")
 });
 
+// node_modules/@qawolf/api-contracts/dist/v1/resource.js
+function resource(fields, { urlFieldDescription = "Absolute URL." } = {}) {
+  return object({
+    ...fields,
+    url: url().describe(urlFieldDescription)
+  });
+}
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/resource.js
+var emailDirectionSchema = _enum(["inbound", "outbound"]);
+var namedAddressSchema = object({
+  address: string2().describe("The email address."),
+  name: string2().optional().describe("The display name, when the message carried one.")
+});
+var emailUrlFieldDescription = "Absolute URL of the workspace. The inbox opens from the app header.";
+var makeEmailSummaryFields = () => ({
+  createdAt: exports_iso.datetime({ offset: true }).describe("When QA Wolf received or sent the email."),
+  direction: emailDirectionSchema.describe("inbound for mail the workspace received, outbound for mail it sent."),
+  from: namedAddressSchema,
+  id: string2().min(1).describe("The id of the email. Pass it to email.get to read the body."),
+  subject: string2().optional(),
+  to: array(namedAddressSchema)
+});
+var makeEmailResourceSchema = () => resource({
+  ...makeEmailSummaryFields(),
+  attachments: array(object({
+    fileName: string2(),
+    index: number2().int().min(0).describe("The position of the attachment in the email, from 0. Pass it to email.getAttachment when file names repeat."),
+    type: string2().optional().describe("The MIME type.")
+  })).optional().describe("Attachment names, positions, and types. Read the content with email.getAttachment."),
+  bcc: array(namedAddressSchema).optional(),
+  cc: array(namedAddressSchema).optional(),
+  html: string2().optional().describe("The HTML body."),
+  links: array(string2()).describe("The links of the email, in order: HTML anchors, then images, then bare URLs of the plain text body. Follow one to confirm a sign-up or reset a password."),
+  replyTo: array(namedAddressSchema).optional(),
+  text: string2().optional().describe("The plain text body.")
+}, { urlFieldDescription: emailUrlFieldDescription });
+
 // node_modules/@qawolf/api-contracts/dist/v1/identity/organization.js
 var identityOrganization = object({
   id: string2(),
@@ -15806,14 +15851,6 @@ var defaultIdSchemas = {
   workspace: string2().min(1).describe("The id of the workspace.")
 };
 
-// node_modules/@qawolf/api-contracts/dist/v1/resource.js
-function resource(fields, { urlFieldDescription = "Absolute URL." } = {}) {
-  return object({
-    ...fields,
-    url: url().describe(urlFieldDescription)
-  });
-}
-
 // node_modules/@qawolf/api-contracts/dist/v1/run/flowSelection.js
 var makeFlowSelectionSchema = (ids) => object({
   flowIds: array(ids.flow).default([]),
@@ -16343,6 +16380,131 @@ var makeAutomateContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/pagination.js
+var makePaginationInputFields = (limits) => ({
+  cursor: string2().min(1).optional().describe("Opaque cursor copied from the previous response's nextCursor. Omit to fetch the first page."),
+  limit: number2().int().min(1).max(limits.maxLimit).default(limits.defaultLimit).describe(`Maximum rows per page. Defaults to ${limits.defaultLimit}, capped at ${limits.maxLimit}.`)
+});
+var nextCursorSchema = string2().min(1).optional().describe("Repeat the request with this value as cursor to fetch the next page. Absent when there are no further results.");
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/find.js
+var makeFindEmailsContract = (ids) => {
+  const input = object({
+    address: email2().optional().describe("Only emails delivered to this exact address (inbound) or sent from it (outbound). Mail to a plus-suffixed address such as inbox+abc@example.com is found by that full address, not by inbox@example.com."),
+    createdAfter: exports_iso.datetime({ offset: true }).optional().describe("Only include emails received or sent after this instant, e.g. since a flow submitted a sign-up form."),
+    direction: emailDirectionSchema.default("inbound").describe("inbound lists the mail the workspace received: its inbox. outbound lists the mail it sent."),
+    workspaceId: ids.workspace.optional().describe("The workspace whose emails to list. Required when authenticating with an organization or user API key."),
+    ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 50 })
+  });
+  const output = object({
+    emails: array(resource(makeEmailSummaryFields(), {
+      urlFieldDescription: emailUrlFieldDescription
+    })).describe("The workspace's emails, newest first. Bodies are available via email.get."),
+    nextCursor: nextCursorSchema
+  });
+  return {
+    description: "List the workspace's inbox, or its sent mail, newest first. Read a message body with email.get.",
+    input,
+    kind: "read",
+    name: "email.find",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/get.js
+var makeGetEmailContract = (ids) => {
+  const input = object({
+    id: string2().min(1).describe("The id of the email, from email.find."),
+    workspaceId: ids.workspace.optional().describe("The workspace the email belongs to. Required when authenticating with an organization or user API key.")
+  });
+  const output = makeEmailResourceSchema();
+  return {
+    description: "Read one email of the workspace, with its plain text and HTML bodies. Use it to pull a sign-in code or a verification link out of a message.",
+    input,
+    kind: "read",
+    name: "email.get",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/getAttachment.js
+var makeGetEmailAttachmentContract = (ids) => {
+  const input = object({
+    fileName: string2().min(1).optional().describe("The attachment's file name, as email.get lists it. The first attachment with that name is returned."),
+    id: string2().min(1).describe("The id of the email, from email.find."),
+    index: number2().int().min(0).optional().describe("The attachment's position in the email, from 0, as email.get lists it. Use it when file names repeat."),
+    workspaceId: ids.workspace.optional().describe("The workspace the email belongs to. Required when authenticating with an organization or user API key.")
+  }).refine((input) => input.fileName === undefined !== (input.index === undefined), { message: "Provide fileName or index, not both." });
+  const output = resource({
+    contentBase64: string2().describe("The file content, base64 encoded."),
+    fileName: string2(),
+    index: number2().int().min(0).describe("The position of the attachment in the email, from 0."),
+    type: string2().optional().describe("The MIME type.")
+  }, { urlFieldDescription: emailUrlFieldDescription });
+  return {
+    description: "Read one attachment of a workspace email as base64 content, by file name or by position. email.get lists both.",
+    input,
+    kind: "read",
+    name: "email.getAttachment",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/listAddresses.js
+var makeListEmailAddressesContract = (ids) => {
+  const input = object({
+    workspaceId: ids.workspace.optional().describe("The workspace whose inbox addresses to list. Required when authenticating with an organization or user API key."),
+    ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 50 })
+  });
+  const output = object({
+    addresses: array(resource({
+      address: string2().describe("The inbox address. Mail sent to any plus-suffixed form, such as inbox+abc@example.com, lands in the same inbox."),
+      isDefault: boolean2().describe("Whether this is the workspace's default inbox address.")
+    }, { urlFieldDescription: emailUrlFieldDescription })).describe("The workspace's permanent inbox addresses, alphabetical."),
+    nextCursor: nextCursorSchema
+  });
+  return {
+    description: "List the workspace's inbox addresses, alphabetical. A flow can sign up with a plus-suffixed form of any of them, and email.find reads what arrives.",
+    input,
+    kind: "read",
+    name: "email.listAddresses",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/send.js
+var recipientsSchema = array(email2()).max(50);
+var maxAttachments = 10;
+var maxEmailAttachmentsBase64Length = 30 * 1024 * 1024;
+var attachmentsBase64Length = (attachments) => Object.values(attachments).reduce((total, content) => total + content.length, 0);
+var makeSendEmailContract = (ids) => {
+  const input = object({
+    attachments: record(string2().min(1), base642()).refine((attachments) => Object.keys(attachments).length <= maxAttachments, { message: `Send at most ${maxAttachments} attachments.` }).refine((attachments) => attachmentsBase64Length(attachments) <= maxEmailAttachmentsBase64Length, { message: "Send at most 30 MB of attachments." }).optional().describe("Files to attach, as file name to base64 content, at most 30 MB in total. The MIME type comes from the file name's extension."),
+    bcc: recipientsSchema.optional(),
+    cc: recipientsSchema.optional(),
+    from: email2().optional().describe("The workspace inbox address to send from, or a plus-suffixed form of one. Defaults to the workspace's default inbox address. See email.listAddresses."),
+    html: string2().optional().describe("The HTML body."),
+    inReplyTo: string2().min(1).optional().describe("The id of an email of the workspace to reply to, from email.find. The reply threads under that message."),
+    replyTo: recipientsSchema.optional().describe("Where replies should go instead of the from address."),
+    subject: string2().min(1),
+    text: string2().optional().describe("The plain text body."),
+    to: recipientsSchema.min(1),
+    workspaceId: ids.workspace.optional().describe("The workspace to send from. Required when authenticating with an organization or user API key.")
+  }).refine((email) => email.html || email.text, {
+    message: "Provide text, html, or both."
+  });
+  const output = resource(makeEmailSummaryFields(), {
+    urlFieldDescription: emailUrlFieldDescription
+  });
+  return {
+    description: "Send an email from one of the workspace's inbox addresses, for example to exercise a flow that reacts to incoming mail. Returns the sent email; read it back with email.get.",
+    input,
+    kind: "write",
+    name: "email.send",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/environment/deleteVariable.js
 var makeDeleteEnvironmentVariableContract = (ids) => {
   const input = object({
@@ -16361,13 +16523,6 @@ var makeDeleteEnvironmentVariableContract = (ids) => {
   };
 };
 
-// node_modules/@qawolf/api-contracts/dist/v1/pagination.js
-var makePaginationInputFields = (limits) => ({
-  cursor: string2().min(1).optional().describe("Opaque cursor copied from the previous response's nextCursor. Omit to fetch the first page."),
-  limit: number2().int().min(1).max(limits.maxLimit).default(limits.defaultLimit).describe(`Maximum rows per page. Defaults to ${limits.defaultLimit}, capped at ${limits.maxLimit}.`)
-});
-var nextCursorSchema = string2().min(1).optional().describe("Repeat the request with this value as cursor to fetch the next page. Absent when there are no further results.");
-
 // node_modules/@qawolf/api-contracts/dist/v1/environment/resource.js
 var makeEnvironmentResourceSchema = (ids) => resource({
   alias: string2().optional().describe("The environment's alias: a team-unique slug that team API keys can use in place of the id. Terminated environments have none."),
@@ -16539,15 +16694,27 @@ var makeCreateTagContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/flow/skippedFlows.js
+var makeSkippedFlowsSchema = (ids, { description, reason }) => array(object({
+  flowId: ids.flow,
+  name: string2().describe("The name of the flow."),
+  reason
+})).describe(description);
+
 // node_modules/@qawolf/api-contracts/dist/v1/flow/addTag.js
 var makeAddTagToFlowsContract = (ids) => {
   const input = object({
     flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").describe("The flows that receive the tag."),
     tagName: string2().trim().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: _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",
@@ -16587,6 +16754,27 @@ var makeListFlowsContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/flow/removeTag.js
+var makeRemoveTagFromFlowsContract = (ids) => {
+  const input = object({
+    flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").describe("The flows that lose the tag."),
+    tagName: string2().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: _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
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/flow/update.js
 var makeUpdateFlowContract = (ids) => {
   const input = object({
@@ -16731,6 +16919,24 @@ var makeCreateIssueContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
+var makeRemoveFlowsFromIssueContract = (ids) => {
+  const input = object({
+    flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").describe("The flows the coverage request no longer covers."),
+    issueId: ids.issue
+  });
+  const output = object({
+    issue: makeIssueResourceSchema(ids)
+  });
+  return {
+    description: "Remove flows from a coverage request owned by the caller's team. " + "Flows the request does not cover are left alone. " + "Bug and maintenance reports link to flows through the runs that reproduce them, so their flows cannot be set directly.",
+    input,
+    kind: "write",
+    name: "issue.removeFlows",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/issue/update.js
 var makeUpdateIssueContract = (ids) => {
   const descriptionSchema = string2().describe("The issue description as plain text; each line becomes a paragraph. Markdown is not parsed.");
@@ -17057,6 +17263,22 @@ var makeTerminateRunnerContract = () => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/runner/list.js
+var makeListRunnersContract = () => {
+  const input = object({});
+  const output = object({
+    outcome: literal("success"),
+    runners: array(makeRunnerSchema()).describe("The runners running right now, in no particular order. Each entry carries the same fields a launch reports, so any of them can be addressed like a runner you launched yourself.")
+  });
+  return {
+    description: "List the runners running on the caller's team right now. Takes no arguments: the API key already names the team. A runner that was terminated, or that terminated on its own after inactivity, is not listed, because the run system keeps no record of a runner once it is gone. This is a lookup: it never starts a runner, and it does not reset a runner's inactivity clock the way reading its journal does. It is how to find a runner launched from another machine or in an earlier session, when the id it was launched under is no longer at hand.",
+    input,
+    kind: "read",
+    name: "runner.list",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/runner/promoteSnapshot.js
 var maxSnapshotPathLength = 1024;
 var makePromoteSnapshotOnRunnerContract = () => {
@@ -17252,6 +17474,13 @@ var makeContractsV1 = (ids) => {
       send: makeAgentSendContract(resolvedIds)
     },
     automate: makeAutomateContract(resolvedIds),
+    email: {
+      find: makeFindEmailsContract(resolvedIds),
+      get: makeGetEmailContract(resolvedIds),
+      getAttachment: makeGetEmailAttachmentContract(resolvedIds),
+      listAddresses: makeListEmailAddressesContract(resolvedIds),
+      send: makeSendEmailContract(resolvedIds)
+    },
     environment: {
       create: makeCreateEnvironmentContract(resolvedIds),
       deleteVariable: makeDeleteEnvironmentVariableContract(resolvedIds),
@@ -17265,6 +17494,7 @@ var makeContractsV1 = (ids) => {
     flow: {
       addTag: makeAddTagToFlowsContract(resolvedIds),
       list: makeListFlowsContract(resolvedIds),
+      removeTag: makeRemoveTagFromFlowsContract(resolvedIds),
       update: makeUpdateFlowContract(resolvedIds)
     },
     issue: {
@@ -17272,6 +17502,7 @@ var makeContractsV1 = (ids) => {
       create: makeCreateIssueContract(resolvedIds),
       find: makeFindIssuesContract(resolvedIds),
       get: makeGetIssueContract(resolvedIds),
+      removeFlows: makeRemoveFlowsFromIssueContract(resolvedIds),
       update: makeUpdateIssueContract(resolvedIds)
     },
     run: {
@@ -17289,6 +17520,7 @@ var makeContractsV1 = (ids) => {
       inspect: makeInspectOnRunnerContract(),
       inspectMobile: makeInspectMobileOnRunnerContract(),
       launch: makeLaunchRunnerContract(),
+      list: makeListRunnersContract(),
       performAction: makePerformActionOnRunnerContract(),
       promoteSnapshot: makePromoteSnapshotOnRunnerContract(),
       readJournal: makeReadRunnerJournalContract(),
@@ -19367,7 +19599,7 @@ function startUpdateCheck(deps) {
 // package.json
 var package_default = {
   name: "@qawolf/cli",
-  version: "1.23.0",
+  version: "1.24.0",
   description: "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   keywords: [
     "automation",
@@ -19438,7 +19670,7 @@ var package_default = {
     "@clack/prompts": "1.5.1",
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
-    "@qawolf/api-contracts": "0.40.0",
+    "@qawolf/api-contracts": "0.47.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.4",
@@ -30548,6 +30780,7 @@ var skippedContractNames = new Set([
   "runner.inspect",
   "runner.inspectMobile",
   "runner.launch",
+  "runner.list",
   "runner.performAction",
   "runner.promoteSnapshot",
   "runner.readJournal",
@@ -32052,68 +32285,56 @@ async function handleRunnerLaunch(ctx, options, deps) {
 // src/domains/interactiveRunner/list.ts
 var columns = [
   { header: "id", value: (row) => row.id },
-  { header: "family", value: (row) => row.runnerName ?? "" },
+  { header: "family", value: (row) => row.runnerName },
+  { header: "launched here", value: (row) => row.launchedHere ? "yes" : "" },
   { header: "default", value: (row) => row.isDefault ? "yes" : "" }
 ];
-var probeBatchSize = 8;
-async function readCandidates(deps) {
-  const held = await deps.store.readRunners();
-  const storedDefault = await deps.store.readDefaultRunnerId();
-  const environmentValue = deps.env[runnerIdEnvironmentVariable]?.trim();
-  const fromEnvironment = environmentValue ? environmentValue : undefined;
-  const candidates = [...held];
-  for (const id of [storedDefault, fromEnvironment]) {
-    if (id !== undefined && !candidates.some((runner) => runner.id === id)) {
-      candidates.push({ id });
-    }
-  }
-  return { candidates, defaultRunnerId: fromEnvironment ?? storedDefault };
+function rank(item) {
+  if (item.isDefault)
+    return 0;
+  return item.launchedHere ? 1 : 2;
 }
-async function probeRunner(ctx, runner) {
-  const result = await ctx.platformClient.callPublicApi(publicContractsV1.runner.get, { id: runner.id }, runnerCallOptions);
-  if (!result.ok)
-    return { ...failureFields(result), ok: false };
-  return { ok: true, runner, running: result.value.running };
+async function readDefaultRunnerId(deps) {
+  const environmentValue = deps.env[runnerIdEnvironmentVariable]?.trim();
+  if (environmentValue)
+    return environmentValue;
+  return deps.store.readDefaultRunnerId();
 }
 async function listRunners(ctx, deps) {
-  const { candidates, defaultRunnerId } = await readCandidates(deps);
-  const running = [];
-  const gone = [];
-  for await (const probe of batchMap(candidates, (runner) => probeRunner(ctx, runner), probeBatchSize)) {
-    if (!probe.ok)
-      return { ...failureFields(probe), ok: false };
-    if (probe.running)
-      running.push(probe.runner);
-    else
-      gone.push(probe.runner.id);
-  }
+  const listed = await ctx.platformClient.callPublicApi(publicContractsV1.runner.list, {}, runnerCallOptions);
+  if (!listed.ok)
+    return { ...failureFields(listed), ok: false };
+  const defaultRunnerId = await readDefaultRunnerId(deps);
+  const runningIds = new Set(listed.value.runners.map((runner) => runner.id));
+  const held = await deps.store.readRunners();
+  const gone = held.filter((runner) => !runningIds.has(runner.id)).map((runner) => runner.id);
   await deps.store.dropRunners(gone).catch(() => {
     return;
   });
+  const heldIds = new Set(held.map((runner) => runner.id));
+  const items = listed.value.runners.map((runner) => ({
+    id: runner.id,
+    isDefault: runner.id === defaultRunnerId,
+    launchedHere: heldIds.has(runner.id),
+    runnerName: runner.runnerName
+  }));
   return {
-    items: [
-      ...running.filter((runner) => runner.id === defaultRunnerId),
-      ...running.filter((runner) => runner.id !== defaultRunnerId)
-    ].map((runner) => ({
-      id: runner.id,
-      isDefault: runner.id === defaultRunnerId,
-      runnerName: runner.runnerName
-    })),
+    items: items.sort((left, right) => rank(left) - rank(right) || left.id.localeCompare(right.id)),
     ok: true
   };
 }
-async function handleRunnerList(ctx, deps) {
+async function handleRunnerList(ctx, options, deps) {
   const listed = await listRunners(ctx, deps);
   if (!listed.ok) {
     return { ...failureFields(listed), exitCode: exitCodes.network };
   }
-  const items = listed.items;
+  const items = options.here ? listed.items.filter((item) => item.launchedHere) : listed.items;
   if (ctx.ui.mode === "json") {
     ctx.ui.json(items);
     return;
   }
   if (items.length === 0) {
-    ctx.ui.info(interactiveRunnerMessages.noRunners);
+    ctx.ui.info(options.here ? interactiveRunnerMessages.noRunnersHere : interactiveRunnerMessages.noRunners);
     return;
   }
   if (ctx.ui.mode === "agent") {
@@ -32175,6 +32396,7 @@ Examples:
 var listExamples2 = `
 Examples:
   $ qawolf runner list
+  $ qawolf runner list --here
   $ qawolf runner list --json`;
 var keepaliveExamples = `
 Examples:
@@ -32182,7 +32404,7 @@ Examples:
   $ qawolf runner keepalive --runner ci`;
 function registerRunnerLifecycleCommands(runner, signals) {
   declareCommandKind(runner.command("launch"), "write").description("Launch an interactive runner and make it this directory's default").option("--id <id>", "Id to launch under. Relaunching an id attaches to that runner").option("--name <family>", "Runner family to run, e.g. playwright").addHelpText("after", launchExamples).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerLaunch(ctx, { id: opts.id, name: opts.name }, runnerDeps(ctx)))(opts, command));
-  declareCommandKind(runner.command("list"), "read").description("List the runners this directory holds that are still running").addHelpText("after", listExamples2).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerList(ctx, runnerDeps(ctx)))(opts, command));
+  declareCommandKind(runner.command("list"), "read").description("List the runners running on your team").option("--here", "Only the runners this directory launched").addHelpText("after", listExamples2).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerList(ctx, { here: opts.here === true }, runnerDeps(ctx)))(opts, command));
   declareCommandKind(runner.command("terminate"), "write").description("End an interactive runner, and the pod it runs on with it").option("--runner <id>", runnerFlagDescription).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerTerminate(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
   declareCommandKind(runner.command("stop-run"), "write").description("Stop what a runner is currently executing, leaving the runner up").option("--runner <id>", runnerFlagDescription).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerStopRun(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
   declareCommandKind(runner.command("keepalive"), "read").description("Reset a runner's inactivity clock, for a caller that pauses between actions").option("--runner <id>", runnerFlagDescription).addHelpText("after", keepaliveExamples).action((opts, command) => withAuthContext(signals, (ctx) => handleRunnerKeepalive(ctx, { runner: opts.runner }, runnerDeps(ctx)))(opts, command));
@@ -32983,4 +33205,4 @@ createProgram({ signals }).parseAsync().catch(() => {
     process.exitCode = 1;
 }).finally(() => flushAndExit(typeof process.exitCode === "number" ? process.exitCode : 0));
 
-//# debugId=C63692CA002E50C264756E2164756E21
+//# debugId=599EFC31E23F426D64756E2164756E21

package/dist/runner-sdk.js

@@ -6102,6 +6102,9 @@ var ZodEmail = /* @__PURE__ */ $constructor("ZodEmail", (inst, def) => {
   $ZodEmail.init(inst, def);
   ZodStringFormat.init(inst, def);
 });
+function email2(params) {
+  return _email(ZodEmail, params);
+}
 var ZodGUID = /* @__PURE__ */ $constructor("ZodGUID", (inst, def) => {
   $ZodGUID.init(inst, def);
   ZodStringFormat.init(inst, def);
@@ -6165,6 +6168,9 @@ var ZodBase64 = /* @__PURE__ */ $constructor("ZodBase64", (inst, def) => {
   $ZodBase64.init(inst, def);
   ZodStringFormat.init(inst, def);
 });
+function base642(params) {
+  return _base64(ZodBase64, params);
+}
 var ZodBase64URL = /* @__PURE__ */ $constructor("ZodBase64URL", (inst, def) => {
   $ZodBase64URL.init(inst, def);
   ZodStringFormat.init(inst, def);
@@ -6747,6 +6753,44 @@ var agentReplySchema = object({
   text: string2().describe("What the AI said.")
 });
 
+// node_modules/@qawolf/api-contracts/dist/v1/resource.js
+function resource(fields, { urlFieldDescription = "Absolute URL." } = {}) {
+  return object({
+    ...fields,
+    url: url().describe(urlFieldDescription)
+  });
+}
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/resource.js
+var emailDirectionSchema = _enum(["inbound", "outbound"]);
+var namedAddressSchema = object({
+  address: string2().describe("The email address."),
+  name: string2().optional().describe("The display name, when the message carried one.")
+});
+var emailUrlFieldDescription = "Absolute URL of the workspace. The inbox opens from the app header.";
+var makeEmailSummaryFields = () => ({
+  createdAt: exports_iso.datetime({ offset: true }).describe("When QA Wolf received or sent the email."),
+  direction: emailDirectionSchema.describe("inbound for mail the workspace received, outbound for mail it sent."),
+  from: namedAddressSchema,
+  id: string2().min(1).describe("The id of the email. Pass it to email.get to read the body."),
+  subject: string2().optional(),
+  to: array(namedAddressSchema)
+});
+var makeEmailResourceSchema = () => resource({
+  ...makeEmailSummaryFields(),
+  attachments: array(object({
+    fileName: string2(),
+    index: number2().int().min(0).describe("The position of the attachment in the email, from 0. Pass it to email.getAttachment when file names repeat."),
+    type: string2().optional().describe("The MIME type.")
+  })).optional().describe("Attachment names, positions, and types. Read the content with email.getAttachment."),
+  bcc: array(namedAddressSchema).optional(),
+  cc: array(namedAddressSchema).optional(),
+  html: string2().optional().describe("The HTML body."),
+  links: array(string2()).describe("The links of the email, in order: HTML anchors, then images, then bare URLs of the plain text body. Follow one to confirm a sign-up or reset a password."),
+  replyTo: array(namedAddressSchema).optional(),
+  text: string2().optional().describe("The plain text body.")
+}, { urlFieldDescription: emailUrlFieldDescription });
+
 // node_modules/@qawolf/api-contracts/dist/v1/identity/organization.js
 var identityOrganization = object({
   id: string2(),
@@ -6802,14 +6846,6 @@ var defaultIdSchemas = {
   workspace: string2().min(1).describe("The id of the workspace.")
 };
 
-// node_modules/@qawolf/api-contracts/dist/v1/resource.js
-function resource(fields, { urlFieldDescription = "Absolute URL." } = {}) {
-  return object({
-    ...fields,
-    url: url().describe(urlFieldDescription)
-  });
-}
-
 // node_modules/@qawolf/api-contracts/dist/v1/run/flowSelection.js
 var makeFlowSelectionSchema = (ids) => object({
   flowIds: array(ids.flow).default([]),
@@ -7344,6 +7380,131 @@ var makeAutomateContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/pagination.js
+var makePaginationInputFields = (limits) => ({
+  cursor: string2().min(1).optional().describe("Opaque cursor copied from the previous response's nextCursor. Omit to fetch the first page."),
+  limit: number2().int().min(1).max(limits.maxLimit).default(limits.defaultLimit).describe(`Maximum rows per page. Defaults to ${limits.defaultLimit}, capped at ${limits.maxLimit}.`)
+});
+var nextCursorSchema = string2().min(1).optional().describe("Repeat the request with this value as cursor to fetch the next page. Absent when there are no further results.");
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/find.js
+var makeFindEmailsContract = (ids) => {
+  const input = object({
+    address: email2().optional().describe("Only emails delivered to this exact address (inbound) or sent from it (outbound). Mail to a plus-suffixed address such as inbox+abc@example.com is found by that full address, not by inbox@example.com."),
+    createdAfter: exports_iso.datetime({ offset: true }).optional().describe("Only include emails received or sent after this instant, e.g. since a flow submitted a sign-up form."),
+    direction: emailDirectionSchema.default("inbound").describe("inbound lists the mail the workspace received: its inbox. outbound lists the mail it sent."),
+    workspaceId: ids.workspace.optional().describe("The workspace whose emails to list. Required when authenticating with an organization or user API key."),
+    ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 50 })
+  });
+  const output = object({
+    emails: array(resource(makeEmailSummaryFields(), {
+      urlFieldDescription: emailUrlFieldDescription
+    })).describe("The workspace's emails, newest first. Bodies are available via email.get."),
+    nextCursor: nextCursorSchema
+  });
+  return {
+    description: "List the workspace's inbox, or its sent mail, newest first. Read a message body with email.get.",
+    input,
+    kind: "read",
+    name: "email.find",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/get.js
+var makeGetEmailContract = (ids) => {
+  const input = object({
+    id: string2().min(1).describe("The id of the email, from email.find."),
+    workspaceId: ids.workspace.optional().describe("The workspace the email belongs to. Required when authenticating with an organization or user API key.")
+  });
+  const output = makeEmailResourceSchema();
+  return {
+    description: "Read one email of the workspace, with its plain text and HTML bodies. Use it to pull a sign-in code or a verification link out of a message.",
+    input,
+    kind: "read",
+    name: "email.get",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/getAttachment.js
+var makeGetEmailAttachmentContract = (ids) => {
+  const input = object({
+    fileName: string2().min(1).optional().describe("The attachment's file name, as email.get lists it. The first attachment with that name is returned."),
+    id: string2().min(1).describe("The id of the email, from email.find."),
+    index: number2().int().min(0).optional().describe("The attachment's position in the email, from 0, as email.get lists it. Use it when file names repeat."),
+    workspaceId: ids.workspace.optional().describe("The workspace the email belongs to. Required when authenticating with an organization or user API key.")
+  }).refine((input) => input.fileName === undefined !== (input.index === undefined), { message: "Provide fileName or index, not both." });
+  const output = resource({
+    contentBase64: string2().describe("The file content, base64 encoded."),
+    fileName: string2(),
+    index: number2().int().min(0).describe("The position of the attachment in the email, from 0."),
+    type: string2().optional().describe("The MIME type.")
+  }, { urlFieldDescription: emailUrlFieldDescription });
+  return {
+    description: "Read one attachment of a workspace email as base64 content, by file name or by position. email.get lists both.",
+    input,
+    kind: "read",
+    name: "email.getAttachment",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/listAddresses.js
+var makeListEmailAddressesContract = (ids) => {
+  const input = object({
+    workspaceId: ids.workspace.optional().describe("The workspace whose inbox addresses to list. Required when authenticating with an organization or user API key."),
+    ...makePaginationInputFields({ defaultLimit: 20, maxLimit: 50 })
+  });
+  const output = object({
+    addresses: array(resource({
+      address: string2().describe("The inbox address. Mail sent to any plus-suffixed form, such as inbox+abc@example.com, lands in the same inbox."),
+      isDefault: boolean2().describe("Whether this is the workspace's default inbox address.")
+    }, { urlFieldDescription: emailUrlFieldDescription })).describe("The workspace's permanent inbox addresses, alphabetical."),
+    nextCursor: nextCursorSchema
+  });
+  return {
+    description: "List the workspace's inbox addresses, alphabetical. A flow can sign up with a plus-suffixed form of any of them, and email.find reads what arrives.",
+    input,
+    kind: "read",
+    name: "email.listAddresses",
+    output
+  };
+};
+
+// node_modules/@qawolf/api-contracts/dist/v1/email/send.js
+var recipientsSchema = array(email2()).max(50);
+var maxAttachments = 10;
+var maxEmailAttachmentsBase64Length = 30 * 1024 * 1024;
+var attachmentsBase64Length = (attachments) => Object.values(attachments).reduce((total, content) => total + content.length, 0);
+var makeSendEmailContract = (ids) => {
+  const input = object({
+    attachments: record(string2().min(1), base642()).refine((attachments) => Object.keys(attachments).length <= maxAttachments, { message: `Send at most ${maxAttachments} attachments.` }).refine((attachments) => attachmentsBase64Length(attachments) <= maxEmailAttachmentsBase64Length, { message: "Send at most 30 MB of attachments." }).optional().describe("Files to attach, as file name to base64 content, at most 30 MB in total. The MIME type comes from the file name's extension."),
+    bcc: recipientsSchema.optional(),
+    cc: recipientsSchema.optional(),
+    from: email2().optional().describe("The workspace inbox address to send from, or a plus-suffixed form of one. Defaults to the workspace's default inbox address. See email.listAddresses."),
+    html: string2().optional().describe("The HTML body."),
+    inReplyTo: string2().min(1).optional().describe("The id of an email of the workspace to reply to, from email.find. The reply threads under that message."),
+    replyTo: recipientsSchema.optional().describe("Where replies should go instead of the from address."),
+    subject: string2().min(1),
+    text: string2().optional().describe("The plain text body."),
+    to: recipientsSchema.min(1),
+    workspaceId: ids.workspace.optional().describe("The workspace to send from. Required when authenticating with an organization or user API key.")
+  }).refine((email) => email.html || email.text, {
+    message: "Provide text, html, or both."
+  });
+  const output = resource(makeEmailSummaryFields(), {
+    urlFieldDescription: emailUrlFieldDescription
+  });
+  return {
+    description: "Send an email from one of the workspace's inbox addresses, for example to exercise a flow that reacts to incoming mail. Returns the sent email; read it back with email.get.",
+    input,
+    kind: "write",
+    name: "email.send",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/environment/deleteVariable.js
 var makeDeleteEnvironmentVariableContract = (ids) => {
   const input = object({
@@ -7362,13 +7523,6 @@ var makeDeleteEnvironmentVariableContract = (ids) => {
   };
 };
 
-// node_modules/@qawolf/api-contracts/dist/v1/pagination.js
-var makePaginationInputFields = (limits) => ({
-  cursor: string2().min(1).optional().describe("Opaque cursor copied from the previous response's nextCursor. Omit to fetch the first page."),
-  limit: number2().int().min(1).max(limits.maxLimit).default(limits.defaultLimit).describe(`Maximum rows per page. Defaults to ${limits.defaultLimit}, capped at ${limits.maxLimit}.`)
-});
-var nextCursorSchema = string2().min(1).optional().describe("Repeat the request with this value as cursor to fetch the next page. Absent when there are no further results.");
-
 // node_modules/@qawolf/api-contracts/dist/v1/environment/resource.js
 var makeEnvironmentResourceSchema = (ids) => resource({
   alias: string2().optional().describe("The environment's alias: a team-unique slug that team API keys can use in place of the id. Terminated environments have none."),
@@ -7540,15 +7694,27 @@ var makeCreateTagContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/flow/skippedFlows.js
+var makeSkippedFlowsSchema = (ids, { description, reason }) => array(object({
+  flowId: ids.flow,
+  name: string2().describe("The name of the flow."),
+  reason
+})).describe(description);
+
 // node_modules/@qawolf/api-contracts/dist/v1/flow/addTag.js
 var makeAddTagToFlowsContract = (ids) => {
   const input = object({
     flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").describe("The flows that receive the tag."),
     tagName: string2().trim().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: _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",
@@ -7588,6 +7754,27 @@ var makeListFlowsContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/flow/removeTag.js
+var makeRemoveTagFromFlowsContract = (ids) => {
+  const input = object({
+    flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").describe("The flows that lose the tag."),
+    tagName: string2().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: _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
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/flow/update.js
 var makeUpdateFlowContract = (ids) => {
   const input = object({
@@ -7732,6 +7919,24 @@ var makeCreateIssueContract = (ids) => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/issue/removeFlows.js
+var makeRemoveFlowsFromIssueContract = (ids) => {
+  const input = object({
+    flowIds: array(ids.flow).min(1).max(300).refine((flowIds) => new Set(flowIds).size === flowIds.length, "flowIds must be unique").describe("The flows the coverage request no longer covers."),
+    issueId: ids.issue
+  });
+  const output = object({
+    issue: makeIssueResourceSchema(ids)
+  });
+  return {
+    description: "Remove flows from a coverage request owned by the caller's team. " + "Flows the request does not cover are left alone. " + "Bug and maintenance reports link to flows through the runs that reproduce them, so their flows cannot be set directly.",
+    input,
+    kind: "write",
+    name: "issue.removeFlows",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/issue/update.js
 var makeUpdateIssueContract = (ids) => {
   const descriptionSchema = string2().describe("The issue description as plain text; each line becomes a paragraph. Markdown is not parsed.");
@@ -8058,6 +8263,22 @@ var makeTerminateRunnerContract = () => {
   };
 };
 
+// node_modules/@qawolf/api-contracts/dist/v1/runner/list.js
+var makeListRunnersContract = () => {
+  const input = object({});
+  const output = object({
+    outcome: literal("success"),
+    runners: array(makeRunnerSchema()).describe("The runners running right now, in no particular order. Each entry carries the same fields a launch reports, so any of them can be addressed like a runner you launched yourself.")
+  });
+  return {
+    description: "List the runners running on the caller's team right now. Takes no arguments: the API key already names the team. A runner that was terminated, or that terminated on its own after inactivity, is not listed, because the run system keeps no record of a runner once it is gone. This is a lookup: it never starts a runner, and it does not reset a runner's inactivity clock the way reading its journal does. It is how to find a runner launched from another machine or in an earlier session, when the id it was launched under is no longer at hand.",
+    input,
+    kind: "read",
+    name: "runner.list",
+    output
+  };
+};
+
 // node_modules/@qawolf/api-contracts/dist/v1/runner/promoteSnapshot.js
 var maxSnapshotPathLength = 1024;
 var makePromoteSnapshotOnRunnerContract = () => {
@@ -8253,6 +8474,13 @@ var makeContractsV1 = (ids) => {
       send: makeAgentSendContract(resolvedIds)
     },
     automate: makeAutomateContract(resolvedIds),
+    email: {
+      find: makeFindEmailsContract(resolvedIds),
+      get: makeGetEmailContract(resolvedIds),
+      getAttachment: makeGetEmailAttachmentContract(resolvedIds),
+      listAddresses: makeListEmailAddressesContract(resolvedIds),
+      send: makeSendEmailContract(resolvedIds)
+    },
     environment: {
       create: makeCreateEnvironmentContract(resolvedIds),
       deleteVariable: makeDeleteEnvironmentVariableContract(resolvedIds),
@@ -8266,6 +8494,7 @@ var makeContractsV1 = (ids) => {
     flow: {
       addTag: makeAddTagToFlowsContract(resolvedIds),
       list: makeListFlowsContract(resolvedIds),
+      removeTag: makeRemoveTagFromFlowsContract(resolvedIds),
       update: makeUpdateFlowContract(resolvedIds)
     },
     issue: {
@@ -8273,6 +8502,7 @@ var makeContractsV1 = (ids) => {
       create: makeCreateIssueContract(resolvedIds),
       find: makeFindIssuesContract(resolvedIds),
       get: makeGetIssueContract(resolvedIds),
+      removeFlows: makeRemoveFlowsFromIssueContract(resolvedIds),
       update: makeUpdateIssueContract(resolvedIds)
     },
     run: {
@@ -8290,6 +8520,7 @@ var makeContractsV1 = (ids) => {
       inspect: makeInspectOnRunnerContract(),
       inspectMobile: makeInspectMobileOnRunnerContract(),
       launch: makeLaunchRunnerContract(),
+      list: makeListRunnersContract(),
       performAction: makePerformActionOnRunnerContract(),
       promoteSnapshot: makePromoteSnapshotOnRunnerContract(),
       readJournal: makeReadRunnerJournalContract(),
@@ -8306,20 +8537,6 @@ var makeContractsV1 = (ids) => {
 };
 var publicContractsV1 = makeContractsV1(defaultIdSchemas);
 
-// src/core/batchMap.ts
-async function* batchMap(items, fn, size) {
-  if (size < 1) {
-    throw new Error("batchMap size must be greater than 0");
-  }
-  for (let i = 0;i < items.length; i += size) {
-    const batch = items.slice(i, i + size);
-    const results = await Promise.all(batch.map(fn));
-    for (const result of results) {
-      yield result;
-    }
-  }
-}
-
 // src/core/formatSeconds.ts
 function formatSeconds(ms) {
   return `${Math.round(ms / 1000)}s`;
@@ -8628,7 +8845,8 @@ var lifecycleMessages = {
 
 // src/core/messages/interactiveRunner/list.ts
 var listMessages = {
-  noRunners: "This directory has no runner running. Launch one with qawolf runner launch, or pass --runner to address a runner started elsewhere.",
+  noRunners: "Your team has no runner running. Launch one with qawolf runner launch.",
+  noRunnersHere: "This directory has no runner running. Launch one with qawolf runner launch, or drop --here to see the whole team's runners.",
   runnerCount: (count) => count === 1 ? "1 runner" : `${String(count)} runners`,
   title: "Runners"
 };
@@ -8776,50 +8994,37 @@ var runnerCallOptions = { timeoutMs: 90000 };
 var runnerIdEnvironmentVariable = "QAWOLF_RUNNER_ID";
 
 // src/domains/interactiveRunner/list.ts
-var probeBatchSize = 8;
-async function readCandidates(deps) {
-  const held = await deps.store.readRunners();
-  const storedDefault = await deps.store.readDefaultRunnerId();
-  const environmentValue = deps.env[runnerIdEnvironmentVariable]?.trim();
-  const fromEnvironment = environmentValue ? environmentValue : undefined;
-  const candidates = [...held];
-  for (const id of [storedDefault, fromEnvironment]) {
-    if (id !== undefined && !candidates.some((runner) => runner.id === id)) {
-      candidates.push({ id });
-    }
-  }
-  return { candidates, defaultRunnerId: fromEnvironment ?? storedDefault };
+function rank(item) {
+  if (item.isDefault)
+    return 0;
+  return item.launchedHere ? 1 : 2;
 }
-async function probeRunner(ctx, runner) {
-  const result = await ctx.platformClient.callPublicApi(publicContractsV1.runner.get, { id: runner.id }, runnerCallOptions);
-  if (!result.ok)
-    return { ...failureFields(result), ok: false };
-  return { ok: true, runner, running: result.value.running };
+async function readDefaultRunnerId(deps) {
+  const environmentValue = deps.env[runnerIdEnvironmentVariable]?.trim();
+  if (environmentValue)
+    return environmentValue;
+  return deps.store.readDefaultRunnerId();
 }
 async function listRunners(ctx, deps) {
-  const { candidates, defaultRunnerId } = await readCandidates(deps);
-  const running = [];
-  const gone = [];
-  for await (const probe of batchMap(candidates, (runner) => probeRunner(ctx, runner), probeBatchSize)) {
-    if (!probe.ok)
-      return { ...failureFields(probe), ok: false };
-    if (probe.running)
-      running.push(probe.runner);
-    else
-      gone.push(probe.runner.id);
-  }
+  const listed = await ctx.platformClient.callPublicApi(publicContractsV1.runner.list, {}, runnerCallOptions);
+  if (!listed.ok)
+    return { ...failureFields(listed), ok: false };
+  const defaultRunnerId = await readDefaultRunnerId(deps);
+  const runningIds = new Set(listed.value.runners.map((runner) => runner.id));
+  const held = await deps.store.readRunners();
+  const gone = held.filter((runner) => !runningIds.has(runner.id)).map((runner) => runner.id);
   await deps.store.dropRunners(gone).catch(() => {
     return;
   });
+  const heldIds = new Set(held.map((runner) => runner.id));
+  const items = listed.value.runners.map((runner) => ({
+    id: runner.id,
+    isDefault: runner.id === defaultRunnerId,
+    launchedHere: heldIds.has(runner.id),
+    runnerName: runner.runnerName
+  }));
   return {
-    items: [
-      ...running.filter((runner) => runner.id === defaultRunnerId),
-      ...running.filter((runner) => runner.id !== defaultRunnerId)
-    ].map((runner) => ({
-      id: runner.id,
-      isDefault: runner.id === defaultRunnerId,
-      runnerName: runner.runnerName
-    })),
+    items: items.sort((left, right) => rank(left) - rank(right) || left.id.localeCompare(right.id)),
     ok: true
   };
 }
@@ -12394,4 +12599,4 @@ export {
   createRunnerSdk
 };
 
-//# debugId=57D8825DED309B1264756E2164756E21
+//# debugId=231C026DA9D7E0DD64756E2164756E21

package/dist/types/runnerSdk/types.d.ts

@@ -108,11 +108,15 @@ export type SubmittedRun = {
     fileSync: FileSync;
     runId: string;
 };
-/** Runners this working directory launched, which the API has no notion of. */
+/**
+ * A runner running on the team. `isDefault` and `launchedHere` are this working
+ * directory's own knowledge, which the API has no notion of.
+ */
 export type ListedRunner = {
     id: string;
     isDefault: boolean;
-    runnerName: string | undefined;
+    launchedHere: boolean;
+    runnerName: string;
 };
 export type KeptAlive = {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qawolf/cli",
-  "version": "1.23.0",
+  "version": "1.24.0",
   "description": "Run and manage QA Wolf flows from the terminal, CI, or an AI agent",
   "keywords": [
     "automation",
@@ -71,7 +71,7 @@
     "@clack/prompts": "1.5.1",
     "@napi-rs/keyring": "1.3.0",
     "@oxc-node/core": "0.1.0",
-    "@qawolf/api-contracts": "0.40.0",
+    "@qawolf/api-contracts": "0.47.0",
     "@qawolf/emails": "1.1.1",
     "@qawolf/flow-targets": "1.0.0",
     "@qawolf/flows": "0.1.4",

package/skills/qawolf-cli/SKILL.md

@@ -132,6 +132,11 @@ that `url`; never guess a route and never send a repository link in its place.
 | `qawolf auth whoami` | read | Show authentication status |
 | `qawolf automate` | write | 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. |
 | `qawolf doctor` | local | Diagnose problems running flows locally |
+| `qawolf email find` | read | List the workspace's inbox, or its sent mail, newest first. Read a message body with email.get. |
+| `qawolf email get` | read | Read one email of the workspace, with its plain text and HTML bodies. Use it to pull a sign-in code or a verification link out of a message. |
+| `qawolf email getAttachment` | read | Read one attachment of a workspace email as base64 content, by file name or by position. email.get lists both. |
+| `qawolf email listAddresses` | read | List the workspace's inbox addresses, alphabetical. A flow can sign up with a plus-suffixed form of any of them, and email.find reads what arrives. |
+| `qawolf email send` | write | Send an email from one of the workspace's inbox addresses, for example to exercise a flow that reacts to incoming mail. Returns the sent email; read it back with email.get. |
 | `qawolf environment create` | write | Create an environment on the caller's team and return it in the environment.get shape. |
 | `qawolf environment deleteVariable` | write | Remove one environment variable by name. Succeeds whether or not the variable existed. |
 | `qawolf environment find` | read | List the team's environments, newest first. |
@@ -140,7 +145,8 @@ that `url`; never guess a route and never send a repository link in its place.
 | `qawolf environment listVariableNames` | read | Use this to answer which QA Wolf environment variables are available to test code. Returns names only; values never leave the server. |
 | `qawolf environment setVariable` | write | Create or replace an environment variable. If the user asks to create one for "my email" without naming it, use DEFAULT_EMAIL. The value is never returned. |
 | `qawolf environment update` | write | Update an environment owned by the caller's team and return it in the environment.get shape. Omitted fields remain unchanged. |
-| `qawolf flow addTag` | write | Assign an existing tag to the selected flows. Create tags with tag.create. |
+| `qawolf flow addTag` | write | Assign an existing tag to the selected flows. Create tags with tag.create. Flows that already carry the tag are reported in skippedFlows. |
+| `qawolf flow removeTag` | write | 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. |
 | `qawolf flow update` | write | Move a flow between draft and active readiness. The other statuses shown in the app are derived and cannot be set. |
 | `qawolf flows list` | local (read with --remote) | List flows matching [pattern] from the local project, or from a QA Wolf environment with --remote |
 | `qawolf flows pull` | read | Download an environment's flows into the local .qawolf/<env>/ cache |
@@ -154,6 +160,7 @@ that `url`; never guess a route and never send a repository link in its place.
 | `qawolf issue create` | write | Create a bug or coverage request issue for the caller's team. Maintenance issues cannot be created through the public API. |
 | `qawolf issue find` | read | List the team's bug reports, maintenance reports, or coverage requests, newest first. |
 | `qawolf issue get` | read | Get an issue by id. |
+| `qawolf issue removeFlows` | write | Remove flows from a coverage request owned by the caller's team. Flows the request does not cover are left alone. Bug and maintenance reports link to flows through the runs that reproduce them, so their flows cannot be set directly. |
 | `qawolf issue update` | write | Update an issue owned by the caller's team. Omitted fields remain unchanged. |
 | `qawolf run create` | write | Create a run for the selected flows and/or tags in an environment. |
 | `qawolf run diagnose` | write | Diagnose failed flows in a run as reproductions of a bug or maintenance report owned by the caller's team. The issue's type selects the diagnosis. Each flow must have failed in the run. A flow that is already diagnosed moves to this issue. The diagnosis appears on the run, and the reproduction appears under the issue's reproductions. Coverage requests cannot be diagnosed; use issue.addFlows to cover flows instead. |
@@ -174,7 +181,7 @@ that `url`; never guess a route and never send a repository link in its place.
 | `qawolf runner inspect variable` | read | Print a top-level variable's value from the running workflow |
 | `qawolf runner keepalive` | read | Reset a runner's inactivity clock, for a caller that pauses between actions |
 | `qawolf runner launch` | write | Launch an interactive runner and make it this directory's default |
-| `qawolf runner list` | read | List the runners this directory holds that are still running |
+| `qawolf runner list` | read | List the runners running on your team |
 | `qawolf runner promote-snapshot` | write | Accept a run's screenshot as the new baseline for an image diff, on the runner that produced it |
 | `qawolf runner run` | write | Run a flow on an interactive runner, shipping the flow and what it imports |
 | `qawolf runner screenshot` | read | Save a JPEG of an interactive runner's screen to a file |