deepline 0.2.12 → 0.2.14

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.12",
+  version: "0.2.14",
   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
   // ——————————————————————————————————————————————————————————
@@ -7123,6 +7185,29 @@ function isQueryResultDatasetTool(toolId) {
   return isCustomerDbDatasetTool(toolId) || isSnowflakeQueryDatasetTool(toolId);
 }
 
+// ../shared_libs/plays/input-contract-definition.ts
+function freezeInputSchema(schema) {
+  const visited = /* @__PURE__ */ new WeakSet();
+  const freeze = (value) => {
+    if (value === null || typeof value !== "object" || visited.has(value)) {
+      return;
+    }
+    visited.add(value);
+    for (const child of Object.values(value)) freeze(child);
+    Object.freeze(value);
+  };
+  freeze(schema);
+  return schema;
+}
+function createPlayInputContract(schema) {
+  if (!schema || typeof schema !== "object" || Array.isArray(schema)) {
+    throw new Error(
+      "defineInput<T>(schema) requires a JSON-schema-like object."
+    );
+  }
+  return Object.freeze({ schema: freezeInputSchema(schema) });
+}
+
 // src/play.ts
 var DeeplineConditionalStepResolver = class _DeeplineConditionalStepResolver {
   constructor(when, run, elseValue) {
@@ -7641,12 +7726,7 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
   );
 }
 function defineInput(schema) {
-  if (!schema || typeof schema !== "object" || Array.isArray(schema)) {
-    throw new Error(
-      "defineInput<T>(schema) requires a JSON-schema-like object."
-    );
-  }
-  return { schema };
+  return createPlayInputContract(schema);
 }
 function definePlay(nameOrConfig, maybeFn, maybeBindings) {
   const config = typeof nameOrConfig === "string" ? {

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.12",
+  version: "0.2.14",
   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
   // ——————————————————————————————————————————————————————————
@@ -7049,6 +7111,29 @@ function isQueryResultDatasetTool(toolId) {
   return isCustomerDbDatasetTool(toolId) || isSnowflakeQueryDatasetTool(toolId);
 }
 
+// ../shared_libs/plays/input-contract-definition.ts
+function freezeInputSchema(schema) {
+  const visited = /* @__PURE__ */ new WeakSet();
+  const freeze = (value) => {
+    if (value === null || typeof value !== "object" || visited.has(value)) {
+      return;
+    }
+    visited.add(value);
+    for (const child of Object.values(value)) freeze(child);
+    Object.freeze(value);
+  };
+  freeze(schema);
+  return schema;
+}
+function createPlayInputContract(schema) {
+  if (!schema || typeof schema !== "object" || Array.isArray(schema)) {
+    throw new Error(
+      "defineInput<T>(schema) requires a JSON-schema-like object."
+    );
+  }
+  return Object.freeze({ schema: freezeInputSchema(schema) });
+}
+
 // src/play.ts
 var DeeplineConditionalStepResolver = class _DeeplineConditionalStepResolver {
   constructor(when, run, elseValue) {
@@ -7567,12 +7652,7 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
   );
 }
 function defineInput(schema) {
-  if (!schema || typeof schema !== "object" || Array.isArray(schema)) {
-    throw new Error(
-      "defineInput<T>(schema) requires a JSON-schema-like object."
-    );
-  }
-  return { schema };
+  return createPlayInputContract(schema);
 }
 function definePlay(nameOrConfig, maybeFn, maybeBindings) {
   const config = typeof nameOrConfig === "string" ? {

package/dist/plays/bundle-play-file.d.mts

@@ -1,5 +1,6 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../tool-execution-error-4-rhemLQ.mjs';
-export { b as PLAY_ARTIFACT_KINDS } from '../tool-execution-error-4-rhemLQ.mjs';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-xFkbJX2B.mjs';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-xFkbJX2B.mjs';
+import '@sinclair/typebox';
 
 type PlayPackageImport = {
     name: string;
@@ -19,6 +20,8 @@ type PlayArtifactCompatibility = {
     runtimeBackend?: string | null;
     /** Missing preserves the legacy schema used before this field existed. */
     toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
+    /** Missing preserves edition 1 for artifacts created before authoring contracts were pinned. */
+    authoringContractEdition?: PlayAuthoringContractEdition;
 };
 /** The only executable Play artifact contract. */
 type PlayArtifactKind = 'cjs_node20';
@@ -40,12 +43,6 @@ type PlayBundleArtifact = {
     cacheHit: boolean;
 };
 
-type PlaySandboxSize = 'standard';
-type PlaySandboxRuntimeDeclaration = {
-    timeout?: string;
-    size?: PlaySandboxSize;
-};
-
 type ImportedPlayDependency = {
     filePath: string;
     playName: string;

package/dist/plays/bundle-play-file.d.ts

@@ -1,5 +1,6 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayArtifactKind$1, a as PlayCompilerManifest } from '../tool-execution-error-4-rhemLQ.js';
-export { b as PLAY_ARTIFACT_KINDS } from '../tool-execution-error-4-rhemLQ.js';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-xFkbJX2B.js';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-xFkbJX2B.js';
+import '@sinclair/typebox';
 
 type PlayPackageImport = {
     name: string;
@@ -19,6 +20,8 @@ type PlayArtifactCompatibility = {
     runtimeBackend?: string | null;
     /** Missing preserves the legacy schema used before this field existed. */
     toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
+    /** Missing preserves edition 1 for artifacts created before authoring contracts were pinned. */
+    authoringContractEdition?: PlayAuthoringContractEdition;
 };
 /** The only executable Play artifact contract. */
 type PlayArtifactKind = 'cjs_node20';
@@ -40,12 +43,6 @@ type PlayBundleArtifact = {
     cacheHit: boolean;
 };
 
-type PlaySandboxSize = 'standard';
-type PlaySandboxRuntimeDeclaration = {
-    timeout?: string;
-    size?: PlaySandboxSize;
-};
-
 type ImportedPlayDependency = {
     filePath: string;
     playName: string;