deepline 0.2.10 → 0.2.11

package/dist/bundling-sources/sdk/src/client.ts

@@ -902,6 +902,66 @@ export type BillingInvoicesResult = {
   entries: BillingInvoiceEntry[];
 };
 
+export type TargetBillingOperation = {
+  id: string;
+  state: string;
+  version: number;
+  next_action?: string | null;
+};
+
+export type TargetBillingPlan = {
+  sku: 'payg-v1' | 'builder-v1' | 'team-v1';
+  name: string;
+  recurring_price_usd: number;
+  interval: 'month';
+  included_credits: number;
+  purchased_credit_price_usd: number;
+};
+
+export type TargetBillingPlansResult = {
+  org_id: string;
+  plans: TargetBillingPlan[];
+  current_plan_sku: string;
+  pending_plan_sku: string | null;
+  acquisition_enabled: boolean;
+};
+
+export type TargetBillingStatusResult = {
+  org_id: string;
+  plan: {
+    sku: string;
+    name: string;
+    recurring_price_usd: number | null;
+    interval: string | null;
+    included_credits: number | null;
+  };
+  state: string;
+  changes_allowed: boolean;
+  payment_state: string;
+  recharge_state: string;
+  next_action: string | null;
+  pending_plan_sku: string | null;
+  as_of: string | null;
+};
+
+export type TargetBillingMutationResult = {
+  data: Record<string, unknown>;
+  operation: TargetBillingOperation;
+  request_id?: string;
+};
+
+export type TargetBillingPlanTransitionOptions =
+  | {
+      action: 'start_or_change';
+      targetPlanSku: 'payg-v1' | 'builder-v1' | 'team-v1';
+      idempotencyKey: string;
+    }
+  | {
+      action: 'cancel' | 'undo_cancel';
+      targetPlanSku?: never;
+      idempotencyKey: string;
+    };
+
 /** Saved payment method details returned by one-click billing top-up. */
 export type BillingPaymentMethodSummary = {
   brand?: string | null;
@@ -977,9 +1037,8 @@ export type BillingPlansResult = {
 /**
  * Public billing namespace exposed as `client.billing`.
  *
- * Carries the durable Deepline billing product model — plans, subscription
- * state, period-end cancellation, and invoice/receipt history — so CLI
- * commands and programmatic callers share the same surface.
+ * Carries plans, subscription state, cancellation, and invoice/receipt history
+ * so CLI commands and programmatic callers share one surface.
  *
  * @sdkReference client 030 client.billing
  */
@@ -1006,8 +1065,39 @@ export type BillingNamespace = {
     /** Subscription invoices plus credit purchase receipts, newest first. */
     list: (options?: { limit?: number }) => Promise<BillingInvoicesResult>;
   };
+  /** Metronome-authored target catalog and current Contract projection. */
+  targetPlans: () => Promise<TargetBillingPlansResult>;
+  /** Normalized target billing state. */
+  targetStatus: () => Promise<TargetBillingStatusResult>;
+  /** Buy Deepline credits through a payment-gated Metronome commit. */
+  purchaseCredits: (options: {
+    credits: number;
+    idempotencyKey: string;
+  }) => Promise<TargetBillingMutationResult>;
+  /** Start, change, cancel, or undo a target plan transition. */
+  transitionPlan: (
+    options: TargetBillingPlanTransitionOptions,
+  ) => Promise<TargetBillingMutationResult>;
+  /** Create a Stripe-hosted billing Portal session. */
+  portalSession: () => Promise<{ url: string }>;
 };
 
+function requireTargetBillingIdempotencyKey(value: string): string {
+  const normalized = value.trim();
+  if (
+    normalized.length === 0 ||
+    normalized.length > 200 ||
+    normalized !== value
+  ) {
+    throw new DeeplineError(
+      'Billing idempotencyKey must contain 1–200 characters with no leading or trailing whitespace.',
+      undefined,
+      'INVALID_BILLING_IDEMPOTENCY_KEY',
+    );
+  }
+  return normalized;
+}
+
 function isRecord(value: unknown): value is Record<string, unknown> {
   return Boolean(value && typeof value === 'object' && !Array.isArray(value));
 }
@@ -1495,6 +1585,11 @@ export class DeeplineClient {
       invoices: {
         list: (options) => this.listBillingInvoices(options),
       },
+      targetPlans: () => this.getTargetBillingPlans(),
+      targetStatus: () => this.getTargetBillingStatus(),
+      purchaseCredits: (options) => this.purchaseTargetBillingCredits(options),
+      transitionPlan: (options) => this.transitionTargetBillingPlan(options),
+      portalSession: () => this.createTargetBillingPortalSession(),
     };
     this.monitors = {
       status: () => this.getMonitorsAccess(),
@@ -4016,6 +4111,67 @@ export class DeeplineClient {
     );
   }
 
+  /** List the reviewed target plans and whether new acquisition is enabled. */
+  async getTargetBillingPlans(): Promise<TargetBillingPlansResult> {
+    return this.http.get<TargetBillingPlansResult>('/api/v2/billing/plans');
+  }
+
+  /** Read the workspace's normalized target plan, payment, and balance state. */
+  async getTargetBillingStatus(): Promise<TargetBillingStatusResult> {
+    return this.http.get<TargetBillingStatusResult>('/api/v2/billing/status');
+  }
+
+  /**
+   * Purchase target-billing credits through the durable commercial operation
+   * flow. The caller supplies an idempotency key for safe retries.
+   */
+  async purchaseTargetBillingCredits(options: {
+    credits: number;
+    idempotencyKey: string;
+  }): Promise<TargetBillingMutationResult> {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey,
+    );
+    return this.http.post<TargetBillingMutationResult>(
+      '/api/v2/billing/credit-purchases',
+      { credits: options.credits },
+      { 'Idempotency-Key': idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true },
+    );
+  }
+
+  /**
+   * Start, change, cancel, or restore a target plan through one idempotent
+   * commercial operation.
+   */
+  async transitionTargetBillingPlan(
+    options: TargetBillingPlanTransitionOptions,
+  ): Promise<TargetBillingMutationResult> {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey,
+    );
+    return this.http.post<TargetBillingMutationResult>(
+      '/api/v2/billing/plan-transitions',
+      {
+        action: options.action,
+        ...(options.targetPlanSku
+          ? { target_plan_sku: options.targetPlanSku }
+          : {}),
+      },
+      { 'Idempotency-Key': idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true },
+    );
+  }
+
+  /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+  async createTargetBillingPortalSession(): Promise<{ url: string }> {
+    const response = await this.http.post<{
+      data: { url: string };
+      request_id?: string;
+    }>('/api/v2/billing/portal-sessions', {});
+    return response.data;
+  }
+
   // ——————————————————————————————————————————————————————————
   // Monitors
   // ——————————————————————————————————————————————————————————

