@5ss/ai-tools 2.11.4 → 3.0.0

package/CHANGELOG.md

@@ -4,6 +4,8 @@ All notable changes to `@5ss/ai-tools` are documented here.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Releases are cut by [semantic-release](https://semantic-release.gitbook.io/) from [conventional commits](https://www.conventionalcommits.org/).
 
+## [3.0.0](https://github.com/five-star-solutions-co/ai-tools/compare/v2.11.4...v3.0.0) (2026-08-10)
+
 ## [2.11.4](https://github.com/five-star-solutions-co/ai-tools/compare/v2.11.3...v2.11.4) (2026-08-10)
 
 ## [2.11.3](https://github.com/five-star-solutions-co/ai-tools/compare/v2.11.2...v2.11.3) (2026-08-10)

package/README.md

@@ -145,7 +145,7 @@ defineTool / defineModule
 | `@5ss/ai-tools/telegram` | `telegram-send-text`, `-edit-text`, media, reactions, … | [telegram](./docs/vendors/telegram.md) |
 | `@5ss/ai-tools/slack` | `slack-send-text`, edit, media, reactions, files, … | [slack](./docs/vendors/slack.md) |
 | `@5ss/ai-tools/teams` | `teams-send-text`, edit, media, Bot Framework activities | [teams](./docs/vendors/teams.md) |
-| `@5ss/ai-tools/imessage` | send/edit/react/unsend/read via Photon Advanced iMessage HTTP | [imessage](./docs/vendors/imessage.md) |
+| `@5ss/ai-tools/imessage` | send/edit/react/unsend/read via photon-rest-proxy (HTTP) | [imessage](./docs/vendors/imessage.md) |
 | `@5ss/ai-tools/s3` | `s3-*` (+ signed URL, multipart) | [s3](./docs/vendors/s3.md) |
 | `@5ss/ai-tools/sqs` | `sqs-send`, `-receive`, `-delete`, `-change-visibility` | [sqs](./docs/vendors/sqs.md) |
 | `@5ss/ai-tools/qdrant` | `qdrant-upsert`, `-query`, `-delete` | [qdrant](./docs/vendors/qdrant.md) |

package/dist/imessage-CH49-sFn.js

@@ -0,0 +1,558 @@
+import { t as ToolError } from "./errors-DoSpNHvs.js";
+import { n as defineModule, r as defineTool } from "./define-ieoksEQ0.js";
+import { n as requireAuth } from "./provider-CgDAlg6K.js";
+import { t as HttpService } from "./http-service-DDNCO1s4.js";
+import { t as base64ToBytes } from "./bytes-BxpimpQx.js";
+import { isPlainObject, isString } from "es-toolkit";
+import { z } from "zod";
+//#region src/vendors/imessage/contracts.ts
+/**
+* Host auth for the hosted photon-rest-proxy (REST → Spectrum gRPC).
+* Credentials are forwarded per request; the proxy stores nothing.
+*
+* Proxy route map (package client → HTTP):
+* - sendText → POST /v1/send
+* - editText → POST /v1/edit
+* - sendChatAction / stopTyping → POST /v1/typing
+* - setReaction → POST /v1/react
+* - clearReaction → POST /v1/clear-reaction (target message_id + emoji; proxy gap if not yet supported)
+* - unsend → POST /v1/unsend
+* - read → POST /v1/read
+* - sendMedia → POST /v1/media
+* - downloadFile → POST /v1/download (chat_id optional; proxy gap if still required)
+* - ensureChat → POST /v1/ensure-chat (host-only; proxy gap until implemented)
+*/
+const imessageAuthSchema = z.object({
+	base_url: z.url().describe("Origin of the hosted photon-rest-proxy, for example https://photon-proxy.example.com"),
+	project_id: z.string().min(1).describe("Spectrum project id (sent as x-spectrum-project-id)"),
+	project_secret: z.string().min(1).describe("Spectrum project secret (sent as x-spectrum-project-secret)"),
+	phone: z.string().min(1).optional().describe("Optional default iMessage line phone when the project has multiple lines")
+});
+const imessageChatActionSchema = z.enum([
+	"typing",
+	"upload_photo",
+	"record_video",
+	"upload_video",
+	"record_voice",
+	"upload_voice",
+	"upload_document",
+	"choose_sticker",
+	"find_location",
+	"record_video_note",
+	"upload_video_note"
+]);
+const imessageSendTextInputSchema = z.object({
+	chat_id: z.string().min(1).describe("iMessage chat guid (e.g. any;-;alice@example.com)"),
+	text: z.string().min(1).describe("Message text"),
+	phone: z.string().min(1).optional().describe("Optional line phone override for multi-line projects")
+});
+const imessageMessageOutputSchema = z.object({
+	message_id: z.string().min(1).describe("Message guid (provider id for journaling)"),
+	space_id: z.string().describe("Chat guid (same as chat_id)")
+});
+const imessageEditTextInputSchema = z.object({
+	chat_id: z.string().min(1).describe("iMessage chat guid"),
+	message_id: z.string().min(1).describe("Message guid to edit"),
+	text: z.string().min(1).describe("Replacement text"),
+	phone: z.string().min(1).optional().describe("Optional line phone override")
+});
+const imessageSendChatActionInputSchema = z.object({
+	chat_id: z.string().min(1).describe("iMessage chat guid"),
+	action: imessageChatActionSchema.describe("Chat action; non-typing values map to typing start"),
+	phone: z.string().min(1).optional().describe("Optional line phone override")
+});
+const imessageSetReactionInputSchema = z.object({
+	chat_id: z.string().min(1).describe("iMessage chat guid"),
+	message_id: z.string().min(1).describe("Message guid to react to"),
+	emoji: z.string().min(1).max(64).describe("Tapback name (love, like, dislike, laugh, emphasize, question) or an emoji character the channel accepts"),
+	phone: z.string().min(1).optional().describe("Optional line phone override")
+});
+const imessageUnsendInputSchema = z.object({
+	chat_id: z.string().min(1).describe("iMessage chat guid"),
+	message_id: z.string().min(1).describe("Message guid to unsend"),
+	phone: z.string().min(1).optional().describe("Optional line phone override")
+});
+const imessageReadInputSchema = z.object({
+	chat_id: z.string().min(1).describe("iMessage chat guid"),
+	message_id: z.string().min(1).optional().describe("Optional; mark-read may apply to the whole chat (field kept for seam parity)"),
+	phone: z.string().min(1).optional().describe("Optional line phone override")
+});
+const imessageOkOutputSchema = z.object({
+	ok: z.boolean(),
+	space_id: z.string().optional()
+});
+const MAX_MEDIA_BYTES = 20 * 1024 * 1024;
+/**
+* Clear a reaction. `message_id` is the **target** message that was reacted to;
+* `emoji` must match set-reaction. Proxy should clear by target+emoji (not reaction message id).
+*/
+const imessageClearReactionInputSchema = z.object({
+	chat_id: z.string().min(1).describe("iMessage chat guid"),
+	message_id: z.string().min(1).describe("Target message guid that was reacted to"),
+	emoji: z.string().min(1).max(64).describe("Same tapback name or emoji used when setting the reaction"),
+	phone: z.string().min(1).optional().describe("Optional line phone override")
+});
+const imessageSendMediaInputSchema = z.object({
+	chat_id: z.string().min(1).describe("iMessage chat guid"),
+	kind: z.enum(["photo", "document"]).describe("Media kind (presentation)"),
+	body_base64: z.string().min(1).describe("File body as base64"),
+	file_name: z.string().min(1).describe("File name including extension"),
+	caption: z.string().optional().describe("Optional caption sent as a follow-up text message"),
+	content_type: z.string().optional().describe("Optional MIME type; inferred from file_name when omitted"),
+	phone: z.string().min(1).optional().describe("Optional line phone override")
+});
+const imessageDownloadFileInputSchema = z.object({
+	file_id: z.string().min(1).describe("Attachment guid (from inbound payload or upload)"),
+	file_name: z.string().min(1).optional().describe("Preferred file name for the download result"),
+	chat_id: z.string().min(1).optional().describe("Chat guid (optional when proxy can resolve by file_id alone)"),
+	phone: z.string().min(1).optional().describe("Optional line phone override")
+});
+const imessageDownloadFileOutputSchema = z.object({
+	file_name: z.string(),
+	file_size: z.number().optional(),
+	body_base64: z.string().describe("Downloaded file body as base64")
+});
+/**
+* Create (or resolve) a chat via proxy POST /v1/ensure-chat (host-only).
+* One address = 1:1; two or more = group.
+*/
+const imessageEnsureChatInputSchema = z.object({
+	addresses: z.array(z.string().min(1)).min(1).describe("Peer phone number(s) or email(s). One address creates a 1:1 chat; two or more create a group"),
+	message: z.string().min(1).optional().describe("Optional opening text sent in the same create call"),
+	client_message_id: z.string().min(1).optional().describe("Optional idempotency key for chat creation and the optional opening send"),
+	phone: z.string().min(1).optional().describe("Optional line phone override")
+});
+const imessageEnsureChatOutputSchema = z.object({
+	chat_id: z.string().min(1).describe("Chat guid for later send, edit, react, or unsend"),
+	message_id: z.string().min(1).optional().describe("Guid of the opening message when message was provided and the server returned one")
+});
+//#endregion
+//#region src/vendors/imessage/domain.ts
+/**
+* photon-rest-proxy response parse + failure helpers (no HTTP).
+*/
+var ImessageClientError = class extends ToolError {
+	failureKind;
+	constructor(input) {
+		super(input.message, {
+			code: mapStatusToToolCode(input.status, input.code),
+			retryable: input.failureKind === "outcome_unknown",
+			cause: input.cause,
+			details: {
+				failure_kind: input.failureKind,
+				status: input.status,
+				proxy_error: input.code
+			}
+		});
+		this.name = "ImessageClientError";
+		this.failureKind = input.failureKind;
+	}
+};
+function isImessageDefiniteRejection(error) {
+	return error instanceof ImessageClientError && error.failureKind === "definite_rejection";
+}
+function isImessageOutcomeUnknown(error) {
+	return error instanceof ImessageClientError && error.failureKind === "outcome_unknown";
+}
+function mapStatusToToolCode(status, proxyCode) {
+	if (status === 401) return "bad_auth";
+	if (status === 403) return "forbidden";
+	if (status === 404) return "not_found";
+	if (status === 400) return "bad_input";
+	if (status === 429) return "rate_limited";
+	if (proxyCode === "unauthorized") return "bad_auth";
+	if (proxyCode === "message_not_found" || proxyCode === "not_found") return "not_found";
+	if (proxyCode === "unsupported" || proxyCode === "not_implemented") return "unsupported";
+	return "upstream";
+}
+function isDefiniteStatus(status) {
+	return status === 400 || status === 401 || status === 403 || status === 404;
+}
+/** Parse photon-rest-proxy JSON error body or throw on non-2xx. */
+function assertProxyOk(label, status, data) {
+	if (status >= 200 && status < 300) return;
+	let message = `${label} failed with HTTP ${status}`;
+	let code;
+	if (isPlainObject(data)) {
+		const err = data["error"];
+		const detail = data["detail"];
+		if (isString(err) && err.length > 0) {
+			code = err;
+			message = isString(detail) && detail.length > 0 ? `${err}: ${detail}` : err;
+		} else if (isString(detail) && detail.length > 0) message = detail;
+	}
+	throw new ImessageClientError({
+		message,
+		failureKind: isDefiniteStatus(status) ? "definite_rejection" : "outcome_unknown",
+		status,
+		...code && { code }
+	});
+}
+function requireString(data, key, label) {
+	const value = data[key];
+	if (!isString(value) || value.length === 0) throw new ToolError(`iMessage proxy ${label} missing ${key}`, { code: "upstream" });
+	return value;
+}
+/** Prefer space_id; accept chat_id alias from newer proxy shapes. */
+function spaceOrChatId(data, label) {
+	const spaceId = data["space_id"];
+	if (isString(spaceId) && spaceId.length > 0) return spaceId;
+	const chatId = data["chat_id"];
+	if (isString(chatId) && chatId.length > 0) return chatId;
+	throw new ToolError(`iMessage proxy ${label} missing space_id`, { code: "upstream" });
+}
+function parseMessageResult(data, label = "send") {
+	if (!isPlainObject(data) || data["ok"] !== true) throw new ToolError(`iMessage proxy returned an unexpected ${label} payload`, { code: "upstream" });
+	return {
+		space_id: spaceOrChatId(data, label),
+		message_id: requireString(data, "message_id", label)
+	};
+}
+function parseOkResult(data) {
+	if (!isPlainObject(data) || data["ok"] !== true) throw new ToolError("iMessage proxy returned an unexpected ok payload", { code: "upstream" });
+	const spaceId = data["space_id"];
+	const chatId = data["chat_id"];
+	const id = isString(spaceId) && spaceId.length > 0 ? spaceId : isString(chatId) && chatId.length > 0 ? chatId : void 0;
+	return {
+		ok: true,
+		...id && { space_id: id }
+	};
+}
+function parseEnsureChatResult(data) {
+	if (!isPlainObject(data) || data["ok"] !== true) throw new ToolError("iMessage proxy returned an unexpected ensure-chat payload", { code: "upstream" });
+	const chatId = spaceOrChatId(data, "ensure-chat");
+	const messageId = data["message_id"];
+	return {
+		chat_id: chatId,
+		...isString(messageId) && messageId.length > 0 && { message_id: messageId }
+	};
+}
+/** Map messaging-style chat_id to proxy space_id body fields. */
+function spaceBody(chatId, phone, extra = {}) {
+	return {
+		platform: "imessage",
+		...extra,
+		...chatId && { space_id: chatId },
+		...phone && { phone }
+	};
+}
+/** Decode and size-check media base64 for sendMedia. */
+function decodeMediaBody(bodyBase64) {
+	let bytes;
+	try {
+		bytes = base64ToBytes(bodyBase64);
+	} catch (error) {
+		throw new ToolError("Invalid base64 body", {
+			code: "bad_input",
+			cause: error
+		});
+	}
+	if (bytes.byteLength === 0) throw new ToolError("Media body must not be empty", { code: "bad_input" });
+	if (bytes.byteLength > 20971520) throw new ToolError("Media exceeds 20 MiB limit", {
+		code: "too_large",
+		details: {
+			max_bytes: MAX_MEDIA_BYTES,
+			content_length: bytes.byteLength
+		}
+	});
+}
+/** Build POST /v1/media JSON body (base64 already validated). */
+function mediaBody(input, phone) {
+	decodeMediaBody(input.body_base64);
+	return spaceBody(input.chat_id, phone, {
+		body_base64: input.body_base64,
+		file_name: input.file_name,
+		...input.content_type && { mime_type: input.content_type },
+		...input.caption && { caption: input.caption }
+	});
+}
+function parseDownloadResult(input, data) {
+	if (!isPlainObject(data) || data["ok"] !== true) throw new ToolError("iMessage proxy returned an unexpected download payload", { code: "upstream" });
+	const bodyBase64 = data["body_base64"];
+	if (!isString(bodyBase64) || bodyBase64.length === 0) throw new ToolError("iMessage proxy download missing body_base64", { code: "upstream" });
+	const name = data["file_name"];
+	const size = data["file_size"];
+	return {
+		file_name: input.file_name ?? (isString(name) && name.length > 0 ? name : input.file_id),
+		...typeof size === "number" && Number.isFinite(size) && { file_size: size },
+		body_base64: bodyBase64
+	};
+}
+//#endregion
+//#region src/vendors/imessage/client.ts
+/**
+* iMessage vendor client via hosted photon-rest-proxy (REST → Spectrum gRPC).
+* Host: `new ImessageClient(auth)`. Agent tools: `fromContext(ctx)`.
+*
+* Workers-safe: only HTTP to the proxy. No Photon SDK / gRPC in this package.
+*/
+var ImessageClient = class ImessageClient {
+	#http;
+	#defaultPhone;
+	constructor(auth, options = {}) {
+		const parsed = imessageAuthSchema.safeParse(auth);
+		if (!parsed.success) throw new ToolError("Invalid iMessage auth credentials", {
+			code: "bad_auth",
+			details: { issues: parsed.error.issues.map((issue) => issue.message) }
+		});
+		const { base_url, project_id, project_secret, phone } = parsed.data;
+		this.#defaultPhone = phone;
+		this.#http = new HttpService({
+			...options,
+			baseURL: base_url,
+			headers: {
+				"Content-Type": "application/json",
+				"x-spectrum-project-id": project_id,
+				"x-spectrum-project-secret": project_secret
+			},
+			label: "iMessage"
+		});
+	}
+	static fromContext(ctx) {
+		const auth = requireAuth(ctx, imessageAuthSchema);
+		return new ImessageClient(auth, {
+			...ctx.fetch && { fetch: ctx.fetch },
+			...ctx.signal && { signal: ctx.signal }
+		});
+	}
+	#phone(override) {
+		return override ?? this.#defaultPhone;
+	}
+	async #post(path, body, label) {
+		const res = await this.#http.post(path, body, {
+			label,
+			noThrow: true
+		});
+		assertProxyOk(label, res.status, res.data);
+		return res.data;
+	}
+	/**
+	* Create a chat (1:1 or group). Host-only; not an agent tool.
+	* Proxy: POST /v1/ensure-chat (fill on proxy if not yet shipped).
+	*/
+	async ensureChat(input) {
+		return parseEnsureChatResult(await this.#post("/v1/ensure-chat", spaceBody(void 0, this.#phone(input.phone), {
+			addresses: input.addresses,
+			...input.message && { message: input.message },
+			...input.client_message_id && { client_message_id: input.client_message_id }
+		}), "iMessage ensureChat"));
+	}
+	/** POST /v1/send */
+	async sendText(input) {
+		return parseMessageResult(await this.#post("/v1/send", spaceBody(input.chat_id, this.#phone(input.phone), { text: input.text }), "iMessage send"), "send");
+	}
+	/** POST /v1/edit */
+	async editText(input) {
+		const data = await this.#post("/v1/edit", spaceBody(input.chat_id, this.#phone(input.phone), {
+			message_id: input.message_id,
+			text: input.text
+		}), "iMessage edit");
+		if (isPlainObject(data) && data["ok"] === true && isString(data["message_id"]) && data["message_id"].length > 0) return parseMessageResult(data, "edit");
+		return {
+			space_id: parseOkResult(data).space_id ?? input.chat_id,
+			message_id: input.message_id
+		};
+	}
+	/**
+	* POST /v1/typing.
+	* Non-typing chat actions map to typing start (presentation parity with other channels).
+	*/
+	async sendChatAction(input) {
+		await this.#post("/v1/typing", spaceBody(input.chat_id, this.#phone(input.phone), { action: "start" }), "iMessage typing");
+	}
+	/** Stop typing indicator. */
+	async stopTyping(input) {
+		await this.#post("/v1/typing", spaceBody(input.chat_id, this.#phone(input.phone), { action: "stop" }), "iMessage typing stop");
+	}
+	/** POST /v1/react — returns reaction/message guid for journaling. */
+	async setReaction(input) {
+		return parseMessageResult(await this.#post("/v1/react", spaceBody(input.chat_id, this.#phone(input.phone), {
+			message_id: input.message_id,
+			emoji: input.emoji
+		}), "iMessage react"), "react");
+	}
+	/**
+	* POST /v1/clear-reaction.
+	* Package contract: target message_id + emoji (same as setReaction).
+	* Proxy should clear by target+emoji; older proxies that only accept reaction message ids need a gap fill.
+	*/
+	async clearReaction(input) {
+		await this.#post("/v1/clear-reaction", spaceBody(input.chat_id, this.#phone(input.phone), {
+			message_id: input.message_id,
+			emoji: input.emoji
+		}), "iMessage clearReaction");
+	}
+	/** POST /v1/unsend */
+	async unsend(input) {
+		await this.#post("/v1/unsend", spaceBody(input.chat_id, this.#phone(input.phone), { message_id: input.message_id }), "iMessage unsend");
+	}
+	/** POST /v1/read */
+	async read(input) {
+		await this.#post("/v1/read", spaceBody(input.chat_id, this.#phone(input.phone), { ...input.message_id && { message_id: input.message_id } }), "iMessage read");
+	}
+	/** POST /v1/media */
+	async sendMedia(input) {
+		return parseMessageResult(await this.#post("/v1/media", mediaBody(input, this.#phone(input.phone)), "iMessage sendMedia"), "media");
+	}
+	/**
+	* POST /v1/download.
+	* Prefer attachment guid alone; pass chat_id when the proxy still requires a space.
+	*/
+	async downloadFile(input) {
+		return parseDownloadResult(input, await this.#post("/v1/download", spaceBody(input.chat_id, this.#phone(input.phone), { file_id: input.file_id }), "iMessage downloadFile"));
+	}
+	async answerCallback(_input) {}
+};
+//#endregion
+//#region src/vendors/imessage/module.ts
+const imessageSendTextTool = defineTool({
+	id: "imessage-send-text",
+	name: "imessageSendText",
+	description: "Send a text message to an iMessage chat. chat_id is the chat guid (e.g. any;-;+1555…). Returns message_id (guid) for later edits, reactions, or unsend.",
+	inputSchema: imessageSendTextInputSchema,
+	outputSchema: imessageMessageOutputSchema,
+	sideEffect: "send",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => ImessageClient.fromContext(ctx).sendText(input)
+});
+const imessageEditTextTool = defineTool({
+	id: "imessage-edit-text",
+	name: "imessageEditText",
+	description: "Edit the text of a previously sent iMessage. Requires chat guid and message guid.",
+	inputSchema: imessageEditTextInputSchema,
+	outputSchema: imessageMessageOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => ImessageClient.fromContext(ctx).editText(input)
+});
+const imessageSendChatActionTool = defineTool({
+	id: "imessage-send-chat-action",
+	name: "imessageSendChatAction",
+	description: "Show a typing indicator in an iMessage chat while a response is being prepared.",
+	inputSchema: imessageSendChatActionInputSchema,
+	outputSchema: imessageOkOutputSchema,
+	sideEffect: "none",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => {
+		await ImessageClient.fromContext(ctx).sendChatAction(input);
+		return {
+			ok: true,
+			space_id: input.chat_id
+		};
+	}
+});
+const imessageSetReactionTool = defineTool({
+	id: "imessage-set-reaction",
+	name: "imessageSetReaction",
+	description: "React to an iMessage with a tapback (love, like, dislike, laugh, emphasize, question) or free emoji. Returns a message guid for journaling. To clear, call clear-reaction with the same target message_id and emoji.",
+	inputSchema: imessageSetReactionInputSchema,
+	outputSchema: imessageMessageOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => ImessageClient.fromContext(ctx).setReaction(input)
+});
+const imessageClearReactionTool = defineTool({
+	id: "imessage-clear-reaction",
+	name: "imessageClearReaction",
+	description: "Clear an iMessage reaction. message_id is the target message that was reacted to; emoji must match set-reaction (tapback name or emoji character).",
+	inputSchema: imessageClearReactionInputSchema,
+	outputSchema: imessageOkOutputSchema,
+	sideEffect: "delete",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => {
+		await ImessageClient.fromContext(ctx).clearReaction(input);
+		return {
+			ok: true,
+			space_id: input.chat_id
+		};
+	}
+});
+const imessageUnsendTool = defineTool({
+	id: "imessage-unsend",
+	name: "imessageUnsend",
+	description: "Unsend a previously sent iMessage using its chat guid and message guid.",
+	inputSchema: imessageUnsendInputSchema,
+	outputSchema: imessageOkOutputSchema,
+	sideEffect: "delete",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => {
+		await ImessageClient.fromContext(ctx).unsend(input);
+		return {
+			ok: true,
+			space_id: input.chat_id
+		};
+	}
+});
+const imessageReadTool = defineTool({
+	id: "imessage-read",
+	name: "imessageRead",
+	description: "Mark an iMessage conversation as read (whole chat).",
+	inputSchema: imessageReadInputSchema,
+	outputSchema: imessageOkOutputSchema,
+	sideEffect: "write",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => {
+		await ImessageClient.fromContext(ctx).read(input);
+		return {
+			ok: true,
+			space_id: input.chat_id
+		};
+	}
+});
+const imessageSendMediaTool = defineTool({
+	id: "imessage-send-media",
+	name: "imessageSendMedia",
+	description: "Upload and send one photo or document to an iMessage chat from base64 bytes. Optional caption is sent as a follow-up text message.",
+	inputSchema: imessageSendMediaInputSchema,
+	outputSchema: imessageMessageOutputSchema,
+	sideEffect: "send",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => ImessageClient.fromContext(ctx).sendMedia(input)
+});
+const imessageDownloadFileTool = defineTool({
+	id: "imessage-download-file",
+	name: "imessageDownloadFile",
+	description: "Download attachment bytes by attachment guid (file_id from inbound or upload).",
+	inputSchema: imessageDownloadFileInputSchema,
+	outputSchema: imessageDownloadFileOutputSchema,
+	sideEffect: "none",
+	runtime: "both",
+	network: true,
+	execute: async (input, ctx) => ImessageClient.fromContext(ctx).downloadFile(input)
+});
+const imessageModule = defineModule({
+	id: "imessage",
+	title: "iMessage",
+	description: "iMessage tools for sending and editing text or media, typing indicators, reactions, unsend, read state, and attachment download via a bound photon-rest-proxy.",
+	runtime: "both",
+	auth: {
+		type: "custom",
+		schema: imessageAuthSchema
+	},
+	categories: ["messaging", "chat"],
+	classification: "pii",
+	tags: ["imessage", "photon"],
+	tools: [
+		imessageSendTextTool,
+		imessageEditTextTool,
+		imessageSendChatActionTool,
+		imessageSetReactionTool,
+		imessageClearReactionTool,
+		imessageUnsendTool,
+		imessageReadTool,
+		imessageSendMediaTool,
+		imessageDownloadFileTool
+	]
+});
+//#endregion
+export { imessageUnsendInputSchema as A, imessageMessageOutputSchema as C, imessageSendMediaInputSchema as D, imessageSendChatActionInputSchema as E, imessageSendTextInputSchema as O, imessageEnsureChatOutputSchema as S, imessageReadInputSchema as T, imessageClearReactionInputSchema as _, imessageReadTool as a, imessageEditTextInputSchema as b, imessageSendTextTool as c, ImessageClient as d, ImessageClientError as f, imessageAuthSchema as g, MAX_MEDIA_BYTES as h, imessageModule as i, imessageSetReactionInputSchema as k, imessageSetReactionTool as l, isImessageOutcomeUnknown as m, imessageDownloadFileTool as n, imessageSendChatActionTool as o, isImessageDefiniteRejection as p, imessageEditTextTool as r, imessageSendMediaTool as s, imessageClearReactionTool as t, imessageUnsendTool as u, imessageDownloadFileInputSchema as v, imessageOkOutputSchema as w, imessageEnsureChatInputSchema as x, imessageDownloadFileOutputSchema as y };
+
+//# sourceMappingURL=imessage-CH49-sFn.js.map