@usenaive-sdk/cli 0.2.0 → 0.2.2

package/dist/commands/link.js

@@ -0,0 +1,91 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { saveConfig } from "../config.js";
+import { agentOutput } from "../output.js";
+export const linkCmd = new Command("link")
+    .description("Link to an existing Naive account via email verification (passwordless)")
+    .requiredOption("--email <email>", "Account email address to link")
+    .addHelpText("after", `
+Examples:
+  $ naive link --email alex@company.com
+  # Check your email for 6-digit code, then:
+  $ naive verify --email alex@company.com --code 123456
+
+What this does:
+  1. Sends a 6-digit verification code to the provided email
+  2. After verifying, creates an API agent linked to your account
+  3. Returns an API key for the linked account
+
+When to use this:
+  - You have a Naive account but prefer passwordless login
+  - You created your account through a social provider (Google, etc.)
+  - You want to link a second machine/agent to an existing account
+
+Flow:
+  naive link --email ... → check email → naive verify --email ... --code ...
+`)
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/auth/link", { email: opts.email }, { noAuth: true });
+    handleApiError("link", resp);
+    agentOutput({
+        action: "link",
+        result: {
+            status: "verification_sent",
+            email: opts.email,
+        },
+        next_steps: [
+            { command: `naive verify --email ${opts.email} --code <6-digit-code>`, description: "Complete verification with the code from your email" },
+        ],
+        hints: [
+            "A 6-digit code has been sent to your email",
+            "The code expires in 10 minutes",
+            "Check spam folder if you don't see it",
+        ],
+        related_commands: ["naive verify", "naive login", "naive register"],
+        help_markdown: "### Verification Code Sent\n\nCheck the inbox for `" + opts.email + "` and use the 6-digit code to complete linking:\n\n```\nnaive verify --email " + opts.email + " --code <CODE>\n```",
+    });
+});
+export const verifyCmd = new Command("verify")
+    .description("Complete account linking with the emailed verification code")
+    .requiredOption("--email <email>", "Account email (same as used in 'naive link')")
+    .requiredOption("--code <code>", "6-digit verification code from email")
+    .addHelpText("after", `
+Examples:
+  $ naive verify --email alex@company.com --code 482910
+
+What this does:
+  1. Validates the code against the pending verification
+  2. Creates an API agent linked to the verified account
+  3. Saves the API key to ~/.naive/config.json
+
+Prerequisites:
+  - Must have run 'naive link --email ...' first
+  - Code must not be expired (10 minute window)
+`)
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/auth/verify", {
+        email: opts.email,
+        code: opts.code,
+    }, { noAuth: true });
+    handleApiError("verify", resp);
+    const data = resp.data;
+    saveConfig({ api_key: data.api_key, agent_id: data.agent_id, company_id: data.company_id, company_name: data.company_name });
+    agentOutput({
+        action: "verify",
+        result: {
+            agent_id: data.agent_id,
+            companies: data.companies,
+            credentials_saved: "~/.naive/config.json",
+        },
+        next_steps: [
+            { command: "naive status", description: "Verify account and check credits" },
+            { command: "naive identity", description: "See resources available in this account" },
+            ...(data.companies?.length > 1
+                ? [{ command: "naive companies select <id>", description: "Choose which company to operate under" }]
+                : []),
+        ],
+        hints: ["Account linked successfully. All future commands use the saved API key."],
+        related_commands: ["naive whoami", "naive companies", "naive status"],
+    });
+});
+//# sourceMappingURL=link.js.map

package/dist/commands/link.js.map

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

package/dist/commands/login.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const loginCmd: Command;

package/dist/commands/login.js

@@ -0,0 +1,63 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { saveConfig } from "../config.js";
+import { agentOutput } from "../output.js";
+export const loginCmd = new Command("login")
+    .description("Log in to an existing Naive account with email and password")
+    .requiredOption("--email <email>", "Account email address")
+    .requiredOption("--password <password>", "Account password")
+    .addHelpText("after", `
+Examples:
+  $ naive login --email alex@company.com --password mypassword123
+
+What this does:
+  1. Authenticates with your email and password
+  2. Issues a fresh API key for your default company
+  3. Saves credentials to ~/.naive/config.json
+
+Notes:
+  - If you have multiple companies, the first one is selected by default
+  - Use 'naive companies' then 'naive companies select <id>' to switch
+  - This uses the same credentials as the Naive dashboard (usenaive.ai)
+  - Each login creates a new API key (old keys remain valid)
+`)
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/auth/login", {
+        email: opts.email,
+        password: opts.password,
+    }, { noAuth: true });
+    handleApiError("login", resp);
+    const data = resp.data;
+    saveConfig({
+        api_key: data.api_key,
+        agent_id: data.agent_id,
+        company_id: data.company_id,
+        company_name: data.company_name,
+    });
+    const hasMultipleCompanies = data.companies && data.companies.length > 1;
+    agentOutput({
+        action: "login",
+        result: {
+            agent_id: data.agent_id,
+            company_id: data.company_id,
+            company_name: data.company_name,
+            credentials_saved: "~/.naive/config.json",
+            companies: data.companies,
+        },
+        next_steps: [
+            { command: "naive status", description: "Check current credits and resources" },
+            { command: "naive identity", description: "View available resources for this company" },
+            ...(hasMultipleCompanies
+                ? [{ command: "naive companies select <id>", description: "Switch to a different company", when: "You want to operate under a different company" }]
+                : []),
+        ],
+        hints: [
+            "Logged in successfully — API key saved for automatic auth",
+            ...(hasMultipleCompanies
+                ? [`You have ${data.companies.length} companies. Currently using "${data.company_name}". Use 'naive companies' to see all.`]
+                : []),
+        ],
+        related_commands: ["naive whoami", "naive companies", "naive status", "naive keys list"],
+    });
+});
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KACzC,WAAW,CAAC,6DAA6D,CAAC;KAC1E,cAAc,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAC1D,cAAc,CAAC,uBAAuB,EAAE,kBAAkB,CAAC;KAC3D,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;;;CAcvB,CAAC;KACC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE;QACtD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAErB,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAMjB,CAAC;IAEF,UAAU,CAAC;QACT,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAC;IAEH,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAEzE,WAAW,CAAC;QACV,MAAM,EAAE,OAAO;QACf,MAAM,EAAE;YACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,iBAAiB,EAAE,sBAAsB;YACzC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B;QACD,UAAU,EAAE;YACV,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,qCAAqC,EAAE;YAC/E,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,2CAA2C,EAAE;YACvF,GAAG,CAAC,oBAAoB;gBACtB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,WAAW,EAAE,+BAA+B,EAAE,IAAI,EAAE,+CAA+C,EAAE,CAAC;gBACnJ,CAAC,CAAC,EAAE,CAAC;SACR;QACD,KAAK,EAAE;YACL,2DAA2D;YAC3D,GAAG,CAAC,oBAAoB;gBACtB,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,gCAAgC,IAAI,CAAC,YAAY,sCAAsC,CAAC;gBAC5H,CAAC,CAAC,EAAE,CAAC;SACR;QACD,gBAAgB,EAAE,CAAC,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,iBAAiB,CAAC;KACzF,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/register.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const registerCmd: Command;

package/dist/commands/register.js

@@ -0,0 +1,68 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { saveConfig } from "../config.js";
+import { agentOutput } from "../output.js";
+export const registerCmd = new Command("register")
+    .description("Create a new Naive account with email and password")
+    .requiredOption("--name <name>", "Your name or agent identity name")
+    .requiredOption("--email <email>", "Email address for the account (must be unique)")
+    .requiredOption("--password <password>", "Account password (minimum 8 characters)")
+    .option("--company <name>", "Company name (defaults to \"<name>'s Company\")")
+    .addHelpText("after", `
+Examples:
+  $ naive register --name "Alex" --email alex@company.com --password mypassword123
+  $ naive register --name "Build Agent" --email agent@acme.co --password s3cur3pw --company "Acme Corp"
+
+What this does:
+  1. Creates a user account (email + password)
+  2. Creates a company workspace
+  3. Provisions an API agent with 100 free credits
+  4. Returns an API key saved to ~/.naive/config.json
+
+After registration:
+  - Use 'naive status' to verify connectivity
+  - Use 'naive identity' to see provisioned resources
+  - Use 'naive email inboxes' to check available email addresses
+  - All subsequent commands authenticate automatically via the saved key
+`)
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/auth/register", {
+        name: opts.name,
+        email: opts.email,
+        password: opts.password,
+        company_name: opts.company,
+    }, { noAuth: true });
+    handleApiError("register", resp);
+    const data = resp.data;
+    saveConfig({
+        api_key: data.api_key,
+        agent_id: data.agent_id,
+        company_id: data.company_id,
+        company_name: data.company_name,
+    });
+    agentOutput({
+        action: "register",
+        result: {
+            agent_id: data.agent_id,
+            company_id: data.company_id,
+            company_name: data.company_name,
+            credentials_saved: "~/.naive/config.json",
+            initial_credits: 100,
+        },
+        next_steps: [
+            { command: "naive status", description: "Verify account status and available credits" },
+            { command: "naive identity", description: "View provisioned resources (email inboxes, etc.)" },
+            { command: "naive email inboxes", description: "List email addresses available for sending" },
+            { command: "naive images generate \"a sunset over mountains\"", description: "Try generating an image" },
+            { command: "naive search \"latest AI news\"", description: "Try a web search" },
+        ],
+        hints: [
+            "Your API key is saved locally — all future commands authenticate automatically",
+            "You start with 100 free credits. Use 'naive usage' to track spending.",
+            "If you already have a Naive account from the dashboard, use 'naive login' instead",
+        ],
+        related_commands: ["naive login", "naive link", "naive whoami", "naive status"],
+        help_markdown: "### Account Created\n\nYour agent is ready. The API key has been saved to `~/.naive/config.json` and will be used automatically for all subsequent commands.\n\n**Credit System**: You start with 100 free credits. Operations cost:\n- Web search: 0.01 credits\n- Email send: 0.05 credits  \n- Image generation: 0.5–2.0 credits (depends on model)\n- Video generation: 2.0–10.0 credits (depends on model/duration)\n- Deep research: 1.0–5.0 credits\n\nUse `naive usage` to monitor spending.",
+    });
+});
+//# sourceMappingURL=register.js.map

package/dist/commands/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/commands/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;KAC/C,WAAW,CAAC,oDAAoD,CAAC;KACjE,cAAc,CAAC,eAAe,EAAE,kCAAkC,CAAC;KACnE,cAAc,CAAC,iBAAiB,EAAE,gDAAgD,CAAC;KACnF,cAAc,CAAC,uBAAuB,EAAE,yCAAyC,CAAC;KAClF,MAAM,CAAC,kBAAkB,EAAE,iDAAiD,CAAC;KAC7E,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;;;;;CAgBvB,CAAC;KACC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,mBAAmB,EAAE;QACzD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,YAAY,EAAE,IAAI,CAAC,OAAO;KAC3B,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAErB,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAuF,CAAC;IAC1G,UAAU,CAAC;QACT,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAC;IAEH,WAAW,CAAC;QACV,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE;YACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,iBAAiB,EAAE,sBAAsB;YACzC,eAAe,EAAE,GAAG;SACrB;QACD,UAAU,EAAE;YACV,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,6CAA6C,EAAE;YACvF,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,kDAAkD,EAAE;YAC9F,EAAE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,4CAA4C,EAAE;YAC7F,EAAE,OAAO,EAAE,mDAAmD,EAAE,WAAW,EAAE,yBAAyB,EAAE;YACxG,EAAE,OAAO,EAAE,iCAAiC,EAAE,WAAW,EAAE,kBAAkB,EAAE;SAChF;QACD,KAAK,EAAE;YACL,gFAAgF;YAChF,uEAAuE;YACvE,mFAAmF;SACpF;QACD,gBAAgB,EAAE,CAAC,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,CAAC;QAC/E,aAAa,EAAE,seAAse;KACtf,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/search.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const searchCmd: Command;

package/dist/commands/search.js

@@ -0,0 +1,209 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { agentOutput } from "../output.js";
+export const searchCmd = new Command("search")
+    .description("Search the web, extract URLs, or run deep multi-source research")
+    .argument("[query]", "Search query (wrap in quotes if multi-word)")
+    .option("--count <n>", "Number of results to return (default: 5)", "5")
+    .addHelpText("after", `
+Subcommands:
+  naive search <query>          Quick web search (Tavily + Brave)
+  naive search url <url>        Extract content from a specific URL
+  naive search research <query> Deep multi-source research (async)
+
+Examples:
+  $ naive search "best project management tools 2025"
+  $ naive search "competitor analysis SaaS pricing" --count 10
+  $ naive search url https://example.com/pricing
+  $ naive search url https://news.ycombinator.com --extract "top 5 stories"
+  $ naive search research "market size for AI coding tools" --depth thorough
+
+Quick Search:
+  Uses Tavily or Brave to return top web results with:
+  - Title, URL, snippet for each result
+  - Relevance scores (when available)
+  Cost: 1 credit
+
+URL Extraction:
+  Fetches and extracts content from a single URL.
+  Optionally uses AI (Groq) to extract specific information.
+  Cost: 1 credit
+
+Deep Research:
+  Multi-source, AI-synthesized research on a topic.
+  Returns a comprehensive report with citations.
+  Runs asynchronously for thorough/exhaustive — use --wait or check with 'naive jobs'.
+  Cost: 3 credits (quick), 5 credits (thorough), 8 credits (exhaustive)
+`)
+    .action(async (query, opts) => {
+    if (!query) {
+        console.error(JSON.stringify({
+            success: false,
+            action: "search",
+            error: { code: "missing_argument", message: "Search query is required" },
+            recovery_steps: [
+                { command: 'naive search "your query here"', description: "Provide a search query" },
+                { command: "naive search --help", description: "See all search options and subcommands" },
+            ],
+        }, null, 2));
+        process.exit(1);
+    }
+    const resp = await apiRequest("POST", "/v1/search", { query, count: parseInt(opts.count) });
+    handleApiError("search", resp);
+    const data = resp.data;
+    const count = data.results?.length ?? 0;
+    agentOutput({
+        action: "search",
+        result: resp.data,
+        next_steps: [
+            ...(count > 0
+                ? [{ command: `naive search url ${data.results[0].url}`, description: "Extract full content from the top result" }]
+                : []),
+            { command: `naive search research "${query}"`, description: "Run deep research on this topic for a comprehensive report", when: "Quick results aren't sufficient" },
+            { command: `naive search "${query}" --count 10`, description: "Get more results" },
+        ],
+        hints: [
+            `Found ${count} results for "${query}"`,
+            "Use 'naive search url <url>' to extract full page content from any result",
+            "Use 'naive search research' for a synthesized multi-source report",
+            "Cost: 1 credit",
+        ],
+        related_commands: ["naive search url", "naive search research"],
+    });
+});
+searchCmd
+    .command("url <url>")
+    .description("Fetch and extract content from a specific URL")
+    .option("--extract <prompt>", "AI extraction prompt (e.g., 'pricing tiers', 'main features')")
+    .addHelpText("after", `
+Examples:
+  $ naive search url https://example.com/pricing
+  $ naive search url https://news.ycombinator.com --extract "top 5 stories with links"
+  $ naive search url https://docs.example.com/api --extract "authentication methods"
+
+What this does:
+  1. Fetches the URL content (respects robots.txt)
+  2. Extracts readable text from HTML
+  3. If --extract is provided, uses AI (Groq) to extract specific information
+  4. Returns the extracted content
+
+Parameters:
+  url           The URL to fetch and extract from
+  --extract     Optional AI prompt for targeted extraction
+
+Cost: 1 credit
+`)
+    .action(async (url, opts) => {
+    const resp = await apiRequest("POST", "/v1/search/url", { url, extract: opts.extract });
+    handleApiError("search.url", resp);
+    agentOutput({
+        action: "search.url",
+        result: resp.data,
+        next_steps: [
+            { command: `naive search url ${url} --extract "<specific question>"`, description: "Re-extract with a more specific prompt", when: "You need different information from the same page" },
+            { command: 'naive search "related topic"', description: "Search for related information" },
+            { command: `naive search research "analysis of ${url}"`, description: "Run deep research incorporating this source" },
+        ],
+        hints: [
+            "Use --extract to focus on specific information from the page",
+            "Cost: 1 credit",
+        ],
+        related_commands: ["naive search", "naive search research"],
+    });
+});
+searchCmd
+    .command("research <query>")
+    .description("Run deep multi-source AI research (async — returns a job)")
+    .option("--depth <level>", "Research depth: quick | thorough | exhaustive (default: quick)", "quick")
+    .option("--wait", "Poll until research completes (otherwise returns job ID)")
+    .addHelpText("after", `
+Examples:
+  $ naive search research "market size for AI developer tools" --depth thorough
+  $ naive search research "competitive analysis: Figma vs Canva" --depth exhaustive --wait
+  $ naive search research "best practices for microservice auth" --depth quick
+
+What this does:
+  1. Submits a research query to the async job system
+  2. The system searches multiple sources, synthesizes with AI (Groq)
+  3. Returns a comprehensive report with sections and citations
+
+Depth levels:
+  quick      - 5 sources, basic synthesis (sync, 3 credits)
+  thorough   - 8 sources, detailed synthesis (async ~45s, 5 credits)
+  exhaustive - 15 sources, comprehensive report (async ~90s, 8 credits)
+
+Without --wait:
+  Returns a job_id immediately. Check status with 'naive jobs get <id>'.
+
+With --wait:
+  Blocks until completion, then outputs the full report.
+
+Cost: 3–8 credits (deducted on completion, not submission)
+`)
+    .action(async (query, opts) => {
+    const resp = await apiRequest("POST", "/v1/search/research", { query, depth: opts.depth });
+    handleApiError("search.research", resp);
+    if (resp.status === 202) {
+        const data = resp.data;
+        if (opts.wait) {
+            agentOutput({
+                action: "search.research.submitted",
+                result: { job_id: data.job_id, status: "polling" },
+                next_steps: [],
+                hints: ["Waiting for research to complete..."],
+            });
+            await pollJob(data.job_id);
+        }
+        else {
+            agentOutput({
+                action: "search.research.submitted",
+                result: { job_id: data.job_id, status: "queued", depth: opts.depth },
+                next_steps: [
+                    { command: `naive jobs get ${data.job_id}`, description: "Check research progress" },
+                    { command: "naive jobs --status processing", description: "List all active jobs" },
+                ],
+                hints: [
+                    `Research job submitted (depth: ${opts.depth})`,
+                    "Credits will be deducted only on successful completion",
+                    `Expected completion: ${opts.depth === "quick" ? "~30s" : opts.depth === "thorough" ? "~60s" : "~120s"}`,
+                ],
+                related_commands: ["naive jobs get", "naive jobs", "naive jobs cancel"],
+            });
+        }
+    }
+    else {
+        agentOutput({
+            action: "search.research",
+            result: resp.data,
+            next_steps: [
+                { command: 'naive search "follow-up query"', description: "Quick search for additional context" },
+            ],
+            hints: ["Research completed synchronously (quick depth)"],
+            related_commands: ["naive search", "naive search url"],
+        });
+    }
+});
+async function pollJob(jobId) {
+    while (true) {
+        await new Promise((r) => setTimeout(r, 3000));
+        const resp = await apiRequest("GET", `/v1/jobs/${jobId}`);
+        const data = resp.data;
+        if (data.status === "completed" || data.status === "failed") {
+            agentOutput({
+                action: "search.research.completed",
+                result: resp.data,
+                next_steps: [
+                    { command: 'naive search "related topic"', description: "Search for additional information" },
+                    { command: "naive search url <url>", description: "Deep-dive into a specific source from the report" },
+                ],
+                hints: [
+                    data.status === "completed" ? "Research completed successfully" : "Research failed — no credits deducted",
+                ],
+                related_commands: ["naive search", "naive search url", "naive jobs"],
+            });
+            return;
+        }
+        process.stderr.write(`  Progress: ${data.progress ?? 0}% (${data.status})\n`);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

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

package/dist/commands/social.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const socialCmd: Command;