@outerlayer/cli 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @outerlayer/cli
 
+## 0.10.0
+
+### Minor Changes
+
+- 60067bc: `outerlayer work pr` and `outerlayer work open-pr` now declare a pull request onto the work item named by `OUTERLAYER_WORK`, and refuse when the session is not on that item. The message names both item numbers and `--session-id`. A successful declaration prints the item's number and title. `outerlayer work pr <n> --withdraw --item <number>` removes a wrong declaration.
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -74,8 +74,10 @@ content:
   hook spawns `outerlayer work link-session` when you launch a session with
   `OUTERLAYER_WORK`, naming the item and the session id — the item itself
   must already exist, created ahead of time with `outerlayer work build --local`.
-  `outerlayer work pr` sends the session id and the pull request number and
-  repository — never the session's own content. `outerlayer work open-pr`
+  `outerlayer work pr` sends the session id, the `OUTERLAYER_WORK` item
+  number and the pull request number and repository — never the session's
+  own content. With `--withdraw` it sends a DELETE naming the item, the
+  repository and the pull request number. `outerlayer work open-pr`
   sends the pull request's title and the text of the body file you name. In a
   host build, which holds an item key, it goes to the gateway, which opens or
   edits the pull request as the factory's GitHub App on the branch the claim
@@ -375,7 +377,7 @@ before it gives up.
 | `outerlayer work remove --issue <n>\|--pr <n> --reason <text> [--repo]` | Withdraws the caller's own addition, recording the reason. Never deletes anything; the item leaves the Work page only once no live addition remains on it. Removing again is a no-op that still succeeds. |
 | `outerlayer work status --issue <n>\|--pr <n> [--repo]` | Shows one item's stage, section, gate ledger, linked pull requests and sessions, and its additions. |
 | `outerlayer work list [--stage] [--section] [--repo] [--claimed] [--unclaimed] [--startable] [--needs amend]` | Lists live work items for the current factory, filterable by stage, section, claim state, startability and whether a comment thread is waiting on an agent. |
-| `outerlayer work pr <n> [--repo] [--session-id]` | Run inside a session on a work item: declares that pull request `<n>` in the checkout's repository belongs to that item. Idempotent — declaring the same pull request twice is a no-op. Refuses when the session is on no item, or the repository is not connected. |
+| `outerlayer work pr <n> [--repo] [--session-id] [--withdraw --item <number>]` | Run inside a session on a work item: declares that pull request `<n>` in the checkout's repository belongs to the `OUTERLAYER_WORK` item. Idempotent — declaring the same pull request twice is a no-op. Refuses when the session is not on that item, or the repository is not connected. `--withdraw --item <number>` removes that item's declaration; it needs your own login. |
 | `outerlayer work open-pr --title <text> --body-file <path> [--repo] [--session-id] [--json]` | Opens the pull request for the work item this session is on, or edits the one already open on its branch. A host build, which holds an item key, sends it to the gateway, which opens it as the factory's GitHub App from the branch the claim named; no `gh` command runs. Your own session runs `gh pr create` or `gh pr edit` under your login and then declares the pull request on the item. Run it again after changing the title or description. |
 | `outerlayer work claim --item <n>\|--issue <n> --kind implement\|amend [--repo] [--host] [--seconds]` | Records a lease for this host (default: its own hostname), so two hosts never build the same item at once. The lease belongs to the runner key that claimed it: a live lease held by a different key is refused, even under the same host name, and claiming again with the same key extends it. The first claim creates the host key (`host-key.pem` beside the config file) and binds the runner key to it; from then on every request made with that key is signed. Lease length defaults to 900 seconds, the server's own cap. |
 | `outerlayer work renew --item <n>\|--issue <n> [--repo] [--host] [--seconds]` | Extends this host's own live lease. Refused if the lease has expired, or if a different runner key holds it (403 `claim_not_held`). |

package/dist/build-info.json

@@ -1 +1 @@
-{"id":"2026-10-07T00:34:36.863Z+f427d9c","root":"/home/runner/_work/outerlayer/outerlayer","pkg":"outerlayer"}
+{"id":"2026-10-07T12:35:00.915Z+be9473d","root":"/home/runner/_work/outerlayer/outerlayer","pkg":"outerlayer"}

