@2kw/ai 6.3.0-dev.43 → 6.3.0-dev.45

package/dist/commands/tracing.js

@@ -1,10 +1,11 @@
 import { Command } from "commander";
 import { getClient, runAction } from "../lib/client.js";
 import { formatDetail, formatList } from "../lib/output.js";
+import { tracingSettingsBody } from "../lib/tracing-settings.js";
 export function makeTracingCommand() {
     const cmd = new Command("tracing").description("Traces and per-org tracing settings (prompt / completion capture)");
     // ── settings ──────────────────────────────────────────────────
-    const settings = new Command("settings").description("Manage per-org tracing settings (includePrompts / includeCompletions)");
+    const settings = new Command("settings").description("Manage per-org tracing settings (PII capture and trace retention)");
     settings
         .command("get")
         .description("Show current tracing settings")
@@ -20,6 +21,7 @@ export function makeTracingCommand() {
         .description("Update tracing settings. Both toggles control PII capture — default is false for both.")
         .option("--include-prompts <bool>", "Retain prompt content on ingested spans (true/false)")
         .option("--include-completions <bool>", "Retain completion content on ingested spans (true/false)")
+        .option("--retention-days <days>", 'Trace retention in days, at most your plan\'s limit, or "plan" to follow the plan. Shortening deletes older traces at the next daily sweep.')
         .action(async (opts, command) => {
         await runAction(command, async () => {
             const client = getClient(command);
@@ -27,17 +29,8 @@ export function makeTracingCommand() {
             // resetting the other. Otherwise an unset flag defaults to false
             // and silently disables capture the admin had already enabled.
             const { data: current } = await client.GET("/v1/tracing/settings");
-            const body = {
-                includePrompts: opts.includePrompts !== undefined
-                    ? opts.includePrompts === "true"
-                    : (current?.includePrompts ?? false),
-                includeCompletions: opts.includeCompletions !== undefined
-                    ? opts.includeCompletions === "true"
-                    : (current?.includeCompletions ?? false),
-            };
-            const { data } = await client.PUT("/v1/tracing/settings", {
-                body,
-            });
+            const body = tracingSettingsBody(current, opts);
+            const { data } = await client.PUT("/v1/tracing/settings", { body });
             formatDetail(data, command);
         });
     });

package/dist/lib/tracing-settings.d.ts

@@ -0,0 +1,26 @@
+/** The options of `tracing settings set`, as commander hands them over. */
+export interface TracingSettingsOptions {
+    includePrompts?: string;
+    includeCompletions?: string;
+    retentionDays?: string;
+}
+/** The fields of a GET this command carries through. */
+export interface TracingSettingsCurrent {
+    includePrompts?: boolean;
+    includeCompletions?: boolean;
+    retentionDays?: number | null;
+}
+export interface TracingSettingsBody {
+    includePrompts: boolean;
+    includeCompletions: boolean;
+    retentionDays: number | null;
+}
+/**
+ * The PUT body: the options given, and the current value of everything else. The PUT is a
+ * full replace (#1015), so a field left out would reset: a missing retentionDays would
+ * follow the plan again and undo the admin's shorter choice.
+ */
+export declare function tracingSettingsBody(current: TracingSettingsCurrent | undefined, opts: TracingSettingsOptions): TracingSettingsBody;
+/** `plan` follows the plan's limit; anything else must be a whole number of days, 1 or more. */
+export declare function parseRetentionDays(value: string): number | null;
+//# sourceMappingURL=tracing-settings.d.ts.map

package/dist/lib/tracing-settings.js

@@ -0,0 +1,25 @@
+import { CliUsageError } from "./errors.js";
+/**
+ * The PUT body: the options given, and the current value of everything else. The PUT is a
+ * full replace (#1015), so a field left out would reset: a missing retentionDays would
+ * follow the plan again and undo the admin's shorter choice.
+ */
+export function tracingSettingsBody(current, opts) {
+    return {
+        includePrompts: opts.includePrompts !== undefined ? opts.includePrompts === "true" : (current?.includePrompts ?? false),
+        includeCompletions: opts.includeCompletions !== undefined
+            ? opts.includeCompletions === "true"
+            : (current?.includeCompletions ?? false),
+        retentionDays: opts.retentionDays !== undefined ? parseRetentionDays(opts.retentionDays) : (current?.retentionDays ?? null),
+    };
+}
+/** `plan` follows the plan's limit; anything else must be a whole number of days, 1 or more. */
+export function parseRetentionDays(value) {
+    if (value === "plan")
+        return null;
+    if (!/^[1-9]\d*$/.test(value)) {
+        throw new CliUsageError(`--retention-days must be a whole number of days (1 or more) or "plan", got "${value}".`);
+    }
+    return Number(value);
+}
+//# sourceMappingURL=tracing-settings.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai",
-  "version": "6.3.0-dev.43",
+  "version": "6.3.0-dev.45",
   "description": "CLI for 2kw.ai — schema-driven document extraction, an OpenAI-compatible EU LLM gateway, transcription, prompts, datasets, and experiments from your terminal or agentic workflows. Ships as 2kw, backbone, and bb.",
   "keywords": [
     "cli",