@ogment-ai/cli 0.6.0 → 0.7.1

package/dist/cli/execute.js

@@ -1,468 +0,0 @@
-import { runAuthLoginCommand, runAuthLogoutCommand, runAuthStatusCommand, } from "../commands/auth.js";
-import { runCatalogCommand, runCatalogToolDetailsCommand, runCatalogToolsCommand, } from "../commands/catalog.js";
-import { runInvokeCommand } from "../commands/invoke.js";
-import { runStatusCommand } from "../commands/status.js";
-import { buildJsonSchemaExample, EXAMPLE_PLACEHOLDER } from "../shared/schema-example.js";
-import { AuthError, ContractMismatchError, NotFoundError, RemoteRequestError, UnexpectedError, ValidationError, } from "../shared/errors.js";
-import { exitCodeForError } from "../shared/exit-codes.js";
-import { cliCommands } from "./commands.js";
-export class CliExitError extends Error {
-    exitCode;
-    constructor(exitCode) {
-        super("CLI exit");
-        this.exitCode = exitCode;
-    }
-}
-const throwCommandError = (error) => {
-    throw new CliExitError(exitCodeForError(error));
-};
-const nextAction = (id, title, command, reason, when = null) => {
-    return {
-        command,
-        id,
-        reason,
-        title,
-        when,
-    };
-};
-const ensureSuccess = (result, runtime, context) => {
-    if (result.status === "error") {
-        runtime.output.error(result.error, {
-            command: context.command,
-            entity: context.entity ?? null,
-        });
-        throwCommandError(result.error);
-    }
-    return result.value;
-};
-const nextActionsForLogin = (payload, mode) => {
-    return [
-        nextAction("check_auth_status", "Check auth status", cliCommands.auth.status(), `Verify persisted credentials after ${mode} login for ${payload.agentName}.`, "immediate"),
-        nextAction("discover_servers", "Discover servers", cliCommands.catalog.command(), `Logged in as ${payload.agentName} via ${mode}; discover available servers.`, "after_auth"),
-    ];
-};
-const nextActionsForAuthStatus = (payload) => {
-    if (!payload.loggedIn) {
-        return [
-            nextAction("login", "Authenticate", cliCommands.auth.login(), "No API key is configured locally; login is required.", "immediate"),
-        ];
-    }
-    return [
-        nextAction("discover_servers", "Discover servers", cliCommands.catalog.command(), `Authenticated via ${payload.apiKeySource}; discover servers next.`, "after_auth"),
-    ];
-};
-const nextActionsForCatalogSummary = (payload, context) => {
-    const actions = [];
-    const targetServer = payload.servers.find((server) => server.toolCount > 0);
-    if (targetServer !== undefined) {
-        actions.push(nextAction("inspect_tools", "Inspect tools", cliCommands.catalog.server(targetServer.serverId), `${targetServer.serverId} has ${targetServer.toolCount} available tools.`, "if_tool_count_gt_0"));
-    }
-    if (context.nextCursor !== null) {
-        actions.push(nextAction("next_catalog_page", "Load next page", cliCommands.catalog.summary({
-            cursor: context.nextCursor,
-            limit: context.limit ?? undefined,
-        }), `More servers are available after cursor ${context.nextCursor}.`, "if_more_servers"));
-    }
-    return actions;
-};
-const nextActionsForCatalogTools = (payload) => {
-    const firstTool = payload.tools[0];
-    if (firstTool === undefined) {
-        return [];
-    }
-    return [
-        nextAction("inspect_tool", "Inspect tool details", cliCommands.catalog.tool(payload.server.serverId, firstTool.name, {
-            example: false,
-        }), `Inspect schema for ${payload.server.serverId}/${firstTool.name} before invoking.`, "if_tools_available"),
-    ];
-};
-const toInlineJsonTemplateArgument = (value) => {
-    const placeholderLiteral = JSON.stringify(EXAMPLE_PLACEHOLDER);
-    const serialized = JSON.stringify(value).replaceAll(placeholderLiteral, " ... ");
-    const escaped = serialized.replaceAll("'", String.raw `'\''`);
-    return `'${escaped}'`;
-};
-const nextActionsForCatalogToolDetails = (payload, exampleInput) => {
-    const inputArgument = toInlineJsonTemplateArgument(exampleInput);
-    return [
-        nextAction("invoke_tool", "Invoke this tool", cliCommands.invoke.withInputValue(`${payload.server.serverId}/${payload.name}`, inputArgument), `Replace every ... placeholder with real JSON values, then invoke ${payload.server.serverId}/${payload.name}.`, "after_tool_inspection"),
-    ];
-};
-const nextActionsForInvoke = (payload) => {
-    return [
-        nextAction("inspect_tool", "Inspect tool schema", cliCommands.catalog.tool(payload.serverId, payload.toolName, { example: false }), `Review ${payload.serverId}/${payload.toolName} schema for the next invocation.`, "after_invoke"),
-    ];
-};
-const nextActionsForStatus = (payload) => {
-    if (!payload.auth.apiKeyPresent) {
-        return [
-            nextAction("login", "Authenticate", cliCommands.auth.login(), "Status detected no API key; authenticate first.", "immediate"),
-        ];
-    }
-    return [
-        nextAction("discover_servers", "Discover servers", cliCommands.catalog.command(), `Connectivity is ${payload.summary.status}; discover available servers.`, "after_status"),
-    ];
-};
-const runLoginFlow = async (runtime, mode, apiKey) => {
-    const loginInvocation = (() => {
-        if (mode === "api_key") {
-            return {
-                commandOptions: {
-                    apiKey: apiKey ?? "",
-                    mode: "apiKey",
-                },
-                invokedCommand: cliCommands.auth.loginWithApiKeyRedacted(),
-            };
-        }
-        const deviceCommand = cliCommands.auth.login();
-        return {
-            commandOptions: {
-                mode: "device",
-                onPending: ({ userCode, verificationUri }) => {
-                    const pendingNextActions = [
-                        nextAction("check_login_status", "Check login status", cliCommands.auth.status(), `Approve ${userCode} at ${verificationUri}, then verify local auth state.`, "immediate"),
-                        nextAction("restart_device_login", "Restart login", cliCommands.auth.login(), `Restart login if code ${userCode} expires before approval.`, "if_expired"),
-                    ];
-                    runtime.output.success({
-                        event: "auth_login.pending",
-                        loggedIn: false,
-                        verification: {
-                            userCode,
-                            verificationUri,
-                        },
-                    }, {
-                        command: deviceCommand,
-                        entity: {
-                            event: "auth_login.pending",
-                            mode,
-                            verification: {
-                                userCode,
-                                verificationUri,
-                            },
-                        },
-                        humanMessage: `Open ${verificationUri} and enter code ${userCode}`,
-                        nextActions: pendingNextActions,
-                    });
-                },
-            },
-            invokedCommand: deviceCommand,
-        };
-    })();
-    const { commandOptions, invokedCommand } = loginInvocation;
-    const result = await runAuthLoginCommand(runtime.context, commandOptions);
-    const data = ensureSuccess(result, runtime, {
-        command: invokedCommand,
-        entity: {
-            mode,
-        },
-    });
-    let humanMessage = `Logged in as ${data.agentName}.`;
-    if (data.outcome === "already_authenticated") {
-        humanMessage = `Already logged in as ${data.agentName}.`;
-    }
-    else if (mode === "api_key") {
-        humanMessage = `Imported API key for ${data.agentName}.`;
-    }
-    const outputData = {
-        ...data,
-        event: "auth_login.completed",
-    };
-    runtime.output.success(outputData, {
-        command: invokedCommand,
-        entity: {
-            agentName: data.agentName,
-            event: "auth_login.completed",
-            loggedIn: data.loggedIn,
-            mode,
-            outcome: data.outcome,
-        },
-        humanMessage,
-        nextActions: nextActionsForLogin(data, mode),
-    });
-};
-const executeAuthLoginInvocation = async (runtime, invocation) => {
-    if (invocation.apiKey !== undefined) {
-        await runLoginFlow(runtime, "api_key", invocation.apiKey);
-        return;
-    }
-    await runLoginFlow(runtime, "device");
-};
-const executeAuthStatusInvocation = async (runtime) => {
-    const command = cliCommands.auth.status();
-    const result = await runAuthStatusCommand(runtime.context);
-    const data = ensureSuccess(result, runtime, {
-        command,
-    });
-    runtime.output.success(data, {
-        command,
-        entity: {
-            apiKeySource: data.apiKeySource,
-            loggedIn: data.loggedIn,
-        },
-        humanMessage: data.loggedIn ? `Authenticated (${data.apiKeySource}).` : "Not authenticated.",
-        nextActions: nextActionsForAuthStatus(data),
-    });
-};
-const executeAuthLogoutInvocation = async (runtime) => {
-    const command = cliCommands.auth.logout();
-    const result = await runAuthLogoutCommand(runtime.context);
-    const data = ensureSuccess(result, runtime, {
-        command,
-    });
-    let message = "Not logged in.";
-    if (data.localCredentialsDeleted) {
-        message = data.revoked
-            ? "Logged out and revoked API key."
-            : "Logged out locally. Server revocation not confirmed.";
-    }
-    runtime.output.success(data, {
-        command,
-        entity: {
-            localCredentialsDeleted: data.localCredentialsDeleted,
-            revoked: data.revoked,
-        },
-        humanMessage: message,
-        nextActions: [
-            nextAction("login", "Authenticate again", cliCommands.auth.login(), "Logout completed; authenticate again before further tool calls.", "after_logout"),
-        ],
-    });
-};
-const executeCatalogInvocation = async (runtime, invocation) => {
-    const parsedLimit = invocation.limit;
-    if (invocation.serverId === undefined) {
-        if (invocation.example) {
-            throw new ValidationError({
-                details: "--example without <server-id> <tool-name>",
-                message: "Invalid catalog options. --example requires <server-id> <tool-name>.",
-                recovery: { command: cliCommands.catalog.command() },
-            });
-        }
-        const command = cliCommands.catalog.summary({
-            cursor: invocation.cursor,
-            limit: parsedLimit,
-        });
-        const result = await runCatalogCommand(runtime.context, {
-            cursor: invocation.cursor,
-            includeDebug: runtime.output.debug,
-            limit: parsedLimit,
-        });
-        const data = ensureSuccess(result, runtime, {
-            command,
-            entity: {
-                cursor: invocation.cursor ?? null,
-                limit: parsedLimit ?? null,
-            },
-        });
-        const outputData = {
-            failures: data.failures,
-            servers: data.servers,
-        };
-        runtime.output.success(outputData, {
-            command,
-            entity: {
-                cursor: invocation.cursor ?? null,
-                failedServerCount: data.failures.length,
-                limit: parsedLimit ?? null,
-                serverCount: data.servers.length,
-            },
-            humanMessage: (() => {
-                const baseMessage = data.nextCursor === null
-                    ? `${data.servers.length} server(s) available.`
-                    : `${data.servers.length} server(s) shown. More available with --cursor ${data.nextCursor}.`;
-                if (data.failures.length === 0) {
-                    return baseMessage;
-                }
-                return `${baseMessage} ${data.failures.length} server(s) failed to load.`;
-            })(),
-            nextActions: nextActionsForCatalogSummary(outputData, {
-                limit: parsedLimit ?? null,
-                nextCursor: data.nextCursor,
-            }),
-            pagination: {
-                nextCursor: data.nextCursor,
-            },
-        });
-        return;
-    }
-    if (invocation.toolName === undefined) {
-        if (invocation.cursor !== undefined || parsedLimit !== undefined) {
-            throw new ValidationError({
-                details: `${invocation.cursor === undefined ? "" : `--cursor ${invocation.cursor} `}${parsedLimit === undefined ? "" : `--limit ${parsedLimit}`}`.trim(),
-                message: "Invalid catalog options. --cursor and --limit are only valid for `ogment catalog`.",
-                recovery: { command: cliCommands.catalog.command() },
-            });
-        }
-        if (invocation.example) {
-            throw new ValidationError({
-                details: `--example without tool name for ${invocation.serverId}`,
-                message: "Invalid catalog options. --example requires <tool-name>.",
-                recovery: { command: cliCommands.catalog.server(invocation.serverId) },
-            });
-        }
-        const serverId = invocation.serverId;
-        const command = cliCommands.catalog.server(serverId);
-        const result = await runCatalogToolsCommand(runtime.context, { serverId });
-        const data = ensureSuccess(result, runtime, {
-            command,
-            entity: {
-                serverId,
-            },
-        });
-        runtime.output.success(data, {
-            command,
-            entity: {
-                serverId: data.server.serverId,
-                toolCount: data.tools.length,
-            },
-            humanMessage: `${data.tools.length} tool(s) available on ${data.server.serverId}.`,
-            nextActions: nextActionsForCatalogTools(data),
-        });
-        return;
-    }
-    if (invocation.cursor !== undefined || parsedLimit !== undefined) {
-        throw new ValidationError({
-            details: `${invocation.cursor === undefined ? "" : `--cursor ${invocation.cursor} `}${parsedLimit === undefined ? "" : `--limit ${parsedLimit}`}`.trim(),
-            message: "Invalid catalog options. --cursor and --limit are only valid for `ogment catalog`.",
-            recovery: {
-                command: cliCommands.catalog.tool(invocation.serverId, invocation.toolName, {
-                    example: invocation.example,
-                }),
-            },
-        });
-    }
-    const serverId = invocation.serverId;
-    const toolName = invocation.toolName;
-    const command = cliCommands.catalog.tool(serverId, toolName, {
-        example: invocation.example,
-    });
-    const result = await runCatalogToolDetailsCommand(runtime.context, { serverId, toolName });
-    const data = ensureSuccess(result, runtime, {
-        command,
-        entity: {
-            serverId,
-            toolName,
-        },
-    });
-    const exampleInput = buildJsonSchemaExample(data.inputSchema);
-    const outputData = invocation.example ? { ...data, exampleInput } : data;
-    runtime.output.success(outputData, {
-        command,
-        entity: {
-            serverId: data.server.serverId,
-            toolName: data.name,
-        },
-        humanMessage: `Loaded schema for ${data.server.serverId}/${data.name}.`,
-        nextActions: nextActionsForCatalogToolDetails(data, exampleInput),
-    });
-};
-const executeInvokeInvocation = async (runtime, invocation) => {
-    let inputSource = "none";
-    let command = cliCommands.invoke.command(invocation.target);
-    if (invocation.input !== undefined) {
-        if (invocation.input === "-") {
-            inputSource = "stdin";
-            command = cliCommands.invoke.stdin(invocation.target);
-        }
-        else if (invocation.input.startsWith("@")) {
-            inputSource = "file";
-            command = cliCommands.invoke.withInputValue(invocation.target, invocation.input);
-        }
-        else {
-            inputSource = "inline_json";
-            command = cliCommands.invoke.inlineJson(invocation.target);
-        }
-    }
-    const result = await runInvokeCommand(runtime.context, {
-        input: invocation.input,
-        target: invocation.target,
-    });
-    const data = ensureSuccess(result, runtime, {
-        command,
-        entity: {
-            inputSource,
-            target: invocation.target,
-        },
-    });
-    runtime.output.success(data, {
-        command,
-        entity: {
-            inputSource,
-            serverId: data.serverId,
-            toolName: data.toolName,
-        },
-        humanMessage: `Invoked ${data.serverId}/${data.toolName}.`,
-        nextActions: nextActionsForInvoke(data),
-    });
-};
-const executeStatusInvocation = async (runtime) => {
-    const command = cliCommands.status.command();
-    if (runtime.infoService === undefined) {
-        throw new UnexpectedError({
-            message: "Info service is not configured",
-        });
-    }
-    const result = await runStatusCommand({
-        apiKeyOverride: runtime.context.apiKeyOverride,
-    }, {
-        infoService: runtime.infoService,
-    });
-    const data = ensureSuccess(result, runtime, {
-        command,
-    });
-    runtime.output.success(data, {
-        command,
-        entity: {
-            summaryStatus: data.summary.status,
-        },
-        humanMessage: `Diagnostics status: ${data.summary.status.toUpperCase()}`,
-        nextActions: nextActionsForStatus(data),
-    });
-};
-const executeRootInvocation = (runtime) => {
-    runtime.output.success({
-        commands: cliCommands.root.commandsSurface(),
-    }, {
-        command: cliCommands.root.command(),
-        entity: null,
-        humanMessage: "Select a command to continue.",
-        nextActions: [
-            nextAction("login", "Authenticate", cliCommands.auth.login(), "Authenticate first so catalog and invoke commands can run.", "immediate"),
-            nextAction("catalog", "Discover servers", cliCommands.catalog.command(), "List accessible servers and tool counts.", "after_auth"),
-        ],
-    });
-};
-const invocationHandlers = {
-    auth_login: executeAuthLoginInvocation,
-    auth_logout: async (runtime) => executeAuthLogoutInvocation(runtime),
-    auth_status: async (runtime) => executeAuthStatusInvocation(runtime),
-    catalog: executeCatalogInvocation,
-    invoke: executeInvokeInvocation,
-    root: async (runtime) => {
-        executeRootInvocation(runtime);
-    },
-    status: async (runtime) => executeStatusInvocation(runtime),
-};
-export const executeInvocation = async (runtime, invocation) => {
-    const handler = invocationHandlers[invocation.kind];
-    await handler(runtime, invocation);
-};
-export const normalizeCliRuntimeError = (error) => {
-    if (error instanceof AuthError ||
-        error instanceof ContractMismatchError ||
-        error instanceof NotFoundError ||
-        error instanceof RemoteRequestError ||
-        error instanceof UnexpectedError ||
-        error instanceof ValidationError) {
-        return error;
-    }
-    if (error instanceof Error) {
-        return new UnexpectedError({
-            cause: error,
-            message: error.message,
-        });
-    }
-    return new UnexpectedError({
-        cause: error,
-        message: "Unexpected CLI failure",
-    });
-};

