@moraya/core 0.2.0 → 0.4.0

package/dist/types-CwM77g7u.d.ts

@@ -0,0 +1,88 @@
+import { AIProvider, AIProviderConfig, AIRequest, AIResponse, ToolCallRequest, AIUsage } from './ai/types.js';
+
+/**
+ * Transport adapter — the platform seam. Core builds requests and parses
+ * responses; the consumer executes them:
+ *   - desktop: Tauri `ai_proxy_*` commands (key injected by Rust from Keychain)
+ *   - web/mobile: direct `fetch()` + SSE (key applied per AuthDescriptor)
+ *
+ * Mirrors the existing `MediaResolver`/`LinkOpener` DI pattern in core.
+ */
+
+/** Declarative auth: tells a web transport HOW to attach the secret. The Tauri
+ *  transport ignores it (Rust already encodes the same rules per `provider`). */
+interface AuthDescriptor {
+    scheme: 'bearer' | 'header' | 'query' | 'none';
+    /** for scheme:'header' (e.g. 'x-api-key') */
+    headerName?: string;
+    /** for scheme:'query' (e.g. 'key') */
+    queryParam?: string;
+}
+/** A fully-built provider request EXCEPT the secret. Produced by a driver. */
+interface TransportRequest {
+    /** Proxy-provider key passed to the Tauri proxy ('claude'|'openai'|'gemini'|'deepseek'|'ollama'). */
+    provider: AIProvider | 'openai' | 'claude' | 'gemini' | 'deepseek' | 'ollama';
+    /** configId for Keychain lookup on desktop. */
+    configId: string;
+    /** Keychain key prefix (default 'ai-key:'). */
+    keyPrefix?: string;
+    method: 'POST' | 'GET';
+    url: string;
+    /** Headers WITHOUT the auth secret. */
+    headers: Record<string, string>;
+    /** JSON-stringified request body. */
+    body: string;
+    auth: AuthDescriptor;
+    /** Web transport fills this from its key store; Tauri transport ignores it
+     *  (Rust holds the key). Drivers never set it. */
+    apiKey?: string;
+}
+interface TransportResponse {
+    status: number;
+    /** Raw response text (a driver's parseResponse parses it). */
+    body: string;
+}
+interface StreamCallbacks {
+    signal?: AbortSignal;
+    /** A plain text delta (desktop: Rust pre-extracted text chunk). */
+    onText: (delta: string) => void;
+    /** A raw provider SSE envelope JSON string (web: every `data:` payload;
+     *  desktop: the `\x02`-tagged non-text events). Driver folds parse it. */
+    onEnvelope: (rawJson: string) => void;
+}
+interface AITransport {
+    fetch(req: TransportRequest, signal?: AbortSignal): Promise<TransportResponse>;
+    stream(req: TransportRequest, cb: StreamCallbacks): Promise<void>;
+    /** Optional per-provider streaming capability. Defaults to true when absent.
+     *  Desktop returns false for gemini/ollama (the Rust proxy has no SSE path
+     *  for them) so the orchestrator one-shots them; web returns true for gemini. */
+    canStream?(provider: AIProvider): boolean;
+}
+
+/** Per-provider driver contract. Drivers are PURE: build a request (no secret)
+ *  and parse responses/streams. */
+
+/** Stateful streaming accumulator. The SAME parser runs on desktop chunks and
+ *  web SSE envelopes. */
+interface StreamFold {
+    /** Feed a raw provider SSE envelope JSON; return any text delta to surface. */
+    pushEnvelope(rawJson: string): string | undefined;
+    /** Finalize after the stream ends. */
+    finish(): {
+        toolCalls?: ToolCallRequest[];
+        stopReason: string;
+        usage?: AIUsage;
+    };
+}
+interface AIDriver {
+    /** Build the wire request WITHOUT the secret. */
+    buildChatRequest(config: AIProviderConfig, request: AIRequest, stream: boolean): TransportRequest;
+    /** Parse a non-streaming JSON response (already JSON.parsed). */
+    parseResponse(json: Record<string, unknown>, config: AIProviderConfig): AIResponse;
+    /** Create a streaming folder. */
+    createStreamFold(): StreamFold;
+    /** Whether this provider can stream at all (gated further by transport.canStream). */
+    readonly supportsStreaming: boolean;
+}
+
+export type { AIDriver as A, StreamFold as S, TransportRequest as T, AITransport as a, AuthDescriptor as b, StreamCallbacks as c, TransportResponse as d };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moraya/core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Shared markdown editor core for Moraya desktop and Moraya Web. ProseMirror schema, markdown-it parser, prosemirror-markdown serializer, plugins, and editor lifecycle factories. Pure ESM, host-agnostic, dependency-injected.",
   "type": "module",
   "main": "./dist/index.js",
@@ -43,7 +43,31 @@
       "import": "./dist/i18n/index.js",
       "types": "./dist/i18n/index.d.ts"
     },
-    "./i18n/locales/*.json": "./dist/i18n/locales/*.json"
+    "./i18n/locales/*.json": "./dist/i18n/locales/*.json",
+    "./ai": {
+      "import": "./dist/ai/index.js",
+      "types": "./dist/ai/index.d.ts"
+    },
+    "./ai/types": {
+      "import": "./dist/ai/types.js",
+      "types": "./dist/ai/types.d.ts"
+    },
+    "./ai/image": {
+      "import": "./dist/ai/image.js",
+      "types": "./dist/ai/image.d.ts"
+    },
+    "./ai/voice": {
+      "import": "./dist/ai/voice.js",
+      "types": "./dist/ai/voice.d.ts"
+    },
+    "./ai/drivers/*": {
+      "import": "./dist/ai/drivers/*.js",
+      "types": "./dist/ai/drivers/*.d.ts"
+    },
+    "./chat-markdown": {
+      "import": "./dist/chat-markdown/index.js",
+      "types": "./dist/chat-markdown/index.d.ts"
+    }
   },
   "files": [
     "dist",