@jclvsh/iris 0.15.0 → 0.17.0

package/dist/commands/conversations.js

@@ -46,11 +46,15 @@ export function registerConversationCommands(program, client) {
     });
     conversations
         .command("create")
-        .description("find-or-create the hub conversation for a contact (not tied to a campaign)")
+        .description("find-or-create a conversation for a contact (hub by default; campaign thread with --campaign-id)")
         .requiredOption("--contact-id <id>", "contact ID to converse with")
+        .option("--campaign-id <id>", "scope to a campaign the contact belongs to")
         .action(async (opts) => {
         try {
-            const result = await client.post("/conversations", { contact_id: opts.contactId });
+            const body = { contact_id: opts.contactId };
+            if (opts.campaignId)
+                body.campaign_id = opts.campaignId;
+            const result = await client.post("/conversations", body);
             formatOutput(result, getFormat(program.opts()));
         }
         catch (error) {

package/dist/commands/messages.js

@@ -72,6 +72,18 @@ export function registerMessageCommands(program, client) {
             handleError(error);
         }
     });
+    messages
+        .command("mark-sent <id>")
+        .description("mark a pending manual-channel draft (tiktok / instagram cold first-touch) as sent outside the platform")
+        .action(async (id) => {
+        try {
+            const result = await client.post(`/messages/${id}/mark-sent`);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
     messages
         .command("feedback <id>")
         .description("submit feedback to improve future AI generations")

package/dist/tools/conversations.js

@@ -47,11 +47,15 @@ export function registerConversationTools(server, client) {
             return formatMcpError(error);
         }
     });
-    server.tool("create_conversation", "find-or-create the hub conversation for a contact (not tied to a campaign) - the entry point for starting outreach outside a campaign flow. requires write scope.", {
+    server.tool("create_conversation", "find-or-create a conversation for a contact - the hub conversation by default, or the campaign-scoped thread when campaign_id is passed (contact must be in that campaign). requires write scope.", {
         contact_id: z.string().uuid().describe("contact ID to converse with"),
-    }, async ({ contact_id }) => {
+        campaign_id: z.string().uuid().optional().describe("scope to a campaign the contact belongs to"),
+    }, async ({ contact_id, campaign_id }) => {
         try {
-            const result = await client.post("/conversations", { contact_id });
+            const body = { contact_id };
+            if (campaign_id)
+                body.campaign_id = campaign_id;
+            const result = await client.post("/conversations", body);
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {

package/dist/tools/messages.js

@@ -55,6 +55,17 @@ export function registerMessageTools(server, client) {
             return formatMcpError(error);
         }
     });
+    server.tool("mark_message_sent", "mark a pending manual-channel draft (tiktok, or instagram cold first-touch) as sent outside the platform. API-sendable drafts must use approve_message instead. requires write scope.", {
+        id: z.string().uuid().describe("approval queue item ID"),
+    }, async ({ id }) => {
+        try {
+            const result = await client.post(`/messages/${id}/mark-sent`);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (error) {
+            return formatMcpError(error);
+        }
+    });
     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"),

package/package.json

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