deepline 0.3.274 → 0.3.275

package/dist/index.mjs

@@ -1229,7 +1229,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.274",
+  version: "0.3.275",
   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
@@ -3750,6 +3750,28 @@ async function* watchRunEvents(options) {
   }
 }
 
+// src/runs/log-cursor.ts
+var RUN_LOGS_CURSOR_PREFIX = "before:";
+function encodeRunLogsCursor(beforeSequence) {
+  return `${RUN_LOGS_CURSOR_PREFIX}${beforeSequence}`;
+}
+function isRunLogsCursor(value) {
+  return value.startsWith(RUN_LOGS_CURSOR_PREFIX);
+}
+function parseRunLogsCursor(value) {
+  const raw = isRunLogsCursor(value) ? value.slice(RUN_LOGS_CURSOR_PREFIX.length) : "";
+  const parsed = /^[1-9]\d*$/.test(raw) ? Number(raw) : NaN;
+  if (!Number.isSafeInteger(parsed)) {
+    throw Object.assign(
+      new Error(
+        `Invalid run log cursor ${JSON.stringify(value)}. Pass the nextCursor value from a previous deepline runs logs result.`
+      ),
+      { exitCode: 2 }
+    );
+  }
+  return parsed;
+}
+
 // src/types.ts
 function isStopAllPlayRunsDryRunResult(result) {
   return "dryRun" in result && result.dryRun === true;
@@ -4569,6 +4591,7 @@ var DeeplineClient = class _DeeplineClient {
       status: (runId) => this.getRunLifecycleStatus(runId),
       list: (options2) => this.listRuns(options2),
       listPage: (options2) => this.listRunsPage(options2),
+      history: (options2) => this.getRunsHistory(options2),
       watch: (runId, options2) => this.watchRunToTerminal(runId, options2),
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
@@ -5646,11 +5669,21 @@ var DeeplineClient = class _DeeplineClient {
     if (options?.full === true) {
       params.set("full", "true");
     }
+    if (options?.configuration === true) {
+      params.set("include", "configuration");
+    }
     const query = params.size > 0 ? `?${params.toString()}` : "";
     const response = await this.http.get(
       `/api/v2/runs/${encodeURIComponent(runId)}${query}`,
       { headers: { "x-deepline-run-status": "1" } }
     );
+    if (options?.configuration === true && !Object.hasOwn(response, "contract")) {
+      throw new DeeplineError(
+        "This server does not support recorded configuration reads.",
+        void 0,
+        "RUN_CONFIGURATION_UNAVAILABLE"
+      );
+    }
     const status = normalizePlayStatus(response);
     if (options?.failedLogs !== true || status.status !== "failed") {
       return status;
@@ -5738,6 +5771,33 @@ var DeeplineClient = class _DeeplineClient {
   async listRuns(options) {
     return (await this.listRunsPage(options)).runs;
   }
+  /** The same tenant-scoped run history searched by the dashboard and CLI. */
+  async getRunsHistory(options = {}) {
+    const params = new URLSearchParams();
+    const search = options.search?.trim();
+    if (search && search.length > 200) {
+      throw new Error("Run search must be at most 200 characters.");
+    }
+    if (options.type && options.type !== "all" && !search) {
+      throw new Error("runs.history options.type requires options.search.");
+    }
+    if (search) params.set("search", search);
+    if (search && options.type) params.set("type", options.type);
+    if (options.cursor) params.set("cursor", options.cursor);
+    if (options.orgId) params.set("orgId", options.orgId);
+    if (options.limit !== void 0) {
+      if (!Number.isSafeInteger(options.limit) || options.limit < 1) {
+        throw new Error(
+          "runs.history options.limit must be a positive integer."
+        );
+      }
+      params.set("limit", String(options.limit));
+    }
+    return this.http.get(
+      `/api/v2/dashboard/runs-history?${params.toString()}`,
+      { signal: options.signal }
+    );
+  }
   /** Read one run page without discarding server pagination metadata. */
   async listRunsPage(options) {
     const playName = options.play?.trim();
@@ -5844,6 +5904,13 @@ var DeeplineClient = class _DeeplineClient {
         "INVALID_RUN_LOG_VIEW"
       );
     }
+    if (options?.cursor !== void 0 && options.failed === true) {
+      throw new DeeplineError(
+        "runs.logs cannot combine failed with cursor.",
+        void 0,
+        "INVALID_RUN_LOG_VIEW"
+      );
+    }
     if (options?.failed === true) {
       const requestedLimit = typeof options.limit === "number" && Number.isFinite(options.limit) && options.limit > 0 ? Math.trunc(options.limit) : RUNS_FAILED_LOG_LIMIT;
       const failedLimit = Math.min(RUNS_FAILED_LOG_LIMIT, requestedLimit);
@@ -5869,6 +5936,7 @@ var DeeplineClient = class _DeeplineClient {
         ...page.logsTruncated ? { logsTruncated: true } : {}
       };
     }
+    const beforeSequence = options?.cursor !== void 0 ? parseRunLogsCursor(options.cursor) : null;
     const limit = options?.all ? Number.MAX_SAFE_INTEGER : typeof options?.limit === "number" && Number.isFinite(options.limit) && options.limit > 0 ? Math.trunc(options.limit) : 200;
     const fetchPage = (afterSeq2, pageLimit) => this.http.get(
       `/api/v2/runs/${encodeURIComponent(runId)}/logs?afterSeq=${afterSeq2}&limit=${pageLimit}`,
@@ -5876,24 +5944,33 @@ var DeeplineClient = class _DeeplineClient {
     );
     const probe = await fetchPage(0, 1);
     const lastStoredSeq = probe.lastStoredSeq;
-    let afterSeq = options?.all ? 0 : Math.max(0, lastStoredSeq - limit);
+    const oldestStoredSeq = probe.entries[0]?.seq ?? null;
+    const upperSeq = beforeSequence === null ? Number.POSITIVE_INFINITY : Math.min(beforeSequence - 1, lastStoredSeq);
+    const windowEndSeq = Math.min(upperSeq, lastStoredSeq);
+    let afterSeq = options?.all ? 0 : Math.max(0, windowEndSeq - limit);
     const entries = [];
-    while (entries.length < limit) {
+    while (entries.length < limit && afterSeq < upperSeq) {
       const page = await fetchPage(
         afterSeq,
-        Math.min(RUN_LOGS_PAGE_LIMIT, limit - entries.length)
+        Math.min(
+          RUN_LOGS_PAGE_LIMIT,
+          limit - entries.length,
+          upperSeq - afterSeq
+        )
       );
-      if (page.entries.length === 0) {
+      const inWindow = page.entries.filter((entry) => entry.seq <= upperSeq);
+      if (inWindow.length === 0) {
         break;
       }
-      entries.push(...page.entries);
-      afterSeq = page.entries[page.entries.length - 1].seq;
-      if (!page.hasMore) {
+      entries.push(...inWindow);
+      afterSeq = inWindow[inWindow.length - 1].seq;
+      if (!page.hasMore || inWindow.length < page.entries.length) {
         break;
       }
     }
     const firstSequence = entries.length > 0 ? entries[0].seq : null;
     const lastSequence = entries.length > 0 ? entries[entries.length - 1].seq : null;
+    const olderLinesExist = firstSequence !== null && oldestStoredSeq !== null && firstSequence > oldestStoredSeq;
     return {
       runId: probe.runId,
       totalCount: probe.totalLogCount,
@@ -5901,7 +5978,8 @@ var DeeplineClient = class _DeeplineClient {
       firstSequence,
       lastSequence,
       truncated: entries.length < probe.totalLogCount,
-      hasMore: lastSequence !== null && lastSequence < lastStoredSeq,
+      hasMore: olderLinesExist,
+      nextCursor: olderLinesExist ? encodeRunLogsCursor(firstSequence) : null,
       entries: entries.map((entry) => entry.line),
       view: options?.all ? "all" : "tail",
       ...probe.logsTruncated ? { logsTruncated: true } : {}

package/dist/install-integrity.json

@@ -24,6 +24,7 @@
     "dist/bundling-sources/sdk/src/plays/local-file-discovery.ts",
     "dist/bundling-sources/sdk/src/plays/run-request.ts",
     "dist/bundling-sources/sdk/src/release.ts",
+    "dist/bundling-sources/sdk/src/runs/log-cursor.ts",
     "dist/bundling-sources/sdk/src/runs/observe-transport.ts",
     "dist/bundling-sources/sdk/src/runs/overview.ts",
     "dist/bundling-sources/sdk/src/runs/read-errors.ts",
@@ -545,6 +546,7 @@
     "dist/bundling-sources/shared_libs/plays/static-pipeline-storage-codec.ts",
     "dist/bundling-sources/shared_libs/plays/static-pipeline.ts",
     "dist/bundling-sources/shared_libs/plays/status-result.ts",
+    "dist/bundling-sources/shared_libs/plays/table-csv.ts",
     "dist/bundling-sources/shared_libs/plays/tool-category-descriptions.ts",
     "dist/bundling-sources/shared_libs/plays/tool-codegen.ts",
     "dist/bundling-sources/shared_libs/plays/tool-execution-error.ts",
@@ -593,8 +595,8 @@
     "dist/cli/index.js",
     "dist/cli/index.mjs",
     "dist/cli/text-imports.d.ts",
-    "dist/client-2rIHKJiq.d.mts",
-    "dist/client-D6fRwhnE.d.ts",
+    "dist/client-5zY7LsId.d.ts",
+    "dist/client-CbNvJLgV.d.mts",
     "dist/compiler-manifest-C1bKB9bY.d.mts",
     "dist/compiler-manifest-C1bKB9bY.d.ts",
     "dist/helpers.d.mts",

package/dist/plays/run-request.d.mts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
 export { S as DeeplineError } from '../compiler-manifest-C1bKB9bY.mjs';
-export { bB as CSV_DATA_INPUT_KEY, bC as FileInputBinding, bD as LocalFileInput, bE as MintStagedFileUpload, bF as PLAY_FILES_STAGE_MINT_PATH, bG as PLAY_FILES_STAGE_PATH, bH as PLAY_RUN_START_PATH, bI as PLAY_RUN_START_STREAM_PATH, bJ as PlayRunHttp, bK as ResolvedStartPlayRunRequest, bL as STAGE_LEGACY_MULTIPART_MAX_BYTES, bM as StagedFileCodec, bN as StagedFileInputs, bO as StagedFileUpload, bP as buildNamedPlayRunRequest, bQ as buildPlayRunStartBody, bR as createSessionPlayRunHttp, bS as createStagedFileUpload, bT as fileInputBindingsFromPlaySchema, bU as fileInputBindingsFromStaticPipeline, bV as getDottedInputValue, bW as isPlayRunPackage, bX as mintStagedPlayFileUploads, bY as normalizePlayRunStart, bZ as playRunFileInputBindings, b_ as setDottedInputValue, b$ as stageFileInputs, c0 as stagePlayFiles, c1 as stagedFileContentType, c2 as startPlayRun, c3 as webStagedFileCodec } from '../client-2rIHKJiq.mjs';
+export { bE as CSV_DATA_INPUT_KEY, bF as FileInputBinding, bG as LocalFileInput, bH as MintStagedFileUpload, bI as PLAY_FILES_STAGE_MINT_PATH, bJ as PLAY_FILES_STAGE_PATH, bK as PLAY_RUN_START_PATH, bL as PLAY_RUN_START_STREAM_PATH, bM as PlayRunHttp, bN as ResolvedStartPlayRunRequest, bO as STAGE_LEGACY_MULTIPART_MAX_BYTES, bP as StagedFileCodec, bQ as StagedFileInputs, bR as StagedFileUpload, bS as buildNamedPlayRunRequest, bT as buildPlayRunStartBody, bU as createSessionPlayRunHttp, bV as createStagedFileUpload, bW as fileInputBindingsFromPlaySchema, bX as fileInputBindingsFromStaticPipeline, bY as getDottedInputValue, bZ as isPlayRunPackage, b_ as mintStagedPlayFileUploads, b$ as normalizePlayRunStart, c0 as playRunFileInputBindings, c1 as setDottedInputValue, c2 as stageFileInputs, c3 as stagePlayFiles, c4 as stagedFileContentType, c5 as startPlayRun, c6 as webStagedFileCodec } from '../client-CbNvJLgV.mjs';
 import '@sinclair/typebox';
 import 'zod';
 import '../monitor-fleet-contract.mjs';

package/dist/plays/run-request.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
 export { S as DeeplineError } from '../compiler-manifest-C1bKB9bY.js';
-export { bB as CSV_DATA_INPUT_KEY, bC as FileInputBinding, bD as LocalFileInput, bE as MintStagedFileUpload, bF as PLAY_FILES_STAGE_MINT_PATH, bG as PLAY_FILES_STAGE_PATH, bH as PLAY_RUN_START_PATH, bI as PLAY_RUN_START_STREAM_PATH, bJ as PlayRunHttp, bK as ResolvedStartPlayRunRequest, bL as STAGE_LEGACY_MULTIPART_MAX_BYTES, bM as StagedFileCodec, bN as StagedFileInputs, bO as StagedFileUpload, bP as buildNamedPlayRunRequest, bQ as buildPlayRunStartBody, bR as createSessionPlayRunHttp, bS as createStagedFileUpload, bT as fileInputBindingsFromPlaySchema, bU as fileInputBindingsFromStaticPipeline, bV as getDottedInputValue, bW as isPlayRunPackage, bX as mintStagedPlayFileUploads, bY as normalizePlayRunStart, bZ as playRunFileInputBindings, b_ as setDottedInputValue, b$ as stageFileInputs, c0 as stagePlayFiles, c1 as stagedFileContentType, c2 as startPlayRun, c3 as webStagedFileCodec } from '../client-D6fRwhnE.js';
+export { bE as CSV_DATA_INPUT_KEY, bF as FileInputBinding, bG as LocalFileInput, bH as MintStagedFileUpload, bI as PLAY_FILES_STAGE_MINT_PATH, bJ as PLAY_FILES_STAGE_PATH, bK as PLAY_RUN_START_PATH, bL as PLAY_RUN_START_STREAM_PATH, bM as PlayRunHttp, bN as ResolvedStartPlayRunRequest, bO as STAGE_LEGACY_MULTIPART_MAX_BYTES, bP as StagedFileCodec, bQ as StagedFileInputs, bR as StagedFileUpload, bS as buildNamedPlayRunRequest, bT as buildPlayRunStartBody, bU as createSessionPlayRunHttp, bV as createStagedFileUpload, bW as fileInputBindingsFromPlaySchema, bX as fileInputBindingsFromStaticPipeline, bY as getDottedInputValue, bZ as isPlayRunPackage, b_ as mintStagedPlayFileUploads, b$ as normalizePlayRunStart, c0 as playRunFileInputBindings, c1 as setDottedInputValue, c2 as stageFileInputs, c3 as stagePlayFiles, c4 as stagedFileContentType, c5 as startPlayRun, c6 as webStagedFileCodec } from '../client-5zY7LsId.js';
 import '@sinclair/typebox';
 import 'zod';
 import '../monitor-fleet-contract.js';

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.274";
+    readonly version: "0.3.275";
     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.274";
+    readonly version: "0.3.275";
     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.274",
+  version: "0.3.275",
   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.274",
+  version: "0.3.275",
   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.274",
+  "version": "0.3.275",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",