@2kw/ai 7.0.0-dev.9 → 7.1.0-dev.1

package/README.md

@@ -110,7 +110,7 @@ kubectl-style contexts switch between organizations and environments:
 | `tracing` | Inspect request traces and tracing settings |
 | `memory` | Your agent memory files (list, read, write, delete, forget); member totals and erasure for admins |
 | `providers` | Manage BYOK AI providers |
-| `analytics` | Usage analytics: spend, quality, providers, errors |
+| `analytics` | Usage analytics: operations, tokens, quality, providers, errors |
 | `billing` | Check subscription tier and usage limits |
 | `agents` | Run agents and answer paused runs (approvals and relayed tool calls); apply, export and scaffold agent.yaml; manage versions, labels, approvals and tool catalogs |
 | `skills` | Import and export SKILL.md bundles; manage skill versions and labels |

package/dist/commands/analytics.js

@@ -8,7 +8,7 @@ function addDateOptions(cmd) {
 }
 export function makeAnalyticsCommand() {
     const cmd = new Command("analytics").description("Organization analytics");
-    const summary = new Command("summary").description("Cross-surface summary (total ops, spend, p95, per-surface breakdown)");
+    const summary = new Command("summary").description("Cross-surface summary (total ops, tokens, p95, per-surface breakdown)");
     addDateOptions(summary);
     summary.action(async (opts, command) => {
         await runAction(command, async () => {
@@ -66,7 +66,6 @@ export function makeAnalyticsCommand() {
                 "successfulExtractions",
                 "successRate",
                 "totalTokens",
-                "totalCost",
                 "avgDurationMs",
             ]);
         });
@@ -89,7 +88,6 @@ export function makeAnalyticsCommand() {
                 "successfulExtractions",
                 "successRate",
                 "totalTokens",
-                "totalCost",
                 "avgDurationMs",
             ]);
         });

package/dist/commands/responses.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeResponsesCommand(): Command;
+//# sourceMappingURL=responses.d.ts.map

package/dist/commands/responses.js

@@ -0,0 +1,46 @@
+import { Command } from "commander";
+import { getClient, runAction } from "../lib/client.js";
+import { isJsonOutput } from "../lib/config.js";
+import { formatDetail, formatSuccess } from "../lib/output.js";
+export function makeResponsesCommand() {
+    const cmd = new Command("responses").description("Read and cancel background responses (agent runs started with background: true)");
+    cmd
+        .command("get")
+        .description("Read a background response as it stands now: queued, in_progress, requires_action, completed, " +
+        "incomplete, failed or cancelled. Only background responses can be read by id.")
+        .argument("<responseId>", "Response ID")
+        .action(async (responseId, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/responses/{responseId}", {
+                params: { path: { responseId } },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("cancel")
+        .description("Cancel the background run whose newest response this is. A queued or paused run is cancelled at " +
+        "once; a running one stops at its next step. Only the caller that started the run can cancel it; " +
+        "an older response of the run is refused with a conflict that names the newest one.")
+        .argument("<responseId>", "Response ID")
+        .action(async (responseId, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/responses/{responseId}/cancel", {
+                params: { path: { responseId } },
+            });
+            const response = data;
+            if (isJsonOutput(command)) {
+                formatDetail(response, command);
+                return;
+            }
+            const status = typeof response?.status === "string" ? response.status : undefined;
+            formatSuccess(status === "cancelled"
+                ? `Response ${responseId} cancelled.`
+                : `Cancel requested for response ${responseId}; it stops at its next step (status: ${status ?? "unknown"}).`, command);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=responses.js.map

package/dist/index.js

@@ -28,6 +28,7 @@ import { makeScoresCommand } from "./commands/scores.js";
 import { makeQueuesCommand } from "./commands/queues.js";
 import { makeAgentsCommand } from "./commands/agents.js";
 import { makeConversationsCommand } from "./commands/conversations.js";
+import { makeResponsesCommand } from "./commands/responses.js";
 import { makeKnowledgeCommand } from "./commands/knowledge.js";
 import { makeFilesCommand } from "./commands/files.js";
 import { makeInstallationsCommand } from "./commands/installations.js";
@@ -68,6 +69,7 @@ program.addCommand(makeSettingsCommand());
 program.addCommand(makeMemoryCommand());
 program.addCommand(makeAgentsCommand());
 program.addCommand(makeConversationsCommand());
+program.addCommand(makeResponsesCommand());
 program.addCommand(makeKnowledgeCommand());
 program.addCommand(makeFilesCommand());
 program.addCommand(makeInstallationsCommand());

package/dist/lib/client.js

@@ -39,6 +39,8 @@ export const errorMiddleware = {
             code: typeof nested?.code === "string" ? nested.code : undefined,
             // A problem detail names its cause in `errorCode` (GlobalExceptionHandler).
             errorCode: typeof body.errorCode === "string" ? body.errorCode : undefined,
+            // A background run's 409 names its newest response, so the caller can poll it.
+            headResponseId: typeof nested?.head_response_id === "string" ? nested.head_response_id : undefined,
         });
     },
 };

package/dist/lib/errors.d.ts

@@ -15,6 +15,8 @@ export interface ApiErrorBody {
      * Kept apart from {@link code}: that one holds lowercase gateway codes and is printed by `--json`.
      */
     errorCode?: string;
+    /** The background run's newest response, named by a 409 the run's state answers. */
+    headResponseId?: string;
 }
 export declare class BackboneApiError extends Error {
     readonly status: number;
@@ -22,6 +24,7 @@ export declare class BackboneApiError extends Error {
     readonly timestamp: string;
     readonly code?: string;
     readonly errorCode?: string;
+    readonly headResponseId?: string;
     constructor(body: Omit<ApiErrorBody, "error"> & {
         error: string;
     });

package/dist/lib/errors.js

@@ -8,6 +8,7 @@ export class BackboneApiError extends Error {
     timestamp;
     code;
     errorCode;
+    headResponseId;
     constructor(body) {
         super(body.message);
         this.name = "BackboneApiError";
@@ -16,6 +17,7 @@ export class BackboneApiError extends Error {
         this.timestamp = body.timestamp;
         this.code = body.code;
         this.errorCode = body.errorCode;
+        this.headResponseId = body.headResponseId;
     }
 }
 /**
@@ -108,6 +110,9 @@ export function hintFor(err) {
     if (err.code === "invalid_approval_decision" && /decided by a conversation grant/.test(err.message)) {
         return "This request was already approved by a conversation grant; nothing to decide.";
     }
+    if (err.headResponseId) {
+        return `The run's newest response is ${err.headResponseId}. Check it: 2kw responses get ${err.headResponseId}`;
+    }
     if (err.code && CODE_HINTS[err.code])
         return CODE_HINTS[err.code];
     // The 403 whose cause is the credential, not the role (#805). Without this the
@@ -169,6 +174,7 @@ export function handleError(err, json) {
                 error: err.errorType,
                 status: err.status,
                 ...(err.code ? { code: err.code } : {}),
+                ...(err.headResponseId ? { head_response_id: err.headResponseId } : {}),
                 message: err.message,
                 timestamp: err.timestamp,
             }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai",
-  "version": "7.0.0-dev.9",
+  "version": "7.1.0-dev.1",
   "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",