@openmail/openclaw 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,189 @@
1
+ // Inbound event admission. Two implementations behind one surface:
2
+ //
3
+ // durable SDK ingress queue + drain (dedupe by event_id, crash-safe rows,
4
+ // backoff retries, dead-letter). Only for trusted installs (npm /
5
+ // ClawHub); the host refuses the state APIs to path-linked plugins.
6
+ // memory Serial in-process dispatch with bounded retries and a file cursor.
7
+ // Loses in-flight events on a crash, but the server replays from the
8
+ // cursor on reconnect so nothing is permanently lost.
9
+ import fs from "node:fs/promises";
10
+ import path from "node:path";
11
+ import { createStandardRawEventIngressMonitor } from "openclaw/plugin-sdk/channel-ingress-runtime";
12
+ import { resolveStateDir } from "openclaw/plugin-sdk/state-paths";
13
+ import { parseAddress } from "./inbound.js";
14
+ import { getOpenMailRuntime } from "./runtime.js";
15
+ const CURSOR_NAMESPACE = "openmail-ws-cursor";
16
+ const MEMORY_RETRY_DELAYS_MS = [2_000, 10_000, 30_000];
17
+ /** Serialize turns per sender so one correspondent's mails run in order. */
18
+ export function laneKeyFor(event) {
19
+ return `sender:${parseAddress(event.message.from).address}`;
20
+ }
21
+ class OpenMailIngressPayloadError extends Error {
22
+ name = "OpenMailIngressPayloadError";
23
+ }
24
+ function isTrustRefusal(error) {
25
+ return error instanceof Error && /only available for trusted plugins/.test(error.message);
26
+ }
27
+ /**
28
+ * Prefer the SDK's durable machinery; fall back to memory when the host
29
+ * refuses it for this install origin.
30
+ */
31
+ export function createIngress(params) {
32
+ const { ctx } = params;
33
+ try {
34
+ const runtime = getOpenMailRuntime();
35
+ const store = runtime.state.openKeyedStore({
36
+ namespace: CURSOR_NAMESPACE,
37
+ maxEntries: 200,
38
+ });
39
+ const queue = runtime.state.openChannelIngressQueue({
40
+ accountId: ctx.accountId,
41
+ });
42
+ return {
43
+ ingress: createDurableIngress({ ...params, queue }),
44
+ cursor: {
45
+ load: async () => (await store.lookup(ctx.accountId))?.lastEventId,
46
+ save: (lastEventId) => store.register(ctx.accountId, { lastEventId }),
47
+ },
48
+ };
49
+ }
50
+ catch (error) {
51
+ if (!isTrustRefusal(error))
52
+ throw error;
53
+ ctx.log?.warn?.("openmail: durable ingress needs a trusted install (npm/ClawHub); this path-linked install retries in memory only");
54
+ return { ingress: createMemoryIngress(params), cursor: createFileCursor(ctx.accountId) };
55
+ }
56
+ }
57
+ function createDurableIngress(params) {
58
+ const { ctx, dispatch } = params;
59
+ const monitor = createStandardRawEventIngressMonitor({
60
+ queue: params.queue,
61
+ abortSignal: ctx.abortSignal,
62
+ inspect: (raw) => ({ eventId: raw.event_id, laneKey: laneKeyFor(raw) }),
63
+ payload: {
64
+ serialize: (raw) => JSON.stringify(raw),
65
+ deserialize: (body) => JSON.parse(body),
66
+ createClaimError: (kind, claim) => new OpenMailIngressPayloadError(kind === "invalid-version"
67
+ ? `OpenMail ingress row ${claim.id} has an unsupported payload version.`
68
+ : `OpenMail ingress row ${claim.id} changed event identity.`),
69
+ },
70
+ classifyAdmissionError: (error) => error instanceof SyntaxError || error instanceof OpenMailIngressPayloadError
71
+ ? error.message
72
+ : undefined,
73
+ deliver: async (event, lifecycle) => {
74
+ try {
75
+ const outcome = await dispatch(event, lifecycle);
76
+ if (outcome.kind === "dropped") {
77
+ ctx.log?.info?.(`openmail: drop event ${event.event_id}: ${outcome.reason}`);
78
+ }
79
+ // Idempotent when inbound.run already adopted through the bound lifecycle.
80
+ await lifecycle.onAdopted();
81
+ return { kind: "completed" };
82
+ }
83
+ catch (error) {
84
+ ctx.log?.warn?.(`openmail: dispatch of ${event.event_id} failed; will retry: ${String(error)}`);
85
+ return { kind: "failed-retryable", error };
86
+ }
87
+ },
88
+ onError: (error) => ctx.log?.error?.(`openmail: ingress error: ${String(error)}`),
89
+ createStoppedError: () => new Error("OpenMail ingress is stopped."),
90
+ });
91
+ return {
92
+ mode: "durable",
93
+ receive: async (event) => {
94
+ const admission = await monitor.receive(event);
95
+ if (admission.kind === "invalid") {
96
+ throw new Error(`malformed event ${event.event_id}: ${admission.message}`);
97
+ }
98
+ },
99
+ start: monitor.start,
100
+ stop: monitor.stop,
101
+ };
102
+ }
103
+ function sleep(ms, signal) {
104
+ return new Promise((resolve) => {
105
+ const t = setTimeout(done, ms);
106
+ function done() {
107
+ clearTimeout(t);
108
+ signal?.removeEventListener("abort", done);
109
+ resolve();
110
+ }
111
+ signal?.addEventListener("abort", done, { once: true });
112
+ });
113
+ }
114
+ export function createMemoryIngress(params) {
115
+ const { ctx, dispatch } = params;
116
+ const delays = params.retryDelaysMs ?? MEMORY_RETRY_DELAYS_MS;
117
+ const seen = new Set();
118
+ let tail = Promise.resolve();
119
+ let running = false;
120
+ const handle = async (event) => {
121
+ if (seen.has(event.event_id)) {
122
+ ctx.log?.info?.(`openmail: skip duplicate event ${event.event_id}`);
123
+ return true;
124
+ }
125
+ seen.add(event.event_id);
126
+ if (seen.size > 5_000)
127
+ seen.delete(seen.values().next().value);
128
+ for (let attempt = 0;; attempt += 1) {
129
+ try {
130
+ const outcome = await dispatch(event);
131
+ if (outcome.kind === "dropped") {
132
+ ctx.log?.info?.(`openmail: drop event ${event.event_id}: ${outcome.reason}`);
133
+ }
134
+ return true;
135
+ }
136
+ catch (error) {
137
+ const delay = delays[attempt];
138
+ if (delay === undefined || ctx.abortSignal?.aborted) {
139
+ seen.delete(event.event_id);
140
+ ctx.log?.error?.(`openmail: giving up on event ${event.event_id} after ${attempt} retries; it will be replayed on reconnect: ${String(error)}`);
141
+ return false;
142
+ }
143
+ ctx.log?.warn?.(`openmail: dispatch of ${event.event_id} failed, retry ${attempt + 1} in ${delay}ms: ${String(error)}`);
144
+ await sleep(delay, ctx.abortSignal);
145
+ }
146
+ }
147
+ };
148
+ return {
149
+ mode: "memory",
150
+ receive: async (event) => {
151
+ if (!running)
152
+ throw new Error("OpenMail ingress is stopped.");
153
+ // Nothing is persisted, so "admitted" can only mean "handled": the
154
+ // caller advances the cursor after we resolve, and a give-up throws so
155
+ // the cursor stays put and the server replays the event on reconnect.
156
+ const done = tail.then(() => handle(event));
157
+ tail = done.then(() => undefined, () => undefined);
158
+ if (!(await done))
159
+ throw new Error(`event ${event.event_id} was not handled`);
160
+ },
161
+ start: () => {
162
+ running = true;
163
+ },
164
+ stop: async () => {
165
+ running = false;
166
+ await tail;
167
+ },
168
+ };
169
+ }
170
+ /** `{ lastEventId }` per account under the OpenClaw state dir. */
171
+ export function createFileCursor(accountId, stateDir = resolveStateDir()) {
172
+ const file = path.join(stateDir, "openmail", `cursor-${accountId.replace(/[^A-Za-z0-9_-]/g, "_")}.json`);
173
+ return {
174
+ async load() {
175
+ try {
176
+ const raw = JSON.parse(await fs.readFile(file, "utf8"));
177
+ return typeof raw.lastEventId === "string" ? raw.lastEventId : undefined;
178
+ }
179
+ catch {
180
+ return undefined;
181
+ }
182
+ },
183
+ async save(lastEventId) {
184
+ await fs.mkdir(path.dirname(file), { recursive: true });
185
+ await fs.writeFile(file, JSON.stringify({ lastEventId }), "utf8");
186
+ },
187
+ };
188
+ }
189
+ //# sourceMappingURL=ingress.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ingress.js","sourceRoot":"","sources":["../src/ingress.ts"],"names":[],"mappings":"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"}
package/dist/media.js ADDED
@@ -0,0 +1,63 @@
1
+ // Stage inbound attachments so the agent can open them as files (images,
2
+ // PDFs) in addition to any server-extracted text we inline in the prompt.
3
+ import { rm } from "node:fs/promises";
4
+ import { saveMediaBuffer } from "openclaw/plugin-sdk/media-store";
5
+ import { AttachmentTooLargeError } from "./openmail-api.js";
6
+ /** Text the server already extracted is enough for the agent; don't re-stage it. */
7
+ export function needsStaging(att) {
8
+ return !(typeof att.parsedText === "string" && att.parsedText.trim().length > 0);
9
+ }
10
+ /**
11
+ * Downloads attachments up to an aggregate `maxBytes` and writes them to the
12
+ * inbound media store. Oversized files are skipped (named in `skipped`) rather
13
+ * than failing the whole message; a partial save is rolled back so a durable
14
+ * retry cannot leak a copy per attempt.
15
+ */
16
+ export async function stageInboundAttachments(params) {
17
+ const out = { paths: [], types: [], skipped: [] };
18
+ if (params.maxBytes <= 0)
19
+ return out;
20
+ const candidates = params.attachments.filter((a) => a.filename && needsStaging(a));
21
+ if (candidates.length === 0)
22
+ return out;
23
+ const downloaded = [];
24
+ let used = 0;
25
+ for (const att of candidates) {
26
+ const declared = typeof att.sizeBytes === "number" ? att.sizeBytes : 0;
27
+ const remaining = params.maxBytes - used;
28
+ if (declared > remaining) {
29
+ out.skipped.push(att.filename);
30
+ continue;
31
+ }
32
+ try {
33
+ const { buffer, contentType } = await params.api.downloadAttachment(params.messageId, att.filename, remaining);
34
+ used += buffer.byteLength;
35
+ downloaded.push({
36
+ buffer,
37
+ contentType: att.contentType || contentType || "application/octet-stream",
38
+ filename: att.filename,
39
+ });
40
+ }
41
+ catch (err) {
42
+ if (err instanceof AttachmentTooLargeError) {
43
+ out.skipped.push(att.filename);
44
+ continue;
45
+ }
46
+ throw err;
47
+ }
48
+ }
49
+ const saved = [];
50
+ try {
51
+ for (const file of downloaded) {
52
+ saved.push(await saveMediaBuffer(file.buffer, file.contentType, "inbound", params.maxBytes, file.filename));
53
+ }
54
+ }
55
+ catch (err) {
56
+ await Promise.allSettled(saved.map((s) => rm(s.path, { force: true })));
57
+ throw err;
58
+ }
59
+ out.paths = saved.map((s) => s.path);
60
+ out.types = saved.map((s) => s.contentType ?? "application/octet-stream");
61
+ return out;
62
+ }
63
+ //# sourceMappingURL=media.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"media.js","sourceRoot":"","sources":["../src/media.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,215 @@
1
+ // Minimal OpenMail REST client. Only what the channel needs: inbox lookup,
2
+ // in-thread replies, attachment text. Everything else stays in the CLI.
3
+ import { randomUUID } from "node:crypto";
4
+ export class OpenMailApiError extends Error {
5
+ status;
6
+ body;
7
+ constructor(message, status, body) {
8
+ super(message);
9
+ this.status = status;
10
+ this.body = body;
11
+ }
12
+ }
13
+ export class AttachmentTooLargeError extends Error {
14
+ filename;
15
+ bytes;
16
+ maxBytes;
17
+ constructor(filename, bytes, maxBytes) {
18
+ super(`Attachment ${filename} (${bytes} bytes) exceeds the ${maxBytes} byte media budget`);
19
+ this.filename = filename;
20
+ this.bytes = bytes;
21
+ this.maxBytes = maxBytes;
22
+ }
23
+ }
24
+ export class OpenMailApi {
25
+ baseUrl;
26
+ apiKey;
27
+ constructor(baseUrl, apiKey) {
28
+ this.baseUrl = baseUrl;
29
+ this.apiKey = apiKey;
30
+ }
31
+ async getInbox(inboxId) {
32
+ const data = (await this.request("GET", `/v1/inboxes/${encodeURIComponent(inboxId)}`));
33
+ return "inbox" in data && data.inbox ? data.inbox : data;
34
+ }
35
+ /** Inboxes visible to this key. Inbox-scoped keys return exactly one. */
36
+ async listInboxes() {
37
+ const data = (await this.request("GET", "/v1/inboxes?limit=50"));
38
+ return data.data ?? data.inboxes ?? [];
39
+ }
40
+ async createInbox(params) {
41
+ const body = {};
42
+ if (params.displayName)
43
+ body.displayName = params.displayName;
44
+ if (params.mailboxName)
45
+ body.mailboxName = params.mailboxName;
46
+ return (await this.request("POST", "/v1/inboxes", body));
47
+ }
48
+ /**
49
+ * Mint an inbox-scoped key. Returns null when the calling key is itself
50
+ * inbox-scoped (403: such keys cannot mint), which tells the caller the key
51
+ * it already holds is the narrowest possible one.
52
+ */
53
+ async mintInboxKey(inboxId, name) {
54
+ try {
55
+ const key = (await this.request("POST", `/v1/inboxes/${encodeURIComponent(inboxId)}/api-keys`, { name }));
56
+ if (!key.token)
57
+ throw new Error("OpenMail did not return the key token");
58
+ return { id: key.id, token: key.token };
59
+ }
60
+ catch (err) {
61
+ if (err instanceof OpenMailApiError && err.status === 403)
62
+ return null;
63
+ throw err;
64
+ }
65
+ }
66
+ /**
67
+ * Pods visible to this key. Account-wide keys see all; a pod-scoped key sees
68
+ * exactly its own pod, which is how we learn a key's pod (there is no whoami).
69
+ */
70
+ async listPods() {
71
+ const data = (await this.request("GET", "/v1/pods?limit=100"));
72
+ return data.data ?? [];
73
+ }
74
+ /** `id` may be the pod id or its clientId. */
75
+ async getPod(id) {
76
+ return (await this.request("GET", `/v1/pods/${encodeURIComponent(id)}`));
77
+ }
78
+ /**
79
+ * Mint a pod-scoped key. Only account-wide keys may; a pod or inbox key gets
80
+ * 403, returned as null so the caller knows the key it holds is already as
81
+ * narrow as (or narrower than) the pod.
82
+ */
83
+ async mintPodKey(podId, name) {
84
+ try {
85
+ const key = (await this.request("POST", `/v1/pods/${encodeURIComponent(podId)}/api-keys`, {
86
+ name,
87
+ }));
88
+ if (!key.token)
89
+ throw new Error("OpenMail did not return the key token");
90
+ return { id: key.id, token: key.token };
91
+ }
92
+ catch (err) {
93
+ if (err instanceof OpenMailApiError && err.status === 403)
94
+ return null;
95
+ throw err;
96
+ }
97
+ }
98
+ async revokeInboxKey(inboxId, keyId) {
99
+ await this.request("DELETE", `/v1/inboxes/${encodeURIComponent(inboxId)}/api-keys/${encodeURIComponent(keyId)}`);
100
+ }
101
+ /**
102
+ * Which inbox does this key drive? An inbox-scoped key answers by itself;
103
+ * a broader key works when it sees exactly one inbox, or none (we create
104
+ * one). Several inboxes is ambiguous and the caller must pick.
105
+ */
106
+ async resolveInbox(create) {
107
+ const inboxes = await this.listInboxes();
108
+ if (inboxes.length === 1)
109
+ return { kind: "resolved", inbox: inboxes[0], created: false };
110
+ if (inboxes.length === 0) {
111
+ return { kind: "resolved", inbox: await this.createInbox(create), created: true };
112
+ }
113
+ return { kind: "ambiguous", inboxes };
114
+ }
115
+ /** Messages in a thread, oldest first. Scoped keys only see their own inbox. */
116
+ async listThreadMessages(threadId) {
117
+ const data = (await this.request("GET", `/v1/threads/${encodeURIComponent(threadId)}/messages`));
118
+ return data.data ?? data.messages ?? [];
119
+ }
120
+ /**
121
+ * Authoritative copy of one message, fetched through the thread it claims
122
+ * to belong to. Null when the thread is not visible to this key or does not
123
+ * contain the message — i.e. the (messageId, threadId) pair was not issued
124
+ * by OpenMail for this inbox.
125
+ */
126
+ async findMessage(threadId, messageId) {
127
+ try {
128
+ const messages = await this.listThreadMessages(threadId);
129
+ return messages.find((m) => m.id === messageId) ?? null;
130
+ }
131
+ catch (err) {
132
+ if (err instanceof OpenMailApiError && (err.status === 404 || err.status === 403))
133
+ return null;
134
+ throw err;
135
+ }
136
+ }
137
+ /** Raw attachment bytes; `maxBytes` aborts the download once exceeded. */
138
+ async downloadAttachment(messageId, filename, maxBytes) {
139
+ const response = await fetch(`${this.baseUrl}/v1/attachments/${encodeURIComponent(messageId)}/${encodeURIComponent(filename)}`, { headers: { Authorization: `Bearer ${this.apiKey}` } });
140
+ if (!response.ok) {
141
+ throw new OpenMailApiError(`OpenMail API ${response.status}: attachment download failed`, response.status, await response.text().catch(() => ""));
142
+ }
143
+ const declared = Number(response.headers.get("content-length") ?? 0);
144
+ if (declared > maxBytes)
145
+ throw new AttachmentTooLargeError(filename, declared, maxBytes);
146
+ const chunks = [];
147
+ let total = 0;
148
+ const reader = response.body?.getReader();
149
+ if (!reader)
150
+ return { buffer: Buffer.alloc(0), contentType: undefined };
151
+ for (;;) {
152
+ const { done, value } = await reader.read();
153
+ if (done)
154
+ break;
155
+ total += value.byteLength;
156
+ if (total > maxBytes) {
157
+ await reader.cancel().catch(() => undefined);
158
+ throw new AttachmentTooLargeError(filename, total, maxBytes);
159
+ }
160
+ chunks.push(value);
161
+ }
162
+ return {
163
+ buffer: Buffer.concat(chunks),
164
+ contentType: response.headers.get("content-type")?.split(";")[0].trim() || undefined,
165
+ };
166
+ }
167
+ /**
168
+ * Reply in an existing thread. The API derives "Re: <subject>" from the
169
+ * thread, so no subject is sent. `to` is the original sender.
170
+ */
171
+ async sendReply(params) {
172
+ const payload = {
173
+ to: params.to,
174
+ body: params.body,
175
+ threadId: params.threadId,
176
+ };
177
+ if (params.subject)
178
+ payload.subject = params.subject;
179
+ return (await this.request("POST", `/v1/inboxes/${encodeURIComponent(params.inboxId)}/send`, payload, { "Idempotency-Key": randomUUID() }));
180
+ }
181
+ async sendNew(params) {
182
+ return (await this.request("POST", `/v1/inboxes/${encodeURIComponent(params.inboxId)}/send`, { to: params.to, subject: params.subject, body: params.body }, { "Idempotency-Key": randomUUID() }));
183
+ }
184
+ async request(method, path, body, extraHeaders = {}) {
185
+ const response = await fetch(`${this.baseUrl}${path}`, {
186
+ method,
187
+ headers: {
188
+ Authorization: `Bearer ${this.apiKey}`,
189
+ "Content-Type": "application/json",
190
+ ...extraHeaders,
191
+ },
192
+ body: body === undefined ? undefined : JSON.stringify(body),
193
+ });
194
+ const text = await response.text();
195
+ const parsed = tryParseJson(text);
196
+ if (!response.ok) {
197
+ const detail = parsed && typeof parsed === "object" && "message" in parsed
198
+ ? String(parsed.message)
199
+ : text.slice(0, 200);
200
+ throw new OpenMailApiError(`OpenMail API ${response.status}: ${detail}`, response.status, parsed ?? text);
201
+ }
202
+ return parsed ?? text;
203
+ }
204
+ }
205
+ function tryParseJson(text) {
206
+ if (!text)
207
+ return undefined;
208
+ try {
209
+ return JSON.parse(text);
210
+ }
211
+ catch {
212
+ return undefined;
213
+ }
214
+ }
215
+ //# sourceMappingURL=openmail-api.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"openmail-api.js","sourceRoot":"","sources":["../src/openmail-api.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wEAAwE;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAqDzC,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAG9B;IACA;IAHX,YACE,OAAe,EACN,MAAc,EACd,IAAa;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAS;IAGxB,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAErC;IACA;IACA;IAHX,YACW,QAAgB,EAChB,KAAa,EACb,QAAgB;QAEzB,KAAK,CAAC,cAAc,QAAQ,KAAK,KAAK,uBAAuB,QAAQ,oBAAoB,CAAC,CAAC;QAJlF,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAQ;QACb,aAAQ,GAAR,QAAQ,CAAQ;IAG3B,CAAC;CACF;AAED,MAAM,OAAO,WAAW;IAEH;IACA;IAFnB,YACmB,OAAe,EACf,MAAc;QADd,YAAO,GAAP,OAAO,CAAQ;QACf,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAEpE,CAAC;QAClB,OAAO,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,IAAsB,CAAC;IAC9E,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAG9D,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAsD;QACtE,MAAM,IAAI,GAA2B,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QAC9D,IAAI,MAAM,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QAC9D,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,CAAkB,CAAC;IAC5E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,IAAY;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAC7B,MAAM,EACN,eAAe,kBAAkB,CAAC,OAAO,CAAC,WAAW,EACrD,EAAE,IAAI,EAAE,CACT,CAAmC,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACzE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,gBAAgB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAA6B,CAAC;QAC3F,OAAO,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAgB,CAAC;IAC1F,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,IAAY;QAC1C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,kBAAkB,CAAC,KAAK,CAAC,WAAW,EAAE;gBACxF,IAAI;aACL,CAAC,CAAmC,CAAC;YACtC,IAAI,CAAC,GAAG,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACzE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,gBAAgB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,KAAa;QACjD,MAAM,IAAI,CAAC,OAAO,CAChB,QAAQ,EACR,eAAe,kBAAkB,CAAC,OAAO,CAAC,aAAa,kBAAkB,CAAC,KAAK,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,MAAsD;QAIvE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACzF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACpF,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IACxC,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,kBAAkB,CAAC,QAAgB;QACvC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAC9B,KAAK,EACL,eAAe,kBAAkB,CAAC,QAAQ,CAAC,WAAW,CACvD,CAA+D,CAAC;QACjE,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,SAAiB;QACnD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YACzD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,gBAAgB,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/F,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,kBAAkB,CACtB,SAAiB,EACjB,QAAgB,EAChB,QAAgB;QAEhB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,IAAI,CAAC,OAAO,mBAAmB,kBAAkB,CAAC,SAAS,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EACjG,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CACxD,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,gBAAgB,CACxB,gBAAgB,QAAQ,CAAC,MAAM,8BAA8B,EAC7D,QAAQ,CAAC,MAAM,EACf,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CACtC,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,IAAI,QAAQ,GAAG,QAAQ;YAAE,MAAM,IAAI,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACzF,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACxE,SAAS,CAAC;YACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;YAC1B,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;gBACrB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC7C,MAAM,IAAI,uBAAuB,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7B,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS;SACrF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,MAMf;QACC,MAAM,OAAO,GAA4B;YACvC,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC;QACF,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACrD,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CACxB,MAAM,EACN,eAAe,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EACxD,OAAO,EACP,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,CACpC,CAAe,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAKb;QACC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CACxB,MAAM,EACN,eAAe,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EACxD,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAC7D,EAAE,iBAAiB,EAAE,UAAU,EAAE,EAAE,CACpC,CAAe,CAAC;IACnB,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,IAAc,EACd,eAAuC,EAAE;QAEzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YACrD,MAAM;YACN,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;gBACtC,cAAc,EAAE,kBAAkB;gBAClC,GAAG,YAAY;aAChB;YACD,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC5D,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,MAAM,GACV,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,SAAS,IAAI,MAAM;gBACzD,CAAC,CAAC,MAAM,CAAE,MAA+B,CAAC,OAAO,CAAC;gBAClD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACzB,MAAM,IAAI,gBAAgB,CACxB,gBAAgB,QAAQ,CAAC,MAAM,KAAK,MAAM,EAAE,EAC5C,QAAQ,CAAC,MAAM,EACf,MAAM,IAAI,IAAI,CACf,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;CACF;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
@@ -0,0 +1,11 @@
1
+ // The PluginRuntime handed to us at registration. Needed outside the gateway
2
+ // context for durable state (ingress queue, keyed stores). The SDK store keys
3
+ // the slot by plugin id so duplicate module instances share one runtime.
4
+ import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
5
+ const { setRuntime, getRuntime } = createPluginRuntimeStore({
6
+ pluginId: "openmail",
7
+ errorMessage: "OpenMail plugin runtime is not initialised; the gateway must load the plugin first.",
8
+ });
9
+ export const setOpenMailRuntime = setRuntime;
10
+ export const getOpenMailRuntime = getRuntime;
11
+ //# sourceMappingURL=runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,yEAAyE;AACzE,OAAO,EAAE,wBAAwB,EAAsB,MAAM,mCAAmC,CAAC;AAEjG,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,wBAAwB,CAAgB;IACzE,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,qFAAqF;CACpG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC"}
@@ -0,0 +1,28 @@
1
+ // Tells the host which config paths may hold SecretRefs so it resolves them
2
+ // (env / file / exec providers) before the channel reads them.
3
+ import { collectConditionalChannelFieldAssignments, createChannelSecretTargetRegistryEntries, getChannelSurface, hasOwnProperty, } from "openclaw/plugin-sdk/channel-secret-basic-runtime";
4
+ import { OPENMAIL_CHANNEL_ID } from "./accounts.js";
5
+ export const secretTargetRegistryEntries = createChannelSecretTargetRegistryEntries({
6
+ channelKey: OPENMAIL_CHANNEL_ID,
7
+ account: ["apiKey"],
8
+ channel: ["apiKey"],
9
+ });
10
+ export function collectRuntimeConfigAssignments(params) {
11
+ const resolved = getChannelSurface(params.config, OPENMAIL_CHANNEL_ID);
12
+ if (!resolved)
13
+ return;
14
+ collectConditionalChannelFieldAssignments({
15
+ channelKey: OPENMAIL_CHANNEL_ID,
16
+ field: "apiKey",
17
+ channel: resolved.channel,
18
+ surface: resolved.surface,
19
+ defaults: params.defaults,
20
+ context: params.context,
21
+ topLevelActiveWithoutAccounts: true,
22
+ topLevelInheritedAccountActive: ({ account, enabled }) => enabled && !hasOwnProperty(account, "apiKey"),
23
+ accountActive: ({ enabled }) => enabled,
24
+ topInactiveReason: "no enabled OpenMail surface inherits this top-level apiKey.",
25
+ accountInactiveReason: "OpenMail account is disabled.",
26
+ });
27
+ }
28
+ //# sourceMappingURL=secret-contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"secret-contract.js","sourceRoot":"","sources":["../src/secret-contract.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,+DAA+D;AAC/D,OAAO,EACL,yCAAyC,EACzC,wCAAwC,EACxC,iBAAiB,EACjB,cAAc,GAGf,MAAM,kDAAkD,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,CAAC,MAAM,2BAA2B,GAAG,wCAAwC,CAAC;IAClF,UAAU,EAAE,mBAAmB;IAC/B,OAAO,EAAE,CAAC,QAAQ,CAAC;IACnB,OAAO,EAAE,CAAC,QAAQ,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,UAAU,+BAA+B,CAAC,MAI/C;IACC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACvE,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,yCAAyC,CAAC;QACxC,UAAU,EAAE,mBAAmB;QAC/B,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,6BAA6B,EAAE,IAAI;QACnC,8BAA8B,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CACvD,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC/C,aAAa,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO;QACvC,iBAAiB,EAAE,6DAA6D;QAChF,qBAAqB,EAAE,+BAA+B;KACvD,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,6 @@
1
+ // Loaded during onboarding/setup instead of index.ts so `ws` and the
2
+ // gateway loop never get imported just to collect an API key.
3
+ import { defineSetupPluginEntry } from "openclaw/plugin-sdk/channel-core";
4
+ import { openmailSetupPlugin } from "./setup.js";
5
+ export default defineSetupPluginEntry(openmailSetupPlugin);
6
+ //# sourceMappingURL=setup-entry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setup-entry.js","sourceRoot":"","sources":["../src/setup-entry.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,8DAA8D;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAe,sBAAsB,CAAC,mBAAmB,CAAC,CAAC"}