@jclvsh/iris 0.14.0 → 0.16.0

package/dist/commands/ai.js

@@ -3,11 +3,12 @@ export function registerAICommands(program, client) {
     const ai = program.command("ai").description("AI content generation and analysis");
     ai.command("generate")
         .description("generate AI content (email draft, subject line, etc.)")
-        .requiredOption("-t, --generation-type <type>", "generation type (e.g. email_draft, subject_line)")
+        .requiredOption("-t, --generation-type <type>", "generation type: initial_outreach, follow_up, response_negotiation, meeting_request, or closing")
         .requiredOption("--tone <tone>", "tone (e.g. professional, casual, friendly)")
         .option("--contact-id <id>", "contact ID for personalization")
         .option("--campaign-id <id>", "campaign ID for context")
         .option("--prompt <text>", "free-form prompt context")
+        .option("--format <format>", "email (default) or dm - dm is short platform-native text, empty subject")
         .action(async (opts) => {
         try {
             const body = {
@@ -20,6 +21,8 @@ export function registerAICommands(program, client) {
                 body.campaign_id = opts.campaignId;
             if (opts.prompt)
                 body.prompt = opts.prompt;
+            if (opts.format)
+                body.format = opts.format;
             const result = await client.post("/ai/generate", body);
             formatOutput(result, getFormat(program.opts()));
         }

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")
+        .option("--channel <channel>", "filter by channel: email, instagram, twitter, tiktok")
         .action(async (opts) => {
         try {
             const params = {};
@@ -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) {
@@ -63,7 +67,7 @@ export function registerConversationCommands(program, client) {
         .requiredOption("--content <text>", "message content")
         .requiredOption("--direction <direction>", "inbound or outbound")
         .requiredOption("--status <status>", "draft, queued, sending, pending_approval, sent, delivered, failed, bounced, or rejected")
-        .requiredOption("--channel <channel>", "email, twitter, or instagram")
+        .requiredOption("--channel <channel>", "email, twitter, instagram, or tiktok (tiktok records only - manual send)")
         .option("--platform-recipient-id <id>", "platform recipient id (twitter/instagram channels)")
         .action(async (id, opts) => {
         try {

package/dist/tools/ai.js

@@ -1,14 +1,32 @@
 import { z } from "zod";
 import { formatMcpError } from "../cli-utils.js";
 export function registerAiTools(server, client) {
-    server.tool("generate_content", "generate AI content for a specific contact conversation (email draft, follow-up, reply). requires generate scope.", {
-        contact_id: z.string().uuid().describe("contact ID"),
-        conversation_id: z.string().uuid().describe("conversation ID"),
-        generation_type: z.enum(["initial_email", "follow_up", "reply"]).describe("type of content to generate"),
-        context: z.string().max(2000).optional().describe("additional context for the AI"),
-    }, async (args) => {
+    server.tool("generate_content", "generate AI outreach content (email or DM draft) for a contact/campaign. the contact's tags + enrichment_data feed the generation context automatically. requires generate scope.", {
+        generation_type: z
+            .enum(["initial_outreach", "follow_up", "response_negotiation", "meeting_request", "closing"])
+            .describe("type of content to generate"),
+        tone: z
+            .string()
+            .min(1)
+            .describe("tone (e.g. professional, friendly, casual, formal, persuasive, informative)"),
+        campaign_id: z.string().uuid().optional().describe("campaign to scope the generation to"),
+        contact_id: z
+            .string()
+            .uuid()
+            .optional()
+            .describe("target contact - its tags + enrichment_data are used automatically"),
+        prompt: z.string().optional().describe("additional freeform instructions"),
+        format: z
+            .enum(["email", "dm"])
+            .optional()
+            .describe("dm = short platform-native message text with empty subject. defaults to email"),
+        include_cta: z.boolean().optional().describe("include a clear call-to-action"),
+    }, async ({ include_cta, ...rest }) => {
         try {
-            const result = await client.post("/ai/generate", args);
+            const body = { ...rest };
+            if (include_cta !== undefined)
+                body.input_context = { include_cta };
+            const result = await client.post("/ai/generate", body);
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         catch (error) {

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) {
@@ -63,7 +67,7 @@ export function registerConversationTools(server, client) {
         content: z.string().min(1).describe("message content"),
         direction: z.enum(["inbound", "outbound"]).describe("message direction"),
         status: z.enum(MESSAGE_STATUSES).describe("initial message status"),
-        channel: z.enum(["email", "twitter", "instagram"]).describe("delivery channel"),
+        channel: z.enum(["email", "twitter", "instagram", "tiktok"]).describe("delivery channel (tiktok is manual-send: record only)"),
         platform_recipient_id: z
             .string()
             .optional()

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jclvsh/iris",
-	"version": "0.14.0",
+	"version": "0.16.0",
 	"description": "MCP server for the Iris API",
 	"type": "module",
 	"main": "dist/index.js",
@@ -15,6 +15,7 @@
 	],
 	"scripts": {
 		"build": "tsc",
+		"prepublishOnly": "npm run build",
 		"start": "node dist/index.js"
 	},
 	"dependencies": {