@aitne/daemon 0.1.6 → 0.1.8

package/dist/api/routes/mail/_pa_wip_mail/body-helpers.d.ts

@@ -0,0 +1,55 @@
+import type { MailMessage, ThreadView } from "../../../services/mail/provider.js";
+export declare const MAIL_BODY_CHUNK_DEFAULT_CHARS = 12000;
+export declare const MAIL_BODY_CHUNK_MAX_CHARS = 50000;
+export declare const MAIL_BODY_METADATA_DEFAULT_LIMIT = 100;
+export declare const MAIL_BODY_METADATA_MAX_LIMIT = 500;
+export type MailBodyFormat = "extracted" | "raw";
+export type MailBodySource = "html" | "text" | "empty";
+export type MailBodyMode = "full" | "none";
+export declare function buildMailBodyResponse(input: {
+    accountId: string;
+    message: MailMessage;
+    format: MailBodyFormat;
+    chunk: number;
+    maxChars: number;
+    metadataOffset: number;
+    metadataLimit: number;
+}): {
+    accountId: string;
+    providerMsgId: any;
+    rfc822MsgId: any;
+    threadId: any;
+    subject: any;
+    format: MailBodyFormat;
+    source: MailBodySource;
+    content: string;
+    chunk: number;
+    maxChars: number;
+    totalChars: number;
+    hasMore: boolean;
+    nextChunk: number | null;
+    rawHtmlAvailable: boolean;
+    rawTextAvailable: boolean;
+    metadataOffset: number;
+    metadataLimit: number;
+    links: ExtractedMailHtmlLink[];
+    images: ExtractedMailHtmlImage[];
+    linkCount: number;
+    imageCount: number;
+    linksHasMore: boolean;
+    imagesHasMore: boolean;
+    nextMetadataOffset: number | null;
+};
+export declare function parseBodyMode(raw: string | undefined): {
+    ok: true;
+    value: MailBodyMode;
+} | {
+    ok: false;
+    body: {
+        error: string;
+        message: string;
+    };
+};
+export declare function applyMailMessageBodyMode(message: MailMessage, mode: MailBodyMode): MailMessage;
+export declare function applyThreadBodyMode(thread: ThreadView, mode: MailBodyMode): ThreadView;
+//# sourceMappingURL=body-helpers.d.ts.map

package/dist/api/routes/mail/_pa_wip_mail/body-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/api/routes/mail/_pa_wip_mail/body-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACX,MAAM,oCAAoC,CAAC;AAQ5C,eAAO,MAAM,6BAA6B,QAAS,CAAC;AACpD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAChD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,KAAK,CAAC;AACjD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;;;;;;;;;;;;;;;;;;;;;;;;;EA0CA;AAgCD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,GAAG,SAAS,GAErB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAO1D;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,YAAY,GACjB,WAAW,CAGb;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,YAAY,GACjB,UAAU,CAQZ"}

package/dist/api/routes/mail/_pa_wip_mail/body-helpers.js

