@ogment-ai/cli 0.3.5 → 0.4.1

package/dist/commands/auth.d.ts

@@ -0,0 +1,22 @@
+import type { Result as ResultType } from "better-result";
+import type { LoginPendingInfo, LoginError } from "../services/auth.js";
+import type { UnexpectedError } from "../shared/errors.js";
+import type { AuthStatusSuccess, LoginSuccess, LogoutSuccess } from "../shared/types.js";
+import type { CommandContext } from "./context.js";
+interface DeviceAuthLoginCommandOptions {
+    mode: "device";
+    onPending?: (info: LoginPendingInfo) => void;
+}
+interface BrowserAuthLoginCommandOptions {
+    mode: "browser";
+}
+interface ApiKeyAuthLoginCommandOptions {
+    apiKey: string;
+    mode: "apiKey";
+}
+export type AuthLoginCommandOptions = ApiKeyAuthLoginCommandOptions | BrowserAuthLoginCommandOptions | DeviceAuthLoginCommandOptions;
+export declare const runAuthLoginCommand: (context: CommandContext, options: AuthLoginCommandOptions) => Promise<ResultType<LoginSuccess, LoginError>>;
+export declare const runAuthStatusCommand: (context: CommandContext) => Promise<ResultType<AuthStatusSuccess, UnexpectedError>>;
+export declare const runAuthLogoutCommand: (context: CommandContext) => Promise<ResultType<LogoutSuccess, UnexpectedError>>;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,UAAU,6BAA6B;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC9C;AAED,UAAU,8BAA8B;IACtC,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,UAAU,6BAA6B;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,MAAM,uBAAuB,GAC/B,6BAA6B,GAC7B,8BAA8B,GAC9B,6BAA6B,CAAC;AAElC,eAAO,MAAM,mBAAmB,GAC9B,SAAS,cAAc,EACvB,SAAS,uBAAuB,KAC/B,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,CAyB9C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,cAAc,KACtB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAExD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,SAAS,cAAc,KACtB,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,eAAe,CAAC,CAEpD,CAAC"}

package/dist/commands/auth.js

@@ -0,0 +1,29 @@
+export const runAuthLoginCommand = async (context, options) => {
+    const loginOptions = (() => {
+        if (options.mode === "apiKey") {
+            return {
+                apiKey: options.apiKey,
+                mode: "apiKey",
+                nonInteractive: context.output.nonInteractive,
+            };
+        }
+        if (options.mode === "browser") {
+            return {
+                mode: "browser",
+                nonInteractive: context.output.nonInteractive,
+            };
+        }
+        return {
+            mode: "device",
+            nonInteractive: context.output.nonInteractive,
+            ...(options.onPending === undefined ? {} : { onPending: options.onPending }),
+        };
+    })();
+    return context.services.auth.login(loginOptions);
+};
+export const runAuthStatusCommand = async (context) => {
+    return context.services.auth.status(context.apiKeyOverride);
+};
+export const runAuthLogoutCommand = async (context) => {
+    return context.services.auth.logout();
+};

package/dist/commands/catalog.d.ts

