@jclvsh/iris 0.2.0

package/dist/commands/contacts.js

@@ -0,0 +1,120 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+export function registerContactCommands(program, client) {
+    const contacts = program.command("contacts").alias("ct").description("manage contacts");
+    contacts
+        .command("list")
+        .description("list contacts with pagination")
+        .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("--search <text>", "search by name, email, or company")
+        .action(async (opts) => {
+        try {
+            const params = {};
+            if (opts.page)
+                params.page = opts.page;
+            if (opts.pageSize)
+                params.page_size = opts.pageSize;
+            if (opts.campaignId)
+                params.campaign_id = opts.campaignId;
+            if (opts.search)
+                params.search = opts.search;
+            const result = await client.get("/contacts", params);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    contacts
+        .command("get <id>")
+        .description("get a contact by ID")
+        .action(async (id) => {
+        try {
+            const result = await client.get(`/contacts/${id}`);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    contacts
+        .command("create")
+        .description("create a new contact")
+        .requiredOption("--campaign-id <id>", "campaign ID")
+        .requiredOption("-e, --email <email>", "contact email")
+        .option("--full-name <name>", "full name")
+        .option("--company-name <name>", "company name")
+        .option("--phone <phone>", "phone number")
+        .action(async (opts) => {
+        try {
+            const body = {
+                campaign_id: opts.campaignId,
+                email: opts.email,
+            };
+            if (opts.fullName)
+                body.full_name = opts.fullName;
+            if (opts.companyName)
+                body.company_name = opts.companyName;
+            if (opts.phone)
+                body.phone = opts.phone;
+            const result = await client.post("/contacts", body);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    contacts
+        .command("update <id>")
+        .description("update a contact")
+        .option("-e, --email <email>", "contact email")
+        .option("--full-name <name>", "full name")
+        .option("--company-name <name>", "company name")
+        .option("--phone <phone>", "phone number")
+        .option("--status <status>", "contact status")
+        .action(async (id, opts) => {
+        try {
+            const body = {};
+            if (opts.email)
+                body.email = opts.email;
+            if (opts.fullName)
+                body.full_name = opts.fullName;
+            if (opts.companyName)
+                body.company_name = opts.companyName;
+            if (opts.phone)
+                body.phone = opts.phone;
+            if (opts.status)
+                body.status = opts.status;
+            const result = await client.patch(`/contacts/${id}`, body);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    contacts
+        .command("delete <id>")
+        .description("delete a contact")
+        .action(async (id) => {
+        try {
+            await client.delete(`/contacts/${id}`);
+            console.log("contact deleted");
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    contacts
+        .command("usage")
+        .description("get contact usage stats for the current billing period")
+        .action(async () => {
+        try {
+            const result = await client.get("/contacts/usage");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/conversations.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { IrisClient } from "../client.js";
+export declare function registerConversationCommands(program: Command, client: IrisClient): void;

package/dist/commands/conversations.js

@@ -0,0 +1,71 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+export function registerConversationCommands(program, client) {
+    const conversations = program
+        .command("conversations")
+        .alias("conv")
+        .description("manage cross-channel conversations");
+    conversations
+        .command("list")
+        .description("list conversations with pagination")
+        .option("-p, --page <n>", "page number", "1")
+        .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")
+        .action(async (opts) => {
+        try {
+            const params = {};
+            if (opts.page)
+                params.page = opts.page;
+            if (opts.pageSize)
+                params.page_size = opts.pageSize;
+            if (opts.status)
+                params.status = opts.status;
+            if (opts.campaignId)
+                params.campaign_id = opts.campaignId;
+            if (opts.channel)
+                params.channel = opts.channel;
+            const result = await client.get("/conversations", params);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    conversations
+        .command("get <id>")
+        .description("get a conversation by ID")
+        .action(async (id) => {
+        try {
+            const result = await client.get(`/conversations/${id}`);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    conversations
+        .command("messages <id>")
+        .description("list messages in a conversation")
+        .action(async (id) => {
+        try {
+            const result = await client.get(`/conversations/${id}/messages`);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    conversations
+        .command("read <id>")
+        .description("mark a conversation as read")
+        .action(async (id) => {
+        try {
+            const result = await client.post(`/conversations/${id}/read`);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/credits.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from "commander";
+import type { IrisClient } from "../client.js";
+/**
+ * Agent credit CLI commands.
+ *
+ * NOTE: credits apply only to agents authenticating via x402 or MPP. With a
+ * regular API key (the typical CLI setup), the balance command returns a
+ * message indicating credits are not applicable, and buy returns a 400.
+ */
+export declare function registerCreditCommands(program: Command, client: IrisClient): void;

package/dist/commands/credits.js

@@ -0,0 +1,38 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+/**
+ * Agent credit CLI commands.
+ *
+ * NOTE: credits apply only to agents authenticating via x402 or MPP. With a
+ * regular API key (the typical CLI setup), the balance command returns a
+ * message indicating credits are not applicable, and buy returns a 400.
+ */
+export function registerCreditCommands(program, client) {
+    const credits = program
+        .command("credits")
+        .alias("cr")
+        .description("agent credit balance and pack purchase (x402/MPP only)");
+    credits
+        .command("balance")
+        .description("check the agent credit balance")
+        .action(async () => {
+        try {
+            const result = await client.get("/agent/credits");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    credits
+        .command("buy")
+        .description("purchase a 5-credit pack via MPP ($12.00 USD). API key users do not need credits.")
+        .action(async () => {
+        try {
+            const result = await client.post("/agent/credits");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/discovery.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { IrisClient } from "../client.js";
+export declare function registerDiscoveryCommands(program: Command, client: IrisClient): void;

package/dist/commands/discovery.js

@@ -0,0 +1,76 @@
+import { formatOutput, handleError, getFormat, parseList } from "../cli-utils.js";
+export function registerDiscoveryCommands(program, client) {
+    const discovery = program.command("discovery").alias("d").description("discover contacts via external sources");
+    discovery
+        .command("search")
+        .description("run a discovery search")
+        .requiredOption("-k, --keywords <list>", "comma-separated search keywords", parseList)
+        .option("-l, --location <location>", "location for local search (city, address, etc.)")
+        .option("--radius-miles <n>", "search radius in miles (default: 25)")
+        .option("--max-results <n>", "max results to return (default: 50, max: 500)")
+        .option("--sources <list>", "comma-separated discovery sources", parseList)
+        .option("--campaign-id <id>", "associate results with this campaign")
+        .option("--profile-type <type>", "target profile type")
+        .option("--no-enrich-emails", "skip email enrichment")
+        .action(async (opts) => {
+        try {
+            const body = { keywords: opts.keywords };
+            if (opts.location)
+                body.location = opts.location;
+            if (opts.radiusMiles)
+                body.radius_miles = Number(opts.radiusMiles);
+            if (opts.maxResults)
+                body.max_results = Number(opts.maxResults);
+            if (opts.sources)
+                body.sources = opts.sources;
+            if (opts.campaignId)
+                body.campaign_id = opts.campaignId;
+            if (opts.profileType)
+                body.profile_type = opts.profileType;
+            if (opts.enrichEmails === false)
+                body.enrich_emails = false;
+            const result = await client.post("/discovery/search", body);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    discovery
+        .command("search-campaign")
+        .description("run discovery scoped to a campaign's target profiles")
+        .requiredOption("--campaign-id <id>", "campaign ID")
+        .action(async (opts) => {
+        try {
+            const result = await client.post("/discovery/search/campaign", { campaign_id: opts.campaignId });
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    discovery
+        .command("sources")
+        .description("list available discovery sources")
+        .action(async () => {
+        try {
+            const result = await client.get("/discovery/sources");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    discovery
+        .command("job <id>")
+        .description("get the status of a discovery job")
+        .action(async (id) => {
+        try {
+            const result = await client.get(`/discovery/jobs/${id}`);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/keys.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { IrisClient } from "../client.js";
+export declare function registerKeyCommands(program: Command, client: IrisClient): void;

package/dist/commands/keys.js

@@ -0,0 +1,70 @@
+import { formatOutput, handleError, getFormat, parseList } from "../cli-utils.js";
+export function registerKeyCommands(program, client) {
+    const keys = program.command("keys").alias("k").description("manage API keys");
+    keys
+        .command("me")
+        .description("get current API key info")
+        .action(async () => {
+        try {
+            const result = await client.get("/keys/me");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    keys
+        .command("list")
+        .description("list API keys (requires admin scope)")
+        .action(async () => {
+        try {
+            const result = await client.get("/keys");
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    keys
+        .command("create")
+        .description("create a new API key (requires admin scope)")
+        .requiredOption("-n, --name <name>", "key name")
+        .option("--scopes <list>", "comma-separated scopes: campaigns:read, campaigns:write, contacts:read, contacts:write, messages:read, messages:write, conversations:read, conversations:write, discovery:write, ai:write, notifications:read, notifications:write, webhooks:read, webhooks:write", parseList)
+        .action(async (opts) => {
+        try {
+            const body = { name: opts.name };
+            if (opts.scopes)
+                body.scopes = opts.scopes;
+            const result = await client.post("/keys", body);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    keys
+        .command("rename <id>")
+        .description("rename an API key (requires admin scope)")
+        .requiredOption("-n, --name <name>", "new key name")
+        .action(async (id, opts) => {
+        try {
+            const result = await client.patch(`/keys/${id}`, { name: opts.name });
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    keys
+        .command("revoke <id>")
+        .description("permanently revoke an API key (requires admin scope)")
+        .action(async (id) => {
+        try {
+            await client.delete(`/keys/${id}`);
+            console.log("api key revoked");
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/messages.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { IrisClient } from "../client.js";
+export declare function registerMessageCommands(program: Command, client: IrisClient): void;

package/dist/commands/messages.js

@@ -0,0 +1,110 @@
+import { formatOutput, handleError, getFormat, parseList } from "../cli-utils.js";
+export function registerMessageCommands(program, client) {
+    const messages = program.command("messages").alias("m").description("manage AI-generated messages and approval queue");
+    messages
+        .command("pending")
+        .description("list messages pending approval")
+        .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("--status <status>", "queue status (default: pending_approval)")
+        .action(async (opts) => {
+        try {
+            const params = {};
+            if (opts.page)
+                params.page = opts.page;
+            if (opts.pageSize)
+                params.page_size = opts.pageSize;
+            if (opts.campaignId)
+                params.campaign_id = opts.campaignId;
+            if (opts.channel)
+                params.channel = opts.channel;
+            if (opts.status)
+                params.status = opts.status;
+            const result = await client.get("/messages/pending", params);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    messages
+        .command("approve <id>")
+        .description("approve a single pending message")
+        .action(async (id) => {
+        try {
+            const result = await client.post(`/messages/${id}/approve`);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    messages
+        .command("reject <id>")
+        .description("reject a single pending message")
+        .option("--reason <text>", "rejection reason")
+        .action(async (id, opts) => {
+        try {
+            const body = {};
+            if (opts.reason)
+                body.reason = opts.reason;
+            const result = await client.post(`/messages/${id}/reject`, body);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    messages
+        .command("retry <id>")
+        .description("retry a failed message send")
+        .action(async (id) => {
+        try {
+            const result = await client.post(`/messages/${id}/retry`);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    messages
+        .command("feedback <id>")
+        .description("submit feedback to improve future AI generations")
+        .requiredOption("-f, --feedback <text>", "feedback text")
+        .option("--approval-queue-id <id>", "approval queue item ID")
+        .action(async (id, opts) => {
+        try {
+            const body = { feedback: opts.feedback };
+            if (opts.approvalQueueId)
+                body.approval_queue_id = opts.approvalQueueId;
+            const result = await client.post(`/messages/${id}/feedback`, body);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    messages
+        .command("bulk")
+        .description("bulk approve or reject pending messages")
+        .requiredOption("-a, --action <action>", "action: approve or reject")
+        .requiredOption("--ids <list>", "comma-separated message IDs", parseList)
+        .option("--reason <text>", "rejection reason (when action is reject)")
+        .action(async (opts) => {
+        try {
+            const body = {
+                action: opts.action,
+                ids: opts.ids,
+            };
+            if (opts.reason)
+                body.reason = opts.reason;
+            const result = await client.post("/messages/bulk", body);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/notifications.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { IrisClient } from "../client.js";
+export declare function registerNotificationCommands(program: Command, client: IrisClient): void;

package/dist/commands/notifications.js

@@ -0,0 +1,66 @@
+import { formatOutput, handleError, getFormat } from "../cli-utils.js";
+export function registerNotificationCommands(program, client) {
+    const notifications = program.command("notifications").alias("n").description("manage user notifications");
+    notifications
+        .command("list")
+        .description("list notifications with pagination")
+        .option("-p, --page <n>", "page number", "1")
+        .option("-s, --page-size <n>", "items per page (max 100)", "50")
+        .action(async (opts) => {
+        try {
+            const params = {};
+            if (opts.page)
+                params.page = opts.page;
+            if (opts.pageSize)
+                params.page_size = opts.pageSize;
+            const result = await client.get("/notifications", params);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    notifications
+        .command("update <id>")
+        .description("update a notification (e.g., mark as read)")
+        .option("--read", "mark as read", true)
+        .option("--unread", "mark as unread")
+        .action(async (id, opts) => {
+        try {
+            const body = {};
+            if (opts.unread)
+                body.read = false;
+            else if (opts.read)
+                body.read = true;
+            const result = await client.patch(`/notifications/${id}`, body);
+            formatOutput(result, getFormat(program.opts()));
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    notifications
+        .command("delete <id>")
+        .description("delete a notification")
+        .action(async (id) => {
+        try {
+            await client.delete(`/notifications/${id}`);
+            console.log("notification deleted");
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    notifications
+        .command("read-all")
+        .description("mark all notifications as read")
+        .action(async () => {
+        try {
+            await client.post("/notifications/read-all");
+            console.log("all notifications marked as read");
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}

package/dist/commands/webhooks.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+import type { IrisClient } from "../client.js";
+export declare function registerWebhookCommands(program: Command, client: IrisClient): void;