@usenaive-sdk/cli 0.3.1 → 0.4.1

package/dist/commands/billing-client.js

@@ -0,0 +1,271 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { agentOutput } from "../output.js";
+export const billingClientCmd = new Command("billing-client")
+    .description("naive/billing-client — Stripe-via-Composio: invoice + bill your clients. Distinct from 'naive billing' (Naive platform plan).")
+    .addHelpText("after", `
+Subcommands:
+  naive billing-client connection             Check whether Stripe is connected via Composio
+  naive billing-client sync                   Manually pull latest invoices/subscriptions/customers from Stripe
+  naive billing-client invoices ...           Manage Stripe invoices for your clients
+  naive billing-client subscriptions ...      Manage Stripe subscriptions for retainers
+  naive billing-client profile <contact-id>   Look up a billing profile for a CRM contact
+  naive billing-client overdue                List overdue invoices (for dunning workflows)
+  naive billing-client mrr                    Net MRR change over a date range
+
+Stripe must be connected via Composio first:
+  $ naive integrations connect stripe
+
+If it isn't connected, every billing-client command returns:
+  { error_code: "stripe_not_connected", connect_url: "..." }
+`);
+billingClientCmd
+    .command("connection")
+    .description("Check Stripe (Composio) connection status")
+    .action(async () => {
+    const resp = await apiRequest("GET", "/v1/billing-client/connection");
+    handleApiError("billing-client.connection", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "billing-client.connection",
+        result: resp.data,
+        next_steps: data.connected
+            ? [{ command: "naive billing-client invoices list", description: "List existing invoices" }]
+            : [{ command: "naive integrations connect stripe", description: "Connect Stripe via Composio" }],
+        hints: data.connected
+            ? ["Stripe is connected — billing-client commands will work"]
+            : ["Stripe is not connected — connect via Composio before invoicing clients"],
+        related_commands: ["naive integrations connect", "naive billing-client invoices list"],
+    });
+});
+billingClientCmd
+    .command("sync")
+    .description("Manually pull latest invoices/subscriptions/customers from Stripe (usually runs hourly)")
+    .action(async () => {
+    const resp = await apiRequest("POST", "/v1/billing-client/sync");
+    handleApiError("billing-client.sync", resp);
+    agentOutput({
+        action: "billing-client.sync",
+        result: resp.data,
+        related_commands: ["naive billing-client invoices list", "naive billing-client subscriptions list"],
+    });
+});
+// ── Invoices ──────────────────────────────────────────────────────────────
+const invoicesCmd = billingClientCmd.command("invoices").description("Stripe invoice management");
+invoicesCmd
+    .command("list")
+    .description("List invoices (denormalized read model)")
+    .option("--crm-contact <id>", "Filter to a CRM contact")
+    .option("--crm-company <id>", "Filter to a CRM company")
+    .option("--status <status>", "Stripe status (draft|open|paid|void|uncollectible)")
+    .option("--limit <n>", "Max results (default 50)", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit, offset: opts.offset });
+    if (opts.crmContact)
+        params.set("crm_contact_id", opts.crmContact);
+    if (opts.crmCompany)
+        params.set("crm_company_id", opts.crmCompany);
+    if (opts.status)
+        params.set("status", opts.status);
+    const resp = await apiRequest("GET", `/v1/billing-client/invoices?${params}`);
+    handleApiError("billing-client.invoices.list", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "billing-client.invoices.list",
+        result: resp.data,
+        next_steps: data.invoices.length > 0
+            ? [{ command: `naive billing-client invoices get ${data.invoices[0].id}`, description: "View the most recent invoice" }]
+            : [{ command: "naive billing-client invoices create --crm-contact <id> --line-items <json>", description: "Create your first invoice" }],
+        hints: [`${data.count} invoice${data.count === 1 ? "" : "s"} returned`],
+        related_commands: ["naive billing-client invoices create", "naive billing-client invoices send"],
+    });
+});
+invoicesCmd
+    .command("create")
+    .description("Create a Stripe invoice for a CRM contact")
+    .requiredOption("--crm-contact <id>", "CRM contact UUID")
+    .requiredOption("--line-items <json>", "JSON array: [{description, amount_cents, quantity?, currency?}]")
+    .option("--memo <text>", "Memo text on the invoice")
+    .option("--due-date <iso>", "ISO date string")
+    .option("--currency <iso>", "Default currency (usd)")
+    .option("--auto-send", "Finalize and send immediately after creation")
+    .action(async (opts) => {
+    let lineItems;
+    try {
+        lineItems = JSON.parse(opts.lineItems);
+    }
+    catch {
+        agentOutput({
+            action: "billing-client.invoices.create",
+            result: { error: "invalid_input", message: "--line-items must be valid JSON" },
+            hints: ["Example: '[{\"description\":\"Audit\",\"amount_cents\":150000}]'"],
+            related_commands: ["naive billing-client invoices create"],
+        });
+        process.exit(1);
+    }
+    const resp = await apiRequest("POST", "/v1/billing-client/invoices", {
+        crm_contact_id: opts.crmContact,
+        line_items: lineItems,
+        memo: opts.memo,
+        due_date: opts.dueDate,
+        currency: opts.currency,
+        auto_send: opts.autoSend === true,
+    });
+    handleApiError("billing-client.invoices.create", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "billing-client.invoices.create",
+        result: resp.data,
+        next_steps: [
+            ...(opts.autoSend
+                ? [{ command: `naive billing-client invoices get ${data.invoice.id}`, description: "Verify invoice was sent" }]
+                : [{ command: `naive billing-client invoices send ${data.invoice.id}`, description: "Finalize and send this draft invoice" }]),
+        ],
+        hints: data.invoice.hosted_invoice_url ? [`Hosted: ${data.invoice.hosted_invoice_url}`] : [],
+        related_commands: ["naive billing-client invoices send", "naive billing-client invoices void"],
+    });
+});
+invoicesCmd
+    .command("get <invoice_id>")
+    .description("Get a single invoice")
+    .action(async (invoiceId) => {
+    const resp = await apiRequest("GET", `/v1/billing-client/invoices/${invoiceId}`);
+    handleApiError("billing-client.invoices.get", resp);
+    agentOutput({
+        action: "billing-client.invoices.get",
+        result: resp.data,
+        related_commands: ["naive billing-client invoices send", "naive billing-client invoices void"],
+    });
+});
+invoicesCmd
+    .command("send <invoice_id>")
+    .description("Finalize (if draft) and send a Stripe invoice")
+    .action(async (invoiceId) => {
+    const resp = await apiRequest("POST", `/v1/billing-client/invoices/${invoiceId}/send`);
+    handleApiError("billing-client.invoices.send", resp);
+    agentOutput({
+        action: "billing-client.invoices.send",
+        result: resp.data,
+        related_commands: ["naive billing-client invoices get", "naive billing-client invoices list"],
+    });
+});
+invoicesCmd
+    .command("void <invoice_id>")
+    .description("Void a Stripe invoice")
+    .option("--reason <text>", "Why the invoice is being voided")
+    .action(async (invoiceId, opts) => {
+    const resp = await apiRequest("POST", `/v1/billing-client/invoices/${invoiceId}/void`, {
+        reason: opts.reason,
+    });
+    handleApiError("billing-client.invoices.void", resp);
+    agentOutput({
+        action: "billing-client.invoices.void",
+        result: resp.data,
+        related_commands: ["naive billing-client invoices list", "naive billing-client invoices create"],
+    });
+});
+// ── Subscriptions ────────────────────────────────────────────────────────
+const subsCmd = billingClientCmd.command("subscriptions").description("Stripe subscription management (retainers)");
+subsCmd
+    .command("list")
+    .description("List subscriptions")
+    .option("--crm-contact <id>", "Filter to a CRM contact")
+    .option("--status <status>", "Stripe status filter")
+    .option("--limit <n>", "Max results (default 50)", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit, offset: opts.offset });
+    if (opts.crmContact)
+        params.set("crm_contact_id", opts.crmContact);
+    if (opts.status)
+        params.set("status", opts.status);
+    const resp = await apiRequest("GET", `/v1/billing-client/subscriptions?${params}`);
+    handleApiError("billing-client.subscriptions.list", resp);
+    agentOutput({
+        action: "billing-client.subscriptions.list",
+        result: resp.data,
+        related_commands: ["naive billing-client subscriptions create", "naive billing-client subscriptions cancel"],
+    });
+});
+subsCmd
+    .command("create")
+    .description("Create a subscription for a CRM contact")
+    .requiredOption("--crm-contact <id>", "CRM contact UUID")
+    .requiredOption("--price-id <id>", "Stripe price ID (price_...)")
+    .option("--trial-days <n>", "Trial period in days")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/billing-client/subscriptions", {
+        crm_contact_id: opts.crmContact,
+        price_id: opts.priceId,
+        ...(opts.trialDays && { trial_days: parseInt(opts.trialDays, 10) }),
+    });
+    handleApiError("billing-client.subscriptions.create", resp);
+    agentOutput({
+        action: "billing-client.subscriptions.create",
+        result: resp.data,
+        related_commands: ["naive billing-client subscriptions list", "naive billing-client mrr"],
+    });
+});
+subsCmd
+    .command("cancel <subscription_id>")
+    .description("Cancel a subscription (default: at period end)")
+    .option("--immediate", "Cancel immediately rather than at period end")
+    .action(async (subscriptionId, opts) => {
+    const resp = await apiRequest("POST", `/v1/billing-client/subscriptions/${subscriptionId}/cancel`, {
+        at_period_end: !opts.immediate,
+    });
+    handleApiError("billing-client.subscriptions.cancel", resp);
+    agentOutput({
+        action: "billing-client.subscriptions.cancel",
+        result: resp.data,
+        related_commands: ["naive billing-client subscriptions list"],
+    });
+});
+// ── Profiles + aggregates ─────────────────────────────────────────────────
+billingClientCmd
+    .command("profile <contact_id>")
+    .description("Get the billing profile for a CRM contact (denormalized status, MRR, LTV)")
+    .action(async (contactId) => {
+    const resp = await apiRequest("GET", `/v1/billing-client/profiles/by-contact/${contactId}`);
+    handleApiError("billing-client.profile", resp);
+    agentOutput({
+        action: "billing-client.profile",
+        result: resp.data,
+        related_commands: ["naive billing-client invoices list", "naive billing-client subscriptions list"],
+    });
+});
+billingClientCmd
+    .command("overdue")
+    .description("List overdue invoices (for dunning)")
+    .option("--threshold-days <n>", "Only invoices overdue by at least N days", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams({ threshold_days: opts.thresholdDays });
+    const resp = await apiRequest("GET", `/v1/billing-client/invoices/overdue?${params}`);
+    handleApiError("billing-client.overdue", resp);
+    agentOutput({
+        action: "billing-client.overdue",
+        result: resp.data,
+        related_commands: ["naive billing-client invoices list", "naive billing-client invoices send"],
+    });
+});
+billingClientCmd
+    .command("mrr")
+    .description("Compute MRR change over a date range")
+    .option("--from <iso>", "Start date (default 30 days ago)")
+    .option("--to <iso>", "End date (default now)")
+    .action(async (opts) => {
+    const params = new URLSearchParams();
+    if (opts.from)
+        params.set("from", opts.from);
+    if (opts.to)
+        params.set("to", opts.to);
+    const resp = await apiRequest("GET", `/v1/billing-client/mrr?${params}`);
+    handleApiError("billing-client.mrr", resp);
+    agentOutput({
+        action: "billing-client.mrr",
+        result: resp.data,
+        related_commands: ["naive billing-client subscriptions list"],
+    });
+});
+//# sourceMappingURL=billing-client.js.map

package/dist/commands/billing-client.js.map

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

package/dist/commands/ceo.d.ts

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

package/dist/commands/ceo.js

@@ -0,0 +1,369 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { loadConfig, getApiKey } from "../config.js";
+import { agentOutput, agentError } from "../output.js";
+export const ceoCmd = new Command("ceo")
+    .description("Communicate with the CEO agent — run prompts, send messages, monitor sessions")
+    .addHelpText("after", `
+Subcommands:
+  naive ceo run <prompt>        Start a new CEO run with a prompt
+  naive ceo message <text>      Send a message to an active CEO session
+  naive ceo status              Get the CEO agent's current status
+  naive ceo sessions            List all CEO sessions
+  naive ceo stream <runId>      Stream real-time output from a CEO run (SSE)
+  naive ceo team-approve        Approve a CEO-proposed team and provision agents
+
+Workflow:
+  1. naive ceo run "Launch a new product line"  → start a CEO task
+  2. naive ceo stream <runId>                   → watch output in real-time
+  3. naive ceo team-approve --team '[...]'      → approve the proposed team
+  4. naive ceo message "Focus on marketing"     → steer the CEO mid-run
+  5. naive ceo status                           → check if the CEO is working
+  6. naive ceo sessions                         → review all past sessions
+
+The CEO is a persistent Hermes gateway that orchestrates your company's
+AI workforce. It decomposes objectives into tasks, proposes teams, and
+dispatches work to employees once you approve the team composition.
+
+Examples:
+  $ naive ceo run "Analyze our competitors and draft a strategy"
+  $ naive ceo status
+  $ naive ceo sessions
+  $ naive ceo stream abc-123
+  $ naive ceo message "Prioritize the SEO analysis"
+`);
+ceoCmd
+    .command("run <prompt>")
+    .description("Start a new CEO run — the CEO will interpret the prompt and begin executing")
+    .addHelpText("after", `
+Examples:
+  $ naive ceo run "Set up email infrastructure and send welcome emails to our leads"
+  $ naive ceo run "Research competitors in the AI space and write a report"
+
+What this does:
+  1. Sends the prompt to the CEO agent
+  2. The CEO decomposes the prompt into objectives and tasks
+  3. Tasks are dispatched to available employees
+  4. Returns a run ID for tracking progress
+
+The CEO operates asynchronously — use 'naive ceo stream <runId>' to
+watch output in real-time, or 'naive ceo status' to check progress.
+`)
+    .action(async (prompt) => {
+    const config = loadConfig();
+    const resp = await apiRequest("POST", `/v1/companies/${config.company_id}/ceo/run`, {
+        prompt,
+    });
+    handleApiError("ceo.run", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "ceo.run",
+        result: resp.data,
+        next_steps: [
+            { command: `naive ceo stream ${data.run_id}`, description: "Stream real-time output from this run" },
+            { command: "naive ceo status", description: "Check the CEO's current status" },
+            { command: "naive tasks list", description: "See tasks the CEO has created" },
+        ],
+        hints: [
+            `CEO run started (id: ${data.run_id})`,
+            "The CEO is now decomposing your prompt into actionable tasks",
+            "Use 'naive ceo stream' to watch progress in real-time",
+        ],
+        related_commands: ["naive ceo stream", "naive ceo status", "naive ceo message", "naive tasks list"],
+    });
+});
+ceoCmd
+    .command("message <text>")
+    .description("Send a message to the CEO agent during an active session")
+    .addHelpText("after", `
+Examples:
+  $ naive ceo message "Focus on the marketing tasks first"
+  $ naive ceo message "Pause all work and give me a status update"
+
+What this does:
+  Sends a real-time message to the active CEO session. Use this to:
+  - Steer the CEO's priorities mid-execution
+  - Ask for a progress update
+  - Provide additional context or constraints
+  - Request course corrections
+
+The CEO will incorporate your message into its current workflow.
+`)
+    .action(async (text) => {
+    const config = loadConfig();
+    const resp = await apiRequest("POST", `/v1/companies/${config.company_id}/ceo/message`, {
+        text,
+    });
+    handleApiError("ceo.message", resp);
+    agentOutput({
+        action: "ceo.message",
+        result: resp.data,
+        next_steps: [
+            { command: "naive ceo status", description: "Check how the CEO is responding to your message" },
+            { command: "naive ceo sessions", description: "View session history" },
+        ],
+        hints: [
+            "Message delivered to the CEO agent",
+            "The CEO will incorporate this into its current execution plan",
+        ],
+        related_commands: ["naive ceo status", "naive ceo run", "naive ceo sessions"],
+    });
+});
+ceoCmd
+    .command("status")
+    .description("Get the CEO agent's current status — active run, idle, or error")
+    .addHelpText("after", `
+Examples:
+  $ naive ceo status
+
+Returns:
+  - Current state (idle, running, error)
+  - Active run ID (if running)
+  - Current objective being worked on
+  - Number of active tasks dispatched
+  - Last activity timestamp
+`)
+    .action(async () => {
+    const config = loadConfig();
+    const resp = await apiRequest("GET", `/v1/companies/${config.company_id}/ceo/status`);
+    handleApiError("ceo.status", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "ceo.status",
+        result: resp.data,
+        next_steps: [
+            ...(data.state === "running" && data.active_run_id
+                ? [{ command: `naive ceo stream ${data.active_run_id}`, description: "Stream the active run's output" }]
+                : []),
+            ...(data.state === "idle"
+                ? [{ command: 'naive ceo run "<prompt>"', description: "Start a new CEO run" }]
+                : []),
+            { command: "naive ceo sessions", description: "View all past sessions" },
+            { command: "naive tasks list", description: "See active tasks" },
+        ],
+        hints: [
+            `CEO is currently: ${data.state}`,
+            ...(data.active_run_id ? [`Active run: ${data.active_run_id}`] : []),
+        ],
+        related_commands: ["naive ceo run", "naive ceo stream", "naive ceo sessions", "naive tasks list"],
+    });
+});
+ceoCmd
+    .command("sessions")
+    .description("List all CEO sessions — past and current runs")
+    .addHelpText("after", `
+Examples:
+  $ naive ceo sessions
+
+Returns a list of all CEO sessions including:
+  - Session/run ID
+  - Original prompt
+  - Status (running, completed, failed)
+  - Start and end timestamps
+  - Number of tasks created
+  - Summary (for completed sessions)
+`)
+    .action(async () => {
+    const config = loadConfig();
+    const resp = await apiRequest("GET", `/v1/companies/${config.company_id}/ceo/sessions`);
+    handleApiError("ceo.sessions", resp);
+    const data = resp.data;
+    const count = data.sessions?.length ?? 0;
+    agentOutput({
+        action: "ceo.sessions",
+        result: resp.data,
+        next_steps: [
+            ...(count > 0
+                ? [{ command: `naive ceo stream ${data.sessions[0].id}`, description: "Stream the most recent session" }]
+                : []),
+            { command: 'naive ceo run "<prompt>"', description: "Start a new CEO session" },
+        ],
+        hints: [
+            `${count} session${count !== 1 ? "s" : ""} found`,
+            "Each session represents a CEO run with its tasks and results",
+        ],
+        related_commands: ["naive ceo run", "naive ceo stream", "naive ceo status"],
+    });
+});
+ceoCmd
+    .command("team-approve")
+    .description("Approve a CEO-proposed team — provisions agent profiles and begins task assignment")
+    .requiredOption("--team <json>", "JSON array of team members (each with name, title, template, optional skills/context)")
+    .option("--tasks <json>", "JSON array of pre-defined tasks (each with title, description, assignee, optional priority/phase)")
+    .option("--objective-id <id>", "Link the team to an objective")
+    .addHelpText("after", `
+Examples:
+  $ naive ceo team-approve --team '[{"name":"Landing Page Engineer","title":"Engineer","template":"engineer"}]'
+  $ naive ceo team-approve --team '[{"name":"Growth Marketer","title":"Marketer","template":"writer"}]' --tasks '[{"title":"Create GTM Plan","description":"Develop go-to-market plan","assignee":"Growth Marketer","priority":"high"}]'
+
+What this does:
+  1. Creates agent records in the database
+  2. Provisions Hermes profiles on the container (with template specialization)
+  3. Creates and assigns any pre-defined tasks
+  4. Notifies the CEO that the team is ready
+  5. Workers are spawned automatically when tasks are dispatched
+
+Team member fields:
+  name     (required) — Display name (use role-based names, e.g. "Landing Page Engineer")
+  title    (required) — Role/title (Engineer, Marketer, Writer, etc.)
+  template (optional) — Specialization: engineer, writer, hunter, or legal
+  skills   (optional) — Array of skill tags for task routing
+  context  (optional) — What this agent works on (e.g. "Build the company landing page")
+  persona  (optional) — Custom persona/system prompt
+
+Task fields:
+  title       (required) — Task title
+  description (required) — Detailed description of the deliverable
+  assignee    (required) — Agent name to assign to (must match a team member name)
+  priority    (optional) — low, medium, high, or critical (default: medium)
+  phase       (optional) — 1 or 2. Phase 1 runs immediately, phase 2 is delegated later.
+`)
+    .action(async (opts) => {
+    const config = loadConfig();
+    let team;
+    try {
+        team = JSON.parse(opts.team);
+    }
+    catch {
+        agentError({
+            action: "ceo.team-approve",
+            error: { code: "invalid_json", message: "The --team flag must be valid JSON" },
+            recovery_steps: [
+                { command: `naive ceo team-approve --team '[{"name":"Alice","title":"Engineer"}]'`, description: "Example with valid JSON" },
+            ],
+        });
+        return;
+    }
+    let tasks;
+    if (opts.tasks) {
+        try {
+            tasks = JSON.parse(opts.tasks);
+        }
+        catch {
+            agentError({
+                action: "ceo.team-approve",
+                error: { code: "invalid_json", message: "The --tasks flag must be valid JSON" },
+                recovery_steps: [
+                    { command: `naive ceo team-approve --team '[...]' --tasks '[{"title":"Build Page","description":"...","assignee":"Engineer"}]'`, description: "Example with valid JSON" },
+                ],
+            });
+            return;
+        }
+    }
+    const body = { team };
+    if (tasks)
+        body.tasks = tasks;
+    if (opts.objectiveId)
+        body.objective_id = opts.objectiveId;
+    const resp = await apiRequest("POST", `/v1/companies/${config.company_id}/ceo/team/approve`, body);
+    handleApiError("ceo.team-approve", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "ceo.team-approve",
+        result: resp.data,
+        next_steps: [
+            { command: "naive employees list", description: "View your provisioned team" },
+            { command: "naive tasks list", description: "See tasks being assigned to the team" },
+            { command: "naive ceo status", description: "Check if the CEO is dispatching work" },
+        ],
+        hints: [
+            `Team approved: ${data.count ?? data.agents_created?.length ?? 0} agent(s) provisioned`,
+            ...(data.agents_created?.length
+                ? [`Agents: ${data.agents_created.map((a) => a.name).join(", ")}`]
+                : []),
+            "The CEO will begin assigning tasks to the new team members",
+        ],
+        related_commands: ["naive employees list", "naive tasks list", "naive ceo run"],
+    });
+});
+ceoCmd
+    .command("stream <runId>")
+    .description("Stream real-time output from a CEO run via Server-Sent Events")
+    .addHelpText("after", `
+Examples:
+  $ naive ceo stream abc-123-run-id
+
+What this does:
+  Opens an SSE (Server-Sent Events) connection to stream the CEO's
+  real-time output. Events include:
+  - thought: CEO's reasoning steps
+  - task_created: new task dispatched
+  - task_completed: employee finished a task
+  - message: CEO status updates
+  - done: run completed
+  - error: something went wrong
+
+Press Ctrl+C to stop streaming (the run continues in the background).
+`)
+    .action(async (runId) => {
+    const config = loadConfig();
+    const apiKey = getApiKey();
+    const url = `${config.base_url}/v1/companies/${config.company_id}/ceo/runs/${runId}/stream`;
+    console.error(`Connecting to CEO stream for run ${runId}...`);
+    try {
+        const resp = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                Accept: "text/event-stream",
+            },
+        });
+        if (!resp.ok || !resp.body) {
+            agentError({
+                action: "ceo.stream",
+                error: { code: "stream_failed", message: `HTTP ${resp.status}: Failed to connect to stream` },
+                recovery_steps: [
+                    { command: `naive ceo stream ${runId}`, description: "Retry the stream connection" },
+                    { command: "naive ceo status", description: "Check if the run is still active" },
+                ],
+            });
+            return;
+        }
+        const reader = resp.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (line.startsWith("data: ")) {
+                    const payload = line.slice(6);
+                    if (payload === "[DONE]") {
+                        agentOutput({
+                            action: "ceo.stream",
+                            result: { status: "completed", run_id: runId },
+                            next_steps: [
+                                { command: "naive tasks list", description: "View tasks created during this run" },
+                                { command: "naive ceo sessions", description: "View all sessions" },
+                            ],
+                            hints: ["CEO run completed — stream ended"],
+                            related_commands: ["naive ceo status", "naive tasks list"],
+                        });
+                        return;
+                    }
+                    try {
+                        const event = JSON.parse(payload);
+                        console.log(JSON.stringify(event));
+                    }
+                    catch {
+                        console.log(payload);
+                    }
+                }
+            }
+        }
+    }
+    catch (err) {
+        agentError({
+            action: "ceo.stream",
+            error: { code: "stream_error", message: String(err) },
+            recovery_steps: [
+                { command: `naive ceo stream ${runId}`, description: "Retry the stream" },
+                { command: "naive ceo status", description: "Check CEO status" },
+            ],
+        });
+    }
+});
+//# sourceMappingURL=ceo.js.map