@bobfrankston/mailx-types 0.1.6 → 0.1.10

package/index.d.ts

@@ -249,6 +249,15 @@ export interface AutocompleteSettings {
     translateEnabled?: boolean;
     proofreadEnabled?: boolean;
 }
+/** AI provider API keys. Lives at the top of `accounts.jsonc` alongside
+ *  `accounts:` so all secrets are co-located in one cloud-synced file. The
+ *  keys field replaces `preferences.jsonc.autocomplete.cloudApiKey` (which
+ *  was tied to the *active* provider) so a user can set both Anthropic and
+ *  OpenAI keys once and switch providers without re-entering anything. */
+export interface AiKeys {
+    anthropic?: string;
+    openai?: string;
+}
 export interface AutocompleteRequest {
     subject: string;
     to: string;
@@ -260,16 +269,40 @@ export interface AutocompleteResponse {
 }
 export interface AiTransformRequest {
     /** translate = render in `targetLang`; proofread = corrected version
-     *  with grammar/spelling fixes; summarize = short paragraph summary. */
-    action: "translate" | "proofread" | "summarize";
+     *  with grammar/spelling fixes; summarize = short paragraph summary;
+     *  extractEvent = parse natural-language event description into a
+     *  structured calendar event (title/start/end/location/notes). */
+    action: "translate" | "proofread" | "summarize" | "extractEvent";
     text: string;
     /** ISO-639-1 (or BCP-47) language code for translate. Defaults to "en". */
     targetLang?: string;
+    /** Caller's "now" hint, ISO 8601 (e.g. 2026-05-05T18:30:00). Used by
+     *  extractEvent to resolve relative dates ("tomorrow at 3pm"). The
+     *  service can't trust its own clock — the user might be on a phone
+     *  in a different timezone — so the caller supplies it. */
+    nowISO?: string;
+}
+/** Structured calendar event fields parsed from a natural-language
+ *  description by aiTransform({ action: "extractEvent" }). All times are
+ *  ISO 8601 in the caller's local timezone (no `Z` suffix); the client
+ *  shapes them into Google Calendar's `dates=` URL parameter. */
+export interface ExtractedEvent {
+    title: string;
+    startISO?: string;
+    endISO?: string;
+    allDay?: boolean;
+    location?: string;
+    notes?: string;
 }
 export interface AiTransformResponse {
     /** Transformed text. Empty when AI is disabled / provider error / feature
-     *  not enabled — caller should treat empty as "no result". */
+     *  not enabled — caller should treat empty as "no result". For
+     *  extractEvent this holds the JSON-stringified ExtractedEvent so the
+     *  response shape stays single-field across all actions. */
     text: string;
+    /** Parsed ExtractedEvent, populated only for extractEvent. Lets the
+     *  client skip the JSON.parse step (the service already validated). */
+    event?: ExtractedEvent;
     /** Optional reason for empty result, surfaced to UI status bar. */
     reason?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/mailx-types",
-  "version": "0.1.6",
+  "version": "0.1.10",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",