package/dist/chunk-5K3IUOPJ.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { autoConnect } from './chunk-KPUJGBA4.js';
+import { detectActiveSession } from './chunk-BFESLKPP.js';
+import { resolveRepoIdentity } from './chunk-LTJPX7TX.js';
+import { parseWorkItemEnv } from './chunk-GQD22KKN.js';
+import { parseTrackerNumber, trackerNumberError } from './chunk-WZBHBH3J.js';
+import { defaultFetch } from './chunk-YO4PSLVB.js';
+import { unauthorizedMessage, resolveGatewayCredentials } from './chunk-PLMTLGYH.js';
+import { homeFromEnv } from './chunk-VNVZDWO3.js';
+
+createRequire(import.meta.url);
+
+// src/work-pr-cmd.ts
+var GREEN = "\x1B[32m";
+var DIM = "\x1B[2m";
+var RESET = "\x1B[0m";
+var WorkPrCommandError = class extends Error {
+};
+function resolveCredentials(opts) {
+  const resolved = resolveGatewayCredentials(opts);
+  if (!resolved.ok) throw new WorkPrCommandError(resolved.message);
+  return { url: resolved.url, apiKey: resolved.credential, appId: resolved.appId };
+}
+function resolveRepository(repoFlag, cwd) {
+  if (repoFlag) return repoFlag;
+  const identity = resolveRepoIdentity(cwd);
+  if (identity.gitRepo) return identity.gitRepo;
+  throw new WorkPrCommandError(
+    "no repository. Pass --repo <owner/name>, or run from a git checkout with a remote."
+  );
+}
+function resolvePrNumber(raw) {
+  const n = parseTrackerNumber(raw);
+  if (n === void 0) throw new WorkPrCommandError(trackerNumberError("<n>", raw ?? ""));
+  return n;
+}
+var SESSION_ID_HINT = "pass --session-id <id> to name the session that was launched on the item";
+function sessionNotOnItemMessage(error, sessionId) {
+  const on = error.sessionItems;
+  const onText = on === void 0 ? "" : `; it is on ${on.length === 0 ? "no work item" : on.map((n) => `item ${n}`).join(", ")}`;
+  return `session ${sessionId} is not on item ${error.workItem ?? "?"} (OUTERLAYER_WORK)${onText}. Nothing was declared. If another session was launched for item ${error.workItem ?? "?"}, ${SESSION_ID_HINT}.`;
+}
+function itemLabel(data) {
+  if (data.workItemNumber == null) return data.workItemId;
+  return data.workItemTitle ? `item ${data.workItemNumber} ${DIM}\xB7${RESET} ${data.workItemTitle}` : `item ${data.workItemNumber}`;
+}
+async function runWorkPrWithdraw(opts, ctx) {
+  const itemNumber = parseTrackerNumber(opts.item);
+  if (itemNumber === void 0) {
+    throw new WorkPrCommandError("--withdraw needs --item <number>, the item to remove the declaration from.");
+  }
+  const { creds, prNumber, repository, sessionId } = ctx;
+  const fetchImpl = opts.fetchImpl ?? defaultFetch;
+  const query = sessionId === void 0 ? "" : `?sessionId=${encodeURIComponent(sessionId)}`;
+  const endpoint = new URL(
+    `/v1/work-items/${itemNumber}/pull-requests/${encodeURIComponent(repository)}/${prNumber}${query}`,
+    creds.url
+  ).toString();
+  let response;
+  try {
+    response = await fetchImpl(endpoint, {
+      method: "DELETE",
+      headers: { authorization: `Bearer ${creds.apiKey}`, "x-outerlayer-app-id": creds.appId }
+    });
+  } catch (err) {
+    throw new WorkPrCommandError(`network error reaching ${endpoint}: ${String(err)}`);
+  }
+  if (response.status === 401) throw new WorkPrCommandError(unauthorizedMessage(creds.apiKey));
+  let json;
+  try {
+    json = await response.json();
+  } catch {
+    throw new WorkPrCommandError(
+      `${endpoint} answered ${response.status} with a body that is not JSON \u2014 the request may not have reached the gateway`
+    );
+  }
+  if (!response.ok || !json.data) {
+    if (json.error?.code === "withdraw_needs_person") {
+      throw new WorkPrCommandError("only a person can withdraw a declaration; run this from your own login, not an agent session or a factory key.");
+    }
+    if (json.error?.code === "declaration_not_found") {
+      throw new WorkPrCommandError(`item ${itemNumber} has no declaration of ${repository}#${prNumber}.`);
+    }
+    if (json.error?.code === "work_item_not_found") {
+      throw new WorkPrCommandError(`item ${itemNumber} does not exist in this factory.`);
+    }
+    throw new WorkPrCommandError(json.error?.message ?? `request failed (${response.status})`);
+  }
+  const data = json.data;
+  const output = opts.json ? JSON.stringify(data) : `${GREEN}\u2713${RESET} withdrawn ${DIM}\xB7${RESET} ${data.repository}#${data.prNumber} ${DIM}from${RESET} item ${itemNumber}`;
+  if (!opts.quiet) process.stdout.write(output + "\n");
+  return { data, output };
+}
+async function runWorkPr(opts) {
+  const cwd = opts.cwd ?? process.cwd();
+  const env = opts.env ?? process.env;
+  const home = opts.home ?? homeFromEnv(env);
+  const refusal = await autoConnect({ ...opts, repository: opts.repo });
+  if (refusal !== void 0) throw new WorkPrCommandError(refusal);
+  const creds = resolveCredentials(opts);
+  const prNumber = resolvePrNumber(opts.number);
+  const repository = resolveRepository(opts.repo, cwd);
+  const identity = resolveRepoIdentity(cwd);
+  const sessionId = opts.sessionId ?? detectActiveSession({
+    env,
+    home,
+    cwds: identity.repoRoot !== void 0 ? [identity.repoRoot, cwd] : [cwd],
+    nowMs: Date.now()
+  });
+  if (opts.withdraw) return runWorkPrWithdraw(opts, { creds, prNumber, repository, sessionId });
+  let workItem;
+  if (env.OUTERLAYER_WORK !== void 0) {
+    const parsed = parseWorkItemEnv(env.OUTERLAYER_WORK);
+    if (!("number" in parsed)) throw new WorkPrCommandError(parsed.reason);
+    workItem = parsed.number;
+  }
+  if (sessionId === void 0) {
+    throw new WorkPrCommandError(
+      `no active session detected. \`work pr\` declares a pull request from inside the session that opened it, or ${SESSION_ID_HINT}.`
+    );
+  }
+  const fetchImpl = opts.fetchImpl ?? defaultFetch;
+  const headers = {
+    "content-type": "application/json",
+    authorization: `Bearer ${creds.apiKey}`,
+    "x-outerlayer-app-id": creds.appId
+  };
+  const endpoint = new URL("/v1/work-items/pull-requests", creds.url).toString();
+  let response;
+  try {
+    response = await fetchImpl(endpoint, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        sessionId,
+        workItem,
+        // JSON.stringify omits it when undefined
+        pullRequest: { repository, number: prNumber }
+      })
+    });
+  } catch (err) {
+    throw new WorkPrCommandError(`network error reaching ${endpoint}: ${String(err)}`);
+  }
+  if (response.status === 401) {
+    throw new WorkPrCommandError(
+      unauthorizedMessage(creds.apiKey)
+    );
+  }
+  let json;
+  try {
+    json = await response.json();
+  } catch {
+    throw new WorkPrCommandError(
+      `${endpoint} answered ${response.status} with a body that is not JSON \u2014 the request may not have reached the gateway`
+    );
+  }
+  if (!response.ok || !json.data) {
+    if (json.error?.code === "session_not_on_item") {
+      if (response.status === 409) throw new WorkPrCommandError(sessionNotOnItemMessage(json.error, sessionId));
+      throw new WorkPrCommandError("this session is not launched on a work item.");
+    }
+    if (json.error?.code === "work_item_not_found" && workItem !== void 0) {
+      throw new WorkPrCommandError(`OUTERLAYER_WORK names item ${workItem}, which does not exist in this factory.`);
+    }
+    if (json.error?.code === "repository_not_connected") {
+      throw new WorkPrCommandError(`${repository} is not a workpiece of this factory.`);
+    }
+    throw new WorkPrCommandError(json.error?.message ?? `request failed (${response.status})`);
+  }
+  const data = json.data;
+  const verb = data.created ? "declared" : "already declared";
+  const output = opts.json ? JSON.stringify(data) : `${GREEN}\u2713${RESET} ${verb} ${DIM}\xB7${RESET} ${data.repository}#${data.prNumber} ${DIM}\u2192${RESET} ${itemLabel(data)}`;
+  if (!opts.quiet) process.stdout.write(output + "\n");
+  return { data, output };
+}
+
+export { WorkPrCommandError, itemLabel, runWorkPr };

