@2kw/ai 8.0.0-dev.1 → 8.0.0-dev.12

package/dist/agent-config/schema.d.ts

@@ -301,6 +301,32 @@ export declare const agentSchema: {
                 };
             };
         };
+        readonly showTableTool: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["type"];
+            readonly properties: {
+                readonly type: {
+                    readonly const: "backbone.show_table";
+                };
+                readonly requiresConfirmation: {
+                    readonly type: "boolean";
+                };
+            };
+        };
+        readonly showChartTool: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["type"];
+            readonly properties: {
+                readonly type: {
+                    readonly const: "backbone.show_chart";
+                };
+                readonly requiresConfirmation: {
+                    readonly type: "boolean";
+                };
+            };
+        };
         readonly skillTool: {
             readonly type: "object";
             readonly additionalProperties: false;
@@ -493,6 +519,30 @@ export declare const agentSchema: {
                 readonly then: {
                     readonly $ref: "#/$defs/bashTool";
                 };
+            }, {
+                readonly if: {
+                    required: string[];
+                    properties: {
+                        type: {
+                            const: string;
+                        };
+                    };
+                };
+                readonly then: {
+                    readonly $ref: "#/$defs/showTableTool";
+                };
+            }, {
+                readonly if: {
+                    required: string[];
+                    properties: {
+                        type: {
+                            const: string;
+                        };
+                    };
+                };
+                readonly then: {
+                    readonly $ref: "#/$defs/showChartTool";
+                };
             }, {
                 readonly if: {
                     required: string[];

package/dist/agent-config/schema.js

@@ -44,6 +44,8 @@ const BUILTIN_TYPES = [
     "backbone.todo",
     "backbone.skill",
     "backbone.bash",
+    "backbone.show_table",
+    "backbone.show_chart",
     "function",
 ];
 const typeIs = (t) => ({ required: ["type"], properties: { type: { const: t } } });
@@ -207,6 +209,19 @@ export const agentSchema = {
             required: ["type"],
             properties: { type: { const: "backbone.todo" }, requiresConfirmation: { type: "boolean" } },
         },
+        // #1419: no options; requiresConfirmation as todoTool, since an author may tighten a read tool.
+        showTableTool: {
+            type: "object",
+            additionalProperties: false,
+            required: ["type"],
+            properties: { type: { const: "backbone.show_table" }, requiresConfirmation: { type: "boolean" } },
+        },
+        showChartTool: {
+            type: "object",
+            additionalProperties: false,
+            required: ["type"],
+            properties: { type: { const: "backbone.show_chart" }, requiresConfirmation: { type: "boolean" } },
+        },
         skillTool: {
             type: "object",
             additionalProperties: false,
@@ -266,6 +281,8 @@ export const agentSchema = {
                 { if: typeIs("backbone.todo"), then: { $ref: "#/$defs/todoTool" } },
                 { if: typeIs("backbone.skill"), then: { $ref: "#/$defs/skillTool" } },
                 { if: typeIs("backbone.bash"), then: { $ref: "#/$defs/bashTool" } },
+                { if: typeIs("backbone.show_table"), then: { $ref: "#/$defs/showTableTool" } },
+                { if: typeIs("backbone.show_chart"), then: { $ref: "#/$defs/showChartTool" } },
                 { if: typeIs("function"), then: { $ref: "#/$defs/functionTool" } },
                 {
                     // The validator reports these with the reason from NON_AUTHORABLE_TOOL_TYPES; this keeps the published schema honest.

package/dist/agent-config/template.js

@@ -41,6 +41,8 @@ tools: []
 #     skills: [skill-name@latest]
 #   - type: backbone.bash
 #     approval: sandbox
+#   - type: backbone.show_table
+#   - type: backbone.show_chart
 #   - type: function
 #     name: lookup_order
 #     description: Look up an order by number

package/dist/commands/files.js

@@ -2,10 +2,9 @@ import { Command } from "commander";
 import { writeFileSync } from "node:fs";
 import chalk from "chalk";
 import { getClient, resolveAuthHeader, runAction } from "../lib/client.js";
-import { resolveConfig } from "../lib/config.js";
+import { isJsonOutput, resolveConfig } from "../lib/config.js";
 import { BackboneApiError } from "../lib/errors.js";
-import { formatPage, formatDetail, formatSuccess, withSpinner } from "../lib/output.js";
-import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+import { formatDetail, formatList, formatSuccess, withSpinner } from "../lib/output.js";
 import { fileToBlob } from "../lib/multipart.js";
 /**
  * Upload a single file with purpose=agent_input|knowledge. Both are multipart
@@ -59,15 +58,31 @@ async function downloadFile(command, fileId) {
 export function makeFilesCommand() {
     const cmd = new Command("files").description("Manage uploaded files");
     const list = new Command("list").description("List files");
-    addPaginationOptions(list);
     list.option("--purpose <purpose>", "Filter by purpose (agent_input, knowledge)");
+    list.option("--limit <number>", "How many files to list (1-100)", "20");
+    list.option("--after <fileId>", "List the files after this one (the previous list's last id)");
+    list.option("--order <order>", "asc (oldest first) or desc (newest first)", "desc");
     list.action(async (opts, command) => {
         await runAction(command, async () => {
             const client = getClient(command);
             const { data } = await client.GET("/v1/files", {
-                params: { query: { purpose: opts.purpose, ...paginationParams(opts) } },
+                params: {
+                    query: {
+                        purpose: opts.purpose,
+                        limit: parseInt(opts.limit, 10),
+                        after: opts.after,
+                        order: opts.order,
+                    },
+                },
             });
-            formatPage(data, command, ["id", "filename", "purpose", "bytes", "created_at"]);
+            if (isJsonOutput(command)) {
+                console.log(JSON.stringify(data, null, 2));
+                return;
+            }
+            formatList(data?.data, command, ["id", "filename", "purpose", "bytes", "created_at"]);
+            if (data?.has_more) {
+                console.log(chalk.dim(`More files: --after ${data.last_id}`));
+            }
         });
     });
     cmd.addCommand(list);

package/dist/commands/knowledge.js

@@ -86,10 +86,23 @@ export function makeKnowledgeCommand() {
         .option("--reranker-provider <id>", "New reranker provider ID")
         .option("--hybrid-search <bool>", "Enable hybrid search (true/false)")
         .option("--text-search-language <name>", "Change the text-search language (reindexes in the background); omit to leave it untouched")
+        .option("--cancel-text-search-reindex", "Abandon the text-search reindex in progress and keep the active language")
         .action(async (id, opts, command) => {
         await runAction(command, async () => {
             const client = getClient(command);
-            const body = {};
+            // The update takes the full body: name, slug, provider, model and dimension are required on
+            // every PATCH, so start from the stored values and overlay the flags. Optional fields left
+            // out keep their stored values server-side.
+            const { data: current } = await client.GET("/v1/knowledge-bases/{id}", {
+                params: { path: { id } },
+            });
+            const body = {
+                name: current?.name,
+                slug: current?.slug,
+                embeddingProviderId: current?.embeddingProviderId,
+                embeddingModel: current?.embeddingModel,
+                embeddingDim: current?.embeddingDim,
+            };
             if (opts.name)
                 body.name = opts.name;
             if (opts.description !== undefined)
@@ -112,6 +125,8 @@ export function makeKnowledgeCommand() {
                 body.hybridSearchEnabled = opts.hybridSearch === "true";
             if (opts.textSearchLanguage)
                 body.textSearchLanguage = opts.textSearchLanguage;
+            if (opts.cancelTextSearchReindex)
+                body.cancelTextSearchReindex = true;
             const { data } = await client.PATCH("/v1/knowledge-bases/{id}", {
                 params: { path: { id } },
                 body: body,

package/dist/commands/skills.js

@@ -138,7 +138,7 @@ export function makeSkillsCommand() {
                 const bundle = packSkillDirectory(path);
                 if (bundle.skipped.length > 0) {
                     // The server reports what it was sent; only the CLI can name what never left the disk.
-                    console.error(`Left out of the bundle (the importer takes SKILL.md, references/, assets/, scripts/): ${bundle.skipped.join(", ")}`);
+                    console.error(`Left out of the bundle (the importer takes SKILL.md, references/, assets/, scripts/, examples/): ${bundle.skipped.join(", ")}`);
                 }
                 blob = new Blob([bundle.bytes], { type: "application/zip" });
                 filename = bundle.filename;
@@ -171,6 +171,7 @@ export function makeSkillsCommand() {
         .option("-o, --output <file>", "Output path (default: <skill-name>-v<n>.zip)")
         .option("-d, --extract-to <dir>", "Unpack the bundle into this directory instead of writing a zip")
         .option("--force", "Write into a non-empty --extract-to directory")
+        .option("--include-examples", "Keep the confidential examples/ files (needs ADMIN or OWNER)")
         .action(async (id, versionNumber, opts, command) => {
         await runAction(command, async () => {
             if (opts.output && opts.extractTo)
@@ -189,14 +190,21 @@ export function makeSkillsCommand() {
             }
             const config = resolveConfig(command);
             const authHeader = await resolveAuthHeader(config);
+            let omitted = 0;
             const bytes = await withSpinner("Exporting skill...", async () => {
                 const baseUrl = config.baseUrl.replace(/\/+$/, "");
-                const res = await fetch(`${baseUrl}/v1/skills/${encodeURIComponent(id)}/versions/${encodeURIComponent(versionNumber)}/export`, {
+                const query = opts.includeExamples ? "?includeExamples=true" : "";
+                const res = await fetch(`${baseUrl}/v1/skills/${encodeURIComponent(id)}/versions/${encodeURIComponent(versionNumber)}/export${query}`, {
                     headers: { Authorization: authHeader },
                 });
                 await checkResponse(res);
+                omitted = Number(res.headers.get("X-Skill-Examples-Omitted") ?? 0);
                 return Buffer.from(await res.arrayBuffer());
             });
+            if (omitted > 0) {
+                // #926: a re-import of this bundle would drop them, so say so where the user looks.
+                console.error(`${omitted} confidential example file(s) left out; --include-examples (admin) keeps them`);
+            }
             if (opts.extractTo) {
                 mkdirSync(opts.extractTo, { recursive: true });
                 const written = unpackSkillBundle(new Uint8Array(bytes), opts.extractTo);

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import { Command } from "commander";
+import { Command, CommanderError } from "commander";
 import { makeAuthCommand } from "./commands/auth.js";
 const require = createRequire(import.meta.url);
 const pkg = require("../package.json");
@@ -78,5 +78,20 @@ program.addCommand(makeConnectorsCommand());
 program.addCommand(makeRelaysCommand());
 program.addCommand(makeBridgeCommand());
 program.addCommand(makeDocsCommand());
-program.parseAsync().then(() => updater.notify());
+// Commander exits 1 on its own parse errors, and 1 is the exit code for API and network failures.
+// Every command throws instead, so a usage error exits 2 like a CliUsageError (#697).
+const throwOnExit = (cmd) => {
+    cmd.exitOverride();
+    cmd.commands.forEach(throwOnExit);
+};
+throwOnExit(program);
+program
+    .parseAsync()
+    .then(() => updater.notify())
+    .catch((err) => {
+    if (!(err instanceof CommanderError))
+        throw err;
+    // --help, --version and a command group's help without a subcommand succeed.
+    process.exit(err.exitCode === 0 || err.code === "commander.help" ? 0 : 2);
+});
 //# sourceMappingURL=index.js.map

package/dist/lib/agent-run.d.ts

@@ -53,6 +53,18 @@ export interface PendingInput {
     mode: InputMode;
     answerUrl: string;
 }
+/**
+ * A table or chart the agent showed the user (#1419): a `backbone:ui` item, its validated `props` as the
+ * server sent them. A client renders from `props`, never from the call's arguments.
+ */
+export interface ShownComponent {
+    id: string;
+    callId: string;
+    /** `table` or `chart`; another value is a component this build does not know. */
+    component: string;
+    schemaVersion: number;
+    props: unknown;
+}
 /** The end user's conversation mode (epic &59); the server matches these three values exactly. */
 export type ConversationMode = "plan" | "ask" | "auto";
 export declare const CONVERSATION_MODES: readonly ConversationMode[];
@@ -60,7 +72,7 @@ export declare const CONVERSATION_MODES: readonly ConversationMode[];
 export declare const MODE_OPTION_HELP: string;
 /**
  * The `--mode` value, checked before any request is sent: anything but the three exact values is a
- * usage error (exit 2). Commander's `.choices()` is not used because it exits 1 through `process.exit`.
+ * usage error (exit 2).
  */
 export declare function parseModeOption(raw: string | undefined): ConversationMode | undefined;
 /** The `backbone:mode` input item (S1 D7); always appended last. */
@@ -87,6 +99,7 @@ export interface RunEnvelope {
     pendingToolCalls: PendingToolCall[];
     pendingConnections: PendingConnection[];
     pendingInputs: PendingInput[];
+    components: ShownComponent[];
     incompleteReason: string | null;
     usage: {
         inputTokens: number;

package/dist/lib/agent-run.js

@@ -1,4 +1,5 @@
 import chalk from "chalk";
+import Table from "cli-table3";
 import { DEFAULT_CHAT_URL } from "./config.js";
 import { answerUrlFor, connectCallIds, connectionsPhrase, inputLabelsPhrase, pendingConnectionsOf, pendingInputsOf, } from "./connect-pause.js";
 import { CliUsageError } from "./errors.js";
@@ -13,7 +14,7 @@ function isConversationMode(value) {
 }
 /**
  * The `--mode` value, checked before any request is sent: anything but the three exact values is a
- * usage error (exit 2). Commander's `.choices()` is not used because it exits 1 through `process.exit`.
+ * usage error (exit 2).
  */
 export function parseModeOption(raw) {
     if (raw === undefined)
@@ -186,6 +187,8 @@ const DECODED_ITEM_TYPES = new Set([
     "backbone:connector_auth_request",
     "backbone:input_request",
     "backbone:tool_image",
+    // A table or chart a finished ShowTable or ShowChart call showed (#1419): it never holds a run either.
+    "backbone:ui",
     "mcp_approval_request",
     "mcp_call",
     "mcp_list_tools",
@@ -337,6 +340,15 @@ export function buildRunEnvelope(result, agentRef, chatUrl = DEFAULT_CHAT_URL) {
         pendingToolCalls,
         pendingConnections,
         pendingInputs,
+        components: output
+            .filter((i) => i.type === "backbone:ui")
+            .map((i) => ({
+            id: String(i.id),
+            callId: String(i.call_id),
+            component: String(i.component),
+            schemaVersion: Number(i.schema_version),
+            props: i.props ?? null,
+        })),
         incompleteReason: result?.incomplete_details?.reason ?? null,
         usage: result?.usage
             ? { inputTokens: result.usage.input_tokens ?? 0, outputTokens: result.usage.output_tokens ?? 0 }
@@ -351,11 +363,64 @@ const INPUT_MODE_WORDS = {
     mixed: "form and link",
     unknown: "question",
 };
+/** The `schema_version` of `backbone:ui` this build prints (#1419 D8). */
+const UI_SCHEMA_VERSION = 1;
+/** A cell as plain text: empty for null, a percent fraction as `25%`, a currency amount with its code. */
+function cellText(value, column = {}) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "number" && column.format === "percent")
+        return `${Number((value * 100).toPrecision(12))}%`;
+    if (typeof value === "number" && column.format === "currency")
+        return `${value} ${String(column.currency ?? "")}`.trimEnd();
+    return stripControl(String(value));
+}
+function plainTable(head, colAligns) {
+    return new Table({
+        head: head.map((h) => stripControl(h)),
+        colAligns,
+        style: { head: [], border: [] },
+        // No rule between rows: a table may have 200.
+        chars: { mid: "", "left-mid": "", "mid-mid": "", "right-mid": "" },
+    });
+}
+/**
+ * A shown table as aligned columns under its title, a chart as its data table: labels down, one column per
+ * series. Null for an unknown component, a newer schema version or props of another shape.
+ */
+function componentTable(c) {
+    const p = (c.props ?? {});
+    if (c.schemaVersion > UI_SCHEMA_VERSION)
+        return null;
+    if (c.component === "table" && Array.isArray(p.columns) && Array.isArray(p.rows)) {
+        const columns = p.columns;
+        const table = plainTable(columns.map((col) => String(col.label)), columns.map((col) => (col.align === "right" ? "right" : "left")));
+        for (const row of p.rows)
+            table.push(columns.map((col) => cellText(row?.[col.key], col)));
+        return { title: String(p.title ?? "Table"), table };
+    }
+    if (c.component === "chart" && Array.isArray(p.labels) && Array.isArray(p.series)) {
+        const series = p.series;
+        const table = plainTable(["", ...series.map((x) => String(x.name))], ["left", ...series.map(() => "right")]);
+        p.labels.forEach((label, i) => table.push([cellText(label), ...series.map((x) => cellText(Array.isArray(x.values) ? x.values[i] : null))]));
+        return { title: `${String(p.title ?? "Chart")}${p.unit ? ` (${String(p.unit)})` : ""}`, table };
+    }
+    return null;
+}
 /** Human-readable rendering of an envelope on stdout. Every value printed is passed through {@link stripControl}. */
 export function printRunText(env) {
     const s = stripControl;
     if (env.text)
         console.log(s(env.text));
+    for (const component of env.components) {
+        const shown = componentTable(component);
+        if (!shown) {
+            console.log(chalk.dim("\nThis content needs a newer version of the CLI."));
+            continue;
+        }
+        console.log(chalk.bold(`\n${s(shown.title)}`));
+        console.log(shown.table.toString());
+    }
     const head = [
         env.agent ? `${env.agent}${env.version !== null ? `@${env.version}` : ""}` : null,
         env.responseId,

package/dist/lib/skill-bundle.js

@@ -2,11 +2,12 @@ import { mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import { unzipSync, zipSync } from "fflate";
 /**
- * The importer takes SKILL.md plus these three directories and reports anything else as
+ * The importer takes SKILL.md plus these four directories and reports anything else as
  * `unsupported-path` (spec §4). Packing only these keeps a stray .git or node_modules out of
- * the upload instead of spending the 20 MB bundle cap on it.
+ * the upload instead of spending the 20 MB bundle cap on it. `examples/` holds confidential
+ * files (#926): imported like the rest, left out of a plain export.
  */
-const RESOURCE_DIRS = ["references", "assets", "scripts"];
+const RESOURCE_DIRS = ["references", "assets", "scripts", "examples"];
 function byName(left, right) {
     return left.name < right.name ? -1 : left.name > right.name ? 1 : 0;
 }

package/package.json

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