kennel 0.2.3 → 0.2.6

package/kernel/plugins/mail/src/mail-hooks.ts

@@ -1,252 +0,0 @@
-import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query"
-
-import { folderPathId } from "@raggle-ai/folder-plugin/client"
-
-import { mailRequest } from "./mail-request.js"
-
-export type MailListResponse = {
-  folder: string
-  items: MailListItemPayload[]
-}
-
-export type MailListItemPayload = {
-  attachments: string[]
-  bcc: string[]
-  cc: string[]
-  createdAt: string | null
-  excerpt: string
-  filePath: string
-  folder: string | null
-  from: string | null
-  id: string
-  inReplyTo: string | null
-  references: string[]
-  revision: string
-  status: string | null
-  subject: string | null
-  tags: string[]
-  to: string[]
-  updatedAt: string | null
-  noSignature: boolean
-}
-
-export type MailDetailPayload = Omit<MailListItemPayload, "excerpt"> & {
-  body: string
-}
-
-export type MailSenderPayload = {
-  from: string | null
-  name: string | null
-  ok: boolean
-}
-
-export type ConversationMessagePayload = {
-  body: string
-  date: string | null
-  from: string | null
-  id: string
-  subject: string | null
-  to: string | null
-}
-
-export type ConversationOutcome =
-  "empty" | "ok" | "partial" | "not-found" | "timeout"
-
-export type ConversationPayload = {
-  items: ConversationMessagePayload[]
-  missing: string[]
-  outcome: ConversationOutcome
-}
-
-export type MailSendPreviewPayload = {
-  dryRun: true
-  output: string
-  revision: string
-}
-
-export type MailSendResultPayload = {
-  dryRun: false
-  output: string
-}
-
-function mailPath(folder: string | null | undefined) {
-  return { path: folder ?? "" }
-}
-
-function folderCacheKey(folder: string | null | undefined) {
-  return ["folder", folder ? folderPathId(folder) : "none", "mail"] as const
-}
-
-export function useMailList(folder: string | null | undefined) {
-  return useQuery({
-    enabled: Boolean(folder),
-    gcTime: 5 * 60_000,
-    queryFn: ({ signal }) =>
-      mailRequest<MailListResponse>("/api/mail", {
-        search: mailPath(folder),
-        signal,
-      }),
-    queryKey: [...folderCacheKey(folder)],
-    staleTime: 15_000,
-  })
-}
-
-export type MailPreviewPayload = {
-  body: string
-  signature: string | null
-}
-
-export type MailDetailResponsePayload = {
-  mail: MailDetailPayload
-  preview?: MailPreviewPayload
-}
-
-export function useMailDetail(
-  folder: string | null | undefined,
-  mailId: string | null | undefined,
-) {
-  return useQuery<MailDetailResponsePayload>({
-    enabled: Boolean(folder && mailId),
-    gcTime: 5 * 60_000,
-    queryFn: ({ signal }) =>
-      mailRequest<MailDetailResponsePayload>("/api/mail/item", {
-        search: { ...mailPath(folder), id: mailId ?? "" },
-        signal,
-      }),
-    queryKey: [...folderCacheKey(folder), mailId ?? ""],
-    retry: false,
-    staleTime: 15_000,
-  })
-}
-
-/** Lazy sender resolution: runs only when the draft has no recorded From. */
-export function useMailSender(
-  folder: string | null | undefined,
-  mailId: string | null | undefined,
-  enabled: boolean,
-) {
-  return useQuery({
-    enabled: Boolean(enabled && mailId),
-    gcTime: 5 * 60_000,
-    queryFn: ({ signal }) =>
-      mailRequest<MailSenderPayload>("/api/mail/from", {
-        search: { ...mailPath(folder), id: mailId ?? "" },
-        signal,
-      }),
-    queryKey: [...folderCacheKey(folder), mailId ?? "", "from"],
-    retry: false,
-    staleTime: 15_000,
-  })
-}
-
-export function useMailConversation(
-  folder: string | null | undefined,
-  mailId: string | null | undefined,
-  enabled: boolean,
-) {
-  return useQuery<ConversationPayload>({
-    enabled: Boolean(enabled && mailId),
-    gcTime: 5 * 60_000,
-    queryFn: ({ signal }) =>
-      mailRequest<ConversationPayload>("/api/mail/conversation", {
-        search: { ...mailPath(folder), id: mailId ?? "" },
-        signal,
-      }),
-    queryKey: [...folderCacheKey(folder), mailId ?? "", "conversation"],
-    retry: false,
-    staleTime: 5 * 60_000,
-  })
-}
-
-export type MailActionInput = {
-  action: "archive" | "delete" | "remove-attachment"
-  id: string
-  path: string
-  revision: string
-  /** Absolute attachment path; used only with the remove-attachment action. */
-  attachment?: string
-}
-
-export function useMailAction(folder: string | null | undefined) {
-  const queryClient = useQueryClient()
-  return useMutation({
-    mutationFn: (input: MailActionInput) =>
-      mailRequest<{ action: string; id: string; ok: true }>(
-        "/api/mail/action",
-        {
-          body: input,
-          method: "POST",
-        },
-      ),
-    onSuccess: () => {
-      void queryClient.invalidateQueries({
-        queryKey: [...folderCacheKey(folder)],
-      })
-    },
-  })
-}
-
-export function useMailSend(folder: string | null | undefined) {
-  const queryClient = useQueryClient()
-  return useMutation({
-    mutationFn: (input: { dryRun: boolean; id: string; revision?: string }) =>
-      mailRequest<MailSendPreviewPayload | MailSendResultPayload>(
-        "/api/mail/send",
-        {
-          body: { path: folder ?? "", ...input },
-          method: "POST",
-        },
-      ),
-    onSuccess: () => {
-      void queryClient.invalidateQueries({
-        queryKey: [...folderCacheKey(folder)],
-      })
-    },
-  })
-}
-
-export type ConversationPanelState =
-  | { variant: "hidden" }
-  | { variant: "loading" }
-  | { variant: "error"; message: string }
-  | { variant: "empty" }
-  | { variant: "ok" }
-  | { variant: "partial"; missing: number }
-  | { variant: "not-found" }
-  | { variant: "timeout" }
-
-/**
- * Pure mapping from the conversation query to a UI state. A disabled query
- * (no references, or the detail still loading) is "hidden" — never an
- * endless loading spinner.
- */
-export function conversationPanelState(input: {
-  data?: ConversationPayload
-  enabled: boolean
-  error: unknown
-  isPending: boolean
-}): ConversationPanelState {
-  if (!input.enabled) return { variant: "hidden" }
-  if (input.isPending && !input.data) return { variant: "loading" }
-  if (input.error && !input.data) {
-    const message =
-      input.error instanceof Error
-        ? input.error.message
-        : "Could not load the conversation."
-    return { variant: "error", message }
-  }
-  switch (input.data?.outcome) {
-    case "empty":
-      return { variant: "empty" }
-    case "ok":
-      return input.data.items.length ? { variant: "ok" } : { variant: "empty" }
-    case "partial":
-      return { variant: "partial", missing: input.data.missing.length }
-    case "not-found":
-      return { variant: "not-found" }
-    case "timeout":
-      return { variant: "timeout" }
-    default:
-      return { variant: "hidden" }
-  }
-}

