@kb-labs/inbox-entry 2.96.0

package/dist/commands/mail-search.js

@@ -0,0 +1,146 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { resolveAccount, searchMessages, InboxError } from '@kb-labs/inbox-core';
+
+// src/commands/mail-search.ts
+function getHint(code, message) {
+  switch (code) {
+    case "ENV_MISSING":
+      return "Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)";
+    case "ACCOUNT_NOT_FOUND":
+      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;
+    case "IMAP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "IMAP_CONNECT_FAILED":
+      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;
+    case "IMAP_TIMEOUT":
+      return "Server did not respond in time \u2014 try again in a moment";
+    case "IMAP_MAILBOX_NOT_FOUND":
+      return "Run kb inbox folders --account <name> to see available folders";
+    case "MESSAGE_NOT_FOUND":
+      return "The uid may be stale \u2014 refresh with: kb inbox list";
+    case "SMTP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "SMTP_CONNECT_FAILED":
+      return "Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT";
+    case "SMTP_INVALID_RECIPIENT":
+      return "Verify the --to address is a valid email";
+    case "VALIDATION_ERROR":
+      return void 0;
+    // message itself is descriptive enough
+    case "INTERNAL_ERROR":
+      return void 0;
+    default: {
+      return void 0;
+    }
+  }
+}
+function handleError(ctx, err, isJson) {
+  if (err instanceof InboxError) {
+    const hint = getHint(err.code, err.message);
+    if (isJson) {
+      ctx.ui?.json?.({
+        ok: false,
+        error: {
+          code: err.code,
+          message: err.message,
+          ...hint && { hint }
+        }
+      });
+    } else {
+      ctx.ui?.error?.(err.message, {
+        ...hint && { hint },
+        cause: `InboxError [${err.code}]`
+      });
+    }
+    return;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  if (isJson) {
+    ctx.ui?.json?.({
+      ok: false,
+      error: { code: "INTERNAL_ERROR", message }
+    });
+  } else {
+    ctx.ui?.error?.(message);
+  }
+}
+
+// src/utils/slim.ts
+function formatDate(iso) {
+  const d = new Date(iso);
+  const now = /* @__PURE__ */ new Date();
+  const diff = now.getTime() - d.getTime();
+  if (diff < 6e4) {
+    return "just now";
+  }
+  if (diff < 36e5) {
+    return `${Math.floor(diff / 6e4)}m ago`;
+  }
+  if (diff < 864e5) {
+    return `${Math.floor(diff / 36e5)}h ago`;
+  }
+  if (diff < 7 * 864e5) {
+    return `${Math.floor(diff / 864e5)}d ago`;
+  }
+  return d.toLocaleDateString();
+}
+function formatFrom(from) {
+  return from.name ? `${from.name} <${from.address}>` : from.address;
+}
+
+// src/commands/mail-search.ts
+var mail_search_default = defineCommand({
+  id: "inbox:mail.search",
+  description: "Search emails by from, subject, body, or text",
+  handler: {
+    async execute(ctx, input) {
+      try {
+        const account = resolveAccount(input.flags.account);
+        const since = input.flags.since ? parseSince(input.flags.since) : void 0;
+        const messages = await searchMessages(account, {
+          from: input.flags.from,
+          subject: input.flags.subject,
+          body: input.flags.body,
+          text: input.flags.text,
+          folder: input.flags.folder,
+          since,
+          limit: input.flags.limit ?? 20
+        });
+        if (input.flags.json) {
+          ctx.ui?.json?.({ ok: true, result: messages });
+          return { exitCode: 0, result: messages };
+        }
+        if (!messages.length) {
+          ctx.ui?.info?.("No messages found.");
+          return { exitCode: 0, result: messages };
+        }
+        ctx.ui?.chain?.(messages.map((msg) => ({
+          title: `[${msg.uid}] ${msg.unread ? "\u25CF " : ""}${msg.subject}`,
+          sections: [{
+            items: [
+              `from: ${formatFrom(msg.from)}  ${formatDate(msg.date)}  folder: ${msg.folder}`
+            ]
+          }]
+        })));
+        return { exitCode: 0, result: messages };
+      } catch (err) {
+        handleError(ctx, err, input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+    }
+  }
+});
+function parseSince(raw) {
+  const match = raw.match(/^(\d+)(h|d|w)$/i);
+  if (match) {
+    const n = parseInt(match[1] ?? "0", 10);
+    const unit = (match[2] ?? "h").toLowerCase();
+    const ms = unit === "h" ? n * 36e5 : unit === "d" ? n * 864e5 : n * 7 * 864e5;
+    return new Date(Date.now() - ms);
+  }
+  return new Date(raw);
+}
+
+export { mail_search_default as default };
+//# sourceMappingURL=mail-search.js.map
+//# sourceMappingURL=mail-search.js.map

package/dist/commands/mail-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/error.ts","../../src/utils/slim.ts","../../src/commands/mail-search.ts"],"names":[],"mappings":"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","file":"mail-search.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { InboxError, type InboxErrorCode } from '@kb-labs/inbox-core';\n\n// HTTP status codes for REST layer\nconst REST_STATUS: Record<InboxErrorCode, number> = {\n  ENV_MISSING:            400,\n  ACCOUNT_NOT_FOUND:      400,\n  IMAP_AUTH_FAILED:       401,\n  IMAP_CONNECT_FAILED:    503,\n  IMAP_TIMEOUT:           504,\n  IMAP_MAILBOX_NOT_FOUND: 404,\n  MESSAGE_NOT_FOUND:      404,\n  SMTP_AUTH_FAILED:       401,\n  SMTP_CONNECT_FAILED:    503,\n  SMTP_INVALID_RECIPIENT: 400,\n  VALIDATION_ERROR:       400,\n  INTERNAL_ERROR:         500,\n};\n\n// Human-readable hints per error code\nfunction getHint(code: InboxErrorCode, message: string): string | undefined {\n  switch (code) {\n    case 'ENV_MISSING':\n      return 'Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)';\n    case 'ACCOUNT_NOT_FOUND':\n      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;\n    case 'IMAP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'IMAP_CONNECT_FAILED':\n      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;\n    case 'IMAP_TIMEOUT':\n      return 'Server did not respond in time — try again in a moment';\n    case 'IMAP_MAILBOX_NOT_FOUND':\n      return 'Run kb inbox folders --account <name> to see available folders';\n    case 'MESSAGE_NOT_FOUND':\n      return 'The uid may be stale — refresh with: kb inbox list';\n    case 'SMTP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'SMTP_CONNECT_FAILED':\n      return 'Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT';\n    case 'SMTP_INVALID_RECIPIENT':\n      return 'Verify the --to address is a valid email';\n    case 'VALIDATION_ERROR':\n      return undefined; // message itself is descriptive enough\n    case 'INTERNAL_ERROR':\n      return undefined;\n    default: {\n      const _: never = code;\n      void _;\n      return undefined;\n    }\n  }\n}\n\n/**\n * Output a structured error for CLI commands.\n *\n * JSON mode  → { ok: false, error: { code, message, hint? } }  — agent-parseable\n * Human mode → ctx.ui.error() with hint and cause fields\n *\n * Call right before `return { exitCode: 1, result: null }`.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n\n    if (isJson) {\n      ctx.ui?.json?.({\n        ok: false,\n        error: {\n          code: err.code,\n          message: err.message,\n          ...(hint && { hint }),\n        },\n      });\n    } else {\n      ctx.ui?.error?.(err.message, {\n        ...(hint && { hint }),\n        cause: `InboxError [${err.code}]`,\n      });\n    }\n    return;\n  }\n\n  // Unknown error\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: { code: 'INTERNAL_ERROR', message },\n    });\n  } else {\n    ctx.ui?.error?.(message);\n  }\n}\n\n/**\n * Re-throws err as an HTTP-aware error for REST handlers.\n * InboxError → preserves HTTP status; others → 500.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n    throw Object.assign(new Error(err.message), {\n      statusCode: REST_STATUS[err.code] ?? 500,\n      code: err.code,\n      details: hint ? { hint } : undefined,\n    });\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  throw Object.assign(new Error(message), {\n    statusCode: 500,\n    code: 'INTERNAL_ERROR',\n  });\n}\n","import type { Email, EmailSlim } from '@kb-labs/inbox-contracts';\n\nexport function slimEmail(email: Email): EmailSlim {\n  return {\n    uid: email.uid,\n    subject: email.subject,\n    from: email.from,\n    date: email.date,\n    folder: email.folder,\n    unread: !email.flags.includes('\\\\Seen'),\n    flagged: email.flags.includes('\\\\Flagged'),\n    hasAttachments: (email.attachments?.length ?? 0) > 0,\n  };\n}\n\nexport function formatDate(iso: string): string {\n  const d = new Date(iso);\n  const now = new Date();\n  const diff = now.getTime() - d.getTime();\n\n  if (diff < 60_000) { return 'just now'; }\n  if (diff < 3_600_000) { return `${Math.floor(diff / 60_000)}m ago`; }\n  if (diff < 86_400_000) { return `${Math.floor(diff / 3_600_000)}h ago`; }\n  if (diff < 7 * 86_400_000) { return `${Math.floor(diff / 86_400_000)}d ago`; }\n\n  return d.toLocaleDateString();\n}\n\nexport function formatFrom(from: { name?: string; address: string }): string {\n  return from.name ? `${from.name} <${from.address}>` : from.address;\n}\n","import { defineCommand, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { resolveAccount, searchMessages } from '@kb-labs/inbox-core';\nimport { handleError } from '../utils/error.js';\nimport { formatDate, formatFrom } from '../utils/slim.js';\n\ntype SearchFlags = {\n  from?: string;\n  subject?: string;\n  body?: string;\n  text?: string;\n  folder?: string;\n  since?: string;\n  limit?: number;\n  account?: string;\n  json?: boolean;\n  full?: boolean;\n};\n\nexport default defineCommand({\n  id: 'inbox:mail.search',\n  description: 'Search emails by from, subject, body, or text',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<SearchFlags>) {\n      try {\n        const account = resolveAccount(input.flags.account);\n        const since = input.flags.since ? parseSince(input.flags.since) : undefined;\n\n        const messages = await searchMessages(account, {\n          from: input.flags.from,\n          subject: input.flags.subject,\n          body: input.flags.body,\n          text: input.flags.text,\n          folder: input.flags.folder,\n          since,\n          limit: input.flags.limit ?? 20,\n        });\n\n        if (input.flags.json) {\n          ctx.ui?.json?.({ ok: true, result: messages });\n          return { exitCode: 0, result: messages };\n        }\n\n        if (!messages.length) {\n          ctx.ui?.info?.('No messages found.');\n          return { exitCode: 0, result: messages };\n        }\n\n        ctx.ui?.chain?.(messages.map(msg => ({\n          title: `[${msg.uid}] ${msg.unread ? '● ' : ''}${msg.subject}`,\n          sections: [{\n            items: [\n              `from: ${formatFrom(msg.from)}  ${formatDate(msg.date)}  folder: ${msg.folder}`,\n            ],\n          }],\n        })));\n\n        return { exitCode: 0, result: messages };\n      } catch (err) {\n        handleError(ctx, err, input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n    },\n  },\n});\n\nfunction parseSince(raw: string): Date {\n  const match = raw.match(/^(\\d+)(h|d|w)$/i);\n  if (match) {\n    const n = parseInt(match[1] ?? '0', 10);\n    const unit = (match[2] ?? 'h').toLowerCase();\n    const ms = unit === 'h' ? n * 3_600_000 : unit === 'd' ? n * 86_400_000 : n * 7 * 86_400_000;\n    return new Date(Date.now() - ms);\n  }\n  return new Date(raw);\n}\n"]}

package/dist/commands/mail-send.d.ts

@@ -0,0 +1,17 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+type SendFlags = {
+    to?: string;
+    subject?: string;
+    body?: string;
+    cc?: string;
+    bcc?: string;
+    account?: string;
+    json?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<SendFlags>, {
+    messageId: string;
+} | null>;
+
+export { _default as default };

package/dist/commands/mail-send.js

@@ -0,0 +1,111 @@
+import { defineCommand, validationError } from '@kb-labs/sdk';
+import { resolveAccount, sendMessage, InboxError } from '@kb-labs/inbox-core';
+
+// src/commands/mail-send.ts
+function getHint(code, message) {
+  switch (code) {
+    case "ENV_MISSING":
+      return "Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)";
+    case "ACCOUNT_NOT_FOUND":
+      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;
+    case "IMAP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "IMAP_CONNECT_FAILED":
+      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;
+    case "IMAP_TIMEOUT":
+      return "Server did not respond in time \u2014 try again in a moment";
+    case "IMAP_MAILBOX_NOT_FOUND":
+      return "Run kb inbox folders --account <name> to see available folders";
+    case "MESSAGE_NOT_FOUND":
+      return "The uid may be stale \u2014 refresh with: kb inbox list";
+    case "SMTP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "SMTP_CONNECT_FAILED":
+      return "Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT";
+    case "SMTP_INVALID_RECIPIENT":
+      return "Verify the --to address is a valid email";
+    case "VALIDATION_ERROR":
+      return void 0;
+    // message itself is descriptive enough
+    case "INTERNAL_ERROR":
+      return void 0;
+    default: {
+      return void 0;
+    }
+  }
+}
+function handleError(ctx, err, isJson) {
+  if (err instanceof InboxError) {
+    const hint = getHint(err.code, err.message);
+    if (isJson) {
+      ctx.ui?.json?.({
+        ok: false,
+        error: {
+          code: err.code,
+          message: err.message,
+          ...hint && { hint }
+        }
+      });
+    } else {
+      ctx.ui?.error?.(err.message, {
+        ...hint && { hint },
+        cause: `InboxError [${err.code}]`
+      });
+    }
+    return;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  if (isJson) {
+    ctx.ui?.json?.({
+      ok: false,
+      error: { code: "INTERNAL_ERROR", message }
+    });
+  } else {
+    ctx.ui?.error?.(message);
+  }
+}
+
+// src/commands/mail-send.ts
+var mail_send_default = defineCommand({
+  id: "inbox:mail.send",
+  description: "Send an email",
+  handler: {
+    async execute(ctx, input) {
+      if (!input.flags.to) {
+        validationError(ctx, "--to is required", 'Usage: kb inbox send --to user@example.com --subject "..." --body "..."', input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+      if (!input.flags.subject) {
+        validationError(ctx, "--subject is required", void 0, input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+      if (!input.flags.body) {
+        validationError(ctx, "--body is required", void 0, input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+      try {
+        const account = resolveAccount(input.flags.account);
+        const result = await sendMessage(account, {
+          to: input.flags.to,
+          subject: input.flags.subject,
+          body: input.flags.body,
+          cc: input.flags.cc,
+          bcc: input.flags.bcc
+        });
+        if (input.flags.json) {
+          ctx.ui?.json?.({ ok: true, result });
+          return { exitCode: 0, result };
+        }
+        ctx.ui?.success?.(`Message sent  id: ${result.messageId}`);
+        return { exitCode: 0, result };
+      } catch (err) {
+        handleError(ctx, err, input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+    }
+  }
+});
+
+export { mail_send_default as default };
+//# sourceMappingURL=mail-send.js.map
+//# sourceMappingURL=mail-send.js.map

package/dist/commands/mail-send.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/error.ts","../../src/commands/mail-send.ts"],"names":[],"mappings":"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","file":"mail-send.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { InboxError, type InboxErrorCode } from '@kb-labs/inbox-core';\n\n// HTTP status codes for REST layer\nconst REST_STATUS: Record<InboxErrorCode, number> = {\n  ENV_MISSING:            400,\n  ACCOUNT_NOT_FOUND:      400,\n  IMAP_AUTH_FAILED:       401,\n  IMAP_CONNECT_FAILED:    503,\n  IMAP_TIMEOUT:           504,\n  IMAP_MAILBOX_NOT_FOUND: 404,\n  MESSAGE_NOT_FOUND:      404,\n  SMTP_AUTH_FAILED:       401,\n  SMTP_CONNECT_FAILED:    503,\n  SMTP_INVALID_RECIPIENT: 400,\n  VALIDATION_ERROR:       400,\n  INTERNAL_ERROR:         500,\n};\n\n// Human-readable hints per error code\nfunction getHint(code: InboxErrorCode, message: string): string | undefined {\n  switch (code) {\n    case 'ENV_MISSING':\n      return 'Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)';\n    case 'ACCOUNT_NOT_FOUND':\n      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;\n    case 'IMAP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'IMAP_CONNECT_FAILED':\n      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;\n    case 'IMAP_TIMEOUT':\n      return 'Server did not respond in time — try again in a moment';\n    case 'IMAP_MAILBOX_NOT_FOUND':\n      return 'Run kb inbox folders --account <name> to see available folders';\n    case 'MESSAGE_NOT_FOUND':\n      return 'The uid may be stale — refresh with: kb inbox list';\n    case 'SMTP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'SMTP_CONNECT_FAILED':\n      return 'Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT';\n    case 'SMTP_INVALID_RECIPIENT':\n      return 'Verify the --to address is a valid email';\n    case 'VALIDATION_ERROR':\n      return undefined; // message itself is descriptive enough\n    case 'INTERNAL_ERROR':\n      return undefined;\n    default: {\n      const _: never = code;\n      void _;\n      return undefined;\n    }\n  }\n}\n\n/**\n * Output a structured error for CLI commands.\n *\n * JSON mode  → { ok: false, error: { code, message, hint? } }  — agent-parseable\n * Human mode → ctx.ui.error() with hint and cause fields\n *\n * Call right before `return { exitCode: 1, result: null }`.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n\n    if (isJson) {\n      ctx.ui?.json?.({\n        ok: false,\n        error: {\n          code: err.code,\n          message: err.message,\n          ...(hint && { hint }),\n        },\n      });\n    } else {\n      ctx.ui?.error?.(err.message, {\n        ...(hint && { hint }),\n        cause: `InboxError [${err.code}]`,\n      });\n    }\n    return;\n  }\n\n  // Unknown error\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: { code: 'INTERNAL_ERROR', message },\n    });\n  } else {\n    ctx.ui?.error?.(message);\n  }\n}\n\n/**\n * Re-throws err as an HTTP-aware error for REST handlers.\n * InboxError → preserves HTTP status; others → 500.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n    throw Object.assign(new Error(err.message), {\n      statusCode: REST_STATUS[err.code] ?? 500,\n      code: err.code,\n      details: hint ? { hint } : undefined,\n    });\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  throw Object.assign(new Error(message), {\n    statusCode: 500,\n    code: 'INTERNAL_ERROR',\n  });\n}\n","import { defineCommand, validationError, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { resolveAccount, sendMessage } from '@kb-labs/inbox-core';\nimport { handleError } from '../utils/error.js';\n\ntype SendFlags = {\n  to?: string;\n  subject?: string;\n  body?: string;\n  cc?: string;\n  bcc?: string;\n  account?: string;\n  json?: boolean;\n};\n\nexport default defineCommand({\n  id: 'inbox:mail.send',\n  description: 'Send an email',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<SendFlags>) {\n      if (!input.flags.to) {\n        validationError(ctx, '--to is required', 'Usage: kb inbox send --to user@example.com --subject \"...\" --body \"...\"', input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n      if (!input.flags.subject) {\n        validationError(ctx, '--subject is required', undefined, input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n      if (!input.flags.body) {\n        validationError(ctx, '--body is required', undefined, input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n\n      try {\n        const account = resolveAccount(input.flags.account);\n        const result = await sendMessage(account, {\n          to: input.flags.to,\n          subject: input.flags.subject,\n          body: input.flags.body,\n          cc: input.flags.cc,\n          bcc: input.flags.bcc,\n        });\n\n        if (input.flags.json) {\n          ctx.ui?.json?.({ ok: true, result });\n          return { exitCode: 0, result };\n        }\n\n        ctx.ui?.success?.(`Message sent  id: ${result.messageId}`);\n        return { exitCode: 0, result };\n      } catch (err) {\n        handleError(ctx, err, input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n    },\n  },\n});\n"]}

package/dist/commands/mail-thread.d.ts

@@ -0,0 +1,13 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_inbox_contracts from '@kb-labs/inbox-contracts';
+import { CLIInput } from '@kb-labs/sdk';
+
+type ThreadFlags = {
+    folder?: string;
+    account?: string;
+    json?: boolean;
+    full?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<ThreadFlags>, _kb_labs_inbox_contracts.Email[] | null>;
+
+export { _default as default };

package/dist/commands/mail-thread.js

@@ -0,0 +1,137 @@
+import { defineCommand, validationError } from '@kb-labs/sdk';
+import { resolveAccount, getThread, InboxError } from '@kb-labs/inbox-core';
+
+// src/commands/mail-thread.ts
+function getHint(code, message) {
+  switch (code) {
+    case "ENV_MISSING":
+      return "Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)";
+    case "ACCOUNT_NOT_FOUND":
+      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;
+    case "IMAP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "IMAP_CONNECT_FAILED":
+      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;
+    case "IMAP_TIMEOUT":
+      return "Server did not respond in time \u2014 try again in a moment";
+    case "IMAP_MAILBOX_NOT_FOUND":
+      return "Run kb inbox folders --account <name> to see available folders";
+    case "MESSAGE_NOT_FOUND":
+      return "The uid may be stale \u2014 refresh with: kb inbox list";
+    case "SMTP_AUTH_FAILED":
+      return "Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS";
+    case "SMTP_CONNECT_FAILED":
+      return "Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT";
+    case "SMTP_INVALID_RECIPIENT":
+      return "Verify the --to address is a valid email";
+    case "VALIDATION_ERROR":
+      return void 0;
+    // message itself is descriptive enough
+    case "INTERNAL_ERROR":
+      return void 0;
+    default: {
+      return void 0;
+    }
+  }
+}
+function handleError(ctx, err, isJson) {
+  if (err instanceof InboxError) {
+    const hint = getHint(err.code, err.message);
+    if (isJson) {
+      ctx.ui?.json?.({
+        ok: false,
+        error: {
+          code: err.code,
+          message: err.message,
+          ...hint && { hint }
+        }
+      });
+    } else {
+      ctx.ui?.error?.(err.message, {
+        ...hint && { hint },
+        cause: `InboxError [${err.code}]`
+      });
+    }
+    return;
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  if (isJson) {
+    ctx.ui?.json?.({
+      ok: false,
+      error: { code: "INTERNAL_ERROR", message }
+    });
+  } else {
+    ctx.ui?.error?.(message);
+  }
+}
+
+// src/utils/slim.ts
+function formatDate(iso) {
+  const d = new Date(iso);
+  const now = /* @__PURE__ */ new Date();
+  const diff = now.getTime() - d.getTime();
+  if (diff < 6e4) {
+    return "just now";
+  }
+  if (diff < 36e5) {
+    return `${Math.floor(diff / 6e4)}m ago`;
+  }
+  if (diff < 864e5) {
+    return `${Math.floor(diff / 36e5)}h ago`;
+  }
+  if (diff < 7 * 864e5) {
+    return `${Math.floor(diff / 864e5)}d ago`;
+  }
+  return d.toLocaleDateString();
+}
+function formatFrom(from) {
+  return from.name ? `${from.name} <${from.address}>` : from.address;
+}
+
+// src/commands/mail-thread.ts
+var mail_thread_default = defineCommand({
+  id: "inbox:mail.thread",
+  description: "Get full email thread by uid",
+  handler: {
+    async execute(ctx, input) {
+      const [rawUid] = input.argv;
+      if (!rawUid) {
+        validationError(ctx, "uid is required", "Usage: kb inbox thread <uid>", input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+      const uid = parseInt(rawUid, 10);
+      if (isNaN(uid)) {
+        validationError(ctx, `Invalid uid: "${rawUid}" \u2014 must be a number`, void 0, input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+      try {
+        const account = resolveAccount(input.flags.account);
+        const thread = await getThread(account, uid, {
+          folder: input.flags.folder ?? "INBOX"
+        });
+        if (input.flags.json) {
+          ctx.ui?.json?.({ ok: true, result: thread });
+          return { exitCode: 0, result: thread };
+        }
+        ctx.ui?.info?.(`Thread: ${thread.length} message${thread.length !== 1 ? "s" : ""}`);
+        ctx.ui?.chain?.(thread.map((msg, i) => ({
+          title: `[${i + 1}/${thread.length}] [uid:${msg.uid}] ${msg.subject}`,
+          sections: [{
+            items: [
+              `from: ${formatFrom(msg.from)}  ${formatDate(msg.date)}`,
+              msg.text ? msg.text.slice(0, 500) : "(no text body)"
+            ]
+          }]
+        })));
+        return { exitCode: 0, result: thread };
+      } catch (err) {
+        handleError(ctx, err, input.flags.json);
+        return { exitCode: 1, result: null };
+      }
+    }
+  }
+});
+
+export { mail_thread_default as default };
+//# sourceMappingURL=mail-thread.js.map
+//# sourceMappingURL=mail-thread.js.map

package/dist/commands/mail-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/error.ts","../../src/utils/slim.ts","../../src/commands/mail-thread.ts"],"names":[],"mappings":"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","file":"mail-thread.js","sourcesContent":["import type { PluginContextV3 } from '@kb-labs/sdk';\nimport { InboxError, type InboxErrorCode } from '@kb-labs/inbox-core';\n\n// HTTP status codes for REST layer\nconst REST_STATUS: Record<InboxErrorCode, number> = {\n  ENV_MISSING:            400,\n  ACCOUNT_NOT_FOUND:      400,\n  IMAP_AUTH_FAILED:       401,\n  IMAP_CONNECT_FAILED:    503,\n  IMAP_TIMEOUT:           504,\n  IMAP_MAILBOX_NOT_FOUND: 404,\n  MESSAGE_NOT_FOUND:      404,\n  SMTP_AUTH_FAILED:       401,\n  SMTP_CONNECT_FAILED:    503,\n  SMTP_INVALID_RECIPIENT: 400,\n  VALIDATION_ERROR:       400,\n  INTERNAL_ERROR:         500,\n};\n\n// Human-readable hints per error code\nfunction getHint(code: InboxErrorCode, message: string): string | undefined {\n  switch (code) {\n    case 'ENV_MISSING':\n      return 'Set INBOX_ACCOUNTS=work,personal and account vars (INBOX_ACCOUNT_WORK_USER, _PASS, _IMAP_HOST, _SMTP_HOST)';\n    case 'ACCOUNT_NOT_FOUND':\n      return `Use kb inbox accounts to see configured accounts, then pass the name with --account`;\n    case 'IMAP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings (yandex.ru/id) and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'IMAP_CONNECT_FAILED':\n      return `Check INBOX_ACCOUNT_<NAME>_IMAP_HOST and _IMAP_PORT, and that the server is reachable`;\n    case 'IMAP_TIMEOUT':\n      return 'Server did not respond in time — try again in a moment';\n    case 'IMAP_MAILBOX_NOT_FOUND':\n      return 'Run kb inbox folders --account <name> to see available folders';\n    case 'MESSAGE_NOT_FOUND':\n      return 'The uid may be stale — refresh with: kb inbox list';\n    case 'SMTP_AUTH_FAILED':\n      return 'Create an app-password in Yandex ID settings and set it as INBOX_ACCOUNT_<NAME>_PASS';\n    case 'SMTP_CONNECT_FAILED':\n      return 'Check INBOX_ACCOUNT_<NAME>_SMTP_HOST and _SMTP_PORT';\n    case 'SMTP_INVALID_RECIPIENT':\n      return 'Verify the --to address is a valid email';\n    case 'VALIDATION_ERROR':\n      return undefined; // message itself is descriptive enough\n    case 'INTERNAL_ERROR':\n      return undefined;\n    default: {\n      const _: never = code;\n      void _;\n      return undefined;\n    }\n  }\n}\n\n/**\n * Output a structured error for CLI commands.\n *\n * JSON mode  → { ok: false, error: { code, message, hint? } }  — agent-parseable\n * Human mode → ctx.ui.error() with hint and cause fields\n *\n * Call right before `return { exitCode: 1, result: null }`.\n */\nexport function handleError(ctx: PluginContextV3, err: unknown, isJson?: boolean): void {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n\n    if (isJson) {\n      ctx.ui?.json?.({\n        ok: false,\n        error: {\n          code: err.code,\n          message: err.message,\n          ...(hint && { hint }),\n        },\n      });\n    } else {\n      ctx.ui?.error?.(err.message, {\n        ...(hint && { hint }),\n        cause: `InboxError [${err.code}]`,\n      });\n    }\n    return;\n  }\n\n  // Unknown error\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (isJson) {\n    ctx.ui?.json?.({\n      ok: false,\n      error: { code: 'INTERNAL_ERROR', message },\n    });\n  } else {\n    ctx.ui?.error?.(message);\n  }\n}\n\n/**\n * Re-throws err as an HTTP-aware error for REST handlers.\n * InboxError → preserves HTTP status; others → 500.\n */\nexport function rethrowForRest(err: unknown): never {\n  if (err instanceof InboxError) {\n    const hint = getHint(err.code, err.message);\n    throw Object.assign(new Error(err.message), {\n      statusCode: REST_STATUS[err.code] ?? 500,\n      code: err.code,\n      details: hint ? { hint } : undefined,\n    });\n  }\n\n  const message = err instanceof Error ? err.message : String(err);\n  throw Object.assign(new Error(message), {\n    statusCode: 500,\n    code: 'INTERNAL_ERROR',\n  });\n}\n","import type { Email, EmailSlim } from '@kb-labs/inbox-contracts';\n\nexport function slimEmail(email: Email): EmailSlim {\n  return {\n    uid: email.uid,\n    subject: email.subject,\n    from: email.from,\n    date: email.date,\n    folder: email.folder,\n    unread: !email.flags.includes('\\\\Seen'),\n    flagged: email.flags.includes('\\\\Flagged'),\n    hasAttachments: (email.attachments?.length ?? 0) > 0,\n  };\n}\n\nexport function formatDate(iso: string): string {\n  const d = new Date(iso);\n  const now = new Date();\n  const diff = now.getTime() - d.getTime();\n\n  if (diff < 60_000) { return 'just now'; }\n  if (diff < 3_600_000) { return `${Math.floor(diff / 60_000)}m ago`; }\n  if (diff < 86_400_000) { return `${Math.floor(diff / 3_600_000)}h ago`; }\n  if (diff < 7 * 86_400_000) { return `${Math.floor(diff / 86_400_000)}d ago`; }\n\n  return d.toLocaleDateString();\n}\n\nexport function formatFrom(from: { name?: string; address: string }): string {\n  return from.name ? `${from.name} <${from.address}>` : from.address;\n}\n","import { defineCommand, validationError, type CLIInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { resolveAccount, getThread } from '@kb-labs/inbox-core';\nimport { handleError } from '../utils/error.js';\nimport { formatDate, formatFrom } from '../utils/slim.js';\n\ntype ThreadFlags = {\n  folder?: string;\n  account?: string;\n  json?: boolean;\n  full?: boolean;\n};\n\nexport default defineCommand({\n  id: 'inbox:mail.thread',\n  description: 'Get full email thread by uid',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<ThreadFlags>) {\n      const [rawUid] = input.argv;\n      if (!rawUid) {\n        validationError(ctx, 'uid is required', 'Usage: kb inbox thread <uid>', input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n\n      const uid = parseInt(rawUid, 10);\n      if (isNaN(uid)) {\n        validationError(ctx, `Invalid uid: \"${rawUid}\" — must be a number`, undefined, input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n\n      try {\n        const account = resolveAccount(input.flags.account);\n        const thread = await getThread(account, uid, {\n          folder: input.flags.folder ?? 'INBOX',\n        });\n\n        if (input.flags.json) {\n          ctx.ui?.json?.({ ok: true, result: thread });\n          return { exitCode: 0, result: thread };\n        }\n\n        ctx.ui?.info?.(`Thread: ${thread.length} message${thread.length !== 1 ? 's' : ''}`);\n\n        ctx.ui?.chain?.(thread.map((msg, i) => ({\n          title: `[${i + 1}/${thread.length}] [uid:${msg.uid}] ${msg.subject}`,\n          sections: [{\n            items: [\n              `from: ${formatFrom(msg.from)}  ${formatDate(msg.date)}`,\n              msg.text ? msg.text.slice(0, 500) : '(no text body)',\n            ],\n          }],\n        })));\n\n        return { exitCode: 0, result: thread };\n      } catch (err) {\n        handleError(ctx, err, input.flags.json);\n        return { exitCode: 1, result: null };\n      }\n    },\n  },\n});\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './manifest.js';
+import '@kb-labs/plugin-contracts';

package/dist/index.js

@@ -0,0 +1,131 @@
+import { combinePermissions, GET, POST, PATCH, DELETE, mergeCliGroups, group, cmd } from '@kb-labs/sdk';
+import { INBOX_ROUTES, INBOX_BASE_PATH } from '@kb-labs/inbox-contracts';
+
+// src/manifest.ts
+var permissions = combinePermissions().withEnv([
+  "INBOX_ACCOUNTS",
+  "INBOX_ACCOUNT_*"
+  // covers all account vars: _USER, _PASS, _IMAP_HOST, etc.
+]).withNetwork({
+  tcp: { connect: ["imap.yandex.ru:993", "smtp.yandex.ru:465", "smtp.yandex.ru:587"] }
+}).withQuotas({ timeoutMs: 3e4, memoryMb: 128 }).build();
+var manifest = {
+  schema: "kb.plugin/3",
+  id: "@kb-labs/inbox",
+  version: "0.1.0",
+  display: {
+    name: "Inbox",
+    description: "Manage email via IMAP/SMTP \u2014 list, search, send, move, delete from CLI and REST API",
+    tags: ["email", "inbox", "imap", "smtp", "productivity"]
+  },
+  permissions,
+  cli: mergeCliGroups(
+    group({ path: "inbox", describe: "Email management", category: "Mail" }, [
+      cmd("inbox list", "./commands/mail-list.js#default", "List emails in a folder").read().flags({
+        folder: { type: "string", description: "Folder to list (default: INBOX)" },
+        unread: { type: "boolean", description: "Show only unread messages" },
+        since: { type: "string", description: "Filter by age: 24h, 7d, 2w or ISO date" },
+        limit: { type: "number", description: "Max results (default: 50)" },
+        account: { type: "string", description: "Account name or index (default: first)" },
+        json: { type: "boolean", description: "Output JSON" },
+        full: { type: "boolean", description: "Full JSON (requires --json)" }
+      }).examples(["kb inbox list", "kb inbox list --unread --since 24h", "kb inbox list --folder Work --account personal --json"]),
+      cmd("inbox get", "./commands/mail-get.js#default", "Get full email content by uid").read().flags({
+        folder: { type: "string", description: "Folder containing the message (default: INBOX)" },
+        attachments: { type: "boolean", description: "Include attachment list" },
+        account: { type: "string", description: "Account name or index" },
+        json: { type: "boolean", description: "Output JSON" },
+        full: { type: "boolean", description: "Full JSON (requires --json)" }
+      }).examples(["kb inbox get 42", "kb inbox get 42 --attachments --json", "kb inbox get 42 --folder Sent --account work"]),
+      cmd("inbox thread", "./commands/mail-thread.js#default", "Get full email thread by uid").read().flags({
+        folder: { type: "string", description: "Folder (default: INBOX)" },
+        account: { type: "string", description: "Account name or index" },
+        json: { type: "boolean", description: "Output JSON" },
+        full: { type: "boolean", description: "Full JSON (requires --json)" }
+      }).examples(["kb inbox thread 42", "kb inbox thread 42 --json"]),
+      cmd("inbox search", "./commands/mail-search.js#default", "Search emails by from, subject, body, or text").read().flags({
+        from: { type: "string", description: "Filter by sender" },
+        subject: { type: "string", description: "Filter by subject" },
+        body: { type: "string", description: "Filter by body text" },
+        text: { type: "string", description: "Full-text search (subject + body)" },
+        folder: { type: "string", description: "Folder to search (default: INBOX)" },
+        since: { type: "string", description: "Filter by age: 24h, 7d, 2w or ISO date" },
+        limit: { type: "number", description: "Max results (default: 20)" },
+        account: { type: "string", description: "Account name or index" },
+        json: { type: "boolean", description: "Output JSON" },
+        full: { type: "boolean", description: "Full JSON (requires --json)" }
+      }).examples([
+        "kb inbox search --from boss@company.com",
+        'kb inbox search --subject "invoice" --since 30d --json',
+        'kb inbox search --text "urgent" --limit 5 --json'
+      ]),
+      cmd("inbox send", "./commands/mail-send.js#default", "Send an email").mutate().flags({
+        to: { type: "string", description: "Recipient address (required)" },
+        subject: { type: "string", description: "Subject (required)" },
+        body: { type: "string", description: "Message body (required)" },
+        cc: { type: "string", description: "CC address" },
+        bcc: { type: "string", description: "BCC address" },
+        account: { type: "string", description: "Account name or index" },
+        json: { type: "boolean", description: "Output JSON" }
+      }).examples([
+        'kb inbox send --to user@example.com --subject "Hello" --body "Hi there"',
+        'kb inbox send --to user@example.com --subject "Report" --body "..." --account work --json'
+      ]),
+      cmd("inbox reply", "./commands/mail-reply.js#default", "Reply to an email by uid (preserves thread)").mutate().flags({
+        body: { type: "string", description: "Reply body (required)" },
+        folder: { type: "string", description: "Folder containing the original (default: INBOX)" },
+        account: { type: "string", description: "Account name or index" },
+        json: { type: "boolean", description: "Output JSON" }
+      }).examples(['kb inbox reply 42 --body "Thanks, will do"', 'kb inbox reply 42 --body "On it" --account work --json']),
+      cmd("inbox move", "./commands/mail-move.js#default", "Move an email to a folder").mutate().flags({
+        folder: { type: "string", description: "Destination folder (required)" },
+        from: { type: "string", description: "Source folder (default: INBOX)" },
+        account: { type: "string", description: "Account name or index" },
+        json: { type: "boolean", description: "Output JSON" }
+      }).examples(["kb inbox move 42 --folder Work", "kb inbox move 42 --folder Archive --from Sent --json"]),
+      cmd("inbox mark", "./commands/mail-mark.js#default", "Mark an email as read, unread, spam, or flagged").mutate().flags({
+        read: { type: "boolean", description: "Mark as read" },
+        unread: { type: "boolean", description: "Mark as unread" },
+        spam: { type: "boolean", description: "Mark as spam and move to Junk" },
+        flagged: { type: "boolean", description: "Flag the message" },
+        unflagged: { type: "boolean", description: "Remove flag" },
+        folder: { type: "string", description: "Folder (default: INBOX)" },
+        account: { type: "string", description: "Account name or index" },
+        json: { type: "boolean", description: "Output JSON" }
+      }).examples(["kb inbox mark 42 --read", "kb inbox mark 42 --spam", "kb inbox mark 42 --flagged --json"]),
+      cmd("inbox delete", "./commands/mail-delete.js#default", "Delete an email (moves to Trash)").mutate().flags({
+        folder: { type: "string", description: "Folder containing the message (default: INBOX)" },
+        account: { type: "string", description: "Account name or index" },
+        json: { type: "boolean", description: "Output JSON" }
+      }).examples(["kb inbox delete 42", "kb inbox delete 42 --folder Spam --json"]),
+      cmd("inbox folders", "./commands/mail-folders.js#default", "List available folders/mailboxes").read().flags({
+        account: { type: "string", description: "Account name or index" },
+        json: { type: "boolean", description: "Output JSON" }
+      }).examples(["kb inbox folders", "kb inbox folders --account work --json"]),
+      cmd("inbox accounts", "./commands/mail-accounts.js#default", "List configured email accounts").read().category("Config").flags({
+        json: { type: "boolean", description: "Output JSON" }
+      }).examples(["kb inbox accounts", "kb inbox accounts --json"])
+    ]),
+    group({ path: "inbox mail", describe: "Mail operations", category: "Mail" }, [])
+  ),
+  rest: {
+    basePath: INBOX_BASE_PATH,
+    routes: [
+      GET(INBOX_ROUTES.MESSAGES, "./rest/handlers/list-handler.js#default"),
+      GET(INBOX_ROUTES.MESSAGE, "./rest/handlers/get-handler.js#default"),
+      GET(INBOX_ROUTES.MESSAGE_THREAD, "./rest/handlers/thread-handler.js#default"),
+      GET(INBOX_ROUTES.SEARCH, "./rest/handlers/search-handler.js#default"),
+      POST(INBOX_ROUTES.MESSAGES, "./rest/handlers/send-handler.js#default", { input: { zod: "@kb-labs/inbox-contracts#SendMessageSchema" } }),
+      POST(INBOX_ROUTES.MESSAGE_REPLY, "./rest/handlers/reply-handler.js#default", { input: { zod: "@kb-labs/inbox-contracts#ReplyMessageSchema" } }),
+      PATCH(INBOX_ROUTES.MESSAGE_MOVE, "./rest/handlers/move-handler.js#default", { input: { zod: "@kb-labs/inbox-contracts#MoveMessageSchema" } }),
+      PATCH(INBOX_ROUTES.MESSAGE_MARK, "./rest/handlers/mark-handler.js#default", { input: { zod: "@kb-labs/inbox-contracts#MarkMessageSchema" } }),
+      DELETE(INBOX_ROUTES.MESSAGE, "./rest/handlers/delete-handler.js#default"),
+      GET(INBOX_ROUTES.FOLDERS, "./rest/handlers/folders-handler.js#default"),
+      GET(INBOX_ROUTES.ACCOUNTS, "./rest/handlers/accounts-handler.js#default")
+    ]
+  }
+};
+
+export { manifest as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map