package/dist/cli/invocations.d.ts

@@ -1,31 +0,0 @@
-export interface AuthLoginInvocation {
-    apiKey: string | undefined;
-    kind: "auth_login";
-}
-export interface AuthStatusInvocation {
-    kind: "auth_status";
-}
-export interface AuthLogoutInvocation {
-    kind: "auth_logout";
-}
-export interface CatalogInvocation {
-    cursor: string | undefined;
-    example: boolean;
-    kind: "catalog";
-    limit: number | undefined;
-    serverId: string | undefined;
-    toolName: string | undefined;
-}
-export interface InvokeInvocation {
-    input: string | undefined;
-    kind: "invoke";
-    target: string;
-}
-export interface StatusInvocation {
-    kind: "status";
-}
-export interface RootInvocation {
-    kind: "root";
-}
-export type CliInvocation = AuthLoginInvocation | AuthLogoutInvocation | AuthStatusInvocation | CatalogInvocation | InvokeInvocation | RootInvocation | StatusInvocation;
-//# sourceMappingURL=invocations.d.ts.map

package/dist/cli/invocations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"invocations.d.ts","sourceRoot":"","sources":["../../src/cli/invocations.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,YAAY,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,CAAC"}

package/dist/cli/invocations.js

@@ -1 +0,0 @@
-export {};

package/dist/cli/parse-errors.d.ts

@@ -1,17 +0,0 @@
-import type { CommanderError } from "commander";
-import type { CliNextAction, CliParseErrorPayload } from "../shared/types.js";
-export interface CommanderParseState {
-    stderrChunks: string[];
-    stdoutChunks: string[];
-}
-export interface ParseCliErrorResult {
-    nextActions: CliNextAction[];
-    payload: CliParseErrorPayload;
-}
-interface ParseCliErrorOptions {
-    includeDebug?: boolean;
-}
-export declare const createCommanderParseState: () => CommanderParseState;
-export declare const toParseCliError: (error: CommanderError, parseState: CommanderParseState, options?: ParseCliErrorOptions) => ParseCliErrorResult;
-export {};
-//# sourceMappingURL=parse-errors.d.ts.map

package/dist/cli/parse-errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse-errors.d.ts","sourceRoot":"","sources":["../../src/cli/parse-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAqB,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAGjG,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,UAAU,oBAAoB;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAsLD,eAAO,MAAM,yBAAyB,QAAO,mBAK5C,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,OAAO,cAAc,EACrB,YAAY,mBAAmB,EAC/B,UAAS,oBAAyB,KACjC,mBAwBF,CAAC"}