@utdk/cli 0.1.0-dev.646adf4

package/dist/cli.js

@@ -0,0 +1,368 @@
+/**
+ * Core CLI logic for @utdk/cli.
+ *
+ * Usage:
+ *   utdk [--output json|table] [--agent] <provider> <operation> [--flag value…]
+ *   utdk --help
+ *   utdk --version
+ *   utdk <provider> --help
+ *
+ * Exit codes (matching cli-printing-press):
+ *   0  success
+ *   2  usage error  (unknown provider / operation, bad args)
+ *   3  not found    (HTTP 404)
+ *   4  auth failure (HTTP 401/403)
+ *   5  API error    (HTTP 5xx)
+ *   7  rate limited (HTTP 429)
+ */
+import { readFileSync } from "fs";
+import { join } from "path";
+import { createClient } from "utdk/client";
+import { resolveAuth, authEnvVars } from "./auth.js";
+import { defaultOutputMode, renderHelpList, writeOutput, } from "./format.js";
+import { buildToolMetadata, findOperation, getProviderInfo, listOperations, listProviders, UTDK_ROOT, } from "./providers.js";
+// ---------------------------------------------------------------------------
+// CLI version
+// ---------------------------------------------------------------------------
+const VERSION = "0.1.0";
+function coerceValue(raw) {
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    if (/^-?\d+(\.\d+)?$/.test(raw))
+        return Number(raw);
+    return raw;
+}
+export function parseArgs(argv) {
+    const result = {
+        output: undefined,
+        agent: false,
+        help: false,
+        version: false,
+        provider: undefined,
+        operation: undefined,
+        params: {},
+    };
+    const positionals = [];
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            result.help = true;
+            i++;
+            continue;
+        }
+        if (arg === "--version" || arg === "-v") {
+            result.version = true;
+            i++;
+            continue;
+        }
+        if (arg === "--agent") {
+            result.agent = true;
+            i++;
+            continue;
+        }
+        if (arg === "--output" || arg === "-o") {
+            const val = argv[i + 1];
+            if (val === "json" || val === "table" || val === "agent") {
+                result.output = val;
+                i += 2;
+            }
+            else {
+                i++;
+            }
+            continue;
+        }
+        if (arg.startsWith("--output=")) {
+            const val = arg.slice(9);
+            if (val === "json" || val === "table" || val === "agent")
+                result.output = val;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--") && arg.length > 2) {
+            const key = arg.slice(2);
+            const nextArg = argv[i + 1];
+            if (nextArg !== undefined && !nextArg.startsWith("--")) {
+                const existing = result.params[key];
+                const coerced = coerceValue(nextArg);
+                if (existing !== undefined) {
+                    result.params[key] = Array.isArray(existing)
+                        ? [...existing, coerced]
+                        : [existing, coerced];
+                }
+                else {
+                    result.params[key] = coerced;
+                }
+                i += 2;
+            }
+            else {
+                result.params[key] = true;
+                i++;
+            }
+            continue;
+        }
+        positionals.push(arg);
+        i++;
+    }
+    result.provider = positionals[0];
+    result.operation = positionals[1];
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Error → exit code mapping
+// ---------------------------------------------------------------------------
+function exitCodeForError(error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    const m = /Request failed: (\d+)/.exec(msg);
+    if (!m)
+        return 1;
+    const status = parseInt(m[1] ?? "0", 10);
+    if (status === 404)
+        return 3;
+    if (status === 401 || status === 403)
+        return 4;
+    if (status === 429)
+        return 7;
+    if (status >= 500)
+        return 5;
+    return 2;
+}
+// ---------------------------------------------------------------------------
+// Help text builders
+// ---------------------------------------------------------------------------
+function printGlobalHelp() {
+    const providers = listProviders();
+    process.stdout.write([
+        `utdk v${VERSION} — agent-native CLI for @utdk providers`,
+        "",
+        "Usage:",
+        "  utdk [--output json|table] [--agent] <provider> <operation> [--flag value…]",
+        "  utdk <provider> --help",
+        "  utdk --help",
+        "",
+        "Global flags:",
+        "  --output json|table  Output format (default: table in TTY, json when piped)",
+        "  --agent              Compact JSON output optimised for agent parsing",
+        "  --help, -h           Show this help or provider/operation help",
+        "  --version, -v        Print version",
+        "",
+        "Providers:",
+    ].join("\n"));
+    process.stdout.write("\n");
+    if (providers.length === 0) {
+        process.stdout.write("  (none found — is the utdk package built?)\n");
+    }
+    else {
+        const items = providers.map((name) => {
+            const info = getProviderInfo(name);
+            return [name, info?.description?.slice(0, 70) ?? ""];
+        });
+        process.stdout.write(renderHelpList(items, 20));
+        process.stdout.write("\n");
+    }
+    process.stdout.write("\n");
+}
+function printProviderHelp(providerName) {
+    const info = getProviderInfo(providerName);
+    if (!info) {
+        process.stderr.write(`Provider "${providerName}" not found.\n`);
+        process.exitCode = 2;
+        return;
+    }
+    const ops = listOperations(providerName);
+    const envVars = authEnvVars(providerName, info.auth);
+    process.stdout.write([
+        `utdk ${providerName} — ${info.description ?? ""}`,
+        "",
+        "Usage:",
+        `  utdk ${providerName} <operation> [--flag value…]`,
+        "",
+        "Auth environment variables:",
+        envVars.map((v) => `  ${v}`).join("\n"),
+        "",
+        `Operations (${ops.length} total):`,
+    ].join("\n"));
+    process.stdout.write("\n");
+    const items = ops.slice(0, 100).map((op) => [
+        op.accessPath.join("."),
+        op.summary?.slice(0, 60) ?? `${op.method} ${op.path}`,
+    ]);
+    process.stdout.write(renderHelpList(items, 40));
+    process.stdout.write("\n");
+    if (ops.length > 100) {
+        process.stdout.write(`\n  … and ${ops.length - 100} more. Filter with: utdk ${providerName} --help | grep <term>\n`);
+    }
+    process.stdout.write("\n");
+}
+function printOperationHelp(providerName, op) {
+    const info = getProviderInfo(providerName);
+    const envVars = authEnvVars(providerName, info?.auth ?? []);
+    process.stdout.write([
+        `utdk ${providerName} ${op.accessPath.join(".")}`,
+        "",
+        `${op.method} ${op.path}`,
+        op.summary ? `Summary: ${op.summary}` : "",
+        op.description ? `\n${op.description.slice(0, 300)}` : "",
+        "",
+        "Parameters:",
+    ]
+        .filter((l) => l !== "")
+        .join("\n"));
+    process.stdout.write("\n");
+    if (op.parameters.length === 0) {
+        process.stdout.write("  (none)\n");
+    }
+    else {
+        const items = op.parameters.map((p) => [
+            `--${p.name}${p.required ? " *" : ""}`,
+            [p.in, p.type, p.description?.slice(0, 50)].filter(Boolean).join(" · "),
+        ]);
+        process.stdout.write(renderHelpList(items, 30));
+        process.stdout.write("\n");
+        process.stdout.write("\n  * = required\n");
+    }
+    process.stdout.write("\nAuth:\n");
+    process.stdout.write(envVars.map((v) => `  ${v}`).join("\n"));
+    process.stdout.write("\n\n");
+}
+// ---------------------------------------------------------------------------
+// Operation executor
+// ---------------------------------------------------------------------------
+/** Navigate a nested object using a dot-path. */
+function getNestedValue(obj, path) {
+    return path.reduce((current, key) => {
+        if (current !== null && typeof current === "object") {
+            return current[key];
+        }
+        return undefined;
+    }, obj);
+}
+async function executeOperation(providerName, op, params, outputMode) {
+    // Load the OpenAPI document for this provider
+    const openApiPath = join(UTDK_ROOT, providerName, "openapi.json");
+    let openApiDocument;
+    try {
+        openApiDocument = JSON.parse(readFileSync(openApiPath, "utf-8"));
+    }
+    catch {
+        process.stderr.write(`Failed to load OpenAPI spec for "${providerName}".\n`);
+        return 2;
+    }
+    // Resolve auth
+    const info = getProviderInfo(providerName);
+    const auth = resolveAuth(providerName, info?.auth ?? []);
+    // Build tool metadata from the OpenAPI spec so path/query/header/body
+    // params are routed correctly (provider metadata.ts files are often empty).
+    const allOps = listOperations(providerName);
+    const toolMetadata = buildToolMetadata(allOps);
+    // Create the client
+    let client;
+    try {
+        client = await createClient({
+            name: providerName,
+            openApiDocument,
+            toolMetadata,
+            ...(auth ? { auth } : {}),
+        });
+    }
+    catch (err) {
+        process.stderr.write(`Failed to create client for "${providerName}": ${err instanceof Error ? err.message : String(err)}\n`);
+        return 2;
+    }
+    // Navigate to the operation function
+    const fn = getNestedValue(client, op.accessPath);
+    if (typeof fn !== "function") {
+        process.stderr.write(`Operation "${op.accessPath.join(".")}" not found on the ${providerName} client.\n`);
+        return 2;
+    }
+    // Call it
+    let result;
+    try {
+        result = await fn(params);
+    }
+    catch (err) {
+        const code = exitCodeForError(err);
+        const msg = err instanceof Error ? err.message : String(err);
+        if (outputMode === "json" || outputMode === "agent") {
+            writeOutput({ ok: false, error: msg, exitCode: code }, outputMode);
+        }
+        else {
+            process.stderr.write(`Error: ${msg}\n`);
+        }
+        return code;
+    }
+    writeOutput(result, outputMode);
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Main entry
+// ---------------------------------------------------------------------------
+export async function runCli(argv) {
+    const args = parseArgs(argv);
+    // Determine output mode: --agent overrides --output
+    const outputMode = args.agent
+        ? "agent"
+        : (args.output ?? defaultOutputMode());
+    // --version
+    if (args.version) {
+        process.stdout.write(`@utdk/cli v${VERSION}\n`);
+        return 0;
+    }
+    // utdk --help
+    if (args.help && !args.provider) {
+        printGlobalHelp();
+        return 0;
+    }
+    // No provider — show global help
+    if (!args.provider) {
+        printGlobalHelp();
+        return 0;
+    }
+    // Validate provider
+    const providers = listProviders();
+    if (!providers.includes(args.provider)) {
+        if (outputMode === "json" || outputMode === "agent") {
+            writeOutput({
+                ok: false,
+                error: `Unknown provider: ${args.provider}`,
+                available: providers,
+            }, outputMode);
+        }
+        else {
+            process.stderr.write(`Unknown provider: "${args.provider}"\nAvailable: ${providers.join(", ")}\n`);
+        }
+        return 2;
+    }
+    // utdk <provider> --help or utdk <provider> (no operation)
+    if (args.help || !args.operation) {
+        printProviderHelp(args.provider);
+        return 0;
+    }
+    // Find the operation
+    const op = findOperation(args.provider, args.operation);
+    if (!op) {
+        // Maybe the user wants help on what they typed
+        if (outputMode === "json" || outputMode === "agent") {
+            writeOutput({
+                ok: false,
+                error: `Unknown operation: ${args.operation}`,
+                provider: args.provider,
+            }, outputMode);
+        }
+        else {
+            process.stderr.write(`Unknown operation "${args.operation}" for provider "${args.provider}".\n` +
+                `Run "utdk ${args.provider} --help" to list available operations.\n`);
+        }
+        return 2;
+    }
+    // utdk <provider> <operation> --help
+    if (args.help) {
+        printOperationHelp(args.provider, op);
+        return 0;
+    }
+    // Execute
+    return executeOperation(args.provider, op, args.params, outputMode);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/format.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Output formatting for @utdk/cli.
+ *
+ * Supports three modes:
+ *   - json   : pretty-printed JSON (default when stdout is not a TTY)
+ *   - table  : padded text table (default when stdout is a TTY)
+ *   - agent  : compact single-line JSON with no ANSI escapes
+ */
+export type OutputMode = "json" | "table" | "agent";
+/** Detect the default output mode based on whether stdout is a TTY. */
+export declare function defaultOutputMode(): OutputMode;
+export declare function formatJson(data: unknown, compact?: boolean): string;
+export declare function formatTable(data: unknown): string;
+export declare function writeOutput(data: unknown, mode: OutputMode): void;
+/** Render a two-column list with fixed-width left column. */
+export declare function renderHelpList(items: Array<[string, string]>, leftWidth?: number): string;

package/dist/format.js

@@ -0,0 +1,111 @@
+/**
+ * Output formatting for @utdk/cli.
+ *
+ * Supports three modes:
+ *   - json   : pretty-printed JSON (default when stdout is not a TTY)
+ *   - table  : padded text table (default when stdout is a TTY)
+ *   - agent  : compact single-line JSON with no ANSI escapes
+ */
+/** Detect the default output mode based on whether stdout is a TTY. */
+export function defaultOutputMode() {
+    return process.stdout.isTTY ? "table" : "json";
+}
+// ---------------------------------------------------------------------------
+// JSON output
+// ---------------------------------------------------------------------------
+export function formatJson(data, compact = false) {
+    return compact ? JSON.stringify(data) : JSON.stringify(data, null, 2);
+}
+// ---------------------------------------------------------------------------
+// Table output
+// ---------------------------------------------------------------------------
+/** Render a two-column key/value table for a plain object. */
+function renderObjectTable(obj) {
+    const entries = Object.entries(obj);
+    const keyWidth = Math.min(40, Math.max(4, ...entries.map(([k]) => k.length)));
+    const lines = [];
+    for (const [key, value] of entries) {
+        const k = key.padEnd(keyWidth);
+        const v = valueToCell(value);
+        lines.push(`${k}  ${v}`);
+    }
+    return lines.join("\n");
+}
+/** Render an array of objects as a columnar table. */
+function renderArrayTable(items) {
+    if (items.length === 0)
+        return "(empty)";
+    // Collect all column names from the first item (limit to 8 columns for readability)
+    const allKeys = Object.keys(items[0] ?? {});
+    const keys = allKeys.slice(0, 8);
+    const widths = keys.map((k) => {
+        const maxValue = Math.max(...items.map((r) => valueToCell(r[k]).length));
+        return Math.min(60, Math.max(k.length, maxValue));
+    });
+    const header = keys.map((k, i) => k.padEnd(widths[i] ?? k.length)).join("  ");
+    const divider = widths.map((w) => "─".repeat(w)).join("  ");
+    const rows = items.map((item) => keys
+        .map((k, i) => valueToCell(item[k]).slice(0, widths[i] ?? 60).padEnd(widths[i] ?? 0))
+        .join("  "));
+    return [header, divider, ...rows].join("\n");
+}
+function valueToCell(v) {
+    if (v === null || v === undefined)
+        return "";
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    if (Array.isArray(v))
+        return `[${v.length} items]`;
+    if (typeof v === "object")
+        return "{…}";
+    return String(v);
+}
+function isObjectArray(data) {
+    return (Array.isArray(data) &&
+        data.length > 0 &&
+        typeof data[0] === "object" &&
+        data[0] !== null &&
+        !Array.isArray(data[0]));
+}
+function isPlainObject(data) {
+    return typeof data === "object" && data !== null && !Array.isArray(data);
+}
+export function formatTable(data) {
+    if (isObjectArray(data))
+        return renderArrayTable(data);
+    if (isPlainObject(data))
+        return renderObjectTable(data);
+    if (Array.isArray(data))
+        return data.map((item) => valueToCell(item)).join("\n");
+    return valueToCell(data);
+}
+// ---------------------------------------------------------------------------
+// Unified output writer
+// ---------------------------------------------------------------------------
+export function writeOutput(data, mode) {
+    let out;
+    switch (mode) {
+        case "json":
+            out = formatJson(data, false);
+            break;
+        case "agent":
+            out = formatJson(data, true);
+            break;
+        case "table":
+            out = formatTable(data);
+            break;
+    }
+    process.stdout.write(`${out}\n`);
+}
+// ---------------------------------------------------------------------------
+// Help table helpers
+// ---------------------------------------------------------------------------
+/** Render a two-column list with fixed-width left column. */
+export function renderHelpList(items, leftWidth = 30) {
+    return items
+        .map(([left, right]) => `  ${left.padEnd(leftWidth)}  ${right}`)
+        .join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/providers.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Provider and operation discovery for @utdk/cli.
+ *
+ * Scans the utdk package directory for providers and reads their OpenAPI
+ * specifications to enumerate operations. Name transformations mirror
+ * those in packages/utdk/client.ts so CLI operation names match the
+ * accessor paths on the created client.
+ *
+ * Also builds ToolRuntimeMetadataMap entries for path/query/header/body
+ * parameter routing, so the generated client can correctly assemble HTTP
+ * requests even when the provider's hand-written metadata.ts is empty.
+ */
+import type { ToolRuntimeMetadataMap } from "utdk/client";
+export declare const UTDK_ROOT: string;
+export type AuthConfig = {
+    auth_type: "api_key" | "oauth2" | "basic";
+    api_key?: string;
+    var_name?: string;
+    location?: string;
+    token_url?: string;
+    client_id?: string;
+    client_secret?: string;
+    scope?: string;
+};
+export type ProviderInfo = {
+    name: string;
+    description?: string;
+    auth: AuthConfig[];
+};
+export type ParameterInfo = {
+    name: string;
+    in: "query" | "path" | "header" | "cookie";
+    required: boolean;
+    description?: string;
+    type?: string;
+};
+export type BodyInfo = {
+    kind: "none" | "properties" | "raw";
+    propertyKeys: string[];
+    contentType?: string;
+    allowsAdditionalProperties?: boolean;
+};
+export type OperationInfo = {
+    accessPath: string[];
+    operationId: string;
+    method: string;
+    path: string;
+    summary?: string;
+    description?: string;
+    parameters: ParameterInfo[];
+    body: BodyInfo;
+};
+export declare function toCamelCase(name: string): string;
+/** Returns all provider names found in the utdk package directory. */
+export declare function listProviders(): string[];
+/** Returns metadata for a single provider, or undefined if not found. */
+export declare function getProviderInfo(providerName: string): ProviderInfo | undefined;
+/** Parses the OpenAPI spec for a provider and returns all operations with their metadata. */
+export declare function listOperations(providerName: string): OperationInfo[];
+/** Returns the OperationInfo for a specific access-path string like "users.getByUsername". */
+export declare function findOperation(providerName: string, operationPath: string): OperationInfo | undefined;
+/**
+ * Build a ToolRuntimeMetadataMap from the provider's OpenAPI spec.
+ *
+ * The map keys equal the bare operationId (which is what OpenApiConverter
+ * uses as tool.name).  Providing this map to createClient() gives the
+ * request assembler correct path/query/header/body routing without
+ * relying on the provider's (often empty) hand-written metadata.ts.
+ */
+export declare function buildToolMetadata(ops: OperationInfo[]): ToolRuntimeMetadataMap;