@opally/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Opally
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/SKILL.md

@@ -0,0 +1,118 @@
+# Opally
+
+AI-powered receptionist platform for the hospitality industry. Query guest conversations, email activity, voice calls, leads, and analytics.
+
+## Setup
+
+Install the CLI and configure your API key:
+
+```bash
+npm install -g @opally/cli
+opally config set-key op_live_YOUR_KEY_HERE
+```
+
+Or set via environment variable:
+
+```bash
+export OPALLY_API_KEY=op_live_YOUR_KEY_HERE
+```
+
+## Tools
+
+### leads list
+List guest leads from chat, voice, and messaging channels.
+```bash
+opally leads list [--from <date>] [--to <date>] [--source <chat|voice|whatsapp|messenger|instagram>] [--limit <n>] [--json]
+```
+
+### leads get
+Get detailed information about a specific lead including their conversation.
+```bash
+opally leads get <id> [--json]
+```
+
+### emails list
+List email logs showing processed emails and AI-generated drafts.
+```bash
+opally emails list [--from <date>] [--to <date>] [--status <processed|draft_created|filtered|spam_filtered|paired|deduplicated>] [--limit <n>] [--json]
+```
+
+### emails get
+Get email details including the decrypted AI draft and send status.
+```bash
+opally emails get <id> [--json]
+```
+
+### chats list
+List chat conversations across all messaging platforms.
+```bash
+opally chats list [--from <date>] [--to <date>] [--platform <webchat|whatsapp|messenger|instagram>] [--limit <n>] [--json]
+```
+
+### chats get
+Get chat conversation details including message count and guest email.
+```bash
+opally chats get <id> [--json]
+```
+
+### chats messages
+Read the full message history of a chat conversation.
+```bash
+opally chats messages <id> [--json]
+```
+
+### voice list
+List voice call logs.
+```bash
+opally voice list [--from <date>] [--to <date>] [--limit <n>] [--json]
+```
+
+### voice get
+Get detailed voice call information.
+```bash
+opally voice get <id> [--json]
+```
+
+### analytics overview
+Get a high-level summary of all activity (emails, chats, voice, leads, agent actions).
+```bash
+opally analytics overview [--from <date>] [--to <date>] [--json]
+```
+
+### analytics emails
+Time-series email processing metrics.
+```bash
+opally analytics emails [--from <date>] [--to <date>] [--interval <day|week|month>] [--status <status>] [--json]
+```
+
+### analytics chats
+Time-series chat activity metrics.
+```bash
+opally analytics chats [--from <date>] [--to <date>] [--interval <day|week|month>] [--platform <platform>] [--json]
+```
+
+### analytics voice
+Time-series voice call metrics.
+```bash
+opally analytics voice [--from <date>] [--to <date>] [--interval <day|week|month>] [--json]
+```
+
+### analytics leads
+Time-series lead generation metrics.
+```bash
+opally analytics leads [--from <date>] [--to <date>] [--interval <day|week|month>] [--source <source>] [--json]
+```
+
+### analytics agent-actions
+Time-series metrics for autonomous agent actions (bookings, modifications, etc).
+```bash
+opally analytics agent-actions [--from <date>] [--to <date>] [--interval <day|week|month>] [--action-type <type>] [--status <status>] [--initiator <channel>] [--json]
+```
+
+## Notes
+
+- All dates are ISO 8601 format (e.g., `2026-03-01`)
+- Date ranges are capped at 90 days
+- Use `--json` for machine-readable output (recommended for automated workflows)
+- Pagination: use `--cursor` with the cursor returned from list commands
+- Default limit is 25 results, max 100

package/dist/bin/opally.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/opally.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const config_js_1 = require("../commands/config.js");
+const leads_js_1 = require("../commands/leads.js");
+const emails_js_1 = require("../commands/emails.js");
+const chats_js_1 = require("../commands/chats.js");
+const voice_js_1 = require("../commands/voice.js");
+const analytics_js_1 = require("../commands/analytics.js");
+const program = new commander_1.Command();
+program
+    .name("opally")
+    .description("CLI for the Opally API")
+    .version("0.1.0");
+program.addCommand(config_js_1.configCommand);
+program.addCommand(leads_js_1.leadsCommand);
+program.addCommand(emails_js_1.emailsCommand);
+program.addCommand(chats_js_1.chatsCommand);
+program.addCommand(voice_js_1.voiceCommand);
+program.addCommand(analytics_js_1.analyticsCommand);
+program.parse();