@@ -0,0 +1,91 @@
+import { extractMailHtmlBody, renderExtractedMailHtmlBody, } from "../../../services/mail/html-to-plaintext.js";
+export const MAIL_BODY_CHUNK_DEFAULT_CHARS = 12_000;
+export const MAIL_BODY_CHUNK_MAX_CHARS = 50_000;
+export const MAIL_BODY_METADATA_DEFAULT_LIMIT = 100;
+export const MAIL_BODY_METADATA_MAX_LIMIT = 500;
+export function buildMailBodyResponse(input) {
+    const { message, format, chunk, maxChars, metadataOffset, metadataLimit } = input;
+    const resolved = resolveMailBody(message, format);
+    const totalChars = resolved.content.length;
+    const start = chunk * maxChars;
+    const end = start + maxChars;
+    const content = start < totalChars ? resolved.content.slice(start, end) : "";
+    const hasMore = end < totalChars;
+    const links = resolved.links.slice(metadataOffset, metadataOffset + metadataLimit);
+    const images = resolved.images.slice(metadataOffset, metadataOffset + metadataLimit);
+    const linksHasMore = metadataOffset + metadataLimit < resolved.links.length;
+    const imagesHasMore = metadataOffset + metadataLimit < resolved.images.length;
+    return {
+        accountId: input.accountId,
+        providerMsgId: message.providerMsgId,
+        rfc822MsgId: message.rfc822MsgId,
+        threadId: message.threadId,
+        subject: message.subject,
+        format,
+        source: resolved.source,
+        content,
+        chunk,
+        maxChars,
+        totalChars,
+        hasMore,
+        nextChunk: hasMore ? chunk + 1 : null,
+        rawHtmlAvailable: typeof message.body.html === "string" && message.body.html.length > 0,
+        rawTextAvailable: typeof message.body.text === "string" && message.body.text.length > 0,
+        metadataOffset,
+        metadataLimit,
+        links,
+        images,
+        linkCount: resolved.links.length,
+        imageCount: resolved.images.length,
+        linksHasMore,
+        imagesHasMore,
+        nextMetadataOffset: linksHasMore || imagesHasMore ? metadataOffset + metadataLimit : null,
+    };
+}
+function resolveMailBody(message, format) {
+    const html = message.body.html;
+    const text = message.body.text;
+    if (format === "raw") {
+        if (html)
+            return { content: html, source: "html", links: [], images: [] };
+        if (text)
+            return { content: text, source: "text", links: [], images: [] };
+        return { content: "", source: "empty", links: [], images: [] };
+    }
+    if (html) {
+        const extracted = extractMailHtmlBody(html);
+        return {
+            content: renderExtractedMailHtmlBody(extracted),
+            source: "html",
+            links: extracted.links,
+            images: extracted.images,
+        };
+    }
+    if (text)
+        return { content: text, source: "text", links: [], images: [] };
+    return { content: "", source: "empty", links: [], images: [] };
+}
+export function parseBodyMode(raw) {
+    if (raw === undefined || raw === "full")
+        return { ok: true, value: "full" };
+    if (raw === "none")
+        return { ok: true, value: "none" };
+    return {
+        ok: false,
+        body: { error: "invalid_query", message: "body must be full or none" },
+    };
+}
+export function applyMailMessageBodyMode(message, mode) {
+    if (mode === "full")
+        return message;
+    return { ...message, body: {} };
+}
+export function applyThreadBodyMode(thread, mode) {
+    if (mode === "full")
+        return thread;
+    return {
+        ...thread,
+        messages: thread.messages.map((message) => applyMailMessageBodyMode(message, mode)),
+    };
+}
+//# sourceMappingURL=body-helpers.js.map

package/dist/api/routes/mail/_pa_wip_mail/body-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-helpers.js","sourceRoot":"","sources":["../../../../../src/api/routes/mail/_pa_wip_mail/body-helpers.ts"],"names":[],"mappings":"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"}

package/dist/api/routes/mail/_pa_wip_mail/dependencies.d.ts

@@ -0,0 +1,36 @@
+import type Database from "better-sqlite3";
+import type { AgentConfig } from "../../../config.js";
+import type { ServiceRegistry } from "../../../services/service-registry.js";
+import type { SettingsStore } from "../../../settings/settings-store.js";
+import type { AgentWriteTracker } from "../../../safety/agent-write-tracker.js";
+import type { EncryptedBlobStore } from "../../../secrets/encrypted-blob-store.js";
+import type { ImapAccountSecret } from "../../../services/mail/imap/app-password.js";
+import type { verifyImapAccountSecret } from "../../../services/mail/imap/client.js";
+export interface MailRouteDependencies {
+    db: Database.Database;
+    config: AgentConfig;
+    services: ServiceRegistry;
+    /**
+     * Required to read/write the Outlook BYOA client config blob and to support
+     * future provider blobs. Optional only because Phase 1 routes that don't
+     * touch blobs would still work without it; Phase 2 routes return 503 when
+     * absent.
+     */
+    blobStore?: EncryptedBlobStore;
+    settingsStore?: SettingsStore;
+    verifyImapAccountSecret?: (secret: ImapAccountSecret) => Promise<Awaited<ReturnType<typeof verifyImapAccountSecret>>>;
+    /**
+     * Shared write tracker — used by send/modify/trash routes so the unified
+     * mail-poller suppresses messages the agent just touched (§3.2). Optional
+     * for tests that construct mail routes in isolation.
+     */
+    writeTracker?: AgentWriteTracker;
+    /**
+     * Fired when the set of enabled mail providers or active accounts changes
+     * (toggle, remove, re-consent). Optional; the daemon wires this to wake up
+     * the unified poller so new accounts start being observed immediately
+     * without waiting for the next scheduled tick.
+     */
+    onMailScopeChanged?: (reason: string) => void;
+}
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/api/routes/mail/_pa_wip_mail/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../../../../src/api/routes/mail/_pa_wip_mail/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAErF,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,uBAAuB,CAAC,EAAE,CACxB,MAAM,EAAE,iBAAiB,KACtB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC;IAClE;;;;OAIG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C"}

