@kb-labs/inbox-entry 2.96.0

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

@@ -0,0 +1,90 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, getMessage, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/get-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/get-handler.ts
+var get_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);
+      const email = await getMessage(account, uid, {
+        folder: q.folder ?? "INBOX",
+        withAttachments: q.attachments === "true"
+      });
+      return { ok: true, result: email };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { get_handler_default as default };
+//# sourceMappingURL=get-handler.js.map
+//# sourceMappingURL=get-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/get-handler.ts"],"names":[],"mappings":"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","file":"get-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, getMessage } from '@kb-labs/inbox-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\ntype Query = { folder?: string; attachments?: 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      const email = await getMessage(account, uid, {\n        folder: q.folder ?? 'INBOX',\n        withAttachments: q.attachments === 'true',\n      });\n\n      return { ok: true, result: email };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

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

@@ -0,0 +1,17 @@
+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;
+    unread?: string;
+    since?: string;
+    limit?: string;
+    account?: string;
+};
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<Query, never, never>, {
+    ok: boolean;
+    result: _kb_labs_inbox_contracts.EmailSlim[];
+}>;
+
+export { _default as default };

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

@@ -0,0 +1,89 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, listMessages, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/list-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/list-handler.ts
+var list_handler_default = defineHandler({
+  async execute(_ctx, input) {
+    try {
+      const q = input.query ?? {};
+      const account = resolveAccount(q.account);
+      const since = q.since ? new Date(q.since) : void 0;
+      const messages = await listMessages(account, {
+        folder: q.folder ?? "INBOX",
+        unreadOnly: q.unread === "true",
+        since,
+        limit: q.limit ? parseInt(q.limit, 10) : 50
+      });
+      return { ok: true, result: messages };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { list_handler_default as default };
+//# sourceMappingURL=list-handler.js.map
+//# sourceMappingURL=list-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/list-handler.ts"],"names":[],"mappings":"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","file":"list-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, listMessages } from '@kb-labs/inbox-core';\nimport { rethrowForRest } from '../../utils/error.js';\n\ntype Query = { folder?: string; unread?: string; since?: string; limit?: string; account?: string };\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<Query, never, never>) {\n    try {\n      const q = input.query ?? {};\n      const account = resolveAccount(q.account);\n      const since = q.since ? new Date(q.since) : undefined;\n\n      const messages = await listMessages(account, {\n        folder: q.folder ?? 'INBOX',\n        unreadOnly: q.unread === 'true',\n        since,\n        limit: q.limit ? parseInt(q.limit, 10) : 50,\n      });\n\n      return { ok: true, result: messages };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

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

@@ -0,0 +1,18 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+type Params = {
+    uid: string;
+};
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<never, {
+    mark: "read" | "unread" | "spam" | "flagged" | "unflagged";
+    account?: string | undefined;
+}, Params>, {
+    ok: boolean;
+    result: {
+        uid: number;
+        action: "read" | "unread" | "spam" | "flagged" | "unflagged";
+    };
+}>;
+
+export { _default as default };

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

@@ -0,0 +1,87 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, markMessage, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/mark-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/mark-handler.ts
+var mark_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 body = input.body;
+      const account = resolveAccount(body.account);
+      await markMessage(account, uid, "INBOX", body.mark);
+      return { ok: true, result: { uid, action: body.mark } };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { mark_handler_default as default };
+//# sourceMappingURL=mark-handler.js.map
+//# sourceMappingURL=mark-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/mark-handler.ts"],"names":[],"mappings":"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","file":"mark-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, markMessage } from '@kb-labs/inbox-core';\nimport type { MarkMessageInput } from '@kb-labs/inbox-contracts';\nimport { rethrowForRest } from '../../utils/error.js';\n\ntype Params = { uid: string };\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<never, MarkMessageInput, 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 body = input.body!;\n      const account = resolveAccount(body.account);\n      await markMessage(account, uid, 'INBOX', body.mark);\n\n      return { ok: true, result: { uid, action: body.mark } };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

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

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

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

@@ -0,0 +1,87 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, moveMessage, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/move-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/move-handler.ts
+var move_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 body = input.body;
+      const account = resolveAccount(body.account);
+      await moveMessage(account, uid, "INBOX", body.folder);
+      return { ok: true, result: { uid, folder: body.folder } };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { move_handler_default as default };
+//# sourceMappingURL=move-handler.js.map
+//# sourceMappingURL=move-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/move-handler.ts"],"names":[],"mappings":"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","file":"move-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, moveMessage } from '@kb-labs/inbox-core';\nimport type { MoveMessageInput } from '@kb-labs/inbox-contracts';\nimport { rethrowForRest } from '../../utils/error.js';\n\ntype Params = { uid: string };\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<never, MoveMessageInput, 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 body = input.body!;\n      const account = resolveAccount(body.account);\n      await moveMessage(account, uid, 'INBOX', body.folder);\n\n      return { ok: true, result: { uid, folder: body.folder } };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

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

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

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

@@ -0,0 +1,93 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { resolveAccount, getMessage, replyMessage, InboxError } from '@kb-labs/inbox-core';
+
+// src/rest/handlers/reply-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/reply-handler.ts
+var reply_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 body = input.body;
+      const account = resolveAccount(body.account);
+      const original = await getMessage(account, uid, { folder: "INBOX" });
+      const result = await replyMessage(account, {
+        body: body.body,
+        originalMessageId: original.messageId,
+        originalReferences: original.references,
+        originalSubject: original.subject
+      }, body.body);
+      return { ok: true, result };
+    } catch (err) {
+      rethrowForRest(err);
+    }
+  }
+});
+
+export { reply_handler_default as default };
+//# sourceMappingURL=reply-handler.js.map
+//# sourceMappingURL=reply-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/error.ts","../../../src/rest/handlers/reply-handler.ts"],"names":[],"mappings":"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","file":"reply-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, getMessage, replyMessage } from '@kb-labs/inbox-core';\nimport type { ReplyMessageInput } from '@kb-labs/inbox-contracts';\nimport { rethrowForRest } from '../../utils/error.js';\n\ntype Params = { uid: string };\n\nexport default defineHandler({\n  async execute(_ctx: PluginContextV3, input: RestInput<never, ReplyMessageInput, 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 body = input.body!;\n      const account = resolveAccount(body.account);\n      const original = await getMessage(account, uid, { folder: 'INBOX' });\n\n      const result = await replyMessage(account, {\n        body: body.body,\n        originalMessageId: original.messageId,\n        originalReferences: original.references,\n        originalSubject: original.subject,\n      }, body.body);\n\n      return { ok: true, result };\n    } catch (err) {\n      rethrowForRest(err);\n    }\n  },\n});\n"]}

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

@@ -0,0 +1,20 @@
+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 = {
+    from?: string;
+    subject?: string;
+    body?: string;
+    text?: string;
+    folder?: string;
+    since?: string;
+    limit?: string;
+    account?: string;
+};
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<Query, never, never>, {
+    ok: boolean;
+    result: _kb_labs_inbox_contracts.EmailSlim[];
+}>;
+
+export { _default as default };