run402 3.2.0 → 3.3.0

package/lib/transfer.mjs

@@ -10,7 +10,7 @@ import {
   positionalArgs,
 } from "./argparse.mjs";
 
-const HELP = `run402 transfer — Two-party project transfer (v1.59)
+const HELP = `run402 transfer — Project transfer, one noun for both recipient kinds (v1.93+)
 
 Usage:
   run402 transfer init --to <wallet|email> [--project <id>] [--billing-policy migrate] [--message <text>] [--kysigned <record_id>] [--retain-collaborator developer]
@@ -18,22 +18,22 @@ Usage:
   run402 transfer list [--incoming | --outgoing] [--limit N] [--offset N]
   run402 transfer accept <transfer_id>
   run402 transfer claim <transfer_id> [--into <organization_id>] [--accept-retained-collaborator]
-  run402 transfer cancel <transfer_id> [--reason <text>] [--handoff]
+  run402 transfer cancel <transfer_id> [--reason <text>]
 
 Subcommands:
-  init        Initiate ownership change. --to <wallet> = two-party wallet transfer;
-              --to <email> = email->org handoff (the recipient claims it).
-  preview     Fetch the safe review document (add --handoff for an email handoff)
-  list        List pending transfers (incoming default, --outgoing, or --handoffs)
-  accept      Accept an incoming wallet transfer (your wallet must be the to_wallet)
-  claim       Claim an incoming email handoff into an org (--into <id>; omit = new org)
-  cancel      Cancel a pending transfer/handoff (--handoff routes to a handoff)
+  init        Initiate ownership change. --to <wallet> = two-party wallet transfer
+              (completed by 'accept'); --to <email> = email->org transfer (completed by 'claim').
+  preview     Fetch the safe review document (wallet or email — kind-agnostic)
+  list        List pending transfers (incoming default, or --outgoing) — both kinds, unioned
+  accept      Accept an incoming WALLET transfer (your wallet must be the to_wallet)
+  claim       Claim an incoming EMAIL transfer into an org (--into <id>; omit = new org)
+  cancel      Cancel a pending transfer of either kind
 
 Notes:
   - Owner-side mutations on a project with a pending transfer return 409
     PROJECT_HAS_PENDING_TRANSFER. Cancel the transfer or wait 72h for expiry.
   - Phase 1A supports only billing_policy=migrate (default).
-  - Secret VALUES are inherited by the recipient on accept; rotation is advised.
+  - Secret VALUES are inherited by the recipient on completion; rotation is advised.
   - GitHub repo ownership is NOT transferred — handle that out of band.
 `;
 
@@ -45,17 +45,18 @@ Usage:
 
 Options:
   --project <id>         Project id (defaults to the active project)
-  --to <wallet>          Recipient wallet (required). Any case; lowercased server-side.
-  --billing-policy <p>   Billing policy. Phase 1A only allows 'migrate' (default).
+  --to <wallet|email>    Recipient (required). A wallet uses the two-party rail (completed by
+                         'accept'); an email uses the email->org rail (completed by 'claim').
+  --billing-policy <p>   Billing policy (wallet rail). Phase 1A only allows 'migrate' (default).
   --message <text>       Optional note shown to the recipient in preview + emails.
-  --kysigned <record_id> Optional KySigned record id (Phase 1A: informational only).
-  --retain-collaborator <role>  Email handoffs only (v1.91): keep a 'developer' membership in
-                         the recipient's org after handoff. The recipient must accept it at
+  --kysigned <record_id> Optional KySigned record id (wallet rail; Phase 1A: informational only).
+  --retain-collaborator <role>  Email recipients only (v1.91): keep a 'developer' membership in
+                         the recipient's org after the transfer. The recipient must accept it at
                          claim (--accept-retained-collaborator); omit for full severance.
 
 Notes:
-  - Caller's wallet must currently own the project (gateway re-checks fresh DB).
-  - Owner-side mutations on the project are frozen until accept/cancel/expiry.
+  - Caller's wallet/session must currently own or admin the project (gateway re-checks fresh DB).
+  - Owner-side mutations on the project are frozen until accept/claim/cancel/expiry.
   - The project lease stays with your organization; it is NOT refunded.
 `,
   preview: `run402 transfer preview — Fetch the preview document
@@ -64,21 +65,25 @@ Usage:
   run402 transfer preview <transfer_id>
 
 Returns project name, custom domains, subdomains, function names, secret NAMES
-(values are never returned), CI bindings that will be revoked on accept, and
-billing implications. Either the from_wallet or the to_wallet may preview.
+(values are never returned), CI bindings that will be revoked on completion, and
+billing implications. Works for both wallet- and email-addressed transfers; any
+party to the transfer may preview.
 `,
   list: `run402 transfer list — List pending transfers
 
 Usage:
   run402 transfer list [--incoming | --outgoing] [--limit N] [--offset N]
 
+Lists both wallet- and email-addressed transfers, unioned; each row carries
+recipient_kind.
+
 Options:
-  --incoming    List transfers OFFERED TO your wallet (default).
-  --outgoing    List transfers INITIATED BY your wallet.
+  --incoming    List transfers OFFERED TO you (default).
+  --outgoing    List transfers INITIATED BY you.
   --limit N     Page size (default 50).
   --offset N    Pagination offset (default 0).
 `,
-  accept: `run402 transfer accept — Accept an incoming transfer
+  accept: `run402 transfer accept — Accept an incoming WALLET transfer
 
 Usage:
   run402 transfer accept <transfer_id>
@@ -86,24 +91,26 @@ Usage:
 Your wallet must equal the transfer's to_wallet. The accept transaction
 atomically: flips ownership, revokes the previous owner's CI bindings on the
 project, enqueues notifications to both parties, and stamps a
-'secrets_rotation_advised' advisory on the project.
+'secrets_rotation_advised' advisory on the project. (Email transfers complete
+via 'claim', not 'accept'.)
 `,
   cancel: `run402 transfer cancel — Cancel a pending transfer
 
 Usage:
