deepline 0.3.239 → 0.3.241

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

@@ -1806,6 +1806,15 @@ export type TargetBillingStatusResult = {
   payment_state: string;
   recharge_state: string;
   billing_email?: string | null;
+  /** Omitted when unavailable; null when no address has been saved. */
+  billing_address?: {
+    line1: string | null;
+    line2: string | null;
+    city: string | null;
+    state: string | null;
+    postal_code: string | null;
+    country: string | null;
+  } | null;
   collection_method?: 'charge_automatically' | 'send_invoice';
   payment_access_policy?: 'payment_required' | 'net_30' | 'net_60';
   plan_invoice?: {
@@ -2163,7 +2172,9 @@ export type BillingNamespace = {
     options: TargetBillingPlanTransitionOptions,
   ) => Promise<TargetBillingMutationResult>;
   /** Create a Stripe-hosted billing Portal session. */
-  portalSession: () => Promise<{ url: string }>;
+  portalSession: (options?: {
+    flow?: 'customer_update';
+  }) => Promise<{ url: string }>;
 };
 
 function requireTargetBillingIdempotencyKey(value: string): string {
@@ -2713,7 +2724,8 @@ export class DeeplineClient {
       recoverCreditPurchase: (options) =>
         this.recoverTargetBillingCreditPurchase(options),
       transitionPlan: (options) => this.transitionTargetBillingPlan(options),
-      portalSession: () => this.createTargetBillingPortalSession(),
+      portalSession: (options) =>
+        this.createTargetBillingPortalSession(options),
     };
     this.workspaces = {
       create: (options) => this.createWorkspace(options),
@@ -6154,11 +6166,18 @@ export class DeeplineClient {
   }
 
   /** Create a Stripe-hosted portal session for payment recovery and invoices. */
-  async createTargetBillingPortalSession(): Promise<{ url: string }> {
+  async createTargetBillingPortalSession(options?: {
+    flow?: 'customer_update';
+  }): Promise<{ url: string }> {
     const response = await this.http.post<{
       data: { url: string };
       request_id?: string;
-    }>('/api/v2/billing/portal-sessions', {});
+    }>(
+      options?.flow === 'customer_update'
+        ? '/api/v2/billing/portal-sessions?flow=customer_update'
+        : '/api/v2/billing/portal-sessions',
+      {},
+    );
     return response.data;
   }
 

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

@@ -395,6 +395,11 @@ export class HttpClient {
     let fetchAttempts = 0;
     let lastRequestUrl = url;
     let networkFailedAt: number | undefined;
+    let networkPhase:
+      | 'before_request'
+      | 'retry_wait'
+      | 'awaiting_headers'
+      | 'reading_body' = 'before_request';
 
     const headers = this.authHeaders(options?.headers);
 
@@ -423,6 +428,7 @@ export class HttpClient {
             ? backoffMs
             : Math.max(backoffMs, retryAfterDelayMs);
         retryAfterDelayMs = null;
+        networkPhase = 'retry_wait';
         try {
           await sleep(delayMs, options?.signal);
         } catch (error) {
@@ -450,6 +456,7 @@ export class HttpClient {
           once: true,
         });
 
+        networkPhase = 'before_request';
         try {
           const requestBody =
             options?.formData !== undefined
@@ -461,6 +468,7 @@ export class HttpClient {
                 : undefined;
           fetchAttempts += 1;
           lastRequestUrl = candidateUrl;
+          networkPhase = 'awaiting_headers';
           const response = await fetch(candidateUrl, {
             method,
             headers,
@@ -468,6 +476,7 @@ export class HttpClient {
             signal: controller.signal,
           });
 
+          networkPhase = 'reading_body';
           options?.onResponse?.(response);
           if (response.status === 404 && options?.allowNotFound) {
             clearTimeout(timeoutId);
@@ -671,6 +680,7 @@ export class HttpClient {
         // Elapsed time covers the entire logical request, including retries.
         elapsedMs: Math.max(0, failedAt - requestStartedAt),
         attempts: fetchAttempts,
+        phase: networkPhase,
       },
     };
     if (options?.toolId) {

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

@@ -200,7 +200,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.239',
+  version: '0.3.241',
   updateSummary:
     'Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.',
   packageCapabilities: {

package/dist/bundling-sources/sdk/src/tool-calls.ts

@@ -1,3 +1,4 @@
+import { OPENSOSDATA_LOOKUP_CLIENT_TIMEOUT_MS } from '../../shared_libs/integration-contracts/opensosdata/execution-policy.js';
 import type { ToolResultBilling } from '../../shared_libs/plays/tool-result-types.js';
 import { resolveTheirstackClientTimeoutMs } from '../../shared_libs/integration-contracts/theirstack/execution-policy.js';
 import { resolveWaterfallClientTimeoutMs } from '../../shared_libs/integration-contracts/waterfall/execution-policy.js';
@@ -172,6 +173,9 @@ function resolveToolExecuteTimeoutMs(
   input: Record<string, unknown>,
 ): number | undefined {
   const normalized = toolId.trim().toLowerCase();
+  if (normalized === 'opensosdata_business_lookup') {
+    return OPENSOSDATA_LOOKUP_CLIENT_TIMEOUT_MS;
+  }
   if (normalized === 'apify_run_actor_sync') {
     const requestedTimeoutMs = input.timeoutMs ?? APIFY_SYNC_DEFAULT_TIMEOUT_MS;
     if (

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

@@ -228,6 +228,8 @@ export interface ToolDefinition extends ToolExecutionMetadataFields {
   outputSchema?: Record<string, unknown>;
   /** User-facing pricing summary. Internal provider/settlement costs are intentionally omitted. */
   pricing?: ToolPricingSummary | null;
+  /** How to use the tool well: the provider's summary and the tool's own notes. */
+  guidance?: { provider?: string; tool?: string };
   /** Copyable play-runtime guidance for V2 tool execution results. */
   usageGuidance?: {
     execute?: string;

package/dist/bundling-sources/shared_libs/integration-contracts/opensosdata/execution-policy.ts

@@ -0,0 +1,18 @@
+/** OpenSOSData's single-entity lookup can complete synchronously or poll a 202 job. */
+export const OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS = 120_000;
+export const OPENSOSDATA_POLL_INTERVAL_MS = 3_000;
+export const OPENSOSDATA_POLL_TIMEOUT_MS = 90_000;
+
+/**
+ * Preserve the provider's existing request and polling windows. A final poll
+ * can begin just before the poll window ends, so include that in-flight request
+ * as well as route/admission and response overhead. Explicit caller deadlines
+ * still take precedence; unrelated tools retain their existing budgets.
+ */
+export const OPENSOSDATA_LOOKUP_CLIENT_TIMEOUT_MS =
+  60_000 +
+  OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS +
+  OPENSOSDATA_POLL_TIMEOUT_MS +
+  OPENSOSDATA_POLL_INTERVAL_MS +
+  OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS +
+  15_000;

package/dist/bundling-sources/shared_libs/play-runtime/deployment/runtime-topology.ts

@@ -187,8 +187,16 @@ export const RUNTIME_TOPOLOGY = {
           dockerfile: 'deploy/fly/runtime-worker/Dockerfile.absurd-scaler',
         },
         processGroups: {
-          app: { desiredStarted: 1, healthCheck: 'scaler_ready' },
-          projector: { desiredStarted: 2, healthCheck: 'projector_ready' },
+          app: {
+            desiredStarted: 1,
+            healthCheck: 'scaler_ready',
+            guest: { cpu_kind: 'shared', cpus: 1, memory_mb: 256 },
+          },
+          projector: {
+            desiredStarted: 2,
+            healthCheck: 'projector_ready',
+            guest: { cpu_kind: 'shared', cpus: 1, memory_mb: 1024 },
+          },
         },
       },
       workerLogShipper: {