@anysiteio/agent-skills 1.2.0 → 1.3.0

package/skills/anysite-cli/references/api-reference.md

@@ -10,12 +10,12 @@ anysite api <endpoint> [key=value ...] [OPTIONS]
 
 ### Output Options
 ```
---format, -f TEXT        json|jsonl|csv|table (default: json)
+--format, -f TEXT        json|jsonl|csv|table|parquet (default: json)
 --fields TEXT            Comma-separated fields to include (dot-notation supported)
 --exclude TEXT           Comma-separated fields to exclude
 --fields-preset TEXT     Built-in preset: minimal|contact|recruiting
 --compact                Compact JSON (no indentation)
---output, -o PATH        Save to file
+--output, -o PATH        Save to file (supports {{date}}/{{datetime}} templates)
 --append                 Append to existing output file
 --quiet, -q              Suppress non-data output (use for piping)
 ```
@@ -53,6 +53,10 @@ anysite api /api/linkedin/company company=anthropic -q | jq '.employee_count'
 # Pipe to database
 anysite api /api/linkedin/user user=satyanadella -q --format jsonl \
   | anysite db insert mydb --table profiles --stdin --auto-create
+
+# Array/set parameters accept comma-separated values
+anysite api /api/linkedin/google/company keywords=fuzzy.so        # auto-wrapped to ["fuzzy.so"]
+anysite api /api/linkedin/google/company keywords=saas,fintech    # becomes ["saas","fintech"]
 ```
 
 ---
@@ -79,7 +83,20 @@ anysite describe --search "company"       # Search by keyword
 anysite describe --json -q                # Machine-readable output
 ```
 
-Output shows: endpoint path, description, input parameters (name, type, required), output fields (name, type).
+Output shows: endpoint path, description, input parameters (name, type, required), output fields (name, type). Nested objects and arrays are expanded with dot-notation:
+
+```
+Output fields (15):
+    name                           string
+    urn                            object
+      .type                        string
+      .value                       string
+    experience                     array[object]
+      .title                       string
+      .company_urn                 string
+```
+
+Use these dot-notation paths in `--fields`, `dependency.field`, and `db_load.fields`.
 
 ---
 
@@ -119,15 +136,31 @@ Schema is cached to `~/.anysite/schema.json`. Required for `anysite describe` an
 ## Global Options
 
 ```
---api-key TEXT     Override API key
---base-url TEXT    Override API base URL
---debug            Enable debug output
---no-color         Disable colored output
---version, -v      Show version
+--api-key TEXT       Override API key
+--base-url TEXT      Override API base URL
+--debug              Enable debug output
+--no-color           Disable colored output
+--json               Force JSON envelope output (auto-enabled in pipes)
+--human              Force human-readable output (override auto-JSON in pipes)
+--non-interactive    Disable interactive prompts (auto-enabled when stdin is not a TTY)
+--version, -v        Show version
 ```
 
 ---
 
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Usage error (invalid args, missing params) |
+| 3 | Authentication failed |
+| 4 | Resource not found |
+| 5 | Network / timeout / rate limit |
+
+---
+
 ## Common API Endpoints
 
 ### LinkedIn
@@ -158,3 +191,35 @@ Schema is cached to `~/.anysite/schema.json`. Required for `anysite describe` an
 ```
 
 Use `anysite describe --search <keyword>` to discover more endpoints.
+
+---
+
+## anysite dataset guide
+
+Show comprehensive dataset configuration reference with examples.
+
+```
+anysite dataset guide [OPTIONS]
+```
+
+```
+--section, -s TEXT    Show specific section (e.g., sources, llm, db_load)
+--example, -e TEXT    Show a complete example config (e.g., basic, advanced)
+--list               List available sections and examples
+--json               Output as machine-readable JSON
+```
+
+### Examples
+```bash
+anysite dataset guide                        # full reference
+anysite dataset guide --section sources      # source types only
+anysite dataset guide --section llm          # LLM enrichment config
+anysite dataset guide --example basic        # basic config example
+anysite dataset guide --example advanced     # multi-source pipeline
+anysite dataset guide --list                 # list all sections and examples
+anysite dataset guide --json                 # structured JSON for agents
+```
+
+Available sections: `sources`, `params`, `dependencies`, `llm`, `transform`, `export`, `db_load`, `storage`, `schedule`, `notifications`, `incremental`.
+
+Available examples: `basic`, `advanced`, `from_file`, `llm_enrichment`.