deepline 0.3.289 → 0.3.291

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

@@ -879,7 +879,7 @@ export type RunsEventSearchOptions = {
   playName?: string;
   /** Exact dotted event kind, such as `step.failed`. The catalog is discoverable with `runs logs --help`; future stored kinds are accepted too. */
   kind?: string;
-  /** JSONPath equality joined with `&&`, at most eight predicates and 512 bytes. See `runs logs --help` for fields and examples. Missing fields do not match; status is not inferred from kind. HTTP `jsonpath`, CLI `--where`. */
+  /** JSONPath equality joined with `&&`, at most eight predicates and 512 bytes. `eventId` selects an exact returned event; add `payloads` to retrieve its saved details. See `runs logs --help` for fields and examples. Missing fields do not match; status is not inferred from kind. HTTP `jsonpath`, CLI `--where`. */
   jsonpath?: string;
   /** Include available `eventPayload` details and receipt `payload` results; maximum ten events and 16 MiB. HTTP `payloads=true`, CLI `--payloads`. */
   includePayloads?: boolean;
@@ -905,7 +905,7 @@ export type RunsEventSearchEntry = {
   playName: string;
   /** Exact dotted event kind, such as `step.failed`. */
   kind: string;
-  /** Recorded log severity, or null; not a JSONPath filter field. */
+  /** Recorded log severity, or null on older events. Filter with `$.level == "error"`. */
   level: string | null;
   /** Log message preview of at most 2,048 characters, or null. Use text logs/export for the full retained line. */
   message: string | null;
@@ -933,7 +933,7 @@ export type RunsEventSearchResult = {
 export type RunsEventPayload = {
   /** Recorded terminal work outcome. */
   status: 'completed' | 'failed' | 'skipped';
-  /** Stored result data, or null when no output was retained. */
+  /** Saved result, including available sanitized call input/output details; failed-call records use kind: tool_call_evidence. Null when no output was retained. */
   output: unknown | null;
   /** Stored failure message, or null when absent. */
   error: string | null;
@@ -3320,8 +3320,10 @@ export class DeeplineClient {
   /**
    * Execute a tool and return the standard execution envelope.
    *
-   * The `toolResponse.rawV2` field contains the complete parsed and scrubbed tool response.
-   * `toolResponse.meta` contains tool/provider metadata.
+   * The `toolResponse.rawV2` field contains the complete tool response,
+   * preserving its original nesting. Inspect `getTool().examples` for a full
+   * Deepline response example. Optional `toolResponse.responseMeta` contains
+   * response metadata.
    * Top-level fields such as `status`, `job_id`, and `billing` describe the
    * Deepline execution envelope.
    */
@@ -4346,7 +4348,7 @@ export class DeeplineClient {
       });
     } catch (error) {
       failedLogsLoaded = false;
-      const retryCommand = `deepline runs get ${runId} --log-failed --json`;
+      const retryCommand = `deepline runs logs ${runId} --failed --json`;
       const reason =
         error instanceof Error && error.message.trim()
           ? ` (${error.message.trim().slice(0, 500)})`

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.289',
+  version: '0.3.291',
   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/runs/overview.ts

@@ -35,7 +35,7 @@ function lifecycleActions(status: PlayStatus, id: string, state?: string) {
       : {}),
     ...(state === 'failed'
       ? {
-          getFailedLogsCmd: `deepline runs get ${id} --log-failed --json`,
+          getFailedLogsCmd: `deepline runs logs ${id} --failed --json`,
           ...(status.rerunCommand ? { rerunCmd: status.rerunCommand } : {}),
         }
       : {}),
@@ -149,7 +149,10 @@ function datasetSummary(value: unknown, conflictingPopulation: boolean) {
 }
 
 /** Action descriptions are affordances, never evidence that an action ran. */
-function actions(value: unknown, names: Record<string, string>) {
+function actions<const Names extends Record<string, string>>(
+  value: unknown,
+  names: Names,
+): Partial<Record<Names[keyof Names], string>> {
   return Object.fromEntries(
     Object.entries(record(value) ?? {}).flatMap(([name, value]) => {
       const action = record(value);
@@ -167,7 +170,7 @@ function actions(value: unknown, names: Record<string, string>) {
         ],
       ];
     }),
-  );
+  ) as Partial<Record<Names[keyof Names], string>>;
 }
 
 /**
@@ -175,7 +178,10 @@ function actions(value: unknown, names: Record<string, string>) {
  * from a server that predates it, the same derivation over the step's
  * reported status and map progress.
  */
-function stepExecution(step: RecordValue, runStatus: string): NodeExecutionState {
+function stepExecution(
+  step: RecordValue,
+  runStatus: string,
+): NodeExecutionState {
   const decoded = decodeNodeExecutionState(step.execution);
   if (decoded) return decoded;
   const progress = record(step.progress);
@@ -323,7 +329,11 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
       );
     return {
       datasetId: dataset.datasetId,
-      name: dataset.tableNamespace,
+      name:
+        dataset.tableNamespace ??
+        (typeof stepOutput?.tableNamespace === 'string'
+          ? stepOutput.tableNamespace
+          : dataset.path),
       stepId: step?.id ?? named[0]?.[1].stepId,
       rowCount: dataset.rowCount ?? null,
       ...(dataset.lifecycle ? { lifecycle: dataset.lifecycle } : {}),
@@ -456,7 +466,7 @@ export function buildRunOverview(status: PlayStatus, fullStatus?: PlayStatus) {
 function receiptAction(id: string) {
   const quotedId = `'${id.replace(/'/g, "'\\''")}'`;
   return {
-    getReceiptCmd: `deepline runs receipt ${quotedId} --key '<receipt-key>' --json`,
+    getReceiptCmd: `deepline runs logs ${quotedId} --kind receipt.completed --payloads --json`,
   };
 }
 

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

@@ -226,6 +226,24 @@ export interface ToolDefinition extends ToolExecutionMetadataFields {
   inputSchema?: Record<string, unknown>;
   /** JSON Schema describing the tool's output shape. */
   outputSchema?: Record<string, unknown>;
+  /** JSON Schema for the Deepline API execution response, including toolResponse.rawV2. */
+  responseSchema?: Record<string, unknown>;
+  /** Illustrative input and full API response examples, separate from schemas. */
+  examples?: Array<{
+    input: Record<string, unknown>;
+    inputSource: 'sample' | 'schema';
+    responseSource: 'sample' | 'schema' | 'no_result';
+    description: string;
+    response: {
+      job_id: string;
+      status: string;
+      toolResponse: {
+        rawV2: unknown;
+        view: 'data' | 'rawV2';
+        responseMeta?: 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. */
@@ -600,7 +618,8 @@ export interface ToolSearchResult {
  * const meta = await client.getTool('dropleads_search_people');
  * console.log(meta.displayName);              // "DropLeads People Search"
  * console.log(meta.estimatedCreditsRange);     // "1-5"
- * console.log(meta.samples);                   // { input: {...}, output: {...} }
+ * console.log(meta.examples?.[0].input);       // example input payload
+ * console.log(meta.examples?.[0].response);    // full Deepline execution response
  * ```
  */
 export interface ToolMetadata extends ToolDefinition {
@@ -632,7 +651,7 @@ export interface ToolMetadata extends ToolDefinition {
   estimateBasedOnTools?: string[];
   /** Individual step cost contributions (for composite tools). */
   stepContributions?: unknown[];
-  /** Example input/output pairs for documentation and testing. */
+  /** Tool body samples. Full execution response examples are available in examples. */
   samples?: Record<string, unknown>;
 }
 

package/dist/bundling-sources/shared_libs/play-runtime/app-runtime-api.ts

@@ -13,7 +13,10 @@ import type { AsyncPlayRunRef } from '../plays/authoring-contract';
 import type { PlayRowUpdate } from './/ctx-types';
 import type { PlayRunTimelineEntry } from './/live-events';
 import type { PlayDatasetBornFrom } from './/cell-provenance';
-import type { PlayLogContext } from './/log-context';
+import type {
+  PlayLogContext,
+  PlayLogMetadata,
+} from './/log-context';
 import {
   routePlayActivityObservation,
   type PlayActivityObservation,
@@ -111,12 +114,17 @@ export type RuntimeStatusUpdate = {
   liveLogs?: string[];
   /** Search-only context aligned to `liveLogs`; stripped before Convex. */
   liveLogContexts?: Array<PlayLogContext | null>;
+  liveLogMetadata?: Array<PlayLogMetadata | null>;
+  liveLogIds?: Array<string | null>;
   /**
    * Monotonic count of log lines the producer ever emitted on this run's
    * channel. `liveLogs` is a rotating tail of those lines; the total lets the
    * positional cursor stay correct once the buffer has rotated.
    */
   liveLogTotalCount?: number;
+  /** Absolute start of a stateless gateway batch. Its durable positions must
+   * reach ingestion even if another request already forwarded a newer batch. */
+  liveLogBatchOffset?: number;
   /**
    * Monotonic scheduler attempt that owns the positional log channel. A new
    * attempt starts at offset zero without colliding with earlier attempts.
@@ -156,6 +164,8 @@ export type RuntimeStatusUpdate = {
   terminalLogReplay?: {
     lines: string[];
     lineContexts?: Array<PlayLogContext | null>;
+    lineMetadata?: Array<PlayLogMetadata | null>;
+    lineIds?: Array<string | null>;
     totalCount?: number;
     dedupeMode?: 'semantic' | 'exact';
     producerAttempt?: number;
@@ -355,6 +365,8 @@ type RuntimeApiRequest =
 export type WorkerRuntimeApiContext = {
   baseUrl: string;
   executorToken: string;
+  /** Exact ingress-prefix verifier advertised by the immutable launch receiver. */
+  runLedgerIngressPrefixBatching?: true;
   boundary?: 'app_runtime' | 'receipt_gateway';
   integrationMode?: 'live' | 'eval_stub' | 'fixture' | null;
   vercelProtectionBypassToken?: string | null;
@@ -2197,18 +2209,23 @@ async function updateRunStatusViaAppRuntimeUnlocked(
       runId: update.playId,
       status: 'queued',
     });
-  // Positional cursor over this producer's log buffer. Running updates forward
-  // only the unsent suffix; terminal updates resend the retained buffer so the
-  // durable stream can recover any progress flush that was lost in transit.
-  const sentCount = isTerminalRuntimeStatus(update.status)
-    ? 0
-    : (runLogChannelSentCounts.get(
-        runLogChannelKey(update.playId, update.liveLogProducerAttempt),
-      ) ?? 0);
+  // Stateful producers forward their unsent suffix. A stateless gateway batch
+  // owns an absolute start: a newer request's process-local cursor is no proof
+  // that this batch reached ingestion. Durable positional identities reconcile
+  // overlap and terminal recovery.
+  const sentCount =
+    update.liveLogBatchOffset ??
+    (isTerminalRuntimeStatus(update.status)
+      ? 0
+      : (runLogChannelSentCounts.get(
+          runLogChannelKey(update.playId, update.liveLogProducerAttempt),
+        ) ?? 0));
   const logSlice = Array.isArray(update.liveLogs)
     ? slicePositionalLogLines({
         bufferLines: update.liveLogs,
         bufferContexts: update.liveLogContexts,
+        bufferMetadata: update.liveLogMetadata,
+        bufferIds: update.liveLogIds,
         bufferTotalCount: update.liveLogTotalCount ?? update.liveLogs.length,
         sentCount,
       })
@@ -2220,6 +2237,8 @@ async function updateRunStatusViaAppRuntimeUnlocked(
         ? {
             lines: update.liveLogs,
             lineContexts: update.liveLogContexts,
+            lineMetadata: update.liveLogMetadata,
+            lineIds: update.liveLogIds,
             totalCount: update.liveLogTotalCount,
             producerAttempt: update.liveLogProducerAttempt,
           }
@@ -2239,7 +2258,14 @@ async function updateRunStatusViaAppRuntimeUnlocked(
       0,
       Math.max(0, replayOffset - logSlice.channelOffset),
     );
-    if (prefix.length) statusPatchLogSlice = { ...logSlice, lines: prefix };
+    if (prefix.length)
+      statusPatchLogSlice = {
+        ...logSlice,
+        lines: prefix,
+        lineContexts: logSlice.lineContexts?.slice(0, prefix.length),
+        lineMetadata: logSlice.lineMetadata?.slice(0, prefix.length),
+        lineIds: logSlice.lineIds?.slice(0, prefix.length),
+      };
   }
   const events = buildPlayRunLedgerEventsFromStatusPatch({
     patch: {
@@ -2250,6 +2276,8 @@ async function updateRunStatusViaAppRuntimeUnlocked(
       lastCheckpointAt: update.lastCheckpointAt ?? null,
       liveLogs: statusPatchLogSlice?.lines ?? null,
       liveLogContexts: statusPatchLogSlice?.lineContexts ?? null,
+      liveLogMetadata: statusPatchLogSlice?.lineMetadata ?? null,
+      liveLogIds: statusPatchLogSlice?.lineIds ?? null,
       liveLogsChannelOffset: statusPatchLogSlice?.channelOffset ?? null,
       liveLogsProducerAttempt: update.liveLogProducerAttempt ?? null,
       liveNodeProgress: update.liveNodeProgress ?? null,
@@ -2335,6 +2363,8 @@ async function updateRunStatusViaAppRuntimeUnlocked(
           occurredAt: update.lastCheckpointAt ?? Date.now(),
           lines: terminalLogReplay.lines,
           lineContexts: terminalLogReplay.lineContexts,
+          lineMetadata: terminalLogReplay.lineMetadata,
+          lineIds: terminalLogReplay.lineIds,
           liveLogTotalCount: terminalLogReplay.totalCount,
           dedupeMode: terminalLogReplay.dedupeMode,
           producerAttempt: terminalLogReplay.producerAttempt,
@@ -2364,7 +2394,7 @@ async function updateRunStatusViaAppRuntimeUnlocked(
       events: terminalLogEvents,
     });
   }
-  if (statusPatchLogSlice) {
+  if (statusPatchLogSlice && update.liveLogBatchOffset === undefined) {
     runLogChannelSentCounts.set(
       runLogChannelKey(update.playId, update.liveLogProducerAttempt),
       statusPatchLogSlice.channelOffset + statusPatchLogSlice.lines.length,