deepline 0.3.22 → 0.3.23

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

@@ -1033,6 +1033,28 @@ export type TargetBillingStatusResult = {
   as_of: string | null;
 };
 
+export type TargetAutoRechargeResult = {
+  org_id: string;
+  enabled: boolean;
+  available: boolean;
+  reason: string | null;
+  threshold_credits: number | null;
+  refill_to_credits: number | null;
+  rolling_limit_cents: null;
+};
+
+export type TargetAutoRechargeUpdateOptions =
+  | {
+      enabled: false;
+      idempotencyKey: string;
+    }
+  | {
+      enabled: true;
+      thresholdCredits: number;
+      refillToCredits: number;
+      idempotencyKey: string;
+    };
+
 export type TargetBillingMutationResult = {
   data: Record<string, unknown>;
   operation: TargetBillingOperation;
@@ -1158,6 +1180,13 @@ export type BillingNamespace = {
   targetPlans: () => Promise<TargetBillingPlansResult>;
   /** Normalized target billing state. */
   targetStatus: () => Promise<TargetBillingStatusResult>;
+  /** Read and manage the Metronome-backed automatic recharge configuration. */
+  autoRecharge: {
+    get: () => Promise<TargetAutoRechargeResult>;
+    update: (
+      options: TargetAutoRechargeUpdateOptions,
+    ) => Promise<TargetAutoRechargeResult>;
+  };
   /** Buy Deepline credits through a payment-gated Metronome commit. */
   purchaseCredits: (options: {
     credits: number;
@@ -1750,6 +1779,10 @@ export class DeeplineClient {
       },
       targetPlans: () => this.getTargetBillingPlans(),
       targetStatus: () => this.getTargetBillingStatus(),
+      autoRecharge: {
+        get: () => this.getTargetAutoRecharge(),
+        update: (options) => this.updateTargetAutoRecharge(options),
+      },
       purchaseCredits: (options) => this.purchaseTargetBillingCredits(options),
       transitionPlan: (options) => this.transitionTargetBillingPlan(options),
       portalSession: () => this.createTargetBillingPortalSession(),
@@ -4537,6 +4570,37 @@ export class DeeplineClient {
     return this.http.get<TargetBillingStatusResult>('/api/v2/billing/status');
   }
 
+  /** Read the canonical Metronome automatic recharge configuration. */
+  async getTargetAutoRecharge(): Promise<TargetAutoRechargeResult> {
+    return this.http.get<TargetAutoRechargeResult>(
+      '/api/v2/billing/auto-recharge',
+    );
+  }
+
+  /** Update automatic recharge and return the server-verified configuration. */
+  async updateTargetAutoRecharge(
+    options: TargetAutoRechargeUpdateOptions,
+  ): Promise<TargetAutoRechargeResult> {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey,
+    );
+    const response = await this.http.put<{
+      data: TargetAutoRechargeResult;
+      request_id?: string;
+    }>(
+      '/api/v2/billing/auto-recharge',
+      options.enabled
+        ? {
+            enabled: true,
+            threshold_credits: options.thresholdCredits,
+            refill_to_credits: options.refillToCredits,
+          }
+        : { enabled: false },
+      { 'Idempotency-Key': idempotencyKey },
+    );
+    return response.data;
+  }
+
   /**
    * Purchase target-billing credits through the durable commercial operation
    * flow. The caller supplies an idempotency key for safe retries.

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

@@ -192,7 +192,7 @@ export const SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: '0.3.22',
+  version: '0.3.23',
   updateSummary:
     'New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.',
   contracts: {

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

@@ -1308,6 +1308,11 @@ export interface PlayCheckResult {
    * `1 trigger · 2 tools · 1 dataset · 14 columns`.
    */
   summary?: string;
+  /**
+   * Feature-gated validation paths that were enabled for this exact cloud
+   * check. Present as an empty array when no feature gate affected the result.
+   */
+  featureFlags?: PlayCheckFeatureFlag[];
   artifactHash?: string | null;
   graphHash?: string | null;
   /** SHA-256 of the exact source bytes checked by Deepline. */
@@ -1341,6 +1346,14 @@ export interface PlayCheckResult {
   };
 }
 
+/** An enabled server-side feature flag that affected a Play check. */
+export interface PlayCheckFeatureFlag {
+  id: string;
+  label: string;
+  enabled: true;
+  reason: string;
+}
+
 /**
  * One exported play's check result inside a multi-play file. Carries the same
  * per-play fields as {@link PlayCheckResult}, unprefixed and unaggregated, so a
@@ -1360,6 +1373,7 @@ export interface PlayCheckExportResult {
   graphHash?: string | null;
   sourceHash?: string | null;
   summary?: string;
+  featureFlags?: PlayCheckFeatureFlag[];
   recognized?: PlayCheckRecognizedSummary;
   triggers?: PlayCheckTriggersSummary | null;
 }

package/dist/cli/index.js

@@ -1047,7 +1047,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.22",
+  version: "0.3.23",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -4647,6 +4647,10 @@ var DeeplineClient = class {
       },
       targetPlans: () => this.getTargetBillingPlans(),
       targetStatus: () => this.getTargetBillingStatus(),
+      autoRecharge: {
+        get: () => this.getTargetAutoRecharge(),
+        update: (options2) => this.updateTargetAutoRecharge(options2)
+      },
       purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
       transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
       portalSession: () => this.createTargetBillingPortalSession()
@@ -6732,6 +6736,28 @@ var DeeplineClient = class {
   async getTargetBillingStatus() {
     return this.http.get("/api/v2/billing/status");
   }
+  /** Read the canonical Metronome automatic recharge configuration. */
+  async getTargetAutoRecharge() {
+    return this.http.get(
+      "/api/v2/billing/auto-recharge"
+    );
+  }
+  /** Update automatic recharge and return the server-verified configuration. */
+  async updateTargetAutoRecharge(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    const response = await this.http.put(
+      "/api/v2/billing/auto-recharge",
+      options.enabled ? {
+        enabled: true,
+        threshold_credits: options.thresholdCredits,
+        refill_to_credits: options.refillToCredits
+      } : { enabled: false },
+      { "Idempotency-Key": idempotencyKey }
+    );
+    return response.data;
+  }
   /**
    * Purchase target-billing credits through the durable commercial operation
    * flow. The caller supplies an idempotency key for safe retries.
@@ -9464,6 +9490,96 @@ async function handleTargetStatus(options) {
     { json: options.json }
   );
 }
+async function handleAutoRechargeStatus(options) {
+  const payload = await new DeeplineClient().billing.autoRecharge.get();
+  const state = payload.available ? payload.enabled ? "on" : "off" : "unavailable";
+  const lines = [
+    `State: ${state}`,
+    ...payload.threshold_credits !== null ? [`Threshold: ${payload.threshold_credits} credits`] : [],
+    ...payload.refill_to_credits !== null ? [`Refill balance to: ${payload.refill_to_credits} credits`] : []
+  ];
+  printCommandEnvelope(
+    {
+      ok: true,
+      ...payload,
+      render: { sections: [{ title: "automatic recharge", lines }] }
+    },
+    { json: options.json }
+  );
+}
+async function handleAutoRechargeSet(options) {
+  const thresholdCredits = parseTopUpCredits(options.thresholdCredits);
+  const refillToCredits = parseTopUpCredits(options.refillToCredits);
+  if (thresholdCredits === null || refillToCredits === null || refillToCredits <= thresholdCredits) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_AUTO_RECHARGE_CONFIGURATION",
+        message: "--threshold-credits and --refill-to-credits must be positive whole credits, and refill-to must be greater."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  if (options.dryRun) {
+    printCommandEnvelope(
+      {
+        ok: true,
+        dry_run: true,
+        idempotency_key: idempotencyKey,
+        planned_request: {
+          method: "PUT",
+          path: "/api/v2/billing/auto-recharge",
+          body: {
+            enabled: true,
+            threshold_credits: thresholdCredits,
+            refill_to_credits: refillToCredits
+          }
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const payload = await new DeeplineClient().billing.autoRecharge.update({
+    enabled: true,
+    thresholdCredits,
+    refillToCredits,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleAutoRechargeOff(options) {
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  if (options.dryRun) {
+    printCommandEnvelope(
+      {
+        ok: true,
+        dry_run: true,
+        idempotency_key: idempotencyKey,
+        planned_request: {
+          method: "PUT",
+          path: "/api/v2/billing/auto-recharge",
+          body: { enabled: false }
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const payload = await new DeeplineClient().billing.autoRecharge.update({
+    enabled: false,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
 async function handleBuyCredits(creditsRaw, options) {
   const credits = parseTopUpCredits(creditsRaw);
   if (credits === null) {
@@ -9725,6 +9841,31 @@ Examples:
   ).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("auto-recharge").description("Inspect and manage automatic Deepline credit recharge.").addHelpText(
+    "after",
+    `
+Examples:
+  deepline billing auto-recharge status --json
+  deepline billing auto-recharge set --threshold-credits 1000 --refill-to-credits 3500 --dry-run --json
+  deepline billing auto-recharge off --dry-run --json
+`
+  ).addCommand(
+    new import_commander.Command("status").description("Show the canonical automatic recharge configuration.").option("--json", "Emit JSON output").action(handleAutoRechargeStatus)
+  ).addCommand(
+    new import_commander.Command("set").description(
+      "Enable automatic recharge with a threshold and refill target."
+    ).requiredOption(
+      "--threshold-credits <credits>",
+      "Recharge when the balance reaches this amount"
+    ).requiredOption(
+      "--refill-to-credits <credits>",
+      "Recharge the balance to this amount"
+    ).option("--idempotency-key <key>", "Stable retry key").option("--dry-run", "Print the planned update without applying it").option("--json", "Emit JSON output").action(handleAutoRechargeSet)
+  ).addCommand(
+    new import_commander.Command("off").description(
+      "Disable automatic recharge without clearing saved amounts."
+    ).option("--idempotency-key <key>", "Stable retry key").option("--dry-run", "Print the planned update without applying it").option("--json", "Emit JSON output").action(handleAutoRechargeOff)
+  );
   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);
@@ -23655,6 +23796,10 @@ function printPlayCheckOutcome(outcome, target, prefix) {
     console.error(
       `\u2717 ${prefix}${playName} failed ${playCheckFailureStage(outcome)}`
     );
+    printPlayCheckFeatureFlags(
+      result.featureFlags,
+      (line) => console.error(line)
+    );
     const { unstructuredErrors } = partitionMirroredErrors(
       result.errors,
       result.issues
@@ -23674,6 +23819,7 @@ function printPlayCheckOutcome(outcome, target, prefix) {
   console.log(
     summary ? `\u2713 ${prefix}${playName} valid \u2014 ${summary}` : `\u2713 ${prefix}${playName} passed ${result.limits ? "cloud" : "local"} play check`
   );
+  printPlayCheckFeatureFlags(result.featureFlags, (line) => console.log(line));
   if (result.artifactHash) {
     console.log(`  artifact: ${result.artifactHash.slice(0, 12)}`);
   }
@@ -23695,6 +23841,11 @@ function printPlayCheckOutcome(outcome, target, prefix) {
   );
   printToolGetterHints(result.toolGetterHints);
 }
+function printPlayCheckFeatureFlags(flags, write) {
+  for (const flag of flags ?? []) {
+    write(`  feature flag enabled: ${flag.label} \u2014 ${flag.reason}`);
+  }
+}
 function printPlayCheckOutcomes(outcomes, target) {
   if (outcomes.length === 1) {
     printPlayCheckOutcome(outcomes[0], target, "");

package/dist/cli/index.mjs

@@ -1033,7 +1033,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.22",
+  version: "0.3.23",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -4633,6 +4633,10 @@ var DeeplineClient = class {
       },
       targetPlans: () => this.getTargetBillingPlans(),
       targetStatus: () => this.getTargetBillingStatus(),
+      autoRecharge: {
+        get: () => this.getTargetAutoRecharge(),
+        update: (options2) => this.updateTargetAutoRecharge(options2)
+      },
       purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
       transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
       portalSession: () => this.createTargetBillingPortalSession()
@@ -6718,6 +6722,28 @@ var DeeplineClient = class {
   async getTargetBillingStatus() {
     return this.http.get("/api/v2/billing/status");
   }
+  /** Read the canonical Metronome automatic recharge configuration. */
+  async getTargetAutoRecharge() {
+    return this.http.get(
+      "/api/v2/billing/auto-recharge"
+    );
+  }
+  /** Update automatic recharge and return the server-verified configuration. */
+  async updateTargetAutoRecharge(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    const response = await this.http.put(
+      "/api/v2/billing/auto-recharge",
+      options.enabled ? {
+        enabled: true,
+        threshold_credits: options.thresholdCredits,
+        refill_to_credits: options.refillToCredits
+      } : { enabled: false },
+      { "Idempotency-Key": idempotencyKey }
+    );
+    return response.data;
+  }
   /**
    * Purchase target-billing credits through the durable commercial operation
    * flow. The caller supplies an idempotency key for safe retries.
@@ -9462,6 +9488,96 @@ async function handleTargetStatus(options) {
     { json: options.json }
   );
 }
+async function handleAutoRechargeStatus(options) {
+  const payload = await new DeeplineClient().billing.autoRecharge.get();
+  const state = payload.available ? payload.enabled ? "on" : "off" : "unavailable";
+  const lines = [
+    `State: ${state}`,
+    ...payload.threshold_credits !== null ? [`Threshold: ${payload.threshold_credits} credits`] : [],
+    ...payload.refill_to_credits !== null ? [`Refill balance to: ${payload.refill_to_credits} credits`] : []
+  ];
+  printCommandEnvelope(
+    {
+      ok: true,
+      ...payload,
+      render: { sections: [{ title: "automatic recharge", lines }] }
+    },
+    { json: options.json }
+  );
+}
+async function handleAutoRechargeSet(options) {
+  const thresholdCredits = parseTopUpCredits(options.thresholdCredits);
+  const refillToCredits = parseTopUpCredits(options.refillToCredits);
+  if (thresholdCredits === null || refillToCredits === null || refillToCredits <= thresholdCredits) {
+    reportBillingFailure(
+      {
+        exitCode: 2,
+        code: "INVALID_AUTO_RECHARGE_CONFIGURATION",
+        message: "--threshold-credits and --refill-to-credits must be positive whole credits, and refill-to must be greater."
+      },
+      options
+    );
+    return;
+  }
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  if (options.dryRun) {
+    printCommandEnvelope(
+      {
+        ok: true,
+        dry_run: true,
+        idempotency_key: idempotencyKey,
+        planned_request: {
+          method: "PUT",
+          path: "/api/v2/billing/auto-recharge",
+          body: {
+            enabled: true,
+            threshold_credits: thresholdCredits,
+            refill_to_credits: refillToCredits
+          }
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const payload = await new DeeplineClient().billing.autoRecharge.update({
+    enabled: true,
+    thresholdCredits,
+    refillToCredits,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
+async function handleAutoRechargeOff(options) {
+  const idempotencyKey = targetBillingIdempotencyKey(options.idempotencyKey);
+  if (options.dryRun) {
+    printCommandEnvelope(
+      {
+        ok: true,
+        dry_run: true,
+        idempotency_key: idempotencyKey,
+        planned_request: {
+          method: "PUT",
+          path: "/api/v2/billing/auto-recharge",
+          body: { enabled: false }
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
+  const payload = await new DeeplineClient().billing.autoRecharge.update({
+    enabled: false,
+    idempotencyKey
+  });
+  printCommandEnvelope(
+    { ok: true, idempotency_key: idempotencyKey, ...payload },
+    { json: options.json }
+  );
+}
 async function handleBuyCredits(creditsRaw, options) {
   const credits = parseTopUpCredits(creditsRaw);
   if (credits === null) {
@@ -9723,6 +9839,31 @@ Examples:
   ).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("auto-recharge").description("Inspect and manage automatic Deepline credit recharge.").addHelpText(
+    "after",
+    `
+Examples:
+  deepline billing auto-recharge status --json
+  deepline billing auto-recharge set --threshold-credits 1000 --refill-to-credits 3500 --dry-run --json
+  deepline billing auto-recharge off --dry-run --json
+`
+  ).addCommand(
+    new Command("status").description("Show the canonical automatic recharge configuration.").option("--json", "Emit JSON output").action(handleAutoRechargeStatus)
+  ).addCommand(
+    new Command("set").description(
+      "Enable automatic recharge with a threshold and refill target."
+    ).requiredOption(
+      "--threshold-credits <credits>",
+      "Recharge when the balance reaches this amount"
+    ).requiredOption(
+      "--refill-to-credits <credits>",
+      "Recharge the balance to this amount"
+    ).option("--idempotency-key <key>", "Stable retry key").option("--dry-run", "Print the planned update without applying it").option("--json", "Emit JSON output").action(handleAutoRechargeSet)
+  ).addCommand(
+    new Command("off").description(
+      "Disable automatic recharge without clearing saved amounts."
+    ).option("--idempotency-key <key>", "Stable retry key").option("--dry-run", "Print the planned update without applying it").option("--json", "Emit JSON output").action(handleAutoRechargeOff)
+  );
   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);
@@ -23718,6 +23859,10 @@ function printPlayCheckOutcome(outcome, target, prefix) {
     console.error(
       `\u2717 ${prefix}${playName} failed ${playCheckFailureStage(outcome)}`
     );
+    printPlayCheckFeatureFlags(
+      result.featureFlags,
+      (line) => console.error(line)
+    );
     const { unstructuredErrors } = partitionMirroredErrors(
       result.errors,
       result.issues
@@ -23737,6 +23882,7 @@ function printPlayCheckOutcome(outcome, target, prefix) {
   console.log(
     summary ? `\u2713 ${prefix}${playName} valid \u2014 ${summary}` : `\u2713 ${prefix}${playName} passed ${result.limits ? "cloud" : "local"} play check`
   );
+  printPlayCheckFeatureFlags(result.featureFlags, (line) => console.log(line));
   if (result.artifactHash) {
     console.log(`  artifact: ${result.artifactHash.slice(0, 12)}`);
   }
@@ -23758,6 +23904,11 @@ function printPlayCheckOutcome(outcome, target, prefix) {
   );
   printToolGetterHints(result.toolGetterHints);
 }
+function printPlayCheckFeatureFlags(flags, write) {
+  for (const flag of flags ?? []) {
+    write(`  feature flag enabled: ${flag.label} \u2014 ${flag.reason}`);
+  }
+}
 function printPlayCheckOutcomes(outcomes, target) {
   if (outcomes.length === 1) {
     printPlayCheckOutcome(outcomes[0], target, "");

package/dist/index.d.mts

@@ -1413,6 +1413,11 @@ interface PlayCheckResult {
      * `1 trigger · 2 tools · 1 dataset · 14 columns`.
      */
     summary?: string;
+    /**
+     * Feature-gated validation paths that were enabled for this exact cloud
+     * check. Present as an empty array when no feature gate affected the result.
+     */
+    featureFlags?: PlayCheckFeatureFlag[];
     artifactHash?: string | null;
     graphHash?: string | null;
     /** SHA-256 of the exact source bytes checked by Deepline. */
@@ -1445,6 +1450,13 @@ interface PlayCheckResult {
         };
     };
 }