@@ -0,0 +1,29 @@
+import type { Result as ResultType } from "better-result";
+import type { McpServiceError } from "../services/mcp.js";
+import { NotFoundError, ValidationError } from "../shared/errors.js";
+import type { CatalogSummarySuccess, CatalogToolDetailsSuccess, CatalogToolsSuccess } from "../shared/types.js";
+import type { CommandContext } from "./context.js";
+import { type ResolveServerStateError } from "./server-context.js";
+export interface CatalogCommandOptions {
+    cursor?: string | undefined;
+    limit?: number | undefined;
+    serverId?: string | undefined;
+}
+export interface CatalogToolsCommandOptions {
+    serverId: string;
+}
+export interface CatalogToolDetailsCommandOptions {
+    serverId: string;
+    toolName: string;
+}
+export interface CatalogSummaryPage {
+    nextCursor: string | null;
+    servers: CatalogSummarySuccess["servers"];
+}
+export type CatalogCommandError = McpServiceError | NotFoundError | ResolveServerStateError | ValidationError;
+export type CatalogToolsCommandError = McpServiceError | NotFoundError | ResolveServerStateError;
+export type CatalogToolDetailsCommandError = McpServiceError | NotFoundError | ResolveServerStateError;
+export declare const runCatalogCommand: (context: CommandContext, options: CatalogCommandOptions) => Promise<ResultType<CatalogSummaryPage, CatalogCommandError>>;
+export declare const runCatalogToolsCommand: (context: CommandContext, options: CatalogToolsCommandOptions) => Promise<ResultType<CatalogToolsSuccess, CatalogToolsCommandError>>;
+export declare const runCatalogToolDetailsCommand: (context: CommandContext, options: CatalogToolDetailsCommandOptions) => Promise<ResultType<CatalogToolDetailsSuccess, CatalogToolDetailsCommandError>>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/commands/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/commands/catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAEV,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AA2B7B,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,aAAa,GACb,uBAAuB,GACvB,eAAe,CAAC;AAEpB,MAAM,MAAM,wBAAwB,GAAG,eAAe,GAAG,aAAa,GAAG,uBAAuB,CAAC;AAEjG,MAAM,MAAM,8BAA8B,GACtC,eAAe,GACf,aAAa,GACb,uBAAuB,CAAC;AAiD5B,eAAO,MAAM,iBAAiB,GAC5B,SAAS,cAAc,EACvB,SAAS,qBAAqB,KAC7B,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAqE7D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,SAAS,cAAc,EACvB,SAAS,0BAA0B,KAClC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,CAoBnE,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,SAAS,cAAc,EACvB,SAAS,gCAAgC,KACxC,OAAO,CAAC,UAAU,CAAC,yBAAyB,EAAE,8BAA8B,CAAC,CAiC/E,CAAC"}

package/dist/commands/catalog.js

