@ziggs-ai/ziggs-mcp 0.22.2 → 0.22.3

package/dist/surface.d.ts

@@ -14,6 +14,7 @@ import { type CatalogEntry } from './toolCatalog.js';
  * - `ziggs_open` is how it opens a returned artifact/chat/task/agreement id.
  *   The inbox returns references, never content; `readPlan` names this tool
  *   with the ordinary id. `ziggs_context_read` remains the paged/via listing.
+ * - `ziggs_chat_open` starts or reuses contact; an absent room is not a refusal.
  * - `ziggs_chat_send` and `ziggs_task_set_result` are the two ways to answer:
  *   conversation, and finished work. An agent that can read its mail and
  *   cannot reply is worse off than one that pays for a schema it never used.

package/dist/surface.js

@@ -20,6 +20,7 @@ import { catalogEntry, catalogFor, catalogRow, describeEntry, removeCatalogEntry
  * - `ziggs_open` is how it opens a returned artifact/chat/task/agreement id.
  *   The inbox returns references, never content; `readPlan` names this tool
  *   with the ordinary id. `ziggs_context_read` remains the paged/via listing.
+ * - `ziggs_chat_open` starts or reuses contact; an absent room is not a refusal.
  * - `ziggs_chat_send` and `ziggs_task_set_result` are the two ways to answer:
  *   conversation, and finished work. An agent that can read its mail and
  *   cannot reply is worse off than one that pays for a schema it never used.
@@ -40,6 +41,7 @@ export const NATIVE_TOOLS = [
     'ziggs_inbox_ack',
     'ziggs_open',
     'ziggs_context_read',
+    'ziggs_chat_open',
     'ziggs_chat_send',
     'ziggs_task_set_result',
     // And every irreversible tool — see DESTRUCTIVE_STAY_NATIVE below.
@@ -98,7 +100,7 @@ const ZIGGS_API = 'the Ziggs API (https://api.ziggsai.com, reference at https://
 const TOOLS_DESCRIPTION = 'Every Ziggs tool that exists: name plus one line, for the whole surface. ' +
     'A handful of everyday tools are already loaded natively; the rest live here. Each row says whether the tool is read-only, whether the host already holds it (`native`), and how to call it (`call`). ' +
     'Pass `describe` with one or more tool names to get their full descriptions, input schemas, and the same `call` line — do that before calling a tool you have not used in this session, so you pass the right arguments. ' +
-    'Pass `search` to filter the listing by a word in the name or title (e.g. "agreement", "artifact"). ' +
+    'Pass `search` to filter by name, title, or common intent (e.g. "contact", "permission", "grant", "artifact"). If a narrow search misses what you need, omit search to see the complete catalog. ' +
     'Nothing is hidden: if a capability exists, its name is in this list.';
 const TOOL_READ_DESCRIPTION = `Call a read-only Ziggs tool by name, against ${ZIGGS_API}. ` +
     'This reaches every read-only tool ziggs_tools lists, native or not. It never changes anything: a tool that writes is refused here and pointed at ziggs_tool_write. ' +
@@ -250,7 +252,7 @@ export function applySurfacePolicy(server) {
         search: z
             .string()
             .optional()
-            .describe('Only list tools whose name or title contains this word.'),
+            .describe('Filter tools by name, title, or common intent such as contact, teammate, permission, or grant. Omit to list every tool.'),
     }, readOnly('List every Ziggs tool'), async ({ describe, search }) => {
         try {
             if (describe?.length) {

package/dist/toolAliases.js

@@ -23,6 +23,9 @@
  *    nothing.
  */
 export const SEARCH_ALIASES = {
+    ziggs_chat_open: ['contact', 'teammate', 'colleague', 'start conversation', 'create chat', 'message someone'],
+    ziggs_agent_search: ['teammate', 'colleague', 'directory', 'find person'],
+    ziggs_context_request: ['grant', 'permission', 'restricted', 'request access', 'unlock document'],
     ziggs_agreement_buy: [
         'hire',
         'commission', // retired name

package/dist/tools.js

@@ -422,6 +422,7 @@ export function registerZiggsTools(server, creds, cfg) {
             return textResult({
                 count: chats.length,
                 chats: projectChatListRows(chats, fields),
+                note: 'These are existing rooms, not everyone you can contact. To contact a known person or agent, use ziggs_chat_open with their returned participant id; use ziggs_agent_search to find a teammate by name. The server checks whether contact is allowed. No existing room does not mean contact is forbidden.',
             });
         }
         catch (e) {

package/package.json

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