@manfred-kunze-dev/backbone-cli 2.6.0-dev.4

package/dist/commands/extractions.js

@@ -0,0 +1,143 @@
+import { Command } from "commander";
+import { readFileSync } from "node:fs";
+import { extname } from "node:path";
+import { getClient, runAction } from "../lib/client.js";
+import { requireProjectId } from "../lib/context.js";
+import { formatPage, formatDetail, withSpinner } from "../lib/output.js";
+import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+const IMAGE_MIME_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".bmp": "image/bmp",
+    ".tiff": "image/tiff",
+};
+function readImages(paths) {
+    return paths.map((p) => {
+        const buffer = readFileSync(p);
+        const ext = extname(p).toLowerCase();
+        const mimeType = IMAGE_MIME_TYPES[ext] ?? "image/png";
+        return { data: buffer.toString("base64"), mimeType };
+    });
+}
+export function makeExtractionsCommand() {
+    const cmd = new Command("extractions").description("Manage extractions");
+    cmd
+        .command("create")
+        .description("Create a new extraction")
+        .requiredOption("--schema <id>", "Schema ID")
+        .requiredOption("-m, --model <model>", "Model to use (provider/model)")
+        .option("-t, --text <text>", "Input text")
+        .option("-f, --file <path>", "Read input text from file")
+        .option("--images <paths...>", "Image file paths")
+        .option("--version-id <id>", "Schema version ID")
+        .option("-l, --label <name>", "Schema label")
+        .option("--async", "Run asynchronously")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            let text = opts.text;
+            if (opts.file) {
+                text = readFileSync(opts.file, "utf-8");
+            }
+            const images = opts.images ? readImages(opts.images) : undefined;
+            const body = {
+                schemaId: opts.schema,
+                schemaVersionId: opts.versionId,
+                model: opts.model,
+                inputText: text,
+                inputImages: images,
+            };
+            if (opts.async) {
+                const { data } = await withSpinner("Extracting...", () => client.POST("/v1/projects/{projectId}/extractions/async", {
+                    params: { path: { projectId } },
+                    body,
+                }));
+                formatDetail(data, command);
+            }
+            else {
+                const { data } = await withSpinner("Extracting...", () => client.POST("/v1/projects/{projectId}/extractions", {
+                    params: { path: { projectId } },
+                    body,
+                }));
+                formatDetail(data, command);
+            }
+        });
+    });
+    cmd
+        .command("get")
+        .description("Get an extraction by ID")
+        .argument("<id>", "Extraction ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects/{projectId}/extractions/{id}", { params: { path: { projectId, id } } });
+            formatDetail(data, command);
+        });
+    });
+    const list = new Command("list").description("List extractions");
+    addPaginationOptions(list);
+    list.option("-s, --search <term>", "Search text");
+    list.option("--schema-version <id>", "Filter by schema version ID");
+    list.option("--status <status>", "Filter by status (PENDING|PROCESSING|COMPLETED|FAILED)");
+    list.action(async (opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects/{projectId}/extractions", {
+                params: {
+                    path: { projectId },
+                    query: {
+                        search: opts.search,
+                        schemaVersionId: opts.schemaVersion,
+                        status: opts.status,
+                        ...paginationParams(opts),
+                    },
+                },
+            });
+            formatPage(data, command, ["id", "schemaId", "model", "status", "totalTokens", "createdAt"]);
+        });
+    });
+    cmd.addCommand(list);
+    cmd
+        .command("estimate")
+        .description("Estimate token usage for an extraction")
+        .requiredOption("--schema <id>", "Schema ID")
+        .requiredOption("-m, --model <model>", "Model to use")
+        .option("-t, --text <text>", "Input text")
+        .option("--version-id <id>", "Schema version ID")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/projects/{projectId}/extractions/estimate", {
+                body: {
+                    schemaId: opts.schema,
+                    schemaVersionId: opts.versionId,
+                    inputText: opts.text,
+                },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("rerun")
+        .description("Re-run an extraction")
+        .argument("<id>", "Extraction ID to rerun")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await withSpinner("Re-running extraction...", () => client.POST("/v1/projects/{projectId}/extractions/{id}/rerun", {
+                params: { path: { projectId, id } },
+            }));
+            formatDetail(data, command);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=extractions.js.map

