Tiangong KB Report Search

Use this skill for Tiangong report-source retrieval. It is intentionally single-source: always search report, never all, sci, or patent.

In Auto Research, an industry-report requirement must name the reviewed report capability in requiredCapabilityIds; Brave or SCI results cannot stand in for it. If that capability is absent, stop at preflight and have the owner import, configure, license, credential, lock, and smoke the exact report capability. The standalone wrapper never reads the workspace broker credential store.

Prerequisites

• The standalone wrapper defaults to its separately tested CLI version

0.0.30; this is not the Auto Research workspace runtime. Set TIANGONGAICLI or TIANGONGAICLI_BIN only to intentionally override the standalone entrypoint.

• Set TIANGONGREPORTAPIKEY or the common fallback

TIANGONGAIAPIKEY. Credentials are rejected recursively in wrapper JSON, request files, URL query parameters, and CLI arguments.

• When requestfile / inputfile is provided, the wrapper loads .env from

that file's directory by default. env_file can point to a different dotenv file. It must be owner-only, regular, and non-symlinked; only documented Tiangong report credential, endpoint, region, and timeout variables are loaded, and existing environment values win.

• Optionally set TIANGONGAIAPIBASEURL; the CLI accepts a Supabase project

root, /functions/v1, or /rest/v1 and derives Functions URLs.

Search

For normal searches, pass a query:

./scripts/report_search.sh '{
  "query": "mechanical recycling policy report",
  "top_k": 5
}'

When the current directory is inside a managed workspace, this command is blocked before credential loading or network. Only a user who explicitly asks for one isolated query may add "execution_mode":"standalone"; the wrapper then emits a non-secret audit event.

The script calls:

npx --yes @tiangong-ai/[email protected] research search --query <query> --sources report --json

For exact edge-function payloads, provide requestfile or inputfile:

./scripts/report_search.sh '{
  "request_file": "./report-request.json",
  "dry_run": true
}'

Raw Payload Filters

Wrapper JSON can include inline raw reportsearch fields; the wrapper will forward them through the CLI --input path. The same payload can also be put in requestfile / input_file:

{
  "query": "mechanical recycling policy report",
  "filter": {
    "source": ["IEA"]
  },
  "topK": 5,
  "extK": 2
}

• filter: metadata term filters, shaped as { "field": ["value"] }.
• topK, extK: raw edge-function names for result count and adjacent chunk

expansion.

• datefilter and getMeta are not supported by report_search.

Input Fields

• query, input, or claim: convenience query text.
• requestfile or inputfile: JSON body forwarded unchanged.
• envfile: optional dotenv file. Without it, requestfile /

input_file causes the wrapper to load .env from that file's directory.

• execution_mode: only standalone, and only after an explicit isolated

owner request when a managed workspace is detected.

• filter, topK, extK: optional inline raw payload fields for report

search.

• sources: optional compatibility field; only report or default is

accepted.

• dry_run: true to return the exact request plan with masked credentials.
• apibaseurl; credentials must come from allowed owner environment

variables or an owner-only env file.

• report_url, region, timeout.
• topk, extk: only used in query mode.