package/dist/client.d.ts

@@ -0,0 +1,16 @@
+export declare function validateId(id: string): string;
+export interface PaginatedResponse<T> {
+    data: T[];
+    pagination: {
+        has_more: boolean;
+        next_cursor: string | null;
+    };
+}
+export interface SingleResponse<T> {
+    data: T;
+}
+export interface ApiError {
+    error: string;
+    details?: string | null;
+}
+export declare function api<T>(path: string, params?: Record<string, string | undefined>): Promise<T>;

package/dist/client.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateId = validateId;
+exports.api = api;
+const config_js_1 = require("./config.js");
+const ID_PATTERN = /^[a-zA-Z0-9_-]+$/;
+function validateId(id) {
+    if (!ID_PATTERN.test(id)) {
+        console.error("Invalid ID format. IDs must be alphanumeric (with - and _ allowed).");
+        process.exit(1);
+    }
+    return id;
+}
+async function api(path, params) {
+    const baseUrl = (0, config_js_1.getBaseUrl)();
+    const url = new URL(`/api/v1${path}`, baseUrl);
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined) {
+                url.searchParams.set(key, value);
+            }
+        }
+    }
+    const res = await fetch(url.toString(), {
+        headers: {
+            Authorization: `Bearer ${(0, config_js_1.getApiKey)()}`,
+            "Content-Type": "application/json",
+        },
+    });
+    const text = await res.text();
+    let body = null;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        // Response is not JSON
+    }
+    if (!res.ok) {
+        if (body && typeof body === "object" && "error" in body) {
+            const err = body;
+            console.error(`Error ${res.status}: ${err.error}`);
+            if (err.details)
+                console.error(`Details: ${err.details}`);
+        }
+        else {
+            console.error(`Error ${res.status}: ${res.statusText || "Request failed"}`);
+            if (text)
+                console.error("Response:", text.slice(0, 500));
+        }
+        process.exit(1);
+    }
+    if (body === null) {
+        console.error("Error: Expected JSON response but received non-JSON body");
+        process.exit(1);
+    }
+    return body;
+}

package/dist/commands/analytics.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const analyticsCommand: Command;

