@absolutejs/rag 0.17.0 → 0.18.1

package/dist/client/research.js

@@ -0,0 +1,223 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, name) => {
+  Object.defineProperty(target, "name", {
+    value: name,
+    enumerable: false,
+    configurable: true
+  });
+  return target;
+};
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => (key in obj) ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+var __decoratorStart = (base) => [, , , __create(base?.[__knownSymbol("metadata")] ?? null)];
+var __decoratorStrings = ["class", "method", "getter", "setter", "accessor", "field", "value", "get", "set"];
+var __expectFn = (fn) => fn !== undefined && typeof fn !== "function" ? __typeError("Function expected") : fn;
+var __decoratorContext = (kind, name, done, metadata, fns) => ({
+  kind: __decoratorStrings[kind],
+  name,
+  metadata,
+  addInitializer: (fn) => done._ ? __typeError("Already initialized") : fns.push(__expectFn(fn || null))
+});
+var __decoratorMetadata = (array, target) => __defNormalProp(target, __knownSymbol("metadata"), array[3]);
+var __runInitializers = (array, flags, self, value) => {
+  for (var i = 0, fns = array[flags >> 1], n = fns && fns.length;i < n; i++)
+    flags & 1 ? fns[i].call(self) : value = fns[i].call(self, value);
+  return value;
+};
+var __decorateElement = (array, flags, name, decorators, target, extra) => {
+  var fn, it, done, ctx, access, k = flags & 7, s = !!(flags & 8), p = !!(flags & 16);
+  var j = k > 3 ? array.length + 1 : k ? s ? 1 : 2 : 0, key = __decoratorStrings[k + 5];
+  var initializers = k > 3 && (array[j - 1] = []), extraInitializers = array[j] || (array[j] = []);
+  var desc = k && (!p && !s && (target = target.prototype), k < 5 && (k > 3 || !p) && __getOwnPropDesc(k < 4 ? target : {
+    get [name]() {
+      return __privateGet(this, extra);
+    },
+    set [name](x) {
+      __privateSet(this, extra, x);
+    }
+  }, name));
+  k ? p && k < 4 && __name(extra, (k > 2 ? "set " : k > 1 ? "get " : "") + name) : __name(target, name);
+  for (var i = decorators.length - 1;i >= 0; i--) {
+    ctx = __decoratorContext(k, name, done = {}, array[3], extraInitializers);
+    if (k) {
+      ctx.static = s, ctx.private = p, access = ctx.access = { has: p ? (x) => __privateIn(target, x) : (x) => (name in x) };
+      if (k ^ 3)
+        access.get = p ? (x) => (k ^ 1 ? __privateGet : __privateMethod)(x, target, k ^ 4 ? extra : desc.get) : (x) => x[name];
+      if (k > 2)
+        access.set = p ? (x, y) => __privateSet(x, target, y, k ^ 4 ? extra : desc.set) : (x, y) => x[name] = y;
+    }
+    it = (0, decorators[i])(k ? k < 4 ? p ? extra : desc[key] : k > 4 ? undefined : { get: desc.get, set: desc.set } : target, ctx);
+    done._ = 1;
+    if (k ^ 4 || it === undefined)
+      __expectFn(it) && (k > 4 ? initializers.unshift(it) : k ? p ? extra = it : desc[key] = it : target = it);
+    else if (typeof it !== "object" || it === null)
+      __typeError("Object expected");
+    else
+      __expectFn(fn = it.get) && (desc.get = fn), __expectFn(fn = it.set) && (desc.set = fn), __expectFn(fn = it.init) && initializers.unshift(fn);
+  }
+  return k || __decoratorMetadata(array, target), desc && __defProp(target, name, desc), p ? k ^ 4 ? extra : desc : target;
+};
+
+// src/client/research.ts
+var createResearchClient = (options = {}) => {
+  let state = {
+    status: "idle",
+    result: null,
+    progress: null,
+    error: null
+  };
+  let active;
+  let generation = 0;
+  const listeners = new Set;
+  const publish = (next) => {
+    state = next;
+    listeners.forEach((listener) => listener());
+  };
+  const cancel = () => {
+    generation++;
+    active?.abort();
+    active = undefined;
+    if (state.status === "running")
+      publish({ ...state, status: "cancelled" });
+  };
+  const run = async (input) => {
+    active?.abort();
+    const id = ++generation;
+    const controller = new AbortController;
+    active = controller;
+    publish({ status: "running", result: null, progress: null, error: null });
+    let reader;
+    try {
+      const headers = new Headers(options.headers?.());
+      headers.set("content-type", "application/json");
+      const response = await (options.fetch ?? fetch)(`${options.path ?? "/research"}/stream`, {
+        method: "POST",
+        body: JSON.stringify(input),
+        headers,
+        credentials: "same-origin",
+        signal: controller.signal
+      });
+      if (!response.ok || !response.body)
+        throw new Error(`Research request failed (${response.status})`);
+      reader = response.body.getReader();
+      const decoder = new TextDecoder;
+      let pending = "";
+      let result;
+      const processLine = (line) => {
+        if (!line.trim())
+          return;
+        const event = JSON.parse(line);
+        if (event.type === "error")
+          throw new Error("Research request failed");
+        if (event.type === "result") {
+          if (!event.result || !["reviewed", "partial", "empty", "unavailable"].includes(event.result.status) || !Array.isArray(event.result.fields) || !Array.isArray(event.result.sources))
+            throw new Error("Invalid research result");
+          result = event.result;
+        }
+        if (event.type === "progress" && id === generation)
+          publish({ ...state, progress: event.progress });
+      };
+      while (true) {
+        controller.signal.throwIfAborted();
+        const chunk = await reader.read();
+        pending += decoder.decode(chunk.value, { stream: !chunk.done });
+        if (pending.length > 4000000)
+          throw new Error("Research response too large");
+        let newline;
+        while ((newline = pending.indexOf(`
+`)) >= 0) {
+          processLine(pending.slice(0, newline));
+          pending = pending.slice(newline + 1);
+        }
+        if (chunk.done)
+          break;
+      }
+      if (pending)
+        processLine(pending);
+      controller.signal.throwIfAborted();
+      if (!result)
+        throw new Error("Research stream ended without a result");
+      if (id === generation)
+        publish({ ...state, status: "complete", result });
+      return result;
+    } catch (error) {
+      if (id === generation)
+        publish({
+          ...state,
+          status: controller.signal.aborted ? "cancelled" : "error",
+          error: controller.signal.aborted ? null : error instanceof Error ? error.message : "Research request failed"
+        });
+      throw error;
+    } finally {
+      await reader?.cancel().catch(() => {
+        return;
+      });
+      reader?.releaseLock();
+      if (id === generation)
+        active = undefined;
+    }
+  };
+  return {
+    run,
+    cancel,
+    getSnapshot: () => state,
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    reset: () => {
+      cancel();
+      publish({ status: "idle", result: null, progress: null, error: null });
+    },
+    dispose: () => {
+      cancel();
+      listeners.clear();
+    }
+  };
+};
+var bindResearchForm = (form, output, options = {}) => {
+  const client = createResearchClient(options);
+  const unsubscribe = client.subscribe(() => {
+    const state = client.getSnapshot();
+    output.setAttribute("aria-busy", String(state.status === "running"));
+    output.textContent = state.result ? JSON.stringify(state.result, null, 2) : state.error ?? state.status;
+  });
+  const submit = (event) => {
+    event.preventDefault();
+    const data = new FormData(form);
+    client.run({
+      query: String(data.get("query") ?? ""),
+      ...data.get("task") ? { task: String(data.get("task")) } : {}
+    }).catch(() => {
+      return;
+    });
+  };
+  form.addEventListener("submit", submit);
+  return {
+    ...client,
+    dispose: () => {
+      form.removeEventListener("submit", submit);
+      unsubscribe();
+      client.dispose();
+    }
+  };
+};
+export {
+  bindResearchForm,
+  createResearchClient
+};
+
+//# debugId=50A87DE12CA1839A64756E2164756E21
+//# sourceMappingURL=research.js.map