package/dist/{cli-7RQYILJT.js → cli-77URFYI7.js}

@@ -4413,12 +4413,12 @@ live addition remains on it.
       throw err;
     }
   });
-  workCmd.command("pr <number>").description("Declare that a pull request belongs to the work item this session is on").option("--repo <owner/name>", "repository (default: the current checkout's remote)").option("--session-id <id>", "session id to record as-is, skipping detection").option("--json", "machine-readable JSON output").option("--url <url>", "cloud base URL (or OUTERLAYER_URL / config)").addOption(apiKeyOption()).option("--app-id <id>", "factory id the key is bound to (or OUTERLAYER_APP_ID / config)").addHelpText(
+  workCmd.command("pr <number>").description("Declare a pull request onto the launched work item, or withdraw it").option("--repo <owner/name>", "repository (default: the current checkout's remote)").option("--session-id <id>", "session id to record as-is, skipping detection").option("--withdraw", "remove the declaration instead of making one (needs --item)").option("--item <number>", "with --withdraw, the item to remove the declaration from").option("--json", "machine-readable JSON output").option("--url <url>", "cloud base URL (or OUTERLAYER_URL / config)").addOption(apiKeyOption()).option("--app-id <id>", "factory id the key is bound to (or OUTERLAYER_APP_ID / config)").addHelpText(
     "after",
-    "\n  outerlayer work pr 481\n\nRun inside a session already on a work item. Records that pull\nrequest 481 in the checkout's repository belongs to that item \u2014 the\nsame fact a `pr-link` in the session's own transcript records on\nsync. Idempotent: declaring the same pull request twice is a no-op.\n"
+    "\n  outerlayer work pr 481\n  outerlayer work pr 481 --withdraw --item 250\n\nRun inside a session already on a work item. Records that pull\nrequest 481 in the checkout's repository belongs to the item named by\nOUTERLAYER_WORK, or refuses when the session is not on it. The same\nfact a `pr-link` in the session's own transcript records on sync.\nIdempotent: declaring the same pull request twice is a no-op.\n\n--withdraw removes one item's declaration of the pull request. It\nneeds your own login; an agent session or a factory key is refused.\n"
   ).action(async (number, opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkPr, WorkPrCommandError } = await import('./work-pr-cmd-MX6UO5GO.js');
+    const { runWorkPr, WorkPrCommandError } = await import('./work-pr-cmd-6TMSCO3Q.js');
     try {
       await runWorkPr({ ...opts, number });
     } catch (err) {
@@ -4434,7 +4434,7 @@ live addition remains on it.
     '\n  outerlayer work open-pr --title "Add the thing" --body-file pr.md\n\nIn a host build, which holds an item key, the gateway opens the pull\nrequest as the factory\'s GitHub App, from the branch the claim named,\nor edits the one already open on that branch. No gh command runs.\nIn your own session it runs `gh pr create` (or `gh pr edit`) under your\nlogin, then declares the pull request on the item, as `work pr` does.\nRun it again after a change to the title or description.\n'
   ).action(async (opts) => {
     warnIfApiKeyFlag(opts);
-    const { runWorkOpenPr, WorkOpenPrCommandError } = await import('./work-open-pr-cmd-ZYOC5SPB.js');
+    const { runWorkOpenPr, WorkOpenPrCommandError } = await import('./work-open-pr-cmd-YESMWATB.js');
     const { WorkCommandError } = await import('./work-cmd-TK4VOOHL.js');
     try {
       await runWorkOpenPr(opts);

package/dist/index.js

@@ -22,5 +22,5 @@ if (argv[0] === "statusline") {
   process.exit(0);
 }
 (await import('./hook-fast-AQCAQIA6.js')).recordLinkExitFailure(argv);
-var { runCli } = await import('./cli-7RQYILJT.js');
+var { runCli } = await import('./cli-77URFYI7.js');
 await runCli(process.argv);

package/dist/{work-open-pr-cmd-ZYOC5SPB.js → work-open-pr-cmd-YESMWATB.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { runWorkPr, WorkPrCommandError } from './chunk-5MF73XCV.js';
+import { itemLabel, runWorkPr, WorkPrCommandError } from './chunk-5K3IUOPJ.js';
 import { resolveCredentials } from './chunk-KWCJLAHQ.js';
 import './chunk-KPUJGBA4.js';
 import './chunk-BFESLKPP.js';
@@ -10,6 +10,7 @@ import './chunk-LTJPX7TX.js';
 import './chunk-USO2DKBD.js';
 import './chunk-N6LURUEF.js';
 import './chunk-YRYMNBGQ.js';
+import { parseWorkItemEnv } from './chunk-GQD22KKN.js';
 import './chunk-WZBHBH3J.js';
 import { defaultFetch } from './chunk-YO4PSLVB.js';
 import './chunk-PLMTLGYH.js';
@@ -82,6 +83,11 @@ async function openThroughGateway(creds, workItem, title, body, fetchImpl) {
   return json.data;
 }
 async function openWithGh(opts, title, bodyFile, cwd) {
+  const launched = opts.env.OUTERLAYER_WORK;
+  if (launched !== void 0) {
+    const parsed = parseWorkItemEnv(launched);
+    if (!("number" in parsed)) throw new WorkOpenPrCommandError(parsed.reason);
+  }
   const runGh = opts.runGh ?? spawnGh;
   const viewed = runGh(["pr", "view", "--json", "number"], cwd);
   let existing;
@@ -130,7 +136,9 @@ async function openWithGh(opts, title, bodyFile, cwd) {
     repository,
     number,
     url: urlMatch ? urlMatch[0] : `https://${repository.startsWith("github.com/") ? repository : `github.com/${repository}`}/pull/${number}`,
-    created: existing === void 0
+    created: existing === void 0,
+    workItemNumber: declared.data.workItemNumber,
+    workItemTitle: declared.data.workItemTitle
   };
 }
 async function runWorkOpenPr(opts) {
@@ -154,7 +162,7 @@ async function runWorkOpenPr(opts) {
   } else {
     data = await openWithGh({ ...opts, env }, opts.title, opts.bodyFile, cwd);
   }
-  const output = opts.json ? JSON.stringify(data) : `${GREEN}\u2713${RESET} ${data.created ? "opened" : "edited"} ${DIM}\xB7${RESET} ${data.repository}#${data.number} ${DIM}\xB7${RESET} ${data.url}`;
+  const output = opts.json ? JSON.stringify(data) : `${GREEN}\u2713${RESET} ${data.created ? "opened" : "edited"} ${DIM}\xB7${RESET} ${data.repository}#${data.number} ${DIM}\xB7${RESET} ${data.url}${data.workItemNumber == null ? "" : ` ${DIM}\u2192${RESET} ${itemLabel({ workItemId: "", ...data })}`}`;
   if (!opts.quiet) process.stdout.write(output + "\n");
   return { data, output };
 }

package/dist/{work-pr-cmd-MX6UO5GO.js → work-pr-cmd-6TMSCO3Q.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { WorkPrCommandError, runWorkPr } from './chunk-5MF73XCV.js';
+export { WorkPrCommandError, itemLabel, runWorkPr } from './chunk-5K3IUOPJ.js';
 import './chunk-KPUJGBA4.js';
 import './chunk-BFESLKPP.js';
 import './chunk-LYESSQUA.js';
@@ -9,6 +9,7 @@ import './chunk-LTJPX7TX.js';
 import './chunk-USO2DKBD.js';
 import './chunk-N6LURUEF.js';
 import './chunk-YRYMNBGQ.js';
+import './chunk-GQD22KKN.js';
 import './chunk-WZBHBH3J.js';
 import './chunk-YO4PSLVB.js';
 import './chunk-PLMTLGYH.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outerlayer/cli",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "OuterLayer CLI — commands: init, connect, doctor, login, logout, sync, daemon (alias: watch), emit, work, runner, hooks, mcp, import, context. Capture and sync coding-agent sessions, and record proof of factory work.",
   "license": "Apache-2.0",
   "author": "Magu Studios, Inc.",

package/dist/chunk-5MF73XCV.js

@@ -1,103 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from 'node:module';
-import { autoConnect } from './chunk-KPUJGBA4.js';
-import { detectActiveSession } from './chunk-BFESLKPP.js';
-import { resolveRepoIdentity } from './chunk-LTJPX7TX.js';
-import { parseTrackerNumber, trackerNumberError } from './chunk-WZBHBH3J.js';
-import { defaultFetch } from './chunk-YO4PSLVB.js';
-import { unauthorizedMessage, resolveGatewayCredentials } from './chunk-PLMTLGYH.js';
-import { homeFromEnv } from './chunk-VNVZDWO3.js';
-
-createRequire(import.meta.url);
-
-// src/work-pr-cmd.ts
-var GREEN = "\x1B[32m";
-var DIM = "\x1B[2m";
-var RESET = "\x1B[0m";
-var WorkPrCommandError = class extends Error {
-};
-function resolveCredentials(opts) {
-  const resolved = resolveGatewayCredentials(opts);
-  if (!resolved.ok) throw new WorkPrCommandError(resolved.message);
-  return { url: resolved.url, apiKey: resolved.credential, appId: resolved.appId };
-}
-function resolveRepository(repoFlag, cwd) {
-  if (repoFlag) return repoFlag;
-  const identity = resolveRepoIdentity(cwd);
-  if (identity.gitRepo) return identity.gitRepo;
-  throw new WorkPrCommandError(
-    "no repository. Pass --repo <owner/name>, or run from a git checkout with a remote."
-  );
-}
-function resolvePrNumber(raw) {
-  const n = parseTrackerNumber(raw);
-  if (n === void 0) throw new WorkPrCommandError(trackerNumberError("<n>", raw ?? ""));
-  return n;
-}
-async function runWorkPr(opts) {
-  const cwd = opts.cwd ?? process.cwd();
-  const env = opts.env ?? process.env;
-  const home = opts.home ?? homeFromEnv(env);
-  const refusal = await autoConnect({ ...opts, repository: opts.repo });
-  if (refusal !== void 0) throw new WorkPrCommandError(refusal);
-  const creds = resolveCredentials(opts);
-  const prNumber = resolvePrNumber(opts.number);
-  const repository = resolveRepository(opts.repo, cwd);
-  const identity = resolveRepoIdentity(cwd);
-  const sessionId = opts.sessionId ?? detectActiveSession({
-    env,
-    home,
-    cwds: identity.repoRoot !== void 0 ? [identity.repoRoot, cwd] : [cwd],
-    nowMs: Date.now()
-  });
-  if (sessionId === void 0) {
-    throw new WorkPrCommandError(
-      "no active session detected. `work pr` declares a pull request from inside the session that opened it."
-    );
-  }
-  const fetchImpl = opts.fetchImpl ?? defaultFetch;
-  const endpoint = new URL("/v1/work-items/pull-requests", creds.url).toString();
-  let response;
-  try {
-    response = await fetchImpl(endpoint, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        authorization: `Bearer ${creds.apiKey}`,
-        "x-outerlayer-app-id": creds.appId
-      },
-      body: JSON.stringify({ sessionId, pullRequest: { repository, number: prNumber } })
-    });
-  } catch (err) {
-    throw new WorkPrCommandError(`network error reaching ${endpoint}: ${String(err)}`);
-  }
-  if (response.status === 401) {
-    throw new WorkPrCommandError(
-      unauthorizedMessage(creds.apiKey)
-    );
-  }
-  let json;
-  try {
-    json = await response.json();
-  } catch {
-    throw new WorkPrCommandError(
-      `${endpoint} answered ${response.status} with a body that is not JSON \u2014 the request may not have reached the gateway`
-    );
-  }
-  if (!response.ok || !json.data) {
-    if (json.error?.code === "session_not_on_item") {
-      throw new WorkPrCommandError("this session is not launched on a work item.");
-    }
-    if (json.error?.code === "repository_not_connected") {
-      throw new WorkPrCommandError(`${repository} is not a workpiece of this factory.`);
-    }
-    throw new WorkPrCommandError(json.error?.message ?? `request failed (${response.status})`);
-  }
-  const data = json.data;
-  const verb = data.created ? "declared" : "already declared";
-  const output = opts.json ? JSON.stringify(data) : `${GREEN}\u2713${RESET} ${verb} ${DIM}\xB7${RESET} ${data.repository}#${data.prNumber} ${DIM}\u2192${RESET} ${data.workItemId}`;
-  if (!opts.quiet) process.stdout.write(output + "\n");
-  return { data, output };
-}
-
-export { WorkPrCommandError, runWorkPr };