@openbkn/bkn-sdk 0.1.1-alpha.12 → 0.1.1-alpha.14

package/dist/cli.js

@@ -37,7 +37,7 @@ import {
   use,
   whoami,
   writePlatformConfig
-} from "./chunk-3FVB6VFQ.js";
+} from "./chunk-2GNQU4XH.js";
 
 // src/cli.ts
 import { Command as Command17 } from "commander";
@@ -45,7 +45,7 @@ import { Command as Command17 } from "commander";
 // package.json
 var package_default = {
   name: "@openbkn/bkn-sdk",
-  version: "0.1.1-alpha.12",
+  version: "0.1.1-alpha.14",
   description: "Unified TypeScript SDK + CLI for the BKN (Business Knowledge Network) platform.",
   type: "module",
   license: "Apache-2.0",
@@ -973,7 +973,14 @@ function adminCommand() {
 import { Command as Command3 } from "commander";
 var int2 = (v) => Number.parseInt(v, 10);
 function agentCommand() {
-  const cmd = new Command3("agent").description("Agent CRUD, chat, sessions, publish");
+  const cmd = new Command3("agent").description(
+    "[DEPRECATED] Decision Agent \u2014 CRUD, chat, sessions, publish (being phased out)"
+  );
+  cmd.hook("preAction", () => {
+    process.stderr.write(
+      "\u26A0\uFE0F  `openbkn agent` is deprecated and may be removed in a future release.\n"
+    );
+  });
   cmd.command("list").description("List published agents").option("--name <s>", "filter by name").option("--limit <n>", "page size", int2, DEFAULT_LIST_LIMIT).option("--offset <n>", "page offset", int2, 0).option("--category-id <id>", "filter by category").action(async (opts, cmd2) => {
     const data = await clientFrom(cmd2).agents.list({
       name: opts.name,
@@ -1976,6 +1983,12 @@ async function handle(client, reqMsg, res) {
 // src/commands/model.ts
 import { Command as Command11 } from "commander";
 var int8 = (v) => Number.parseInt(v, 10);
+async function resolveLlmModelName(client, model) {
+  if (!/^\d+$/.test(model)) return model;
+  const detail = await client.models.llm.get(model);
+  if (!detail?.model_name) throw new InputError(`No LLM found with id ${model}.`);
+  return detail.model_name;
+}
 function addManagementCommands(parent, kind) {
   parent.command("add").description("Register a model (definition JSON via --body / --body-file)").option("--body <json>", "model definition JSON").option("--body-file <path>", "read model definition JSON from a file").action(async (opts, cmd) => {
     printJson(await clientFrom(cmd).models[kind].add(readBody(opts)), outputOptions(cmd));
@@ -1991,7 +2004,9 @@ function addManagementCommands(parent, kind) {
   });
 }
 function modelCommand() {
-  const model = new Command11("model").description("Model factory \u2014 LLM / small-model CRUD + chat");
+  const model = new Command11("model").description(
+    "Model factory \u2014 LLM / small-model CRUD, chat / embeddings / rerank, default selection"
+  );
   const llm = model.command("llm").description("Large language models");
   llm.command("list").description("List LLM models").option("--name <s>", "filter by name").option("--type <t>", "model type filter").option("--limit <n>", "page size", int8, DEFAULT_LIST_LIMIT).option("--page <n>", "page", int8, 1).action(async (opts, cmd) => {
     printJson(
@@ -2007,14 +2022,22 @@ function modelCommand() {
   llm.command("get <modelId>").description("Get an LLM model").action(async (id, _opts, cmd) => {
     printJson(await clientFrom(cmd).models.llm.get(id), outputOptions(cmd));
   });
-  llm.command("chat <modelId>").description("OpenAI-compatible chat completion").requiredOption("-m, --message <text>", "user message").option("--stream", "stream the reply token-by-token to stdout").action(async (id, opts, cmd) => {
+  llm.command("chat <model>").description("OpenAI-compatible chat completion (<model> = model name or numeric id)").requiredOption("-m, --message <text>", "user message").option("--stream", "stream the reply token-by-token to stdout").action(async (model2, opts, cmd) => {
+    const client = clientFrom(cmd);
+    const name = await resolveLlmModelName(client, model2);
     const messages = [{ role: "user", content: opts.message }];
     if (opts.stream) {
-      await clientFrom(cmd).models.llm.chatStream(id, messages, (t) => process.stdout.write(t));
+      await client.models.llm.chatStream(name, messages, (t) => process.stdout.write(t));
       process.stdout.write("\n");
       return;
     }
-    printJson(await clientFrom(cmd).models.llm.chat(id, messages), outputOptions(cmd));
+    printJson(await client.models.llm.chat(name, messages), outputOptions(cmd));
+  });
+  llm.command("set-default <modelId>").description("Set this LLM as the system default (admin)").action(async (id, _opts, cmd) => {
+    printJson(await clientFrom(cmd).models.llm.setDefault(id, true), outputOptions(cmd));
+  });
+  llm.command("unset-default <modelId>").description("Clear this LLM as the system default (admin)").action(async (id, _opts, cmd) => {
+    printJson(await clientFrom(cmd).models.llm.setDefault(id, false), outputOptions(cmd));
   });
   addManagementCommands(llm, "llm");
   const small = model.command("small").description("Small models (embedding / reranker)");
@@ -2044,7 +2067,31 @@ function modelCommand() {
       outputOptions(cmd)
     );
   });
+  small.command("get-default").description("Show the system default small model for a type").option("--type <t>", "model type: embedding | reranker", "embedding").action(async (opts, cmd) => {
+    printJson(await clientFrom(cmd).models.small.getDefault(opts.type), outputOptions(cmd));
+  });
+  small.command("set-default <modelId>").description("Set this small model as the system default for its type (admin)").action(async (id, _opts, cmd) => {
+    printJson(await clientFrom(cmd).models.small.setDefault(id, true), outputOptions(cmd));
+  });
+  small.command("unset-default <modelId>").description("Clear this small model as the system default (admin)").action(async (id, _opts, cmd) => {
+    printJson(await clientFrom(cmd).models.small.setDefault(id, false), outputOptions(cmd));
+  });
   addManagementCommands(small, "small");
+  model.addHelpText(
+    "after",
+    `
+Identifiers:
+  \u2022 get / set-default / delete take the numeric model id (e.g. 2071747547839467520).
+  \u2022 chat takes a model NAME, but also accepts a numeric id (resolved to its name).
+
+Examples:
+  $ openbkn model llm list                          # ids + the 'default' flag
+  $ openbkn model llm chat deepseek_v4_flash -m hi  # by name
+  $ openbkn model llm chat 2071747547839467520 -m hi --stream   # by id, streamed
+  $ openbkn model llm set-default 2071747547839467520           # system default LLM
+  $ openbkn model small get-default --type embedding            # current default
+  $ openbkn model small set-default <id>                        # default embedding/reranker`
+  );
   return group(model, "MODELS & SKILLS");
 }