@kb-labs/inbox-entry 2.96.0

package/dist/index.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,23 @@
+import * as _kb_labs_plugin_contracts from '@kb-labs/plugin-contracts';
+
+declare const manifest: {
+    schema: "kb.plugin/3";
+    id: string;
+    version: string;
+    display: {
+        name: string;
+        description: string;
+        tags: string[];
+    };
+    permissions: _kb_labs_plugin_contracts.PermissionSpec;
+    cli: {
+        commands: _kb_labs_plugin_contracts.CliCommandDecl[];
+        groupMeta?: _kb_labs_plugin_contracts.CliGroupMeta[];
+    };
+    rest: {
+        basePath: "/v1/plugins/inbox";
+        routes: _kb_labs_plugin_contracts.RestRouteDecl[];
+    };
+};
+
+export { manifest as default, manifest };

package/dist/manifest.js

@@ -0,0 +1,132 @@
+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")
+    ]
+  }
+};
+var manifest_default = manifest;
+
+export { manifest_default as default, manifest };
+//# sourceMappingURL=manifest.js.map
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/rest/handlers/accounts-handler.d.ts

@@ -0,0 +1,10 @@
+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 { RestInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<never, never, never>, {
+    ok: boolean;
+    result: _kb_labs_inbox_contracts.AccountInfo[];
+}>;
+
+export { _default as default };

package/dist/rest/handlers/accounts-handler.js

@@ -0,0 +1,81 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { listAccounts, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/accounts-handler.ts
+var REST_STATUS = {
+  ENV_MISSING: 400,
+  ACCOUNT_NOT_FOUND: 400,
+  IMAP_AUTH_FAILED: 401,
+  IMAP_CONNECT_FAILED: 503,
+  IMAP_TIMEOUT: 504,
+  IMAP_MAILBOX_NOT_FOUND: 404,
+  MESSAGE_NOT_FOUND: 404,
+  SMTP_AUTH_FAILED: 401,
+  SMTP_CONNECT_FAILED: 503,
+  SMTP_INVALID_RECIPIENT: 400,
+  VALIDATION_ERROR: 400,
+  INTERNAL_ERROR: 500
+};
+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 rethrowForRest(err) {
+  if (err instanceof InboxError) {
+    const hint = getHint(err.code, err.message);
+    throw Object.assign(new Error(err.message), {
+      statusCode: REST_STATUS[err.code] ?? 500,
+      code: err.code,
+      details: hint ? { hint } : void 0
+    });
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  throw Object.assign(new Error(message), {
+    statusCode: 500,
+    code: "INTERNAL_ERROR"
+  });
+}
+
+// src/rest/handlers/accounts-handler.ts
+var accounts_handler_default = defineHandler({
+  async execute(_ctx, _input) {
+    try {
+      const accounts = listAccounts();
+      return { ok: true, result: accounts };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { accounts_handler_default as default };
+//# sourceMappingURL=accounts-handler.js.map
+//# sourceMappingURL=accounts-handler.js.map

package/dist/rest/handlers/accounts-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/accounts-handler.ts"],"names":[],"mappings":";;;;AAIA,IAAM,WAAA,GAA8C;AAAA,EAClD,WAAA,EAAwB,GAAA;AAAA,EACxB,iBAAA,EAAwB,GAAA;AAAA,EACxB,gBAAA,EAAwB,GAAA;AAAA,EACxB,mBAAA,EAAwB,GAAA;AAAA,EACxB,YAAA,EAAwB,GAAA;AAAA,EACxB,sBAAA,EAAwB,GAAA;AAAA,EACxB,iBAAA,EAAwB,GAAA;AAAA,EACxB,gBAAA,EAAwB,GAAA;AAAA,EACxB,mBAAA,EAAwB,GAAA;AAAA,EACxB,sBAAA,EAAwB,GAAA;AAAA,EACxB,gBAAA,EAAwB,GAAA;AAAA,EACxB,cAAA,EAAwB;AAC1B,CAAA;AAGA,SAAS,OAAA,CAAQ,MAAsB,OAAA,EAAqC;AAC1E,EAAA,QAAQ,IAAA;AAAM,IACZ,KAAK,aAAA;AACH,MAAA,OAAO,4GAAA;AAAA,IACT,KAAK,mBAAA;AACH,MAAA,OAAO,CAAA,mFAAA,CAAA;AAAA,IACT,KAAK,kBAAA;AACH,MAAA,OAAO,qGAAA;AAAA,IACT,KAAK,qBAAA;AACH,MAAA,OAAO,CAAA,qFAAA,CAAA;AAAA,IACT,KAAK,cAAA;AACH,MAAA,OAAO,6DAAA;AAAA,IACT,KAAK,wBAAA;AACH,MAAA,OAAO,gEAAA;AAAA,IACT,KAAK,mBAAA;AACH,MAAA,OAAO,yDAAA;AAAA,IACT,KAAK,kBAAA;AACH,MAAA,OAAO,sFAAA;AAAA,IACT,KAAK,qBAAA;AACH,MAAA,OAAO,qDAAA;AAAA,IACT,KAAK,wBAAA;AACH,MAAA,OAAO,0CAAA;AAAA,IACT,KAAK,kBAAA;AACH,MAAA,OAAO,MAAA;AAAA;AAAA,IACT,KAAK,gBAAA;AACH,MAAA,OAAO,MAAA;AAAA,IACT,SAAS;AAGP,MAAA,OAAO,MAAA;AAAA,IACT;AAAA;AAEJ;AAiDO,SAAS,eAAe,GAAA,EAAqB;AAClD,EAAA,IAAI,eAAe,UAAA,EAAY;AAC7B,IAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,GAAA,CAAI,IAAA,EAAM,IAAI,OAAO,CAAA;AAC1C,IAAA,MAAM,OAAO,MAAA,CAAO,IAAI,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA,EAAG;AAAA,MAC1C,UAAA,EAAY,WAAA,CAAY,GAAA,CAAI,IAAI,CAAA,IAAK,GAAA;AAAA,MACrC,MAAM,GAAA,CAAI,IAAA;AAAA,MACV,OAAA,EAAS,IAAA,GAAO,EAAE,IAAA,EAAK,GAAI;AAAA,KAC5B,CAAA;AAAA,EACH;AAEA,EAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,OAAO,CAAA,EAAG;AAAA,IACtC,UAAA,EAAY,GAAA;AAAA,IACZ,IAAA,EAAM;AAAA,GACP,CAAA;AACH;;;AChHA,IAAO,2BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,IAAA,EAAuB,MAAA,EAAwC;AAC3E,IAAA,IAAI;AACF,MAAA,MAAM,WAAW,YAAA,EAAa;AAC9B,MAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,MAAA,EAAQ,QAAA,EAAS;AAAA,IACtC,SAAS,GAAA,EAAK;AACZ,MAAA,cAAA,CAAe,GAAG,CAAA;AAAA,IACpB;AAAA,EACF;AACF,CAAC","file":"accounts-handler.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 { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport { listAccounts } from '@kb-labs/inbox-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, _input: RestInput<never, never, never>) {\n    try {\n      const accounts = listAccounts();\n      return { ok: true, result: accounts };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/dist/rest/handlers/delete-handler.d.ts

@@ -0,0 +1,19 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+type Query = {
+    folder?: string;
+    account?: string;
+};
+type Params = {
+    uid: string;
+};
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<Query, never, Params>, {
+    ok: boolean;
+    result: {
+        uid: number;
+        deleted: boolean;
+    };
+}>;
+
+export { _default as default };

package/dist/rest/handlers/delete-handler.js

@@ -0,0 +1,87 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, deleteMessage, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/delete-handler.ts
+var REST_STATUS = {
+  ENV_MISSING: 400,
+  ACCOUNT_NOT_FOUND: 400,
+  IMAP_AUTH_FAILED: 401,
+  IMAP_CONNECT_FAILED: 503,
+  IMAP_TIMEOUT: 504,
+  IMAP_MAILBOX_NOT_FOUND: 404,
+  MESSAGE_NOT_FOUND: 404,
+  SMTP_AUTH_FAILED: 401,
+  SMTP_CONNECT_FAILED: 503,
+  SMTP_INVALID_RECIPIENT: 400,
+  VALIDATION_ERROR: 400,
+  INTERNAL_ERROR: 500
+};
+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 rethrowForRest(err) {
+  if (err instanceof InboxError) {
+    const hint = getHint(err.code, err.message);
+    throw Object.assign(new Error(err.message), {
+      statusCode: REST_STATUS[err.code] ?? 500,
+      code: err.code,
+      details: hint ? { hint } : void 0
+    });
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  throw Object.assign(new Error(message), {
+    statusCode: 500,
+    code: "INTERNAL_ERROR"
+  });
+}
+
+// src/rest/handlers/delete-handler.ts
+var delete_handler_default = defineHandler({
+  async execute(_ctx, input) {
+    try {
+      const uid = parseInt(input.params?.uid ?? "", 10);
+      if (isNaN(uid)) {
+        throw Object.assign(new Error("uid must be a number"), { statusCode: 400, code: "VALIDATION_ERROR" });
+      }
+      const q = input.query ?? {};
+      const account = resolveAccount(q.account);
+      await deleteMessage(account, uid, q.folder ?? "INBOX");
+      return { ok: true, result: { uid, deleted: true } };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { delete_handler_default as default };
+//# sourceMappingURL=delete-handler.js.map
+//# sourceMappingURL=delete-handler.js.map

package/dist/rest/handlers/delete-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/delete-handler.ts"],"names":[],"mappings":"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","file":"delete-handler.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 { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport { resolveAccount, deleteMessage } from '@kb-labs/inbox-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\ntype Query = { folder?: string; account?: string };\ntype Params = { uid: string };\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<Query, never, Params>) {\n    try {\n      const uid = parseInt(input.params?.uid ?? '', 10);\n      if (isNaN(uid)) { throw Object.assign(new Error('uid must be a number'), { statusCode: 400, code: 'VALIDATION_ERROR' }); }\n\n      const q = input.query ?? {};\n      const account = resolveAccount(q.account);\n      await deleteMessage(account, uid, q.folder ?? 'INBOX');\n\n      return { ok: true, result: { uid, deleted: true } };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/dist/rest/handlers/folders-handler.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 { RestInput } from '@kb-labs/sdk';
+
+type Query = {
+    account?: string;
+};
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<Query, never, never>, {
+    ok: boolean;
+    result: _kb_labs_inbox_contracts.Folder[];
+}>;
+
+export { _default as default };

package/dist/rest/handlers/folders-handler.js

@@ -0,0 +1,82 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, listFolders, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/folders-handler.ts
+var REST_STATUS = {
+  ENV_MISSING: 400,
+  ACCOUNT_NOT_FOUND: 400,
+  IMAP_AUTH_FAILED: 401,
+  IMAP_CONNECT_FAILED: 503,
+  IMAP_TIMEOUT: 504,
+  IMAP_MAILBOX_NOT_FOUND: 404,
+  MESSAGE_NOT_FOUND: 404,
+  SMTP_AUTH_FAILED: 401,
+  SMTP_CONNECT_FAILED: 503,
+  SMTP_INVALID_RECIPIENT: 400,
+  VALIDATION_ERROR: 400,
+  INTERNAL_ERROR: 500
+};
+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 rethrowForRest(err) {
+  if (err instanceof InboxError) {
+    const hint = getHint(err.code, err.message);
+    throw Object.assign(new Error(err.message), {
+      statusCode: REST_STATUS[err.code] ?? 500,
+      code: err.code,
+      details: hint ? { hint } : void 0
+    });
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  throw Object.assign(new Error(message), {
+    statusCode: 500,
+    code: "INTERNAL_ERROR"
+  });
+}
+
+// src/rest/handlers/folders-handler.ts
+var folders_handler_default = defineHandler({
+  async execute(_ctx, input) {
+    try {
+      const account = resolveAccount(input.query?.account);
+      const folders = await listFolders(account);
+      return { ok: true, result: folders };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { folders_handler_default as default };
+//# sourceMappingURL=folders-handler.js.map
+//# sourceMappingURL=folders-handler.js.map

package/dist/rest/handlers/folders-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/folders-handler.ts"],"names":[],"mappings":";;;;AAIA,IAAM,WAAA,GAA8C;AAAA,EAClD,WAAA,EAAwB,GAAA;AAAA,EACxB,iBAAA,EAAwB,GAAA;AAAA,EACxB,gBAAA,EAAwB,GAAA;AAAA,EACxB,mBAAA,EAAwB,GAAA;AAAA,EACxB,YAAA,EAAwB,GAAA;AAAA,EACxB,sBAAA,EAAwB,GAAA;AAAA,EACxB,iBAAA,EAAwB,GAAA;AAAA,EACxB,gBAAA,EAAwB,GAAA;AAAA,EACxB,mBAAA,EAAwB,GAAA;AAAA,EACxB,sBAAA,EAAwB,GAAA;AAAA,EACxB,gBAAA,EAAwB,GAAA;AAAA,EACxB,cAAA,EAAwB;AAC1B,CAAA;AAGA,SAAS,OAAA,CAAQ,MAAsB,OAAA,EAAqC;AAC1E,EAAA,QAAQ,IAAA;AAAM,IACZ,KAAK,aAAA;AACH,MAAA,OAAO,4GAAA;AAAA,IACT,KAAK,mBAAA;AACH,MAAA,OAAO,CAAA,mFAAA,CAAA;AAAA,IACT,KAAK,kBAAA;AACH,MAAA,OAAO,qGAAA;AAAA,IACT,KAAK,qBAAA;AACH,MAAA,OAAO,CAAA,qFAAA,CAAA;AAAA,IACT,KAAK,cAAA;AACH,MAAA,OAAO,6DAAA;AAAA,IACT,KAAK,wBAAA;AACH,MAAA,OAAO,gEAAA;AAAA,IACT,KAAK,mBAAA;AACH,MAAA,OAAO,yDAAA;AAAA,IACT,KAAK,kBAAA;AACH,MAAA,OAAO,sFAAA;AAAA,IACT,KAAK,qBAAA;AACH,MAAA,OAAO,qDAAA;AAAA,IACT,KAAK,wBAAA;AACH,MAAA,OAAO,0CAAA;AAAA,IACT,KAAK,kBAAA;AACH,MAAA,OAAO,MAAA;AAAA;AAAA,IACT,KAAK,gBAAA;AACH,MAAA,OAAO,MAAA;AAAA,IACT,SAAS;AAGP,MAAA,OAAO,MAAA;AAAA,IACT;AAAA;AAEJ;AAiDO,SAAS,eAAe,GAAA,EAAqB;AAClD,EAAA,IAAI,eAAe,UAAA,EAAY;AAC7B,IAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,GAAA,CAAI,IAAA,EAAM,IAAI,OAAO,CAAA;AAC1C,IAAA,MAAM,OAAO,MAAA,CAAO,IAAI,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA,EAAG;AAAA,MAC1C,UAAA,EAAY,WAAA,CAAY,GAAA,CAAI,IAAI,CAAA,IAAK,GAAA;AAAA,MACrC,MAAM,GAAA,CAAI,IAAA;AAAA,MACV,OAAA,EAAS,IAAA,GAAO,EAAE,IAAA,EAAK,GAAI;AAAA,KAC5B,CAAA;AAAA,EACH;AAEA,EAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,EAAA,MAAM,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,OAAO,CAAA,EAAG;AAAA,IACtC,UAAA,EAAY,GAAA;AAAA,IACZ,IAAA,EAAM;AAAA,GACP,CAAA;AACH;;;AC9GA,IAAO,0BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,IAAA,EAAuB,KAAA,EAAuC;AAC1E,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,GAAU,cAAA,CAAe,KAAA,CAAM,KAAA,EAAO,OAAO,CAAA;AACnD,MAAA,MAAM,OAAA,GAAU,MAAM,WAAA,CAAY,OAAO,CAAA;AACzC,MAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,MAAA,EAAQ,OAAA,EAAQ;AAAA,IACrC,SAAS,GAAA,EAAK;AACZ,MAAA,cAAA,CAAe,GAAG,CAAA;AAAA,IACpB;AAAA,EACF;AACF,CAAC","file":"folders-handler.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 { defineHandler, type PluginContextV3, type RestInput } from '@kb-labs/sdk';\nimport { resolveAccount, listFolders } from '@kb-labs/inbox-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\ntype Query = { account?: string };\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<Query, never, never>) {\n    try {\n      const account = resolveAccount(input.query?.account);\n      const folders = await listFolders(account);\n      return { ok: true, result: folders };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

package/dist/rest/handlers/get-handler.d.ts

@@ -0,0 +1,18 @@
+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 { RestInput } from '@kb-labs/sdk';
+
+type Query = {
+    folder?: string;
+    attachments?: string;
+    account?: string;
+};
+type Params = {
+    uid: string;
+};
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<Query, never, Params>, {
+    ok: boolean;
+    result: _kb_labs_inbox_contracts.Email;
+}>;
+
+export { _default as default };