package/dist/commands/analytics.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsCommand = void 0;
+const commander_1 = require("commander");
+const client_js_1 = require("../client.js");
+const output_js_1 = require("../output.js");
+exports.analyticsCommand = new commander_1.Command("analytics")
+    .description("View analytics and metrics");
+exports.analyticsCommand
+    .command("overview")
+    .description("High-level summary of all activity")
+    .option("--from <date>", "Start date (ISO 8601)")
+    .option("--to <date>", "End date (ISO 8601)")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    const res = await (0, client_js_1.api)("/analytics/overview", {
+        from: opts.from,
+        to: opts.to,
+    });
+    if (opts.json) {
+        (0, output_js_1.output)(res, "json");
+        return;
+    }
+    const { period, ...metrics } = res;
+    console.log(`Period: ${period.from} → ${period.to}\n`);
+    for (const [section, data] of Object.entries(metrics)) {
+        console.log(`${section.toUpperCase()}:`);
+        if (typeof data === "object" && data !== null) {
+            for (const [key, val] of Object.entries(data)) {
+                if (typeof val === "object" && val !== null) {
+                    console.log(`  ${key}:`);
+                    for (const [k, v] of Object.entries(val)) {
+                        console.log(`    ${k}: ${v}`);
+                    }
+                }
+                else {
+                    console.log(`  ${key}: ${val}`);
+                }
+            }
+        }
+        else {
+            console.log(`  ${data}`);
+        }
+        console.log();
+    }
+});
+function addTimeSeriesCommand(name, path, description, extraFilters) {
+    const cmd = exports.analyticsCommand
+        .command(name)
+        .description(description)
+        .option("--from <date>", "Start date (ISO 8601)")
+        .option("--to <date>", "End date (ISO 8601)")
+        .option("--interval <interval>", "Granularity: day, week, month", "day")
+        .option("--json", "Output as JSON");
+    if (extraFilters) {
+        for (const f of extraFilters) {
+            cmd.option(`--${f.name} <value>`, f.desc);
+        }
+    }
+    cmd.action(async (opts) => {
+        const params = {
+            from: opts.from,
+            to: opts.to,
+            interval: opts.interval,
+        };
+        if (extraFilters) {
+            for (const f of extraFilters) {
+                const camel = f.name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+                params[f.name.replace(/-/g, "_")] = opts[camel];
+            }
+        }
+        const res = await (0, client_js_1.api)(path, params);
+        if (opts.json) {
+            (0, output_js_1.output)(res, "json");
+            return;
+        }
+        console.log(`Period: ${res.period.from} → ${res.period.to} (${res.interval})\n`);
+        (0, output_js_1.output)(res.data, "table");
+    });
+}
+addTimeSeriesCommand("emails", "/analytics/emails", "Email analytics over time", [
+    { name: "status", desc: "Filter: processed, draft_created, filtered, spam_filtered, paired, deduplicated" },
+]);
+addTimeSeriesCommand("chats", "/analytics/chats", "Chat analytics over time", [
+    { name: "platform", desc: "Filter: webchat, whatsapp, messenger, instagram" },
+]);
+addTimeSeriesCommand("voice", "/analytics/voice", "Voice analytics over time");
+addTimeSeriesCommand("leads", "/analytics/leads", "Lead analytics over time", [
+    { name: "source", desc: "Filter: chat, voice, whatsapp, messenger, instagram" },
+]);
+addTimeSeriesCommand("agent-actions", "/analytics/agent-actions", "Agent action analytics over time", [
+    { name: "action-type", desc: "Filter: booking_modification, booking_cancellation, date_change, room_upgrade, add_service, special_request, general_inquiry, response_generation, tool_execution" },
+    { name: "status", desc: "Filter: pending_approval, auto_executed, manually_approved, rejected, failed, cancelled" },
+    { name: "initiator", desc: "Filter: email, chat, voice, whatsapp, messenger, instagram" },
+]);

package/dist/commands/chats.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const chatsCommand: Command;

package/dist/commands/chats.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatsCommand = void 0;
+const commander_1 = require("commander");
+const client_js_1 = require("../client.js");
+const output_js_1 = require("../output.js");
+exports.chatsCommand = new commander_1.Command("chats")
+    .description("View chat conversations");
+exports.chatsCommand
+    .command("list")
+    .description("List chat conversations")
+    .option("--from <date>", "Start date (ISO 8601)")
+    .option("--to <date>", "End date (ISO 8601)")
+    .option("--platform <platform>", "Filter: webchat, whatsapp, messenger, instagram")
+    .option("--limit <n>", "Results per page (1-100)")
+    .option("--cursor <cursor>", "Pagination cursor")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    const res = await (0, client_js_1.api)("/conversations/chats", {
+        from: opts.from,
+        to: opts.to,
+        platform: opts.platform,
+        limit: opts.limit,
+        cursor: opts.cursor,
+    });
+    (0, output_js_1.output)(res.data, opts.json ? "json" : "table", [
+        "id",
+        "title",
+        "platform",
+        "language",
+        "created_at",
+    ]);
+    if (res.pagination.has_more) {
+        console.log(`\nMore results available. Use --cursor ${res.pagination.next_cursor}`);
+    }
+});
+exports.chatsCommand
+    .command("get <id>")
+    .description("Get chat conversation details")
+    .option("--json", "Output as JSON")
+    .action(async (id, opts) => {
+    const res = await (0, client_js_1.api)(`/conversations/chats/${(0, client_js_1.validateId)(id)}`);
+    const data = res.data;
+    if (opts.json) {
+        (0, output_js_1.output)(data, "json");
+        return;
+    }
+    console.log(`Title:     ${data.title}`);
+    console.log(`Platform:  ${data.platform}`);
+    console.log(`Language:  ${data.language}`);
+    console.log(`Guest:     ${data.guest_email || "(unknown)"}`);
+    console.log(`Messages:  ${data.message_count}`);
+    console.log(`Created:   ${data.created_at}`);
+});
+exports.chatsCommand
+    .command("messages <id>")
+    .description("Get messages in a chat conversation")
+    .option("--json", "Output as JSON")
+    .action(async (id, opts) => {
+    const res = await (0, client_js_1.api)(`/conversations/chats/${(0, client_js_1.validateId)(id)}/messages`);
+    const messages = res.data.messages;
+    if (opts.json) {
+        (0, output_js_1.output)(messages, "json");
+        return;
+    }
+    for (const msg of messages) {
+        const role = msg.role === "assistant" ? "Opally" : "Guest";
+        const time = new Date(msg.created_at).toLocaleString();
+        // Message content may be JSON-encoded chat parts
+        let text = msg.content;
+        try {
+            const parts = JSON.parse(msg.content);
+            if (Array.isArray(parts)) {
+                text = parts
+                    .flatMap((p) => (p.parts || []).filter((pt) => pt.type === "text").map((pt) => pt.text))
+                    .filter(Boolean)
+                    .join("\n") || text;
+            }
+        }
+        catch {
+            // Plain text content, use as-is
+        }
+        console.log(`[${time}] ${role}:`);
+        console.log(`  ${text}\n`);
+    }
+});

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const configCommand: Command;

