deepline 0.2.28 → 0.2.30

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.28',
+  version: '0.2.30',
   contracts: {
     api: {
       name: 'sdk-http-api',

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

@@ -467,6 +467,12 @@ export interface ToolSearchResult {
 export interface ToolMetadata extends ToolDefinition {
   /** Related async polling action, if this tool supports async execution. */
   asyncGetAction?: string | null;
+  /** Async job lifecycle: this tool starts it, then polling may lead to final rows. */
+  asyncFlow?: {
+    startAction: string;
+    pollActions: string[];
+    finishAction?: string | null;
+  } | null;
   /** Known failure scenarios and their expected handling. */
   failureMode?: Record<string, unknown> | null;
   /** Sanitized pricing model for describe metadata. Provider internal prices are intentionally omitted. */

package/dist/bundling-sources/shared_libs/observability/telemetry.ts

@@ -61,7 +61,7 @@ export type TelemetryMetricEvent = TelemetryEventBase & {
 
 export type TelemetrySpanEvent = TelemetryEventBase & {
   telemetryKind: 'span';
-  telemetryLevel: 'info' | 'error';
+  telemetryLevel: 'info' | 'warn' | 'error';
   spanDurationMs: number;
   spanOutcome: TelemetrySpanOutcome;
   errorType?: string;
@@ -69,9 +69,7 @@ export type TelemetrySpanEvent = TelemetryEventBase & {
 };
 
 export type TelemetryEvent =
-  | TelemetryLogEvent
-  | TelemetryMetricEvent
-  | TelemetrySpanEvent;
+  TelemetryLogEvent | TelemetryMetricEvent | TelemetrySpanEvent;
 
 export type TelemetryAdapter = {
   emit(event: TelemetryEvent): void | Promise<void>;
@@ -79,6 +77,11 @@ export type TelemetryAdapter = {
 
 export type TelemetryEventOptions = { tag?: string };
 
+export type TelemetryTimeErrorOptions = {
+  telemetryLevel: 'warn' | 'error';
+  fields?: TelemetryFields;
+};
+
 export type Telemetry = {
   child(input: { component?: string; context?: TelemetryContext }): Telemetry;
   debug(
@@ -117,6 +120,7 @@ export type Telemetry = {
     span: string,
     fields: TelemetryFields | undefined,
     fn: () => Promise<T> | T,
+    options?: { onError?: (error: unknown) => TelemetryTimeErrorOptions },
   ): Promise<T>;
 };
 
@@ -269,9 +273,8 @@ export function createConsoleTelemetryAdapter(input?: {
   return {
     emit(event) {
       const line = JSON.stringify(event);
-      if (event.telemetryKind === 'log') target[event.telemetryLevel](line);
-      else if (event.telemetryKind === 'span' && event.spanOutcome === 'error')
-        target.error(line);
+      if (event.telemetryKind === 'log' || event.telemetryKind === 'span')
+        target[event.telemetryLevel](line);
       else target.info(line);
     },
   };
@@ -384,7 +387,7 @@ export function createTelemetry(input: CreateTelemetryInput): Telemetry {
       metric('gauge', name, value, undefined, fields),
     distribution: (name, value, options) =>
       metric('distribution', name, value, options?.unit, options?.fields),
-    async time(span, fields, fn) {
+    async time(span, fields, fn, options) {
       const startedAt = performance.now();
       try {
         const result = await fn();
@@ -398,11 +401,13 @@ export function createTelemetry(input: CreateTelemetryInput): Telemetry {
         });
         return result;
       } catch (error) {
+        const errorOptions = options?.onError?.(error);
         await publish({
           ...base(span),
           ...normalizeFields(fields),
+          ...normalizeFields(errorOptions?.fields),
           telemetryKind: 'span',
-          telemetryLevel: 'error',
+          telemetryLevel: errorOptions?.telemetryLevel ?? 'error',
           spanDurationMs: performance.now() - startedAt,
           spanOutcome: 'error',
           ...errorFields(error),

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.28",
+  version: "0.2.30",
   contracts: {
     api: {
       name: "sdk-http-api",

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.28",
+  version: "0.2.30",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/index.d.mts

@@ -535,6 +535,12 @@ interface ToolSearchResult {
 interface ToolMetadata extends ToolDefinition {
     /** Related async polling action, if this tool supports async execution. */
     asyncGetAction?: string | null;
+    /** Async job lifecycle: this tool starts it, then polling may lead to final rows. */
+    asyncFlow?: {
+        startAction: string;
+        pollActions: string[];
+        finishAction?: string | null;
+    } | null;
     /** Known failure scenarios and their expected handling. */
     failureMode?: Record<string, unknown> | null;
     /** Sanitized pricing model for describe metadata. Provider internal prices are intentionally omitted. */

package/dist/index.d.ts

@@ -535,6 +535,12 @@ interface ToolSearchResult {
 interface ToolMetadata extends ToolDefinition {
     /** Related async polling action, if this tool supports async execution. */
     asyncGetAction?: string | null;
+    /** Async job lifecycle: this tool starts it, then polling may lead to final rows. */
+    asyncFlow?: {
+        startAction: string;
+        pollActions: string[];
+        finishAction?: string | null;
+    } | null;
     /** Known failure scenarios and their expected handling. */
     failureMode?: Record<string, unknown> | null;
     /** Sanitized pricing model for describe metadata. Provider internal prices are intentionally omitted. */

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.28",
+  version: "0.2.30",
   contracts: {
     api: {
       name: "sdk-http-api",

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.28",
+  version: "0.2.30",
   contracts: {
     api: {
       name: "sdk-http-api",

package/package.json

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