@tiangong-ai/cli 0.0.13 → 0.0.15

package/dist/research/commands.js

@@ -0,0 +1,147 @@
+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 { parseResearchSources, researchSourceConfig, resolveResearchConfig } from "./config.js";
+const RESEARCH_SEARCH_OPTIONS = {
+    help: "boolean",
+    json: "boolean",
+    "dry-run": "boolean",
+    input: "string",
+    query: "string",
+    claim: "string",
+    sources: "string",
+    "api-key": "string",
+    "api-base-url": "string",
+    "sci-api-key": "string",
+    "report-api-key": "string",
+    "patent-api-key": "string",
+    "sci-url": "string",
+    "report-url": "string",
+    "patent-url": "string",
+    region: "string",
+    timeout: "string",
+    "top-k": "string",
+    "ext-k": "string",
+    "get-meta": "boolean",
+};
+export async function runResearchCommand(argv, io) {
+    const [subcommand, ...rest] = argv;
+    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+        write(io.stdout, researchHelp());
+        return 0;
+    }
+    if (subcommand === "search") {
+        return runResearchSearchCommand(rest, io);
+    }
+    write(io.stdout, researchHelp());
+    return 1;
+}
+function researchHelp() {
+    return `Tiangong research commands
+
+Usage:
+  tiangong-ai research search --input <request.json> [--sources default|all|sci|report|patent] [--dry-run] [--json]
+  tiangong-ai research search --query <query> [--sources default|all|sci|report|patent] [--dry-run] [--json]
+
+Research 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/--get-meta.
+  --sources <csv> (default sci; all = sci,report,patent)
+  --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.
+  --sci-api-key <token>, --report-api-key <token>, --patent-api-key <token>
+  --sci-url <url>, --report-url <url>, --patent-url <url>
+  --region <name>
+  --timeout <seconds>
+  --top-k <n>
+  --ext-k <n>
+  --get-meta
+  --json
+`;
+}
+async function runResearchSearchCommand(argv, io) {
+    const args = parseStrictArgs(argv, RESEARCH_SEARCH_OPTIONS, "research search");
+    if (strictBoolean(args, "help")) {
+        write(io.stdout, researchHelp());
+        return 0;
+    }
+    if (args.positionals.length > 0) {
+        throw new CliError("research search does not accept positional arguments.", {
+            code: "INVALID_ARGS",
+            exitCode: 2,
+            details: { positionals: args.positionals },
+        });
+    }
+    const sourceIds = parseResearchSources(strictString(args, "sources"));
+    const config = resolveResearchConfig(args, io.env);
+    const inputPath = strictString(args, "input");
+    const body = researchRequestBody(args);
+    const result = await runEdgeSearch({
+        body,
+        inputPath,
+        sources: sourceIds.map((source) => ({ source, ...researchSourceConfig(config, source) })),
+        timeoutMs: config.timeoutSeconds * 1000,
+        dryRun: strictBoolean(args, "dry-run"),
+        missingCredentialHelp: "Provide --api-key, a source-specific API key option, or set TIANGONG_AI_APIKEY.",
+    });
+    writeSearchResult(io, result, strictBoolean(args, "json"));
+    return 0;
+}
+function researchRequestBody(args) {
+    const inputPath = strictString(args, "input");
+    if (inputPath) {
+        rejectInputModeBodyFlags(args, ["query", "claim", "top-k", "ext-k", "get-meta"]);
+        return readJsonInput(inputPath);
+    }
+    const query = strictString(args, "query") ?? strictString(args, "claim");
+    if (!query) {
+        throw new CliError("Usage: tiangong-ai research search --input <file> or --query <query>", {
+            code: "RESEARCH_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;
+    if (strictBoolean(args, "get-meta"))
+        body.getMeta = true;
+    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/research/commands.js.map

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

package/dist/research/config.d.ts

@@ -0,0 +1,23 @@
+import { type EdgeSearchAuthStrategy, type EdgeSearchSourceSpec } from "../edge-search.js";
+import { type StrictParsedArgs } from "../strict-args.js";
+import type { ResearchSourceId } from "./types.js";
+export declare const DEFAULT_SCI_SEARCH_ENDPOINT = "sci_search";
+export declare const DEFAULT_REPORT_SEARCH_ENDPOINT = "report_search";
+export declare const DEFAULT_PATENT_SEARCH_ENDPOINT = "patent_search";
+export declare const DEFAULT_RESEARCH_SOURCES: ResearchSourceId[];
+export declare const ALL_RESEARCH_SOURCES: ResearchSourceId[];
+export declare const RESEARCH_SEARCH_SOURCES: Record<ResearchSourceId, EdgeSearchSourceSpec>;
+export interface ResearchConfig {
+    timeoutSeconds: number;
+    sources: Record<ResearchSourceId, ResearchSourceConfig>;
+}
+export interface ResearchSourceConfig {
+    url: string;
+    apiKey: string;
+    region: string;
+    authStrategy: EdgeSearchAuthStrategy;
+    includeRegion: boolean;
+}
+export declare function resolveResearchConfig(args: StrictParsedArgs, env: NodeJS.ProcessEnv): ResearchConfig;
+export declare function researchSourceConfig(config: ResearchConfig, source: ResearchSourceId): ResearchSourceConfig;
+export declare function parseResearchSources(value: string | undefined): ResearchSourceId[];

package/dist/research/config.js

@@ -0,0 +1,120 @@
+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_SCI_SEARCH_ENDPOINT = "sci_search";
+export const DEFAULT_REPORT_SEARCH_ENDPOINT = "report_search";
+export const DEFAULT_PATENT_SEARCH_ENDPOINT = "patent_search";
+export const DEFAULT_RESEARCH_SOURCES = ["sci"];
+export const ALL_RESEARCH_SOURCES = ["sci", "report", "patent"];
+export const RESEARCH_SEARCH_SOURCES = {
+    sci: {
+        endpoint: DEFAULT_SCI_SEARCH_ENDPOINT,
+        includeRegion: true,
+        authStrategy: "apiKey",
+    },
+    report: {
+        endpoint: DEFAULT_REPORT_SEARCH_ENDPOINT,
+        includeRegion: true,
+        authStrategy: "apiKey",
+    },
+    patent: {
+        endpoint: DEFAULT_PATENT_SEARCH_ENDPOINT,
+        includeRegion: true,
+        authStrategy: "apiKey",
+    },
+};
+export function resolveResearchConfig(args, env) {
+    const timeoutSeconds = getPositiveIntegerValue(strictString(args, "timeout") ?? firstEnv(env, "TIANGONG_RESEARCH_TIMEOUT"), 120, "--timeout");
+    const apiKey = strictString(args, "api-key") ?? firstEnv(env, "TIANGONG_AI_APIKEY") ?? "";
+    const apiBaseUrl = strictString(args, "api-base-url") ??
+        firstEnv(env, "TIANGONG_RESEARCH_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: {
+            sci: {
+                url: strictString(args, "sci-url") ??
+                    firstEnv(env, "TIANGONG_SCI_SEARCH_URL") ??
+                    edgeFunctionUrl(apiBaseUrl, RESEARCH_SEARCH_SOURCES.sci.endpoint),
+                apiKey: strictString(args, "sci-api-key") ?? firstEnv(env, "TIANGONG_SCI_APIKEY") ?? apiKey ?? "",
+                region,
+                authStrategy: RESEARCH_SEARCH_SOURCES.sci.authStrategy,
+                includeRegion: RESEARCH_SEARCH_SOURCES.sci.includeRegion,
+            },
+            report: {
+                url: strictString(args, "report-url") ??
+                    firstEnv(env, "TIANGONG_REPORT_SEARCH_URL") ??
+                    edgeFunctionUrl(apiBaseUrl, RESEARCH_SEARCH_SOURCES.report.endpoint),
+                apiKey: strictString(args, "report-api-key") ?? firstEnv(env, "TIANGONG_REPORT_APIKEY") ?? apiKey,
+                region,
+                authStrategy: RESEARCH_SEARCH_SOURCES.report.authStrategy,
+                includeRegion: RESEARCH_SEARCH_SOURCES.report.includeRegion,
+            },
+            patent: {
+                url: strictString(args, "patent-url") ??
+                    firstEnv(env, "TIANGONG_PATENT_SEARCH_URL") ??
+                    edgeFunctionUrl(apiBaseUrl, RESEARCH_SEARCH_SOURCES.patent.endpoint),
+                apiKey: strictString(args, "patent-api-key") ?? firstEnv(env, "TIANGONG_PATENT_APIKEY") ?? apiKey,
+                region,
+                authStrategy: RESEARCH_SEARCH_SOURCES.patent.authStrategy,
+                includeRegion: RESEARCH_SEARCH_SOURCES.patent.includeRegion,
+            },
+        },
+    };
+}
+export function researchSourceConfig(config, source) {
+    return config.sources[source];
+}
+export function parseResearchSources(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_RESEARCH_SOURCES;
+        if (source === "all")
+            return ALL_RESEARCH_SOURCES;
+        return [parseResearchSource(source)];
+    }));
+}
+function parseResearchSource(source) {
+    if (source === "sci")
+        return source;
+    if (source === "report")
+        return source;
+    if (source === "patent")
+        return source;
+    throw new CliError(`Unsupported research source: ${source}`, {
+        code: "RESEARCH_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/research/config.js.map

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

package/dist/research/types.d.ts

@@ -0,0 +1 @@
+export type ResearchSourceId = "sci" | "report" | "patent";

package/dist/research/types.js

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

package/dist/research/types.js.map

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

package/dist/strict-args.d.ts

@@ -0,0 +1,8 @@
+export type StrictOptionType = "boolean" | "string";
+export interface StrictParsedArgs {
+    flags: Map<string, string | true>;
+    positionals: string[];
+}
+export declare function parseStrictArgs(argv: string[], options: Record<string, StrictOptionType>, commandName: string): StrictParsedArgs;
+export declare function strictString(args: StrictParsedArgs, name: string): string | undefined;
+export declare function strictBoolean(args: StrictParsedArgs, name: string): boolean;

package/dist/strict-args.js

@@ -0,0 +1,63 @@
+import { CliError } from "./errors.js";
+export function parseStrictArgs(argv, options, commandName) {
+    const flags = new Map();
+    const positionals = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (!arg)
+            continue;
+        if (!arg.startsWith("--")) {
+            positionals.push(arg);
+            continue;
+        }
+        const withoutPrefix = arg.slice(2);
+        const equalsIndex = withoutPrefix.indexOf("=");
+        const name = equalsIndex >= 0 ? withoutPrefix.slice(0, equalsIndex) : withoutPrefix;
+        const type = options[name];
+        if (!type) {
+            throw new CliError(`Unknown option for ${commandName}: --${name}`, {
+                code: "INVALID_ARGS",
+                exitCode: 2,
+                details: { option: name, command: commandName },
+            });
+        }
+        if (type === "boolean") {
+            if (equalsIndex >= 0) {
+                const value = withoutPrefix.slice(equalsIndex + 1);
+                if (value !== "true" && value !== "false") {
+                    throw new CliError(`Boolean option --${name} must be true or false.`, {
+                        code: "INVALID_ARGS",
+                        exitCode: 2,
+                        details: { option: name, value },
+                    });
+                }
+                if (value === "true")
+                    flags.set(name, true);
+            }
+            else {
+                flags.set(name, true);
+            }
+            continue;
+        }
+        const value = equalsIndex >= 0 ? withoutPrefix.slice(equalsIndex + 1) : argv[index + 1];
+        if (!value || value.startsWith("--")) {
+            throw new CliError(`Missing value for --${name}.`, {
+                code: "INVALID_ARGS",
+                exitCode: 2,
+                details: { option: name, command: commandName },
+            });
+        }
+        flags.set(name, value);
+        if (equalsIndex < 0)
+            index += 1;
+    }
+    return { flags, positionals };
+}
+export function strictString(args, name) {
+    const value = args.flags.get(name);
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+export function strictBoolean(args, name) {
+    return args.flags.get(name) === true;
+}
+//# sourceMappingURL=strict-args.js.map

package/dist/strict-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict-args.js","sourceRoot":"","sources":["../src/strict-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AASvC,MAAM,UAAU,eAAe,CAC7B,IAAc,EACd,OAAyC,EACzC,WAAmB;IAEnB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QACpF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,QAAQ,CAAC,sBAAsB,WAAW,OAAO,IAAI,EAAE,EAAE;gBACjE,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBACrB,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;gBACnD,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;oBAC1C,MAAM,IAAI,QAAQ,CAAC,oBAAoB,IAAI,yBAAyB,EAAE;wBACpE,IAAI,EAAE,cAAc;wBACpB,QAAQ,EAAE,CAAC;wBACX,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE;qBACjC,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,KAAK,KAAK,MAAM;oBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxB,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,QAAQ,CAAC,uBAAuB,IAAI,GAAG,EAAE;gBACjD,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvB,IAAI,WAAW,GAAG,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAsB,EAAE,IAAY;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAsB,EAAE,IAAY;IAChE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AACvC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiangong-ai/cli",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Tiangong AI command-line interface.",
   "repository": {
     "type": "git",
@@ -26,7 +26,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
-    "prepack": "npm run build",
+    "prepack": "npm run clean && npm run build",
     "typecheck": "tsc --noEmit",
     "test": "npm run build && node --import tsx --test test/*.test.ts",
     "test:coverage": "npm run build && node ./scripts/run-test-coverage.cjs",