@templatical/ai-kit 0.0.0-stage → 0.51.0

package/dist/http-provider-Cx2ZcLRB.js

@@ -0,0 +1,278 @@
+import { a as AI_ROUTES, l as aiRoutePath, o as AI_SESSION_HEADER, r as AI_GENERATE_FIELDS, s as AI_WIRE_HEADER } from "./wire-B6AF_UGT.js";
+import { a as providerFailure, n as errorFromEvent, r as errorFromResponse, t as AI_TEMPLATE_CHANGED_MESSAGE } from "./errors-DWshWx18.js";
+import { CollaborationConflict, SdkError } from "@templatical/types";
+//#region src/client/sse.ts
+const TYPES = /* @__PURE__ */ new Set([
+	"text",
+	"operations",
+	"applied",
+	"done",
+	"error"
+]);
+function parse(data) {
+	try {
+		const event = JSON.parse(data);
+		return typeof event === "object" && event !== null && typeof event.type === "string" && TYPES.has(event.type) ? event : null;
+	} catch {
+		return null;
+	}
+}
+/**
+* The wire's events from an SSE body: `data:` lines, joined per event and
+* dispatched at a blank line or the end; comments (`: ping`), other fields,
+* unparseable data and unknown types are skipped. Cancelling the generator
+* cancels the body.
+*/
+async function* readSse(body) {
+	const reader = body.getReader();
+	const decoder = new TextDecoder();
+	let buffer = "";
+	let data = [];
+	function* dispatch() {
+		if (data.length === 0) return;
+		const event = parse(data.join("\n"));
+		data = [];
+		if (event) yield event;
+	}
+	function* lines(text) {
+		for (const raw of text.split("\n")) {
+			const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
+			if (line === "") yield* dispatch();
+			else if (line.startsWith("data:")) data.push(line.slice(line.startsWith("data: ") ? 6 : 5));
+		}
+	}
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			buffer += decoder.decode(value, { stream: true });
+			const end = buffer.lastIndexOf("\n");
+			if (end === -1) continue;
+			const complete = buffer.slice(0, end);
+			buffer = buffer.slice(end + 1);
+			yield* lines(complete);
+		}
+		buffer += decoder.decode();
+		if (buffer !== "") yield* lines(buffer);
+		yield* dispatch();
+	} finally {
+		reader.cancel().catch(() => {});
+	}
+}
+//#endregion
+//#region src/client/http-provider.ts
+function abortError(signal) {
+	const reason = signal.reason;
+	return reason instanceof Error && reason.name === "AbortError" ? reason : new DOMException("The AI request was stopped.", "AbortError");
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* An `AiProvider` over the wire (A1 §4): JSON or multipart requests, SSE
+* answers for turns and rewrite, JSON for history.
+* Errors are `SdkError`s; stopping a call rejects with an `AbortError`.
+*/
+function createHttpAiProvider(options) {
+	return createHttpAiProviderWithFetch(options, (input, init) => fetch(input, init));
+}
+/** @internal A per-instance transport for wire conformance; not a package export. */
+function createHttpAiProviderWithFetch(options, fetchRequest) {
+	const base = options.baseUrl.replace(/\/+$/, "");
+	const on = (feature) => options.features?.[feature] !== false;
+	async function request(route, params, init) {
+		init.signal?.throwIfAborted();
+		const own = typeof options.headers === "function" ? await options.headers() : options.headers ?? {};
+		const headers = new Headers(own);
+		headers.set(AI_WIRE_HEADER, "1");
+		headers.set("Accept", init.stream ? "text/event-stream" : "application/json");
+		if (init.session) headers.set(AI_SESSION_HEADER, init.session);
+		let body;
+		if (init.form) body = init.form;
+		else if (init.json !== void 0) {
+			headers.set("Content-Type", "application/json");
+			body = JSON.stringify(init.json);
+		}
+		let response;
+		try {
+			init.signal?.throwIfAborted();
+			response = await fetchRequest(`${base}${aiRoutePath(route, params)}`, {
+				method: AI_ROUTES[route].method,
+				headers,
+				body,
+				...options.credentials ? { credentials: options.credentials } : {},
+				signal: init.signal
+			});
+		} catch (error) {
+			if (init.signal?.aborted) throw abortError(init.signal);
+			throw error instanceof SdkError ? error : providerFailure();
+		}
+		if (!response.ok) throw await errorFromResponse(response);
+		return response;
+	}
+	/**
+	* One streamed call. `each` handles every event before `done`; it may
+	* throw to end the call (a refusal, the editor's own error), which aborts
+	* the request.
+	*/
+	async function streamed(route, template, init, signal, each, done) {
+		const controller = new AbortController();
+		const stop = () => controller.abort(signal.reason);
+		if (signal.aborted) stop();
+		signal.addEventListener("abort", stop, { once: true });
+		try {
+			const response = await request(route, { template }, {
+				...init,
+				stream: true,
+				signal: controller.signal
+			});
+			if (!response.body) throw providerFailure();
+			for await (const event of readSse(response.body)) {
+				if (signal.aborted) {
+					if (event.type === "applied") await each(event);
+					if (event.type === "done" || event.type === "error") throw abortError(signal);
+					continue;
+				}
+				if (event.type === "error") throw errorFromEvent(event);
+				if (event.type === "done") {
+					const value = done(event);
+					if (value === void 0) throw providerFailure();
+					return value;
+				}
+				await each(event);
+			}
+			throw providerFailure();
+		} catch (error) {
+			if (signal.aborted) throw abortError(signal);
+			controller.abort();
+			if (error instanceof SdkError) throw error;
+			if (error instanceof Error && error.name === "AbortError") throw error;
+			if (error instanceof Error && !(error instanceof TypeError)) throw error;
+			throw providerFailure();
+		} finally {
+			signal.removeEventListener("abort", stop);
+		}
+	}
+	function turn(route, req, init, handlers, signal) {
+		let text = "";
+		return streamed(route, req.templateId, {
+			...init,
+			session: req.sessionId
+		}, signal, async (event) => {
+			if (event.type === "text") {
+				text += event.text;
+				handlers.onText(event.text);
+			} else if (event.type === "operations") {
+				const result = await handlers.onOperations(event.ops);
+				if (!result.applied) throw new CollaborationConflict(AI_TEMPLATE_CHANGED_MESSAGE, {
+					code: result.code,
+					opIndex: result.opIndex
+				});
+			} else if (event.type === "applied") handlers.onApplied({
+				batchId: event.batchId,
+				revision: event.revision,
+				operationCount: event.operationCount
+			});
+		}, (done) => typeof done.messageId === "string" || done.messageId === null ? {
+			messageId: done.messageId,
+			text
+		} : void 0);
+	}
+	async function json(response) {
+		try {
+			return await response.json();
+		} catch {
+			throw providerFailure();
+		}
+	}
+	async function replay(route, templateId, messageId, sessionId) {
+		const body = await json(await request(route, {
+			template: templateId,
+			message: messageId
+		}, { session: sessionId }));
+		if (!isRecord(body)) throw providerFailure();
+		const data = body.data ?? {};
+		if (Array.isArray(data.operations) && typeof data.replayId === "string" && data.replayId !== "") return {
+			operations: data.operations,
+			replayId: data.replayId
+		};
+		if (typeof data.batchId === "string" && typeof data.revision === "number") return { applied: {
+			batchId: data.batchId,
+			revision: data.revision
+		} };
+		throw providerFailure();
+	}
+	return {
+		chatAttachments: on("chat") && on("chatAttachments"),
+		chat: on("chat") ? (req, handlers, signal) => {
+			const body = {
+				message: req.message,
+				selectedBlockId: req.selectedBlockId,
+				mergeTags: req.mergeTags,
+				content: req.content,
+				revision: req.revision
+			};
+			if (req.attachments.length === 0) return turn("generate", req, { json: body }, handlers, signal);
+			const form = new FormData();
+			form.set(AI_GENERATE_FIELDS.message, req.message);
+			if (req.selectedBlockId !== null) form.set(AI_GENERATE_FIELDS.selectedBlockId, req.selectedBlockId);
+			form.set(AI_GENERATE_FIELDS.mergeTags, JSON.stringify(req.mergeTags));
+			form.set(AI_GENERATE_FIELDS.content, JSON.stringify(req.content));
+			if (req.revision !== null) form.set(AI_GENERATE_FIELDS.revision, String(req.revision));
+			for (const attachment of req.attachments) form.append(AI_GENERATE_FIELDS.attachment, attachment.file, attachment.name);
+			return turn("generate", req, { form }, handlers, signal);
+		} : false,
+		fixFinding: on("fixFinding") ? (req, handlers, signal) => turn("fixFinding", req, { json: {
+			finding: req.finding,
+			mergeTags: req.mergeTags,
+			content: req.content,
+			revision: req.revision
+		} }, handlers, signal) : false,
+		rewrite: on("rewrite") ? (req, handlers, signal) => streamed("rewriteText", req.templateId, { json: {
+			html: req.html,
+			preset: req.preset,
+			language: req.language,
+			instruction: req.instruction,
+			mergeTags: req.mergeTags
+		} }, signal, (event) => {
+			if (event.type === "text") handlers.onText(event.text);
+		}, (done) => typeof done.html === "string" ? { html: done.html } : void 0) : false,
+		altText: on("altText") ? (req, signal) => {
+			const { templateId, sessionId, ...body } = req;
+			return streamed("altText", templateId, {
+				json: body,
+				session: sessionId
+			}, signal, () => {}, (done) => typeof done.alt === "string" ? { alt: done.alt } : void 0);
+		} : false,
+		...on("conversation") ? { conversation: {
+			settleReplay: async (templateId, messageId, outcome) => {
+				await request("settleReplay", {
+					template: templateId,
+					message: messageId,
+					replayId: outcome.replayId
+				}, {
+					session: outcome.sessionId,
+					json: {
+						direction: outcome.direction,
+						applied: outcome.applied
+					}
+				});
+			},
+			list: async (templateId) => {
+				const body = await json(await request("conversationMessages", { template: templateId }, {}));
+				if (!isRecord(body)) throw providerFailure();
+				if (!Array.isArray(body.data)) throw providerFailure();
+				return body.data;
+			},
+			clear: async (templateId) => {
+				await request("clearConversation", { template: templateId }, {});
+			},
+			undo: (templateId, messageId, context) => replay("undoMessage", templateId, messageId, context.sessionId),
+			redo: (templateId, messageId, context) => replay("redoMessage", templateId, messageId, context.sessionId)
+		} } : {}
+	};
+}
+//#endregion
+export { createHttpAiProviderWithFetch as n, readSse as r, createHttpAiProvider as t };
+
+//# sourceMappingURL=http-provider-Cx2ZcLRB.js.map

package/dist/http-provider-Cx2ZcLRB.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-provider-Cx2ZcLRB.js","names":[],"sources":["../src/client/sse.ts","../src/client/http-provider.ts"],"sourcesContent":["import type { AiWireEvent } from \"../wire\";\n\nconst TYPES = new Set([\"text\", \"operations\", \"applied\", \"done\", \"error\"]);\n\nfunction parse(data: string): AiWireEvent | null {\n  try {\n    const event = JSON.parse(data) as { type?: unknown };\n    return typeof event === \"object\" &&\n      event !== null &&\n      typeof event.type === \"string\" &&\n      TYPES.has(event.type)\n      ? (event as AiWireEvent)\n      : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * The wire's events from an SSE body: `data:` lines, joined per event and\n * dispatched at a blank line or the end; comments (`: ping`), other fields,\n * unparseable data and unknown types are skipped. Cancelling the generator\n * cancels the body.\n */\nexport async function* readSse(\n  body: ReadableStream<Uint8Array>,\n): AsyncGenerator<AiWireEvent> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  let data: string[] = [];\n\n  function* dispatch(): Generator<AiWireEvent> {\n    if (data.length === 0) return;\n    const event = parse(data.join(\"\\n\"));\n    data = [];\n    if (event) yield event;\n  }\n\n  function* lines(text: string): Generator<AiWireEvent> {\n    for (const raw of text.split(\"\\n\")) {\n      const line = raw.endsWith(\"\\r\") ? raw.slice(0, -1) : raw;\n      if (line === \"\") {\n        yield* dispatch();\n      } else if (line.startsWith(\"data:\")) {\n        data.push(line.slice(line.startsWith(\"data: \") ? 6 : 5));\n      }\n    }\n  }\n\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      buffer += decoder.decode(value, { stream: true });\n      const end = buffer.lastIndexOf(\"\\n\");\n      if (end === -1) continue;\n      const complete = buffer.slice(0, end);\n      buffer = buffer.slice(end + 1);\n      yield* lines(complete);\n    }\n    buffer += decoder.decode();\n    if (buffer !== \"\") yield* lines(buffer);\n    yield* dispatch();\n  } finally {\n    reader.cancel().catch(() => {});\n  }\n}\n","import type {\n  AiFeatureName,\n  AiProvider,\n  AiReplay,\n  AiReplayOutcome,\n  AiRequestBase,\n  AiTurnHandlers,\n  AiTurnResult,\n} from \"@templatical/types\";\nimport { CollaborationConflict, SdkError } from \"@templatical/types\";\nimport {\n  AI_GENERATE_FIELDS,\n  AI_ROUTES,\n  AI_SESSION_HEADER,\n  AI_WIRE_HEADER,\n  AI_WIRE_VERSION,\n  aiRoutePath,\n  type AiDoneEvent,\n  type AiRouteName,\n  type AiWireEvent,\n} from \"../wire\";\nimport {\n  AI_TEMPLATE_CHANGED_MESSAGE,\n  errorFromEvent,\n  errorFromResponse,\n  providerFailure,\n} from \"./errors\";\nimport { readSse } from \"./sse\";\n\nexport type HttpAiFeatures = Partial<\n  Record<AiFeatureName | \"conversation\", boolean>\n>;\n\nexport interface HttpAiProviderOptions {\n  /** Where the wire's routes live: `{baseUrl}/templates/{t}/ai/…`. */\n  baseUrl: string;\n  /** Your auth headers, or a function (async for a token refresh) called per request. */\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>);\n  /** `fetch`'s `credentials`, for cookie auth. */\n  credentials?: RequestCredentials;\n  /** `false` turns a feature off, `conversation` included. Everything else is on. */\n  features?: HttpAiFeatures;\n}\n\nfunction abortError(signal: AbortSignal): Error {\n  const reason = signal.reason as unknown;\n  return reason instanceof Error && reason.name === \"AbortError\"\n    ? reason\n    : new DOMException(\"The AI request was stopped.\", \"AbortError\");\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * An `AiProvider` over the wire (A1 §4): JSON or multipart requests, SSE\n * answers for turns and rewrite, JSON for history.\n * Errors are `SdkError`s; stopping a call rejects with an `AbortError`.\n */\nexport function createHttpAiProvider(\n  options: HttpAiProviderOptions,\n): AiProvider {\n  return createHttpAiProviderWithFetch(options, (input, init) =>\n    fetch(input, init),\n  );\n}\n\n/** @internal A per-instance transport for wire conformance; not a package export. */\nexport function createHttpAiProviderWithFetch(\n  options: HttpAiProviderOptions,\n  fetchRequest: typeof fetch,\n): AiProvider {\n  const base = options.baseUrl.replace(/\\/+$/, \"\");\n  const on = (feature: AiFeatureName | \"conversation\") =>\n    options.features?.[feature] !== false;\n\n  async function request(\n    route: AiRouteName,\n    params: { template: string; message?: string; replayId?: string },\n    init: {\n      json?: unknown;\n      form?: FormData;\n      session?: string;\n      stream?: boolean;\n      signal?: AbortSignal;\n    },\n  ): Promise<Response> {\n    init.signal?.throwIfAborted();\n    const own =\n      typeof options.headers === \"function\"\n        ? await options.headers()\n        : (options.headers ?? {});\n    const headers = new Headers(own);\n    headers.set(AI_WIRE_HEADER, AI_WIRE_VERSION);\n    headers.set(\n      \"Accept\",\n      init.stream ? \"text/event-stream\" : \"application/json\",\n    );\n    if (init.session) headers.set(AI_SESSION_HEADER, init.session);\n    let body: BodyInit | undefined;\n    if (init.form) {\n      body = init.form;\n    } else if (init.json !== undefined) {\n      headers.set(\"Content-Type\", \"application/json\");\n      body = JSON.stringify(init.json);\n    }\n    let response: Response;\n    try {\n      init.signal?.throwIfAborted();\n      response = await fetchRequest(`${base}${aiRoutePath(route, params)}`, {\n        method: AI_ROUTES[route].method,\n        headers,\n        body,\n        ...(options.credentials ? { credentials: options.credentials } : {}),\n        signal: init.signal,\n      });\n    } catch (error) {\n      if (init.signal?.aborted) throw abortError(init.signal);\n      throw error instanceof SdkError ? error : providerFailure();\n    }\n    if (!response.ok) throw await errorFromResponse(response);\n    return response;\n  }\n\n  /**\n   * One streamed call. `each` handles every event before `done`; it may\n   * throw to end the call (a refusal, the editor's own error), which aborts\n   * the request.\n   */\n  async function streamed<T>(\n    route: AiRouteName,\n    template: string,\n    init: { json?: unknown; form?: FormData; session?: string },\n    signal: AbortSignal,\n    // Never called with `done` or `error`: those end the call first.\n    each: (event: AiWireEvent) => Promise<void> | void,\n    done: (event: AiDoneEvent) => T | undefined,\n  ): Promise<T> {\n    const controller = new AbortController();\n    const stop = () => controller.abort(signal.reason);\n    if (signal.aborted) stop();\n    signal.addEventListener(\"abort\", stop, { once: true });\n    try {\n      const response = await request(\n        route,\n        { template },\n        {\n          ...init,\n          stream: true,\n          signal: controller.signal,\n        },\n      );\n      if (!response.body) throw providerFailure();\n      for await (const event of readSse(response.body)) {\n        if (signal.aborted) {\n          // Already received server edits still need reconciliation after Stop.\n          if (event.type === \"applied\") await each(event);\n          if (event.type === \"done\" || event.type === \"error\")\n            throw abortError(signal);\n          continue;\n        }\n        if (event.type === \"error\") throw errorFromEvent(event);\n        if (event.type === \"done\") {\n          const value = done(event);\n          if (value === undefined) throw providerFailure();\n          return value;\n        }\n        await each(event);\n      }\n      throw providerFailure();\n    } catch (error) {\n      if (signal.aborted) throw abortError(signal);\n      controller.abort();\n      if (error instanceof SdkError) throw error;\n      if (error instanceof Error && error.name === \"AbortError\") throw error;\n      if (error instanceof Error && !(error instanceof TypeError)) throw error;\n      throw providerFailure();\n    } finally {\n      signal.removeEventListener(\"abort\", stop);\n    }\n  }\n\n  function turn(\n    route: \"generate\" | \"fixFinding\",\n    req: AiRequestBase,\n    init: { json?: unknown; form?: FormData },\n    handlers: AiTurnHandlers,\n    signal: AbortSignal,\n  ): Promise<AiTurnResult> {\n    let text = \"\";\n    return streamed(\n      route,\n      req.templateId,\n      { ...init, session: req.sessionId },\n      signal,\n      async (event) => {\n        if (event.type === \"text\") {\n          text += event.text;\n          handlers.onText(event.text);\n        } else if (event.type === \"operations\") {\n          const result = await handlers.onOperations(event.ops);\n          if (!result.applied) {\n            // SSE is one-way: the backend can't be told mid-turn, so the\n            // request ends here with the operation's own code (§4).\n            throw new CollaborationConflict(AI_TEMPLATE_CHANGED_MESSAGE, {\n              code: result.code,\n              opIndex: result.opIndex,\n            });\n          }\n        } else if (event.type === \"applied\") {\n          handlers.onApplied({\n            batchId: event.batchId,\n            revision: event.revision,\n            operationCount: event.operationCount,\n          });\n        }\n      },\n      (done) =>\n        typeof done.messageId === \"string\" || done.messageId === null\n          ? { messageId: done.messageId, text }\n          : undefined,\n    );\n  }\n\n  async function json<T>(response: Response): Promise<T> {\n    try {\n      return (await response.json()) as T;\n    } catch {\n      throw providerFailure();\n    }\n  }\n\n  async function replay(\n    route: \"undoMessage\" | \"redoMessage\",\n    templateId: string,\n    messageId: string,\n    sessionId: string,\n  ): Promise<AiReplay> {\n    const response = await request(\n      route,\n      { template: templateId, message: messageId },\n      { session: sessionId },\n    );\n    const body = await json<{\n      data?: {\n        operations?: unknown;\n        replayId?: unknown;\n        batchId?: unknown;\n        revision?: unknown;\n      };\n    }>(response);\n    if (!isRecord(body)) throw providerFailure();\n    const data = body.data ?? {};\n    if (\n      Array.isArray(data.operations) &&\n      typeof data.replayId === \"string\" &&\n      data.replayId !== \"\"\n    )\n      return { operations: data.operations, replayId: data.replayId };\n    if (typeof data.batchId === \"string\" && typeof data.revision === \"number\") {\n      return { applied: { batchId: data.batchId, revision: data.revision } };\n    }\n    throw providerFailure();\n  }\n\n  return {\n    chatAttachments: on(\"chat\") && on(\"chatAttachments\"),\n    chat: on(\"chat\")\n      ? (req, handlers, signal) => {\n          const body = {\n            message: req.message,\n            selectedBlockId: req.selectedBlockId,\n            mergeTags: req.mergeTags,\n            content: req.content,\n            revision: req.revision,\n          };\n          if (req.attachments.length === 0)\n            return turn(\"generate\", req, { json: body }, handlers, signal);\n          const form = new FormData();\n          form.set(AI_GENERATE_FIELDS.message, req.message);\n          if (req.selectedBlockId !== null)\n            form.set(AI_GENERATE_FIELDS.selectedBlockId, req.selectedBlockId);\n          form.set(AI_GENERATE_FIELDS.mergeTags, JSON.stringify(req.mergeTags));\n          form.set(AI_GENERATE_FIELDS.content, JSON.stringify(req.content));\n          if (req.revision !== null)\n            form.set(AI_GENERATE_FIELDS.revision, String(req.revision));\n          for (const attachment of req.attachments)\n            form.append(\n              AI_GENERATE_FIELDS.attachment,\n              attachment.file,\n              attachment.name,\n            );\n          return turn(\"generate\", req, { form }, handlers, signal);\n        }\n      : false,\n    fixFinding: on(\"fixFinding\")\n      ? (req, handlers, signal) =>\n          turn(\n            \"fixFinding\",\n            req,\n            {\n              json: {\n                finding: req.finding,\n                mergeTags: req.mergeTags,\n                content: req.content,\n                revision: req.revision,\n              },\n            },\n            handlers,\n            signal,\n          )\n      : false,\n    rewrite: on(\"rewrite\")\n      ? (req, handlers, signal) =>\n          streamed(\n            \"rewriteText\",\n            req.templateId,\n            {\n              json: {\n                html: req.html,\n                preset: req.preset,\n                language: req.language,\n                instruction: req.instruction,\n                mergeTags: req.mergeTags,\n              },\n            },\n            signal,\n            (event) => {\n              if (event.type === \"text\") handlers.onText(event.text);\n            },\n            (done) =>\n              typeof done.html === \"string\" ? { html: done.html } : undefined,\n          )\n      : false,\n    altText: on(\"altText\")\n      ? (req, signal) => {\n          const { templateId, sessionId, ...body } = req;\n          return streamed(\n            \"altText\",\n            templateId,\n            { json: body, session: sessionId },\n            signal,\n            () => {},\n            (done) =>\n              typeof done.alt === \"string\" ? { alt: done.alt } : undefined,\n          );\n        }\n      : false,\n    ...(on(\"conversation\")\n      ? {\n          conversation: {\n            settleReplay: async (\n              templateId: string,\n              messageId: string,\n              outcome: AiReplayOutcome,\n            ) => {\n              await request(\n                \"settleReplay\",\n                {\n                  template: templateId,\n                  message: messageId,\n                  replayId: outcome.replayId,\n                },\n                {\n                  session: outcome.sessionId,\n                  json: {\n                    direction: outcome.direction,\n                    applied: outcome.applied,\n                  },\n                },\n              );\n            },\n            list: async (templateId: string) => {\n              const response = await request(\n                \"conversationMessages\",\n                { template: templateId },\n                {},\n              );\n              const body = await json<{ data?: unknown }>(response);\n              if (!isRecord(body)) throw providerFailure();\n              if (!Array.isArray(body.data)) throw providerFailure();\n              return body.data;\n            },\n            clear: async (templateId: string) => {\n              await request(\"clearConversation\", { template: templateId }, {});\n            },\n            undo: (\n              templateId: string,\n              messageId: string,\n              context: { sessionId: string },\n            ) =>\n              replay(\"undoMessage\", templateId, messageId, context.sessionId),\n            redo: (\n              templateId: string,\n              messageId: string,\n              context: { sessionId: string },\n            ) =>\n              replay(\"redoMessage\", templateId, messageId, context.sessionId),\n          },\n        }\n      : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { C as AiWireEvent, S as AiTextEvent, T as matchAiRoute, _ as AiReplayResponse, a as AI_ROUTES, b as AiRouteMatch, c as AI_WIRE_VERSION, d as AiConversationResponse, f as AiDoneEvent, g as AiOperationsEvent, h as AiGenerateBody, i as AI_LIMITS, l as AiAltTextBody, m as AiFixFindingBody, n as AI_ERROR_STATUS, o as AI_SESSION_HEADER, p as AiErrorEvent, r as AI_GENERATE_FIELDS, s as AI_WIRE_HEADER, t as AI_ERROR_MESSAGES, u as AiAppliedEvent, v as AiRewriteBody, w as aiRoutePath, x as AiRouteName, y as AiRoute } from "./wire-Cv7Fk-7n.js";
+import { AiAltTextRequest, AiAppliedBatch, AiChatAttachment, AiChatMessage, AiChatRequest, AiConversationProvider, AiErrorCode, AiFeatureName, AiFixFinding, AiFixRequest, AiLimitDetails, AiMergeTag, AiMergeTagSyntax, AiMergeTags, AiMessageBatch, AiMessageKind, AiOperationsResult, AiProvider, AiReplay, AiReplayContext, AiReplayOutcome, AiRequestBase, AiRewriteHandlers, AiRewritePreset, AiRewriteRequest, AiTurnHandlers, AiTurnResult, CollaborationConflict, Operation, SdkError, TemplateContent, ThrottledError } from "@templatical/types";
+export { AI_ERROR_MESSAGES, AI_ERROR_STATUS, AI_GENERATE_FIELDS, AI_LIMITS, AI_ROUTES, AI_SESSION_HEADER, AI_WIRE_HEADER, AI_WIRE_VERSION, AiAltTextBody, type AiAltTextRequest, type AiAppliedBatch, AiAppliedEvent, type AiChatAttachment, type AiChatMessage, type AiChatRequest, type AiConversationProvider, AiConversationResponse, AiDoneEvent, type AiErrorCode, AiErrorEvent, type AiFeatureName, type AiFixFinding, AiFixFindingBody, type AiFixRequest, AiGenerateBody, type AiLimitDetails, type AiMergeTag, type AiMergeTagSyntax, type AiMergeTags, type AiMessageBatch, type AiMessageKind, AiOperationsEvent, type AiOperationsResult, type AiProvider, type AiReplay, type AiReplayContext, type AiReplayOutcome, AiReplayResponse, type AiRequestBase, AiRewriteBody, type AiRewriteHandlers, type AiRewritePreset, type AiRewriteRequest, AiRoute, AiRouteMatch, AiRouteName, AiTextEvent, type AiTurnHandlers, type AiTurnResult, AiWireEvent, CollaborationConflict, type Operation, SdkError, type TemplateContent, ThrottledError, aiRoutePath, matchAiRoute };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { a as AI_ROUTES, c as AI_WIRE_VERSION, i as AI_LIMITS, l as aiRoutePath, n as AI_ERROR_STATUS, o as AI_SESSION_HEADER, r as AI_GENERATE_FIELDS, s as AI_WIRE_HEADER, t as AI_ERROR_MESSAGES, u as matchAiRoute } from "./wire-B6AF_UGT.js";
+import { CollaborationConflict, SdkError, ThrottledError } from "@templatical/types";
+export { AI_ERROR_MESSAGES, AI_ERROR_STATUS, AI_GENERATE_FIELDS, AI_LIMITS, AI_ROUTES, AI_SESSION_HEADER, AI_WIRE_HEADER, AI_WIRE_VERSION, CollaborationConflict, SdkError, ThrottledError, aiRoutePath, matchAiRoute };

package/dist/model-xJvGTfLB.d.ts

@@ -0,0 +1,84 @@
+//#region src/server/tool.d.ts
+/** A tool in neutral JSON-schema form; adapters map it to their SDK's shape. */
+interface AiToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>;
+}
+/**
+ * The editing turns' one tool (S7 A4). `ops` is a JSON **string**: several
+ * SDKs turn tool arguments into maps that lose `{}` (S7 D8), and a string
+ * survives every one of them.
+ */
+declare const applyOperationsTool: AiToolDefinition;
+//#endregion
+//#region src/server/model.d.ts
+/** A design file or an image URL attached to a user message. */
+type AiModelAttachment = {
+  kind: "image" | "pdf";
+  mediaType: string;
+  data: Blob;
+} | {
+  kind: "image-url";
+  url: string;
+};
+interface AiModelToolCall {
+  id: string;
+  name: string;
+  /** The tool's arguments: a JSON string of the arguments object, or the object. */
+  input: string | Record<string, unknown>;
+}
+type AiModelMessage = {
+  role: "user";
+  content: string;
+  attachments?: AiModelAttachment[];
+} | {
+  role: "assistant";
+  content: string;
+  toolCalls?: AiModelToolCall[];
+  /** What the adapter yielded as `state` for this step; it replays its own. */
+  state?: unknown;
+} | {
+  role: "tool";
+  toolCallId: string;
+  name: string;
+  content: string;
+};
+interface AiUsage {
+  /** Input tokens billed at the full rate: not read from or written to a cache. */
+  inputTokens: number;
+  outputTokens: number;
+  /** Input tokens read from the provider's prompt cache, when it reports them. */
+  cacheReadInputTokens?: number;
+  /** Input tokens written to the provider's prompt cache, when it reports them. */
+  cacheWriteInputTokens?: number;
+}
+type AiModelPart = {
+  type: "text";
+  text: string;
+} | ({
+  type: "tool-call";
+} & AiModelToolCall) |
+/** Opaque to the kit: the adapter's own record of the step (e.g. thinking), JSON-safe. */
+{
+  type: "state";
+  state: unknown;
+} | ({
+  type: "usage";
+} & AiUsage);
+/**
+ * Your model, behind one method: stream a reply to `messages` with `system` as
+ * the system prompt and `tools` offered. `@templatical/ai-kit/adapters/*`
+ * implements it for Anthropic, OpenAI and the Vercel AI SDK. Honour `signal`.
+ */
+interface AiModelAdapter {
+  stream(input: {
+    system: string;
+    messages: AiModelMessage[];
+    tools: AiToolDefinition[];
+    signal?: AbortSignal;
+  }): AsyncIterable<AiModelPart>;
+}
+//#endregion
+export { AiModelToolCall as a, applyOperationsTool as c, AiModelPart as i, AiModelAttachment as n, AiUsage as o, AiModelMessage as r, AiToolDefinition as s, AiModelAdapter as t };
+//# sourceMappingURL=model-xJvGTfLB.d.ts.map