photon-msg 0.0.0-stage → 0.1.0

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC;;;;;;GAMG;AACH,SAAS,WAAW;IAClB,IAAI,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAClD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAgB,CAAC;gBACvE,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,EAAE,CAAC;oBACzE,OAAO,GAAG,CAAC,OAAO,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,SAAS,GAAG,MAAM,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,OAAO,GAAW,WAAW,EAAE,CAAC;AAE7C,MAAM,CAAC,MAAM,SAAS,GAAG,cAAc,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyD7C,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCP;IACC,eAAe,EAAE;;;;;;;;;;;;CAYlB;IACC,gBAAgB,EAAE;;;;;;CAMnB;IACC,eAAe,EAAE;;;;;CAKlB;IACC,cAAc,EAAE;;;;CAIjB;IACC,oBAAoB,EAAE;;;CAGvB;IACC,MAAM,EAAE;;;CAGT;IACC,aAAa,EAAE;;;;;;CAMhB;CACA,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Programmatic entry point, so the CLI's building blocks can be reused in a
+ * script or an agent without shelling out.
+ */
+export { createPhotonClient, createOfflineClient, pageItems, nextPageToken, handleOf } from "./client.js";
+export type { ClientOptions } from "./client.js";
+export { buildMessage, detectModes, describeContent, validateContentFlags, MODES } from "./content.js";
+export type { BuildMessageInput, ContentMode } from "./content.js";
+export { resolveTarget, resolveUser, normalizeHandle, inferPlatform } from "./target.js";
+export type { ResolveTargetInput, ResolveUserInput } from "./target.js";
+export { createUploader, buildMultipartRelated, contentTypeFor } from "./upload.js";
+export type { UploaderOptions, MultipartInput } from "./upload.js";
+export { resolveConfig, requireCredentials, readConfigFile, redact, ENV, defaultConfigPath } from "./config.js";
+export type { Config, ConfigFile, Credentials, ResolveConfigInput } from "./config.js";
+export { createOutput, formatTime, summarizeContent } from "./output.js";
+export type { Output, OutputOptions, TableColumn } from "./output.js";
+export { CliError, EXIT, PROBLEM_HINTS, toCliError, isApiError, errorPayload, usageError } from "./errors.js";
+export type { CliErrorOptions, ExitCode, ProblemBody, ApiErrorLike } from "./errors.js";
+export { main, ROUTES, commands, hasRoute } from "./cli.js";
+export type { Flags, Command, CommandContext, BuiltMessage, EmailOptions, ResolvedTarget, Uploader, UserLookup, UserRecord, MessageRecord, SpaceRecord, AssignmentRecord, AttachmentRecord, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC1G,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACvG,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChH,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEvF,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9G,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE5D,YAAY,EACV,KAAK,EACL,OAAO,EACP,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * Programmatic entry point, so the CLI's building blocks can be reused in a
+ * script or an agent without shelling out.
+ */
+export { createPhotonClient, createOfflineClient, pageItems, nextPageToken, handleOf } from "./client.js";
+export { buildMessage, detectModes, describeContent, validateContentFlags, MODES } from "./content.js";
+export { resolveTarget, resolveUser, normalizeHandle, inferPlatform } from "./target.js";
+export { createUploader, buildMultipartRelated, contentTypeFor } from "./upload.js";
+export { resolveConfig, requireCredentials, readConfigFile, redact, ENV, defaultConfigPath } from "./config.js";
+export { createOutput, formatTime, summarizeContent } from "./output.js";
+export { CliError, EXIT, PROBLEM_HINTS, toCliError, isApiError, errorPayload, usageError } from "./errors.js";
+export { main, ROUTES, commands, hasRoute } from "./cli.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG1G,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAGvG,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGzF,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGpF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9G,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Output helper: one place that decides between human-readable text and stable
+ * JSON, and that keeps stdout clean so `--json` stays pipeable.
+ */
+import type { Writable } from "node:stream";
+import type { SendContent } from "@photon-ai/api";
+import type { CliError } from "./errors.js";
+export interface OutputOptions {
+    json?: boolean;
+    color?: boolean;
+    stdout?: Writable;
+    stderr?: Writable;
+}
+export interface TableColumn<T> {
+    header: string;
+    value: (row: T) => unknown;
+}
+export interface Output {
+    readonly json: boolean;
+    data(value: unknown): void;
+    line(text?: string): void;
+    success(text: string): void;
+    info(text: string): void;
+    warn(text: string): void;
+    error(cliError: CliError): void;
+    table<T>(rows: T[], columns: Array<TableColumn<T>>): void;
+    heading(text: string): void;
+    keyValue(pairs: Array<[string, unknown]>): void;
+}
+export declare function createOutput({ json, color, stdout, stderr, }?: OutputOptions): Output;
+/** Formats an RFC 3339 timestamp for humans; falls back to the raw string. */
+export declare function formatTime(value: string | undefined): string;
+/** Renders message content as a single line of text for tables and logs. */
+export declare function summarizeContent(content: SendContent | undefined): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAW5C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,wBAAgB,YAAY,CAAC,EAC3B,IAAY,EACZ,KAAa,EACb,MAAuB,EACvB,MAAuB,GACxB,GAAE,aAAkB,GAAG,MAAM,CAsE7B;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAK5D;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CA8BzE"}

package/dist/output.js

@@ -0,0 +1,121 @@
+/**
+ * Output helper: one place that decides between human-readable text and stable
+ * JSON, and that keeps stdout clean so `--json` stays pipeable.
+ */
+const ANSI = {
+    reset: "\u001b[0m",
+    dim: "\u001b[2m",
+    bold: "\u001b[1m",
+    red: "\u001b[31m",
+    green: "\u001b[32m",
+    yellow: "\u001b[33m",
+};
+export function createOutput({ json = false, color = false, stdout = process.stdout, stderr = process.stderr, } = {}) {
+    const paint = (code, text) => (color ? `${code}${text}${ANSI.reset}` : text);
+    return {
+        json,
+        /** Emits the machine-readable result; a no-op unless --json is set. */
+        data(value) {
+            if (!json)
+                return;
+            stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+        },
+        line(text = "") {
+            if (json)
+                return;
+            stdout.write(`${text}\n`);
+        },
+        success(text) {
+            if (json)
+                return;
+            stdout.write(`${paint(ANSI.green, "✓")} ${text}\n`);
+        },
+        info(text) {
+            if (json)
+                return;
+            stdout.write(`${paint(ANSI.dim, text)}\n`);
+        },
+        warn(text) {
+            if (json)
+                return;
+            stderr.write(`${paint(ANSI.yellow, "!")} ${text}\n`);
+        },
+        error(cliError) {
+            stderr.write(`${paint(ANSI.red, "✗")} ${cliError.message}\n`);
+            if (cliError.hint)
+                stderr.write(`  ${cliError.hint}\n`);
+        },
+        /** Simple two-column renderer used by the list commands. */
+        table(rows, columns) {
+            if (json)
+                return;
+            if (rows.length === 0) {
+                this.info("(no results)");
+                return;
+            }
+            const widths = columns.map((column) => Math.max(column.header.length, ...rows.map((row) => String(column.value(row) ?? "").length)));
+            const header = columns.map((column, index) => column.header.padEnd(widths[index] ?? 0)).join("  ");
+            stdout.write(`${paint(ANSI.bold, header)}\n`);
+            for (const row of rows) {
+                const cells = columns.map((column, index) => String(column.value(row) ?? "").padEnd(widths[index] ?? 0));
+                stdout.write(`${cells.join("  ")}\n`);
+            }
+        },
+        heading(text) {
+            if (json)
+                return;
+            stdout.write(`${paint(ANSI.bold, text)}\n`);
+        },
+        keyValue(pairs) {
+            if (json)
+                return;
+            const width = Math.max(...pairs.map(([key]) => key.length));
+            for (const [key, value] of pairs) {
+                stdout.write(`${paint(ANSI.dim, key.padEnd(width))}  ${String(value ?? "")}\n`);
+            }
+        },
+    };
+}
+/** Formats an RFC 3339 timestamp for humans; falls back to the raw string. */
+export function formatTime(value) {
+    if (!value)
+        return "";
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return date.toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z");
+}
+/** Renders message content as a single line of text for tables and logs. */
+export function summarizeContent(content) {
+    if (!content)
+        return "";
+    switch (content.type) {
+        case "text":
+        case "text.update":
+            return content.text;
+        case "attachment":
+            return `[attachment ${content.attachmentId}]`;
+        case "voice":
+            return "[voice note]";
+        case "reaction":
+            return `[reaction ${content.action ?? "add"} ${content.reaction}]`;
+        case "poll":
+        case "poll.update":
+            return `[poll ${content.question}]`;
+        case "poll.vote":
+            return "[poll vote]";
+        case "message.delete":
+            return "[message deleted]";
+        case "message.read":
+            return "[read receipt]";
+        case "space.typing.update":
+            return `[typing ${content.typing ? "on" : "off"}]`;
+        case "space.participants.update":
+            return "[participants updated]";
+        case "group":
+            return `[group of ${content.parts.length}]`;
+        default:
+            return "[unknown content]";
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}

package/dist/target.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Resolves who is sending and where, turning friendly handles into the IDs the
+ * API requires.
+ *
+ * Two addressing styles are supported:
+ *   --space <spaceId> --as <sender>   reply into an existing conversation
+ *   --to <handle> --as <sender>       start (or reuse) a direct conversation
+ *
+ * The second relies on `createOrGetSpace`, so it is idempotent for a given pair
+ * of participants.
+ */
+import type { Photon } from "@photon-ai/api";
+import type { Flags, ResolvedTarget, UserRecord } from "./types.js";
+/** Infers a platform from a handle when --platform is absent. */
+export declare function inferPlatform(handle: string | undefined, fallback?: string): string;
+/** Normalizes a phone number to E.164 when it looks like one; otherwise passes it through. */
+export declare function normalizeHandle(handle: string): string;
+export interface ResolveUserInput {
+    client: Photon;
+    projectId: string;
+    platform: string;
+    input: string;
+    normalize?: boolean;
+}
+/** Accepts a Photon user ID or a handle and returns the user record. */
+export declare function resolveUser({ client, projectId, platform, input, normalize, }: ResolveUserInput): Promise<UserRecord>;
+export interface ResolveTargetInput {
+    client: Photon;
+    projectId: string;
+    flags: Flags;
+    defaultHandle?: string | undefined;
+}
+export declare function resolveTarget({ client, projectId, flags, defaultHandle, }: ResolveTargetInput): Promise<ResolvedTarget>;
+//# sourceMappingURL=target.d.ts.map

package/dist/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../src/target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIpE,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAa,GAAG,MAAM,CAIvF;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,EAChC,MAAM,EACN,SAAS,EACT,QAAQ,EACR,KAAK,EACL,SAAgB,GACjB,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAWxC;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,wBAAsB,aAAa,CAAC,EAClC,MAAM,EACN,SAAS,EACT,KAAK,EACL,aAAa,GACd,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CA0C9C"}

package/dist/target.js

@@ -0,0 +1,75 @@
+/**
+ * Resolves who is sending and where, turning friendly handles into the IDs the
+ * API requires.
+ *
+ * Two addressing styles are supported:
+ *   --space <spaceId> --as <sender>   reply into an existing conversation
+ *   --to <handle> --as <sender>       start (or reuse) a direct conversation
+ *
+ * The second relies on `createOrGetSpace`, so it is idempotent for a given pair
+ * of participants.
+ */
+import { usageError } from "./errors.js";
+const USER_ID = /^pho_usr_[0-9a-z]+$/i;
+/** Infers a platform from a handle when --platform is absent. */
+export function inferPlatform(handle, fallback = "imessage") {
+    if (!handle)
+        return fallback;
+    if (handle.includes("@"))
+        return "email";
+    return fallback;
+}
+/** Normalizes a phone number to E.164 when it looks like one; otherwise passes it through. */
+export function normalizeHandle(handle) {
+    const value = handle.trim();
+    const digits = value.replace(/[^\d+]/g, "");
+    if (/^\+?\d{7,15}$/.test(digits)) {
+        return digits.startsWith("+") ? digits : `+1${digits}`;
+    }
+    return value;
+}
+/** Accepts a Photon user ID or a handle and returns the user record. */
+export async function resolveUser({ client, projectId, platform, input, normalize = true, }) {
+    if (USER_ID.test(input)) {
+        const user = await client.projects.getUser({ path: { id: projectId, userId: input } });
+        return user;
+    }
+    const handle = normalize ? normalizeHandle(input) : input;
+    const user = await client.projects.createOrGetUser({
+        path: { id: projectId },
+        body: { handle, platform },
+    });
+    return user;
+}
+export async function resolveTarget({ client, projectId, flags, defaultHandle, }) {
+    const platform = flags.platform ?? inferPlatform(flags.to);
+    const senderInput = flags.as ?? defaultHandle;
+    if (!senderInput) {
+        throw usageError("No sender. Pass --as <agent handle or user ID>, or set PHOTON_AGENT_HANDLE.", "The sender must be an agent that belongs to this project (for example the number assigned to a shared line).");
+    }
+    const sender = await resolveUser({ client, projectId, platform, input: senderInput });
+    const senderId = String(sender.id);
+    const senderHandle = typeof sender.handle === "string" ? sender.handle : undefined;
+    if (flags.space) {
+        return { spaceId: flags.space, senderId, ...(senderHandle ? { senderHandle } : {}) };
+    }
+    if (!flags.to) {
+        throw usageError("No destination. Pass --to <handle> to start a direct conversation, or --space <spaceId> to use an existing one.");
+    }
+    const peer = await resolveUser({ client, projectId, platform, input: flags.to });
+    const peerId = String(peer.id);
+    const space = await client.projects.createOrGetSpace({
+        path: { id: projectId },
+        headers: {
+            "idempotency-key": flags["idempotency-key"] ?? `photon-msg:space:${senderId}:${peerId}`,
+        },
+        body: { platform, participantIds: [senderId, peerId] },
+    });
+    return {
+        spaceId: String(space.id),
+        senderId,
+        ...(senderHandle ? { senderHandle } : {}),
+        peerId,
+    };
+}
+//# sourceMappingURL=target.js.map

package/dist/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../src/target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,OAAO,GAAG,sBAAsB,CAAC;AAEvC,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,MAA0B,EAAE,QAAQ,GAAG,UAAU;IAC7E,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAUD,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAChC,MAAM,EACN,SAAS,EACT,QAAQ,EACR,KAAK,EACL,SAAS,GAAG,IAAI,GACC;IACjB,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACvF,OAAO,IAA6B,CAAC;IACvC,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC;QACjD,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;QACvB,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;KAC3B,CAAC,CAAC;IACH,OAAO,IAA6B,CAAC;AACvC,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAClC,MAAM,EACN,SAAS,EACT,KAAK,EACL,aAAa,GACM;IACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAE3D,MAAM,WAAW,GAAG,KAAK,CAAC,EAAE,IAAI,aAAa,CAAC;IAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,UAAU,CACd,6EAA6E,EAC7E,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnF,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,MAAM,UAAU,CACd,iHAAiH,CAClH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE/B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACnD,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;QACvB,OAAO,EAAE;YACP,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAAI,oBAAoB,QAAQ,IAAI,MAAM,EAAE;SACxF;QACD,IAAI,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;KACvD,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,QAAQ;QACR,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Shared types for the CLI.
+ *
+ * Payload shapes come from the SDK rather than being re-declared, so the CLI
+ * fails to compile if the API contract changes underneath it.
+ */
+import type { ParseArgsOptionsConfig } from "node:util";
+import type { Photon, SendContent } from "@photon-ai/api";
+import type { Output } from "./output.js";
+import type { Config } from "./config.js";
+/** Uploads a local path or URL and resolves to an attachment ID. */
+export type Uploader = (source: string, options?: {
+    contentType?: string;
+}) => Promise<string>;
+/** Looks up users by Photon ID; used to build participant snapshots. */
+export type UserLookup = (ids: string[]) => Promise<UserRecord[]>;
+/** The subset of a Photon User the CLI relies on. */
+export interface UserRecord {
+    id: string;
+    handle?: string;
+    kind?: string;
+    type?: string;
+    platform?: string;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+/**
+ * Parsed flags. `parseArgs` yields `string | boolean | (string|boolean)[]`, so
+ * array-capable options are typed as `string | string[]` and normalized by
+ * `toArray` at the call site.
+ */
+export interface Flags {
+    help?: boolean;
+    version?: boolean;
+    json?: boolean;
+    color?: boolean;
+    "api-key"?: string;
+    project?: string;
+    "base-url"?: string;
+    timeout?: string;
+    "dry-run"?: boolean;
+    quiet?: boolean;
+    to?: string;
+    space?: string;
+    as?: string;
+    platform?: string;
+    text?: string | string[];
+    "text-file"?: string;
+    format?: string;
+    image?: string | string[];
+    file?: string | string[];
+    caption?: string;
+    voice?: string;
+    reaction?: string;
+    "reaction-action"?: string;
+    poll?: string;
+    "poll-option"?: string | string[];
+    "poll-mode"?: string;
+    edit?: string;
+    delete?: string;
+    reason?: string;
+    read?: boolean;
+    typing?: string;
+    "participants-add"?: string | string[];
+    "participants-remove"?: string | string[];
+    group?: boolean;
+    "reply-to"?: string;
+    "idempotency-key"?: string;
+    subject?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    direction?: string;
+    order?: string;
+    "order-by"?: string;
+    resource?: string;
+    "perspective-user"?: string;
+    "created-since"?: string;
+    "created-before"?: string;
+    "updated-since"?: string;
+    "updated-before"?: string;
+    "exclude-content-types"?: string;
+    "page-size"?: string;
+    "page-token"?: string;
+    limit?: string;
+    interval?: string;
+    for?: string;
+    since?: string;
+    participant?: string | string[];
+    "participant-handle"?: string;
+    handle?: string;
+    email?: string;
+    "first-name"?: string;
+    "last-name"?: string;
+    "include-released"?: boolean;
+    "content-type"?: string;
+    out?: string;
+    on?: boolean;
+    off?: boolean;
+}
+/** Everything a command receives. `client` and `upload` are always present; in
+ * dry-run they throw rather than silently doing nothing. */
+export interface CommandContext {
+    flags: Flags;
+    positionals: string[];
+    config: Config;
+    projectId: string;
+    client: Photon;
+    upload: Uploader;
+    out: Output;
+    dryRun: boolean;
+}
+/** A command implementation. */
+export interface Command {
+    options: ParseArgsOptionsConfig;
+    run(ctx: CommandContext): Promise<void>;
+}
+/** A resolved outbound payload, before it is addressed to a space. */
+export interface BuiltMessage {
+    content: SendContent;
+    parentMessageId?: string;
+    email?: EmailOptions;
+}
+/** Email-only options that travel alongside content. */
+export interface EmailOptions {
+    subject?: string;
+    cc?: Array<{
+        address: string;
+    }>;
+    bcc?: Array<{
+        address: string;
+    }>;
+}
+/** Resolved addressing for a send. */
+export interface ResolvedTarget {
+    spaceId: string;
+    senderId: string;
+    senderHandle?: string;
+    peerId?: string;
+}
+/**
+ * Display projections of API resources.
+ *
+ * The SDK models these as platform-specific unions; the CLI only reads the
+ * fields that every platform shares, so these interfaces keep table and JSON
+ * output typed without pretending to model each platform.
+ */
+export interface MessageRecord {
+    id: string;
+    platform?: string;
+    direction?: string;
+    status?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    space?: {
+        id: string;
+        kind?: string;
+        platform?: string;
+    };
+    sentBy?: {
+        id?: string;
+        kind?: string;
+        handle?: string;
+    };
+    receivedBy?: {
+        id?: string;
+        kind?: string;
+        handle?: string;
+    } | null;
+    content?: SendContent;
+    [key: string]: unknown;
+}
+export interface SpaceRecord {
+    id: string;
+    platform?: string;
+    kind?: string;
+    title?: string;
+    name?: string;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+export interface AssignmentRecord {
+    assignmentId: string;
+    handle: string;
+    assignedPhoneNumber: string;
+    platform?: string;
+    projectId?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    releasedAt?: string;
+    [key: string]: unknown;
+}
+export interface AttachmentRecord {
+    id: string;
+    contentType?: string;
+    filename?: string;
+    sizeBytes?: number;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared types for the CLI.
+ *
+ * Payload shapes come from the SDK rather than being re-declared, so the CLI
+ * fails to compile if the API contract changes underneath it.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/upload.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Attachment upload.
+ *
+ * The endpoint takes `multipart/related` with exactly two parts: a JSON
+ * descriptor followed by the raw bytes. We talk to it with fetch directly rather
+ * than through the SDK, because the SDK's upload method expects a
+ * pre-serialized body and would otherwise fight us over the content type.
+ */
+import type { Uploader } from "./types.js";
+/** Best-effort content type from a filename extension. */
+export declare function contentTypeFor(filename: string): string;
+export interface MultipartInput {
+    descriptor: Record<string, unknown>;
+    bytes: Uint8Array;
+    contentType: string;
+    boundary: string;
+}
+/**
+ * Builds the `multipart/related` body by hand so the framing is exactly what the
+ * API documents: two parts, no extra headers. (The API rejects unsupported
+ * content-type parameters and part headers, which is why nothing else is added.)
+ */
+export declare function buildMultipartRelated({ descriptor, bytes, contentType, boundary, }: MultipartInput): Uint8Array;
+export interface UploaderOptions {
+    apiKey: string;
+    projectId: string;
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+}
+/** Creates an uploader bound to one project. Returns an attachment ID. */
+export declare function createUploader({ apiKey, projectId, baseUrl, fetch: fetchImpl, timeoutMs, }: UploaderOptions): Uploader;
+//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqB3C,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,UAAU,EACV,KAAK,EACL,WAAW,EACX,QAAQ,GACT,EAAE,cAAc,GAAG,UAAU,CAmB7B;AAyBD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,SAAS,EACT,OAA0B,EAC1B,KAAK,EAAE,SAA4B,EACnC,SAAS,GACV,EAAE,eAAe,GAAG,QAAQ,CA2C5B"}