@usenaive-sdk/cli 0.3.1 → 0.4.0

package/dist/commands/tasks.js

@@ -0,0 +1,400 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { agentOutput } from "../output.js";
+export const tasksCmd = new Command("tasks")
+    .description("Kanban task management — list, create, complete, and manage tasks across your AI workforce")
+    .addHelpText("after", `
+Subcommands:
+  naive tasks list                 List tasks (with optional filters)
+  naive tasks create <title>       Create a new task
+  naive tasks show <id>            Show full task details
+  naive tasks run <id>             Trigger a worker to start executing a task
+  naive tasks complete <id>        Mark a task as completed
+  naive tasks block <id>           Mark a task as blocked
+  naive tasks unblock <id>         Remove blocked status from a task
+  naive tasks comment <id> <text>  Add a comment to a task
+  naive tasks dispatch             Dispatch pending tasks to available employees
+  naive tasks stats                Show task board statistics
+
+Workflow:
+  1. naive tasks create "Write blog post" --assignee writer-1  → create a task
+  2. naive tasks list --status in_progress                     → monitor active work
+  3. naive tasks comment <id> "Add SEO keywords"               → provide guidance
+  4. naive tasks complete <id> --summary "Published to blog"   → close the task
+  5. naive tasks stats                                         → review board health
+
+Tasks are the unit of work in the naive kanban system. The CEO creates
+objectives, which are broken into tasks, which are assigned to employees.
+
+Examples:
+  $ naive tasks list
+  $ naive tasks list --status blocked --assignee engineer-1
+  $ naive tasks create "Deploy landing page" --assignee engineer-1
+  $ naive tasks complete abc-123 --summary "Deployed to production"
+  $ naive tasks dispatch
+`);
+tasksCmd
+    .command("list")
+    .description("List tasks with optional filters")
+    .option("--status <status>", "Filter by status: pending | in_progress | completed | blocked")
+    .option("--assignee <agent>", "Filter by assignee agent ID or name")
+    .option("--objective <id>", "Filter by parent objective ID")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks list
+  $ naive tasks list --status in_progress
+  $ naive tasks list --assignee marketer-1
+  $ naive tasks list --objective obj-abc-123
+
+Returns tasks with:
+  - id, title, status, assignee
+  - Parent objective reference
+  - Created/updated timestamps
+  - Priority and tags
+`)
+    .action(async (opts) => {
+    const params = new URLSearchParams();
+    if (opts.status)
+        params.set("status", opts.status);
+    if (opts.assignee)
+        params.set("assignee", opts.assignee);
+    if (opts.objective)
+        params.set("objective", opts.objective);
+    const qs = params.toString();
+    const resp = await apiRequest("GET", `/v1/tasks${qs ? `?${qs}` : ""}`);
+    handleApiError("tasks.list", resp);
+    const data = resp.data;
+    const count = data.tasks?.length ?? 0;
+    const blocked = data.tasks?.filter((t) => t.status === "blocked") ?? [];
+    agentOutput({
+        action: "tasks.list",
+        result: resp.data,
+        next_steps: [
+            ...(count > 0
+                ? [{ command: `naive tasks show ${data.tasks[0].id}`, description: "View details of the first task" }]
+                : []),
+            ...(blocked.length > 0
+                ? [{ command: `naive tasks unblock ${blocked[0].id}`, description: "Unblock a stuck task" }]
+                : []),
+            { command: "naive tasks create <title>", description: "Create a new task" },
+            { command: "naive tasks dispatch", description: "Auto-assign pending tasks to employees" },
+        ],
+        hints: [
+            `${count} task${count !== 1 ? "s" : ""} found${opts.status ? ` (status: ${opts.status})` : ""}`,
+            ...(blocked.length > 0 ? [`${blocked.length} task${blocked.length !== 1 ? "s" : ""} currently blocked`] : []),
+        ],
+        related_commands: ["naive tasks show", "naive tasks create", "naive tasks dispatch", "naive tasks stats"],
+    });
+});
+tasksCmd
+    .command("create <title>")
+    .description("Create a new task on the kanban board")
+    .option("--assignee <agent>", "Assign to a specific employee agent")
+    .option("--objective <id>", "Link to a parent objective")
+    .option("--priority <level>", "Priority: low | medium | high | critical", "medium")
+    .option("--description <text>", "Detailed task description")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks create "Write blog post about AI trends"
+  $ naive tasks create "Deploy landing page" --assignee engineer-1 --priority high
+  $ naive tasks create "Research competitors" --objective obj-abc-123
+
+What this does:
+  Creates a new task in 'pending' status. If --assignee is provided,
+  the task is immediately assigned. Otherwise, use 'naive tasks dispatch'
+  to auto-assign pending tasks to available employees.
+`)
+    .action(async (title, opts) => {
+    const resp = await apiRequest("POST", "/v1/tasks", {
+        title,
+        ...(opts.assignee && { assignee: opts.assignee }),
+        ...(opts.objective && { objective_id: opts.objective }),
+        ...(opts.priority && { priority: opts.priority }),
+        ...(opts.description && { description: opts.description }),
+    });
+    handleApiError("tasks.create", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "tasks.create",
+        result: resp.data,
+        next_steps: [
+            ...(data.assignee
+                ? [{ command: `naive tasks show ${data.id}`, description: "Monitor the assigned task" }]
+                : [{ command: "naive tasks dispatch", description: "Dispatch this task to an available employee" }]),
+            { command: "naive tasks list", description: "View the full task board" },
+        ],
+        hints: [
+            `Task created: "${data.title}" (id: ${data.id})`,
+            data.assignee ? `Assigned to: ${data.assignee}` : "Task is unassigned — use dispatch or assign manually",
+        ],
+        related_commands: ["naive tasks list", "naive tasks dispatch", "naive tasks show"],
+    });
+});
+tasksCmd
+    .command("show <id>")
+    .description("Show full details for a specific task")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks show abc-123-task-id
+
+Returns complete task details:
+  - Title, description, status, priority
+  - Assignee and parent objective
+  - Comments and activity log
+  - Created/updated/completed timestamps
+  - Metadata and handoff summary
+`)
+    .action(async (id) => {
+    const resp = await apiRequest("GET", `/v1/tasks/${id}`);
+    handleApiError("tasks.show", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "tasks.show",
+        result: resp.data,
+        next_steps: [
+            ...(data.status === "in_progress"
+                ? [{ command: `naive tasks complete ${id} --summary "..."`, description: "Mark as completed" }]
+                : []),
+            ...(data.status === "pending"
+                ? [{ command: "naive tasks dispatch", description: "Dispatch pending tasks" }]
+                : []),
+            ...(data.status === "blocked"
+                ? [{ command: `naive tasks unblock ${id}`, description: "Unblock this task" }]
+                : []),
+            { command: `naive tasks comment ${id} "<text>"`, description: "Add a comment" },
+            { command: "naive tasks list", description: "Back to task list" },
+        ],
+        hints: [
+            `Task "${data.title}": ${data.status}`,
+        ],
+        related_commands: ["naive tasks complete", "naive tasks comment", "naive tasks list"],
+    });
+});
+tasksCmd
+    .command("complete <id>")
+    .description("Mark a task as completed with an optional summary and metadata")
+    .option("--summary <text>", "Completion summary describing what was accomplished")
+    .option("--metadata <json>", "JSON metadata to attach (e.g., output URLs, metrics)")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks complete abc-123 --summary "Blog post published at /blog/ai-trends"
+  $ naive tasks complete abc-123 --summary "Done" --metadata '{"url": "https://example.com/post"}'
+
+What this does:
+  Moves the task to 'completed' status. The summary and metadata are
+  stored as the task's handoff — visible to the CEO and other agents
+  for downstream coordination.
+`)
+    .action(async (id, opts) => {
+    const body = { status: "completed" };
+    if (opts.summary)
+        body.summary = opts.summary;
+    if (opts.metadata) {
+        try {
+            body.metadata = JSON.parse(opts.metadata);
+        }
+        catch {
+            body.metadata = opts.metadata;
+        }
+    }
+    const resp = await apiRequest("POST", `/v1/tasks/${id}/complete`, body);
+    handleApiError("tasks.complete", resp);
+    agentOutput({
+        action: "tasks.complete",
+        result: resp.data,
+        next_steps: [
+            { command: "naive tasks list --status pending", description: "Pick up the next pending task" },
+            { command: "naive tasks stats", description: "View board statistics" },
+        ],
+        hints: [
+            `Task ${id} marked as completed`,
+            ...(opts.summary ? [`Summary: ${opts.summary}`] : []),
+        ],
+        related_commands: ["naive tasks list", "naive tasks stats", "naive tasks dispatch"],
+    });
+});
+tasksCmd
+    .command("block <id>")
+    .description("Mark a task as blocked — requires a reason")
+    .requiredOption("--reason <reason>", "Why is this task blocked?")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks block abc-123 --reason "Waiting for domain DNS propagation"
+  $ naive tasks block abc-123 --reason "Need API credentials from client"
+
+Blocked tasks are surfaced to the CEO for resolution or re-assignment.
+`)
+    .action(async (id, opts) => {
+    const resp = await apiRequest("POST", `/v1/tasks/${id}/block`, {
+        reason: opts.reason,
+    });
+    handleApiError("tasks.block", resp);
+    agentOutput({
+        action: "tasks.block",
+        result: resp.data,
+        next_steps: [
+            { command: `naive tasks unblock ${id}`, description: "Unblock when the issue is resolved" },
+            { command: "naive tasks list --status blocked", description: "View all blocked tasks" },
+            { command: "naive ceo message \"Task blocked: " + opts.reason + "\"", description: "Notify the CEO" },
+        ],
+        hints: [
+            `Task ${id} is now blocked`,
+            `Reason: ${opts.reason}`,
+        ],
+        related_commands: ["naive tasks unblock", "naive tasks list", "naive ceo message"],
+    });
+});
+tasksCmd
+    .command("unblock <id>")
+    .description("Remove blocked status from a task — returns it to in_progress")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks unblock abc-123
+
+Moves the task from 'blocked' back to 'in_progress' so the assignee
+can resume work.
+`)
+    .action(async (id) => {
+    const resp = await apiRequest("POST", `/v1/tasks/${id}/unblock`);
+    handleApiError("tasks.unblock", resp);
+    agentOutput({
+        action: "tasks.unblock",
+        result: resp.data,
+        next_steps: [
+            { command: `naive tasks show ${id}`, description: "View the unblocked task" },
+            { command: "naive tasks list --status in_progress", description: "See all active tasks" },
+        ],
+        hints: [
+            `Task ${id} unblocked — back to in_progress`,
+        ],
+        related_commands: ["naive tasks show", "naive tasks list", "naive tasks block"],
+    });
+});
+tasksCmd
+    .command("comment <id> <text>")
+    .description("Add a comment to a task — visible to all agents and the CEO")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks comment abc-123 "Added SEO meta tags to the blog post"
+  $ naive tasks comment abc-123 "Waiting on design assets from the marketer"
+
+Comments create an activity trail on the task for coordination.
+`)
+    .action(async (id, text) => {
+    const resp = await apiRequest("POST", `/v1/tasks/${id}/comments`, {
+        text,
+    });
+    handleApiError("tasks.comment", resp);
+    agentOutput({
+        action: "tasks.comment",
+        result: resp.data,
+        next_steps: [
+            { command: `naive tasks show ${id}`, description: "View the task with all comments" },
+            { command: "naive tasks list", description: "Back to task list" },
+        ],
+        hints: [
+            `Comment added to task ${id}`,
+        ],
+        related_commands: ["naive tasks show", "naive tasks list"],
+    });
+});
+tasksCmd
+    .command("run <id>")
+    .description("Directly trigger a worker to start executing a specific task")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks run abc-123
+  $ naive tasks run t_a2a1ae0c
+
+What this does:
+  Triggers the kanban dispatcher to immediately spawn a worker for
+  the specified task. The task must already be assigned to an employee.
+  Use 'naive tasks list --status in_progress' to monitor the worker's progress.
+`)
+    .action(async (id) => {
+    const resp = await apiRequest("POST", `/v1/tasks/${id}/run`);
+    handleApiError("tasks.run", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "tasks.run",
+        result: resp.data,
+        next_steps: [
+            { command: `naive tasks show ${id}`, description: "Monitor task progress" },
+            { command: "naive tasks list --status in_progress", description: "View all running tasks" },
+        ],
+        hints: [
+            `Worker triggered for task "${data.task.title}"`,
+            ...(data.task.assignee ? [`Assigned to: ${data.task.assignee}`] : []),
+            data.run_triggered ? "Dispatch triggered successfully" : "Dispatch may have failed",
+        ],
+        related_commands: ["naive tasks show", "naive tasks list", "naive tasks dispatch"],
+    });
+});
+tasksCmd
+    .command("dispatch")
+    .description("Auto-dispatch pending tasks to available employees based on skills and capacity")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks dispatch
+
+What this does:
+  The system examines all pending tasks and available employees,
+  then assigns tasks based on:
+  - Employee skill match
+  - Current workload / capacity
+  - Task priority
+  - Objective deadlines
+
+Returns the list of newly assigned tasks and their assignees.
+`)
+    .action(async () => {
+    const resp = await apiRequest("POST", "/v1/tasks/dispatch");
+    handleApiError("tasks.dispatch", resp);
+    const data = resp.data;
+    const count = data.dispatched?.length ?? 0;
+    agentOutput({
+        action: "tasks.dispatch",
+        result: resp.data,
+        next_steps: [
+            { command: "naive tasks list --status in_progress", description: "View newly assigned tasks" },
+            { command: "naive tasks stats", description: "Check board statistics" },
+        ],
+        hints: [
+            `${count} task${count !== 1 ? "s" : ""} dispatched to employees`,
+            ...(count === 0 ? ["No pending tasks to dispatch, or no employees available"] : []),
+        ],
+        related_commands: ["naive tasks list", "naive tasks stats", "naive employees list"],
+    });
+});
+tasksCmd
+    .command("stats")
+    .description("Show kanban board statistics — task counts by status, employee utilization")
+    .addHelpText("after", `
+Examples:
+  $ naive tasks stats
+
+Returns:
+  - Task counts by status (pending, in_progress, completed, blocked)
+  - Average completion time
+  - Employee utilization rates
+  - Blocked task summary
+  - Objective progress overview
+`)
+    .action(async () => {
+    const resp = await apiRequest("GET", "/v1/tasks/stats");
+    handleApiError("tasks.stats", resp);
+    agentOutput({
+        action: "tasks.stats",
+        result: resp.data,
+        next_steps: [
+            { command: "naive tasks list --status blocked", description: "Address blocked tasks" },
+            { command: "naive tasks dispatch", description: "Dispatch pending tasks" },
+            { command: "naive objectives list", description: "Review objective progress" },
+        ],
+        hints: [
+            "Stats reflect the current state of your kanban board",
+        ],
+        related_commands: ["naive tasks list", "naive tasks dispatch", "naive objectives list", "naive employees list"],
+    });
+});
+//# sourceMappingURL=tasks.js.map

package/dist/commands/tasks.js.map

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

package/dist/commands/usage.js

@@ -27,16 +27,16 @@ Use this to:
 
 Credit costs reference:
   Fixed-price operations:
-  - Web search: 0.01 credits
-  - URL extraction: 0.02 credits
-  - Email send: 1.0 credits
+  - Web search: 1 credit
+  - URL read: 1 credit
+  - Email send: 1 credit
   - Stock photo search: free (0 credits)
-  - Deep research: 1.0–5.0 credits (depth-dependent)
+  - Deep research: 3–8 credits (depth-dependent)
 
   Dynamic-price operations (model-dependent):
+  - LLM tokens: per-token billing based on model (see docs)
   - Image generation: varies (GET /v1/images/pricing to preview)
   - Video generation: varies (GET /v1/video/pricing to preview)
-  - Pricing: based on model costs, at $0.50 per credit
 `)
     .action(async (opts) => {
     const resp = await apiRequest("GET", `/v1/usage?days=${opts.days}&limit=${opts.limit}`);