package/kernel/plugins/mail/src/mail-page.tsx

@@ -1,109 +0,0 @@
-import { RefreshCw } from "lucide-react"
-
-import type { FolderPluginViewProps } from "@raggle-ai/folder-plugin/client"
-import { folderLabel } from "@raggle-ai/mail/folders"
-import {
-  MailFolderFilter,
-  mailItemContext,
-  MailList,
-} from "@raggle-ai/mail/viewer"
-import { CopyContextButton } from "@raggle-ai/ui/components/copy-context"
-import { useFolderFilter } from "@raggle-ai/ui/hooks/use-folder-filter"
-
-import { useMailList } from "./mail-hooks.js"
-import { mailErrorText } from "./mail-request.js"
-
-export function MailPage({
-  folder,
-  href,
-}: Pick<FolderPluginViewProps, "folder" | "href">) {
-  const query = useMailList(folder)
-
-  const items = query.data?.items ?? []
-  const hasItems = Boolean(query.data?.items.length)
-  // Shared folder-filter state: derives the chips from the drafts' owning
-  // folders and filters the list. A selection whose folder no longer has
-  // drafts falls back to All folders rather than showing a dead-end list.
-  const { choices, effectiveSelected, setSelected, total, visibleItems } =
-    useFolderFilter(items, {
-      getFolder: (item) => item.folder,
-      rootFolder: folder ?? "",
-    })
-
-  if (!folder) {
-    return (
-      <div
-        className="mx-auto grid w-full max-w-3xl min-w-0 grid-cols-1 gap-4 px-4
-          py-5"
-      >
-        <p className="m-0 text-sm text-[#6c7a6d]">Open mail from a folder.</p>
-      </div>
-    )
-  }
-
-  return (
-    <div
-      className="mx-auto grid w-full max-w-3xl min-w-0 grid-cols-1 gap-4 px-4
-        py-5"
-    >
-      <div className="flex flex-wrap items-center justify-between gap-3">
-        <h1 className="m-0 text-2xl font-semibold text-[#233025]">Mail</h1>
-        <button
-          type="button"
-          className="inline-flex items-center gap-2 rounded-md border px-3
-            py-1.5 text-sm disabled:pointer-events-none disabled:opacity-50"
-          onClick={() => void query.refetch()}
-          disabled={query.isFetching}
-        >
-          <RefreshCw
-            className={query.isFetching ? "size-4 animate-spin" : "size-4"}
-          />
-          Refresh
-        </button>
-      </div>
-
-      {hasItems ? (
-        <MailFolderFilter
-          choices={choices}
-          onSelect={setSelected}
-          selected={effectiveSelected}
-          total={total}
-        />
-      ) : null}
-
-      {query.isPending ? (
-        <p className="m-0 text-sm text-[#6c7a6d]">Loading…</p>
-      ) : null}
-      {query.error ? (
-        <p className="m-0 text-sm text-[#9c3a3a]">
-          {mailErrorText(query.error)}
-        </p>
-      ) : null}
-
-      {!query.isPending && !query.error && !query.data?.items.length ? (
-        <p className="m-0 text-sm text-[#6c7a6d]">No mail found.</p>
-      ) : null}
-
-      {hasItems ? (
-        visibleItems.length ? (
-          <MailList
-            actions={(item) => (
-              <CopyContextButton
-                className="text-[#6c7a6d] hover:text-[#2f382f]"
-                context={() => mailItemContext(item)}
-                label={`Copy context for ${item.subject ?? "this draft"}`}
-              />
-            )}
-            folderLabel={(mailFolder) => folderLabel(mailFolder, folder)}
-            items={visibleItems}
-            mailHref={href}
-          />
-        ) : (
-          <p className="m-0 text-sm text-[#6c7a6d]">
-            No drafts in this folder.
-          </p>
-        )
-      ) : null}
-    </div>
-  )
-}

package/kernel/plugins/mail/src/mail-request.ts

@@ -1,78 +0,0 @@
-export type MailRequestOptions = {
-  body?: unknown
-  method?: "GET" | "POST" | "DELETE"
-  search?: Record<string, string | undefined>
-  signal?: AbortSignal
-}
-
-export class MailRequestFailure extends Error {
-  readonly status: number
-
-  constructor(status: number, message: string) {
-    super(message)
-    this.name = "MailRequestFailure"
-    this.status = status
-  }
-}
-
-function structuredMessage(text: string) {
-  try {
-    const parsed = JSON.parse(text) as {
-      error?: { code?: string; message?: string }
-    }
-    if (parsed.error?.message) return parsed.error.message
-  } catch {
-    // Non-JSON error bodies fall back to the raw text.
-  }
-  return text.trim() || "Mail request failed."
-}
-
-/**
- * Shared typed request helper for the mail API. GET requests never carry a
- * body (the server forbids mutations over GET); mutations send JSON which the
- * server's same-origin guard accepts only for same-site pages. JSON responses
- * are enforced and structured server errors become readable messages.
- */
-export async function mailRequest<T>(
-  path: string,
-  options: MailRequestOptions = {},
-): Promise<T> {
-  const search = new URLSearchParams()
-  for (const [key, value] of Object.entries(options.search ?? {})) {
-    if (value !== undefined) search.set(key, value)
-  }
-  const query = search.toString()
-  const url = `${path}${query ? `?${query}` : ""}`
-
-  const headers: Record<string, string> = {}
-  let body: string | undefined
-  if (options.body !== undefined) {
-    headers["content-type"] = "application/json"
-    body = JSON.stringify(options.body)
-  }
-
-  const response = await fetch(url, {
-    body,
-    headers,
-    method: options.method ?? "GET",
-    signal: options.signal,
-  })
-
-  const text = await response.text()
-  if (!response.ok) {
-    throw new MailRequestFailure(response.status, structuredMessage(text))
-  }
-  if (!response.headers.get("content-type")?.includes("application/json")) {
-    throw new MailRequestFailure(
-      response.status,
-      "The server returned a non-JSON response.",
-    )
-  }
-  return JSON.parse(text) as T
-}
-
-export function mailErrorText(error: unknown) {
-  if (error instanceof MailRequestFailure) return error.message
-  if (error instanceof Error) return error.message
-  return "Mail request failed."
-}

package/kernel/plugins/mail/src/mail-send-box.tsx

@@ -1,175 +0,0 @@
-import { useEffect, useState } from "react"
-import { CheckCircle2, Loader2, Send, XCircle } from "lucide-react"
-
-import type { MailSendPreviewPayload } from "./mail-hooks.js"
-import { useMailSend } from "./mail-hooks.js"
-import { mailErrorText } from "./mail-request.js"
-
-type SendPhase =
-  "idle" | "previewing" | "confirm" | "sending" | "sent" | "failed"
-
-/**
- * The preview-then-confirm send flow for one draft. State resets when the
- * active draft changes so navigation never carries a stale preview, and every
- * action disables the buttons while a request is in flight (double
- * submissions cannot start a send twice).
- */
-export function MailSendBox({
-  folder,
-  mailId,
-  status,
-}: {
-  folder: string | null | undefined
-  mailId: string | null | undefined
-  status: string | null | undefined
-}) {
-  const [phase, setPhase] = useState<SendPhase>("idle")
-  const [preview, setPreview] = useState<MailSendPreviewPayload | null>(null)
-  const [error, setError] = useState<string | null>(null)
-  const send = useMailSend(folder)
-
-  useEffect(() => {
-    setPhase("idle")
-    setPreview(null)
-    setError(null)
-  }, [mailId])
-
-  const pending =
-    send.isPending || phase === "previewing" || phase === "sending"
-
-  async function runPreview() {
-    if (!mailId || pending) return
-    setError(null)
-    setPhase("previewing")
-    try {
-      const result = await send.mutateAsync({ dryRun: true, id: mailId })
-      if (!("revision" in result)) {
-        throw new Error("MailOS did not return a revision.")
-      }
-      setPreview(result)
-      setPhase("confirm")
-    } catch (cause) {
-      setError(mailErrorText(cause))
-      setPhase("failed")
-    }
-  }
-
-  async function runSend() {
-    if (!mailId || !preview || pending) return
-    setError(null)
-    setPhase("sending")
-    try {
-      await send.mutateAsync({
-        dryRun: false,
-        id: mailId,
-        revision: preview.revision,
-      })
-      setPhase("sent")
-    } catch (cause) {
-      setError(mailErrorText(cause))
-      setPhase("failed")
-    }
-  }
-
-  return (
-    <div
-      className="rounded-xl border border-[#e7ebe7] bg-white px-4 py-3
-        shadow-[0_1px_2px_rgb(31_41_55/0.05)]"
-    >
-      {phase === "idle" ? (
-        <div className="flex flex-wrap items-center gap-3">
-          <button
-            type="button"
-            className="inline-flex w-fit items-center gap-2 rounded-md
-              bg-[#395641] px-3 py-1.5 text-sm text-white hover:bg-[#2f4b38]
-              disabled:pointer-events-none disabled:opacity-50"
-            onClick={() => void runPreview()}
-            disabled={status === "sent" || pending}
-          >
-            <Send className="size-4" />
-            {status === "sent" ? "Already sent" : "Send"}
-          </button>
-          <span className="text-[0.82rem] text-[#6c7a6d]">
-            Will preview for confirmation before delivering.
-          </span>
-        </div>
-      ) : null}
-
-      {phase === "previewing" || phase === "sending" ? (
-        <p className="m-0 flex items-center gap-2 text-sm text-[#4a554b]">
-          <Loader2 className="size-4 animate-spin" />
-          {phase === "previewing" ? "Previewing…" : "Sending…"}
-        </p>
-      ) : null}
-
-      {phase === "confirm" && preview ? (
-        <div className="grid gap-3">
-          <p className="m-0 text-sm text-[#4a554b]">
-            Ready to send this draft to its recipients.
-          </p>
-          <div className="flex flex-wrap items-center gap-2">
-            <button
-              type="button"
-              className="inline-flex w-fit items-center gap-2 rounded-md
-                bg-[#395641] px-3 py-1.5 text-sm text-white hover:bg-[#2f4b38]
-                disabled:pointer-events-none disabled:opacity-50"
-              onClick={() => void runSend()}
-              disabled={pending}
-            >
-              <Send className="size-4" />
-              Send now
-            </button>
-            <button
-              type="button"
-              className="w-fit rounded-md border border-[#dde1dc] bg-white px-3
-                py-1.5 text-sm text-[#4a554b] hover:bg-[#f3f5f2]
-                disabled:pointer-events-none disabled:opacity-50"
-              onClick={() => {
-                setPhase("idle")
-                setPreview(null)
-              }}
-              disabled={pending}
-            >
-              Cancel
-            </button>
-          </div>
-          <details className="text-[0.82rem] text-[#6c7a6d]">
-            <summary className="cursor-pointer">Preview output</summary>
-            <pre
-              className="mt-2 max-h-48 overflow-auto rounded-md bg-[#f3f5f2] p-2
-                text-[0.75rem] whitespace-pre-wrap text-[#4a554b]"
-            >
-              {preview.output}
-            </pre>
-          </details>
-        </div>
-      ) : null}
-
-      {phase === "sent" ? (
-        <p className="m-0 flex items-center gap-2 text-sm text-[#2f5b3a]">
-          <CheckCircle2 className="size-4" />
-          Sent.
-        </p>
-      ) : null}
-
-      {phase === "failed" ? (
-        <div className="grid gap-3">
-          <p className="m-0 flex items-center gap-2 text-sm text-[#9c3a3a]">
-            <XCircle className="size-4 shrink-0" />
-            <span className="break-words">{error}</span>
-          </p>
-          <button
-            type="button"
-            className="inline-flex w-fit items-center gap-2 rounded-md border
-              border-[#dde1dc] bg-white px-3 py-1.5 text-sm text-[#4a554b]
-              hover:bg-[#f3f5f2]"
-            onClick={() => void runPreview()}
-          >
-            <Send className="size-4" />
-            Try again
-          </button>
-        </div>
-      ) : null}
-    </div>
-  )
-}