deepline 0.2.16 → 0.2.18

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

@@ -77,6 +77,7 @@ import type {
   ToolMetadata,
   CustomerDbQueryResult,
   DeeplineAgentModelDescription,
+  InferenceQuote,
 } from './types.js';
 import type { MonitorDefinition } from './monitors.js';
 import type { PlayStagedFileRef } from './plays/local-file-discovery.js';
@@ -1919,6 +1920,22 @@ export class DeeplineClient {
     );
   }
 
+  /**
+   * Quote dynamic AI inference pricing for a concrete payload.
+   *
+   * The result separates a planning estimate from a proven authorization
+   * maximum and contains Deepline credits only.
+   */
+  async quoteInferenceTool(
+    toolId: 'ai_inference' | 'deeplineagent',
+    payload: Record<string, unknown>,
+  ): Promise<InferenceQuote> {
+    return this.http.post<InferenceQuote>(
+      `/api/v2/integrations/${encodeURIComponent(toolId)}/quote`,
+      payload,
+    );
+  }
+
   /**
    * Execute a tool and return the standard execution envelope.
    *

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

@@ -160,7 +160,7 @@ export const 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.16',
+  version: '0.2.18',
   contracts: {
     api: {
       name: 'sdk-http-api',

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

@@ -336,8 +336,51 @@ export interface DeeplineAgentModelDescription {
   };
   caveats: string[];
   sources: string[];
+  inferencePricing: InferenceDynamicPricingCapability;
 }
 
+export interface InferenceDynamicPricingCapability {
+  settlement: 'actual_usage';
+  staticUnitPrice: null;
+  quoteEndpointTemplate: string;
+  supportedQualities: Array<'bounded_max' | 'estimate_only' | 'unavailable'>;
+  payloadFields: string[];
+}
+
+export type InferenceQuoteAssumptions = {
+  modelCallCount: number;
+  planningModelCallCount: number;
+  estimatedInputTokens: number;
+  estimatedOutputTokens: number;
+  maxOutputTokens: number | null;
+  candidateRouteCount: number;
+  pricedRouteCount: number;
+  inputBound: 'proven_request_tokens' | 'catalog_context' | 'not_proven';
+  inputBoundProofId?: string;
+};
+
+export type InferenceQuote = {
+  quality: 'bounded_max' | 'estimate_only' | 'unavailable';
+  estimate:
+    | {
+        quality: 'estimate_only';
+        credits: number;
+        assumptions: InferenceQuoteAssumptions;
+      }
+    | { quality: 'unavailable'; assumptions: InferenceQuoteAssumptions };
+  authorization:
+    | {
+        quality: 'bounded_max';
+        maximumCredits: number;
+        assumptions: InferenceQuoteAssumptions;
+      }
+    | {
+        quality: 'estimate_only' | 'unavailable';
+        assumptions: InferenceQuoteAssumptions;
+      };
+  settlement: 'actual_usage';
+};
+
 /**
  * Query options for ranked tool/provider discovery.
  */

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

@@ -7617,6 +7617,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     const compositionNamespace = this.inlineChildCompositionNamespace(
       resolvedName,
       normalizedKey,
+      input,
     );
     const inlineChildGovernor =
       await this.currentExecutionGovernor.forkInlineChild({
@@ -7728,35 +7729,42 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
   }
 
   /**
-   * Replay-stable composition namespace for one inline `ctx.runPlay`
-   * invocation. Format `child:<playName>#<callKey>[@<rowScope>]`:
+   * Replay-stable receipt namespace for primitives executed by one inline
+   * `ctx.runPlay` invocation. Format
+   * `child:<playName>#<callKey>@<invocationDigest>`:
    *
    *   - `callKey` is the author's normalized `ctx.runPlay(key, ...)` call key,
    *     so distinct call sites never collide.
-   *   - `rowScope` (table namespace + row key) is appended when the invocation
-   *     runs inside a map/dataset row resolver, so the SAME call site invoked
-   *     across rows scopes each row's child step receipts separately.
+   *   - `invocationDigest` hashes the resolved child input and inherited row
+   *     scope. The row scope keeps concurrent map invocations isolated; the
+   *     input prevents two different people at an otherwise identical caller
+   *     row from ever recovering one another's child step or fetch receipt.
    *
-   * The namespace is derived purely from authored, content-stable inputs —
-   * never from arrival order — so a retried run attempt reproduces the same
-   * namespace under any row-completion interleaving and the child's tool
-   * receipts (owned by the PARENT run) recover instead of re-billing. Inline
-   * children carry NO durable run id — this namespace is their only identity.
-   * See ADR 0013.
+   * This is not a `runPlay` result cache: `runPlay` always executes the child.
+   * It only scopes the child's own durable step and fetch receipts. Parent run
+   * identity is intentionally excluded, allowing semantically identical child
+   * work to recover across retries and parent runs without permitting a
+   * different child input to reuse a result. See ADR 0013.
    */
   private inlineChildCompositionNamespace(
     childPlayName: string,
     normalizedKey: string,
+    input: Record<string, unknown>,
   ): string {
     const rowScope = rowContext.getStore();
-    const rowScopeKey = rowScope
-      ? `${rowScope.tableNamespace ?? rowScope.fieldName ?? 'rows'}:${
-          rowScope.rowKey ?? String(rowScope.rowId)
-        }`
-      : '';
-    const namespace = `child:${childPlayName}#${normalizedKey}${
-      rowScopeKey ? `@${rowScopeKey}` : ''
-    }`;
+    const invocationScope = buildDurableRunPlayInvocationScope({
+      childPlayName,
+      input,
+      rowScope: rowScope
+        ? {
+            tableNamespace: rowScope.tableNamespace ?? null,
+            rowKey: rowScope.rowKey ?? null,
+            rowId: rowScope.rowKey ? null : rowScope.rowId,
+            fieldName: rowScope.fieldName ?? null,
+          }
+        : null,
+    });
+    const namespace = `child:${childPlayName}#${normalizedKey}@${invocationScope}`;
     if (rowScope) {
       const namespaces = (rowScope.inlineChildInvocationNamespaces ??=
         new Set<string>());
@@ -8138,6 +8146,11 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
                 rowId: rowStore.rowKey ? null : rowStore.rowId,
                 fieldName: rowStore.fieldName ?? null,
                 callIndex,
+                // Row scope prevents unrelated map cells from sharing a
+                // checkpoint. A supplied semantic key identifies the actual
+                // work (for example, ctx.runSteps hashes its current input),
+                // so it must refine row scope rather than being discarded.
+                semanticKey: options?.semanticKey ?? null,
               }),
             )
           : options?.semanticKey,

package/dist/bundling-sources/shared_libs/play-runtime/run-failure.ts

@@ -1,3 +1,5 @@
+import { ToolExecutionError } from '../tool-execution-error';
+
 const CLOUDFLARE_DURABLE_OBJECT_RESET_RE =
   /Durable Object.*(?:code (?:was|has been) updated|storage caused object)/;
 const CLOUDFLARE_WORKER_SUBREQUEST_LIMIT_RE =
