deepline 0.3.69 → 0.3.71

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

@@ -1233,6 +1233,29 @@ export type BillingPlansResult = {
   metrics: BillingMetricEntry[];
 };
 
+export type WorkspaceCreateResult = {
+  org_id: string;
+  org_name: string;
+  org_slug: string;
+  plan_sku: 'payg-v1';
+  rate_policy_ref: 'payg-rates-v2';
+  operation: {
+    id: string;
+    state: 'completed';
+    replayed: boolean;
+  };
+  request_id?: string;
+};
+
+/** Deliberate workspace lifecycle operations. */
+export type WorkspacesNamespace = {
+  /** Create an additional workspace and provision its active PAYG Contract. */
+  create: (options: {
+    name: string;
+    idempotencyKey: string;
+  }) => Promise<WorkspaceCreateResult>;
+};
+
 /**
  * Public billing namespace exposed as `client.billing`.
  *
@@ -1796,10 +1819,7 @@ function playRunStatusFromState(state: PlayLiveStatusState): PlayStatus {
 }
 
 /**
- * Low-level client for the Deepline REST API.
- *
- * Provides typed methods for every API endpoint: tools, plays, auth, and health.
- * Handles authentication, retries, and localhost failover automatically.
+ * Low-level typed REST client with authentication, retries, and localhost failover.
  *
  * @example
  * ```typescript
@@ -1826,6 +1846,8 @@ export class DeeplineClient {
   readonly db: DbNamespace;
   /** Billing namespace: subscription status/cancel and invoice history. */
   readonly billing: BillingNamespace;
+  /** Workspace lifecycle namespace. */
+  readonly workspaces: WorkspacesNamespace;
   /** Monitors namespace: access, catalog, deploy/check, and lifecycle. */
   readonly monitors: MonitorsNamespace;
 
@@ -1875,6 +1897,9 @@ export class DeeplineClient {
       transitionPlan: (options) => this.transitionTargetBillingPlan(options),
       portalSession: () => this.createTargetBillingPortalSession(),
     };
+    this.workspaces = {
+      create: (options) => this.createWorkspace(options),
+    };
     this.monitors = {
       status: () => this.getMonitorsAccess(),
       available: (toolIdOrOptions, options) =>
@@ -4765,6 +4790,31 @@ export class DeeplineClient {
     return response.data;
   }
 
+  /** Create an additional workspace through the durable PAYG workflow. */
+  async createWorkspace(options: {
+    name: string;
+    idempotencyKey: string;
+  }): Promise<WorkspaceCreateResult> {
+    const idempotencyKey = requireTargetBillingIdempotencyKey(
+      options.idempotencyKey,
+    );
+    const response = await this.http.post<{
+      data: Omit<WorkspaceCreateResult, 'operation' | 'request_id'>;
+      operation: WorkspaceCreateResult['operation'];
+      request_id?: string;
+    }>(
+      '/api/v2/workspaces',
+      { name: options.name },
+      { 'Idempotency-Key': idempotencyKey },
+      { maxRetries: 0, exactUrlOnly: true },
+    );
+    return {
+      ...response.data,
+      operation: response.operation,
+      ...(response.request_id ? { request_id: response.request_id } : {}),
+    };
+  }
+
   // ——————————————————————————————————————————————————————————
   // Monitors
   // ——————————————————————————————————————————————————————————

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

@@ -68,6 +68,8 @@ export type {
   BillingSubscriptionCancelResult,
   BillingSubscriptionStatus,
   BillingTopUpResult,
+  WorkspaceCreateResult,
+  WorkspacesNamespace,
   MonitorsNamespace,
   MonitorsAccessStatus,
   MonitorsAvailableOptions,

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

@@ -199,7 +199,7 @@ export const SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: '0.3.69',
+  version: '0.3.71',
   updateSummary:
     'Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.',
   packageCapabilities: {

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -3662,6 +3662,27 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     };
   }
 
+  /**
+   * A Deepline admission limit is decided before provider dispatch; the
+   * execute endpoint also releases its billing reservation on that path.
+   * Reclaim only this explicit, structured failure. A timeout, unreadable
+   * body, provider error, or unknown receipt can follow billable provider
+   * work and must remain behind its durable idempotency fence.
+   */
+  private canRetryWithoutProviderDispatch(
+    receipt: RuntimeStepReceipt,
+  ): boolean {
+    const failure = receipt.errorPayload;
+    return (
+      receipt.status === 'failed' &&
+      failure?.schemaVersion === 1 &&
+      failure.origin === 'deepline' &&
+      failure.category === 'rate_limit' &&
+      failure.code === 'RATE_LIMIT' &&
+      failure.retryable === true
+    );
+  }
+
   /**
    * Dispatch a batched runtime-step-receipt request in bounded chunks and
    * concatenate the aligned result arrays back into one array positioned
@@ -11010,6 +11031,22 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           );
           for (const [key, receipt] of claimed) claims.set(key, receipt);
         }
+        const safeFailedKeys = receipts.flatMap((receipt) => {
+          const claimed = claims.get(receipt.resultReceiptKey);
+          return claimed && this.canRetryWithoutProviderDispatch(claimed)
+            ? [receipt.resultReceiptKey]
+            : [];
+        });
+        if (safeFailedKeys.length > 0) {
+          const refreshed = await this.claimRuntimeStepReceipts(
+            safeFailedKeys,
+            this.currentReceiptOwnerRunId,
+            false,
+            false,
+            true,
+          );
+          for (const [key, receipt] of refreshed) claims.set(key, receipt);
+        }
         return await recordsFor(
           receipts.map((receipt) => receipt.resultReceiptKey),
           claims,
@@ -12238,6 +12275,23 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
             for (const [receiptKey, claim] of failedRefreshClaims) {
               claims.set(receiptKey, claim);
             }
+            const safeFailedReceiptKeys = [...claims]
+              .filter(([, claim]) =>
+                this.canRetryWithoutProviderDispatch(claim),
+              )
+              .map(([receiptKey]) => receiptKey);
+            if (safeFailedReceiptKeys.length > 0) {
+              const refreshed = await this.claimRuntimeStepReceipts(
+                safeFailedReceiptKeys,
+                this.currentReceiptOwnerRunId,
+                false,
+                false,
+                true,
+              );
+              for (const [receiptKey, claim] of refreshed) {
+                claims.set(receiptKey, claim);
+              }
+            }
             const claimedRequests: ToolCallRequest[] = [...localOnlyRequests];
             const durableRecoveredRequests: ToolCallRequest[] = [];
             const resolveRequestsFromReceipt = async (
@@ -13377,8 +13431,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
       );
     }
     const materialized = lifecycle.materialized!;
-    const selectedResponse =
-      lifecycle.finishResponse ?? lifecycle.pollResponse;
+    const selectedResponse = lifecycle.finishResponse ?? lifecycle.pollResponse;
     return {
       ...selectedResponse,
       status: