deepline 0.3.68 → 0.3.69

package/dist/cli/index.mjs

@@ -1199,7 +1199,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.68",
+  version: "0.3.69",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -18216,12 +18216,20 @@ async function publishImportedPlayDependencies(client2, graph) {
   };
   await publishNode(graph.root.filePath, true);
 }
+function timestampDate(value) {
+  if (value === null || value === void 0 || value === "") return null;
+  const normalized = typeof value === "string" && /^\d+$/.test(value.trim()) ? Number(value) : value;
+  const date = new Date(normalized);
+  return Number.isNaN(date.getTime()) ? null : date;
+}
 function formatTimestamp(value) {
-  if (!value) return "\u2014";
-  const date = typeof value === "number" ? new Date(value) : new Date(value);
-  if (Number.isNaN(date.getTime())) return "\u2014";
+  const date = timestampDate(value);
+  if (!date) return "\u2014";
   return date.toISOString();
 }
+function isoTimestamp(value) {
+  return timestampDate(value)?.toISOString() ?? null;
+}
 function formatRunLine(run) {
   const credits = typeof run.billingTotalCredits === "number" && Number.isFinite(run.billingTotalCredits) ? `${formatCreditAmount(run.billingTotalCredits)} credits` : "\u2014";
   return `${run.workflowId} ${run.status} ${formatTimestamp(run.startTime)} ${credits}`;
@@ -22647,13 +22655,22 @@ async function handleRunsList(args) {
     ...offset !== void 0 ? { offset } : {}
   })).map((run) => ({
     runId: run.workflowId,
+    // `workflowId` is the legacy SDK name for the same public Deepline run
+    // identity. Keep it during the compatibility window, but never label the
+    // duplicate as a Temporal/runtime id.
     workflowId: run.workflowId,
-    temporalRunId: run.runId,
+    // Retain the runtime identifier for existing JSON consumers. It is not a
+    // stable Deepline run id; `runId` above is the canonical public id.
+    temporalRunId: run.runId ?? null,
     parentRunId: run.parentRunId ?? null,
     rootRunId: run.rootRunId ?? null,
     status: String(run.status ?? "").toLowerCase(),
+    createdAt: run.createdAt ?? null,
+    createdAtIso: isoTimestamp(run.createdAt),
     startedAt: run.startTime ?? run.startedAt ?? null,
+    startedAtIso: isoTimestamp(run.startTime ?? run.startedAt ?? null),
     finishedAt: run.closeTime ?? run.finishedAt ?? null,
+    finishedAtIso: isoTimestamp(run.closeTime ?? run.finishedAt ?? null),
     executionTime: run.executionTime,
     billingTotalCredits: run.billingTotalCredits,
     billingMaxCreditsPerRun: run.billingMaxCreditsPerRun,
@@ -22661,9 +22678,19 @@ async function handleRunsList(args) {
   }));
   const lines = runs.length === 0 ? [
     playName ? `No runs found for ${playName}.` : `No runs found for status ${statusFilter}.`
-  ] : runs.map(
-    (run) => `${run.runId} ${run.status} ${formatTimestamp(run.startedAt)} ${typeof run.billingTotalCredits === "number" && Number.isFinite(run.billingTotalCredits) ? `${formatCreditAmount(run.billingTotalCredits)} credits` : "\u2014"}${run.parentRunId ? ` parent=${run.parentRunId}` : ""}`
-  );
+  ] : runs.map((run) => {
+    const lines2 = [
+      `${run.runId} ${run.status}`,
+      `  created: ${formatTimestamp(run.createdAt)}`,
+      `  started: ${formatTimestamp(run.startedAt)}`,
+      `  finished: ${formatTimestamp(run.finishedAt)}`,
+      `  credits: ${typeof run.billingTotalCredits === "number" && Number.isFinite(run.billingTotalCredits) ? formatCreditAmount(run.billingTotalCredits) : "\u2014"}`,
+      `  inspect: deepline runs get ${run.runId} --json`
+    ];
+    if (run.parentRunId) lines2.push(`  parent: ${run.parentRunId}`);
+    if (run.rootRunId) lines2.push(`  root: ${run.rootRunId}`);
+    return lines2.join("\n");
+  });
   printCommandEnvelope(
     {
       runs,
@@ -30469,10 +30496,12 @@ function registerEnrichCommand(program) {
 }
 
 // src/cli/commands/feedback.ts
+import { readFileSync as readFileSync9 } from "fs";
 async function handleFeedback(text, options) {
+  const message = resolveFeedbackText(text, options.file);
   const { http } = getAuthedHttpClient();
   const response = await http.post("/api/v2/cli/feedback", {
-    text,
+    text: message,
     requested: options.requested === true,
     environment: collectLocalEnvInfo(),
     ...options.command ? { command: options.command } : {},
@@ -30490,6 +30519,35 @@ async function handleFeedback(text, options) {
     { json: options.json }
   );
 }
+function resolveFeedbackText(text, file, readFile6 = (path) => readFileSync9(path, "utf8")) {
+  if (text !== void 0 && file !== void 0) {
+    throw new Error(
+      "Pass feedback text positionally or with --file, not both."
+    );
+  }
+  let value;
+  if (file !== void 0) {
+    try {
+      value = readFile6(file === "-" ? 0 : file);
+    } catch (error) {
+      throw new Error(
+        `Could not read feedback ${file === "-" ? "from stdin" : `file ${file}`}: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  } else if (text !== void 0) {
+    value = text;
+  } else if (!process.stdin.isTTY) {
+    value = readFile6(0);
+  } else {
+    throw new Error(
+      "Feedback text is required. Pass it positionally, use --file <path>, or pipe stdin."
+    );
+  }
+  if (!value.trim()) {
+    throw new Error("Feedback text must not be empty.");
+  }
+  return value;
+}
 function registerFeedbackCommands(program) {
   const feedback = program.command("feedback").description("Submit CLI feedback to Deepline.").addHelpText(
     "after",
@@ -30509,10 +30567,12 @@ Examples:
     `
 Examples:
   deepline feedback send "tools search returned stale results" --json
+  deepline feedback send --file incident.md --requested --json
+  cat incident.md | deepline feedback send --requested --json
   deepline feedback send "tools search returned stale results" --requested --json
   deepline feedback send "plays run failed after upload" --command "deepline plays run my.play.ts --watch"
 `
-  ).argument("<text>", "Feedback text").option("--command <command>", "Command that reproduced the issue").option("--payload <payload>", "JSON or plain-text payload for the repro").option(
+  ).argument("[text]", "Feedback text").option("--file <path>", "Read feedback text from a file, or - for stdin").option("--command <command>", "Command that reproduced the issue").option("--payload <payload>", "JSON or plain-text payload for the repro").option(
     "--requested",
     "Mark the report as explicitly requested by the user"
   ).option("--json", "Emit JSON output").action(handleFeedback);
@@ -30523,7 +30583,7 @@ import {
   existsSync as existsSync10,
   mkdirSync as mkdirSync8,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync9,
+  readFileSync as readFileSync10,
   statSync as statSync4,
   writeFileSync as writeFileSync11
 } from "fs";
@@ -30661,7 +30721,7 @@ function sessionIdFromCodexFilePath(filePath) {
 }
 function readCodexSessionId(filePath) {
   try {
-    for (const line of normalizedJsonLines(readFileSync9(filePath)).slice(
+    for (const line of normalizedJsonLines(readFileSync10(filePath)).slice(
       0,
       20
     )) {
@@ -30980,7 +31040,7 @@ async function handleSessionsSend(options) {
       throw new Error(`File not found: ${options.file}`);
     }
     const response2 = await uploadPayload("/api/v2/cli/send-session", {
-      file: readFileSync9(filePath).toString("base64"),
+      file: readFileSync10(filePath).toString("base64"),
       filename: basename5(filePath)
     });
     printCommandEnvelope(
@@ -31010,7 +31070,7 @@ async function handleSessionsSend(options) {
     agent: options.agent
   });
   const built = targets.map((target) => {
-    const upload = buildSessionUploadContent(readFileSync9(target.filePath));
+    const upload = buildSessionUploadContent(readFileSync10(target.filePath));
     return { ...target, ...upload };
   });
   if (built.some((session) => session.needsChunking)) {
@@ -31094,8 +31154,8 @@ function loadViewerAssets() {
       const jsPath = join12(root, "viewer.js");
       if (!existsSync10(cssPath) || !existsSync10(jsPath)) continue;
       return {
-        css: readFileSync9(cssPath, "utf8"),
-        js: readFileSync9(jsPath, "utf8")
+        css: readFileSync10(cssPath, "utf8"),
+        js: readFileSync10(jsPath, "utf8")
       };
     } catch {
       continue;
@@ -31133,7 +31193,7 @@ async function handleSessionsRender(options) {
   const sessions = targets.map((target) => ({
     label: target.label,
     events: parsePreparedEvents(
-      prepareSessionBuffer(readFileSync9(target.filePath))
+      prepareSessionBuffer(readFileSync10(target.filePath))
     )
   }));
   const { css, js } = loadViewerAssets();
@@ -31367,7 +31427,7 @@ Examples:
 
 // src/cli/commands/monitors.ts
 import { randomUUID as randomUUID5 } from "crypto";
-import { readFileSync as readFileSync10, writeFileSync as writeFileSync12 } from "fs";
+import { readFileSync as readFileSync11, writeFileSync as writeFileSync12 } from "fs";
 import { resolve as resolve14 } from "path";
 import { createInterface } from "readline/promises";
 
@@ -31807,8 +31867,8 @@ function parseJsonObjectArg(raw, argLabel) {
   return parsed;
 }
 function resolveMonitorJsonBody(input2) {
-  const readFile6 = input2.readFile ?? ((path) => readFileSync10(path, "utf-8"));
-  const readStdin = input2.readStdin ?? (() => readFileSync10(0, "utf-8"));
+  const readFile6 = input2.readFile ?? ((path) => readFileSync11(path, "utf-8"));
+  const readStdin = input2.readStdin ?? (() => readFileSync11(0, "utf-8"));
   if (input2.positional !== void 0 && input2.file !== void 0) {
     throw new MonitorsUsageError(
       `Pass exactly one source for ${input2.argLabel}: the positional JSON or --file, not both.`
@@ -32205,6 +32265,7 @@ function renderDeployedListText(payload, requestedStatus) {
     if (!entry || !key) continue;
     const status = asString(entry.status);
     const tool = asString(entry.tool);
+    const monitorType = asString(entry.type);
     const name = asString(entry.name);
     const outputTable = asString(entry.output_table);
     const webhookState = asString(entry.webhook_state);
@@ -32215,10 +32276,11 @@ function renderDeployedListText(payload, requestedStatus) {
     lines.push(
       `  ${key}${status ? `  ${status}` : ""}${tool ? `  ${tool}` : ""}${name ? `  (${name})` : ""}`
     );
-    if (outputTable || webhookState || executionType || boundPlays !== void 0) {
+    if (outputTable || monitorType || webhookState || executionType || boundPlays !== void 0) {
       lines.push(
         `    ${[
           outputTable ? `table: ${outputTable}` : null,
+          monitorType ? `type: ${monitorType}` : null,
           webhookState ? `webhook: ${webhookState}` : null,
           executionType ? `execution: ${executionType}` : null,
           boundPlays !== void 0 ? `bound Plays: ${boundPlays}` : null
@@ -33043,6 +33105,7 @@ function renderMonitorGet(payload) {
   const tool = asString(payload.tool);
   if (!key || !tool) return void 0;
   const status = asString(payload.status);
+  const monitorType = asString(payload.type);
   const hasLastReceivedEvent = "last_received_event" in payload;
   const lastReceivedEvent = asString(payload.last_received_event);
   const definition = asRecord2(payload.definition);
@@ -33060,8 +33123,9 @@ function renderMonitorGet(payload) {
   const lines = [
     `Monitor: ${key}`,
     `Tool: ${tool}`,
+    ...monitorType ? [`Type: ${monitorType}`] : [],
     ...status ? [`Status: ${status}`] : [],
-    ...hasLastReceivedEvent ? [`Last received: ${lastReceivedEvent ?? "never"}`] : [],
+    ...hasLastReceivedEvent ? [`Latest inbound event: ${lastReceivedEvent ?? "never"}`] : [],
     ...pricingLine ? [`Pricing: ${pricingLine}`] : [],
     ...nextRenewalAt ? [`Next renewal: ${nextRenewalAt}`] : []
   ];
@@ -33127,17 +33191,15 @@ function renderMonitorGet(payload) {
       const name = asString(play.name) ?? "unnamed Play";
       const listener = asString(play.listener_key);
       const health = asRecord2(play.consumer_health);
-      const status2 = asString(health?.last_run_status) ?? "no delivery yet";
+      const runStatus = asString(health?.last_run_status);
       const lastDelivery = asFiniteNumber(health?.last_delivery_at);
+      const runId = asString(health?.last_run_id);
       const error = asString(health?.last_error);
+      lines.push(`  ${name}${listener ? ` (listener: ${listener})` : ""}:`);
       lines.push(
-        `  ${name}${listener ? ` (listener: ${listener})` : ""}: ${status2}`
+        `    Latest delivered event: ${lastDelivery !== void 0 ? new Date(lastDelivery).toISOString() : "never"}`,
+        `    Latest consumer run: ${runId ?? "never"}${runStatus ? ` (${runStatus})` : ""}`
       );
-      if (lastDelivery !== void 0) {
-        lines.push(
-          `    last delivery: ${new Date(lastDelivery).toISOString()}`
-        );
-      }
       if (error) lines.push(`    error: ${error}`);
     }
   }
@@ -34795,7 +34857,7 @@ import {
   existsSync as existsSync14,
   lstatSync as lstatSync2,
   mkdirSync as mkdirSync11,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   realpathSync as realpathSync4,
   writeFileSync as writeFileSync15
 } from "fs";
@@ -34806,7 +34868,7 @@ import { dirname as dirname16, join as join16, resolve as resolve16 } from "path
 import {
   existsSync as existsSync11,
   lstatSync,
-  readFileSync as readFileSync11,
+  readFileSync as readFileSync12,
   realpathSync as realpathSync3,
   rmSync as rmSync4
 } from "fs";
@@ -34822,7 +34884,7 @@ var nodeFileSystem = {
   },
   read(path) {
     try {
-      return readFileSync11(path, "utf8");
+      return readFileSync12(path, "utf8");
     } catch {
       return "";
     }
@@ -34932,7 +34994,7 @@ function isOwnedInstallerCommandPath(input2) {
 
 // src/cli/commands/skills.ts
 import { spawn as spawn3 } from "child_process";
-import { existsSync as existsSync13, mkdirSync as mkdirSync10, readFileSync as readFileSync13, writeFileSync as writeFileSync14 } from "fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync10, readFileSync as readFileSync14, writeFileSync as writeFileSync14 } from "fs";
 import { homedir as homedir8 } from "os";
 import { dirname as dirname15, join as join15 } from "path";
 
@@ -35047,7 +35109,7 @@ import { spawn as spawn2, spawnSync } from "child_process";
 import {
   existsSync as existsSync12,
   mkdirSync as mkdirSync9,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync13,
   unlinkSync,
   writeFileSync as writeFileSync13
 } from "fs";
@@ -35411,7 +35473,7 @@ function hasMarkedSkillsSyncVersion(path, version) {
 }
 function readMarkedSkillsSyncVersion(path) {
   try {
-    return existsSync12(path) ? readFileSync12(path, "utf-8").trim() : "";
+    return existsSync12(path) ? readFileSync13(path, "utf-8").trim() : "";
   } catch {
     return "";
   }
@@ -35899,7 +35961,7 @@ function isSkillsPlanCurrent(plan, state) {
 }
 function readSkillsInstallState(path) {
   try {
-    const parsed = JSON.parse(readFileSync13(path, "utf8"));
+    const parsed = JSON.parse(readFileSync14(path, "utf8"));
     return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
   } catch {
     return null;
@@ -36191,7 +36253,7 @@ function phasesFromLegacyStatus(status) {
 function readSetupState(input2) {
   try {
     const parsed = JSON.parse(
-      readFileSync14(
+      readFileSync15(
         setupStatePath(input2.baseUrl, input2.scope, input2.root),
         "utf8"
       )
@@ -36296,7 +36358,7 @@ function asRecord3(value) {
 }
 function safeRead(path) {
   try {
-    return readFileSync14(path, "utf8");
+    return readFileSync15(path, "utf8");
   } catch {
     return "";
   }
@@ -37060,7 +37122,7 @@ Examples:
 import {
   existsSync as existsSync15,
   mkdirSync as mkdirSync12,
-  readFileSync as readFileSync15,
+  readFileSync as readFileSync16,
   renameSync,
   rmSync as rmSync5,
   writeFileSync as writeFileSync16
@@ -37107,7 +37169,7 @@ function readCliUpdatePreferences(homeDir2 = homedir10()) {
   const path = cliUpdatePreferencesPath(homeDir2);
   if (!existsSync15(path)) return defaultPreferences();
   try {
-    const parsed = JSON.parse(readFileSync15(path, "utf8"));
+    const parsed = JSON.parse(readFileSync16(path, "utf8"));
     return {
       schemaVersion: UPDATE_PREFERENCES_SCHEMA_VERSION,
       autoUpdateEnabled: typeof parsed.autoUpdateEnabled === "boolean" ? parsed.autoUpdateEnabled : true,
@@ -37186,7 +37248,7 @@ import {
   existsSync as existsSync17,
   mkdirSync as mkdirSync13,
   realpathSync as realpathSync5,
-  readFileSync as readFileSync17,
+  readFileSync as readFileSync18,
   renameSync as renameSync2,
   rmSync as rmSync6,
   unlinkSync as unlinkSync2,
@@ -37204,7 +37266,7 @@ import {
 
 // src/cli/install-integrity.ts
 import { createRequire } from "module";
-import { existsSync as existsSync16, readFileSync as readFileSync16, statSync as statSync5 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync17, statSync as statSync5 } from "fs";
 import { isAbsolute as isAbsolute6, join as join18, relative as relative6, resolve as resolve17 } from "path";
 var SDK_SIDECAR_CRITICAL_PACKAGE_FILES = [
   "dist/cli/index.mjs",
@@ -37238,7 +37300,7 @@ function resolveContainedPath(root, value) {
   return target;
 }
 function parseJson(path) {
-  return JSON.parse(readFileSync16(path, "utf8"));
+  return JSON.parse(readFileSync17(path, "utf8"));
 }
 function isFile(path) {
   try {
@@ -37448,7 +37510,7 @@ function publicNpmFallbackRegistryUrl(hostUrl) {
 }
 function readOptionalText(path) {
   try {
-    return readFileSync17(path, "utf8").trim();
+    return readFileSync18(path, "utf8").trim();
   } catch {
     return "";
   }
@@ -37651,7 +37713,7 @@ function readAutoUpdateFailure(plan) {
   if (!path) return null;
   try {
     const parsed = JSON.parse(
-      readFileSync17(path, "utf8")
+      readFileSync18(path, "utf8")
     );
     if ((parsed.kind === "npm-global" || parsed.kind === "python-sidecar") && typeof parsed.packageSpec === "string" && typeof parsed.failedAt === "string" && typeof parsed.exitCode === "number" && typeof parsed.manualCommand === "string") {
       return parsed;
@@ -37737,7 +37799,7 @@ function installedPackageVersion(versionDir) {
     "package.json"
   );
   try {
-    const parsed = JSON.parse(readFileSync17(packageJsonPath, "utf8"));
+    const parsed = JSON.parse(readFileSync18(packageJsonPath, "utf8"));
     return typeof parsed.version === "string" ? safeVersionSegment(parsed.version) : "";
   } catch {
     return "";
@@ -38997,7 +39059,7 @@ import {
   chmodSync,
   existsSync as existsSync18,
   mkdtempSync,
-  readFileSync as readFileSync18,
+  readFileSync as readFileSync19,
   writeFileSync as writeFileSync19
 } from "fs";
 import { tmpdir as tmpdir5 } from "os";
@@ -41126,7 +41188,7 @@ function readJsonArgument(raw, flagName) {
     throw new Error(`Invalid ${flagName} value: empty @file path.`);
   }
   try {
-    return readFileSync18(resolveAtFilePath(filePath), "utf8").replace(
+    return readFileSync19(resolveAtFilePath(filePath), "utf8").replace(
       /^\uFEFF/,
       ""
     );

package/dist/index.d.mts

@@ -1026,6 +1026,8 @@ interface PlayRunListItem {
     startTime?: string | null;
     /** Unix epoch milliseconds when the run started, returned by normalized V2 run summaries. */
     startedAt?: number | string | null;
+    /** Unix epoch milliseconds when the run was created. */
+    createdAt?: number | string | null;
     /** ISO 8601 timestamp when the run finished. */
     closeTime?: string | null;
     /** Unix epoch milliseconds when the run finished, returned by normalized V2 run summaries. */
@@ -2437,6 +2439,8 @@ type MonitorListEntry = {
     monitor_key?: string;
     status?: string;
     tool?: string;
+    /** Generic provider-authored event category for this deployed monitor. */
+    type?: string;
     name?: string;
     configured?: boolean;
     active?: boolean;

package/dist/index.d.ts

@@ -1026,6 +1026,8 @@ interface PlayRunListItem {
     startTime?: string | null;
     /** Unix epoch milliseconds when the run started, returned by normalized V2 run summaries. */
     startedAt?: number | string | null;
+    /** Unix epoch milliseconds when the run was created. */
+    createdAt?: number | string | null;
     /** ISO 8601 timestamp when the run finished. */
     closeTime?: string | null;
     /** Unix epoch milliseconds when the run finished, returned by normalized V2 run summaries. */
@@ -2437,6 +2439,8 @@ type MonitorListEntry = {
     monitor_key?: string;
     status?: string;
     tool?: string;
+    /** Generic provider-authored event category for this deployed monitor. */
+    type?: string;
     name?: string;
     configured?: boolean;
     active?: boolean;

package/dist/index.js

@@ -832,7 +832,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.68",
+  version: "0.3.69",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.mjs

@@ -744,7 +744,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.68",
+  version: "0.3.69",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.68",
+  "version": "0.3.69",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",