@jclvsh/iris 0.2.4 → 0.3.0

package/dist/client.js

@@ -1,3 +1,32 @@
+function safeStringify(value) {
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((entry) => {
+            if (typeof entry === "string")
+                return entry;
+            if (entry && typeof entry === "object") {
+                const msg = entry.msg;
+                if (typeof msg === "string")
+                    return msg;
+            }
+            try {
+                return JSON.stringify(entry);
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((p) => typeof p === "string" && p.length > 0);
+        if (parts.length > 0)
+            return parts.join("; ");
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
 export class IrisClient {
     apiKey;
     baseUrl;
@@ -77,7 +106,13 @@ export class IrisClient {
         try {
             const body = await response.json();
             if (body?.error) {
-                const parts = [body.error.message || "unknown error"];
+                const rawMessage = body.error.message;
+                const messageStr = typeof rawMessage === "string" && rawMessage.trim() !== ""
+                    ? rawMessage
+                    : rawMessage != null
+                        ? safeStringify(rawMessage)
+                        : "unknown error";
+                const parts = [messageStr];
                 if (body.error.code)
                     parts.unshift(`[${body.error.code}]`);
                 if (body.error.field)

package/dist/commands/channels.js

@@ -28,7 +28,7 @@ export function registerChannelCommands(program, client) {
     channels
         .command("send")
         .description("send a message through a specific channel in a conversation")
-        .requiredOption("--channel <channel>", "channel: email, instagram, twitter, linkedin")
+        .requiredOption("--channel <channel>", "channel: email, instagram, twitter")
         .requiredOption("--conversation-id <id>", "conversation ID")
         .requiredOption("--recipient-id <id>", "recipient (email for email channel; platform handle/ID for social)")
         .requiredOption("-c, --content <text>", "message content")

package/dist/commands/conversations.js

@@ -11,7 +11,7 @@ export function registerConversationCommands(program, client) {
         .option("-s, --page-size <n>", "items per page (max 100)", "50")
         .option("--status <status>", "filter by status")
         .option("--campaign-id <id>", "filter by campaign")
-        .option("--channel <channel>", "filter by channel: email, instagram, twitter, linkedin")
+        .option("--channel <channel>", "filter by channel: email, instagram, twitter")
         .action(async (opts) => {
         try {
             const params = {};

package/dist/commands/messages.js

@@ -7,7 +7,7 @@ export function registerMessageCommands(program, client) {
         .option("-p, --page <n>", "page number", "1")
         .option("-s, --page-size <n>", "items per page (max 100)", "50")
         .option("--campaign-id <id>", "filter by campaign")
-        .option("--channel <channel>", "filter by channel: email, instagram, twitter, linkedin")
+        .option("--channel <channel>", "filter by channel: email, instagram, twitter")
         .option("--status <status>", "queue status (default: pending_approval)")
         .action(async (opts) => {
         try {

package/dist/tools/campaigns.js

@@ -178,7 +178,7 @@ export function registerCampaignTools(server, client) {
         industries: z.array(z.string()).optional().describe("target industries"),
         discovery_keywords: z.array(z.string()).optional().describe("keywords for contact discovery"),
         recommended_channels: z
-            .array(z.enum(["email", "instagram", "twitter", "linkedin"]))
+            .array(z.enum(["email", "instagram", "twitter"]))
             .optional()
             .describe("recommended outreach channels"),
     }, async ({ id, ...body }) => {

package/dist/tools/channels.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-const CHANNELS = ["email", "instagram", "twitter", "linkedin"];
+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 () => {
         try {

package/dist/tools/discovery.js

@@ -1,11 +1,52 @@
 import { z } from "zod";
-const DISCOVERY_SOURCES = ["google_maps", "instagram", "twitter", "linkedin"];
+const DISCOVERY_SOURCES = ["google_maps", "instagram", "twitter", "tiktok", "reddit"];
+const PROFILE_TYPES = [
+    "local_business",
+    "content_creator",
+    "influencer",
+    "b2b_professional",
+    "ecommerce",
+    "saas_company",
+    "agency",
+    "freelancer",
+    "other",
+];
 export function registerDiscoveryTools(server, client) {
-    server.tool("search_contacts", "search for new contacts using external data sources (Google Maps, social platforms). requires discovery:write scope.", {
-        query: z.string().min(1).max(500).describe("search query"),
-        source: z.enum(DISCOVERY_SOURCES).describe("data source to search"),
-        max_results: z.number().int().min(1).max(100).optional().describe("maximum number of results (default 20)"),
-        campaign_id: z.string().uuid().optional().describe("campaign to add discovered contacts to"),
+    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.", {
+        keywords: z
+            .array(z.string().min(1))
+            .min(1)
+            .describe("non-empty array of search keywords (e.g. ['boutique hotel', 'rooftop venue'])"),
+        location: z
+            .string()
+            .optional()
+            .describe("location for geo-scoped goals (local_business / venue / brick-and-mortar). omit for global goals (creators, b2b, saas)."),
+        radius_miles: z.number().positive().optional().default(25).describe("search radius in miles (default 25)"),
+        max_results: z
+            .number()
+            .int()
+            .min(10)
+            .max(500)
+            .optional()
+            .describe("max contacts to return (10-500, default 50; server clamps to plan cap)"),
+        sources: z
+            .array(z.enum(DISCOVERY_SOURCES))
+            .optional()
+            .describe("override the default per-profile_type source mix. valid: google_maps, instagram, twitter, tiktok, reddit. omit to let the orchestrator pick."),
+        profile_type: z
+            .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"),
+        enrich_emails: z
+            .boolean()
+            .optional()
+            .default(true)
+            .describe("run waterfall email enrichment (BetterContact → FullEnrich → ZeroBounce). default true."),
     }, async (args) => {
         try {
             const result = await client.post("/discovery/search", args);
@@ -33,7 +74,7 @@ export function registerDiscoveryTools(server, client) {
             };
         }
     });
-    server.tool("get_discovery_job", "get the status and results of a discovery job. 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 discovery:read scope.", {
         id: z.string().uuid().describe("discovery job ID"),
     }, async ({ id }) => {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jclvsh/iris",
-	"version": "0.2.4",
+	"version": "0.3.0",
 	"description": "MCP server for the Iris API",
 	"type": "module",
 	"main": "dist/index.js",