@@ -0,0 +1,151 @@
+import { Result } from "better-result";
+import { ERROR_CODE } from "../shared/error-codes.js";
+import { NotFoundError, ValidationError } from "../shared/errors.js";
+import { findServerByPath, resolveServerState, } from "./server-context.js";
+const toServerSummary = (server, toolCount) => {
+    return {
+        capabilities: [],
+        description: server.description,
+        name: server.name,
+        orgSlug: server.orgSlug,
+        serverId: server.path,
+        toolCount,
+        version: null,
+    };
+};
+const toToolSummaries = (tools) => {
+    return tools.map((tool) => {
+        return {
+            description: tool.description,
+            inputSchemaRef: tool.inputSchema["$id"] ?? null,
+            name: tool.name,
+        };
+    });
+};
+const listServerTools = async (context, apiKey, server) => {
+    return context.services.mcp.listTools({
+        orgSlug: server.orgSlug,
+        serverPath: server.path,
+    }, apiKey);
+};
+const TOOL_COUNT_CONCURRENCY = 4;
+const mapWithConcurrency = async (items, concurrency, mapItem) => {
+    if (items.length === 0) {
+        return [];
+    }
+    const results = Array.from({ length: items.length });
+    let nextIndex = 0;
+    const worker = async () => {
+        while (true) {
+            const currentIndex = nextIndex;
+            nextIndex += 1;
+            if (currentIndex >= items.length) {
+                return;
+            }
+            results[currentIndex] = await mapItem(items[currentIndex], currentIndex);
+        }
+    };
+    const workerCount = Math.min(concurrency, items.length);
+    await Promise.all(Array.from({ length: workerCount }, async () => worker()));
+    return results;
+};
+export const runCatalogCommand = async (context, options) => {
+    const stateResult = await resolveServerState(context);
+    if (Result.isError(stateResult)) {
+        return stateResult;
+    }
+    let targetServers = stateResult.value.servers;
+    if (options.serverId !== undefined) {
+        const serverResult = findServerByPath(stateResult.value.servers, options.serverId);
+        if (Result.isError(serverResult)) {
+            return serverResult;
+        }
+        targetServers = [serverResult.value];
+    }
+    const serverSummaries = await mapWithConcurrency(targetServers, TOOL_COUNT_CONCURRENCY, async (server) => {
+        const toolsResult = await listServerTools(context, stateResult.value.apiKey, server);
+        return {
+            server,
+            toolsResult,
+        };
+    });
+    const summaries = [];
+    for (const serverSummary of serverSummaries) {
+        if (Result.isError(serverSummary.toolsResult)) {
+            return serverSummary.toolsResult;
+        }
+        summaries.push(toServerSummary(serverSummary.server, serverSummary.toolsResult.value.length));
+    }
+    if (options.serverId !== undefined) {
+        return Result.ok({
+            nextCursor: null,
+            servers: summaries,
+        });
+    }
+    const limit = Math.max(1, options.limit ?? 20);
+    let startIndex = 0;
+    if (options.cursor !== undefined) {
+        const cursorIndex = summaries.findIndex((server) => server.serverId === options.cursor);
+        if (cursorIndex === -1) {
+            return Result.err(new ValidationError({
+                code: ERROR_CODE.validationInvalidInput,
+                message: `Invalid --cursor value: "${options.cursor}"`,
+                suggestedCommand: "ogment catalog",
+            }));
+        }
+        startIndex = cursorIndex + 1;
+    }
+    const servers = summaries.slice(startIndex, startIndex + limit);
+    const hasMore = startIndex + limit < summaries.length;
+    const nextCursor = hasMore ? (servers.at(-1)?.serverId ?? null) : null;
+    return Result.ok({
+        nextCursor,
+        servers,
+    });
+};
+export const runCatalogToolsCommand = async (context, options) => {
+    const stateResult = await resolveServerState(context);
+    if (Result.isError(stateResult)) {
+        return stateResult;
+    }
+    const serverResult = findServerByPath(stateResult.value.servers, options.serverId);
+    if (Result.isError(serverResult)) {
+        return serverResult;
+    }
+    const toolsResult = await listServerTools(context, stateResult.value.apiKey, serverResult.value);
+    if (Result.isError(toolsResult)) {
+        return toolsResult;
+    }
+    return Result.ok({
+        server: toServerSummary(serverResult.value, toolsResult.value.length),
+        tools: toToolSummaries(toolsResult.value),
+    });
+};
+export const runCatalogToolDetailsCommand = async (context, options) => {
+    const stateResult = await resolveServerState(context);
+    if (Result.isError(stateResult)) {
+        return stateResult;
+    }
+    const serverResult = findServerByPath(stateResult.value.servers, options.serverId);
+    if (Result.isError(serverResult)) {
+        return serverResult;
+    }
+    const toolsResult = await listServerTools(context, stateResult.value.apiKey, serverResult.value);
+    if (Result.isError(toolsResult)) {
+        return toolsResult;
+    }
+    const tool = toolsResult.value.find((item) => item.name === options.toolName);
+    if (tool === undefined) {
+        return Result.err(new NotFoundError({
+            message: `Tool "${options.toolName}" not found`,
+            resource: options.toolName,
+        }));
+    }
+    return Result.ok({
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        name: tool.name,
+        outputSchema: tool.outputSchema ?? null,
+        server: toServerSummary(serverResult.value, toolsResult.value.length),
+    });
+};

package/dist/commands/invoke.d.ts

@@ -0,0 +1,17 @@
+import type { Result as ResultType } from "better-result";
+import type { McpServiceError } from "../services/mcp.js";
+import { NotFoundError, UnexpectedError, ValidationError } from "../shared/errors.js";
+import type { InvokeSuccess } from "../shared/types.js";
+import type { CommandContext } from "./context.js";
+import { type ResolveServerStateError } from "./server-context.js";
+export interface InvokeCommandOptions {
+    input: string | undefined;
+    target: string;
+}
+interface InvokeCommandDeps {
+    readStdin?: () => Promise<ResultType<string, UnexpectedError>>;
+}
+export type InvokeCommandError = McpServiceError | NotFoundError | ResolveServerStateError | UnexpectedError | ValidationError;
+export declare const runInvokeCommand: (context: CommandContext, options: InvokeCommandOptions, deps?: InvokeCommandDeps) => Promise<ResultType<InvokeSuccess, InvokeCommandError>>;
+export {};
+//# sourceMappingURL=invoke.d.ts.map

package/dist/commands/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/commands/invoke.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;CAChE;AAED,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,aAAa,GACb,uBAAuB,GACvB,eAAe,GACf,eAAe,CAAC;AAgIpB,eAAO,MAAM,gBAAgB,GAC3B,SAAS,cAAc,EACvB,SAAS,oBAAoB,EAC7B,OAAM,iBAAsB,KAC3B,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAwCvD,CAAC"}

package/dist/commands/invoke.js

@@ -0,0 +1,123 @@
+import { readFile } from "node:fs/promises";
+import { Result } from "better-result";
+import { NotFoundError, UnexpectedError, ValidationError } from "../shared/errors.js";
+import { findServerByPath, resolveServerState, } from "./server-context.js";
+const parseTarget = (target) => {
+    const separatorIndex = target.lastIndexOf("/");
+    if (separatorIndex <= 0 || separatorIndex >= target.length - 1) {
+        return Result.err(new ValidationError({
+            details: target,
+            message: "Invoke target must be in format <server-id>/<tool-name>",
+        }));
+    }
+    const serverId = target.slice(0, separatorIndex);
+    const toolName = target.slice(separatorIndex + 1);
+    return Result.ok({
+        serverId,
+        toolName,
+    });
+};
+const parseInputObject = (raw, context) => {
+    const parsed = Result.try({
+        catch: () => new ValidationError({
+            details: raw,
+            message: `Invalid JSON in ${context}`,
+        }),
+        try: () => JSON.parse(raw),
+    });
+    if (Result.isError(parsed)) {
+        return parsed;
+    }
+    if (typeof parsed.value !== "object" || parsed.value === null || Array.isArray(parsed.value)) {
+        return Result.err(new ValidationError({
+            message: "Invoke input must be a JSON object",
+        }));
+    }
+    return Result.ok(parsed.value);
+};
+const readStdin = async () => {
+    return Result.tryPromise({
+        catch: (cause) => new UnexpectedError({
+            cause,
+            message: "Failed to read stdin",
+        }),
+        try: async () => {
+            return new Promise((resolve, reject) => {
+                let data = "";
+                process.stdin.setEncoding("utf8");
+                process.stdin.on("data", (chunk) => {
+                    data += chunk.toString();
+                });
+                process.stdin.on("end", () => {
+                    resolve(data);
+                });
+                process.stdin.on("error", (error) => {
+                    reject(error);
+                });
+            });
+        },
+    });
+};
+const parseInvokeArgs = async (options, deps) => {
+    if (options.input === undefined) {
+        return Result.ok({});
+    }
+    if (options.input === "-") {
+        const stdinResult = await (deps.readStdin ?? readStdin)();
+        if (Result.isError(stdinResult)) {
+            return stdinResult;
+        }
+        return parseInputObject(stdinResult.value, "--input (-)");
+    }
+    if (options.input.startsWith("@")) {
+        const inputFile = options.input.slice(1);
+        if (inputFile.length === 0) {
+            return Result.err(new ValidationError({
+                details: options.input,
+                message: "Invalid --input value. Use @<path>, -, or an inline JSON object.",
+            }));
+        }
+        const fileReadResult = await Result.tryPromise({
+            catch: (cause) => new UnexpectedError({
+                cause,
+                message: `Failed to read input file: ${inputFile}`,
+            }),
+            try: async () => readFile(inputFile, "utf8"),
+        });
+        if (Result.isError(fileReadResult)) {
+            return fileReadResult;
+        }
+        return parseInputObject(fileReadResult.value, "--input (@file)");
+    }
+    return parseInputObject(options.input, "--input");
+};
+export const runInvokeCommand = async (context, options, deps = {}) => {
+    const targetResult = parseTarget(options.target);
+    if (Result.isError(targetResult)) {
+        return targetResult;
+    }
+    const argsResult = await parseInvokeArgs(options, deps);
+    if (Result.isError(argsResult)) {
+        return argsResult;
+    }
+    const stateResult = await resolveServerState(context);
+    if (Result.isError(stateResult)) {
+        return stateResult;
+    }
+    const serverResult = findServerByPath(stateResult.value.servers, targetResult.value.serverId);
+    if (Result.isError(serverResult)) {
+        return serverResult;
+    }
+    const callResult = await context.services.mcp.callTool({
+        orgSlug: serverResult.value.orgSlug,
+        serverPath: serverResult.value.path,
+    }, stateResult.value.apiKey, targetResult.value.toolName, argsResult.value);
+    if (Result.isError(callResult)) {
+        return callResult;
+    }
+    return Result.ok({
+        result: callResult.value.structuredContent,
+        serverId: targetResult.value.serverId,
+        toolName: targetResult.value.toolName,
+    });
+};

