deepline 0.3.239 → 0.3.241

package/dist/index.d.ts

@@ -1269,6 +1269,11 @@ 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;
@@ -4533,6 +4538,15 @@ 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?: {
@@ -4863,7 +4877,9 @@ type BillingNamespace = {
     /** Start, change, cancel, or undo a target plan transition. */
     transitionPlan: (options: TargetBillingPlanTransitionOptions) => Promise<TargetBillingMutationResult>;
     /** Create a Stripe-hosted billing Portal session. */
-    portalSession: () => Promise<{
+    portalSession: (options?: {
+        flow?: 'customer_update';
+    }) => Promise<{
         url: string;
     }>;
 };
@@ -6022,7 +6038,9 @@ declare class DeeplineClient {
      */
     transitionTargetBillingPlan(options: TargetBillingPlanTransitionOptions): Promise<TargetBillingMutationResult>;
     /** Create a Stripe-hosted portal session for payment recovery and invoices. */
-    createTargetBillingPortalSession(): Promise<{
+    createTargetBillingPortalSession(options?: {
+        flow?: 'customer_update';
+    }): Promise<{
         url: string;
     }>;
     /** Create an additional workspace through the durable PAYG workflow. */

package/dist/index.js

@@ -814,6 +814,12 @@ function resolveConfig(options) {
   };
 }
 
+// ../integration-contracts/opensosdata/execution-policy.ts
+var OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS = 12e4;
+var OPENSOSDATA_POLL_INTERVAL_MS = 3e3;
+var OPENSOSDATA_POLL_TIMEOUT_MS = 9e4;
+var OPENSOSDATA_LOOKUP_CLIENT_TIMEOUT_MS = 6e4 + OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS + OPENSOSDATA_POLL_TIMEOUT_MS + OPENSOSDATA_POLL_INTERVAL_MS + OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS + 15e3;
+
 // ../integration-contracts/theirstack/execution-policy.ts
 var THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS = 135e3;
 var THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS = 6e4 + THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS + 15e3;
@@ -964,6 +970,9 @@ var APIFY_SYNC_DEFAULT_TIMEOUT_MS = 3e5;
 var APIFY_SYNC_RESPONSE_GRACE_MS = 9e4;
 function resolveToolExecuteTimeoutMs(toolId, input) {
   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 (typeof requestedTimeoutMs === "number" && Number.isFinite(requestedTimeoutMs) && requestedTimeoutMs > 0) {
@@ -1267,7 +1276,7 @@ var 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: {
     updatePreferences: 1
@@ -2022,6 +2031,7 @@ var HttpClient = class {
     let fetchAttempts = 0;
     let lastRequestUrl = url;
     let networkFailedAt;
+    let networkPhase = "before_request";
     const headers = this.authHeaders(options?.headers);
     if (options?.body !== void 0) {
       headers["Content-Type"] = "application/json";
@@ -2040,6 +2050,7 @@ var HttpClient = class {
         const backoffMs = Math.min(1e3 * Math.pow(2, attempt - 1), 3e4);
         const delayMs = retryAfterDelayMs === null ? backoffMs : Math.max(backoffMs, retryAfterDelayMs);
         retryAfterDelayMs = null;
+        networkPhase = "retry_wait";
         try {
           await sleep(delayMs, options?.signal);
         } catch (error) {
@@ -2065,16 +2076,19 @@ var HttpClient = class {
         options?.signal?.addEventListener("abort", abortRequest, {
           once: true
         });
+        networkPhase = "before_request";
         try {
           const requestBody = options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0;
           fetchAttempts += 1;
           lastRequestUrl = candidateUrl;
+          networkPhase = "awaiting_headers";
           const response = await fetch(candidateUrl, {
             method,
             headers,
             body: requestBody,
             signal: controller.signal
           });
+          networkPhase = "reading_body";
           options?.onResponse?.(response);
           if (response.status === 404 && options?.allowNotFound) {
             clearTimeout(timeoutId);
@@ -2217,7 +2231,8 @@ var HttpClient = class {
         failedAtUtc: new Date(failedAt).toISOString(),
         // Elapsed time covers the entire logical request, including retries.
         elapsedMs: Math.max(0, failedAt - requestStartedAt),
-        attempts: fetchAttempts
+        attempts: fetchAttempts,
+        phase: networkPhase
       }
     };
     if (options?.toolId) {
@@ -3992,7 +4007,7 @@ var DeeplineClient = class _DeeplineClient {
       purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
       recoverCreditPurchase: (options2) => this.recoverTargetBillingCreditPurchase(options2),
       transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
-      portalSession: () => this.createTargetBillingPortalSession()
+      portalSession: (options2) => this.createTargetBillingPortalSession(options2)
     };
     this.workspaces = {
       create: (options2) => this.createWorkspace(options2)
@@ -6513,8 +6528,11 @@ var DeeplineClient = class _DeeplineClient {
     );
   }
   /** Create a Stripe-hosted portal session for payment recovery and invoices. */
-  async createTargetBillingPortalSession() {
-    const response = await this.http.post("/api/v2/billing/portal-sessions", {});
+  async createTargetBillingPortalSession(options) {
+    const response = await this.http.post(
+      options?.flow === "customer_update" ? "/api/v2/billing/portal-sessions?flow=customer_update" : "/api/v2/billing/portal-sessions",
+      {}
+    );
     return response.data;
   }
   /** Create an additional workspace through the durable PAYG workflow. */

package/dist/index.mjs

@@ -718,6 +718,12 @@ function resolveConfig(options) {
   };
 }
 
+// ../integration-contracts/opensosdata/execution-policy.ts
+var OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS = 12e4;
+var OPENSOSDATA_POLL_INTERVAL_MS = 3e3;
+var OPENSOSDATA_POLL_TIMEOUT_MS = 9e4;
+var OPENSOSDATA_LOOKUP_CLIENT_TIMEOUT_MS = 6e4 + OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS + OPENSOSDATA_POLL_TIMEOUT_MS + OPENSOSDATA_POLL_INTERVAL_MS + OPENSOSDATA_LOOKUP_REQUEST_TIMEOUT_MS + 15e3;
+
 // ../integration-contracts/theirstack/execution-policy.ts
 var THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS = 135e3;
 var THEIRSTACK_SLOW_JOB_SEARCH_CLIENT_TIMEOUT_MS = 6e4 + THEIRSTACK_SLOW_JOB_SEARCH_PROVIDER_TIMEOUT_MS + 15e3;
@@ -868,6 +874,9 @@ var APIFY_SYNC_DEFAULT_TIMEOUT_MS = 3e5;
 var APIFY_SYNC_RESPONSE_GRACE_MS = 9e4;
 function resolveToolExecuteTimeoutMs(toolId, input) {
   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 (typeof requestedTimeoutMs === "number" && Number.isFinite(requestedTimeoutMs) && requestedTimeoutMs > 0) {
@@ -1171,7 +1180,7 @@ var 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: {
     updatePreferences: 1
@@ -1926,6 +1935,7 @@ var HttpClient = class {
     let fetchAttempts = 0;
     let lastRequestUrl = url;
     let networkFailedAt;
+    let networkPhase = "before_request";
     const headers = this.authHeaders(options?.headers);
     if (options?.body !== void 0) {
       headers["Content-Type"] = "application/json";
@@ -1944,6 +1954,7 @@ var HttpClient = class {
         const backoffMs = Math.min(1e3 * Math.pow(2, attempt - 1), 3e4);
         const delayMs = retryAfterDelayMs === null ? backoffMs : Math.max(backoffMs, retryAfterDelayMs);
         retryAfterDelayMs = null;
+        networkPhase = "retry_wait";
         try {
           await sleep(delayMs, options?.signal);
         } catch (error) {
@@ -1969,16 +1980,19 @@ var HttpClient = class {
         options?.signal?.addEventListener("abort", abortRequest, {
           once: true
         });
+        networkPhase = "before_request";
         try {
           const requestBody = options?.formData !== void 0 ? typeof options.formData === "function" ? options.formData() : options.formData : options?.body !== void 0 ? JSON.stringify(options.body) : void 0;
           fetchAttempts += 1;
           lastRequestUrl = candidateUrl;
+          networkPhase = "awaiting_headers";
           const response = await fetch(candidateUrl, {
             method,
             headers,
             body: requestBody,
             signal: controller.signal
           });
+          networkPhase = "reading_body";
           options?.onResponse?.(response);
           if (response.status === 404 && options?.allowNotFound) {
             clearTimeout(timeoutId);
@@ -2121,7 +2135,8 @@ var HttpClient = class {
         failedAtUtc: new Date(failedAt).toISOString(),
         // Elapsed time covers the entire logical request, including retries.
         elapsedMs: Math.max(0, failedAt - requestStartedAt),
-        attempts: fetchAttempts
+        attempts: fetchAttempts,
+        phase: networkPhase
       }
     };
     if (options?.toolId) {
@@ -3896,7 +3911,7 @@ var DeeplineClient = class _DeeplineClient {
       purchaseCredits: (options2) => this.purchaseTargetBillingCredits(options2),
       recoverCreditPurchase: (options2) => this.recoverTargetBillingCreditPurchase(options2),
       transitionPlan: (options2) => this.transitionTargetBillingPlan(options2),
-      portalSession: () => this.createTargetBillingPortalSession()
+      portalSession: (options2) => this.createTargetBillingPortalSession(options2)
     };
     this.workspaces = {
       create: (options2) => this.createWorkspace(options2)
@@ -6417,8 +6432,11 @@ var DeeplineClient = class _DeeplineClient {
     );
   }
   /** Create a Stripe-hosted portal session for payment recovery and invoices. */
-  async createTargetBillingPortalSession() {
-    const response = await this.http.post("/api/v2/billing/portal-sessions", {});
+  async createTargetBillingPortalSession(options) {
+    const response = await this.http.post(
+      options?.flow === "customer_update" ? "/api/v2/billing/portal-sessions?flow=customer_update" : "/api/v2/billing/portal-sessions",
+      {}
+    );
     return response.data;
   }
   /** Create an additional workspace through the durable PAYG workflow. */

package/dist/install-integrity.json

@@ -33,6 +33,7 @@
     "dist/bundling-sources/shared_libs/integration-contracts/index.ts",
     "dist/bundling-sources/shared_libs/integration-contracts/monitor-fleet-contract.ts",
     "dist/bundling-sources/shared_libs/integration-contracts/monitor-input-contract.ts",
+    "dist/bundling-sources/shared_libs/integration-contracts/opensosdata/execution-policy.ts",
     "dist/bundling-sources/shared_libs/integration-contracts/README.md",
     "dist/bundling-sources/shared_libs/integration-contracts/theirstack/execution-policy.ts",
     "dist/bundling-sources/shared_libs/integration-contracts/waterfall/execution-policy.ts",

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.239";
+    readonly version: "0.3.241";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.239";
+    readonly version: "0.3.241";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var 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: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var 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: {
     updatePreferences: 1

package/package.json

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