package/dist/api/routes/mail/_pa_wip_mail/dependencies.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dependencies.js.map

package/dist/api/routes/mail/_pa_wip_mail/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../../../../src/api/routes/mail/_pa_wip_mail/dependencies.ts"],"names":[],"mappings":""}

package/dist/api/routes/mail/_pa_wip_mail/gating.d.ts

@@ -0,0 +1,45 @@
+import { type IntegrationKey } from "@aitne/shared";
+import type { MailProviderKind } from "../../../services/mail/provider.js";
+export declare const ALL_KINDS: readonly MailProviderKind[];
+export declare const PROVIDER_LABELS: Record<MailProviderKind, string>;
+/**
+ * Maps a mail provider kind to the `IntegrationKey` whose mode gates that
+ * kind under the §4.8 per-account delegated rule. Kinds outside the
+ * registry return null — iCloud, Yahoo, and generic IMAP are direct-only
+ * by design and never enter the delegated surface.
+ */
+export type MailGatedIntegrationKey = Extract<IntegrationKey, "gmail" | "outlook_mail">;
+export declare function gatedIntegrationForKind(kind: MailProviderKind): MailGatedIntegrationKey | null;
+export declare function delegatedMailIntegrationMessage(key: MailGatedIntegrationKey, delegatedBackend: string | null | undefined): string;
+/**
+ * INTEGRATION_NATIVE_MODE_DESIGN.md §9.2 — `/api/mail/*` cannot be
+ * prefix-gated by `integration-route-gate.ts` because it is
+ * multi-provider; the gated kinds (Gmail, Outlook) get a per-account
+ * 410 inside the handler. This helper produces the body for
+ * `delegated` and `native` modes (the two daemonless modes that have
+ * an explicit redirect target — the user's MCP). `disabled` is
+ * intentionally NOT gated here: the integration map defaults to
+ * `disabled`, and a fresh install with Gmail/Outlook accounts already
+ * provisioned would otherwise 410 their entire `/api/mail/*` surface
+ * before the user has even visited the mode picker. The integration
+ * registry's poller filter handles the `disabled` case at the data
+ * path; the route-level 410 for disabled is reserved for the
+ * centralised middleware where `apiRoutesTouched` declares prefix
+ * coverage.
+ *
+ * The error codes mirror the centralised middleware's vocabulary so
+ * dashboards can branch on the same string regardless of which gate
+ * fired.
+ */
+export declare function gatedMailIntegrationResponse(key: MailGatedIntegrationKey, state: {
+    mode: string;
+    delegatedBackend?: string | null;
+    nativeBackend?: string | null;
+}): {
+    error: "integration_delegated" | "integration_native";
+    message: string;
+    integration: MailGatedIntegrationKey;
+    backend: string | null;
+    mode: "delegated" | "native";
+} | null;
+//# sourceMappingURL=gating.d.ts.map

package/dist/api/routes/mail/_pa_wip_mail/gating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gating.d.ts","sourceRoot":"","sources":["../../../../../src/api/routes/mail/_pa_wip_mail/gating.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,eAAO,MAAM,SAAS,EAAE,SAAS,gBAAgB,EAKhD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAK5D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAC3C,cAAc,EACd,OAAO,GAAG,cAAc,CACzB,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,gBAAgB,GACrB,uBAAuB,GAAG,IAAI,CAIhC;AAED,wBAAgB,+BAA+B,CAC7C,GAAG,EAAE,uBAAuB,EAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,CAuBR;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,uBAAuB,EAC5B,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GACA;IACD,KAAK,EAAE,uBAAuB,GAAG,oBAAoB,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,uBAAuB,CAAC;IACrC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC9B,GAAG,IAAI,CAmCP"}

