deepline 0.3.231 → 0.3.232

package/dist/index.d.mts

@@ -91,126 +91,6 @@ type PlaySettingsPathsPage = {
     hasMore: boolean;
 };
 
-type ProductNotificationFactValue = string | number | boolean;
-type ProductNotificationFacts = Record<string, ProductNotificationFactValue>;
-type ProductNotificationDestinationSettings = {
-    kind: 'slack';
-    targetKind: 'channel' | 'member';
-    targetId: string;
-    targetName: string;
-    oauthConnectionId: string;
-} | {
-    kind: 'email_addresses';
-    to: string[];
-    cc?: string[];
-    bcc?: string[];
-} | {
-    kind: 'email_roles';
-    roles: string[];
-};
-type ProductNotificationTrigger = {
-    kind: 'each_match';
-} | {
-    kind: 'state_transition';
-    targetState: string;
-    reasonCode?: string;
-} | {
-    kind: 'threshold_crossing';
-    direction: 'above' | 'below' | 'at_or_above';
-    threshold: number;
-    unit?: string;
-} | {
-    kind: 'consecutive_outcomes';
-    count: number;
-    outcome: string;
-    maxLookback: number;
-};
-type ProductNotificationDeliveryTiming = {
-    mode: 'immediate';
-} | {
-    mode: 'immediate_first' | 'digest_only' | 'rolling_limit';
-    windowMs: number;
-};
-type ProductNotificationRepeatMode = 'on_enter' | 'every_match';
-type ProductNotificationDefaultPolicy = {
-    version: number;
-    groups: ProductNotificationDefaultGroup[];
-    destinations: ProductNotificationDefaultDestination[];
-    rules: ProductNotificationDefaultRule[];
-};
-type ProductNotificationDefaultGroup = {
-    groupKey: string;
-    name: string;
-    enabled: boolean;
-    /** Omitted only by stored compatibility rows; effective groups are normalized. */
-    deliveryTiming?: ProductNotificationDeliveryTiming;
-};
-type ProductNotificationDefaultDestination = {
-    destinationKey: string;
-    groupKey: string;
-    name: string;
-    enabled: boolean;
-    settings: ProductNotificationDestinationSettings;
-};
-type ProductNotificationDefaultRule = {
-    ruleKey: string;
-    groupKey: string;
-    enabled: boolean;
-    notificationType: string;
-    eventName: string;
-    eventFilter: ProductNotificationFacts;
-    trigger: ProductNotificationTrigger;
-    /** Omitted only by stored compatibility rows; effective rules are normalized. */
-    repeatMode?: ProductNotificationRepeatMode;
-    /** Omitted only by stored compatibility rows; effective rules are normalized. */
-    conditionGeneration?: number;
-};
-type ProductNotificationConfigMode = 'custom' | 'replace_default' | 'disable_default';
-/** The provider-neutral state edited by UI and CLI clients for one group. */
-type ProductNotificationGroupDraft = {
-    group: EffectiveProductNotificationGroup;
-    destinations: EffectiveProductNotificationDestination[];
-    rules: EffectiveProductNotificationRule[];
-};
-/** Public configuration intent. Convex alone derives sparse override writes. */
-type ProductNotificationConfigurationChange = {
-    kind: 'save_group';
-    draft: ProductNotificationGroupDraft;
-} | {
-    kind: 'delete_group';
-    groupKey: string;
-};
-type EffectiveProductNotificationGroup = Omit<ProductNotificationDefaultGroup, 'deliveryTiming'> & {
-    deliveryTiming: ProductNotificationDeliveryTiming;
-    source: 'default' | 'workspace';
-    configMode: 'default' | ProductNotificationConfigMode;
-    defaultKey?: string;
-    version: number;
-};
-type EffectiveProductNotificationDestination = ProductNotificationDefaultDestination & {
-    source: 'default' | 'workspace';
-    configMode: 'default' | ProductNotificationConfigMode;
-    defaultKey?: string;
-    version: number;
-    status: string;
-};
-type EffectiveProductNotificationRule = Omit<ProductNotificationDefaultRule, 'repeatMode' | 'conditionGeneration'> & {
-    repeatMode: ProductNotificationRepeatMode;
-    conditionGeneration: number;
-    source: 'default' | 'workspace';
-    configMode: 'default' | ProductNotificationConfigMode;
-    defaultKey?: string;
-    version: number;
-};
-type EffectiveProductNotificationConfiguration = {
-    /** Exact policy used to materialize this effective configuration. */
-    defaultPolicy: ProductNotificationDefaultPolicy | null;
-    workspaceVersion: number;
-    groups: EffectiveProductNotificationGroup[];
-    destinations: EffectiveProductNotificationDestination[];
-    rules: EffectiveProductNotificationRule[];
-};
-
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
 declare const FIXTURE_BEHAVIOR_RESPONSE_VERSION: 2;
 declare const FIXTURE_BEHAVIOR_REPLAY_VERSION: 3;