package/dist/bundling-sources/sdk/src/release.ts

@@ -160,7 +160,7 @@ export const SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: '0.2.10',
+  version: '0.2.11',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/cli/index.js

@@ -1040,7 +1040,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.10",
+  version: "0.2.11",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3506,6 +3506,17 @@ function resolveToolExecuteTimeoutMs(toolId, input2) {
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
 var RUN_LOGS_PAGE_LIMIT = 1e3;
+function requireTargetBillingIdempotencyKey(value) {
+  const normalized = value.trim();
+  if (normalized.length === 0 || normalized.length > 200 || normalized !== value) {
+    throw new DeeplineError(
+      "Billing idempotencyKey must contain 1\u2013200 characters with no leading or trailing whitespace.",
+      void 0,
+      "INVALID_BILLING_IDEMPOTENCY_KEY"
+    );
+  }
+  return normalized;
+}
 function isRecord6(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -3776,7 +3787,12 @@ var DeeplineClient = class {
       },
       invoices: {
         list: (options2) => this.listBillingInvoices(options2)
-      }
+      },
+      targetPlans: () => this.getTargetBillingPlans(),
+      targetStatus: () => this.getTargetBillingStatus(),
+      purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
+      transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
+      portalSession: () => this.createTargetBillingPortalSession()
     };
     this.monitors = {
       status: () => this.getMonitorsAccess(),
@@ -5690,6 +5706,52 @@ var DeeplineClient = class {
       `/api/v2/billing/invoices${suffix}`
     );
   }