package/dist/api/routes/mail/_pa_wip_mail/gating.js

@@ -0,0 +1,98 @@
+import { INTEGRATION_DESCRIPTORS, } from "@aitne/shared";
+export const ALL_KINDS = [
+    "gmail",
+    "outlook",
+    "yahoo",
+    "icloud",
+];
+export const PROVIDER_LABELS = {
+    gmail: "Gmail",
+    outlook: "Outlook",
+    yahoo: "Yahoo Mail",
+    icloud: "iCloud Mail",
+};
+export function gatedIntegrationForKind(kind) {
+    if (kind === "gmail")
+        return "gmail";
+    if (kind === "outlook")
+        return "outlook_mail";
+    return null;
+}
+export function delegatedMailIntegrationMessage(key, delegatedBackend) {
+    const descriptor = INTEGRATION_DESCRIPTORS[key];
+    const displayName = descriptor.displayName;
+    const owner = delegatedBackend
+        ? `delegated to ${delegatedBackend}`
+        : "delegated";
+    // User-managed connector integrations (Outlook today) ship no
+    // daemon-side proxy. The agent must use whatever Outlook MCP /
+    // connector the user wired up on the chosen backend; pointing at
+    // `/api/integrations/.../invoke` would be a lie.
+    if (descriptor.userManagedConnector) {
+        return [
+            `${displayName} is in delegated mode (${owner}).`,
+            `The agent backend is expected to use the user-installed ${displayName} MCP / connector tools — the daemon does not proxy this integration.`,
+            "Other mail accounts remain available through /api/mail/*.",
+        ].join(" ");
+    }
+    return [
+        `${displayName} is in delegated mode (${owner}).`,
+        `Same-backend sessions: use the connector's native ${displayName} MCP tools.`,
+        `Cross-backend sessions: call POST /api/integrations/${key}/invoke.`,
+        `Non-${displayName} mail accounts remain available through /api/mail/*.`,
+    ].join(" ");
+}
+/**
+ * INTEGRATION_NATIVE_MODE_DESIGN.md §9.2 — `/api/mail/*` cannot be
+ * prefix-gated by `integration-route-gate.ts` because it is
+ * multi-provider; the gated kinds (Gmail, Outlook) get a per-account
+ * 410 inside the handler. This helper produces the body for
+ * `delegated` and `native` modes (the two daemonless modes that have
+ * an explicit redirect target — the user's MCP). `disabled` is
+ * intentionally NOT gated here: the integration map defaults to
+ * `disabled`, and a fresh install with Gmail/Outlook accounts already
+ * provisioned would otherwise 410 their entire `/api/mail/*` surface
+ * before the user has even visited the mode picker. The integration
+ * registry's poller filter handles the `disabled` case at the data
+ * path; the route-level 410 for disabled is reserved for the
+ * centralised middleware where `apiRoutesTouched` declares prefix
+ * coverage.
+ *
+ * The error codes mirror the centralised middleware's vocabulary so
+ * dashboards can branch on the same string regardless of which gate
+ * fired.
+ */
+export function gatedMailIntegrationResponse(key, state) {
+    const descriptor = INTEGRATION_DESCRIPTORS[key];
+    const displayName = descriptor.displayName;
+    if (state.mode === "delegated") {
+        return {
+            error: "integration_delegated",
+            message: delegatedMailIntegrationMessage(key, state.delegatedBackend ?? null),
+            integration: key,
+            backend: state.delegatedBackend ?? null,
+            mode: "delegated",
+        };
+    }
+    if (state.mode === "native") {
+        const nb = state.nativeBackend ?? null;
+        // User-managed integrations (Outlook) point at the user's installed
+        // MCP; descriptor-driven (Gmail) point at the backend's hosted
+        // connector and the SKILL.native.<backend>.md body. Mirrors the
+        // central route gate's branching so the agent gets symmetric copy
+        // whether the request hits a prefix-gated route or a multi-provider
+        // route.
+        const message = descriptor.userManagedConnector
+            ? `${displayName} is in native mode (bound to ${nb ?? "main backend"}). The agent backend is expected to use the user-installed ${displayName} MCP / connector tools — the daemon does not poll and does not expose a proxy for this integration. Other mail accounts remain available through /api/mail/*.`
+            : `${displayName} is in native mode (bound to ${nb ?? "main backend"}). Use the backend's native MCP tools (see the SKILL.native.${nb ?? "<backend>"}.md body); the daemon does not poll and does not expose a proxy for this integration. Other mail accounts remain available through /api/mail/*.`;
+        return {
+            error: "integration_native",
+            message,
+            integration: key,
+            backend: nb,
+            mode: "native",
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=gating.js.map

package/dist/api/routes/mail/_pa_wip_mail/gating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gating.js","sourceRoot":"","sources":["../../../../../src/api/routes/mail/_pa_wip_mail/gating.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GAExB,MAAM,eAAe,CAAC;AAGvB,MAAM,CAAC,MAAM,SAAS,GAAgC;IACpD,OAAO;IACP,SAAS;IACT,OAAO;IACP,QAAQ;CACT,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAqC;IAC/D,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,aAAa;CACtB,CAAC;AAaF,MAAM,UAAU,uBAAuB,CACrC,IAAsB;IAEtB,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACrC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,GAA4B,EAC5B,gBAA2C;IAE3C,MAAM,UAAU,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;IAC3C,MAAM,KAAK,GAAG,gBAAgB;QAC5B,CAAC,CAAC,gBAAgB,gBAAgB,EAAE;QACpC,CAAC,CAAC,WAAW,CAAC;IAChB,8DAA8D;IAC9D,+DAA+D;IAC/D,iEAAiE;IACjE,iDAAiD;IACjD,IAAI,UAAU,CAAC,oBAAoB,EAAE,CAAC;QACpC,OAAO;YACL,GAAG,WAAW,0BAA0B,KAAK,IAAI;YACjD,2DAA2D,WAAW,sEAAsE;YAC5I,2DAA2D;SAC5D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IACD,OAAO;QACL,GAAG,WAAW,0BAA0B,KAAK,IAAI;QACjD,qDAAqD,WAAW,aAAa;QAC7E,uDAAuD,GAAG,UAAU;QACpE,OAAO,WAAW,sDAAsD;KACzE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,4BAA4B,CAC1C,GAA4B,EAC5B,KAIC;IAQD,MAAM,UAAU,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;IAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC/B,OAAO;YACL,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EAAE,+BAA+B,CACtC,GAAG,EACH,KAAK,CAAC,gBAAgB,IAAI,IAAI,CAC/B;YACD,WAAW,EAAE,GAAG;YAChB,OAAO,EAAE,KAAK,CAAC,gBAAgB,IAAI,IAAI;YACvC,IAAI,EAAE,WAAW;SAClB,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC;QACvC,oEAAoE;QACpE,+DAA+D;QAC/D,gEAAgE;QAChE,kEAAkE;QAClE,oEAAoE;QACpE,SAAS;QACT,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB;YAC7C,CAAC,CAAC,GAAG,WAAW,gCAAgC,EAAE,IAAI,cAAc,8DAA8D,WAAW,+JAA+J;YAC5S,CAAC,CAAC,GAAG,WAAW,gCAAgC,EAAE,IAAI,cAAc,+DAA+D,EAAE,IAAI,WAAW,iJAAiJ,CAAC;QACxS,OAAO;YACL,KAAK,EAAE,oBAAoB;YAC3B,OAAO;YACP,WAAW,EAAE,GAAG;YAChB,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,QAAQ;SACf,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/api/routes/mail/_pa_wip_mail/mail/accounts.d.ts

@@ -0,0 +1,4 @@
+import type { Hono } from "hono";
+import type { MailRouteDependencies } from "./dependencies.js";
+export declare function registerAccountsRoutes(app: Hono, deps: MailRouteDependencies): void;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/api/routes/mail/_pa_wip_mail/mail/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../../../../../src/api/routes/mail/_pa_wip_mail/mail/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAajC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAI/D,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,qBAAqB,GAC1B,IAAI,CAySN"}