package/dist/commands/config.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configCommand = void 0;
+const commander_1 = require("commander");
+const config_js_1 = require("../config.js");
+exports.configCommand = new commander_1.Command("config")
+    .description("Manage CLI configuration");
+exports.configCommand
+    .command("set-key <key>")
+    .description("Save your Opally API key")
+    .action((key) => {
+    if (!key.startsWith("op_live_") && !key.startsWith("op_test_")) {
+        console.error("Invalid key format. Expected op_live_* or op_test_*");
+        process.exit(1);
+    }
+    if (key.length < 32) {
+        console.error("Invalid key format. Key is too short.");
+        process.exit(1);
+    }
+    const config = (0, config_js_1.loadConfig)();
+    config.api_key = key;
+    (0, config_js_1.saveConfig)(config);
+    console.log("API key saved to ~/.opally/config.json");
+});
+exports.configCommand
+    .command("set-url <url>")
+    .description("Set the Opally API base URL")
+    .action((url) => {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== "https:") {
+            console.error("Base URL must use HTTPS.");
+            process.exit(1);
+        }
+    }
+    catch {
+        console.error("Invalid URL format.");
+        process.exit(1);
+    }
+    const config = (0, config_js_1.loadConfig)();
+    config.base_url = url;
+    (0, config_js_1.saveConfig)(config);
+    console.log(`Base URL set to ${url}`);
+});
+exports.configCommand
+    .command("show")
+    .description("Show current configuration")
+    .action(() => {
+    const config = (0, config_js_1.loadConfig)();
+    console.log(`API key: ${config.api_key ? config.api_key.slice(0, 12) + "..." : "(not set)"}`);
+    console.log(`Base URL: ${config.base_url || "https://api.opally.com (default)"}`);
+});

package/dist/commands/emails.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const emailsCommand: Command;

package/dist/commands/emails.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emailsCommand = void 0;
+const commander_1 = require("commander");
+const client_js_1 = require("../client.js");
+const output_js_1 = require("../output.js");
+exports.emailsCommand = new commander_1.Command("emails")
+    .description("View email conversations");
+exports.emailsCommand
+    .command("list")
+    .description("List email logs")
+    .option("--from <date>", "Start date (ISO 8601)")
+    .option("--to <date>", "End date (ISO 8601)")
+    .option("--status <status>", "Filter: processed, draft_created, filtered, spam_filtered, paired, deduplicated")
+    .option("--limit <n>", "Results per page (1-100)")
+    .option("--cursor <cursor>", "Pagination cursor")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    const res = await (0, client_js_1.api)("/conversations/emails", {
+        from: opts.from,
+        to: opts.to,
+        status: opts.status,
+        limit: opts.limit,
+        cursor: opts.cursor,
+    });
+    (0, output_js_1.output)(res.data, opts.json ? "json" : "table", [
+        "id",
+        "subject",
+        "sender",
+        "status",
+        "timestamp",
+    ]);
+    if (res.pagination.has_more) {
+        console.log(`\nMore results available. Use --cursor ${res.pagination.next_cursor}`);
+    }
+});
+exports.emailsCommand
+    .command("get <id>")
+    .description("Get email details with draft")
+    .option("--json", "Output as JSON")
+    .action(async (id, opts) => {
+    const res = await (0, client_js_1.api)(`/conversations/emails/${(0, client_js_1.validateId)(id)}`);
+    const data = res.data;
+    if (opts.json) {
+        (0, output_js_1.output)(data, "json");
+        return;
+    }
+    console.log(`Subject:  ${data.subject}`);
+    console.log(`Sender:   ${data.sender}`);
+    console.log(`Status:   ${data.status}`);
+    console.log(`Time:     ${data.timestamp}`);
+    if (data.draft) {
+        console.log(`\n--- Draft ---`);
+        console.log(`Subject:  ${data.draft.subject}`);
+        console.log(`Status:   ${data.draft.status}`);
+        console.log(`Created:  ${data.draft.draft_created_at}`);
+        if (data.draft.sent_at)
+            console.log(`Sent:     ${data.draft.sent_at}`);
+        console.log(`\n${data.draft.body}`);
+    }
+});

package/dist/commands/leads.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const leadsCommand: Command;

package/dist/commands/leads.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.leadsCommand = void 0;
+const commander_1 = require("commander");
+const client_js_1 = require("../client.js");
+const output_js_1 = require("../output.js");
+exports.leadsCommand = new commander_1.Command("leads")
+    .description("Manage chat leads");
+exports.leadsCommand
+    .command("list")
+    .description("List leads")
+    .option("--from <date>", "Start date (ISO 8601)")
+    .option("--to <date>", "End date (ISO 8601)")
+    .option("--source <source>", "Filter: chat, voice, whatsapp, messenger, instagram")
+    .option("--limit <n>", "Results per page (1-100)")
+    .option("--cursor <cursor>", "Pagination cursor")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    const res = await (0, client_js_1.api)("/leads", {
+        from: opts.from,
+        to: opts.to,
+        source: opts.source,
+        limit: opts.limit,
+        cursor: opts.cursor,
+    });
+    (0, output_js_1.output)(res.data, opts.json ? "json" : "table", [
+        "id",
+        "name",
+        "email",
+        "source",
+        "created_at",
+    ]);
+    if (res.pagination.has_more) {
+        console.log(`\nMore results available. Use --cursor ${res.pagination.next_cursor}`);
+    }
+});
+exports.leadsCommand
+    .command("get <id>")
+    .description("Get lead details")
+    .option("--json", "Output as JSON")
+    .action(async (id, opts) => {
+    const res = await (0, client_js_1.api)(`/leads/${(0, client_js_1.validateId)(id)}`);
+    (0, output_js_1.output)(res.data, opts.json ? "json" : "table");
+});

package/dist/commands/voice.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const voiceCommand: Command;

package/dist/commands/voice.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.voiceCommand = void 0;
+const commander_1 = require("commander");
+const client_js_1 = require("../client.js");
+const output_js_1 = require("../output.js");
+exports.voiceCommand = new commander_1.Command("voice")
+    .description("View voice call logs");
+exports.voiceCommand
+    .command("list")
+    .description("List voice calls")
+    .option("--from <date>", "Start date (ISO 8601)")
+    .option("--to <date>", "End date (ISO 8601)")
+    .option("--limit <n>", "Results per page (1-100)")
+    .option("--cursor <cursor>", "Pagination cursor")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    const res = await (0, client_js_1.api)("/conversations/voice", {
+        from: opts.from,
+        to: opts.to,
+        limit: opts.limit,
+        cursor: opts.cursor,
+    });
+    (0, output_js_1.output)(res.data, opts.json ? "json" : "table", [
+        "id",
+        "from_number",
+        "to_number",
+        "duration_seconds",
+        "status",
+        "started_at",
+    ]);
+    if (res.pagination.has_more) {
+        console.log(`\nMore results available. Use --cursor ${res.pagination.next_cursor}`);
+    }
+});
+exports.voiceCommand
+    .command("get <id>")
+    .description("Get voice call details")
+    .option("--json", "Output as JSON")
+    .action(async (id, opts) => {
+    const res = await (0, client_js_1.api)(`/conversations/voice/${(0, client_js_1.validateId)(id)}`);
+    const data = res.data;
+    if (opts.json) {
+        (0, output_js_1.output)(data, "json");
+        return;
+    }
+    console.log(`From:      ${data.from_number}`);
+    console.log(`To:        ${data.to_number}`);
+    console.log(`Status:    ${data.status}`);
+    console.log(`Started:   ${data.started_at}`);
+    if (data.ended_at)
+        console.log(`Ended:     ${data.ended_at}`);
+    console.log(`Duration:  ${data.duration_seconds}s`);
+});

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+export interface Config {
+    api_key?: string;
+    base_url?: string;
+}
+export declare function loadConfig(): Config;
+export declare function saveConfig(config: Config): void;
+export declare function getApiKey(): string;
+export declare function getBaseUrl(): string;