+  /** List the reviewed target plans and whether new acquisition is enabled. */
+  async getTargetBillingPlans() {
+    return this.http.get("/api/v2/billing/plans");
+  }
+  /** Read the workspace's normalized target plan, payment, and balance state. */
+  async getTargetBillingStatus() {
+    return this.http.get("/api/v2/billing/status");
+  }
+  /**
+   * Purchase target-billing credits through the durable commercial operation
+   * flow. The caller supplies an idempotency key for safe retries.
+   */
+  async purchaseTargetBillingCredits(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/credit-purchases",
+      { credits: options.credits },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /**
+   * Start, change, cancel, or restore a target plan through one idempotent
+   * commercial operation.
+   */
+  async transitionTargetBillingPlan(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/plan-transitions",
+      {
+        action: options.action,
+        ...options.targetPlanSku ? { target_plan_sku: options.targetPlanSku } : {}
+      },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+  async createTargetBillingPortalSession() {
+    const response = await this.http.post("/api/v2/billing/portal-sessions", {});
+    return response.data;
+  }
   // ——————————————————————————————————————————————————————————
   // Monitors
   // ——————————————————————————————————————————————————————————
@@ -7500,6 +7562,9 @@ function topUpIdempotencyKey(raw) {
   }
   return `cli_topup:${Date.now()}:${(0, import_node_crypto2.randomUUID)()}`;
 }
+function targetBillingIdempotencyKey(raw) {
+  return typeof raw === "string" ? raw : `cli_target_billing:${Date.now()}:${(0, import_node_crypto2.randomUUID)()}`;
+}
 function checkoutCommandForCredits(credits) {
   return `deepline billing checkout --credits ${credits} --no-open --json`;
 }
@@ -8305,6 +8370,92 @@ async function handleTopUp(creditsRaw, options) {
     json: options.json
   });
 }
