@bobfrankston/mailx-types 0.1.8 → 0.1.10

package/index.d.ts

@@ -269,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.8",
+  "version": "0.1.10",
   "type": "module",
   "main": "index.js",
   "types": "index.d.ts",