capyai 0.3.5 → 0.3.6

package/AGENTS.md

@@ -81,19 +81,22 @@ Config file locations:
 - Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
 - Cursor: `.cursor/mcp.json`
 
-14 MCP tools with full CLI parity:
+17 MCP tools with full CLI parity:
 
 | Tool | What it does | Annotations |
 |------|-------------|-------------|
 | `capy_captain` | Start Captain thread | openWorld |
 | `capy_build` | Start Build agent | openWorld |
+| `capy_start` | Start/resume a backlog task | openWorld |
 | `capy_wait` | Block until done | readOnly, idempotent |
 | `capy_review` | Run quality gates | readOnly |
 | `capy_approve` | Approve task | openWorld |
 | `capy_retry` | Retry with context | openWorld |
+| `capy_re_review` | Trigger Greptile re-review | openWorld |
 | `capy_status` | Task/thread details or dashboard | readOnly, idempotent |
-| `capy_list` | List tasks (filterable) | readOnly, idempotent |
-| `capy_threads` | List threads | readOnly, idempotent |
+| `capy_list` | List tasks (filterable, paginated) | readOnly, idempotent |
+| `capy_threads` | List threads (paginated) | readOnly, idempotent |
+| `capy_thread_messages` | Read thread conversation history | readOnly, idempotent |
 | `capy_diff` | View diff | readOnly |
 | `capy_msg` | Message task/thread | openWorld |
 | `capy_stop` | Stop task/thread | destructive |
@@ -203,21 +206,30 @@ Every command supports `--json` for structured output. Errors always return `{ "
 |---------|-------------|
 | `capy captain "<prompt>"` | Start Captain thread |
 | `capy build "<prompt>"` | Start Build agent (small isolated tasks) |
+| `capy start <id>` | Start/resume a backlog task |
+| `capy stop <id> [reason]` | Stop a running task |
+| `capy msg <id> "<text>"` | Message a running task |
 | `capy wait <id> --timeout=N` | Block until terminal state |
 | `capy review <id>` | Run quality gates (pass/fail) |
+| `capy re-review <id>` | Trigger fresh Greptile review |
 | `capy approve <id>` | Approve if gates pass |
-| `capy retry <id> --fix="..."` | Retry with context |
-| `capy status` | Dashboard |
-| `capy list [status]` | List tasks |
-| `capy get <id>` | Task or thread details |
-| `capy diff <id>` | View diff |
-| `capy pr <id>` | Create PR |
-| `capy watch <id>` | Cron poll + notify |
-| `capy threads list` | List threads |
-| `capy threads get <id>` | Thread details |
+| `capy retry <id> --fix="..."` | Retry with context from failure |
+| `capy status` | Dashboard (all threads + tasks) |
+| `capy list [status]` | List tasks (filter: in_progress, needs_review, backlog, archived) |
+| `capy get <id>` | Task details (jams, PR state, credits) |
+| `capy diff <id>` | View diff (file-by-file with patches) |
+| `capy pr <id> [title]` | Create PR for a task |
+| `capy watch <id>` | Cron poll + notify on completion |
+| `capy unwatch <id>` | Stop watching |
+| `capy watches` | List active watches |
+| `capy threads list` | List Captain threads |
+| `capy threads get <id>` | Thread details (tasks, PRs) |
 | `capy threads msg <id> "<text>"` | Message a thread |
+| `capy threads stop <id>` | Stop a thread |
+| `capy threads messages <id>` | Read thread conversation history |
 | `capy config [key] [value]` | Get/set config |
 | `capy models` | List available models |
+| `capy tools` | Show all commands + env vars |
 
 ### Prompting tips
 

package/README.md

@@ -87,7 +87,7 @@ For agents that prefer MCP over CLI:
 }
 ```
 
-14 tools with full CLI parity: `capy_captain`, `capy_build`, `capy_wait`, `capy_review`, `capy_approve`, `capy_retry`, `capy_status`, `capy_list`, `capy_threads`, `capy_diff`, `capy_msg`, `capy_stop`, `capy_pr`, `capy_models`.
+17 tools with full CLI parity: `capy_captain`, `capy_build`, `capy_start`, `capy_wait`, `capy_review`, `capy_approve`, `capy_retry`, `capy_re_review`, `capy_status`, `capy_list`, `capy_threads`, `capy_thread_messages`, `capy_diff`, `capy_msg`, `capy_stop`, `capy_pr`, `capy_models`.
 
 ## Config
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capyai",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "type": "module",
   "description": "Unofficial Capy.ai CLI for agent orchestration with quality gates",
   "bin": {

package/skills/capy/SKILL.md

@@ -3,7 +3,7 @@ name: capy
 description: Orchestrate Capy.ai coding agents with quality gates. Delegate coding work, wait for completion, review quality, approve or retry.
 metadata:
   author: yazcaleb
-  version: "0.3.5"
+  version: "0.3.6"
 ---
 
 # capy

package/src/api.ts

@@ -72,6 +72,11 @@ export async function listModelsWithKey(apiKey: string, server = "https://capy.a
   return data.models || [];
 }
 
+export async function getProject(id?: string): Promise<Project & { createdAt?: string; updatedAt?: string }> {
+  const pid = id || config.load().projectId;
+  return request("GET", `/projects/${pid}`);
+}
+
 // --- Threads ---
 export async function createThread(prompt: string, model?: string, repos?: unknown[]): Promise<Thread> {
   const cfg = config.load();
@@ -83,10 +88,11 @@ export async function createThread(prompt: string, model?: string, repos?: unkno
   });
 }
 
-export async function listThreads(opts: { limit?: number; status?: string } = {}): Promise<ListResponse<Thread>> {
+export async function listThreads(opts: { limit?: number; status?: string; cursor?: string } = {}): Promise<ListResponse<Thread>> {
   const cfg = config.load();
   const p = new URLSearchParams({ projectId: cfg.projectId, limit: String(opts.limit || 10) });
   if (opts.status) p.set("status", opts.status);
+  if (opts.cursor) p.set("cursor", opts.cursor);
   return request("GET", `/threads?${p}`);
 }
 
@@ -121,10 +127,11 @@ export async function createTask(prompt: string, model?: string, opts: { title?:
   });
 }
 
-export async function listTasks(opts: { limit?: number; status?: string } = {}): Promise<ListResponse<Task>> {
+export async function listTasks(opts: { limit?: number; status?: string; cursor?: string } = {}): Promise<ListResponse<Task>> {
   const cfg = config.load();
   const p = new URLSearchParams({ projectId: cfg.projectId, limit: String(opts.limit || 30) });
   if (opts.status) p.set("status", opts.status);
+  if (opts.cursor) p.set("cursor", opts.cursor);
   return request("GET", `/tasks?${p}`);
 }
 

package/src/mcp.ts

@@ -234,12 +234,13 @@ server.registerTool("capy_list", {
   inputSchema: {
     status: z.string().optional().describe("Filter by status"),
     limit: z.number().optional().describe("Max results (default 30)"),
+    cursor: z.string().optional().describe("Pagination cursor from previous response"),
   },
   annotations: { readOnlyHint: true, idempotentHint: true },
-}, async ({ status, limit }) => {
+}, async ({ status, limit, cursor }) => {
   try {
-    const data = await api.listTasks({ status, limit: limit || 30 });
-    return text(data.items || []);
+    const data = await api.listTasks({ status, limit: limit || 30, cursor });
+    return text({ items: data.items || [], nextCursor: data.nextCursor, hasMore: data.hasMore });
   } catch (e) { return err(e); }
 });
 
@@ -247,12 +248,13 @@ server.registerTool("capy_threads", {
   description: "List Captain threads",
   inputSchema: {
     limit: z.number().optional().describe("Max results (default 10)"),
+    cursor: z.string().optional().describe("Pagination cursor from previous response"),
   },
   annotations: { readOnlyHint: true, idempotentHint: true },
-}, async ({ limit }) => {
+}, async ({ limit, cursor }) => {
   try {
-    const data = await api.listThreads({ limit: limit || 10 });
-    return text(data.items || []);
+    const data = await api.listThreads({ limit: limit || 10, cursor });
+    return text({ items: data.items || [], nextCursor: data.nextCursor, hasMore: data.hasMore });
   } catch (e) { return err(e); }
 });
 
@@ -315,6 +317,61 @@ server.registerTool("capy_pr", {
   } catch (e) { return err(e); }
 });
 
+server.registerTool("capy_start", {
+  description: "Start a backlog task (resume a task that was created but not yet running)",
+  inputSchema: {
+    id: z.string().describe("Task ID"),
+    model: z.string().optional().describe("Model ID override"),
+  },
+  annotations: { openWorldHint: true },
+}, async ({ id, model }) => {
+  try {
+    const data = await api.startTask(id, model);
+    return text(data);
+  } catch (e) { return err(e); }
+});
+
+server.registerTool("capy_thread_messages", {
+  description: "Read the conversation history of a Captain thread",
+  inputSchema: {
+    id: z.string().describe("Thread ID"),
+    limit: z.number().optional().describe("Max messages (default 50)"),
+  },
+  annotations: { readOnlyHint: true, idempotentHint: true },
+}, async ({ id, limit }) => {
+  try {
+    const data = await api.getThreadMessages(id, { limit: limit || 50 });
+    return text(data.items || []);
+  } catch (e) { return err(e); }
+});
+
+server.registerTool("capy_re_review", {
+  description: "Trigger a fresh Greptile code review on a task's PR",
+  inputSchema: {
+    id: z.string().describe("Task ID"),
+  },
+  annotations: { openWorldHint: true },
+}, async ({ id }) => {
+  try {
+    const greptileApi = await import("./greptile.js");
+    const task = await api.getTask(id);
+    const cfg = config.load();
+
+    if (!task.pullRequest?.number) {
+      return { content: [{ type: "text" as const, text: JSON.stringify({ error: { code: "no_pr", message: `Task ${task.identifier} has no PR` } }) }], isError: true as const };
+    }
+
+    const repo = task.pullRequest.repoFullName || cfg.repos[0]?.repoFullName || "";
+    const prNum = task.pullRequest.number;
+    const defaultBranch = cfg.repos.find((r: { repoFullName: string; branch: string }) => r.repoFullName === repo)?.branch || "main";
+
+    const result = await greptileApi.freshReview(repo, prNum, defaultBranch);
+    const unaddressed = await greptileApi.getUnaddressedIssues(repo, prNum, defaultBranch);
+
+    return text({ task: task.identifier, pr: prNum, reviewStatus: result?.status || "triggered", unaddressed });
+  } catch (e) { return err(e); }
+});
+
 server.registerTool("capy_models", {
   description: "List available AI models",
   inputSchema: {},

package/src/types.ts

@@ -31,9 +31,16 @@ export interface Credits {
 }
 
 export interface Jam {
+  id?: string;
   model?: string;
   status?: string;
   credits?: Credits | number;
+  pullRequest?: PullRequestRef;
+  branches?: Record<string, unknown>;
+  git?: unknown;
+  slackThreads?: unknown[];
+  createdAt?: string;
+  updatedAt?: string;
 }
 
 export interface PullRequestRef {
@@ -48,21 +55,29 @@ export interface PullRequestRef {
 
 export interface Task {
   id: string;
+  projectId?: string;
   identifier: string;
   title: string;
   status: string;
   prompt?: string;
-  createdAt?: string;
+  labels?: string[];
   pullRequest?: PullRequestRef;
+  slackThreads?: unknown[];
+  createdAt?: string;
+  updatedAt?: string;
   jams?: Jam[];
 }
 
 export interface Thread {
   id: string;
+  projectId?: string;
   title?: string;
   status: string;
   tasks?: Task[];
   pullRequests?: PullRequestRef[];
+  slackThreads?: unknown[];
+  createdAt?: string;
+  updatedAt?: string;
 }
 
 export interface ThreadMessage {
@@ -178,5 +193,7 @@ export interface ApiResponse {
 
 export interface ListResponse<T> {
   items?: T[];
+  nextCursor?: string;
+  hasMore?: boolean;
   [key: string]: unknown;
 }