@2kw/ai 6.1.0 → 6.2.0-dev.13

package/dist/commands/conversations.js

@@ -20,6 +20,29 @@ export function makeConversationsCommand() {
             formatDetail(data, command);
         });
     });
+    cmd
+        .command("list")
+        .description("List conversations, most recently active first")
+        .option("--agent-id <id>", "Only conversations bound to this agent")
+        .option("--scope <scope>", "mine (default) or org; org needs MEMBER or above", "mine")
+        .option("--page <n>", "Page number, starting at 0", "0")
+        .option("--size <n>", "Page size, 1 to 100", "30")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/conversations", {
+                params: {
+                    query: {
+                        agent_id: opts.agentId,
+                        scope: opts.scope,
+                        page: Number(opts.page),
+                        size: Number(opts.size),
+                    },
+                },
+            });
+            formatDetail(data, command);
+        });
+    });
     cmd
         .command("get")
         .description("Retrieve a conversation by id")

package/dist/commands/plugins.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+/** Install, sync and detach Claude Code plugins (#640). */
+export declare function makePluginsCommand(): Command;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/commands/plugins.js

@@ -0,0 +1,88 @@
+import { Command, Option } from "commander";
+import { getClient, runAction } from "../lib/client.js";
+import { formatPage, formatDetail, formatSuccess } from "../lib/output.js";
+import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+const REF_POLICY_HELP = "track:<branch-or-tag> to follow it, pin:<sha> to freeze";
+/** Install, sync and detach Claude Code plugins (#640). */
+export function makePluginsCommand() {
+    const cmd = new Command("plugins").description("Manage Claude Code plugins imported from git");
+    const list = new Command("list").description("List installed plugins");
+    addPaginationOptions(list);
+    list.addOption(new Option("--status <status>", "Filter by status").choices(["ACTIVE", "DISABLED"]));
+    list.action(async (opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/plugins", {
+                params: { query: { status: opts.status, ...paginationParams(opts) } },
+            });
+            formatPage(data, command, ["id", "name", "gitUrl", "refPolicy", "status", "lastSyncedSha"]);
+        });
+    });
+    cmd.addCommand(list);
+    cmd
+        .command("get")
+        .description("Get an installed plugin, including its last sync report")
+        .argument("<id>", "Plugin ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/plugins/{id}", { params: { path: { id } } });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("install")
+        .description("Install a plugin from a git repository and run its first sync (admin)")
+        .argument("<git-url>", "https remote of a repository in Claude Code plugin layout")
+        .option("-n, --name <name>", "Org-local name (default: the manifest name, slugified)")
+        .option("--ref-policy <policy>", REF_POLICY_HELP)
+        .action(async (gitUrl, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/plugins", {
+                body: { gitUrl, name: opts.name, refPolicy: opts.refPolicy },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("update")
+        .description("Change a plugin's ref policy or status (admin)")
+        .argument("<id>", "Plugin ID")
+        .option("--ref-policy <policy>", REF_POLICY_HELP)
+        .addOption(new Option("--status <status>", "ACTIVE or DISABLED").choices(["ACTIVE", "DISABLED"]))
+        .action(async (id, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.PATCH("/v1/plugins/{id}", {
+                params: { path: { id } },
+                body: { refPolicy: opts.refPolicy, status: opts.status },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("sync")
+        .description("Sync a plugin now; unchanged is a no-op (admin)")
+        .argument("<id>", "Plugin ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/plugins/{id}/sync", { params: { path: { id } } });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("delete")
+        .description("Detach a plugin; imported skills stay (admin)")
+        .argument("<id>", "Plugin ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            await client.DELETE("/v1/plugins/{id}", { params: { path: { id } } });
+            formatSuccess(`Plugin ${id} detached`, command);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=plugins.js.map

package/dist/commands/skill-labels.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+/** Manage skill labels (#642). */
+export declare function makeSkillLabelsCommand(): Command;
+//# sourceMappingURL=skill-labels.d.ts.map

package/dist/commands/skill-labels.js

@@ -0,0 +1,64 @@
+import { Command } from "commander";
+import { getClient, runAction } from "../lib/client.js";
+import { formatList, formatDetail, formatSuccess } from "../lib/output.js";
+/** Manage skill labels (#642). */
+export function makeSkillLabelsCommand() {
+    const cmd = new Command("labels").description("Manage skill labels");
+    cmd
+        .command("list")
+        .description("List labels for a skill")
+        .argument("<id>", "Skill ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/skills/{id}/labels", { params: { path: { id } } });
+            formatList(data, command, ["name", "skillVersionId", "versionNumber"]);
+        });
+    });
+    cmd
+        .command("create")
+        .description("Create a label for a skill version")
+        .argument("<id>", "Skill ID")
+        .argument("<name>", "Label name")
+        .requiredOption("--version-id <id>", "Skill version ID to label")
+        .action(async (id, name, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/skills/{id}/labels", {
+                params: { path: { id } },
+                body: { name, skillVersionId: opts.versionId },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("update")
+        .description("Update a label to point to a different version")
+        .argument("<id>", "Skill ID")
+        .argument("<name>", "Label name")
+        .requiredOption("--version-id <id>", "New skill version ID")
+        .action(async (id, name, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.PUT("/v1/skills/{id}/labels/{name}", {
+                params: { path: { id, name } },
+                body: { skillVersionId: opts.versionId },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("delete")
+        .description("Delete a skill label")
+        .argument("<id>", "Skill ID")
+        .argument("<name>", "Label name")
+        .action(async (id, name, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            await client.DELETE("/v1/skills/{id}/labels/{name}", { params: { path: { id, name } } });
+            formatSuccess(`Label "${name}" deleted.`, command);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=skill-labels.js.map

package/dist/commands/skill-versions.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+/** Manage skill versions (#642). */
+export declare function makeSkillVersionsCommand(): Command;
+//# sourceMappingURL=skill-versions.d.ts.map

package/dist/commands/skill-versions.js

@@ -0,0 +1,53 @@
+import { Command } from "commander";
+import { readFileSync } from "node:fs";
+import { getClient, runAction } from "../lib/client.js";
+import { formatPage, formatDetail } from "../lib/output.js";
+import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+/** Manage skill versions (#642). */
+export function makeSkillVersionsCommand() {
+    const cmd = new Command("versions").description("Manage skill versions");
+    const list = new Command("list").description("List versions of a skill").argument("<id>", "Skill ID");
+    addPaginationOptions(list);
+    list.action(async (id, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/skills/{id}/versions", {
+                params: { path: { id }, query: paginationParams(opts) },
+            });
+            formatPage(data, command, ["id", "versionNumber", "description", "contentHash"]);
+        });
+    });
+    cmd.addCommand(list);
+    cmd
+        .command("get")
+        .description("Get a specific skill version")
+        .argument("<id>", "Skill ID")
+        .argument("<versionNumber>", "Version number")
+        .action(async (id, versionNumber, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/skills/{id}/versions/{versionNumber}", {
+                params: { path: { id, versionNumber: Number(versionNumber) } },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("create")
+        .description("Create a skill version from a markdown body file")
+        .argument("<id>", "Skill ID")
+        .requiredOption("--description <text>", "Version description")
+        .requiredOption("--body-file <path>", "Markdown body file")
+        .action(async (id, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/skills/{id}/versions", {
+                params: { path: { id } },
+                body: { description: opts.description, body: readFileSync(opts.bodyFile, "utf-8") },
+            });
+            formatDetail(data, command);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=skill-versions.js.map

package/dist/commands/skills.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+/** Manage skills, versions and labels (#642). */
+export declare function makeSkillsCommand(): Command;
+//# sourceMappingURL=skills.d.ts.map

package/dist/commands/skills.js

@@ -0,0 +1,161 @@
+import { Command, Option } from "commander";
+import { statSync, writeFileSync } from "node:fs";
+import { basename, extname } from "node:path";
+import { getClient, resolveAuthHeader, runAction } from "../lib/client.js";
+import { resolveConfig } from "../lib/config.js";
+import { BackboneApiError } from "../lib/errors.js";
+import { fileToBlob } from "../lib/multipart.js";
+import { formatPage, formatDetail, formatSuccess, withSpinner } from "../lib/output.js";
+import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+import { makeSkillVersionsCommand } from "./skill-versions.js";
+import { makeSkillLabelsCommand } from "./skill-labels.js";
+async function checkResponse(res) {
+    if (res.ok)
+        return;
+    const body = await res.json().catch(() => ({}));
+    throw new BackboneApiError({
+        status: body.status ?? res.status,
+        error: body.title ?? body.error ?? res.statusText,
+        message: body.detail ?? body.message ?? `HTTP ${res.status}: ${res.statusText}`,
+        timestamp: body.timestamp ?? new Date().toISOString(),
+    });
+}
+/** Manage skills, versions and labels (#642). */
+export function makeSkillsCommand() {
+    const cmd = new Command("skills").description("Manage skills");
+    const list = new Command("list").description("List skills");
+    addPaginationOptions(list);
+    list.option("-s, --search <term>", "Filter by name");
+    list.addOption(new Option("--status <status>", "Filter by status").choices(["ACTIVE", "ARCHIVED"]));
+    list.action(async (opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/skills", {
+                params: { query: { search: opts.search, status: opts.status, ...paginationParams(opts) } },
+            });
+            formatPage(data, command, ["id", "name", "status", "latestVersionNumber"]);
+        });
+    });
+    cmd.addCommand(list);
+    cmd
+        .command("get")
+        .description("Get a skill by ID")
+        .argument("<id>", "Skill ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/skills/{id}", { params: { path: { id } } });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("create")
+        .description("Create a skill (add content with versions create or import)")
+        .argument("<name>", "Skill name")
+        .action(async (name, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/skills", { body: { name } });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("update")
+        .description("Update a skill's status")
+        .argument("<id>", "Skill ID")
+        .addOption(new Option("--status <status>", "New status").choices(["ACTIVE", "ARCHIVED"]).makeOptionMandatory())
+        .action(async (id, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.PUT("/v1/skills/{id}", {
+                params: { path: { id } },
+                body: { status: opts.status },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("delete")
+        .description("Delete a skill")
+        .argument("<id>", "Skill ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            await client.DELETE("/v1/skills/{id}", { params: { path: { id } } });
+            formatSuccess(`Skill ${id} deleted.`, command);
+        });
+    });
+    cmd
+        .command("resolve")
+        .description("Resolve a skill by name, name@label or name@version")
+        .argument("<ref>", "Skill reference")
+        .action(async (ref, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/skills/resolve", { params: { query: { ref } } });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("import")
+        .description("Import a local SKILL.md or zip archive")
+        .argument("<path>", "Local SKILL.md or .zip file")
+        .action(async (path, _opts, command) => {
+        await runAction(command, async () => {
+            if (statSync(path).isDirectory())
+                throw new Error("Cannot import a directory; zip it first.");
+            if (basename(path) !== "SKILL.md" && extname(path).toLowerCase() !== ".zip") {
+                throw new Error("Import requires a SKILL.md or .zip file.");
+            }
+            const config = resolveConfig(command);
+            const authHeader = await resolveAuthHeader(config);
+            const { blob, filename } = fileToBlob(path);
+            const formData = new FormData();
+            formData.append("file", blob, filename);
+            const data = await withSpinner("Importing skill...", async () => {
+                const res = await fetch(`${config.baseUrl.replace(/\/+$/, "")}/v1/skills/import`, {
+                    method: "POST",
+                    headers: { Authorization: authHeader },
+                    body: formData,
+                });
+                await checkResponse(res);
+                return res.json();
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("export")
+        .description("Export a skill version as a zip archive")
+        .argument("<id>", "Skill ID")
+        .argument("<versionNumber>", "Version number")
+        .option("-o, --output <file>", "Output path (default: <skill-name>-v<n>.zip)")
+        .action(async (id, versionNumber, opts, command) => {
+        await runAction(command, async () => {
+            let outputPath = opts.output;
+            if (!outputPath) {
+                const client = getClient(command);
+                const { data } = await client.GET("/v1/skills/{id}", { params: { path: { id } } });
+                if (!data?.name)
+                    throw new Error("Skill name missing; specify an output path with -o.");
+                outputPath = `${basename(data.name)}-v${versionNumber}.zip`;
+            }
+            const config = resolveConfig(command);
+            const authHeader = await resolveAuthHeader(config);
+            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`, {
+                    headers: { Authorization: authHeader },
+                });
+                await checkResponse(res);
+                return Buffer.from(await res.arrayBuffer());
+            });
+            writeFileSync(outputPath, bytes);
+            formatSuccess(`Wrote ${bytes.length} bytes to ${outputPath}`, command);
+        });
+    });
+    cmd.addCommand(makeSkillVersionsCommand());
+    cmd.addCommand(makeSkillLabelsCommand());
+    return cmd;
+}
+//# sourceMappingURL=skills.js.map

package/dist/index.js

@@ -7,6 +7,8 @@ const pkg = require("../package.json");
 import { makeConfigCommand } from "./commands/config.js";
 import { makeSchemasCommand } from "./commands/schemas.js";
 import { makePromptsCommand } from "./commands/prompts.js";
+import { makeSkillsCommand } from "./commands/skills.js";
+import { makePluginsCommand } from "./commands/plugins.js";
 import { makeExtractionsCommand } from "./commands/extractions.js";
 import { makeConvertCommand } from "./commands/convert.js";
 import { makeAiCommand } from "./commands/ai.js";
@@ -43,6 +45,8 @@ program.addCommand(makeConfigCommand());
 program.addCommand(makeContextCommand());
 program.addCommand(makeSchemasCommand());
 program.addCommand(makePromptsCommand());
+program.addCommand(makeSkillsCommand());
+program.addCommand(makePluginsCommand());
 program.addCommand(makeExtractionsCommand());
 program.addCommand(makeConvertCommand());
 program.addCommand(makeAiCommand());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2kw/ai",
-  "version": "6.1.0",
+  "version": "6.2.0-dev.13",
   "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",
@@ -54,7 +54,7 @@
     "ora": "^8.2.0"
   },
   "devDependencies": {
-    "@types/node": "^22.19.17",
+    "@types/node": "^22.20.1",
     "openapi-typescript": "^7.13.0",
     "tsx": "^4.21.1",
     "typescript": "^5.9.3",