@@ -280,6 +282,20 @@ function toErrorText(error: unknown): string {
 export function normalizePlayRunFailure(error: unknown): PlayRunFailureDetails {
   const rawCause = toErrorText(error);
   const cause = boundedFailureText(rawCause);
+  if (
+    error instanceof ToolExecutionError &&
+    error.origin === 'deepline' &&
+    error.category === 'billing' &&
+    error.code !== 'BILLING_UNAVAILABLE'
+  ) {
+    return {
+      code: error.code?.trim() || 'BILLING_DENIED',
+      phase: 'billing',
+      message: cause,
+      retryable: false,
+      cause,
+    };
+  }
   if (
     (error &&
       typeof error === 'object' &&

package/dist/cli/index.js

@@ -1044,7 +1044,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.16",
+  version: "0.2.18",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -4040,6 +4040,18 @@ var DeeplineClient = class {
       }
     );
   }
+  /**
+   * Quote dynamic AI inference pricing for a concrete payload.
+   *
+   * The result separates a planning estimate from a proven authorization
+   * maximum and contains Deepline credits only.
+   */
+  async quoteInferenceTool(toolId, payload) {
+    return this.http.post(
+      `/api/v2/integrations/${encodeURIComponent(toolId)}/quote`,
+      payload
+    );
+  }
   /**
    * Execute a tool and return the standard execution envelope.
    *
@@ -33005,11 +33017,15 @@ Examples:
   deepline tools describe hunter_email_verifier --examples-only
   deepline tools describe hunter_email_verifier --json
   deepline tools describe deeplineagent --model openai/gpt-5.5 --json
+  deepline tools describe ai_inference --estimate-payload @payload.json --json
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
 `
   ).option("--json", "Emit JSON output. Also automatic when stdout is piped").option(
     "--model <model>",
     "For deeplineagent, include AI Gateway model/provider option metadata"
+  ).option(
+    "--estimate-payload <payload>",
+    "Quote an ai_inference or deeplineagent JSON payload (inline or @file)"
   ).option("--pricing-only", "Only print pricing and billing semantics").option("--schema-only", "Only print input schema fields").option(
     "--examples-only",
     "Only print runnable examples and sample payloads"
@@ -33032,7 +33048,8 @@ Examples:
       schemaOnly: Boolean(options.schemaOnly),
       examplesOnly: Boolean(options.examplesOnly),
       gettersOnly: Boolean(options.gettersOnly),
-      model: typeof options.model === "string" ? options.model : void 0
+      model: typeof options.model === "string" ? options.model : void 0,
+      estimatePayload: typeof options.estimatePayload === "string" ? options.estimatePayload : void 0
     });
   });
   addToolMetadataCommand(tools.command("describe <toolId>").alias("get"));
@@ -33106,6 +33123,23 @@ async function getTool(toolId, options = {}) {
     }
     throw error;
   }
+  let inferenceQuote = null;
+  if (options.estimatePayload) {
+    if (toolId !== "deeplineagent" && toolId !== "ai_inference") {
+      console.error(
+        "--estimate-payload is only supported for deeplineagent and ai_inference."
+      );
+      return 2;
+    }
+    const estimatePayload = parseJsonObjectArgument(
+      options.estimatePayload,
+      "--estimate-payload"
+    );
+    if (options.model && estimatePayload.model === void 0) {
+      estimatePayload.model = options.model;
+    }
+    inferenceQuote = await client2.quoteInferenceTool(toolId, estimatePayload);
+  }
   const modelDescription = options.model && (toolId === "deeplineagent" || toolId === "ai_inference") ? await client2.describeModel(options.model) : null;
   if (options.model && !modelDescription) {
     console.error(
@@ -33117,7 +33151,8 @@ async function getTool(toolId, options = {}) {
     process.stdout.write(
       `${JSON.stringify({
         ...toolContractJsonForDescribe(tool, toolId),
-        ...modelDescription ? { modelOptions: modelDescription } : {}
+        ...modelDescription ? { modelOptions: modelDescription } : {},
+        ...inferenceQuote ? { inferenceQuote } : {}
       })}
 `
     );
@@ -33128,7 +33163,8 @@ async function getTool(toolId, options = {}) {
     process.stdout.write(
       `${JSON.stringify({
         ...toolMetadataJsonForDescribe(tool, toolId),
-        ...modelDescription ? { modelOptions: modelDescription } : {}
+        ...modelDescription ? { modelOptions: modelDescription } : {},
+        ...inferenceQuote ? { inferenceQuote } : {}
       })}
 `
     );
@@ -33148,18 +33184,22 @@ async function getTool(toolId, options = {}) {
   }
   if (options.pricingOnly) {
     printToolPricingOnly(tool, toolId);
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (options.schemaOnly) {
     printToolSchemaOnly(tool, toolId);
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (options.examplesOnly) {
     printToolExamplesOnly(tool, toolId);
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (options.gettersOnly) {
     printToolGettersOnly(tool, toolId);
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (options.compact) {
@@ -33168,13 +33208,15 @@ async function getTool(toolId, options = {}) {
       process.stdout.write(`
 ${formatModelDescription(modelDescription)}`);
     }
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (shouldEmitJson()) {
     process.stdout.write(
       `${JSON.stringify({
         ...toolContractJsonForDescribe(tool, toolId),
-        ...modelDescription ? { modelOptions: modelDescription } : {}
+        ...modelDescription ? { modelOptions: modelDescription } : {},
+        ...inferenceQuote ? { inferenceQuote } : {}
       })}
 `
     );
@@ -33185,8 +33227,26 @@ ${formatModelDescription(modelDescription)}`);
     process.stdout.write(`
 ${formatModelDescription(modelDescription)}`);
   }
+  if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
   return 0;
 }
+function printInferenceQuoteSummary(quote) {
+  console.log("");
+  console.log("Inference quote:");
+  if (quote.estimate.quality === "estimate_only") {
+    console.log(`- Planning estimate: ${quote.estimate.credits} credits`);
+  } else {
+    console.log("- Planning estimate: unavailable");
+  }
+  if (quote.authorization.quality === "bounded_max") {
+    console.log(
+      `- Maximum authorization: ${quote.authorization.maximumCredits} credits`
+    );
+  } else {
+    console.log(`- Maximum authorization: ${quote.authorization.quality}`);
+  }
+  console.log("- Settlement: actual usage");
+}
 function toolContractJsonForDescribe(tool, requestedToolId) {
   const toolId = String(tool.toolId || requestedToolId);
   const inputFields = toolInputFieldsForDisplay(

package/dist/cli/index.mjs

@@ -1030,7 +1030,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.16",
+  version: "0.2.18",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -4026,6 +4026,18 @@ var DeeplineClient = class {
       }
     );
   }
+  /**
+   * Quote dynamic AI inference pricing for a concrete payload.
+   *
+   * The result separates a planning estimate from a proven authorization
+   * maximum and contains Deepline credits only.
+   */
+  async quoteInferenceTool(toolId, payload) {
+    return this.http.post(
+      `/api/v2/integrations/${encodeURIComponent(toolId)}/quote`,
+      payload
+    );
+  }
   /**
    * Execute a tool and return the standard execution envelope.
    *
@@ -33068,11 +33080,15 @@ Examples:
   deepline tools describe hunter_email_verifier --examples-only
   deepline tools describe hunter_email_verifier --json
   deepline tools describe deeplineagent --model openai/gpt-5.5 --json
+  deepline tools describe ai_inference --estimate-payload @payload.json --json
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
 `
   ).option("--json", "Emit JSON output. Also automatic when stdout is piped").option(
     "--model <model>",
     "For deeplineagent, include AI Gateway model/provider option metadata"
+  ).option(
+    "--estimate-payload <payload>",
+    "Quote an ai_inference or deeplineagent JSON payload (inline or @file)"
   ).option("--pricing-only", "Only print pricing and billing semantics").option("--schema-only", "Only print input schema fields").option(
     "--examples-only",
     "Only print runnable examples and sample payloads"
@@ -33095,7 +33111,8 @@ Examples:
       schemaOnly: Boolean(options.schemaOnly),
       examplesOnly: Boolean(options.examplesOnly),
       gettersOnly: Boolean(options.gettersOnly),
-      model: typeof options.model === "string" ? options.model : void 0
+      model: typeof options.model === "string" ? options.model : void 0,
+      estimatePayload: typeof options.estimatePayload === "string" ? options.estimatePayload : void 0
     });
   });
   addToolMetadataCommand(tools.command("describe <toolId>").alias("get"));
@@ -33169,6 +33186,23 @@ async function getTool(toolId, options = {}) {
     }
     throw error;
   }
+  let inferenceQuote = null;
+  if (options.estimatePayload) {
+    if (toolId !== "deeplineagent" && toolId !== "ai_inference") {
+      console.error(
+        "--estimate-payload is only supported for deeplineagent and ai_inference."
+      );
+      return 2;
+    }
+    const estimatePayload = parseJsonObjectArgument(
+      options.estimatePayload,
+      "--estimate-payload"
+    );
+    if (options.model && estimatePayload.model === void 0) {
+      estimatePayload.model = options.model;
+    }
+    inferenceQuote = await client2.quoteInferenceTool(toolId, estimatePayload);
+  }
   const modelDescription = options.model && (toolId === "deeplineagent" || toolId === "ai_inference") ? await client2.describeModel(options.model) : null;
   if (options.model && !modelDescription) {
     console.error(
@@ -33180,7 +33214,8 @@ async function getTool(toolId, options = {}) {
     process.stdout.write(
       `${JSON.stringify({
         ...toolContractJsonForDescribe(tool, toolId),
-        ...modelDescription ? { modelOptions: modelDescription } : {}
+        ...modelDescription ? { modelOptions: modelDescription } : {},
+        ...inferenceQuote ? { inferenceQuote } : {}
       })}
 `
     );
@@ -33191,7 +33226,8 @@ async function getTool(toolId, options = {}) {
     process.stdout.write(
       `${JSON.stringify({
         ...toolMetadataJsonForDescribe(tool, toolId),
-        ...modelDescription ? { modelOptions: modelDescription } : {}
+        ...modelDescription ? { modelOptions: modelDescription } : {},
+        ...inferenceQuote ? { inferenceQuote } : {}
       })}
 `
     );
@@ -33211,18 +33247,22 @@ async function getTool(toolId, options = {}) {
   }
   if (options.pricingOnly) {
     printToolPricingOnly(tool, toolId);
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (options.schemaOnly) {
     printToolSchemaOnly(tool, toolId);
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (options.examplesOnly) {
     printToolExamplesOnly(tool, toolId);
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (options.gettersOnly) {
     printToolGettersOnly(tool, toolId);
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (options.compact) {
@@ -33231,13 +33271,15 @@ async function getTool(toolId, options = {}) {
       process.stdout.write(`
 ${formatModelDescription(modelDescription)}`);
     }
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
   if (shouldEmitJson()) {
     process.stdout.write(
       `${JSON.stringify({
         ...toolContractJsonForDescribe(tool, toolId),
-        ...modelDescription ? { modelOptions: modelDescription } : {}
+        ...modelDescription ? { modelOptions: modelDescription } : {},
+        ...inferenceQuote ? { inferenceQuote } : {}
       })}
 `
     );
@@ -33248,8 +33290,26 @@ ${formatModelDescription(modelDescription)}`);
     process.stdout.write(`
 ${formatModelDescription(modelDescription)}`);
   }
+  if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
   return 0;
 }
+function printInferenceQuoteSummary(quote) {
+  console.log("");
+  console.log("Inference quote:");
+  if (quote.estimate.quality === "estimate_only") {
+    console.log(`- Planning estimate: ${quote.estimate.credits} credits`);
+  } else {
+    console.log("- Planning estimate: unavailable");
+  }
+  if (quote.authorization.quality === "bounded_max") {
+    console.log(
+      `- Maximum authorization: ${quote.authorization.maximumCredits} credits`
+    );
+  } else {
+    console.log(`- Maximum authorization: ${quote.authorization.quality}`);
+  }
+  console.log("- Settlement: actual usage");
+}
 function toolContractJsonForDescribe(tool, requestedToolId) {
   const toolId = String(tool.toolId || requestedToolId);
   const inputFields = toolInputFieldsForDisplay(

package/dist/index.d.mts

@@ -411,7 +411,46 @@ interface DeeplineAgentModelDescription {
     };
     caveats: string[];
     sources: string[];
+    inferencePricing: InferenceDynamicPricingCapability;
 }
+interface InferenceDynamicPricingCapability {
+    settlement: 'actual_usage';
+    staticUnitPrice: null;
+    quoteEndpointTemplate: string;
+    supportedQualities: Array<'bounded_max' | 'estimate_only' | 'unavailable'>;
+    payloadFields: string[];
+}
+type InferenceQuoteAssumptions = {
+    modelCallCount: number;
+    planningModelCallCount: number;
+    estimatedInputTokens: number;
+    estimatedOutputTokens: number;
+    maxOutputTokens: number | null;
+    candidateRouteCount: number;
+    pricedRouteCount: number;
+    inputBound: 'proven_request_tokens' | 'catalog_context' | 'not_proven';
+    inputBoundProofId?: string;
+};
+type InferenceQuote = {
+    quality: 'bounded_max' | 'estimate_only' | 'unavailable';
+    estimate: {
+        quality: 'estimate_only';
+        credits: number;
+        assumptions: InferenceQuoteAssumptions;
+    } | {
+        quality: 'unavailable';
+        assumptions: InferenceQuoteAssumptions;
+    };
+    authorization: {
+        quality: 'bounded_max';
+        maximumCredits: number;
+        assumptions: InferenceQuoteAssumptions;
+    } | {
+        quality: 'estimate_only' | 'unavailable';
+        assumptions: InferenceQuoteAssumptions;
+    };
+    settlement: 'actual_usage';
+};
 /**
  * Query options for ranked tool/provider discovery.
  */
@@ -2446,6 +2485,13 @@ declare class DeeplineClient {
      * @returns Model metadata, provider option shapes, and runnable examples
      */
     describeModel(model: string): Promise<DeeplineAgentModelDescription>;
+    /**
+     * Quote dynamic AI inference pricing for a concrete payload.
+     *
+     * The result separates a planning estimate from a proven authorization
+     * maximum and contains Deepline credits only.
+     */
+    quoteInferenceTool(toolId: 'ai_inference' | 'deeplineagent', payload: Record<string, unknown>): Promise<InferenceQuote>;
     /**
      * Execute a tool and return the standard execution envelope.
      *

package/dist/index.d.ts

@@ -411,7 +411,46 @@ interface DeeplineAgentModelDescription {
     };
     caveats: string[];
     sources: string[];
+    inferencePricing: InferenceDynamicPricingCapability;
 }
+interface InferenceDynamicPricingCapability {
+    settlement: 'actual_usage';
+    staticUnitPrice: null;
+    quoteEndpointTemplate: string;
+    supportedQualities: Array<'bounded_max' | 'estimate_only' | 'unavailable'>;
+    payloadFields: string[];
+}
+type InferenceQuoteAssumptions = {
+    modelCallCount: number;
+    planningModelCallCount: number;
+    estimatedInputTokens: number;
+    estimatedOutputTokens: number;
+    maxOutputTokens: number | null;
+    candidateRouteCount: number;
+    pricedRouteCount: number;
+    inputBound: 'proven_request_tokens' | 'catalog_context' | 'not_proven';
+    inputBoundProofId?: string;
+};
+type InferenceQuote = {
+    quality: 'bounded_max' | 'estimate_only' | 'unavailable';
+    estimate: {
+        quality: 'estimate_only';
+        credits: number;
+        assumptions: InferenceQuoteAssumptions;
+    } | {
+        quality: 'unavailable';
+        assumptions: InferenceQuoteAssumptions;
+    };
+    authorization: {
+        quality: 'bounded_max';
+        maximumCredits: number;
+        assumptions: InferenceQuoteAssumptions;
+    } | {
+        quality: 'estimate_only' | 'unavailable';
+        assumptions: InferenceQuoteAssumptions;
+    };
+    settlement: 'actual_usage';
+};
 /**
  * Query options for ranked tool/provider discovery.
  */
@@ -2446,6 +2485,13 @@ declare class DeeplineClient {
      * @returns Model metadata, provider option shapes, and runnable examples
      */
     describeModel(model: string): Promise<DeeplineAgentModelDescription>;
+    /**
+     * Quote dynamic AI inference pricing for a concrete payload.
+     *
+     * The result separates a planning estimate from a proven authorization
+     * maximum and contains Deepline credits only.
+     */
+    quoteInferenceTool(toolId: 'ai_inference' | 'deeplineagent', payload: Record<string, unknown>): Promise<InferenceQuote>;
     /**
      * Execute a tool and return the standard execution envelope.
      *

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.16",
+  version: "0.2.18",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3759,6 +3759,18 @@ var DeeplineClient = class {
       }
     );
   }
+  /**
+   * Quote dynamic AI inference pricing for a concrete payload.
+   *
+   * The result separates a planning estimate from a proven authorization
+   * maximum and contains Deepline credits only.
+   */
+  async quoteInferenceTool(toolId, payload) {
+    return this.http.post(
+      `/api/v2/integrations/${encodeURIComponent(toolId)}/quote`,
+      payload
+    );
+  }
   /**
    * Execute a tool and return the standard execution envelope.
    *

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.16",
+  version: "0.2.18",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3685,6 +3685,18 @@ var DeeplineClient = class {
       }
     );
   }
+  /**
+   * Quote dynamic AI inference pricing for a concrete payload.
+   *
+   * The result separates a planning estimate from a proven authorization
+   * maximum and contains Deepline credits only.
+   */
+  async quoteInferenceTool(toolId, payload) {
+    return this.http.post(
+      `/api/v2/integrations/${encodeURIComponent(toolId)}/quote`,
+      payload
+    );
+  }
   /**
    * Execute a tool and return the standard execution envelope.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {