@tiangong-ai/cli 0.0.13 → 0.0.15

package/dist/edge-search.d.ts

@@ -0,0 +1,54 @@
+import { type FetchLike } from "./http.js";
+export declare const DEFAULT_EDGE_SEARCH_API_BASE_URL = "https://qyyqlnwqwgvzxnccnbgm.supabase.co/functions/v1";
+export type EdgeSearchAuthStrategy = "apiKey" | "bearerOrApiKey";
+export type EdgeSearchSourceSpec = {
+    endpoint: string;
+    includeRegion: boolean;
+    authStrategy: EdgeSearchAuthStrategy;
+};
+export interface EdgeSearchSourceConfig<SourceId extends string> {
+    source: SourceId;
+    url: string;
+    apiKey: string;
+    bearerToken?: string | undefined;
+    region: string;
+    authStrategy: EdgeSearchAuthStrategy;
+    includeRegion: boolean;
+}
+export interface EdgeSearchRequestPlan<SourceId extends string> {
+    source: SourceId;
+    request: {
+        method: "POST";
+        url: string;
+        headers: Record<string, string>;
+        inputPath?: string | undefined;
+        body: unknown;
+        timeoutMs: number;
+    };
+}
+export interface EdgeSearchDryRunResult<SourceId extends string> {
+    dryRun: true;
+    requests: Array<EdgeSearchRequestPlan<SourceId>>;
+}
+export interface EdgeSearchResponse<SourceId extends string> {
+    source: SourceId;
+    response: unknown;
+}
+export interface EdgeSearchRunResult<SourceId extends string> {
+    dryRun: false;
+    responses: Array<EdgeSearchResponse<SourceId>>;
+}
+export type EdgeSearchResult<SourceId extends string> = EdgeSearchDryRunResult<SourceId> | EdgeSearchRunResult<SourceId>;
+export declare function deriveSupabaseProjectBaseUrl(apiBaseUrl: string): string;
+export declare function deriveSupabaseRestBaseUrl(apiBaseUrl: string): string;
+export declare const deriveSupabaseFunctionsBaseUrl: (apiBaseUrl: string) => string;
+export declare function edgeFunctionUrl(apiBaseUrl: string, endpoint: string): string;
+export declare function runEdgeSearch<SourceId extends string>(input: {
+    body: unknown;
+    inputPath?: string | undefined;
+    sources: Array<EdgeSearchSourceConfig<SourceId>>;
+    timeoutMs: number;
+    dryRun: boolean;
+    missingCredentialHelp: string;
+    fetchImpl?: FetchLike | undefined;
+}): Promise<EdgeSearchResult<SourceId>>;

package/dist/edge-search.js

@@ -0,0 +1,108 @@
+import { CliError } from "./errors.js";
+import { postJson } from "./http.js";
+export const DEFAULT_EDGE_SEARCH_API_BASE_URL = "https://qyyqlnwqwgvzxnccnbgm.supabase.co/functions/v1";
+function normalizeBaseUrl(apiBaseUrl) {
+    const normalized = apiBaseUrl.trim().replace(/\/+$/u, "");
+    if (!normalized) {
+        throw new CliError("Cannot derive Supabase URLs from an empty API base URL.", {
+            code: "EDGE_SEARCH_API_BASE_URL_INVALID",
+            exitCode: 2,
+        });
+    }
+    return normalized;
+}
+export function deriveSupabaseProjectBaseUrl(apiBaseUrl) {
+    const normalized = normalizeBaseUrl(apiBaseUrl);
+    if (normalized.endsWith("/functions/v1")) {
+        return normalized.replace(/\/functions\/v1$/u, "");
+    }
+    if (normalized.endsWith("/rest/v1")) {
+        return normalized.replace(/\/rest\/v1$/u, "");
+    }
+    if (/^https?:\/\/[^/]+$/u.test(normalized)) {
+        return normalized;
+    }
+    throw new CliError("Cannot derive a Supabase project base URL from TIANGONG_AI_API_BASE_URL. Use a Supabase project base URL, a /functions/v1 base URL, or a /rest/v1 base URL.", {
+        code: "EDGE_SEARCH_API_BASE_URL_INVALID",
+        exitCode: 2,
+        details: normalized,
+    });
+}
+export function deriveSupabaseRestBaseUrl(apiBaseUrl) {
+    return `${deriveSupabaseProjectBaseUrl(apiBaseUrl)}/rest/v1`;
+}
+export const deriveSupabaseFunctionsBaseUrl = (apiBaseUrl) => `${deriveSupabaseProjectBaseUrl(apiBaseUrl)}/functions/v1`;
+export function edgeFunctionUrl(apiBaseUrl, endpoint) {
+    return `${deriveSupabaseFunctionsBaseUrl(apiBaseUrl)}/${endpoint.replace(/^\/+/u, "")}`;
+}
+export async function runEdgeSearch(input) {
+    const plans = input.sources.map((source) => edgeSearchRequestPlan({
+        source,
+        body: input.body,
+        inputPath: input.inputPath,
+        timeoutMs: input.timeoutMs,
+        masked: input.dryRun,
+        missingCredentialHelp: input.missingCredentialHelp,
+    }));
+    if (input.dryRun) {
+        return { dryRun: true, requests: plans };
+    }
+    const responses = [];
+    for (const plan of plans) {
+        responses.push({
+            source: plan.source,
+            response: await postJson({
+                url: plan.request.url,
+                headers: plan.request.headers,
+                body: plan.request.body,
+                timeoutMs: input.timeoutMs,
+                fetchImpl: input.fetchImpl ?? fetch,
+            }),
+        });
+    }
+    return { dryRun: false, responses };
+}
+function edgeSearchRequestPlan(input) {
+    const headers = edgeSearchHeaders(input.source, input.masked, input.missingCredentialHelp);
+    return {
+        source: input.source.source,
+        request: {
+            method: "POST",
+            url: input.source.url,
+            headers,
+            ...(input.inputPath ? { inputPath: input.inputPath } : {}),
+            body: input.body,
+            timeoutMs: input.timeoutMs,
+        },
+    };
+}
+function edgeSearchHeaders(source, masked, missingCredentialHelp) {
+    if (source.authStrategy === "apiKey" && !source.apiKey) {
+        throw new CliError(`Missing ${source.source} search credentials. ${missingCredentialHelp}`, {
+            code: "EDGE_SEARCH_CREDENTIALS_REQUIRED",
+            exitCode: 2,
+            details: { source: source.source },
+        });
+    }
+    if (source.authStrategy === "bearerOrApiKey" && !source.apiKey && !source.bearerToken) {
+        throw new CliError(`Missing ${source.source} search credentials. ${missingCredentialHelp}`, {
+            code: "EDGE_SEARCH_CREDENTIALS_REQUIRED",
+            exitCode: 2,
+            details: { source: source.source },
+        });
+    }
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (source.includeRegion && source.region) {
+        headers["x-region"] = source.region;
+    }
+    if (source.authStrategy === "bearerOrApiKey" && source.bearerToken) {
+        headers.Authorization = `Bearer ${masked ? "****" : source.bearerToken}`;
+    }
+    else {
+        headers["x-api-key"] = masked ? "****" : source.apiKey;
+    }
+    return headers;
+}
+//# sourceMappingURL=edge-search.js.map

package/dist/edge-search.js.map

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

package/dist/education/commands.d.ts

@@ -0,0 +1,2 @@
+import type { CliIO } from "../io.js";
+export declare function runEducationCommand(argv: string[], io: CliIO): Promise<number>;

package/dist/education/commands.js

@@ -0,0 +1,144 @@
+import { runEdgeSearch } from "../edge-search.js";
+import { CliError } from "../errors.js";
+import { readJsonInput, stringifyJson, write } from "../io.js";
+import { parseStrictArgs, strictBoolean, strictString } from "../strict-args.js";
+import { educationSourceConfig, parseEducationSources, resolveEducationConfig } from "./config.js";
+const EDUCATION_SEARCH_OPTIONS = {
+    help: "boolean",
+    json: "boolean",
+    "dry-run": "boolean",
+    input: "string",
+    query: "string",
+    sources: "string",
+    "api-key": "string",
+    "api-base-url": "string",
+    "bearer-token": "string",
+    "course-api-key": "string",
+    "edu-api-key": "string",
+    "textbook-api-key": "string",
+    "course-url": "string",
+    "edu-url": "string",
+    "textbook-url": "string",
+    region: "string",
+    timeout: "string",
+    "top-k": "string",
+    "ext-k": "string",
+};
+export async function runEducationCommand(argv, io) {
+    const [subcommand, ...rest] = argv;
+    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+        write(io.stdout, educationHelp());
+        return 0;
+    }
+    if (subcommand === "search") {
+        return runEducationSearchCommand(rest, io);
+    }
+    write(io.stdout, educationHelp());
+    return 1;
+}
+function educationHelp() {
+    return `Tiangong education commands
+
+Usage:
+  tiangong-ai education search --input <request.json> [--sources default|all|course|edu|textbook] [--dry-run] [--json]
+  tiangong-ai education search --query <query> [--sources default|all|course|edu|textbook] [--dry-run] [--json]
+
+Education search options:
+  --input <file>
+    JSON request body to forward unchanged to each selected edge function.
+  --query <text>
+    Convenience mode; builds {"query": text} plus optional --top-k/--ext-k.
+  --sources <csv> (default course; all = course,edu,textbook)
+  --dry-run
+    Print the exact POST request plan with masked credentials.
+  --api-key <token> or TIANGONG_AI_APIKEY
+  --api-base-url <url>
+    Supabase project root, /functions/v1, or /rest/v1 base URL.
+  --bearer-token <token> for scoped course search
+  --course-api-key <token>, --edu-api-key <token>, --textbook-api-key <token>
+  --course-url <url>, --edu-url <url>, --textbook-url <url>
+  --region <name>
+  --timeout <seconds>
+  --top-k <n>
+  --ext-k <n>
+  --json
+`;
+}
+async function runEducationSearchCommand(argv, io) {
+    const args = parseStrictArgs(argv, EDUCATION_SEARCH_OPTIONS, "education search");
+    if (strictBoolean(args, "help")) {
+        write(io.stdout, educationHelp());
+        return 0;
+    }
+    if (args.positionals.length > 0) {
+        throw new CliError("education search does not accept positional arguments.", {
+            code: "INVALID_ARGS",
+            exitCode: 2,
+            details: { positionals: args.positionals },
+        });
+    }
+    const sourceIds = parseEducationSources(strictString(args, "sources"));
+    const config = resolveEducationConfig(args, io.env);
+    const inputPath = strictString(args, "input");
+    const body = educationRequestBody(args);
+    const result = await runEdgeSearch({
+        body,
+        inputPath,
+        sources: sourceIds.map((source) => ({ source, ...educationSourceConfig(config, source) })),
+        timeoutMs: config.timeoutSeconds * 1000,
+        dryRun: strictBoolean(args, "dry-run"),
+        missingCredentialHelp: "Provide --api-key, --bearer-token for course search, a source-specific API key option, or set TIANGONG_AI_APIKEY.",
+    });
+    writeSearchResult(io, result, strictBoolean(args, "json"));
+    return 0;
+}
+function educationRequestBody(args) {
+    const inputPath = strictString(args, "input");
+    if (inputPath) {
+        rejectInputModeBodyFlags(args, ["query", "top-k", "ext-k"]);
+        return readJsonInput(inputPath);
+    }
+    const query = strictString(args, "query");
+    if (!query) {
+        throw new CliError("Usage: tiangong-ai education search --input <file> or --query <query>", {
+            code: "EDUCATION_QUERY_REQUIRED",
+            exitCode: 2,
+        });
+    }
+    const body = { query };
+    const topK = optionalPositiveInteger(strictString(args, "top-k"), "--top-k");
+    const extK = optionalPositiveInteger(strictString(args, "ext-k"), "--ext-k");
+    if (topK !== undefined)
+        body.topK = topK;
+    if (extK !== undefined)
+        body.extK = extK;
+    return body;
+}
+function rejectInputModeBodyFlags(args, bodyFlagNames) {
+    const present = bodyFlagNames.filter((name) => args.flags.has(name));
+    if (present.length === 0)
+        return;
+    throw new CliError(`--input cannot be combined with body-building flags: ${present.join(", ")}`, {
+        code: "INVALID_ARGS",
+        exitCode: 2,
+        details: { flags: present },
+    });
+}
+function optionalPositiveInteger(value, label) {
+    if (!value)
+        return undefined;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new CliError(`${label} must be a positive integer.`, {
+            code: "INVALID_NUMERIC_OPTION",
+            exitCode: 2,
+            details: { label, value },
+        });
+    }
+    return parsed;
+}
+function writeSearchResult(io, result, compact) {
+    const output = !result.dryRun && result.responses.length === 1 ? result.responses[0]?.response : result;
+    write(io.stdout, stringifyJson(output, compact));
+}
+//# sourceMappingURL=commands.js.map

package/dist/education/commands.js.map

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

package/dist/education/config.d.ts

@@ -0,0 +1,24 @@
+import { type EdgeSearchAuthStrategy, type EdgeSearchSourceSpec } from "../edge-search.js";
+import { type StrictParsedArgs } from "../strict-args.js";
+import type { EducationSourceId } from "./types.js";
+export declare const DEFAULT_COURSE_SEARCH_ENDPOINT = "course_search";
+export declare const DEFAULT_EDU_SEARCH_ENDPOINT = "edu_search";
+export declare const DEFAULT_TEXTBOOK_SEARCH_ENDPOINT = "textbook_search";
+export declare const DEFAULT_EDUCATION_SOURCES: EducationSourceId[];
+export declare const ALL_EDUCATION_SOURCES: EducationSourceId[];
+export declare const EDUCATION_SEARCH_SOURCES: Record<EducationSourceId, EdgeSearchSourceSpec>;
+export interface EducationConfig {
+    timeoutSeconds: number;
+    sources: Record<EducationSourceId, EducationSourceConfig>;
+}
+export interface EducationSourceConfig {
+    url: string;
+    apiKey: string;
+    bearerToken: string | undefined;
+    region: string;
+    authStrategy: EdgeSearchAuthStrategy;
+    includeRegion: boolean;
+}
+export declare function resolveEducationConfig(args: StrictParsedArgs, env: NodeJS.ProcessEnv): EducationConfig;
+export declare function educationSourceConfig(config: EducationConfig, source: EducationSourceId): EducationSourceConfig;
+export declare function parseEducationSources(value: string | undefined): EducationSourceId[];

package/dist/education/config.js

@@ -0,0 +1,127 @@
+import { firstEnv } from "../env.js";
+import { DEFAULT_EDGE_SEARCH_API_BASE_URL, edgeFunctionUrl, } from "../edge-search.js";
+import { CliError } from "../errors.js";
+import { strictString } from "../strict-args.js";
+export const DEFAULT_COURSE_SEARCH_ENDPOINT = "course_search";
+export const DEFAULT_EDU_SEARCH_ENDPOINT = "edu_search";
+export const DEFAULT_TEXTBOOK_SEARCH_ENDPOINT = "textbook_search";
+export const DEFAULT_EDUCATION_SOURCES = ["course"];
+export const ALL_EDUCATION_SOURCES = ["course", "edu", "textbook"];
+export const EDUCATION_SEARCH_SOURCES = {
+    course: {
+        endpoint: DEFAULT_COURSE_SEARCH_ENDPOINT,
+        includeRegion: true,
+        authStrategy: "bearerOrApiKey",
+    },
+    edu: {
+        endpoint: DEFAULT_EDU_SEARCH_ENDPOINT,
+        includeRegion: true,
+        authStrategy: "apiKey",
+    },
+    textbook: {
+        endpoint: DEFAULT_TEXTBOOK_SEARCH_ENDPOINT,
+        includeRegion: true,
+        authStrategy: "apiKey",
+    },
+};
+export function resolveEducationConfig(args, env) {
+    const timeoutSeconds = getPositiveIntegerValue(strictString(args, "timeout") ?? firstEnv(env, "TIANGONG_EDUCATION_TIMEOUT"), 120, "--timeout");
+    const apiKey = strictString(args, "api-key") ?? firstEnv(env, "TIANGONG_AI_APIKEY") ?? "";
+    const bearerToken = strictString(args, "bearer-token") ??
+        firstEnv(env, "TIANGONG_EDUCATION_BEARER_TOKEN", "TIANGONG_KB_READ_TOKEN");
+    const apiBaseUrl = strictString(args, "api-base-url") ??
+        firstEnv(env, "TIANGONG_EDUCATION_API_BASE_URL", "TIANGONG_AI_SEARCH_API_BASE_URL", "TIANGONG_AI_API_BASE_URL") ??
+        DEFAULT_EDGE_SEARCH_API_BASE_URL;
+    const region = strictString(args, "region") ?? firstEnv(env, "TIANGONG_REGION") ?? "us-east-1";
+    return {
+        timeoutSeconds,
+        sources: {
+            course: {
+                url: strictString(args, "course-url") ??
+                    firstEnv(env, "TIANGONG_COURSE_SEARCH_URL") ??
+                    edgeFunctionUrl(apiBaseUrl, EDUCATION_SEARCH_SOURCES.course.endpoint),
+                apiKey: strictString(args, "course-api-key") ?? firstEnv(env, "TIANGONG_COURSE_APIKEY") ?? apiKey,
+                bearerToken,
+                region,
+                authStrategy: EDUCATION_SEARCH_SOURCES.course.authStrategy,
+                includeRegion: EDUCATION_SEARCH_SOURCES.course.includeRegion,
+            },
+            edu: {
+                url: strictString(args, "edu-url") ??
+                    firstEnv(env, "TIANGONG_EDU_SEARCH_URL") ??
+                    edgeFunctionUrl(apiBaseUrl, EDUCATION_SEARCH_SOURCES.edu.endpoint),
+                apiKey: strictString(args, "edu-api-key") ?? firstEnv(env, "TIANGONG_EDU_APIKEY") ?? apiKey,
+                bearerToken: undefined,
+                region,
+                authStrategy: EDUCATION_SEARCH_SOURCES.edu.authStrategy,
+                includeRegion: EDUCATION_SEARCH_SOURCES.edu.includeRegion,
+            },
+            textbook: {
+                url: strictString(args, "textbook-url") ??
+                    firstEnv(env, "TIANGONG_TEXTBOOK_SEARCH_URL") ??
+                    edgeFunctionUrl(apiBaseUrl, EDUCATION_SEARCH_SOURCES.textbook.endpoint),
+                apiKey: strictString(args, "textbook-api-key") ??
+                    firstEnv(env, "TIANGONG_TEXTBOOK_APIKEY") ??
+                    apiKey,
+                bearerToken: undefined,
+                region,
+                authStrategy: EDUCATION_SEARCH_SOURCES.textbook.authStrategy,
+                includeRegion: EDUCATION_SEARCH_SOURCES.textbook.includeRegion,
+            },
+        },
+    };
+}
+export function educationSourceConfig(config, source) {
+    return config.sources[source];
+}
+export function parseEducationSources(value) {
+    const rawSources = (value ?? "default")
+        .split(",")
+        .map((source) => source.trim())
+        .filter(Boolean);
+    const sources = rawSources.length ? rawSources : ["default"];
+    return uniqueSources(sources.flatMap((source) => {
+        if (source === "default")
+            return DEFAULT_EDUCATION_SOURCES;
+        if (source === "all")
+            return ALL_EDUCATION_SOURCES;
+        return [parseEducationSource(source)];
+    }));
+}
+function parseEducationSource(source) {
+    if (source === "course")
+        return source;
+    if (source === "edu")
+        return source;
+    if (source === "textbook")
+        return source;
+    throw new CliError(`Unsupported education source: ${source}`, {
+        code: "EDUCATION_SOURCE_UNSUPPORTED",
+        exitCode: 2,
+        details: { source },
+    });
+}
+function uniqueSources(sources) {
+    const seen = new Set();
+    const unique = [];
+    for (const source of sources) {
+        if (seen.has(source))
+            continue;
+        seen.add(source);
+        unique.push(source);
+    }
+    return unique;
+}
+function getPositiveIntegerValue(value, defaultValue, label) {
+    if (!value)
+        return defaultValue;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0)
+        throw new CliError(`${label} must be a positive integer.`, {
+            code: "INVALID_NUMERIC_OPTION",
+            exitCode: 2,
+            details: { label, value },
+        });
+    return parsed;
+}
+//# sourceMappingURL=config.js.map

package/dist/education/config.js.map

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

package/dist/education/types.d.ts

@@ -0,0 +1 @@
+export type EducationSourceId = "course" | "edu" | "textbook";

package/dist/education/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/education/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/education/types.ts"],"names":[],"mappings":""}

package/dist/env.d.ts

@@ -0,0 +1,2 @@
+export declare function loadDotenv(env: NodeJS.ProcessEnv): void;
+export declare function firstEnv(env: NodeJS.ProcessEnv, ...names: string[]): string | undefined;

package/dist/env.js

@@ -0,0 +1,42 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export function loadDotenv(env) {
+    const cwd = dirname(fileURLToPath(import.meta.url));
+    const candidates = [resolve(process.cwd(), ".env"), resolve(cwd, "../.env")];
+    for (const candidate of candidates) {
+        const content = readEnvFile(candidate);
+        if (!content)
+            continue;
+        for (const line of content.split(/\r?\n/)) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#") || !trimmed.includes("="))
+                continue;
+            const [rawKey, ...rawValue] = trimmed.replace(/^export\s+/, "").split("=");
+            const key = rawKey?.trim();
+            if (!key || env[key])
+                continue;
+            env[key] = rawValue
+                .join("=")
+                .trim()
+                .replace(/^["']|["']$/g, "");
+        }
+    }
+}
+export function firstEnv(env, ...names) {
+    for (const name of names) {
+        const value = env[name]?.trim();
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+function readEnvFile(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,UAAU,CAAC,GAAsB;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5E,MAAM,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3E,MAAM,GAAG,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ;iBAChB,IAAI,CAAC,GAAG,CAAC;iBACT,IAAI,EAAE;iBACN,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAsB,EAAE,GAAG,KAAe;IACjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;QAChC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,24 @@
+export declare class CliError extends Error {
+    readonly code: string;
+    readonly details: unknown;
+    readonly exitCode: number;
+    constructor(message: string, optionsOrExitCode?: {
+        code?: string;
+        details?: unknown;
+        exitCode?: number;
+    } | number);
+}
+export declare class HttpError extends CliError {
+    readonly status: number | undefined;
+    readonly retryAfterSeconds: number | undefined;
+    readonly retryable: boolean;
+    constructor(message: string, status: number | undefined, retryAfterSeconds: number | undefined, retryable: boolean);
+}
+export type ErrorPayload = {
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+};
+export declare function toErrorPayload(error: unknown): ErrorPayload;

package/dist/errors.js

@@ -0,0 +1,53 @@
+export class CliError extends Error {
+    code;
+    details;
+    exitCode;
+    constructor(message, optionsOrExitCode = {}) {
+        super(message);
+        this.name = "CliError";
+        const options = typeof optionsOrExitCode === "number" ? { exitCode: optionsOrExitCode } : optionsOrExitCode;
+        this.code = options.code ?? "CLI_ERROR";
+        this.details = options.details;
+        this.exitCode = options.exitCode ?? 1;
+    }
+}
+export class HttpError extends CliError {
+    status;
+    retryAfterSeconds;
+    retryable;
+    constructor(message, status, retryAfterSeconds, retryable) {
+        super(message, {
+            code: "HTTP_ERROR",
+            details: { status, retryAfterSeconds, retryable },
+        });
+        this.status = status;
+        this.retryAfterSeconds = retryAfterSeconds;
+        this.retryable = retryable;
+    }
+}
+export function toErrorPayload(error) {
+    if (error instanceof CliError) {
+        return {
+            error: {
+                code: error.code,
+                message: error.message,
+                ...(error.details === undefined ? {} : { details: error.details }),
+            },
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            error: {
+                code: "UNEXPECTED_ERROR",
+                message: error.message,
+            },
+        };
+    }
+    return {
+        error: {
+            code: "UNKNOWN_THROWN_VALUE",
+            message: String(error),
+        },
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAS;IACb,OAAO,CAAU;IACjB,QAAQ,CAAS;IAE1B,YACE,OAAe,EACf,oBAAsF,EAAE;QAExF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,MAAM,OAAO,GACX,OAAO,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAC9F,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,QAAQ;IAG1B;IACA;IACA;IAJX,YACE,OAAe,EACN,MAA0B,EAC1B,iBAAqC,EACrC,SAAkB;QAE3B,KAAK,CAAC,OAAO,EAAE;YACb,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE;SAClD,CAAC,CAAC;QAPM,WAAM,GAAN,MAAM,CAAoB;QAC1B,sBAAiB,GAAjB,iBAAiB,CAAoB;QACrC,cAAS,GAAT,SAAS,CAAS;IAM7B,CAAC;CACF;AAUD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;aACnE;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE;YACL,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;SACvB;KACF,CAAC;AACJ,CAAC"}