package/dist/config.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.getApiKey = getApiKey;
+exports.getBaseUrl = getBaseUrl;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const CONFIG_DIR = (0, path_1.join)((0, os_1.homedir)(), ".opally");
+const CONFIG_FILE = (0, path_1.join)(CONFIG_DIR, "config.json");
+function loadConfig() {
+    if (!(0, fs_1.existsSync)(CONFIG_FILE))
+        return {};
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(CONFIG_FILE, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function saveConfig(config) {
+    if (!(0, fs_1.existsSync)(CONFIG_DIR)) {
+        (0, fs_1.mkdirSync)(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+    (0, fs_1.writeFileSync)(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", {
+        mode: 0o600,
+    });
+}
+function getApiKey() {
+    const envKey = process.env.OPALLY_API_KEY;
+    if (envKey)
+        return envKey;
+    const config = loadConfig();
+    if (config.api_key)
+        return config.api_key;
+    console.error("No API key found. Set OPALLY_API_KEY or run: opally config set-key <key>");
+    process.exit(1);
+}
+function getBaseUrl() {
+    return (process.env.OPALLY_BASE_URL ||
+        loadConfig().base_url ||
+        "https://api.opally.com");
+}

package/dist/output.d.ts

@@ -0,0 +1,3 @@
+export declare function table(rows: Record<string, unknown>[], columns?: string[]): void;
+export declare function json(data: unknown): void;
+export declare function output(data: unknown, format: "table" | "json", columns?: string[]): void;

package/dist/output.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.table = table;
+exports.json = json;
+exports.output = output;
+function table(rows, columns) {
+    if (rows.length === 0) {
+        console.log("No results.");
+        return;
+    }
+    const cols = columns || Object.keys(rows[0]);
+    // Calculate column widths
+    const widths = cols.map((col) => Math.max(col.length, ...rows.map((row) => String(row[col] ?? "").length)));
+    // Header
+    const header = cols.map((col, i) => col.padEnd(widths[i])).join("  ");
+    const separator = widths.map((w) => "─".repeat(w)).join("──");
+    console.log(header);
+    console.log(separator);
+    // Rows
+    for (const row of rows) {
+        const line = cols
+            .map((col, i) => String(row[col] ?? "").padEnd(widths[i]))
+            .join("  ");
+        console.log(line);
+    }
+}
+function json(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+function output(data, format, columns) {
+    if (format === "json") {
+        json(data);
+    }
+    else if (Array.isArray(data)) {
+        table(data, columns);
+    }
+    else {
+        json(data);
+    }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@opally/cli",
+  "version": "0.1.0",
+  "description": "CLI for the Opally API — query guest conversations, emails, voice calls, leads, and analytics.",
+  "bin": {
+    "opally": "./dist/bin/opally.js"
+  },
+  "files": [
+    "dist",
+    "SKILL.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/bin/opally.ts",
+    "start": "node dist/bin/opally.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opally",
+    "hospitality",
+    "hotel",
+    "cli",
+    "api"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opally-com/opally-cli.git"
+  },
+  "homepage": "https://github.com/opally-com/opally-cli#readme",
+  "bugs": {
+    "url": "https://github.com/opally-com/opally-cli/issues"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}