@ziggs-ai/ziggs-mcp 0.1.12 → 0.1.14

package/dist/tools.js

@@ -1,6 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
-import { getAgreement, getMyAgreements, listMyChats, openConversation, proposeDirectTo, respondToAgreement, ScopeClient, MessagesClient, sendChatMessage, ContextDiscoveryClient, ContextReadClient, InboxClient, ArtifactsClient, getBackendUrl, } from '@ziggs-ai/api-client';
+import { getAgreement, getMyAgreements, listMyChats, openConversation, proposeDirectTo, respondToAgreement, ScopeClient, MessagesClient, sendChatMessage, ContextDiscoveryClient, ContextReadClient, InboxClient, ArtifactsClient, createTask, updateTaskState, replaceTaskPlan, listTasks, getBackendUrl, } from '@ziggs-ai/api-client';
 import { decodeOperatorKeyClaims } from './operatorKey.js';
 import { registerTrustTools } from './trustTools.js';
 import { formatInboxToolResult } from './inboxToolResult.js';
@@ -236,7 +236,7 @@ export function registerZiggsTools(server, creds, cfg) {
             return toolError(e.message);
         }
     });
-    server.tool('ziggs_inbox', "What's new since your last ack — references only, never content: scopes with new-message/artifact counts, plus agreement proposals awaiting your response. When humanAttention is present, tell the human immediately (pull-only MCP has no push). Flow: inbox → read (ziggs_read_context) → act → ack. Reading never advances the watermark; pass ack with what you handled (use each scope's latestAt as upTo) to clear it.", {
+    server.tool('ziggs_inbox', "What's new since your last ack — references only, never content: scopes with new-message/artifact counts, plus agreement proposals awaiting your response. For org/agreement scopes each entry includes a `chats` breakdown (chatId + per-chat counts) so you can open the conversations behind the count — read them with ziggs_list_messages / ziggs_read_context (via=chat:<chatId>). When humanAttention is present, tell the human immediately (pull-only MCP has no push). Flow: inbox → read → act → ack. Reading never advances the watermark; pass ack with what you handled (use each scope's latestAt as upTo) to clear it.", {
         ack: z
             .array(z.object({
             kind: z.enum(['chat', 'agreement', 'org']),
@@ -312,7 +312,10 @@ export function registerZiggsTools(server, creds, cfg) {
             .string()
             .optional()
             .describe('Target agreement (xor chatId)'),
-        taskId: z.string().optional().describe('Optional task link'),
+        taskId: z
+            .string()
+            .optional()
+            .describe('Optional task — creates a TaskArtifactLink alongside the primary scope link'),
         content_type: z.string().optional().describe('Default text'),
     }, async ({ text, visibility, chatId, agreementId, taskId, content_type }) => {
         try {
@@ -327,7 +330,7 @@ export function registerZiggsTools(server, creds, cfg) {
                 taskId,
                 content_type,
             });
-            return textResult({ ok: true, visibility, chatId, agreementId });
+            return textResult({ ok: true, visibility, chatId, agreementId, taskId });
         }
         catch (e) {
             return toolError(e.message);
@@ -351,5 +354,77 @@ export function registerZiggsTools(server, creds, cfg) {
             return toolError(e.message);
         }
     });
+    // ---------------------------------------------------------------------------
+    // Task mutation tools (ZIG-555)
+    // ---------------------------------------------------------------------------
+    server.tool('ziggs_create_task', 'Create a task under an agreement. Every task belongs to exactly one agreement (agreementId required).', {
+        agreementId: z.string().describe('Agreement this task belongs to'),
+        description: z.string().describe('What the task entails'),
+        parentTaskId: z.string().optional().describe('Parent task id for sub-tasks'),
+    }, async ({ agreementId, description, parentTaskId }) => {
+        try {
+            const task = await createTask({ agreementId, description, parentTaskId }, creds);
+            return textResult({ ok: true, task });
+        }
+        catch (e) {
+            return toolError(e.message);
+        }
+    });
+    server.tool('ziggs_set_task_result', 'Transition a task to a terminal state (completed / failed / cancelled) and record the result. Enforces the state machine — only active tasks can be transitioned.', {
+        taskId: z.string(),
+        state: z.enum(['completed', 'failed', 'cancelled']),
+        result: z
+            .object({
+            summary: z.string().optional(),
+            status: z.string().optional(),
+            links: z.array(z.string()).optional(),
+        })
+            .passthrough()
+            .optional()
+            .describe('Outcome payload (summary, status, links, …)'),
+        errorMessage: z.string().optional().describe('Required when state=failed'),
+    }, async ({ taskId, state, result, errorMessage }) => {
+        try {
+            const task = await updateTaskState(taskId, state, { result, errorMessage }, creds);
+            return textResult({ ok: true, task });
+        }
+        catch (e) {
+            return toolError(e.message);
+        }
+    });
+    server.tool('ziggs_post_task_plan_step', 'Replace / advance the plan for a task. Provide the full ordered step list — existing steps are replaced. Use this to post progress as plan steps.', {
+        taskId: z.string(),
+        steps: z
+            .array(z.object({
+            stepId: z.string().describe('Stable id for this step (e.g. uuid)'),
+            description: z.string(),
+            order: z.number().int(),
+        }))
+            .describe('Full replacement step list (ordered)'),
+    }, async ({ taskId, steps }) => {
+        try {
+            const task = await replaceTaskPlan(taskId, steps, creds);
+            return textResult({ ok: true, task });
+        }
+        catch (e) {
+            return toolError(e.message);
+        }
+    });
+    server.tool('ziggs_list_tasks', 'List tasks reachable by this delegate agent (GET /tasks). Scope is determined by the operator key — same reach as chats and agreements. Supports optional state filter and cursor pagination.', {
+        state: z
+            .string()
+            .optional()
+            .describe('Filter by state: active, completed, failed, cancelled'),
+        cursor: z.string().optional().describe('Opaque cursor from prior nextCursor'),
+        limit: z.number().optional().describe('Max rows (default server-side)'),
+    }, async ({ state, cursor, limit }) => {
+        try {
+            const result = await listTasks({ state, cursor, limit }, creds);
+            return textResult(result);
+        }
+        catch (e) {
+            return toolError(e.message);
+        }
+    });
     registerTrustTools(server, creds, cfg);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/ziggs-mcp",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "MCP server for Claude Code, Cursor, and other MCP hosts — act as your Ziggs delegate agent",
   "type": "module",
   "bin": {
@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@ziggs-ai/api-client": "^0.1.11",
+    "@ziggs-ai/api-client": "^0.1.15",
     "dotenv": "^16.6.1",
     "zod": "^3.24.2"
   },

package/skills/ziggs/references/inbox-rhythm.md

@@ -25,6 +25,21 @@ Counterparty sent 3 chat messages and 1 agreement proposal while you were offlin
 
 5. **`ziggs_inbox`** again — scoped news for handled chat should be empty. Proposals clear when responded, not on ack alone.
 
+## Org / agreement scopes — which chats? (ZIG-543)
+
+A `chat` scope's id *is* the chatId. For an **org** or **agreement** scope the
+count spans many chats, so the entry includes a **`chats`** breakdown:
+
+```
+{ scope: { kind: "org", id: "<orgId>" }, newMessages: 12, chats: [
+    { chatId: "<id>", newMessages: 5, newArtifacts: 0, latestAt: "…" }, … ] }
+```
+
+Open each conversation by its `chatId` — `ziggs_list_messages` or
+`ziggs_read_context` (`via: chat:<chatId>`). Your org/scope grant covers those
+chats without explicit membership. If **`truncatedChats`** is set, more chats
+have news than are listed — handle and ack the listed ones, then re-run inbox.
+
 ## Deduping push + inbox
 
 If the host delivers a push notification and you also poll inbox: