@tiangong-ai/cli 0.0.13 → 0.0.15

package/AGENTS.md

@@ -15,8 +15,8 @@ checkPaths:
   - .docpact/config.yaml
   - docs/agents/**
   - src/**
-lastReviewedAt: 2026-05-17
-lastReviewedCommit: d56d2633c2d69354d2cc787fe241459d887f22b9
+lastReviewedAt: 2026-05-26
+lastReviewedCommit: 6a05f20d5e167b770fce1aa3286a7dbdd2e1cd0d
 ---
 
 # Tiangong AI CLI Contract
@@ -44,6 +44,8 @@ This repository owns the Tiangong AI command-line interface.
 - `tiangong-ai kb ingest export`
 - `tiangong-ai kb collections`
 - `tiangong-ai kb status`
+- `tiangong-ai research search`
+- `tiangong-ai education search`
 
 ## Validation
 

package/README.md

@@ -12,8 +12,8 @@ checkPaths:
   - package.json
   - bin/**
   - src/**
-lastReviewedAt: 2026-05-17
-lastReviewedCommit: d56d2633c2d69354d2cc787fe241459d887f22b9
+lastReviewedAt: 2026-05-26
+lastReviewedCommit: 6a05f20d5e167b770fce1aa3286a7dbdd2e1cd0d
 ---
 
 # Tiangong AI CLI
@@ -150,6 +150,63 @@ Check document status:
 tiangong-ai kb ingest status <document-id>
 ```
 
+## Research Search
+
+Forward research-oriented search requests to SCI, report, and patent edge
+search sources:
+
+```bash
+tiangong-ai research search \
+  --input ./sci-request.json \
+  --sources all \
+  --dry-run \
+  --json
+```
+
+Required environment:
+
+```bash
+TIANGONG_AI_APIKEY=
+```
+
+`--input <file>` reads a JSON object and forwards it unchanged as the POST body
+to every selected source. Use `--dry-run` to emit the exact request plan,
+including method, URL, masked headers, input path, body, and timeout
+milliseconds, without remote calls.
+For quick calls, `--query <text>` builds a minimal body with `query` plus
+optional `--top-k`, `--ext-k`, and `--get-meta`.
+
+`--sources` accepts concrete IDs and presets. `default` expands to `sci`; `all`
+expands to `sci,report,patent`. Use source-specific endpoint or credential
+overrides with `--sci-url`, `--report-url`, `--patent-url`,
+`--sci-api-key`, `--report-api-key`, and `--patent-api-key`. When source URLs
+are not provided, `--api-base-url` or `TIANGONG_AI_API_BASE_URL` may be a
+Supabase project root, `/functions/v1`, or `/rest/v1`; the CLI derives the
+Functions base URL and appends `sci_search`, `report_search`, or
+`patent_search`.
+
+## Education Search
+
+Forward education-oriented search requests to course, education, and textbook
+edge search sources:
+
+```bash
+tiangong-ai education search \
+  --query "activated sludge process principles" \
+  --sources all \
+  --json
+```
+
+`--input <file>` forwards the JSON request body unchanged. `--query <text>`
+builds a minimal body with `query` plus optional `--top-k` and `--ext-k`.
+`--sources default` expands to `course`; `--sources all` expands to
+`course,edu,textbook`. `course` search can use a scoped bearer token through
+`--bearer-token` or `TIANGONG_EDUCATION_BEARER_TOKEN`; all education sources can
+use `--api-key` or `TIANGONG_AI_APIKEY`. When source URLs are not provided,
+`--api-base-url` or `TIANGONG_AI_API_BASE_URL` may be a Supabase project root,
+`/functions/v1`, or `/rest/v1`; the CLI derives the Functions base URL and
+appends `course_search`, `edu_search`, or `textbook_search`.
+
 ## Boundary
 
 The CLI is a thin local client. It sends bearer-token requests to the Tiangong

package/dist/args.d.ts

@@ -0,0 +1,13 @@
+export interface ParsedArgs {
+    positionals: string[];
+    flags: Map<string, string | true>;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function getString(args: ParsedArgs, name: string): string | undefined;
+export declare function getBoolean(args: ParsedArgs, name: string): boolean;
+export declare function getPositiveInteger(args: ParsedArgs, name: string, defaultValue: number): number;
+export declare function getNonNegativeInteger(args: ParsedArgs, name: string, defaultValue: number): number;
+export declare function nonNegativeIntegerValue(value: string | undefined, defaultValue: number, label: string): number;
+export declare function getPositiveNumber(args: ParsedArgs, name: string, defaultValue: number): number;
+export declare function positiveNumberValue(value: string | undefined, defaultValue: number, label: string): number;
+export declare function positiveIntegerValue(value: string | undefined, defaultValue: number, label: string): number;

package/dist/args.js

@@ -0,0 +1,72 @@
+import { CliError } from "./errors.js";
+export function parseArgs(argv) {
+    const positionals = [];
+    const flags = new Map();
+    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("=");
+        if (equalsIndex >= 0) {
+            flags.set(withoutPrefix.slice(0, equalsIndex), withoutPrefix.slice(equalsIndex + 1));
+            continue;
+        }
+        const next = argv[index + 1];
+        if (next && !next.startsWith("--")) {
+            flags.set(withoutPrefix, next);
+            index += 1;
+        }
+        else {
+            flags.set(withoutPrefix, true);
+        }
+    }
+    return { positionals, flags };
+}
+export function getString(args, name) {
+    const value = args.flags.get(name);
+    if (typeof value !== "string" || value.trim() === "")
+        return undefined;
+    return value.trim();
+}
+export function getBoolean(args, name) {
+    return args.flags.get(name) === true || args.flags.get(name) === "true";
+}
+export function getPositiveInteger(args, name, defaultValue) {
+    return positiveIntegerValue(getString(args, name), defaultValue, `--${name}`);
+}
+export function getNonNegativeInteger(args, name, defaultValue) {
+    return nonNegativeIntegerValue(getString(args, name), defaultValue, `--${name}`);
+}
+export function nonNegativeIntegerValue(value, defaultValue, label) {
+    if (!value)
+        return defaultValue;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0)
+        throw new CliError(`${label} must be a non-negative integer.`);
+    return parsed;
+}
+export function getPositiveNumber(args, name, defaultValue) {
+    return positiveNumberValue(getString(args, name), defaultValue, `--${name}`);
+}
+export function positiveNumberValue(value, defaultValue, label) {
+    if (!value)
+        return defaultValue;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        throw new CliError(`${label} must be a positive number.`);
+    return parsed;
+}
+export function positiveIntegerValue(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.`);
+    return parsed;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/cli.d.ts

@@ -1,22 +1,6 @@
-export declare const DEFAULT_API_BASE_URL = "https://thuenv.tiangong.world:7300";
-export declare const DEFAULT_API_PATH_PREFIX = "/api/v1/kb";
-interface Output {
-    write(text: string): unknown;
-}
-export interface CliIO {
-    env: NodeJS.ProcessEnv;
-    stdout: Output;
-    stderr: Output;
-}
-interface ParsedArgs {
-    positionals: string[];
-    flags: Map<string, string | true>;
-}
-interface CollectionSelector {
-    field: "primary_collection_id" | "collection_path" | "collection_key" | "collection_name";
-    value: string;
-}
+import type { CliIO } from "./io.js";
+export type { CliIO, Output } from "./io.js";
+export { parseArgs } from "./args.js";
+export { DEFAULT_API_BASE_URL, DEFAULT_API_PATH_PREFIX } from "./kb/config.js";
+export { resolveCollectionSelector } from "./kb/selector.js";
 export declare function runCli(argv: string[], io: CliIO): Promise<number>;
-export declare function parseArgs(argv: string[]): ParsedArgs;
-export declare function resolveCollectionSelector(args: ParsedArgs, env: NodeJS.ProcessEnv): CollectionSelector;
-export {};