@kedataindo/docflow-core 0.0.32 → 0.0.33

package/dist/ai/index.cjs

@@ -0,0 +1,310 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/ai/index.ts
+var ai_exports = {};
+__export(ai_exports, {
+  CONTEXT_CHAR_CAP: () => CONTEXT_CHAR_CAP,
+  LOCAL_STORAGE_KEY: () => LOCAL_STORAGE_KEY,
+  buildAIPrompt: () => buildAIPrompt,
+  httpKeyStorage: () => httpKeyStorage,
+  localStorageKeyStorage: () => localStorageKeyStorage,
+  memoryKeyStorage: () => memoryKeyStorage,
+  openaiCompatibleProvider: () => openaiCompatibleProvider,
+  toAIStreamFn: () => toAIStreamFn,
+  trimContextAfter: () => trimContextAfter,
+  trimContextBefore: () => trimContextBefore
+});
+module.exports = __toCommonJS(ai_exports);
+
+// src/ai/prompts.ts
+var CONTEXT_CHAR_CAP = 1500;
+var ONLY_RESULT = "Return ONLY the resulting text \u2014 no preamble, no explanation, no commentary, no markdown fences.";
+var SYSTEM_PROMPTS = {
+  rewrite: `You are a writing assistant. Rewrite the selected text to improve clarity, flow, and style while preserving its meaning. ${ONLY_RESULT}`,
+  summarize: `You are a writing assistant. Summarize the selected text concisely, keeping every key point. ${ONLY_RESULT}`,
+  grammar: `You are a writing assistant. Fix grammar, spelling, and punctuation in the selected text without changing its meaning or voice. ${ONLY_RESULT}`,
+  tone: `You are a writing assistant. Adjust the tone of the selected text as instructed while preserving its content. ${ONLY_RESULT}`,
+  translate: `You are a writing assistant. Translate the selected text as instructed, preserving structure and formatting. ${ONLY_RESULT}`,
+  expand: `You are a writing assistant. Expand the selected text with relevant detail, staying on topic and matching the existing style. ${ONLY_RESULT}`,
+  shorten: `You are a writing assistant. Shorten the selected text, keeping its essential meaning. ${ONLY_RESULT}`,
+  generate: `You are a writing assistant embedded in a document editor. Write the text the user asks for so it fits the surrounding context. ${ONLY_RESULT}`,
+  chat: "You are a helpful writing assistant embedded in a document editor. Answer the user\u2019s question. Use the provided document context when it is relevant; say so when it is not enough to answer."
+};
+function trimContextBefore(text) {
+  return text.length > CONTEXT_CHAR_CAP ? `\u2026${text.slice(-CONTEXT_CHAR_CAP)}` : text;
+}
+function trimContextAfter(text) {
+  return text.length > CONTEXT_CHAR_CAP ? `${text.slice(0, CONTEXT_CHAR_CAP)}\u2026` : text;
+}
+function quote(label, text) {
+  return `${label}:
+"""${text}"""`;
+}
+function contextSection(req) {
+  const parts = [];
+  if (req.context) {
+    const before = trimContextBefore(req.context.before ?? "");
+    const after = trimContextAfter(req.context.after ?? "");
+    if (before) parts.push(quote("Text before", before));
+    if (after) parts.push(quote("Text after", after));
+  }
+  return parts;
+}
+function buildAIPrompt(req) {
+  let system;
+  const userParts = [];
+  switch (req.action) {
+    case "rewrite":
+    case "summarize":
+    case "grammar":
+    case "expand":
+    case "shorten":
+      system = SYSTEM_PROMPTS[req.action];
+      userParts.push(quote("Selected text", req.selection ?? ""));
+      break;
+    case "tone":
+      system = SYSTEM_PROMPTS.tone;
+      userParts.push(quote("Selected text", req.selection ?? ""));
+      userParts.push(`Target tone: ${req.prompt ?? "professional"}`);
+      break;
+    case "translate":
+      system = SYSTEM_PROMPTS.translate;
+      userParts.push(quote("Selected text", req.selection ?? ""));
+      userParts.push(`Target language: ${req.prompt ?? "English"}`);
+      break;
+    case "generate":
+      system = SYSTEM_PROMPTS.generate;
+      userParts.push(`Instruction: ${req.prompt ?? ""}`);
+      break;
+    case "chat":
+      system = SYSTEM_PROMPTS.chat;
+      if (req.selection) userParts.push(quote("Selected text", req.selection));
+      userParts.push(req.prompt ?? "");
+      break;
+    case "draft":
+      throw new Error(
+        "action 'draft' is not built via buildAIPrompt \u2014 use the aiDraft port (Phase 7E)"
+      );
+    default: {
+      const exhaustive = req.action;
+      throw new Error(`Unknown AI action: ${String(exhaustive)}`);
+    }
+  }
+  userParts.push(...contextSection(req));
+  return { system, prompt: userParts.filter(Boolean).join("\n\n") };
+}
+
+// src/ai/adapter.ts
+function toAIStreamFn(provider) {
+  return async function* aiStream(req, signal) {
+    const { system, prompt } = buildAIPrompt(req);
+    for await (const event of provider.complete({ system, prompt, signal })) {
+      if (event.type === "delta") {
+        yield event.text;
+      } else if (event.type === "done") {
+        return;
+      } else {
+        throw event.error;
+      }
+    }
+  };
+}
+
+// src/ai/keyStorage.ts
+function memoryKeyStorage(initial = null) {
+  let value = initial;
+  return {
+    async get() {
+      return value;
+    },
+    async set(next) {
+      value = next;
+    },
+    async clear() {
+      value = null;
+    }
+  };
+}
+var LOCAL_STORAGE_KEY = "docflow:ai-config";
+function localStorageKeyStorage(key = LOCAL_STORAGE_KEY, storage) {
+  const store = () => {
+    const s = storage ?? globalThis.localStorage;
+    if (!s) throw new Error("localStorageKeyStorage: no Storage available (SSR?)");
+    return s;
+  };
+  return {
+    async get() {
+      const raw = store().getItem(key);
+      if (!raw) return null;
+      try {
+        return JSON.parse(raw);
+      } catch {
+        return null;
+      }
+    },
+    async set(value) {
+      store().setItem(key, JSON.stringify(value));
+    },
+    async clear() {
+      store().removeItem(key);
+    }
+  };
+}
+function httpKeyStorage(urls) {
+  const doFetch = urls.fetchImpl ?? ((...args) => fetch(...args));
+  return {
+    async get() {
+      const res = await doFetch(urls.getUrl, { credentials: "include" });
+      if (res.status === 404) return null;
+      if (!res.ok) throw new Error(`AI config read failed: ${res.status}`);
+      return await res.json();
+    },
+    async set(value) {
+      const res = await doFetch(urls.setUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        body: JSON.stringify(value)
+      });
+      if (!res.ok) throw new Error(`AI config write failed: ${res.status}`);
+    },
+    async clear() {
+      const res = await doFetch(urls.deleteUrl, { method: "DELETE", credentials: "include" });
+      if (!res.ok && res.status !== 404) throw new Error(`AI config delete failed: ${res.status}`);
+    }
+  };
+}
+
+// src/ai/openaiCompatibleProvider.ts
+function authHeaders(auth) {
+  switch (auth.type) {
+    case "bearer":
+      return { Authorization: `Bearer ${auth.apiKey}` };
+    case "header":
+      return { [auth.name]: auth.value };
+    case "none":
+      return {};
+  }
+}
+function toError(err) {
+  return err instanceof Error ? err : new Error(String(err));
+}
+function openaiCompatibleProvider(config) {
+  const baseUrl = config.baseUrl.replace(/\/+$/, "");
+  return {
+    async *complete(req) {
+      const controller = new AbortController();
+      const onAbort = () => controller.abort();
+      const callerSignal = req.signal;
+      if (callerSignal) {
+        if (callerSignal.aborted) controller.abort();
+        else callerSignal.addEventListener("abort", onAbort, { once: true });
+      }
+      try {
+        const system = [config.systemPrompt, req.system].filter(Boolean).join("\n\n");
+        const messages = [];
+        if (system) messages.push({ role: "system", content: system });
+        messages.push({ role: "user", content: req.prompt });
+        let res;
+        try {
+          res = await fetch(`${baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...authHeaders(config.auth) },
+            body: JSON.stringify({ model: config.model, messages, stream: true }),
+            signal: controller.signal
+          });
+        } catch (err) {
+          if (controller.signal.aborted) return;
+          yield { type: "error", error: toError(err) };
+          return;
+        }
+        if (!res.ok) {
+          const detail = await res.text().catch(() => "");
+          yield {
+            type: "error",
+            error: new Error(
+              `AI provider responded ${res.status}${detail ? `: ${detail.slice(0, 200)}` : ""}`
+            )
+          };
+          return;
+        }
+        if (!res.body) {
+          yield { type: "error", error: new Error("AI provider response has no body") };
+          return;
+        }
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        let sawDone = false;
+        try {
+          for (; ; ) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            buffer += decoder.decode(value, { stream: true });
+            let sep;
+            while ((sep = buffer.indexOf("\n\n")) >= 0) {
+              const block = buffer.slice(0, sep);
+              buffer = buffer.slice(sep + 2);
+              for (const line of block.split("\n")) {
+                if (!line.startsWith("data:")) continue;
+                const data = line.slice("data:".length).trim();
+                if (data === "[DONE]") {
+                  sawDone = true;
+                  yield { type: "done" };
+                  return;
+                }
+                try {
+                  const json = JSON.parse(data);
+                  const text = json.choices?.[0]?.delta?.content;
+                  if (text) yield { type: "delta", text };
+                } catch {
+                }
+              }
+            }
+          }
+        } catch (err) {
+          if (!controller.signal.aborted) {
+            yield { type: "error", error: toError(err) };
+            return;
+          }
+        } finally {
+          reader.releaseLock();
+        }
+        if (!sawDone && !controller.signal.aborted) yield { type: "done" };
+      } finally {
+        callerSignal?.removeEventListener("abort", onAbort);
+        controller.abort();
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CONTEXT_CHAR_CAP,
+  LOCAL_STORAGE_KEY,
+  buildAIPrompt,
+  httpKeyStorage,
+  localStorageKeyStorage,
+  memoryKeyStorage,
+  openaiCompatibleProvider,
+  toAIStreamFn,
+  trimContextAfter,
+  trimContextBefore
+});

package/dist/ai/index.d.cts

@@ -0,0 +1 @@
+export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, a as AIDraftFn, h as AIProvider, A as AIStreamFn, j as Auth, k as CONTEXT_CHAR_CAP, l as CslDate, m as CslItemData, n as CslName, H as HttpKeyStorageUrls, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, p as buildAIPrompt, q as httpKeyStorage, r as localStorageKeyStorage, s as memoryKeyStorage, t as openaiCompatibleProvider, u as toAIStreamFn, v as trimContextAfter, w as trimContextBefore } from '../index-BsIFJXPk.cjs';

package/dist/ai/index.d.ts

@@ -0,0 +1 @@
+export { b as AIAction, c as AIActionRequest, d as AICompleteRequest, e as AIConfig, f as AIDraftCitation, g as AIDraftEvent, a as AIDraftFn, h as AIProvider, A as AIStreamFn, j as Auth, k as CONTEXT_CHAR_CAP, l as CslDate, m as CslItemData, n as CslName, H as HttpKeyStorageUrls, K as KeyStorage, L as LOCAL_STORAGE_KEY, O as OpenAICompatibleConfig, S as StreamEvent, p as buildAIPrompt, q as httpKeyStorage, r as localStorageKeyStorage, s as memoryKeyStorage, t as openaiCompatibleProvider, u as toAIStreamFn, v as trimContextAfter, w as trimContextBefore } from '../index-BsIFJXPk.js';

package/dist/ai/index.js

@@ -0,0 +1,24 @@
+import {
+  CONTEXT_CHAR_CAP,
+  LOCAL_STORAGE_KEY,
+  buildAIPrompt,
+  httpKeyStorage,
+  localStorageKeyStorage,
+  memoryKeyStorage,
+  openaiCompatibleProvider,
+  toAIStreamFn,
+  trimContextAfter,
+  trimContextBefore
+} from "../chunk-HMOWKFPE.js";
+export {
+  CONTEXT_CHAR_CAP,
+  LOCAL_STORAGE_KEY,
+  buildAIPrompt,
+  httpKeyStorage,
+  localStorageKeyStorage,
+  memoryKeyStorage,
+  openaiCompatibleProvider,
+  toAIStreamFn,
+  trimContextAfter,
+  trimContextBefore
+};

package/dist/chunk-HMOWKFPE.js

@@ -0,0 +1,275 @@
+// src/ai/prompts.ts
+var CONTEXT_CHAR_CAP = 1500;
+var ONLY_RESULT = "Return ONLY the resulting text \u2014 no preamble, no explanation, no commentary, no markdown fences.";
+var SYSTEM_PROMPTS = {
+  rewrite: `You are a writing assistant. Rewrite the selected text to improve clarity, flow, and style while preserving its meaning. ${ONLY_RESULT}`,
+  summarize: `You are a writing assistant. Summarize the selected text concisely, keeping every key point. ${ONLY_RESULT}`,
+  grammar: `You are a writing assistant. Fix grammar, spelling, and punctuation in the selected text without changing its meaning or voice. ${ONLY_RESULT}`,
+  tone: `You are a writing assistant. Adjust the tone of the selected text as instructed while preserving its content. ${ONLY_RESULT}`,
+  translate: `You are a writing assistant. Translate the selected text as instructed, preserving structure and formatting. ${ONLY_RESULT}`,
+  expand: `You are a writing assistant. Expand the selected text with relevant detail, staying on topic and matching the existing style. ${ONLY_RESULT}`,
+  shorten: `You are a writing assistant. Shorten the selected text, keeping its essential meaning. ${ONLY_RESULT}`,
+  generate: `You are a writing assistant embedded in a document editor. Write the text the user asks for so it fits the surrounding context. ${ONLY_RESULT}`,
+  chat: "You are a helpful writing assistant embedded in a document editor. Answer the user\u2019s question. Use the provided document context when it is relevant; say so when it is not enough to answer."
+};
+function trimContextBefore(text) {
+  return text.length > CONTEXT_CHAR_CAP ? `\u2026${text.slice(-CONTEXT_CHAR_CAP)}` : text;
+}
+function trimContextAfter(text) {
+  return text.length > CONTEXT_CHAR_CAP ? `${text.slice(0, CONTEXT_CHAR_CAP)}\u2026` : text;
+}
+function quote(label, text) {
+  return `${label}:
+"""${text}"""`;
+}
+function contextSection(req) {
+  const parts = [];
+  if (req.context) {
+    const before = trimContextBefore(req.context.before ?? "");
+    const after = trimContextAfter(req.context.after ?? "");
+    if (before) parts.push(quote("Text before", before));
+    if (after) parts.push(quote("Text after", after));
+  }
+  return parts;
+}
+function buildAIPrompt(req) {
+  let system;
+  const userParts = [];
+  switch (req.action) {
+    case "rewrite":
+    case "summarize":
+    case "grammar":
+    case "expand":
+    case "shorten":
+      system = SYSTEM_PROMPTS[req.action];
+      userParts.push(quote("Selected text", req.selection ?? ""));
+      break;
+    case "tone":
+      system = SYSTEM_PROMPTS.tone;
+      userParts.push(quote("Selected text", req.selection ?? ""));
+      userParts.push(`Target tone: ${req.prompt ?? "professional"}`);
+      break;
+    case "translate":
+      system = SYSTEM_PROMPTS.translate;
+      userParts.push(quote("Selected text", req.selection ?? ""));
+      userParts.push(`Target language: ${req.prompt ?? "English"}`);
+      break;
+    case "generate":
+      system = SYSTEM_PROMPTS.generate;
+      userParts.push(`Instruction: ${req.prompt ?? ""}`);
+      break;
+    case "chat":
+      system = SYSTEM_PROMPTS.chat;
+      if (req.selection) userParts.push(quote("Selected text", req.selection));
+      userParts.push(req.prompt ?? "");
+      break;
+    case "draft":
+      throw new Error(
+        "action 'draft' is not built via buildAIPrompt \u2014 use the aiDraft port (Phase 7E)"
+      );
+    default: {
+      const exhaustive = req.action;
+      throw new Error(`Unknown AI action: ${String(exhaustive)}`);
+    }
+  }
+  userParts.push(...contextSection(req));
+  return { system, prompt: userParts.filter(Boolean).join("\n\n") };
+}
+
+// src/ai/adapter.ts
+function toAIStreamFn(provider) {
+  return async function* aiStream(req, signal) {
+    const { system, prompt } = buildAIPrompt(req);
+    for await (const event of provider.complete({ system, prompt, signal })) {
+      if (event.type === "delta") {
+        yield event.text;
+      } else if (event.type === "done") {
+        return;
+      } else {
+        throw event.error;
+      }
+    }
+  };
+}
+
+// src/ai/keyStorage.ts
+function memoryKeyStorage(initial = null) {
+  let value = initial;
+  return {
+    async get() {
+      return value;
+    },
+    async set(next) {
+      value = next;
+    },
+    async clear() {
+      value = null;
+    }
+  };
+}
+var LOCAL_STORAGE_KEY = "docflow:ai-config";
+function localStorageKeyStorage(key = LOCAL_STORAGE_KEY, storage) {
+  const store = () => {
+    const s = storage ?? globalThis.localStorage;
+    if (!s) throw new Error("localStorageKeyStorage: no Storage available (SSR?)");
+    return s;
+  };
+  return {
+    async get() {
+      const raw = store().getItem(key);
+      if (!raw) return null;
+      try {
+        return JSON.parse(raw);
+      } catch {
+        return null;
+      }
+    },
+    async set(value) {
+      store().setItem(key, JSON.stringify(value));
+    },
+    async clear() {
+      store().removeItem(key);
+    }
+  };
+}
+function httpKeyStorage(urls) {
+  const doFetch = urls.fetchImpl ?? ((...args) => fetch(...args));
+  return {
+    async get() {
+      const res = await doFetch(urls.getUrl, { credentials: "include" });
+      if (res.status === 404) return null;
+      if (!res.ok) throw new Error(`AI config read failed: ${res.status}`);
+      return await res.json();
+    },
+    async set(value) {
+      const res = await doFetch(urls.setUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        credentials: "include",
+        body: JSON.stringify(value)
+      });
+      if (!res.ok) throw new Error(`AI config write failed: ${res.status}`);
+    },
+    async clear() {
+      const res = await doFetch(urls.deleteUrl, { method: "DELETE", credentials: "include" });
+      if (!res.ok && res.status !== 404) throw new Error(`AI config delete failed: ${res.status}`);
+    }
+  };
+}
+
+// src/ai/openaiCompatibleProvider.ts
+function authHeaders(auth) {
+  switch (auth.type) {
+    case "bearer":
+      return { Authorization: `Bearer ${auth.apiKey}` };
+    case "header":
+      return { [auth.name]: auth.value };
+    case "none":
+      return {};
+  }
+}
+function toError(err) {
+  return err instanceof Error ? err : new Error(String(err));
+}
+function openaiCompatibleProvider(config) {
+  const baseUrl = config.baseUrl.replace(/\/+$/, "");
+  return {
+    async *complete(req) {
+      const controller = new AbortController();
+      const onAbort = () => controller.abort();
+      const callerSignal = req.signal;
+      if (callerSignal) {
+        if (callerSignal.aborted) controller.abort();
+        else callerSignal.addEventListener("abort", onAbort, { once: true });
+      }
+      try {
+        const system = [config.systemPrompt, req.system].filter(Boolean).join("\n\n");
+        const messages = [];
+        if (system) messages.push({ role: "system", content: system });
+        messages.push({ role: "user", content: req.prompt });
+        let res;
+        try {
+          res = await fetch(`${baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...authHeaders(config.auth) },
+            body: JSON.stringify({ model: config.model, messages, stream: true }),
+            signal: controller.signal
+          });
+        } catch (err) {
+          if (controller.signal.aborted) return;
+          yield { type: "error", error: toError(err) };
+          return;
+        }
+        if (!res.ok) {
+          const detail = await res.text().catch(() => "");
+          yield {
+            type: "error",
+            error: new Error(
+              `AI provider responded ${res.status}${detail ? `: ${detail.slice(0, 200)}` : ""}`
+            )
+          };
+          return;
+        }
+        if (!res.body) {
+          yield { type: "error", error: new Error("AI provider response has no body") };
+          return;
+        }
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        let sawDone = false;
+        try {
+          for (; ; ) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            buffer += decoder.decode(value, { stream: true });
+            let sep;
+            while ((sep = buffer.indexOf("\n\n")) >= 0) {
+              const block = buffer.slice(0, sep);
+              buffer = buffer.slice(sep + 2);
+              for (const line of block.split("\n")) {
+                if (!line.startsWith("data:")) continue;
+                const data = line.slice("data:".length).trim();
+                if (data === "[DONE]") {
+                  sawDone = true;
+                  yield { type: "done" };
+                  return;
+                }
+                try {
+                  const json = JSON.parse(data);
+                  const text = json.choices?.[0]?.delta?.content;
+                  if (text) yield { type: "delta", text };
+                } catch {
+                }
+              }
+            }
+          }
+        } catch (err) {
+          if (!controller.signal.aborted) {
+            yield { type: "error", error: toError(err) };
+            return;
+          }
+        } finally {
+          reader.releaseLock();
+        }
+        if (!sawDone && !controller.signal.aborted) yield { type: "done" };
+      } finally {
+        callerSignal?.removeEventListener("abort", onAbort);
+        controller.abort();
+      }
+    }
+  };
+}
+
+export {
+  CONTEXT_CHAR_CAP,
+  trimContextBefore,
+  trimContextAfter,
+  buildAIPrompt,
+  toAIStreamFn,
+  memoryKeyStorage,
+  LOCAL_STORAGE_KEY,
+  localStorageKeyStorage,
+  httpKeyStorage,
+  openaiCompatibleProvider
+};