@youdotcom-oss/api 0.0.1 → 0.1.0

package/README.md

@@ -38,7 +38,7 @@ bunx @youdotcom-oss/api contents --json '{
 }' --client MyAgent
 
 # Discover available parameters with --schema
-api search --schema | jq '.properties | keys'
+ydc search --schema | jq '.properties | keys'
 ```
 
 ### Programmatic Usage
@@ -99,9 +99,9 @@ export YDC_CLIENT="YourAgentName"  # Optional: default client for tracking
 All commands require the `--json` flag with a JSON string containing the query parameters:
 
 ```bash
-api search --json '{"query":"..."}'
-api express --json '{"input":"..."}'
-api contents --json '{"urls":["..."]}'
+ydc search --json '{"query":"..."}'
+ydc express --json '{"input":"..."}'
+ydc contents --json '{"urls":["..."]}'
 ```
 
 ### Global Options
@@ -118,13 +118,13 @@ Use `--schema` to discover what parameters each command accepts:
 
 ```bash
 # Get schema for search command
-api search --schema
+ydc search --schema
 
 # Get schema for express command
-api express --schema
+ydc express --schema
 
 # Get schema for contents command
-api contents --schema
+ydc contents --schema
 ```
 
 The schema output describes the JSON structure to pass via `--json`.
@@ -132,21 +132,21 @@ The schema output describes the JSON structure to pass via `--json`.
 ### Search Command
 
 ```bash
-api search --json '{"query":"..."}' [options]
+ydc search --json '{"query":"..."}' [options]
 
 Examples:
   # Basic search
-  api search --json '{"query":"machine learning"}' --client Openclaw
+  ydc search --json '{"query":"machine learning"}' --client Openclaw
 
   # Search with livecrawl (KEY FEATURE)
-  api search --json '{
+  ydc search --json '{
     "query":"documentation",
     "livecrawl":"web",
     "livecrawl_formats":"markdown"
   }' --client Openclaw
 
   # Advanced filters
-  api search --json '{
+  ydc search --json '{
     "query":"AI papers",
     "site":"arxiv.org",
     "fileType":"pdf",
@@ -185,7 +185,7 @@ Examples:
 ### Express Command
 
 ```bash
-api express --json '{"input":"..."}' [options]
+ydc express --json '{"input":"..."}' [options]
 
 Examples:
   # Fast answer
@@ -212,7 +212,7 @@ Examples:
 ### Contents Command
 
 ```bash
-api contents --json '{"urls":["..."]}' [options]
+ydc contents --json '{"urls":["..."]}' [options]
 
 Examples:
   # Extract markdown
@@ -275,7 +275,7 @@ Examples:
 
 ```bash
 # Direct access to response fields
-api search --json '{"query":"AI"}' | jq '.results.web[0].title'
+ydc search --json '{"query":"AI"}' | jq '.results.web[0].title'
 
 # No need to unwrap .data or .success
 ```
@@ -390,9 +390,9 @@ exit 1
 
 ```bash
 #!/usr/bin/env bash
-api search --json '{"query":"AI"}' --client Openclaw &
-api search --json '{"query":"ML"}' --client Openclaw &
-api search --json '{"query":"LLM"}' --client Openclaw &
+ydc search --json '{"query":"AI"}' --client Openclaw &
+ydc search --json '{"query":"ML"}' --client Openclaw &
+ydc search --json '{"query":"LLM"}' --client Openclaw &
 wait
 ```
 
@@ -418,7 +418,7 @@ answer=$(api express --json '{
 
 # Extract top result URL and fetch content
 url=$(echo "$search" | jq -r '.results.web[0].url')
-api contents --json "{\"urls\":[\"$url\"],\"formats\":[\"markdown\"]}" \
+ydc contents --json "{\"urls\":[\"$url\"],\"formats\":[\"markdown\"]}" \
   --client Openclaw | jq -r '.[0].markdown' > output.md
 ```
 
@@ -441,7 +441,7 @@ query=$(jq -n '{
 }')
 
 # Execute search
-api search --json "$query" --client Openclaw
+ydc search --json "$query" --client Openclaw
 ```
 
 ## Agent Skills Integration

package/bin/cli.js

@@ -15,7 +15,7 @@ import { parseArgs as parseArgs4 } from "node:util";
 // package.json
 var package_default = {
   name: "@youdotcom-oss/api",
-  version: "0.0.1",
+  version: "0.1.0",
   description: "You.com API client with bundled CLI for agents supporting Agent Skills",
   license: "MIT",
   engines: {
@@ -1894,10 +1894,6 @@ var $ZodNumberFormat = /* @__PURE__ */ $constructor("$ZodNumberFormat", (inst, d
   $ZodCheckNumberFormat.init(inst, def);
   $ZodNumber.init(inst, def);
 });
-var $ZodAny = /* @__PURE__ */ $constructor("$ZodAny", (inst, def) => {
-  $ZodType.init(inst, def);
-  inst._zod.parse = (payload) => payload;
-});
 var $ZodUnknown = /* @__PURE__ */ $constructor("$ZodUnknown", (inst, def) => {
   $ZodType.init(inst, def);
   inst._zod.parse = (payload) => payload;
@@ -3169,11 +3165,6 @@ function _int(Class2, params) {
     ...normalizeParams(params)
   });
 }
-function _any(Class2) {
-  return new Class2({
-    type: "any"
-  });
-}
 function _unknown(Class2) {
   return new Class2({
     type: "unknown"
@@ -4584,14 +4575,6 @@ var ZodNumberFormat = /* @__PURE__ */ $constructor("ZodNumberFormat", (inst, def
 function int(params) {
   return _int(ZodNumberFormat, params);
 }
-var ZodAny = /* @__PURE__ */ $constructor("ZodAny", (inst, def) => {
-  $ZodAny.init(inst, def);
-  ZodType.init(inst, def);
-  inst._zod.processJSONSchema = (ctx, json, params) => anyProcessor(inst, ctx, json, params);
-});
-function any() {
-  return _any(ZodAny);
-}
 var ZodUnknown = /* @__PURE__ */ $constructor("ZodUnknown", (inst, def) => {
   $ZodUnknown.init(inst, def);
   ZodType.init(inst, def);
@@ -5071,13 +5054,13 @@ var ExpressAgentInputSchema = object({
   })).optional().describe("Tools (web search only)")
 });
 var ApiSearchResultItemSchema = object({
-  source_type: string2().optional(),
+  source_type: string2().nullable().optional(),
   citation_uri: string2().optional(),
   url: string2(),
   title: string2(),
   snippet: string2(),
-  thumbnail_url: string2().optional(),
-  provider: any().optional()
+  thumbnail_url: string2().nullable().optional(),
+  provider: string2().nullable().optional()
 });
 var ExpressAgentApiOutputItemSchema = union([
   object({
@@ -5093,7 +5076,10 @@ var ExpressAgentApiResponseSchema = object({
   output: array(ExpressAgentApiOutputItemSchema),
   agent: string2().optional().describe("Agent identifier"),
   mode: string2().optional().describe("Agent mode"),
-  input: array(any()).optional().describe("Input messages")
+  input: array(object({
+    role: _enum(["user"]).describe("User role"),
+    content: string2().describe("User question")
+  })).optional().describe("Input messages")
 }).passthrough();
 var McpSearchResultItemSchema = object({
   url: string2().describe("URL"),
@@ -5439,11 +5425,11 @@ Output Format:
   Invalid args: Error message on stderr (exit 2)
 
 Examples:
-  ydc search "AI developments" --client Openclaw
-  ydc search "AI" --client Openclaw | jq '.data.results.web[0].title'
-  ydc express "What happened today?" --client MyAgent --tools web_search
-  ydc contents https://example.com --formats markdown
+  ydc search --json '{"query":"AI developments"}' --client Openclaw
+  ydc express --json '{"input":"What happened today?","tools":[{"type":"web_search"}]}' --client MyAgent
+  ydc contents --json '{"urls":["https://example.com"],"formats":["markdown"]}'
   ydc search --schema  # Get JSON schema for search --json input
+  ydc search --json '{"query":"AI"}' | jq '.data.results.web[0].title'
 
 More info: https://github.com/youdotcom-oss/dx-toolkit/tree/main/packages/api
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdotcom-oss/api",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "You.com API client with bundled CLI for agents supporting Agent Skills",
   "license": "MIT",
   "engines": {

package/src/cli.ts

@@ -54,11 +54,11 @@ Output Format:
   Invalid args: Error message on stderr (exit 2)
 
 Examples:
-  ydc search "AI developments" --client Openclaw
-  ydc search "AI" --client Openclaw | jq '.data.results.web[0].title'
-  ydc express "What happened today?" --client MyAgent --tools web_search
-  ydc contents https://example.com --formats markdown
+  ydc search --json '{"query":"AI developments"}' --client Openclaw
+  ydc express --json '{"input":"What happened today?","tools":[{"type":"web_search"}]}' --client MyAgent
+  ydc contents --json '{"urls":["https://example.com"],"formats":["markdown"]}'
   ydc search --schema  # Get JSON schema for search --json input
+  ydc search --json '{"query":"AI"}' | jq '.data.results.web[0].title'
 
 More info: https://github.com/youdotcom-oss/dx-toolkit/tree/main/packages/api
 `)

package/src/express/express.schemas.ts

@@ -19,13 +19,13 @@ export type ExpressAgentInput = z.infer<typeof ExpressAgentInputSchema>
 // Search result content item from web_search.results
 // Note: thumbnail_url, source_type, and provider are API-only pass-through fields not used in MCP output
 const ApiSearchResultItemSchema = z.object({
-  source_type: z.string().optional(),
+  source_type: z.string().nullable().optional(),
   citation_uri: z.string().optional(), // Used as fallback for url in transformation
   url: z.string(),
   title: z.string(),
   snippet: z.string(),
-  thumbnail_url: z.string().optional(), // API-only, not transformed to MCP output
-  provider: z.any().optional(), // API-only, not transformed to MCP output
+  thumbnail_url: z.string().nullable().optional(), // API-only, not transformed to MCP output
+  provider: z.string().nullable().optional(), // API-only, not transformed to MCP output
 })
 
 // Union of possible output item types from API
@@ -47,7 +47,15 @@ export const ExpressAgentApiResponseSchema = z
     output: z.array(ExpressAgentApiOutputItemSchema),
     agent: z.string().optional().describe('Agent identifier'),
     mode: z.string().optional().describe('Agent mode'),
-    input: z.array(z.any()).optional().describe('Input messages'),
+    input: z
+      .array(
+        z.object({
+          role: z.enum(['user']).describe('User role'),
+          content: z.string().describe('User question'),
+        }),
+      )
+      .optional()
+      .describe('Input messages'),
   })
   .passthrough()