+async function handleTargetStatus(options) {
+  const client2 = new DeeplineClient();
+  const payload = await client2.billing.targetStatus();
+  printCommandEnvelope(
+    {
+      ok: true,
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: "billing status",
+            lines: [
+              `Plan: ${payload.plan.name} (${payload.plan.sku})`,
+              `State: ${payload.state}`,
+              `Payment: ${payload.payment_state}`,
+              `Automatic recharge: ${payload.recharge_state}`
+            ]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleBuyCredits(creditsRaw, options) {
+  const credits = parseTopUpCredits(creditsRaw);
+  if (credits === null) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_CREDITS",
+        message: "<credits> must be a positive integer."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new DeeplineClient().billing.purchaseCredits({
+    credits,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPlan(planSku, options) {
+  if (planSku !== "payg-v1" && planSku !== "builder-v1" && planSku !== "team-v1") {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_PLAN",
+        message: "Plan must be payg-v1, builder-v1, or team-v1."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new DeeplineClient().billing.transitionPlan({
+    action: "start_or_change",
+    targetPlanSku: planSku,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPlanCancellation(options) {
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new DeeplineClient().billing.transitionPlan({
+    action: options.undo ? "undo_cancel" : "cancel",
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPortal(options) {
+  const payload = await new DeeplineClient().billing.portalSession();
+  if (!options.json && !options.noOpen) openInBrowser(payload.url);
+  printCommandEnvelope({ ok: true, ...payload }, { json: options.json });
+}
 async function handleRedeemCode(code, options) {
   const { http } = getAuthedHttpClient();
   const payload = await http.post(
@@ -8500,6 +8651,11 @@ Examples:
     "--idempotency-key <key>",
     "Stable retry key for the same intended top-up"
   ).option("--dry-run", "Print the planned top-up without charging").option("--compact", "Keep only high-signal fields in JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleTopUp);
+  billing.command("buy").description("Buy credits through the target billing contract.").argument("<credits>", "Positive integer Deepline credit amount").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleBuyCredits);
+  billing.command("status").description("Show normalized target billing state.").option("--json", "Emit JSON output").action(handleTargetStatus);
+  billing.command("change-plan").description("Start or change the target billing plan.").argument("<plan_sku>", "payg-v1, builder-v1, or team-v1").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleTargetPlan);
+  billing.command("cancel-plan").description("Cancel a target subscription at period end, or undo it.").option("--undo", "Undo a pending period-end cancellation").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleTargetPlanCancellation);
+  billing.command("portal").description("Open the Stripe-hosted billing recovery portal.").option("--no-open", "Print the URL without opening a browser").option("--json", "Emit JSON output").action(handleTargetPortal);
   billing.command("plans").description("Show published plans and the plan you are on.").addHelpText(
     "after",
     `

package/dist/cli/index.mjs

@@ -1025,7 +1025,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.10",
+  version: "0.2.11",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3491,6 +3491,17 @@ function resolveToolExecuteTimeoutMs(toolId, input2) {
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
 var RUN_LOGS_PAGE_LIMIT = 1e3;
+function requireTargetBillingIdempotencyKey(value) {
+  const normalized = value.trim();
+  if (normalized.length === 0 || normalized.length > 200 || normalized !== value) {
+    throw new DeeplineError(
+      "Billing idempotencyKey must contain 1\u2013200 characters with no leading or trailing whitespace.",
+      void 0,
+      "INVALID_BILLING_IDEMPOTENCY_KEY"
+    );
+  }
+  return normalized;
+}
 function isRecord6(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -3761,7 +3772,12 @@ var DeeplineClient = class {
       },
       invoices: {
         list: (options2) => this.listBillingInvoices(options2)
-      }
+      },
+      targetPlans: () => this.getTargetBillingPlans(),
+      targetStatus: () => this.getTargetBillingStatus(),
+      purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
+      transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
+      portalSession: () => this.createTargetBillingPortalSession()
     };
     this.monitors = {
       status: () => this.getMonitorsAccess(),
@@ -5675,6 +5691,52 @@ var DeeplineClient = class {
       `/api/v2/billing/invoices${suffix}`
     );
   }
+  /** List the reviewed target plans and whether new acquisition is enabled. */
+  async getTargetBillingPlans() {
+    return this.http.get("/api/v2/billing/plans");
+  }
+  /** Read the workspace's normalized target plan, payment, and balance state. */
+  async getTargetBillingStatus() {
+    return this.http.get("/api/v2/billing/status");
+  }
+  /**
+   * Purchase target-billing credits through the durable commercial operation
+   * flow. The caller supplies an idempotency key for safe retries.
+   */
+  async purchaseTargetBillingCredits(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/credit-purchases",
+      { credits: options.credits },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /**
+   * Start, change, cancel, or restore a target plan through one idempotent
+   * commercial operation.
+   */
+  async transitionTargetBillingPlan(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/plan-transitions",
+      {
+        action: options.action,
+        ...options.targetPlanSku ? { target_plan_sku: options.targetPlanSku } : {}
+      },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+  async createTargetBillingPortalSession() {
+    const response = await this.http.post("/api/v2/billing/portal-sessions", {});
+    return response.data;
+  }
   // ——————————————————————————————————————————————————————————
   // Monitors
   // ——————————————————————————————————————————————————————————
@@ -7497,6 +7559,9 @@ function topUpIdempotencyKey(raw) {
   }
   return `cli_topup:${Date.now()}:${randomUUID()}`;
 }
+function targetBillingIdempotencyKey(raw) {
+  return typeof raw === "string" ? raw : `cli_target_billing:${Date.now()}:${randomUUID()}`;
+}
 function checkoutCommandForCredits(credits) {
   return `deepline billing checkout --credits ${credits} --no-open --json`;
 }
@@ -8302,6 +8367,92 @@ async function handleTopUp(creditsRaw, options) {
     json: options.json
   });
 }
+async function handleTargetStatus(options) {
+  const client2 = new DeeplineClient();
+  const payload = await client2.billing.targetStatus();
+  printCommandEnvelope(
+    {
+      ok: true,
+      ...payload,
+      render: {
+        sections: [
+          {
+            title: "billing status",
+            lines: [
+              `Plan: ${payload.plan.name} (${payload.plan.sku})`,
+              `State: ${payload.state}`,
+              `Payment: ${payload.payment_state}`,
+              `Automatic recharge: ${payload.recharge_state}`
+            ]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
+async function handleBuyCredits(creditsRaw, options) {
+  const credits = parseTopUpCredits(creditsRaw);
+  if (credits === null) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_CREDITS",
+        message: "<credits> must be a positive integer."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new DeeplineClient().billing.purchaseCredits({
+    credits,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPlan(planSku, options) {
+  if (planSku !== "payg-v1" && planSku !== "builder-v1" && planSku !== "team-v1") {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_PLAN",
+        message: "Plan must be payg-v1, builder-v1, or team-v1."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new DeeplineClient().billing.transitionPlan({
+    action: "start_or_change",
+    targetPlanSku: planSku,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPlanCancellation(options) {
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  const payload = await new DeeplineClient().billing.transitionPlan({
+    action: options.undo ? "undo_cancel" : "cancel",
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleTargetPortal(options) {
+  const payload = await new DeeplineClient().billing.portalSession();
+  if (!options.json && !options.noOpen) openInBrowser(payload.url);
+  printCommandEnvelope({ ok: true, ...payload }, { json: options.json });
+}
 async function handleRedeemCode(code, options) {
   const { http } = getAuthedHttpClient();
   const payload = await http.post(
@@ -8497,6 +8648,11 @@ Examples:
     "--idempotency-key <key>",
     "Stable retry key for the same intended top-up"
   ).option("--dry-run", "Print the planned top-up without charging").option("--compact", "Keep only high-signal fields in JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleTopUp);
+  billing.command("buy").description("Buy credits through the target billing contract.").argument("<credits>", "Positive integer Deepline credit amount").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleBuyCredits);
+  billing.command("status").description("Show normalized target billing state.").option("--json", "Emit JSON output").action(handleTargetStatus);
+  billing.command("change-plan").description("Start or change the target billing plan.").argument("<plan_sku>", "payg-v1, builder-v1, or team-v1").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleTargetPlan);
+  billing.command("cancel-plan").description("Cancel a target subscription at period end, or undo it.").option("--undo", "Undo a pending period-end cancellation").option("--idempotency-key <key>", "Stable retry key").option("--json", "Emit JSON output").action(handleTargetPlanCancellation);
+  billing.command("portal").description("Open the Stripe-hosted billing recovery portal.").option("--no-open", "Print the URL without opening a browser").option("--json", "Emit JSON output").action(handleTargetPortal);
   billing.command("plans").description("Show published plans and the plan you are on.").addHelpText(
     "after",
     `

package/dist/index.d.mts

@@ -2135,6 +2135,58 @@ type BillingInvoicesResult = {
     org_id: string;
     entries: BillingInvoiceEntry[];
 };
+type TargetBillingOperation = {
+    id: string;
+    state: string;
+    version: number;
+    next_action?: string | null;
+};
+type TargetBillingPlan = {
+    sku: 'payg-v1' | 'builder-v1' | 'team-v1';
+    name: string;
+    recurring_price_usd: number;
+    interval: 'month';
+    included_credits: number;
+    purchased_credit_price_usd: number;
+};
+type TargetBillingPlansResult = {
+    org_id: string;
+    plans: TargetBillingPlan[];
+    current_plan_sku: string;
+    pending_plan_sku: string | null;
+    acquisition_enabled: boolean;
+};
+type TargetBillingStatusResult = {
+    org_id: string;
+    plan: {
+        sku: string;
+        name: string;
+        recurring_price_usd: number | null;
+        interval: string | null;
+        included_credits: number | null;
+    };
+    state: string;
+    changes_allowed: boolean;
+    payment_state: string;
+    recharge_state: string;
+    next_action: string | null;
+    pending_plan_sku: string | null;
+    as_of: string | null;
+};
+type TargetBillingMutationResult = {
+    data: Record<string, unknown>;
+    operation: TargetBillingOperation;
+    request_id?: string;
+};
+type TargetBillingPlanTransitionOptions = {
+    action: 'start_or_change';
+    targetPlanSku: 'payg-v1' | 'builder-v1' | 'team-v1';
+    idempotencyKey: string;
+} | {
+    action: 'cancel' | 'undo_cancel';
+    targetPlanSku?: never;
+    idempotencyKey: string;
+};
 /** Saved payment method details returned by one-click billing top-up. */
 type BillingPaymentMethodSummary = {
     brand?: string | null;
@@ -2206,9 +2258,8 @@ type BillingPlansResult = {
 /**
  * Public billing namespace exposed as `client.billing`.
  *
- * Carries the durable Deepline billing product model — plans, subscription
- * state, period-end cancellation, and invoice/receipt history — so CLI
- * commands and programmatic callers share the same surface.
+ * Carries plans, subscription state, cancellation, and invoice/receipt history
+ * so CLI commands and programmatic callers share one surface.
  *
  * @sdkReference client 030 client.billing
  */
@@ -2237,6 +2288,21 @@ type BillingNamespace = {
             limit?: number;
         }) => Promise<BillingInvoicesResult>;
     };
+    /** Metronome-authored target catalog and current Contract projection. */
+    targetPlans: () => Promise<TargetBillingPlansResult>;
+    /** Normalized target billing state. */
+    targetStatus: () => Promise<TargetBillingStatusResult>;
+    /** Buy Deepline credits through a payment-gated Metronome commit. */
+    purchaseCredits: (options: {
+        credits: number;
+        idempotencyKey: string;
+    }) => Promise<TargetBillingMutationResult>;
+    /** Start, change, cancel, or undo a target plan transition. */
+    transitionPlan: (options: TargetBillingPlanTransitionOptions) => Promise<TargetBillingMutationResult>;
+    /** Create a Stripe-hosted billing Portal session. */
+    portalSession: () => Promise<{
+        url: string;
+    }>;
 };
 /**
  * A staged-file upload target minted by POST /api/v2/plays/files/stage/mint.
@@ -3152,6 +3218,27 @@ declare class DeeplineClient {
     listBillingInvoices(options?: {
         limit?: number;
     }): Promise<BillingInvoicesResult>;
+    /** List the reviewed target plans and whether new acquisition is enabled. */
+    getTargetBillingPlans(): Promise<TargetBillingPlansResult>;
+    /** Read the workspace's normalized target plan, payment, and balance state. */
+    getTargetBillingStatus(): Promise<TargetBillingStatusResult>;
+    /**
+     * Purchase target-billing credits through the durable commercial operation
+     * flow. The caller supplies an idempotency key for safe retries.
+     */
+    purchaseTargetBillingCredits(options: {
+        credits: number;
+        idempotencyKey: string;
+    }): Promise<TargetBillingMutationResult>;
+    /**
+     * Start, change, cancel, or restore a target plan through one idempotent
+     * commercial operation.
+     */
+    transitionTargetBillingPlan(options: TargetBillingPlanTransitionOptions): Promise<TargetBillingMutationResult>;
+    /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+    createTargetBillingPortalSession(): Promise<{
+        url: string;
+    }>;
     /**
      * Whether the current workspace can use Deepline Monitors. Reachable without
      * monitor access; a denial is a normal 200 body, not a 403. Prefer

package/dist/index.d.ts

@@ -2135,6 +2135,58 @@ type BillingInvoicesResult = {
     org_id: string;
     entries: BillingInvoiceEntry[];
 };
+type TargetBillingOperation = {
+    id: string;
+    state: string;
+    version: number;
+    next_action?: string | null;
+};
+type TargetBillingPlan = {
+    sku: 'payg-v1' | 'builder-v1' | 'team-v1';
+    name: string;
+    recurring_price_usd: number;
+    interval: 'month';
+    included_credits: number;
+    purchased_credit_price_usd: number;
+};
+type TargetBillingPlansResult = {
+    org_id: string;
+    plans: TargetBillingPlan[];
+    current_plan_sku: string;
+    pending_plan_sku: string | null;
+    acquisition_enabled: boolean;
+};
+type TargetBillingStatusResult = {
+    org_id: string;
+    plan: {
+        sku: string;
+        name: string;
+        recurring_price_usd: number | null;
+        interval: string | null;
+        included_credits: number | null;
+    };
+    state: string;
+    changes_allowed: boolean;
+    payment_state: string;
+    recharge_state: string;
+    next_action: string | null;
+    pending_plan_sku: string | null;
+    as_of: string | null;
+};
+type TargetBillingMutationResult = {
+    data: Record<string, unknown>;
+    operation: TargetBillingOperation;
+    request_id?: string;
+};
+type TargetBillingPlanTransitionOptions = {
+    action: 'start_or_change';
+    targetPlanSku: 'payg-v1' | 'builder-v1' | 'team-v1';
+    idempotencyKey: string;
+} | {
+    action: 'cancel' | 'undo_cancel';
+    targetPlanSku?: never;
+    idempotencyKey: string;
+};
 /** Saved payment method details returned by one-click billing top-up. */
 type BillingPaymentMethodSummary = {
     brand?: string | null;
@@ -2206,9 +2258,8 @@ type BillingPlansResult = {
 /**
  * Public billing namespace exposed as `client.billing`.
  *
- * Carries the durable Deepline billing product model — plans, subscription
- * state, period-end cancellation, and invoice/receipt history — so CLI
- * commands and programmatic callers share the same surface.
+ * Carries plans, subscription state, cancellation, and invoice/receipt history
+ * so CLI commands and programmatic callers share one surface.
  *
  * @sdkReference client 030 client.billing
  */
@@ -2237,6 +2288,21 @@ type BillingNamespace = {
             limit?: number;
         }) => Promise<BillingInvoicesResult>;
     };
+    /** Metronome-authored target catalog and current Contract projection. */
+    targetPlans: () => Promise<TargetBillingPlansResult>;
+    /** Normalized target billing state. */
+    targetStatus: () => Promise<TargetBillingStatusResult>;
+    /** Buy Deepline credits through a payment-gated Metronome commit. */
+    purchaseCredits: (options: {
+        credits: number;
+        idempotencyKey: string;
+    }) => Promise<TargetBillingMutationResult>;
+    /** Start, change, cancel, or undo a target plan transition. */
+    transitionPlan: (options: TargetBillingPlanTransitionOptions) => Promise<TargetBillingMutationResult>;
+    /** Create a Stripe-hosted billing Portal session. */
+    portalSession: () => Promise<{
+        url: string;
+    }>;
 };
 /**
  * A staged-file upload target minted by POST /api/v2/plays/files/stage/mint.
@@ -3152,6 +3218,27 @@ declare class DeeplineClient {
     listBillingInvoices(options?: {
         limit?: number;
     }): Promise<BillingInvoicesResult>;
+    /** List the reviewed target plans and whether new acquisition is enabled. */
+    getTargetBillingPlans(): Promise<TargetBillingPlansResult>;
+    /** Read the workspace's normalized target plan, payment, and balance state. */
+    getTargetBillingStatus(): Promise<TargetBillingStatusResult>;
+    /**
+     * Purchase target-billing credits through the durable commercial operation
+     * flow. The caller supplies an idempotency key for safe retries.
+     */
+    purchaseTargetBillingCredits(options: {
+        credits: number;
+        idempotencyKey: string;
+    }): Promise<TargetBillingMutationResult>;
+    /**
+     * Start, change, cancel, or restore a target plan through one idempotent
+     * commercial operation.
+     */
+    transitionTargetBillingPlan(options: TargetBillingPlanTransitionOptions): Promise<TargetBillingMutationResult>;
+    /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+    createTargetBillingPortalSession(): Promise<{
+        url: string;
+    }>;
     /**
      * Whether the current workspace can use Deepline Monitors. Reachable without
      * monitor access; a denial is a normal 200 body, not a 403. Prefer

package/dist/index.js

@@ -763,7 +763,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.10",
+  version: "0.2.11",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3229,6 +3229,17 @@ function resolveToolExecuteTimeoutMs(toolId, input) {
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
 var RUN_LOGS_PAGE_LIMIT = 1e3;
+function requireTargetBillingIdempotencyKey(value) {
+  const normalized = value.trim();
+  if (normalized.length === 0 || normalized.length > 200 || normalized !== value) {
+    throw new DeeplineError(
+      "Billing idempotencyKey must contain 1\u2013200 characters with no leading or trailing whitespace.",
+      void 0,
+      "INVALID_BILLING_IDEMPOTENCY_KEY"
+    );
+  }
+  return normalized;
+}
 function isRecord6(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -3499,7 +3510,12 @@ var DeeplineClient = class {
       },
       invoices: {
         list: (options2) => this.listBillingInvoices(options2)
-      }
+      },
+      targetPlans: () => this.getTargetBillingPlans(),
+      targetStatus: () => this.getTargetBillingStatus(),
+      purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
+      transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
+      portalSession: () => this.createTargetBillingPortalSession()
     };
     this.monitors = {
       status: () => this.getMonitorsAccess(),
@@ -5413,6 +5429,52 @@ var DeeplineClient = class {
       `/api/v2/billing/invoices${suffix}`
     );
   }
+  /** List the reviewed target plans and whether new acquisition is enabled. */
+  async getTargetBillingPlans() {
+    return this.http.get("/api/v2/billing/plans");
+  }
+  /** Read the workspace's normalized target plan, payment, and balance state. */
+  async getTargetBillingStatus() {
+    return this.http.get("/api/v2/billing/status");
+  }
+  /**
+   * Purchase target-billing credits through the durable commercial operation
+   * flow. The caller supplies an idempotency key for safe retries.
+   */
+  async purchaseTargetBillingCredits(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/credit-purchases",
+      { credits: options.credits },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /**
+   * Start, change, cancel, or restore a target plan through one idempotent
+   * commercial operation.
+   */
+  async transitionTargetBillingPlan(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/plan-transitions",
+      {
+        action: options.action,
+        ...options.targetPlanSku ? { target_plan_sku: options.targetPlanSku } : {}
+      },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+  async createTargetBillingPortalSession() {
+    const response = await this.http.post("/api/v2/billing/portal-sessions", {});
+    return response.data;
+  }
   // ——————————————————————————————————————————————————————————
   // Monitors
   // ——————————————————————————————————————————————————————————

package/dist/index.mjs

@@ -689,7 +689,7 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.10",
+  version: "0.2.11",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3155,6 +3155,17 @@ function resolveToolExecuteTimeoutMs(toolId, input) {
 }
 var RUNS_FAILED_LOG_LIMIT = 20;
 var RUN_LOGS_PAGE_LIMIT = 1e3;
+function requireTargetBillingIdempotencyKey(value) {
+  const normalized = value.trim();
+  if (normalized.length === 0 || normalized.length > 200 || normalized !== value) {
+    throw new DeeplineError(
+      "Billing idempotencyKey must contain 1\u2013200 characters with no leading or trailing whitespace.",
+      void 0,
+      "INVALID_BILLING_IDEMPOTENCY_KEY"
+    );
+  }
+  return normalized;
+}
 function isRecord6(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -3425,7 +3436,12 @@ var DeeplineClient = class {
       },
       invoices: {
         list: (options2) => this.listBillingInvoices(options2)
-      }
+      },
+      targetPlans: () => this.getTargetBillingPlans(),
+      targetStatus: () => this.getTargetBillingStatus(),
+      purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
+      transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
+      portalSession: () => this.createTargetBillingPortalSession()
     };
     this.monitors = {
       status: () => this.getMonitorsAccess(),
@@ -5339,6 +5355,52 @@ var DeeplineClient = class {
       `/api/v2/billing/invoices${suffix}`
     );
   }
+  /** List the reviewed target plans and whether new acquisition is enabled. */
+  async getTargetBillingPlans() {
+    return this.http.get("/api/v2/billing/plans");
+  }
+  /** Read the workspace's normalized target plan, payment, and balance state. */
+  async getTargetBillingStatus() {
+    return this.http.get("/api/v2/billing/status");
+  }
+  /**
+   * Purchase target-billing credits through the durable commercial operation
+   * flow. The caller supplies an idempotency key for safe retries.
+   */
+  async purchaseTargetBillingCredits(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/credit-purchases",
+      { credits: options.credits },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /**
+   * Start, change, cancel, or restore a target plan through one idempotent
+   * commercial operation.
+   */
+  async transitionTargetBillingPlan(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    return this.http.post(
+      "/api/v2/billing/plan-transitions",
+      {
+        action: options.action,
+        ...options.targetPlanSku ? { target_plan_sku: options.targetPlanSku } : {}
+      },
+      { "Idempotency-Key": idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
+  /** Create a Stripe-hosted portal session for payment recovery and invoices. */
+  async createTargetBillingPortalSession() {
+    const response = await this.http.post("/api/v2/billing/portal-sessions", {});
+    return response.data;
+  }
   // ——————————————————————————————————————————————————————————
   // Monitors
   // ——————————————————————————————————————————————————————————

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {