@jclvsh/iris 0.3.0 → 0.5.0

package/dist/tools/channels.js

@@ -1,31 +1,41 @@
 import { z } from "zod";
 const CHANNELS = ["email", "instagram", "twitter"];
 export function registerChannelTools(server, client) {
-    server.tool("list_connected_accounts", "list all connected social media accounts. requires channels:read scope.", {}, async () => {
+    server.tool("list_connected_accounts", "list all connected social media accounts. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/channels/accounts");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("check_channel_availability", "check which outreach channels are available and configured. requires channels:read scope.", {}, async () => {
+    server.tool("check_channel_availability", "check which outreach channels are available and configured. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/channels/availability");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("send_channel_message", "send a message through a specific channel in a conversation. requires channels:write scope.", {
+    server.tool("send_channel_message", "send a message through a specific channel in a conversation. requires send scope.", {
         channel: z.enum(CHANNELS).describe("outreach channel to use"),
         conversation_id: z.string().uuid().describe("conversation ID"),
         recipient_id: z
@@ -41,7 +51,12 @@ export function registerChannelTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }

package/dist/tools/contacts.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerContactTools(server, client) {
-    server.tool("list_contacts", "list all contacts with optional search. requires contacts:read scope.", {
+    server.tool("list_contacts", "list all contacts with optional search. requires read scope.", {
         page: z.number().int().positive().optional().describe("page number (default 1)"),
         page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
         search: z.string().optional().describe("search by name, email, or company"),
@@ -18,12 +18,17 @@ export function registerContactTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("create_contact", "create a new contact. requires contacts:write scope.", {
+    server.tool("create_contact", "create a new contact. requires write scope.", {
         email: z.string().email().describe("contact email address"),
         first_name: z.string().max(100).optional().describe("first name"),
         last_name: z.string().max(100).optional().describe("last name"),
@@ -39,12 +44,17 @@ export function registerContactTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("get_contact", "get a contact by ID. requires contacts:read scope.", {
+    server.tool("get_contact", "get a contact by ID. requires read scope.", {
         id: z.string().uuid().describe("contact ID"),
     }, async ({ id }) => {
         try {
@@ -53,12 +63,17 @@ export function registerContactTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("update_contact", "update a contact's details. requires contacts:write scope.", {
+    server.tool("update_contact", "update a contact's details. requires write scope.", {
         id: z.string().uuid().describe("contact ID"),
         email: z.string().email().optional().describe("email address"),
         first_name: z.string().max(100).optional().describe("first name"),
@@ -75,12 +90,17 @@ export function registerContactTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("delete_contact", "soft-delete a contact. requires contacts:write scope.", {
+    server.tool("delete_contact", "soft-delete a contact. requires write scope.", {
         id: z.string().uuid().describe("contact ID"),
     }, async ({ id }) => {
         try {
@@ -89,12 +109,17 @@ export function registerContactTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("bulk_import_contacts", "import multiple contacts at once, optionally adding them to a campaign. requires contacts:write scope.", {
+    server.tool("bulk_import_contacts", "import multiple contacts at once, optionally adding them to a campaign. requires write scope.", {
         contacts: z
             .array(z.object({
             email: z.string().email().describe("contact email"),
@@ -115,24 +140,34 @@ export function registerContactTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("get_contact_usage", "get contact usage limits and current counts for the billing period. requires contacts:read scope.", {}, async () => {
+    server.tool("get_contact_usage", "get contact usage limits and current counts for the billing period. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/contacts/usage");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("list_contact_conversations", "list all conversations for a specific contact. requires contacts:read scope.", {
+    server.tool("list_contact_conversations", "list all conversations for a specific contact. requires read scope.", {
         id: z.string().uuid().describe("contact ID"),
     }, async ({ id }) => {
         try {
@@ -141,7 +176,12 @@ export function registerContactTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }

package/dist/tools/conversations.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 const CONVERSATION_STATUSES = ["active", "completed", "failed", "human_review"];
 export function registerConversationTools(server, client) {
-    server.tool("list_conversations", "list conversations with optional filtering. requires conversations:read scope.", {
+    server.tool("list_conversations", "list conversations with optional filtering. requires read scope.", {
         page: z.number().int().positive().optional().describe("page number (default 1)"),
         page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
         status: z.enum(CONVERSATION_STATUSES).optional().describe("filter by conversation status"),
@@ -22,12 +22,17 @@ export function registerConversationTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("get_conversation", "get a conversation by ID with contact and campaign details. requires conversations:read scope.", {
+    server.tool("get_conversation", "get a conversation by ID with contact and campaign details. requires read scope.", {
         id: z.string().uuid().describe("conversation ID"),
     }, async ({ id }) => {
         try {
@@ -36,12 +41,17 @@ export function registerConversationTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("get_conversation_messages", "get all messages in a conversation. requires conversations:read scope.", {
+    server.tool("get_conversation_messages", "get all messages in a conversation. requires read scope.", {
         id: z.string().uuid().describe("conversation ID"),
     }, async ({ id }) => {
         try {
@@ -50,12 +60,17 @@ export function registerConversationTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("mark_conversation_read", "mark a conversation as read. requires conversations:write scope.", {
+    server.tool("mark_conversation_read", "mark a conversation as read. requires write scope.", {
         id: z.string().uuid().describe("conversation ID"),
     }, async ({ id }) => {
         try {
@@ -64,19 +79,29 @@ export function registerConversationTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("get_engagement_metrics", "get overall engagement metrics across all conversations. requires conversations:read scope.", {}, async () => {
+    server.tool("get_engagement_metrics", "get overall engagement metrics across all conversations. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/conversations/engagement");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }

package/dist/tools/discovery.js

@@ -12,7 +12,7 @@ const PROFILE_TYPES = [
     "other",
 ];
 export function registerDiscoveryTools(server, client) {
-    server.tool("search_contacts", "kick off a multi-source contact discovery job (Apify-backed). returns a job_id and contacts when ready (waits up to 90s; if status=queued, poll get_discovery_job). closed source list: google_maps, instagram, twitter, tiktok, reddit. requires discovery:write scope.", {
+    server.tool("search_contacts", "kick off a multi-source contact discovery job (Apify-backed). returns a job_id and contacts when ready (waits up to 90s; if status=queued, poll get_discovery_job). closed source list: google_maps, instagram, twitter, tiktok, reddit. requires generate scope.", {
         keywords: z
             .array(z.string().min(1))
             .min(1)
@@ -37,11 +37,7 @@ export function registerDiscoveryTools(server, client) {
             .enum(PROFILE_TYPES)
             .optional()
             .describe("ICP profile type — drives default source mix when sources is omitted"),
-        campaign_id: z
-            .string()
-            .uuid()
-            .optional()
-            .describe("campaign to attach discovered contacts to on finalize"),
+        campaign_id: z.string().uuid().optional().describe("campaign to attach discovered contacts to on finalize"),
         enrich_emails: z
             .boolean()
             .optional()
@@ -54,12 +50,17 @@ export function registerDiscoveryTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("search_campaign_contacts", "search for contacts matching a campaign's target profiles. requires discovery:write scope.", {
+    server.tool("search_campaign_contacts", "search for contacts matching a campaign's target profiles. requires generate scope.", {
         campaign_id: z.string().uuid().describe("campaign ID"),
         target_profile_id: z.string().uuid().optional().describe("specific target profile to search for"),
     }, async (args) => {
@@ -69,12 +70,17 @@ export function registerDiscoveryTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("get_discovery_job", "get the status, progress, and contacts of a discovery job. status values: pending, running, completed, failed. contacts populated only when status=completed. requires discovery:read scope.", {
+    server.tool("get_discovery_job", "get the status, progress, and contacts of a discovery job. status values: pending, running, completed, failed. contacts populated only when status=completed. requires read scope.", {
         id: z.string().uuid().describe("discovery job ID"),
     }, async ({ id }) => {
         try {
@@ -83,19 +89,29 @@ export function registerDiscoveryTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("list_discovery_sources", "list available discovery data sources and their status. requires discovery:read scope.", {}, async () => {
+    server.tool("list_discovery_sources", "list available discovery data sources and their status. requires read scope.", {}, async () => {
         try {
             const result = await client.get("/discovery/sources");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }

package/dist/tools/keys.js

@@ -1,42 +1,21 @@
 import { z } from "zod";
-const SCOPES = [
-    "campaigns:read",
-    "campaigns:write",
-    "contacts:read",
-    "contacts:write",
-    "conversations:read",
-    "conversations:write",
-    "messages:read",
-    "messages:write",
-    "ai:read",
-    "ai:write",
-    "discovery:read",
-    "discovery:write",
-    "analytics:read",
-    "billing:read",
-    "channels:read",
-    "channels:write",
-    "notifications:read",
-    "notifications:write",
-    "webhooks:read",
-    "webhooks:write",
-    "keys:read",
-    "keys:write",
-];
+const SCOPES = ["read", "write", "delete", "generate", "send", "admin"];
 export function registerKeyTools(server, client) {
-    server.tool("get_current_api_key", "get details about the currently authenticated API key. requires keys:read scope.", {}, async () => {
+    server.tool("get_current_api_key", "get details about the currently authenticated API key.", {}, async () => {
         try {
             const result = await client.get("/keys/me");
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    { type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("list_api_keys", "list all API keys for the account. requires keys:read scope.", {
+    server.tool("list_api_keys", "list all API keys for the account. requires admin scope.", {
         page: z.number().int().positive().optional().describe("page number (default 1)"),
         page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
     }, async ({ page, page_size }) => {
@@ -51,17 +30,22 @@ export function registerKeyTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("create_api_key", "create a new API key. requires keys:write scope.", {
+    server.tool("create_api_key", "create a new API key. requires admin scope.", {
         name: z.string().min(1).max(100).describe("key name for identification"),
         scopes: z
             .array(z.enum(SCOPES))
             .optional()
-            .describe('permission scopes (e.g. ["campaigns:read", "contacts:write"]). defaults to all scopes'),
+            .describe("permission scopes (any of: read, write, delete, generate, send, admin). defaults to all scopes"),
         expires_at: z.string().optional().describe("expiration date in ISO 8601 format"),
     }, async (args) => {
         try {
@@ -70,12 +54,17 @@ export function registerKeyTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("revoke_api_key", "revoke (delete) an API key. requires keys:write scope.", {
+    server.tool("revoke_api_key", "revoke (delete) an API key. requires admin scope.", {
         id: z.string().uuid().describe("API key ID to revoke"),
     }, async ({ id }) => {
         try {
@@ -84,7 +73,12 @@ export function registerKeyTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }

package/dist/tools/messages.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 export function registerMessageTools(server, client) {
-    server.tool("list_pending_messages", "list messages awaiting approval before sending. requires messages:read scope.", {
+    server.tool("list_pending_messages", "list messages awaiting approval before sending. requires read scope.", {
         page: z.number().int().positive().optional().describe("page number (default 1)"),
         page_size: z.number().int().min(1).max(100).optional().describe("items per page (default 50, max 100)"),
         campaign_id: z.string().uuid().optional().describe("filter by campaign ID"),
@@ -18,12 +18,17 @@ export function registerMessageTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("approve_message", "approve a pending message for sending. requires messages:write scope.", {
+    server.tool("approve_message", "approve a pending message for sending. requires send scope.", {
         id: z.string().uuid().describe("message ID"),
     }, async ({ id }) => {
         try {
@@ -32,12 +37,17 @@ export function registerMessageTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("reject_message", "reject a pending message with an optional reason. requires messages:write scope.", {
+    server.tool("reject_message", "reject a pending message with an optional reason. requires send scope.", {
         id: z.string().uuid().describe("message ID"),
         reason: z.string().max(500).optional().describe("reason for rejection"),
     }, async ({ id, reason }) => {
@@ -47,12 +57,17 @@ export function registerMessageTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("retry_message", "retry sending a failed message. requires messages:write scope.", {
+    server.tool("retry_message", "retry sending a failed message. requires send scope.", {
         id: z.string().uuid().describe("message ID"),
     }, async ({ id }) => {
         try {
@@ -61,12 +76,17 @@ export function registerMessageTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("submit_message_feedback", "submit feedback on an AI-generated message to improve future generations. requires messages:write scope.", {
+    server.tool("submit_message_feedback", "submit feedback on an AI-generated message to improve future generations. requires send scope.", {
         id: z.string().uuid().describe("message ID"),
         feedback: z.string().min(1).max(2000).describe("feedback text"),
     }, async ({ id, feedback }) => {
@@ -76,14 +96,19 @@ export function registerMessageTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }
     });
-    server.tool("bulk_message_action", "approve or reject multiple messages at once. requires messages:write scope.", {
+    server.tool("bulk_message_action", "approve or reject multiple messages at once. requires send scope.", {
         action: z.enum(["approve", "reject"]).describe("action to perform"),
-        ids: z.array(z.string().uuid()).min(1).max(100).describe("message IDs to act on"),
+        message_ids: z.array(z.string().uuid()).min(1).max(100).describe("message IDs to act on"),
     }, async (args) => {
         try {
             const result = await client.post("/messages/bulk", args);
@@ -91,7 +116,12 @@ export function registerMessageTools(server, client) {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `error: ${error instanceof Error ? error.message : String(error)}` }],
+                content: [
+                    {
+                        type: "text",
+                        text: `error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
                 isError: true,
             };
         }