@kweaver-ai/kweaver-sdk 0.8.1 → 0.8.3

package/dist/commands/token.js

@@ -1,10 +1,21 @@
 import { ensureValidToken, formatHttpError } from "../auth/oauth.js";
+import { renderHelp } from "../help/format.js";
+const HELP = renderHelp({
+    tagline: "Print the current access token (auto-refresh first if needed)",
+    usage: "kweaver token",
+    inheritedFlags: "--base-url, --token, --user, --help",
+    examples: ["kweaver token", "kweaver --user alice token"],
+});
 export function parseTokenArgs(args) {
     if (args.length > 0) {
         throw new Error("Usage: kweaver token");
     }
 }
 export async function runTokenCommand(args) {
+    if (args[0] === "--help" || args[0] === "-h") {
+        console.log(HELP);
+        return 0;
+    }
     try {
         parseTokenArgs(args);
     }

package/dist/commands/tool.js

@@ -3,35 +3,52 @@ import { ensureValidToken, formatHttpError, with401RefreshRetry } from "../auth/
 import { debugTool, executeTool, listTools, setToolStatuses, uploadTool } from "../api/toolboxes.js";
 import { formatCallOutput } from "./call.js";
 import { resolveBusinessDomain } from "../config/store.js";
-const HELP = `kweaver tool
-
-Subcommands:
-  upload --toolbox <box-id> <openapi-spec-path> [--metadata-type openapi]
-                                              Upload an OpenAPI spec file as a tool
-  list --toolbox <box-id>                      List tools in a toolbox
-  enable --toolbox <box-id> <tool-id>...       Enable one or more tools
-  disable --toolbox <box-id> <tool-id>...      Disable one or more tools
-  execute --toolbox <box-id> <tool-id> [--body '<json>'|--body-file <path>]
-                                              [--header|--query|--path '<json>']
-                                              Invoke a published+enabled tool
-  debug   --toolbox <box-id> <tool-id> [--body '<json>'|--body-file <path>]
-                                              [--header|--query|--path '<json>']
-                                              Invoke a tool (works on draft/disabled too)
-
-Options for execute/debug:
-  --header '<json>'       Headers map forwarded to the downstream tool
-                          (Authorization is auto-injected from current session
-                          when --header omits it; pass {} to send none)
-  --query  '<json>'       Query params map forwarded to the downstream tool
-  --path   '<json>'       Path parameter map for OpenAPI path placeholders (e.g. {id})
-                          (JSON object: quote id and UUID, e.g. key id for get_dataview_detail /
-                          query_dataview_sql)
-  --timeout <seconds>     Per-call timeout (backend default applies when omitted)
-
-Common options:
-  -bd, --biz-domain <s>   Business domain (default: bd_public)
-  --pretty                Pretty-print JSON (default)
-  --compact               Single-line JSON (pipeline-friendly)`;
+import { renderHelp } from "../help/format.js";
+const HELP = renderHelp({
+    tagline: "Tools inside a toolbox — upload OpenAPI specs, enable/disable, execute",
+    usage: "kweaver tool <subcommand> --toolbox <box-id> [flags]",
+    sections: [
+        {
+            title: "AVAILABLE COMMANDS",
+            items: [
+                { name: "upload", desc: "Upload an OpenAPI spec file as a tool" },
+                { name: "list", desc: "List tools in a toolbox" },
+                { name: "enable", desc: "Enable one or more tools" },
+                { name: "disable", desc: "Disable one or more tools" },
+                { name: "execute", desc: "Invoke a published+enabled tool" },
+                { name: "debug", desc: "Invoke a tool (works on draft/disabled too)" },
+            ],
+        },
+    ],
+    flags: [
+        {
+            title: "Execute / debug",
+            flags: [
+                { name: "--body '<json>'", desc: "Request body" },
+                { name: "--body-file <path>", desc: "Request body from file" },
+                { name: "--header '<json>'", desc: "Headers map (Authorization auto-injected if omitted; pass {} to send none)" },
+                { name: "--query '<json>'", desc: "Query params map" },
+                { name: "--path '<json>'", desc: "Path params for OpenAPI placeholders, e.g. {\"id\":\"...\"}" },
+                { name: "--timeout <seconds>", desc: "Per-call timeout (backend default applies when omitted)" },
+            ],
+        },
+        {
+            title: "Common",
+            flags: [
+                { name: "-bd, --biz-domain <s>", desc: "Business domain (default: bd_public)" },
+                { name: "--pretty", desc: "Pretty-print JSON (default)" },
+                { name: "--compact", desc: "Single-line JSON (pipeline-friendly)" },
+            ],
+        },
+    ],
+    inheritedFlags: "--base-url, --token, --user, --help",
+    examples: [
+        "kweaver tool upload --toolbox <box-id> spec.yaml",
+        "kweaver tool list --toolbox <box-id>",
+        "kweaver tool execute --toolbox <box-id> <tool-id> --body '{\"key\":\"value\"}'",
+    ],
+    learnMore: ["Use `kweaver tool <subcommand> --help` for flag details"],
+});
 export async function runToolCommand(args) {
     const [subcommand, ...rest] = args;
     if (!subcommand || subcommand === "--help" || subcommand === "-h") {

package/dist/commands/toolbox.js

@@ -4,22 +4,38 @@ import { ensureValidToken, formatHttpError, with401RefreshRetry } from "../auth/
 import { createToolbox, deleteToolbox, exportConfig, importConfig, listToolboxes, setToolboxStatus, } from "../api/toolboxes.js";
 import { formatCallOutput } from "./call.js";
 import { resolveBusinessDomain } from "../config/store.js";
+import { renderHelp } from "../help/format.js";
 const VALID_IMPEX_TYPES = new Set(["toolbox", "mcp", "operator"]);
-const HELP = `kweaver toolbox
-
-Subcommands:
-  create --name <n> --service-url <url> [--description <d>]   Create a new toolbox
-  list [--keyword <s>] [--limit <n>] [--offset <n>]           List toolboxes
-  publish <box-id>                                            Publish a toolbox (status=published)
-  unpublish <box-id>                                          Unpublish (status=draft)
-  delete <box-id> [-y|--yes]                                  Delete a toolbox
-  export <box-id> [-o <file>|-] [--type toolbox|mcp|operator] Export toolbox config (.adp JSON)
-  import <file> [--type toolbox|mcp|operator]                 Import a previously exported config
-
-Options:
-  -bd, --biz-domain <s>   Business domain (default: bd_public)
-  --pretty                Pretty-print JSON (default)
-  --compact               Single-line JSON (pipeline-friendly)`;
+const HELP = renderHelp({
+    tagline: "Agent toolbox lifecycle — create, list, publish, delete, export/import",
+    usage: "kweaver toolbox <subcommand> [flags]",
+    sections: [
+        {
+            title: "AVAILABLE COMMANDS",
+            items: [
+                { name: "create", desc: "Create a new toolbox" },
+                { name: "list", desc: "List toolboxes" },
+                { name: "publish", desc: "Publish a toolbox (status=published)" },
+                { name: "unpublish", desc: "Unpublish (status=draft)" },
+                { name: "delete", desc: "Delete a toolbox" },
+                { name: "export", desc: "Export toolbox config (.adp JSON)" },
+                { name: "import", desc: "Import a previously exported config" },
+            ],
+        },
+    ],
+    flags: [
+        { name: "-bd, --biz-domain <s>", desc: "Business domain (default: bd_public)" },
+        { name: "--pretty", desc: "Pretty-print JSON (default)" },
+        { name: "--compact", desc: "Single-line JSON (pipeline-friendly)" },
+    ],
+    inheritedFlags: "--base-url, --token, --user, --help",
+    examples: [
+        "kweaver toolbox create --name MyBox --service-url https://svc.example.com",
+        "kweaver toolbox list --keyword analytics",
+        "kweaver toolbox export <box-id> -o box.adp",
+    ],
+    learnMore: ["Use `kweaver toolbox <subcommand> --help` for flag details"],
+});
 export async function runToolboxCommand(args) {
     const [subcommand, ...rest] = args;
     if (!subcommand || subcommand === "--help" || subcommand === "-h") {

package/dist/commands/trace.d.ts

@@ -1,14 +1,39 @@
 export interface ParsedTraceArgs {
-    subcommand: "diagnose" | "rules-validate" | "help";
+    subcommand: "diagnose" | "rules-validate" | "eval-set-build" | "eval-set-test" | "schema-validate" | "help";
+    mode?: "single" | "batch";
     conversationId?: string;
+    traces?: string;
     rulePath?: string;
     out: string | null;
     rulesDir: string | null;
     noBuiltin: boolean;
     noLlm: boolean;
+    noArtifacts: boolean;
+    maxParallel: number;
+    format: 'yaml' | 'markdown' | 'both' | null;
+    lang: 'en' | 'zh' | null;
     baseUrl: string | null;
     token: string | null;
     businessDomain: string | null;
+    queriesPath?: string;
+    diagnosisPath?: string;
+    onConflict?: "fail" | "skip" | "overwrite";
+    redactionRules?: string;
+    evalSetId?: string;
+    schemaValidatePath?: string;
+    schemaKind?: string;
+    evalSetPath?: string;
+    candidateAgentId?: string;
+    candidateAgentVersion?: string;
 }
 export declare function parseTraceArgs(argv: string[]): ParsedTraceArgs;
 export declare function runTraceCommand(rest: string[]): Promise<number>;
+export declare class SchemaKindRequiredError extends Error {
+    constructor(filePath: string);
+}
+export declare function inferKind(filePath: string): string | null;
+export interface RunSchemaValidateOpts {
+    filePath: string;
+    kind: string | undefined;
+}
+export declare function runSchemaValidate(opts: RunSchemaValidateOpts): Promise<number>;