package/dist/commands/{info.d.ts → status.d.ts}

@@ -1,12 +1,12 @@
 import type { Result as ResultType } from "better-result";
 import type { InfoService } from "../services/info.js";
 import type { InfoPayload } from "../shared/types.js";
-export interface InfoCommandOptions {
+export interface StatusCommandOptions {
     apiKeyOverride: string | undefined;
 }
-interface RunInfoCommandDeps {
+interface RunStatusCommandDeps {
     infoService: InfoService;
 }
-export declare const runInfoCommand: (options: InfoCommandOptions, deps: RunInfoCommandDeps) => Promise<ResultType<InfoPayload, never>>;
+export declare const runStatusCommand: (options: StatusCommandOptions, deps: RunStatusCommandDeps) => Promise<ResultType<InfoPayload, never>>;
 export {};
-//# sourceMappingURL=info.d.ts.map
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,UAAU,oBAAoB;IAC5B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,eAAO,MAAM,gBAAgB,GAC3B,SAAS,oBAAoB,EAC7B,MAAM,oBAAoB,KACzB,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAGxC,CAAC"}

package/dist/commands/{info.js → status.js}

@@ -1,5 +1,5 @@
 import { Result } from "better-result";
-export const runInfoCommand = async (options, deps) => {
+export const runStatusCommand = async (options, deps) => {
     const payload = await deps.infoService.collect(options.apiKeyOverride);
     return Result.ok(payload);
 };

package/dist/output/envelope.d.ts

@@ -0,0 +1,19 @@
+import type { AppError } from "../shared/errors.js";
+import { type CliErrorEnvelope, type CliNextAction, type CliPaginationMeta, type CliSuccessEnvelope } from "../shared/types.js";
+export interface EnvelopeContext {
+    command: string;
+    entity?: Record<string, unknown> | null;
+    nextActions?: CliNextAction[];
+    pagination?: CliPaginationMeta | null;
+}
+interface EnvelopeBuilderDeps {
+    createRequestId?: () => string;
+    now?: () => Date;
+}
+export interface EnvelopeBuilder {
+    error: (error: AppError, context: EnvelopeContext) => CliErrorEnvelope;
+    success: <T>(data: T, context: EnvelopeContext) => CliSuccessEnvelope<T>;
+}
+export declare const createEnvelopeBuilder: (deps?: EnvelopeBuilderDeps) => EnvelopeBuilder;
+export {};
+//# sourceMappingURL=envelope.d.ts.map

package/dist/output/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/output/envelope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACvC;AAED,UAAU,mBAAmB;IAC3B,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,KAAK,gBAAgB,CAAC;IACvE,OAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,KAAK,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAC1E;AAED,eAAO,MAAM,qBAAqB,GAAI,OAAM,mBAAwB,KAAG,eAkDtE,CAAC"}

package/dist/output/envelope.js

@@ -0,0 +1,51 @@
+import { randomUUID } from "node:crypto";
+import { appErrorMeta, formatAppError } from "../shared/errors.js";
+import { CLI_CONTRACT_VERSION, } from "../shared/types.js";
+export const createEnvelopeBuilder = (deps = {}) => {
+    const createRequestId = deps.createRequestId ?? randomUUID;
+    const now = deps.now ?? (() => new Date());
+    const toMeta = (context) => {
+        return {
+            command: context.command,
+            entity: context.entity ?? null,
+            pagination: context.pagination ?? null,
+            requestId: createRequestId(),
+            timestamp: now().toISOString(),
+        };
+    };
+    return {
+        error: (error, context) => {
+            const meta = appErrorMeta(error);
+            return {
+                data: null,
+                error: {
+                    category: meta.category,
+                    code: meta.code,
+                    detail: formatAppError(error),
+                    diagnostics: {
+                        tag: error._tag,
+                    },
+                    docsUrl: null,
+                    retryAfterMs: null,
+                    retryable: meta.retryable,
+                    suggestedCommand: meta.suggestedCommand ?? null,
+                    title: error.message,
+                },
+                meta: toMeta(context),
+                next_actions: context.nextActions ?? [],
+                ok: false,
+                version: CLI_CONTRACT_VERSION,
+            };
+        },
+        success: (data, context) => {
+            return {
+                data,
+                error: null,
+                meta: toMeta(context),
+                next_actions: context.nextActions ?? [],
+                ok: true,
+                version: CLI_CONTRACT_VERSION,
+            };
+        },
+    };
+};

package/dist/output/manager.d.ts

@@ -1,7 +1,9 @@
 import type { AppError } from "../shared/errors.js";
+import type { CliErrorEnvelope, CliNextAction, CliPaginationMeta } from "../shared/types.js";
 export type OutputMode = "human" | "json" | "quiet";
 export interface OutputInitOptions {
-    json: boolean | undefined;
+    human: boolean | undefined;
+    json?: boolean | undefined;
     nonInteractive: boolean | undefined;
     quiet: boolean | undefined;
     yes: boolean | undefined;
@@ -10,21 +12,32 @@ interface WritableLike {
     write(chunk: string): boolean;
 }
 interface OutputManagerDeps {
+    createRequestId?: () => string;
     isTty?: boolean;
     noColor?: boolean;
+    now?: () => Date;
     stderr?: WritableLike;
     stdout?: WritableLike;
 }
+interface EnvelopeOptions {
+    command: string;
+    entity?: Record<string, unknown> | null;
+    nextActions?: CliNextAction[];
+    pagination?: CliPaginationMeta | null;
+}
+interface SuccessOptions extends EnvelopeOptions {
+    humanMessage?: string;
+}
 export declare class OutputManager {
     #private;
     constructor(deps?: OutputManagerDeps);
     configure(options: OutputInitOptions): void;
     get mode(): OutputMode;
     get nonInteractive(): boolean;
-    error(error: AppError): void;
+    error(error: AppError, options: EnvelopeOptions): CliErrorEnvelope;
     info(message: string): void;
     json(value: unknown): void;
-    success(data: unknown, humanMessage?: string): void;
+    success<T>(data: T, options: SuccessOptions): void;
 }
 export {};
 //# sourceMappingURL=manager.d.ts.map

package/dist/output/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/output/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,GAAG,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1B;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,UAAU,iBAAiB;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAMD,qBAAa,aAAa;;gBAOL,IAAI,GAAE,iBAAsB;IASxC,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAWlD,IAAW,IAAI,IAAI,UAAU,CAE5B;IAED,IAAW,cAAc,IAAI,OAAO,CAEnC;IAEM,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAsB5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ3B,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI1B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;CAwB3D"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/output/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG7F,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,GAAG,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1B;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,UAAU,iBAAiB;IACzB,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACvC;AAED,UAAU,cAAe,SAAQ,eAAe;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,qBAAa,aAAa;;gBAQL,IAAI,GAAE,iBAAsB;IAWxC,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAalD,IAAW,IAAI,IAAI,UAAU,CAE5B;IAED,IAAW,cAAc,IAAI,OAAO,CAEnC;IAEM,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,GAAG,gBAAgB;IAgBlE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ3B,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI1B,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;CAmB1D"}

package/dist/output/manager.js

@@ -1,7 +1,9 @@
+import { createEnvelopeBuilder } from "./envelope.js";
 const toJson = (value) => {
     return `${JSON.stringify(value, null, 2)}\n`;
 };
 export class OutputManager {
+    #envelopeBuilder;
     #isTty;
     #mode;
     #nonInteractive = false;
@@ -11,16 +13,22 @@ export class OutputManager {
         this.#isTty = deps.isTty ?? Boolean(process.stdout.isTTY);
         this.#stderr = deps.stderr ?? process.stderr;
         this.#stdout = deps.stdout ?? process.stdout;
-        const colorDisabled = deps.noColor ?? process.env["NO_COLOR"] !== undefined;
-        this.#mode = this.#isTty && !colorDisabled ? "human" : "quiet";
+        this.#mode = "json";
+        this.#envelopeBuilder = createEnvelopeBuilder({
+            ...(deps.createRequestId === undefined ? {} : { createRequestId: deps.createRequestId }),
+            ...(deps.now === undefined ? {} : { now: deps.now }),
+        });
     }
     configure(options) {
-        if (options.json === true) {
-            this.#mode = "json";
-        }
-        else if (options.quiet === true) {
+        if (options.quiet === true) {
             this.#mode = "quiet";
         }
+        else if (options.human === true && options.json !== true) {
+            this.#mode = "human";
+        }
+        else {
+            this.#mode = "json";
+        }
         this.#nonInteractive =
             options.nonInteractive === true || options.yes === true || this.#isTty === false;
     }
@@ -30,23 +38,17 @@ export class OutputManager {
     get nonInteractive() {
         return this.#nonInteractive;
     }
-    error(error) {
-        const payload = {
-            error: {
-                details: "details" in error ? error.details : undefined,
-                message: error.message,
-                type: error._tag,
-            },
-            status: "error",
-        };
+    error(error, options) {
+        const envelope = this.#envelopeBuilder.error(error, options);
         if (this.#mode === "json") {
-            this.#stdout.write(toJson(payload));
-            return;
+            this.#stdout.write(toJson(envelope));
+            return envelope;
         }
         if (this.#mode === "quiet") {
-            return;
+            return envelope;
         }
-        this.#stderr.write(`${error.message}\n`);
+        this.#stderr.write(`${envelope.error.code}: ${envelope.error.detail}\n`);
+        return envelope;
     }
     info(message) {
         if (this.#mode !== "human") {
@@ -57,23 +59,19 @@ export class OutputManager {
     json(value) {
         this.#stdout.write(toJson(value));
     }
-    success(data, humanMessage) {
+    success(data, options) {
+        const envelope = this.#envelopeBuilder.success(data, options);
         if (this.#mode === "json") {
-            this.#stdout.write(toJson({
-                data,
-                status: "success",
-            }));
+            this.#stdout.write(toJson(envelope));
             return;
         }
         if (this.#mode === "quiet") {
             return;
         }
-        if (typeof humanMessage === "string" && humanMessage.length > 0) {
-            this.#stdout.write(`${humanMessage}\n`);
+        if (typeof options.humanMessage === "string" && options.humanMessage.length > 0) {
+            this.#stdout.write(`${options.humanMessage}\n`);
             return;
         }
-        if (typeof data === "string" && data.length > 0) {
-            this.#stdout.write(`${data}\n`);
-        }
+        this.#stdout.write(toJson(data));
     }
 }

package/dist/services/account.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/services/account.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG1F,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACrF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACtF;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;CACxB;AAQD,eAAO,MAAM,oBAAoB,GAAI,MAAM,kBAAkB,KAAG,cAyE/D,CAAC"}
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/services/account.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI1F,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACrF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACtF;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;CACxB;AAQD,eAAO,MAAM,oBAAoB,GAAI,MAAM,kBAAkB,KAAG,cA8F/D,CAAC"}