package/dist/client/research.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/client/research.ts"],
+  "sourcesContent": [
+    "import type {\n  ResearchInput,\n  ResearchResult,\n  ResearchProgress,\n} from \"../research/types\";\nexport type ResearchRequest = Pick<\n  ResearchInput,\n  \"query\" | \"task\" | \"freshness\"\n>;\nexport type ResearchState = {\n  status: \"idle\" | \"running\" | \"complete\" | \"cancelled\" | \"error\";\n  result: ResearchResult | null;\n  progress: ResearchProgress | null;\n  error: string | null;\n};\nexport type ResearchClientOptions = {\n  path?: string;\n  fetch?: typeof fetch;\n  headers?: () => HeadersInit;\n};\nexport const createResearchClient = (options: ResearchClientOptions = {}) => {\n  let state: ResearchState = {\n    status: \"idle\",\n    result: null,\n    progress: null,\n    error: null,\n  };\n  let active: AbortController | undefined;\n  let generation = 0;\n  const listeners = new Set<() => void>();\n  const publish = (next: ResearchState) => {\n    state = next;\n    listeners.forEach((listener) => listener());\n  };\n  const cancel = () => {\n    generation++;\n    active?.abort();\n    active = undefined;\n    if (state.status === \"running\") publish({ ...state, status: \"cancelled\" });\n  };\n  const run = async (input: ResearchRequest): Promise<ResearchResult> => {\n    active?.abort();\n    const id = ++generation;\n    const controller = new AbortController();\n    active = controller;\n    publish({ status: \"running\", result: null, progress: null, error: null });\n    let reader: ReadableStreamDefaultReader<Uint8Array> | undefined;\n    try {\n      const headers = new Headers(options.headers?.());\n      headers.set(\"content-type\", \"application/json\");\n      const response = await (options.fetch ?? fetch)(\n        `${options.path ?? \"/research\"}/stream`,\n        {\n          method: \"POST\",\n          body: JSON.stringify(input),\n          headers,\n          credentials: \"same-origin\",\n          signal: controller.signal,\n        },\n      );\n      if (!response.ok || !response.body)\n        throw new Error(`Research request failed (${response.status})`);\n      reader = response.body.getReader();\n      const decoder = new TextDecoder();\n      let pending = \"\";\n      let result: ResearchResult | undefined;\n      const processLine = (line: string) => {\n        if (!line.trim()) return;\n        const event = JSON.parse(line);\n        if (event.type === \"error\") throw new Error(\"Research request failed\");\n        if (event.type === \"result\") {\n          if (\n            !event.result ||\n            ![\"reviewed\", \"partial\", \"empty\", \"unavailable\"].includes(\n              event.result.status,\n            ) ||\n            !Array.isArray(event.result.fields) ||\n            !Array.isArray(event.result.sources)\n          )\n            throw new Error(\"Invalid research result\");\n          result = event.result;\n        }\n        if (event.type === \"progress\" && id === generation)\n          publish({ ...state, progress: event.progress });\n      };\n      while (true) {\n        controller.signal.throwIfAborted();\n        const chunk = await reader.read();\n        pending += decoder.decode(chunk.value, { stream: !chunk.done });\n        if (pending.length > 4_000_000)\n          throw new Error(\"Research response too large\");\n        let newline: number;\n        while ((newline = pending.indexOf(\"\\n\")) >= 0) {\n          processLine(pending.slice(0, newline));\n          pending = pending.slice(newline + 1);\n        }\n        if (chunk.done) break;\n      }\n      if (pending) processLine(pending);\n      controller.signal.throwIfAborted();\n      if (!result) throw new Error(\"Research stream ended without a result\");\n      if (id === generation) publish({ ...state, status: \"complete\", result });\n      return result;\n    } catch (error) {\n      if (id === generation)\n        publish({\n          ...state,\n          status: controller.signal.aborted ? \"cancelled\" : \"error\",\n          error: controller.signal.aborted\n            ? null\n            : error instanceof Error\n              ? error.message\n              : \"Research request failed\",\n        });\n      throw error;\n    } finally {\n      await reader?.cancel().catch(() => undefined);\n      reader?.releaseLock();\n      if (id === generation) active = undefined;\n    }\n  };\n  return {\n    run,\n    cancel,\n    getSnapshot: () => state,\n    subscribe: (listener: () => void) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    reset: () => {\n      cancel();\n      publish({ status: \"idle\", result: null, progress: null, error: null });\n    },\n    dispose: () => {\n      cancel();\n      listeners.clear();\n    },\n  };\n};\n\n/** HTML binding uses textContent, never model-produced HTML. Returns cleanup. */\nexport const bindResearchForm = (\n  form: HTMLFormElement,\n  output: HTMLElement,\n  options: ResearchClientOptions = {},\n) => {\n  const client = createResearchClient(options);\n  const unsubscribe = client.subscribe(() => {\n    const state = client.getSnapshot();\n    output.setAttribute(\"aria-busy\", String(state.status === \"running\"));\n    output.textContent = state.result\n      ? JSON.stringify(state.result, null, 2)\n      : (state.error ?? state.status);\n  });\n  const submit = (event: SubmitEvent) => {\n    event.preventDefault();\n    const data = new FormData(form);\n    void client\n      .run({\n        query: String(data.get(\"query\") ?? \"\"),\n        ...(data.get(\"task\") ? { task: String(data.get(\"task\")) } : {}),\n      })\n      .catch(() => undefined);\n  };\n  form.addEventListener(\"submit\", submit);\n  return {\n    ...client,\n    dispose: () => {\n      form.removeEventListener(\"submit\", submit);\n      unsubscribe();\n      client.dispose();\n    },\n  };\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "50A87DE12CA1839A64756E2164756E21",
+  "names": []
+}