deepline 0.3.136 → 0.3.138

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.136',
+  version: '0.3.138',
   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/shared_libs/observability/dlq.ts

@@ -200,6 +200,11 @@ export const QUEUE_ITEM_STATES = [
 
 export type QueueItemState = (typeof QUEUE_ITEM_STATES)[number];
 
+/** Operator disposition is an overlay on native source state. Retiring an
+ * item removes it from active operational views without pretending the owner
+ * completed, deleted, or replayed the source row. */
+export type QueueItemDisposition = 'active' | 'retired';
+
 export type QueueItemAction =
   | 'archive'
   | 'quarantine'
@@ -207,6 +212,7 @@ export type QueueItemAction =
   | 'hold'
   | 'resume'
   | 'cancel'
+  | 'retire'
   | 'update';
 
 export const QUEUE_ITEM_ACTIONS = [
@@ -216,6 +222,7 @@ export const QUEUE_ITEM_ACTIONS = [
   'hold',
   'resume',
   'cancel',
+  'retire',
   'update',
 ] as const satisfies readonly QueueItemAction[];
 
@@ -262,6 +269,8 @@ export type QueueItem = {
   readonly revision: string;
   readonly observedAt: string;
   readonly state: QueueItemState;
+  /** Additive operator overlay; older connectors may omit it. */
+  readonly disposition?: QueueItemDisposition;
   readonly nativeState: string;
   readonly lastError?: QueueItemLastError;
   readonly actions: readonly ActionAvailability[];
@@ -269,6 +278,8 @@ export type QueueItem = {
   readonly createdAt?: string;
   readonly updatedAt?: string;
   readonly summary?: string;
+  readonly retiredAt?: string;
+  readonly retirementReason?: string;
 };
 
 /** Keep old DLQ verbs working at the boundary while exposing a smaller,
@@ -424,8 +435,9 @@ export type QueueItemConnectorContext = {
 
 /**
  * Owner implementation port. The connector owns native reads, state mapping,
- * lease/CAS checks, and outcome verification. The shared control service only
- * authenticates, validates, journals idempotency, and returns this result.
+ * lease/CAS checks, and outcome verification. `retire` is the one shared
+ * disposition action: connectors fence the source revision, while the shared
+ * control plane records an overlay and never mutates the owner row.
  */
 export type QueueItemConnector = {
   readonly id: string;

package/dist/cli/index.js

@@ -3068,7 +3068,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.136",
+  version: "0.3.138",
   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
@@ -36192,6 +36192,14 @@ function parseSessionAgent(value) {
   }
   throw new Error("Invalid --agent value. Expected auto, claude, or codex.");
 }
+function parseSessionRating(value) {
+  if (value === void 0) return void 0;
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "good" || normalized === "bad" || normalized === "neutral") {
+    return normalized;
+  }
+  throw new Error("Invalid --rating value. Expected good, bad, or neutral.");
+}
 function findSessionFile(sessionId, agent) {
   if (!UUID_RE.test(sessionId)) {
     throw new Error(
@@ -36457,7 +36465,8 @@ async function uploadChunkedSessions(sessions, options) {
     upload_id: uploadId,
     session_ids: sessions.map((session) => session.sessionId),
     labels: sessions.map((session) => session.label),
-    environments: sessions.map(() => detectShellContext())
+    environments: sessions.map(() => detectShellContext()),
+    ...options.rating ? { rating: options.rating } : {}
   });
   printCommandEnvelope(
     {
@@ -36477,6 +36486,7 @@ async function uploadChunkedSessions(sessions, options) {
   );
 }
 async function handleSessionsSend(options) {
+  const rating = parseSessionRating(options.rating);
   if (options.file) {
     const filePath = (0, import_node_path19.resolve)(options.file);
     if (!(0, import_node_fs14.existsSync)(filePath)) {
@@ -36484,7 +36494,8 @@ async function handleSessionsSend(options) {
     }
     const response2 = await uploadPayload("/api/v2/cli/send-session", {
       file: (0, import_node_fs14.readFileSync)(filePath).toString("base64"),
-      filename: (0, import_node_path19.basename)(filePath)
+      filename: (0, import_node_path19.basename)(filePath),
+      ...rating ? { rating } : {}
     });
     printCommandEnvelope(
       {
@@ -36517,13 +36528,14 @@ async function handleSessionsSend(options) {
     return { ...target, ...upload };
   });
   if (built.some((session) => session.needsChunking)) {
-    await uploadChunkedSessions(built, options);
+    await uploadChunkedSessions(built, { json: options.json, rating });
     return;
   }
   const response = built.length === 1 && !options.label?.length ? await uploadPayload("/api/v2/cli/send-session", {
     session_id: built[0]?.sessionId,
     content: built[0]?.encodedContent,
-    environment: detectShellContext()
+    environment: detectShellContext(),
+    ...rating ? { rating } : {}
   }) : await uploadPayload("/api/v2/cli/send-session", {
     sessions: built.map((session) => ({
       session_id: session.sessionId,
@@ -36531,7 +36543,8 @@ async function handleSessionsSend(options) {
       label: session.label,
       environment: detectShellContext()
     })),
-    environment: detectShellContext()
+    environment: detectShellContext(),
+    ...rating ? { rating } : {}
   });
   printCommandEnvelope(
     {
@@ -36709,6 +36722,7 @@ Examples:
   deepline ${familyName} send --current-session --json
   deepline ${familyName} send --agent codex --current-session --json
   deepline ${familyName} send --session-id 5a3bfb97-a2d9-49d9-82c6-52ccc03dadca --label "pilot run"
+  deepline ${familyName} send --current-session --rating bad --json   # tag the session as one that went badly
   deepline ${familyName} send --file ./debug.log --json
 `
   ).option(
@@ -36725,7 +36739,10 @@ Examples:
     "--agent <auto|claude|codex>",
     "Limit transcript discovery to one agent runtime",
     "auto"
-  ).option("--current-session", "Use the newest local agent session JSONL").option("--file <path>", "Upload a raw local file instead of a session").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleSessionsSend);
+  ).option("--current-session", "Use the newest local agent session JSONL").option("--file <path>", "Upload a raw local file instead of a session").option(
+    "--rating <good|bad|neutral>",
+    "Tag the upload by outcome, not tone, so Deepline can filter sessions: good = the user's goal was met without product problems; bad = the goal was missed, or a product failure, bug, or avoidable friction (including a substantial workaround) got in the way; neutral = partly met or unclear."
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleSessionsSend);
   parent.command("render").description("Render local session transcript(s) to an HTML viewer.").addHelpText(
     "after",
     `

package/dist/cli/index.mjs

@@ -3063,7 +3063,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.136",
+  version: "0.3.138",
   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
@@ -36271,6 +36271,14 @@ function parseSessionAgent(value) {
   }
   throw new Error("Invalid --agent value. Expected auto, claude, or codex.");
 }
+function parseSessionRating(value) {
+  if (value === void 0) return void 0;
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "good" || normalized === "bad" || normalized === "neutral") {
+    return normalized;
+  }
+  throw new Error("Invalid --rating value. Expected good, bad, or neutral.");
+}
 function findSessionFile(sessionId, agent) {
   if (!UUID_RE.test(sessionId)) {
     throw new Error(
@@ -36536,7 +36544,8 @@ async function uploadChunkedSessions(sessions, options) {
     upload_id: uploadId,
     session_ids: sessions.map((session) => session.sessionId),
     labels: sessions.map((session) => session.label),
-    environments: sessions.map(() => detectShellContext())
+    environments: sessions.map(() => detectShellContext()),
+    ...options.rating ? { rating: options.rating } : {}
   });
   printCommandEnvelope(
     {
@@ -36556,6 +36565,7 @@ async function uploadChunkedSessions(sessions, options) {
   );
 }
 async function handleSessionsSend(options) {
+  const rating = parseSessionRating(options.rating);
   if (options.file) {
     const filePath = resolve14(options.file);
     if (!existsSync10(filePath)) {
@@ -36563,7 +36573,8 @@ async function handleSessionsSend(options) {
     }
     const response2 = await uploadPayload("/api/v2/cli/send-session", {
       file: readFileSync11(filePath).toString("base64"),
-      filename: basename5(filePath)
+      filename: basename5(filePath),
+      ...rating ? { rating } : {}
     });
     printCommandEnvelope(
       {
@@ -36596,13 +36607,14 @@ async function handleSessionsSend(options) {
     return { ...target, ...upload };
   });
   if (built.some((session) => session.needsChunking)) {
-    await uploadChunkedSessions(built, options);
+    await uploadChunkedSessions(built, { json: options.json, rating });
     return;
   }
   const response = built.length === 1 && !options.label?.length ? await uploadPayload("/api/v2/cli/send-session", {
     session_id: built[0]?.sessionId,
     content: built[0]?.encodedContent,
-    environment: detectShellContext()
+    environment: detectShellContext(),
+    ...rating ? { rating } : {}
   }) : await uploadPayload("/api/v2/cli/send-session", {
     sessions: built.map((session) => ({
       session_id: session.sessionId,
@@ -36610,7 +36622,8 @@ async function handleSessionsSend(options) {
       label: session.label,
       environment: detectShellContext()
     })),
-    environment: detectShellContext()
+    environment: detectShellContext(),
+    ...rating ? { rating } : {}
   });
   printCommandEnvelope(
     {
@@ -36788,6 +36801,7 @@ Examples:
   deepline ${familyName} send --current-session --json
   deepline ${familyName} send --agent codex --current-session --json
   deepline ${familyName} send --session-id 5a3bfb97-a2d9-49d9-82c6-52ccc03dadca --label "pilot run"
+  deepline ${familyName} send --current-session --rating bad --json   # tag the session as one that went badly
   deepline ${familyName} send --file ./debug.log --json
 `
   ).option(
@@ -36804,7 +36818,10 @@ Examples:
     "--agent <auto|claude|codex>",
     "Limit transcript discovery to one agent runtime",
     "auto"
-  ).option("--current-session", "Use the newest local agent session JSONL").option("--file <path>", "Upload a raw local file instead of a session").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleSessionsSend);
+  ).option("--current-session", "Use the newest local agent session JSONL").option("--file <path>", "Upload a raw local file instead of a session").option(
+    "--rating <good|bad|neutral>",
+    "Tag the upload by outcome, not tone, so Deepline can filter sessions: good = the user's goal was met without product problems; bad = the goal was missed, or a product failure, bug, or avoidable friction (including a substantial workaround) got in the way; neutral = partly met or unclear."
+  ).option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleSessionsSend);
   parent.command("render").description("Render local session transcript(s) to an HTML viewer.").addHelpText(
     "after",
     `

package/dist/index.js

@@ -864,7 +864,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.136",
+  version: "0.3.138",
   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/index.mjs

@@ -768,7 +768,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.136",
+  version: "0.3.138",
   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.d.mts

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