@@ -427,6 +307,126 @@ declare function formatPlayBootstrapFinderKinds(): string;
 declare function formatPlayBootstrapTemplates(): string;
 declare function formatPlayBootstrapFinderKindsForSentence(): string;
 
+type ProductNotificationFactValue = string | number | boolean;
+type ProductNotificationFacts = Record<string, ProductNotificationFactValue>;
+type ProductNotificationDestinationSettings = {
+    kind: 'slack';
+    targetKind: 'channel' | 'member';
+    targetId: string;
+    targetName: string;
+    oauthConnectionId: string;
+} | {
+    kind: 'email_addresses';
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+} | {
+    kind: 'email_roles';
+    roles: string[];
+};
+type ProductNotificationTrigger = {
+    kind: 'each_match';
+} | {
+    kind: 'state_transition';
+    targetState: string;
+    reasonCode?: string;
+} | {
+    kind: 'threshold_crossing';
+    direction: 'above' | 'below' | 'at_or_above';
+    threshold: number;
+    unit?: string;
+} | {
+    kind: 'consecutive_outcomes';
+    count: number;
+    outcome: string;
+    maxLookback: number;
+};
+type ProductNotificationDeliveryTiming = {
+    mode: 'immediate';
+} | {
+    mode: 'immediate_first' | 'digest_only' | 'rolling_limit';
+    windowMs: number;
+};
+type ProductNotificationRepeatMode = 'on_enter' | 'every_match';
+type ProductNotificationDefaultPolicy = {
+    version: number;
+    groups: ProductNotificationDefaultGroup[];
+    destinations: ProductNotificationDefaultDestination[];
+    rules: ProductNotificationDefaultRule[];
+};
+type ProductNotificationDefaultGroup = {
+    groupKey: string;
+    name: string;
+    enabled: boolean;
+    /** Omitted only by stored compatibility rows; effective groups are normalized. */
+    deliveryTiming?: ProductNotificationDeliveryTiming;
+};
+type ProductNotificationDefaultDestination = {
+    destinationKey: string;
+    groupKey: string;
+    name: string;
+    enabled: boolean;
+    settings: ProductNotificationDestinationSettings;
+};
+type ProductNotificationDefaultRule = {
+    ruleKey: string;
+    groupKey: string;
+    enabled: boolean;
+    notificationType: string;
+    eventName: string;
+    eventFilter: ProductNotificationFacts;
+    trigger: ProductNotificationTrigger;
+    /** Omitted only by stored compatibility rows; effective rules are normalized. */
+    repeatMode?: ProductNotificationRepeatMode;
+    /** Omitted only by stored compatibility rows; effective rules are normalized. */
+    conditionGeneration?: number;
+};
+type ProductNotificationConfigMode = 'custom' | 'replace_default' | 'disable_default';
+/** The provider-neutral state edited by UI and CLI clients for one group. */
+type ProductNotificationGroupDraft = {
+    group: EffectiveProductNotificationGroup;
+    destinations: EffectiveProductNotificationDestination[];
+    rules: EffectiveProductNotificationRule[];
+};
+/** Public configuration intent. Convex alone derives sparse override writes. */
+type ProductNotificationConfigurationChange = {
+    kind: 'save_group';
+    draft: ProductNotificationGroupDraft;
+} | {
+    kind: 'delete_group';
+    groupKey: string;
+};
+type EffectiveProductNotificationGroup = Omit<ProductNotificationDefaultGroup, 'deliveryTiming'> & {
+    deliveryTiming: ProductNotificationDeliveryTiming;
+    source: 'default' | 'workspace';
+    configMode: 'default' | ProductNotificationConfigMode;
+    defaultKey?: string;
+    version: number;
+};
+type EffectiveProductNotificationDestination = ProductNotificationDefaultDestination & {
+    source: 'default' | 'workspace';
+    configMode: 'default' | ProductNotificationConfigMode;
+    defaultKey?: string;
+    version: number;
+    status: string;
+};
+type EffectiveProductNotificationRule = Omit<ProductNotificationDefaultRule, 'repeatMode' | 'conditionGeneration'> & {
+    repeatMode: ProductNotificationRepeatMode;
+    conditionGeneration: number;
+    source: 'default' | 'workspace';
+    configMode: 'default' | ProductNotificationConfigMode;
+    defaultKey?: string;
+    version: number;
+};
+type EffectiveProductNotificationConfiguration = {
+    /** Exact policy used to materialize this effective configuration. */
+    defaultPolicy: ProductNotificationDefaultPolicy | null;
+    workspaceVersion: number;
+    groups: EffectiveProductNotificationGroup[];
+    destinations: EffectiveProductNotificationDestination[];
+    rules: EffectiveProductNotificationRule[];
+};
+
 /** Type-owned content, independent of email markup and persisted audit strings. */
 type NotificationText = string | readonly (string | {
     strong: string;
@@ -3058,6 +3058,76 @@ interface UpdateSharePageRequest {
     seoIndexing?: 'index' | 'noindex';
 }
 
+type ExecuteToolRawOptions = {
+    includeToolMetadata?: boolean;
+    responseIntent?: 'dataset' | 'raw' | 'row_artifact';
+    metadata?: Record<string, unknown>;
+    timeout?: number;
+    maxRetries?: number;
+    /** Retry transient HTTP API responses when the caller has confirmed safety. */
+    retryApiErrors?: boolean;
+    /** Reuse this stable key to recover or retry an ambiguous execution. */
+    idempotencyKey?: string;
+    /** Generate a key and enable recoverable execution before dispatch. */
+    recover?: boolean;
+    /** Called and awaited with the key before the first network request. */
+    onExecution?: (execution: {
+        idempotencyKey: string;
+    }) => void | Promise<void>;
+    /** Maximum time to reconnect to an in-progress keyed execution. Defaults to 15 minutes. */
+    recoveryTimeoutMs?: number;
+    /** The `search_ref` of the tools search that found this tool. */
+    searchRef?: string;
+};
+/** Durable state returned for a keyed tool execution. */
+type ExecutionRecovery = {
+    /** Stable caller key used to resume or replay this execution. */
+    idempotencyKey: string;
+    /** Whether the execution is still running, completed, or has an unknown provider outcome. */
+    state: 'running' | 'completed' | 'outcome_unknown';
+    /** Whether this response came from an existing durable execution. */
+    replayed: boolean;
+    /** ISO timestamp after which the completed execution can no longer be replayed. */
+    expiresAt?: string;
+};
+/** Durable lookup result for a keyed tool execution. */
+type ExecutionByKeyResult = {
+    /** Recovery state and the key that owns the execution. */
+    executionRecovery: ExecutionRecovery;
+    /** Provider tool associated with the execution. */
+    toolId: string;
+    /** Original server-owned billing request ID, allocated before provider dispatch. */
+    requestId?: string;
+    /** HTTP status saved with the original response, when it was terminal. */
+    responseStatus?: number;
+    /** Saved execution response, when one is available for replay. */
+    response?: unknown;
+};
+/**
+ * Standard provider/tool execution envelope returned by low-level SDK calls.
+ *
+ * `toolResponse.rawV2` contains the complete scrubbed provider response;
+ * `toolResponse.raw` is derived locally as the legacy provider-result projection. `extractedValues` and
+ * `extractedLists` contain Deepline-normalized getters when the tool exposes
+ * them. Billing fields are Deepline-facing and must not expose provider spend.
+ */
+type ToolExecution<TData = unknown, TMeta = Record<string, unknown>> = {
+    status: string;
+    job_id?: string;
+    meta?: Record<string, unknown>;
+    toolResponse: {
+        raw: TData;
+        rawV2?: unknown;
+        view?: 'data' | 'rawV2';
+        meta?: TMeta;
+        responseMeta?: TMeta;
+    };
+    extractedLists?: Record<string, unknown>;
+    extractedValues?: Record<string, unknown>;
+    billing?: ToolResultBilling;
+    [key: string]: unknown;
+};
+
 /**
  * Monitor authoring and typing for the Deepline SDK.
  *
@@ -3298,75 +3368,6 @@ type IngestionStorageRepairResult = {
         };
     };
 };
-type ExecuteToolRawOptions = {
-    includeToolMetadata?: boolean;
-    responseIntent?: 'dataset' | 'raw' | 'row_artifact';
-    metadata?: Record<string, unknown>;
-    timeout?: number;
-    maxRetries?: number;
-    /** Retry transient HTTP API responses when the caller has confirmed safety. */
-    retryApiErrors?: boolean;
-    /** Reuse this stable key to recover or retry an ambiguous execution. */
-    idempotencyKey?: string;
-    /** Generate a key and enable recoverable execution before dispatch. */
-    recover?: boolean;
-    /** Called and awaited with the key before the first network request. */
-    onExecution?: (execution: {
-        idempotencyKey: string;
-    }) => void | Promise<void>;
-    /** Maximum time to reconnect to an in-progress keyed execution. Defaults to 15 minutes. */
-    recoveryTimeoutMs?: number;
-    /** The `search_ref` of the tools search that found this tool. */
-    searchRef?: string;
-};
-/** Durable state returned for a keyed tool execution. */
-type ExecutionRecovery = {
-    /** Stable caller key used to resume or replay this execution. */
-    idempotencyKey: string;
-    /** Whether the execution is still running, completed, or has an unknown provider outcome. */
-    state: 'running' | 'completed' | 'outcome_unknown';
-    /** Whether this response came from an existing durable execution. */
-    replayed: boolean;
-    /** ISO timestamp after which the completed execution can no longer be replayed. */
-    expiresAt?: string;
-};
-/** Durable lookup result for a keyed tool execution. */
-type ExecutionByKeyResult = {
-    /** Recovery state and the key that owns the execution. */
-    executionRecovery: ExecutionRecovery;
-    /** Provider tool associated with the execution. */
-    toolId: string;
-    /** Original server-owned billing request ID, allocated before provider dispatch. */
-    requestId?: string;
-    /** HTTP status saved with the original response, when it was terminal. */
-    responseStatus?: number;
-    /** Saved execution response, when one is available for replay. */
-    response?: unknown;
-};
-/**
- * Standard provider/tool execution envelope returned by low-level SDK calls.
- *
- * `toolResponse.rawV2` contains the complete scrubbed provider response;
- * `toolResponse.raw` is derived locally as the legacy provider-result projection. `extractedValues` and
- * `extractedLists` contain Deepline-normalized getters when the tool exposes
- * them. Billing fields are Deepline-facing and must not expose provider spend.
- */
-type ToolExecution<TData = unknown, TMeta = Record<string, unknown>> = {
-    status: string;
-    job_id?: string;
-    meta?: Record<string, unknown>;
-    toolResponse: {
-        raw: TData;
-        rawV2?: unknown;
-        view?: 'data' | 'rawV2';
-        meta?: TMeta;
-        responseMeta?: TMeta;
-    };
-    extractedLists?: Record<string, unknown>;
-    extractedValues?: Record<string, unknown>;
-    billing?: ToolResultBilling;
-    [key: string]: unknown;
-};
 /** Filters for `client.runs.list(...)`. */
 type RunsListOptions = {
     play?: string;
@@ -4888,6 +4889,7 @@ type MintStagedFileUpload = {
  */
 declare class DeeplineClient {
     private readonly http;
+    private readonly toolCalls;
     private readonly config;
     /** Canonical run lifecycle namespace backed by `/api/v2/runs`. */
     readonly runs: RunsNamespace;
@@ -5020,7 +5022,6 @@ declare class DeeplineClient {
     executeTool<TData = unknown, TMeta = Record<string, unknown>>(toolId: string, input: Record<string, unknown>, options?: ExecuteToolRawOptions): Promise<ToolExecution<TData, TMeta>>;
     /** Read the durable state of a keyed tool execution. */
     getExecutionByKey(idempotencyKey: string): Promise<ExecutionByKeyResult>;
-    private lookupExecutionByKey;
     /** Public recovery namespace. */
     get executions(): {
         getByKey: (key: string) => Promise<ExecutionByKeyResult>;