package/dist/commands/projects.d.ts

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

package/dist/commands/projects.js

@@ -0,0 +1,83 @@
+import { Command } from "commander";
+import { getClient, runAction } from "../lib/client.js";
+import { formatPage, formatDetail, formatSuccess } from "../lib/output.js";
+import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+export function makeProjectsCommand() {
+    const cmd = new Command("projects").description("Manage projects");
+    const list = new Command("list").description("List projects");
+    addPaginationOptions(list);
+    list.option("-s, --search <term>", "Filter by name");
+    list.action(async (opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects", {
+                params: { query: { search: opts.search, ...paginationParams(opts) } },
+            });
+            formatPage(data, command, ["id", "name", "description", "createdAt"]);
+        });
+    });
+    cmd.addCommand(list);
+    cmd
+        .command("get")
+        .description("Get a project by ID")
+        .argument("<id>", "Project ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects/{id}", {
+                params: { path: { id } },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("create")
+        .description("Create a new project")
+        .requiredOption("-n, --name <name>", "Project name")
+        .option("-d, --description <text>", "Project description")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/projects", {
+                body: { name: opts.name, description: opts.description },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("update")
+        .description("Update a project")
+        .argument("<id>", "Project ID")
+        .option("-n, --name <name>", "New name")
+        .option("-d, --description <text>", "New description")
+        .action(async (id, opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            const body = {};
+            if (opts.name)
+                body.name = opts.name;
+            if (opts.description !== undefined)
+                body.description = opts.description;
+            const { data } = await client.PUT("/v1/projects/{id}", {
+                params: { path: { id } },
+                body: body,
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("delete")
+        .description("Delete a project")
+        .argument("<id>", "Project ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const client = getClient(command);
+            await client.DELETE("/v1/projects/{id}", {
+                params: { path: { id } },
+            });
+            formatSuccess(`Project ${id} deleted.`, command);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=projects.js.map

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

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

package/dist/commands/prompt-labels.js

@@ -0,0 +1,72 @@
+import { Command } from "commander";
+import { getClient, runAction } from "../lib/client.js";
+import { requireProjectId } from "../lib/context.js";
+import { formatList, formatDetail, formatSuccess } from "../lib/output.js";
+export function makePromptLabelsCommand() {
+    const cmd = new Command("labels").description("Manage prompt labels");
+    cmd
+        .command("list")
+        .description("List labels for a prompt")
+        .requiredOption("--prompt <id>", "Prompt ID")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects/{projectId}/prompts/{promptId}/labels", { params: { path: { projectId, promptId: opts.prompt } } });
+            formatList(data, command, [
+                "name",
+                "promptVersionId",
+                "createdAt",
+            ]);
+        });
+    });
+    cmd
+        .command("create")
+        .description("Create a label for a prompt version")
+        .requiredOption("--prompt <id>", "Prompt ID")
+        .requiredOption("-n, --name <name>", "Label name")
+        .requiredOption("--version-id <id>", "Prompt version ID to label")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/projects/{projectId}/prompts/{promptId}/labels", {
+                params: { path: { projectId, promptId: opts.prompt } },
+                body: { name: opts.name, promptVersionId: opts.versionId },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("update")
+        .description("Update a label to point to a different version")
+        .argument("<labelName>", "Label name")
+        .requiredOption("--prompt <id>", "Prompt ID")
+        .requiredOption("--version-id <id>", "New prompt version ID")
+        .action(async (labelName, opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.PUT("/v1/projects/{projectId}/prompts/{promptId}/labels/{labelName}", {
+                params: { path: { projectId, promptId: opts.prompt, labelName } },
+                body: { promptVersionId: opts.versionId },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("delete")
+        .description("Delete a prompt label")
+        .argument("<labelName>", "Label name")
+        .requiredOption("--prompt <id>", "Prompt ID")
+        .action(async (labelName, opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            await client.DELETE("/v1/projects/{projectId}/prompts/{promptId}/labels/{labelName}", { params: { path: { projectId, promptId: opts.prompt, labelName } } });
+            formatSuccess(`Label "${labelName}" deleted.`, command);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=prompt-labels.js.map

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

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

package/dist/commands/prompt-versions.js

@@ -0,0 +1,70 @@
+import { Command } from "commander";
+import { getClient, runAction } from "../lib/client.js";
+import { requireProjectId } from "../lib/context.js";
+import { formatPage, formatDetail } from "../lib/output.js";
+import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+export function makePromptVersionsCommand() {
+    const cmd = new Command("versions").description("Manage prompt versions");
+    const list = new Command("list").description("List versions of a prompt");
+    addPaginationOptions(list);
+    list.requiredOption("--prompt <id>", "Prompt ID");
+    list.action(async (opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects/{projectId}/prompts/{promptId}/versions", {
+                params: {
+                    path: { projectId, promptId: opts.prompt },
+                    query: paginationParams(opts),
+                },
+            });
+            formatPage(data, command, ["id", "version", "active", "changeDescription", "createdAt"]);
+        });
+    });
+    cmd.addCommand(list);
+    cmd
+        .command("get")
+        .description("Get a specific prompt version")
+        .argument("<versionId>", "Version ID")
+        .requiredOption("--prompt <id>", "Prompt ID")
+        .action(async (versionId, opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects/{projectId}/prompts/{promptId}/versions/{versionId}", { params: { path: { projectId, promptId: opts.prompt, versionId } } });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("create")
+        .description("Create a new prompt version")
+        .requiredOption("--prompt <id>", "Prompt ID")
+        .requiredOption("-c, --content <text>", "Prompt content (template text)")
+        .option("-m, --message <text>", "Change description")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/projects/{projectId}/prompts/{promptId}/versions", {
+                params: { path: { projectId, promptId: opts.prompt } },
+                body: { content: opts.content, changeDescription: opts.message },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("activate")
+        .description("Activate a prompt version")
+        .argument("<versionId>", "Version ID")
+        .requiredOption("--prompt <id>", "Prompt ID")
+        .action(async (versionId, opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.PUT("/v1/projects/{projectId}/prompts/{promptId}/versions/{versionId}/activate", { params: { path: { projectId, promptId: opts.prompt, versionId } } });
+            formatDetail(data, command);
+        });
+    });
+    return cmd;
+}
+//# sourceMappingURL=prompt-versions.js.map

package/dist/commands/prompts.d.ts

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

package/dist/commands/prompts.js

@@ -0,0 +1,170 @@
+import { Command } from "commander";
+import { getClient, runAction } from "../lib/client.js";
+import { requireProjectId } from "../lib/context.js";
+import { formatPage, formatDetail, formatSuccess } from "../lib/output.js";
+import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
+import { makePromptVersionsCommand } from "./prompt-versions.js";
+import { makePromptLabelsCommand } from "./prompt-labels.js";
+export function makePromptsCommand() {
+    const cmd = new Command("prompts").description("Manage prompts");
+    const list = new Command("list").description("List prompts");
+    addPaginationOptions(list);
+    list.option("-s, --search <term>", "Filter by name");
+    list.option("--type <type>", "Filter by type");
+    list.action(async (opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects/{projectId}/prompts", {
+                params: {
+                    path: { projectId },
+                    query: { search: opts.search, type: opts.type, ...paginationParams(opts) },
+                },
+            });
+            formatPage(data, command, ["id", "name", "type", "description", "activeVersionId", "createdAt"]);
+        });
+    });
+    cmd.addCommand(list);
+    cmd
+        .command("get")
+        .description("Get a prompt by ID")
+        .argument("<id>", "Prompt ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects/{projectId}/prompts/{id}", {
+                params: { path: { projectId, id } },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("create")
+        .description("Create a new prompt")
+        .requiredOption("-n, --name <name>", "Prompt name")
+        .option("-d, --description <text>", "Prompt description")
+        .option("--type <type>", "Prompt type")
+        .action(async (opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.POST("/v1/projects/{projectId}/prompts", {
+                params: { path: { projectId } },
+                body: { name: opts.name, description: opts.description, type: opts.type },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("update")
+        .description("Update a prompt")
+        .argument("<id>", "Prompt ID")
+        .option("-n, --name <name>", "New name")
+        .option("-d, --description <text>", "New description")
+        .option("--type <type>", "New type")
+        .action(async (id, opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const body = {};
+            if (opts.name)
+                body.name = opts.name;
+            if (opts.description !== undefined)
+                body.description = opts.description;
+            if (opts.type !== undefined)
+                body.type = opts.type;
+            const { data } = await client.PUT("/v1/projects/{projectId}/prompts/{id}", {
+                params: { path: { projectId, id } },
+                body: body,
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("delete")
+        .description("Delete a prompt")
+        .argument("<id>", "Prompt ID")
+        .action(async (id, _opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            await client.DELETE("/v1/projects/{projectId}/prompts/{id}", {
+                params: { path: { projectId, id } },
+            });
+            formatSuccess(`Prompt ${id} deleted.`, command);
+        });
+    });
+    cmd
+        .command("resolve")
+        .description("Resolve prompt content (latest or by label)")
+        .argument("<promptId>", "Prompt ID")
+        .option("-l, --label <name>", "Label to resolve")
+        .action(async (promptId, opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const { data } = await client.GET("/v1/projects/{projectId}/prompts/{promptId}/resolve", {
+                params: {
+                    path: { projectId, promptId },
+                    query: { label: opts.label },
+                },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("compile")
+        .description("Compile a prompt with variable substitution")
+        .argument("<promptId>", "Prompt ID")
+        .option("--vars <json>", "Variables as JSON object")
+        .option("--version-id <id>", "Specific version ID")
+        .option("-l, --label <name>", "Label to use")
+        .action(async (promptId, opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const variables = opts.vars ? JSON.parse(opts.vars) : undefined;
+            const { data } = await client.POST("/v1/projects/{projectId}/prompts/{promptId}/compile", {
+                params: { path: { projectId, promptId } },
+                body: {
+                    variables,
+                    versionId: opts.versionId,
+                    label: opts.label,
+                },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd
+        .command("test")
+        .description("Test a prompt with an LLM")
+        .argument("<promptId>", "Prompt ID")
+        .requiredOption("-m, --model <model>", "Model to use (provider/model)")
+        .option("-t, --text <text>", "Input text")
+        .option("--vars <json>", "Variables as JSON object")
+        .option("--version-id <id>", "Specific version ID")
+        .option("-l, --label <name>", "Label to use")
+        .action(async (promptId, opts, command) => {
+        await runAction(command, async () => {
+            const projectId = requireProjectId(command);
+            const client = getClient(command);
+            const variables = opts.vars ? JSON.parse(opts.vars) : undefined;
+            const { data } = await client.POST("/v1/projects/{projectId}/prompts/{promptId}/test", {
+                params: { path: { projectId, promptId } },
+                body: {
+                    model: opts.model,
+                    content: opts.text,
+                    variables,
+                    versionId: opts.versionId,
+                    label: opts.label,
+                },
+            });
+            formatDetail(data, command);
+        });
+    });
+    cmd.addCommand(makePromptVersionsCommand());
+    cmd.addCommand(makePromptLabelsCommand());
+    return cmd;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/commands/providers.d.ts

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