-  run402 transfer cancel <transfer_id> [--reason <text>] [--handoff]
+  run402 transfer cancel <transfer_id> [--reason <text>]
 
-Either the from_wallet or the to_wallet may cancel. Already-processed
-transfers return 409 TRANSFER_ALREADY_PROCESSED. Pass --handoff to cancel an
-email->org handoff instead of a wallet transfer.
+Cancels a pending transfer of either kind. You must be authorized for the row's
+kind (a wallet signing party, or an owner/admin of the offering org / the
+addressed-email principal). Already-processed transfers return 409
+TRANSFER_ALREADY_PROCESSED.
 `,
-  claim: `run402 transfer claim — Claim an incoming email handoff
+  claim: `run402 transfer claim — Claim an incoming EMAIL transfer
 
 Usage:
   run402 transfer claim <transfer_id> [--into <organization_id>] [--accept-retained-collaborator]
 
-Claims a handoff addressed to your email into an org you own. Omit --into to
-claim into a brand-new org. This is the email-handoff analog of 'accept'.
+Claims an email-addressed transfer into an org you own. Omit --into to claim into
+a brand-new org. This is the email analog of 'accept'.
 
 Options:
   --into <organization_id>       Org to claim into (omit = brand-new org).
@@ -123,9 +130,9 @@ async function init(args) {
   if (extra.length > 0) {
     fail({ code: "BAD_USAGE", message: `Unexpected argument for transfer init: ${extra[0]}` });
   }
-  const toWallet = flagValue(parsedArgs, "--to");
-  if (!toWallet) {
-    fail({ code: "BAD_USAGE", message: "Missing --to <wallet>" });
+  const to = flagValue(parsedArgs, "--to");
+  if (!to) {
+    fail({ code: "BAD_USAGE", message: "Missing --to <wallet|email>" });
   }
   const projectFlag = flagValue(parsedArgs, "--project");
   const projectId = await resolveProjectId(projectFlag);
@@ -144,17 +151,18 @@ async function init(args) {
   const kysigned = flagValue(parsedArgs, "--kysigned");
   const retainCollaborator = flagValue(parsedArgs, "--retain-collaborator");
 
-  // One noun, two rails: an email recipient routes to the email->org handoff;
-  // a wallet recipient routes to the two-party wallet transfer.
-  const isEmail = toWallet.includes("@");
+  // One noun, two rails: an email recipient routes to the email->org completion
+  // ('claim'); a wallet recipient routes to the two-party wallet completion
+  // ('accept'). Both initiate on the SAME endpoint, discriminated by the body.
+  const isEmail = to.includes("@");
 
-  // --retain-collaborator (v1.91) is a handoff-only opt-in: the sender keeps a
+  // --retain-collaborator (v1.91) is an email-only opt-in: the sender keeps a
   // developer membership in the recipient's org (recipient must accept at claim).
   if (retainCollaborator !== null) {
     if (!isEmail) {
       fail({
         code: "BAD_FLAG",
-        message: "--retain-collaborator applies only to email handoffs; a wallet --to uses the two-party transfer rail.",
+        message: "--retain-collaborator applies only to email recipients; a wallet --to uses the two-party transfer rail.",
         details: { flag: "--retain-collaborator" },
       });
     }
@@ -167,21 +175,20 @@ async function init(args) {
     }
   }
 
-  allowanceAuthHeaders(
-    isEmail ? `/projects/v1/${projectId}/handoffs` : `/projects/v1/${projectId}/transfers`,
-  );
+  // Both kinds initiate on the unified transfer endpoint — sign that path.
+  allowanceAuthHeaders(`/projects/v1/${projectId}/transfers`);
 
   try {
     const res = isEmail
-      ? await getSdk().admin.transfers.initiateHandoff({
+      ? await getSdk().admin.transfers.initiate({
           projectId,
-          toEmail: toWallet,
+          toEmail: to,
           message: message ?? undefined,
           retainCollaborator: retainCollaborator ? { role: retainCollaborator } : undefined,
         })
       : await getSdk().admin.transfers.initiate({
           projectId,
-          toWallet,
+          toWallet: to,
           billingPolicy: billingPolicy ?? undefined,
           message: message ?? undefined,
           kysignedRecordId: kysigned ?? undefined,
@@ -194,19 +201,17 @@ async function init(args) {
 
 async function preview(args) {
   const parsedArgs = normalizeArgv(args);
-  assertKnownFlags(parsedArgs, ["--handoff", "--help", "-h"]);
+  assertKnownFlags(parsedArgs, ["--help", "-h"]);
   const positionals = positionalArgs(parsedArgs);
   if (positionals.length !== 1) {
-    fail({ code: "BAD_USAGE", message: "Usage: run402 transfer preview <transfer_id> [--handoff]" });
+    fail({ code: "BAD_USAGE", message: "Usage: run402 transfer preview <transfer_id>" });
   }
   const transferId = positionals[0];
-  const handoff = parsedArgs.includes("--handoff");
-  allowanceAuthHeaders(`/agent/v1/${handoff ? "handoffs" : "transfers"}/${transferId}`);
+  // Preview is kind-agnostic — one route serves wallet and email transfers.
+  allowanceAuthHeaders(`/agent/v1/transfers/${transferId}`);
 
   try {
-    const data = handoff
-      ? await getSdk().admin.transfers.previewHandoff(transferId)
-      : await getSdk().admin.transfers.preview(transferId);
+    const data = await getSdk().admin.transfers.preview(transferId);
     console.log(JSON.stringify(data, null, 2));
   } catch (err) {
     reportSdkError(err);
@@ -216,24 +221,12 @@ async function preview(args) {
 async function list(args) {
   const parsedArgs = normalizeArgv(args);
   const valueFlags = ["--limit", "--offset"];
-  assertKnownFlags(parsedArgs, [...valueFlags, "--incoming", "--outgoing", "--handoffs", "--help", "-h"], valueFlags);
+  assertKnownFlags(parsedArgs, [...valueFlags, "--incoming", "--outgoing", "--help", "-h"], valueFlags);
   const extra = positionalArgs(parsedArgs, valueFlags);
   if (extra.length > 0) {
     fail({ code: "BAD_USAGE", message: `Unexpected argument for transfer list: ${extra[0]}` });
   }
 
-  // Email->org handoffs ride the same rail but have their own incoming inbox.
-  if (parsedArgs.includes("--handoffs")) {
-    allowanceAuthHeaders("/agent/v1/handoffs/incoming");
-    try {
-      const handoffs = await getSdk().admin.transfers.listIncomingHandoffs();
-      console.log(JSON.stringify({ kind: "handoffs", handoffs }, null, 2));
-    } catch (err) {
-      reportSdkError(err);
-    }
-    return;
-  }
-
   const incoming = parsedArgs.includes("--incoming");
   const outgoing = parsedArgs.includes("--outgoing");
   if (incoming && outgoing) {
@@ -252,6 +245,8 @@ async function list(args) {
       ? undefined
       : parseIntegerFlag("--offset", offsetFlag, { min: 0 });
 
+  // Incoming/outgoing are kind-agnostic — each returns the union of wallet- and
+  // email-addressed rows, tagged with recipient_kind.
   allowanceAuthHeaders(`/agent/v1/transfers/${direction}`);
 
   try {
@@ -286,20 +281,18 @@ async function accept(args) {
 async function cancel(args) {
   const parsedArgs = normalizeArgv(args);
   const valueFlags = ["--reason"];
-  assertKnownFlags(parsedArgs, [...valueFlags, "--handoff", "--help", "-h"], valueFlags);
+  assertKnownFlags(parsedArgs, [...valueFlags, "--help", "-h"], valueFlags);
   const positionals = positionalArgs(parsedArgs, valueFlags);
   if (positionals.length !== 1) {
-    fail({ code: "BAD_USAGE", message: "Usage: run402 transfer cancel <transfer_id> [--reason <text>] [--handoff]" });
+    fail({ code: "BAD_USAGE", message: "Usage: run402 transfer cancel <transfer_id> [--reason <text>]" });
   }
   const transferId = positionals[0];
   const reason = flagValue(parsedArgs, "--reason");
-  const handoff = parsedArgs.includes("--handoff");
-  allowanceAuthHeaders(`/agent/v1/${handoff ? "handoffs" : "transfers"}/${transferId}/cancel`);
+  // Cancel is kind-agnostic — one route serves wallet and email transfers.
+  allowanceAuthHeaders(`/agent/v1/transfers/${transferId}/cancel`);
 
   try {
-    const data = handoff
-      ? await getSdk().admin.transfers.cancelHandoff(transferId)
-      : await getSdk().admin.transfers.cancel(transferId, reason ?? undefined);
+    const data = await getSdk().admin.transfers.cancel(transferId, reason ?? undefined);
     console.log(JSON.stringify(data, null, 2));
   } catch (err) {
     reportSdkError(err);
@@ -319,10 +312,10 @@ async function claim(args) {
   // v1.91: accept the sender's retained-developer-membership offer (see the
   // preview's `retain_collaborator` block). Absent = full severance (default).
   const acceptRetain = parsedArgs.includes("--accept-retained-collaborator");
-  allowanceAuthHeaders(`/agent/v1/handoffs/${transferId}/claim`);
+  allowanceAuthHeaders(`/agent/v1/transfers/${transferId}/claim`);
 
   try {
-    const data = await getSdk().admin.transfers.claimHandoff(transferId, {
+    const data = await getSdk().admin.transfers.claim(transferId, {
       organizationId: into ?? undefined,
       acceptRetainedCollaborator: acceptRetain || undefined,
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "CLI for Run402 — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 and MPP micropayments.",
   "type": "module",
   "bin": {

package/sdk/dist/namespaces/transfers.d.ts

@@ -1,36 +1,43 @@
 /**
- * `transfers` namespace — two-party SIWX-signed project transfer (v1.59).
+ * `transfers` namespace — the unified project-transfer noun (v1.93+).
  *
- * Exposed as `r.admin.transfers.*`. Phase 1A surface: initiate (owner-only),
- * preview, accept (recipient), cancel (either party), and incoming/outgoing
- * inboxes. The handoff is atomic at accept time: ownership flips, CI
- * bindings are revoked, secret names carry over (values are NOT visible to
- * the recipient before accept), and the project is decorated with a
- * persistent `secrets_rotation_advised` advisory.
+ * Exposed as `r.admin.transfers.*`. Project transfer is ONE capability,
+ * body-discriminated by recipient kind: a wallet recipient (`toWallet`, SIWX
+ * bilateral signing) or an email recipient (`toEmail`, the recipient claims
+ * into an org). Both ride the same `/transfers` surface — there is no separate
+ * `/handoffs` noun (the gateway removed it in `unify-project-transfer-surface`).
  *
  * Gateway endpoints:
- *   POST /projects/v1/:project_id/transfers      — A initiates
- *   GET  /agent/v1/transfers/incoming            — B's inbox
- *   GET  /agent/v1/transfers/outgoing            — A's outbox
- *   GET  /agent/v1/transfers/:transfer_id        — preview (either party)
- *   POST /agent/v1/transfers/:transfer_id/accept — B accepts
- *   POST /agent/v1/transfers/:transfer_id/cancel — either party cancels
+ *   POST /projects/v1/:project_id/transfers      — initiate; body { to_wallet } XOR { to_email }
+ *   GET  /agent/v1/transfers/incoming            — inbox (both kinds, unioned)
+ *   GET  /agent/v1/transfers/outgoing            — outbox (both kinds, unioned)
+ *   GET  /agent/v1/transfers/:transfer_id        — preview (kind-agnostic)
+ *   POST /agent/v1/transfers/:transfer_id/accept — WALLET completion (recipient SIWX-signs)
+ *   POST /agent/v1/transfers/:transfer_id/claim  — EMAIL completion (recipient claims into an org)
+ *   POST /agent/v1/transfers/:transfer_id/cancel — cancel (kind-agnostic)
  *
  * Owner-side mutations against a project with a pending transfer return
  * 409 `PROJECT_HAS_PENDING_TRANSFER`. The SDK kernel surfaces that as
- * {@link TransferFreezeError} so agents can guide the user to cancel.
+ * {@link TransferFreezeError} so agents can guide the user to cancel. Calling
+ * the wrong completion for a row's kind (e.g. `accept` on an email row) returns
+ * 409 `WRONG_COMPLETION_FOR_TRANSFER_KIND`; the thrown error exposes
+ * `nextActions` pointing at the sibling completion on the SAME `transfer_id`.
  */
 import type { Client } from "../kernel.js";
 /** Phase 1A only supports the `migrate` policy — B's wallet must already be on a organization, and the project moves into it. */
 export type TransferBillingPolicy = "migrate";
 export type TransferStatus = "pending" | "accepted" | "cancelled" | "expired";
 export type TransferCancelledBy = "from_wallet" | "to_wallet" | "system";
-/** Inputs to `r.admin.transfers.initiate(...)`. */
-export interface InitiateTransferInput {
-    /** Project id to transfer. Caller must currently own it (gateway re-checks against fresh DB, not cache). */
+/** Which kind of recipient a transfer row is addressed to. */
+export type RecipientKind = "wallet" | "email";
+/** Initiate a transfer addressed to a wallet (two-party SIWX completion via `accept`). */
+export interface InitiateWalletTransferInput {
+    /** Project id to transfer. Caller must currently own/admin it (gateway re-checks against fresh DB, not cache). */
     projectId: string;
     /** Recipient wallet (any case — gateway lowercases). Must differ from the current owner. */
     toWallet: string;
+    /** Mutually exclusive with {@link InitiateWalletTransferInput.toWallet}; not allowed on the wallet path. */
+    toEmail?: never;
     /**
      * Billing policy. Defaults to `"migrate"`. Phase 1A only supports
      * `"migrate"`; future phases may add `"inherit"` as a separate spec.
@@ -40,7 +47,38 @@ export interface InitiateTransferInput {
     message?: string;
     /** Optional KySigned record id (Phase 1A: informational only, stored verbatim, not verified). */
     kysignedRecordId?: string;
+    /** Retention is an email-only opt-in; not allowed on the wallet path. */
+    retainCollaborator?: never;
 }
+/** Initiate a transfer addressed to an email (the recipient claims into an org via `claim`). */
+export interface InitiateEmailTransferInput {
+    /** Project id to transfer. Caller must currently own/admin it. */
+    projectId: string;
+    /** Recipient email; claimed at the recipient's first verified login. */
+    toEmail: string;
+    /** Mutually exclusive with {@link InitiateEmailTransferInput.toEmail}; not allowed on the email path. */
+    toWallet?: never;
+    /** Optional note shown to the recipient (HTML-escaped server-side). */
+    message?: string;
+    /**
+     * Opt in (v1.91) to retaining a `developer` membership in the recipient's org
+     * after the transfer completes. Only `role: "developer"` is accepted, and the
+     * subject is always the initiating owner (you can only retain yourself). The
+     * recipient must explicitly accept it at claim time (see
+     * {@link ClaimTransferInput.acceptRetainedCollaborator}); omitting this is a
+     * full severance, the default.
+     */
+    retainCollaborator?: {
+        role: "developer";
+    } | null;
+    /** Billing policy is wallet-path only; not allowed on the email path. */
+    billingPolicy?: never;
+    /** KySigned record id is wallet-path only; not allowed on the email path. */
+    kysignedRecordId?: never;
+}
+/** Inputs to `r.admin.transfers.initiate(...)` — wallet XOR email. */
+export type InitiateTransferInput = InitiateWalletTransferInput | InitiateEmailTransferInput;
+/** Result of a wallet-addressed `initiate`. */
 export interface InitiateTransferResult {
     transfer_id: string;
     expires_at: string;
@@ -55,6 +93,13 @@ export interface InitiateTransferResult {
     lease_refundable: false;
     terms_sha256: string;
 }
+/** Result of an email-addressed `initiate`. The recipient completes via `claim`. */
+export interface InitiateEmailTransferResult {
+    status: "ok";
+    transfer_id: string;
+    to_email: string;
+    expires_at: string;
+}
 export interface AcceptTransferResult {
     project_id: string;
     from_wallet: string;
@@ -79,20 +124,34 @@ export interface CancelTransferResult {
     cancellation_reason: string | null;
     cancelled_at: string;
 }
-/** Summary row used in `/agent/v1/transfers/incoming` and `/outgoing`. */
+/**
+ * Summary row used in `/agent/v1/transfers/incoming` and `/outgoing`. The list
+ * is kind-agnostic: `recipient_kind` discriminates wallet vs email rows. Wallet
+ * rows carry `from_wallet`/`to_wallet`; email rows carry `to_email` +
+ * `from_organization_id`.
+ */
 export interface TransferSummary {
     transfer_id: string;
     project_id: string;
     project_name_snapshot: string | null;
-    from_wallet: string;
-    to_wallet: string;
+    recipient_kind: RecipientKind;
     billing_policy: TransferBillingPolicy;
     message: string | null;
-    initiated_at: string;
     expires_at: string;
-    kysigned_record_id: string | null;
     /** API path for the full preview document. */
     preview_path: string;
+    /** Wallet rows only. */
+    from_wallet?: string;
+    /** Wallet rows only; `null`/absent for email rows. */
+    to_wallet?: string | null;
+    /** Wallet rows only. */
+    initiated_at?: string;
+    /** Wallet rows only. */
+    kysigned_record_id?: string | null;
+    /** Email rows only. */
+    to_email?: string;
+    /** Email rows only. */
+    from_organization_id?: string | null;
 }
 export interface ListTransfersOptions {
     /** Page size; defaults to 50 on the gateway. */
@@ -137,15 +196,37 @@ export interface BillingImplications {
     functions_count: number;
     custom_domains_count: number;
 }
+/**
+ * The sender-retained-membership offer block on an email transfer preview
+ * (v1.91), or `null` when the sender requested no retention. `accept_field`
+ * names the claim body field the recipient sets to accept
+ * (`"accept_retained_collaborator"`).
+ */
+export interface RetainCollaboratorPreview {
+    principal_id: string;
+    role: "developer";
+    sender_label: string;
+    scope: string;
+    note?: string;
+    accept_field: string;
+    [key: string]: unknown;
+}
+/**
+ * Kind-agnostic preview document. Wallet-identity fields are `null` on email
+ * rows; `to_email` and `retain_collaborator` are populated on email rows.
+ */
 export interface ProjectTransferPreview {
     transfer_id: string;
     project_id: string;
     project_name_snapshot: string | null;
     status: TransferStatus;
-    from_wallet: string;
-    from_wallet_display: string;
-    to_wallet: string;
-    to_wallet_display: string;
+    recipient_kind: RecipientKind;
+    from_wallet: string | null;
+    from_wallet_display: string | null;
+    to_wallet: string | null;
+    to_wallet_display: string | null;
+    /** Email rows only. */
+    to_email?: string;
     billing_policy: TransferBillingPolicy;
     message: string | null;
     initiated_at: string;
@@ -162,140 +243,91 @@ export interface ProjectTransferPreview {
     signers: SignerPreview[];
     github_repo_note: string;
     billing_implications: BillingImplications;
-}
-/** Inputs to {@link Transfers.initiateHandoff}. */
-export interface InitiateHandoffInput {
-    /** Project id to hand off. Caller must currently own it. */
-    projectId: string;
-    /** Recipient email; claimed at the recipient's first login. */
-    toEmail: string;
-    /** Optional note shown to the recipient (HTML-escaped server-side). */
-    message?: string;
-    /**
-     * Opt in (v1.91) to retaining a `developer` membership in the recipient's org
-     * after the handoff completes. Only `role: "developer"` is accepted, and the
-     * subject is always the initiating owner (you can only retain yourself). The
-     * recipient must explicitly accept it at claim time (see
-     * {@link ClaimHandoffInput.acceptRetainedCollaborator}); omitting this is a
-     * full severance, the default. Gateway rejects a bad role with
-     * `INVALID_RETAIN_ROLE` and a missing actor with `RETAIN_SUBJECT_REQUIRED`.
-     */
-    retainCollaborator?: {
-        role: "developer";
-    } | null;
-}
-/** Result of {@link Transfers.initiateHandoff}. Forward-compatible (gateway owns the exact shape). */
-export interface HandoffResult {
-    transfer_id: string;
-    expires_at?: string;
-    [key: string]: unknown;
-}
-/** Summary row from `GET /agent/v1/handoffs/incoming`. Forward-compatible. */
-export interface HandoffSummary {
-    transfer_id: string;
-    project_id: string;
-    to_email?: string;
-    [key: string]: unknown;
-}
-/**
- * The sender-retained-membership offer block on a handoff preview (v1.91), or
- * `null` when the sender requested no retention. `accept_field` names the claim
- * body field the recipient sets to accept (`"accept_retained_collaborator"`).
- */
-export interface RetainCollaboratorPreview {
-    principal_id: string;
-    role: "developer";
-    sender_label: string;
-    scope: string;
-    note?: string;
-    accept_field: string;
-    [key: string]: unknown;
-}
-/** Preview from `GET /agent/v1/handoffs/:transfer_id`. Forward-compatible. */
-export interface ProjectHandoffPreview {
-    transfer_id: string;
-    project_id: string;
-    status?: TransferStatus | string;
-    /** v1.91 sender-retained-membership offer, or `null` when none was requested. */
+    /** v1.91 sender-retained-membership offer (email rows), or `null` when none was requested. */
     retain_collaborator?: RetainCollaboratorPreview | null;
-    [key: string]: unknown;
 }
-/** Inputs to {@link Transfers.claimHandoff}. */
-export interface ClaimHandoffInput {
+/** Inputs to {@link Transfers.claim}. */
+export interface ClaimTransferInput {
     /** Org (organization) to claim into. Omit to claim into a brand-new org. */
     organizationId?: string;
     /**
      * Accept the sender's v1.91 retained-`developer`-membership offer (see the
-     * handoff preview's `retain_collaborator` block). Only an explicit `true`
+     * preview's `retain_collaborator` block). Only an explicit `true`
      * materializes the membership in the new org; omitting it (the default) is a
      * full severance.
      */
     acceptRetainedCollaborator?: boolean;
 }
-/** Result of {@link Transfers.claimHandoff}. Forward-compatible. */
-export interface ClaimHandoffResult {
+/**
+ * Result of {@link Transfers.claim}. Symmetric with wallet {@link Transfers.accept}:
+ * the email completion returns the new owner's project keys
+ * (`project-transfer-claim-credentials`), and `claim` persists them to the
+ * keystore so the claimant can operate the project immediately.
+ */
+export interface ClaimTransferResult {
+    status: "accepted";
     project_id: string;
-    new_organization_id?: string | null;
+    to_organization_id: string;
+    created_new_org: boolean;
     /**
      * The sender's principal id retained as a `developer` of the new org (v1.91),
      * or `null` when no membership was retained (declined, not offered, or no-op).
      */
-    retained_collaborator_principal_id?: string | null;
-    [key: string]: unknown;
+    retained_collaborator_principal_id: string | null;
+    /** New owner's project anon key (stateless `project_id`-derived JWT). `claim` persists it. */
+    anon_key: string;
+    /** New owner's project service key (stateless `project_id`-derived JWT). Full project access; persisted on claim. */
+    service_key: string;
 }
 export declare class Transfers {
     private readonly client;
     constructor(client: Client);
     /**
-     * Initiate a two-party project transfer. Caller must currently own
-     * `projectId` (gateway re-reads owner from DB, not cache). Creates a
-     * `pending` row with a 72h expiry and freezes owner-side mutations on
-     * the project until the transfer is accepted, cancelled, or expires.
+     * Initiate a project transfer — addressed to a wallet (`toWallet`) OR an email
+     * (`toEmail`), exactly one. Caller must currently own/admin `projectId`
+     * (gateway re-reads owner from DB, not cache). Creates a `pending` row with a
+     * 72h expiry and freezes owner-side mutations on the project until the
+     * transfer is accepted (wallet), claimed (email), cancelled, or expires.
      */
-    initiate(input: InitiateTransferInput): Promise<InitiateTransferResult>;
+    initiate(input: InitiateWalletTransferInput): Promise<InitiateTransferResult>;
+    initiate(input: InitiateEmailTransferInput): Promise<InitiateEmailTransferResult>;
     /**
-     * Fetch the preview document for a pending or terminal transfer. The
-     * caller must be either the `from_wallet` or the `to_wallet`; other
-     * wallets receive 403. Preview lists secret NAMES (not values), custom
-     * domains, functions, CI bindings that will be revoked at accept, and
-     * the billing implications.
+     * Fetch the preview document for a pending or terminal transfer of either
+     * kind. The caller must be a party to it (wallet signer, addressed-email
+     * principal, or offering-org member); other callers receive 403. Preview
+     * lists secret NAMES (not values), custom domains, functions, CI bindings
+     * that will be revoked at completion, the billing implications, and — on
+     * email rows — the `retain_collaborator` offer.
      */
     preview(transferId: string): Promise<ProjectTransferPreview>;
     /**
-     * Accept an incoming transfer. The caller's wallet must equal the
-     * transfer's `to_wallet`. The accept transaction atomically flips
-     * ownership, revokes A's CI bindings on the project, enqueues
-     * notifications to both parties, and stamps the persistent
-     * `secrets_rotation_advised` advisory on the project.
+     * Accept an incoming WALLET transfer. The caller's wallet must equal the
+     * transfer's `to_wallet`. The accept transaction atomically flips ownership,
+     * revokes A's CI bindings on the project, enqueues notifications to both
+     * parties, and stamps the persistent `secrets_rotation_advised` advisory.
      */
     accept(transferId: string): Promise<AcceptTransferResult>;
     /**
-     * Cancel a pending transfer. The caller must be either the `from_wallet`
-     * or the `to_wallet`. Already-accepted/cancelled/expired transfers
-     * return 409 `TRANSFER_ALREADY_PROCESSED`.
+     * Claim an incoming EMAIL transfer into an org. Omit `organizationId` to claim
+     * into a brand-new org. The claim atomically flips ownership (the email analog
+     * of {@link Transfers.accept}) and returns the new owner's project keys, which
+     * `claim` persists to the keystore — symmetric with `accept` (#428 /
+     * `project-transfer-claim-credentials`) — so the claimant can operate the
+     * project immediately. Note the claim auth model is principal-based (a
+     * control-plane session or a verified-email SIWX match), so — unlike `accept`
+     * — a wallet is not assumed to be present.
+     */
+    claim(transferId: string, opts?: ClaimTransferInput): Promise<ClaimTransferResult>;
+    /**
+     * Cancel a pending transfer of either kind. The caller must be authorized for
+     * the row's kind (a wallet signer, or an owner/admin of the offering org /
+     * the addressed-email principal). Already-processed transfers return 409
+     * `TRANSFER_ALREADY_PROCESSED`.
      */
     cancel(transferId: string, reason?: string): Promise<CancelTransferResult>;
-    /** Pending transfers OFFERED TO the authenticated wallet. */
+    /** Pending transfers OFFERED TO the caller — both wallet- and email-addressed. */
     listIncoming(opts?: ListTransfersOptions): Promise<TransferSummary[]>;
-    /** Pending transfers INITIATED BY the authenticated wallet. */
+    /** Pending transfers INITIATED BY the caller — both wallet- and email-addressed. */
     listOutgoing(opts?: ListTransfersOptions): Promise<TransferSummary[]>;
-    /**
-     * Initiate an email→org handoff of `projectId` to `toEmail`. Like a wallet
-     * transfer, freezes owner-side mutations until the recipient claims, the
-     * sender cancels, or it expires.
-     */
-    initiateHandoff(input: InitiateHandoffInput): Promise<HandoffResult>;
-    /** Pending handoffs addressed to the authenticated principal's email. */
-    listIncomingHandoffs(): Promise<HandoffSummary[]>;
-    /** Preview a handoff (sender, or the addressed recipient). */
-    previewHandoff(transferId: string): Promise<ProjectHandoffPreview>;
-    /**
-     * Claim an incoming handoff into an org. Omit `organizationId` to claim
-     * into a brand-new org. The claim atomically flips ownership (the handoff
-     * analog of {@link Transfers.accept}).
-     */
-    claimHandoff(transferId: string, input?: ClaimHandoffInput): Promise<ClaimHandoffResult>;
-    /** Cancel a pending handoff (sender or recipient). */
-    cancelHandoff(transferId: string): Promise<CancelTransferResult>;
 }
 //# sourceMappingURL=transfers.d.ts.map

package/sdk/dist/namespaces/transfers.d.ts.map

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

package/sdk/dist/namespaces/transfers.js

@@ -1,67 +1,87 @@
 /**
- * `transfers` namespace — two-party SIWX-signed project transfer (v1.59).
+ * `transfers` namespace — the unified project-transfer noun (v1.93+).
  *
- * Exposed as `r.admin.transfers.*`. Phase 1A surface: initiate (owner-only),
- * preview, accept (recipient), cancel (either party), and incoming/outgoing
- * inboxes. The handoff is atomic at accept time: ownership flips, CI
- * bindings are revoked, secret names carry over (values are NOT visible to
- * the recipient before accept), and the project is decorated with a
- * persistent `secrets_rotation_advised` advisory.
+ * Exposed as `r.admin.transfers.*`. Project transfer is ONE capability,
+ * body-discriminated by recipient kind: a wallet recipient (`toWallet`, SIWX
+ * bilateral signing) or an email recipient (`toEmail`, the recipient claims
+ * into an org). Both ride the same `/transfers` surface — there is no separate
+ * `/handoffs` noun (the gateway removed it in `unify-project-transfer-surface`).
  *
  * Gateway endpoints:
- *   POST /projects/v1/:project_id/transfers      — A initiates
- *   GET  /agent/v1/transfers/incoming            — B's inbox
- *   GET  /agent/v1/transfers/outgoing            — A's outbox
- *   GET  /agent/v1/transfers/:transfer_id        — preview (either party)
- *   POST /agent/v1/transfers/:transfer_id/accept — B accepts
- *   POST /agent/v1/transfers/:transfer_id/cancel — either party cancels
+ *   POST /projects/v1/:project_id/transfers      — initiate; body { to_wallet } XOR { to_email }
+ *   GET  /agent/v1/transfers/incoming            — inbox (both kinds, unioned)
+ *   GET  /agent/v1/transfers/outgoing            — outbox (both kinds, unioned)
+ *   GET  /agent/v1/transfers/:transfer_id        — preview (kind-agnostic)
+ *   POST /agent/v1/transfers/:transfer_id/accept — WALLET completion (recipient SIWX-signs)
+ *   POST /agent/v1/transfers/:transfer_id/claim  — EMAIL completion (recipient claims into an org)
+ *   POST /agent/v1/transfers/:transfer_id/cancel — cancel (kind-agnostic)
  *
  * Owner-side mutations against a project with a pending transfer return
  * 409 `PROJECT_HAS_PENDING_TRANSFER`. The SDK kernel surfaces that as
- * {@link TransferFreezeError} so agents can guide the user to cancel.
+ * {@link TransferFreezeError} so agents can guide the user to cancel. Calling
+ * the wrong completion for a row's kind (e.g. `accept` on an email row) returns
+ * 409 `WRONG_COMPLETION_FOR_TRANSFER_KIND`; the thrown error exposes
+ * `nextActions` pointing at the sibling completion on the SAME `transfer_id`.
  */
+import { LocalError } from "../errors.js";
 // ─── Class ───────────────────────────────────────────────────────────────────
 export class Transfers {
     client;
     constructor(client) {
         this.client = client;
     }
-    /**
-     * Initiate a two-party project transfer. Caller must currently own
-     * `projectId` (gateway re-reads owner from DB, not cache). Creates a
-     * `pending` row with a 72h expiry and freezes owner-side mutations on
-     * the project until the transfer is accepted, cancelled, or expires.
-     */
     async initiate(input) {
-        const body = { to_wallet: input.toWallet };
-        if (input.billingPolicy !== undefined)
-            body.billing_policy = input.billingPolicy;
-        if (input.message !== undefined)
-            body.message = input.message;
-        if (input.kysignedRecordId !== undefined)
-            body.kysigned_record_id = input.kysignedRecordId;
-        return this.client.request(`/projects/v1/${encodeURIComponent(input.projectId)}/transfers`, {
+        const toWallet = "toWallet" in input ? input.toWallet : undefined;
+        const toEmail = "toEmail" in input ? input.toEmail : undefined;
+        const hasWallet = typeof toWallet === "string" && toWallet.length > 0;
+        const hasEmail = typeof toEmail === "string" && toEmail.length > 0;
+        if (hasWallet === hasEmail) {
+            throw new LocalError("Provide exactly one of toWallet or toEmail.", "initiating project transfer", { code: "VALIDATION_ERROR", details: { fields: ["toWallet", "toEmail"] } });
+        }
+        const path = `/projects/v1/${encodeURIComponent(input.projectId)}/transfers`;
+        if (hasEmail) {
+            const body = { to_email: toEmail };
+            if (input.message !== undefined)
+                body.message = input.message;
+            const retain = input.retainCollaborator;
+            if (retain !== undefined)
+                body.retain_collaborator = retain;
+            return this.client.request(path, {
+                method: "POST",
+                body,
+                context: "initiating project transfer",
+            });
+        }
+        const w = input;
+        const body = { to_wallet: toWallet };
+        if (w.billingPolicy !== undefined)
+            body.billing_policy = w.billingPolicy;
+        if (w.message !== undefined)
+            body.message = w.message;
+        if (w.kysignedRecordId !== undefined)
+            body.kysigned_record_id = w.kysignedRecordId;
+        return this.client.request(path, {
             method: "POST",
             body,
             context: "initiating project transfer",
         });
     }
     /**
-     * Fetch the preview document for a pending or terminal transfer. The
-     * caller must be either the `from_wallet` or the `to_wallet`; other
-     * wallets receive 403. Preview lists secret NAMES (not values), custom
-     * domains, functions, CI bindings that will be revoked at accept, and
-     * the billing implications.
+     * Fetch the preview document for a pending or terminal transfer of either
+     * kind. The caller must be a party to it (wallet signer, addressed-email
+     * principal, or offering-org member); other callers receive 403. Preview
+     * lists secret NAMES (not values), custom domains, functions, CI bindings
+     * that will be revoked at completion, the billing implications, and — on
+     * email rows — the `retain_collaborator` offer.
      */
     async preview(transferId) {
         return this.client.request(`/agent/v1/transfers/${encodeURIComponent(transferId)}`, { context: "previewing project transfer" });
     }
     /**
-     * Accept an incoming transfer. The caller's wallet must equal the
-     * transfer's `to_wallet`. The accept transaction atomically flips
-     * ownership, revokes A's CI bindings on the project, enqueues
-     * notifications to both parties, and stamps the persistent
-     * `secrets_rotation_advised` advisory on the project.
+     * Accept an incoming WALLET transfer. The caller's wallet must equal the
+     * transfer's `to_wallet`. The accept transaction atomically flips ownership,
+     * revokes A's CI bindings on the project, enqueues notifications to both
+     * parties, and stamps the persistent `secrets_rotation_advised` advisory.
      */
     async accept(transferId) {
         const result = await this.client.request(`/agent/v1/transfers/${encodeURIComponent(transferId)}/accept`, {
@@ -86,9 +106,45 @@ export class Transfers {
         return result;
     }
     /**
-     * Cancel a pending transfer. The caller must be either the `from_wallet`
-     * or the `to_wallet`. Already-accepted/cancelled/expired transfers
-     * return 409 `TRANSFER_ALREADY_PROCESSED`.
+     * Claim an incoming EMAIL transfer into an org. Omit `organizationId` to claim
+     * into a brand-new org. The claim atomically flips ownership (the email analog
+     * of {@link Transfers.accept}) and returns the new owner's project keys, which
+     * `claim` persists to the keystore — symmetric with `accept` (#428 /
+     * `project-transfer-claim-credentials`) — so the claimant can operate the
+     * project immediately. Note the claim auth model is principal-based (a
+     * control-plane session or a verified-email SIWX match), so — unlike `accept`
+     * — a wallet is not assumed to be present.
+     */
+    async claim(transferId, opts = {}) {
+        const body = {};
+        if (opts.organizationId !== undefined)
+            body.organization_id = opts.organizationId;
+        if (opts.acceptRetainedCollaborator !== undefined) {
+            body.accept_retained_collaborator = opts.acceptRetainedCollaborator;
+        }
+        const result = await this.client.request(`/agent/v1/transfers/${encodeURIComponent(transferId)}/claim`, { method: "POST", body, context: "claiming project transfer" });
+        // Persist the new owner's keys so the claimant can operate the project
+        // immediately, mirroring `accept`. Keys are returned only after the
+        // ownership flip commits, to the authorized claimant.
+        if (result.anon_key && result.service_key) {
+            const creds = this.client.credentials;
+            if (creds.saveProject) {
+                await creds.saveProject(result.project_id, {
+                    anon_key: result.anon_key,
+                    service_key: result.service_key,
+                });
+            }
+            if (creds.setActiveProject) {
+                await creds.setActiveProject(result.project_id);
+            }
+        }
+        return result;
+    }
+    /**
+     * Cancel a pending transfer of either kind. The caller must be authorized for
+     * the row's kind (a wallet signer, or an owner/admin of the offering org /
+     * the addressed-email principal). Already-processed transfers return 409
+     * `TRANSFER_ALREADY_PROCESSED`.
      */
     async cancel(transferId, reason) {
         const body = {};
@@ -100,7 +156,7 @@ export class Transfers {
             context: "cancelling project transfer",
         });
     }
-    /** Pending transfers OFFERED TO the authenticated wallet. */
+    /** Pending transfers OFFERED TO the caller — both wallet- and email-addressed. */
     async listIncoming(opts = {}) {
         const q = buildPagination(opts);
         const path = q ? `/agent/v1/transfers/incoming?${q}` : "/agent/v1/transfers/incoming";
@@ -109,7 +165,7 @@ export class Transfers {
         });
         return res.transfers;
     }
-    /** Pending transfers INITIATED BY the authenticated wallet. */
+    /** Pending transfers INITIATED BY the caller — both wallet- and email-addressed. */
     async listOutgoing(opts = {}) {
         const q = buildPagination(opts);
         const path = q ? `/agent/v1/transfers/outgoing?${q}` : "/agent/v1/transfers/outgoing";
@@ -118,51 +174,6 @@ export class Transfers {
         });
         return res.transfers;
     }
-    // ── Email→org handoff (v1.78) ─────────────────────────────────────────────
-    // Same transfer rail, but the recipient is an EMAIL (resolved to an org at
-    // claim time) rather than a wallet. The caller must own the project; the
-    // recipient claims into an org they own (or a brand-new one). Exposed under
-    // the same `transfer` noun on the CLI (`transfer init --to <email>`).
-    /**
-     * Initiate an email→org handoff of `projectId` to `toEmail`. Like a wallet
-     * transfer, freezes owner-side mutations until the recipient claims, the
-     * sender cancels, or it expires.
-     */
-    async initiateHandoff(input) {
-        const body = { to_email: input.toEmail };
-        if (input.message !== undefined)
-            body.message = input.message;
-        if (input.retainCollaborator !== undefined)
-            body.retain_collaborator = input.retainCollaborator;
-        return this.client.request(`/projects/v1/${encodeURIComponent(input.projectId)}/handoffs`, { method: "POST", body, context: "initiating project handoff" });
-    }
-    /** Pending handoffs addressed to the authenticated principal's email. */
-    async listIncomingHandoffs() {
-        const res = await this.client.request("/agent/v1/handoffs/incoming", { context: "listing incoming handoffs" });
-        return res.handoffs ?? res.transfers ?? [];
-    }
-    /** Preview a handoff (sender, or the addressed recipient). */
-    async previewHandoff(transferId) {
-        return this.client.request(`/agent/v1/handoffs/${encodeURIComponent(transferId)}`, { context: "previewing project handoff" });
-    }
-    /**
-     * Claim an incoming handoff into an org. Omit `organizationId` to claim
-     * into a brand-new org. The claim atomically flips ownership (the handoff
-     * analog of {@link Transfers.accept}).
-     */
-    async claimHandoff(transferId, input = {}) {
-        const body = {};
-        if (input.organizationId !== undefined)
-            body.organization_id = input.organizationId;
-        if (input.acceptRetainedCollaborator !== undefined) {
-            body.accept_retained_collaborator = input.acceptRetainedCollaborator;
-        }
-        return this.client.request(`/agent/v1/handoffs/${encodeURIComponent(transferId)}/claim`, { method: "POST", body, context: "claiming project handoff" });
-    }
-    /** Cancel a pending handoff (sender or recipient). */
-    async cancelHandoff(transferId) {
-        return this.client.request(`/agent/v1/handoffs/${encodeURIComponent(transferId)}/cancel`, { method: "POST", body: {}, context: "cancelling project handoff" });
-    }
 }
 function buildPagination(opts) {
     const parts = [];

package/sdk/dist/namespaces/transfers.js.map

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