+/** An enabled server-side feature flag that affected a Play check. */
+interface PlayCheckFeatureFlag {
+    id: string;
+    label: string;
+    enabled: true;
+    reason: string;
+}
 /**
  * One exported play's check result inside a multi-play file. Carries the same
  * per-play fields as {@link PlayCheckResult}, unprefixed and unaggregated, so a
@@ -1464,6 +1476,7 @@ interface PlayCheckExportResult {
     graphHash?: string | null;
     sourceHash?: string | null;
     summary?: string;
+    featureFlags?: PlayCheckFeatureFlag[];
     recognized?: PlayCheckRecognizedSummary;
     triggers?: PlayCheckTriggersSummary | null;
 }
@@ -2498,6 +2511,24 @@ type TargetBillingStatusResult = {
     pending_plan_sku: string | null;
     as_of: string | null;
 };
+type TargetAutoRechargeResult = {
+    org_id: string;
+    enabled: boolean;
+    available: boolean;
+    reason: string | null;
+    threshold_credits: number | null;
+    refill_to_credits: number | null;
+    rolling_limit_cents: null;
+};
+type TargetAutoRechargeUpdateOptions = {
+    enabled: false;
+    idempotencyKey: string;
+} | {
+    enabled: true;
+    thresholdCredits: number;
+    refillToCredits: number;
+    idempotencyKey: string;
+};
 type TargetBillingMutationResult = {
     data: Record<string, unknown>;
     operation: TargetBillingOperation;
@@ -2617,6 +2648,11 @@ type BillingNamespace = {
     targetPlans: () => Promise<TargetBillingPlansResult>;
     /** Normalized target billing state. */
     targetStatus: () => Promise<TargetBillingStatusResult>;
+    /** Read and manage the Metronome-backed automatic recharge configuration. */
+    autoRecharge: {
+        get: () => Promise<TargetAutoRechargeResult>;
+        update: (options: TargetAutoRechargeUpdateOptions) => Promise<TargetAutoRechargeResult>;
+    };
     /** Buy Deepline credits through a payment-gated Metronome commit. */
     purchaseCredits: (options: {
         credits: number;
@@ -3662,6 +3698,10 @@ declare class DeeplineClient {
     getTargetBillingPlans(): Promise<TargetBillingPlansResult>;
     /** Read the workspace's normalized target plan, payment, and balance state. */
     getTargetBillingStatus(): Promise<TargetBillingStatusResult>;
+    /** Read the canonical Metronome automatic recharge configuration. */
+    getTargetAutoRecharge(): Promise<TargetAutoRechargeResult>;
+    /** Update automatic recharge and return the server-verified configuration. */
+    updateTargetAutoRecharge(options: TargetAutoRechargeUpdateOptions): Promise<TargetAutoRechargeResult>;
     /**
      * Purchase target-billing credits through the durable commercial operation
      * flow. The caller supplies an idempotency key for safe retries.

package/dist/index.d.ts

@@ -1413,6 +1413,11 @@ interface PlayCheckResult {
      * `1 trigger · 2 tools · 1 dataset · 14 columns`.
      */
     summary?: string;
+    /**
+     * Feature-gated validation paths that were enabled for this exact cloud
+     * check. Present as an empty array when no feature gate affected the result.
+     */
+    featureFlags?: PlayCheckFeatureFlag[];
     artifactHash?: string | null;
     graphHash?: string | null;
     /** SHA-256 of the exact source bytes checked by Deepline. */
@@ -1445,6 +1450,13 @@ interface PlayCheckResult {
         };
     };
 }
+/** An enabled server-side feature flag that affected a Play check. */
+interface PlayCheckFeatureFlag {
+    id: string;
+    label: string;
+    enabled: true;
+    reason: string;
+}
 /**
  * One exported play's check result inside a multi-play file. Carries the same
  * per-play fields as {@link PlayCheckResult}, unprefixed and unaggregated, so a
@@ -1464,6 +1476,7 @@ interface PlayCheckExportResult {
     graphHash?: string | null;
     sourceHash?: string | null;
     summary?: string;
+    featureFlags?: PlayCheckFeatureFlag[];
     recognized?: PlayCheckRecognizedSummary;
     triggers?: PlayCheckTriggersSummary | null;
 }
@@ -2498,6 +2511,24 @@ type TargetBillingStatusResult = {
     pending_plan_sku: string | null;
     as_of: string | null;
 };
+type TargetAutoRechargeResult = {
+    org_id: string;
+    enabled: boolean;
+    available: boolean;
+    reason: string | null;
+    threshold_credits: number | null;
+    refill_to_credits: number | null;
+    rolling_limit_cents: null;
+};
+type TargetAutoRechargeUpdateOptions = {
+    enabled: false;
+    idempotencyKey: string;
+} | {
+    enabled: true;
+    thresholdCredits: number;
+    refillToCredits: number;
+    idempotencyKey: string;
+};
 type TargetBillingMutationResult = {
     data: Record<string, unknown>;
     operation: TargetBillingOperation;
@@ -2617,6 +2648,11 @@ type BillingNamespace = {
     targetPlans: () => Promise<TargetBillingPlansResult>;
     /** Normalized target billing state. */
     targetStatus: () => Promise<TargetBillingStatusResult>;
+    /** Read and manage the Metronome-backed automatic recharge configuration. */
+    autoRecharge: {
+        get: () => Promise<TargetAutoRechargeResult>;
+        update: (options: TargetAutoRechargeUpdateOptions) => Promise<TargetAutoRechargeResult>;
+    };
     /** Buy Deepline credits through a payment-gated Metronome commit. */
     purchaseCredits: (options: {
         credits: number;
@@ -3662,6 +3698,10 @@ declare class DeeplineClient {
     getTargetBillingPlans(): Promise<TargetBillingPlansResult>;
     /** Read the workspace's normalized target plan, payment, and balance state. */
     getTargetBillingStatus(): Promise<TargetBillingStatusResult>;
+    /** Read the canonical Metronome automatic recharge configuration. */
+    getTargetAutoRecharge(): Promise<TargetAutoRechargeResult>;
+    /** Update automatic recharge and return the server-verified configuration. */
+    updateTargetAutoRecharge(options: TargetAutoRechargeUpdateOptions): Promise<TargetAutoRechargeResult>;
     /**
      * Purchase target-billing credits through the durable commercial operation
      * flow. The caller supplies an idempotency key for safe retries.

package/dist/index.js

@@ -783,7 +783,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.22",
+  version: "0.3.23",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -4358,6 +4358,10 @@ var DeeplineClient = class {
       },
       targetPlans: () => this.getTargetBillingPlans(),
       targetStatus: () => this.getTargetBillingStatus(),
+      autoRecharge: {
+        get: () => this.getTargetAutoRecharge(),
+        update: (options2) => this.updateTargetAutoRecharge(options2)
+      },
       purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
       transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
       portalSession: () => this.createTargetBillingPortalSession()
@@ -6443,6 +6447,28 @@ var DeeplineClient = class {
   async getTargetBillingStatus() {
     return this.http.get("/api/v2/billing/status");
   }
+  /** Read the canonical Metronome automatic recharge configuration. */
+  async getTargetAutoRecharge() {
+    return this.http.get(
+      "/api/v2/billing/auto-recharge"
+    );
+  }
+  /** Update automatic recharge and return the server-verified configuration. */
+  async updateTargetAutoRecharge(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    const response = await this.http.put(
+      "/api/v2/billing/auto-recharge",
+      options.enabled ? {
+        enabled: true,
+        threshold_credits: options.thresholdCredits,
+        refill_to_credits: options.refillToCredits
+      } : { enabled: false },
+      { "Idempotency-Key": idempotencyKey }
+    );
+    return response.data;
+  }
   /**
    * Purchase target-billing credits through the durable commercial operation
    * flow. The caller supplies an idempotency key for safe retries.

package/dist/index.mjs

@@ -706,7 +706,7 @@ var SDK_RELEASE = {
   // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
-  version: "0.3.22",
+  version: "0.3.23",
   updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
   contracts: {
     api: {
@@ -4281,6 +4281,10 @@ var DeeplineClient = class {
       },
       targetPlans: () => this.getTargetBillingPlans(),
       targetStatus: () => this.getTargetBillingStatus(),
+      autoRecharge: {
+        get: () => this.getTargetAutoRecharge(),
+        update: (options2) => this.updateTargetAutoRecharge(options2)
+      },
       purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
       transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
       portalSession: () => this.createTargetBillingPortalSession()
@@ -6366,6 +6370,28 @@ var DeeplineClient = class {
   async getTargetBillingStatus() {
     return this.http.get("/api/v2/billing/status");
   }
+  /** Read the canonical Metronome automatic recharge configuration. */
+  async getTargetAutoRecharge() {
+    return this.http.get(
+      "/api/v2/billing/auto-recharge"
+    );
+  }
+  /** Update automatic recharge and return the server-verified configuration. */
+  async updateTargetAutoRecharge(options) {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey
+    );
+    const response = await this.http.put(
+      "/api/v2/billing/auto-recharge",
+      options.enabled ? {
+        enabled: true,
+        threshold_credits: options.thresholdCredits,
+        refill_to_credits: options.refillToCredits
+      } : { enabled: false },
+      { "Idempotency-Key": idempotencyKey }
+    );
+    return response.data;
+  }
   /**
    * Purchase target-billing credits through the durable commercial operation
    * flow. The caller supplies an idempotency key for safe retries.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.22",
+  "version": "0.3.23",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",