pagegraph 0.12.0 → 0.14.0

package/dist/system-one-shared-Dl10ZF7Z.js

@@ -0,0 +1,167 @@
+import { t as calculateCost } from "./models-DcT5qOEL.js";
+import { n as providerHeadersToRecord, t as headersToRecord } from "./headers-BRNMVpzu.js";
+import { t as retryProviderRequest } from "./provider-retry-DzKoh1X7.js";
+import { n as normalizeProviderError, t as formatProviderError } from "./error-body-CyiejW4b.js";
+//#region node_modules/@earendil-works/pi-ai/dist/api/system-one-shared.js
+function httpError(label, response, body) {
+	const error = /* @__PURE__ */ new Error(`${label} returned ${response.status}`);
+	error.status = response.status;
+	error.headers = response.headers;
+	error.body = body;
+	return error;
+}
+function timeoutError(timeoutMs) {
+	const error = /* @__PURE__ */ new Error(`Request timed out after ${timeoutMs}ms`);
+	error.name = "TimeoutError";
+	error.status = void 0;
+	error.headers = void 0;
+	error.body = "";
+	return error;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requiredNumber(label, value, field) {
+	if (typeof value !== "number" || !Number.isFinite(value)) throw new Error(`${label} returned an invalid ${field}`);
+	return value;
+}
+function probabilities(label, value, id) {
+	if (!isRecord(value)) throw new Error(`${label} returned invalid probabilities for ${id}`);
+	return Object.fromEntries(Object.entries(value).map(([key, probability]) => [key, requiredNumber(label, probability, `probability for ${id}.${key}`)]));
+}
+function parseAnswers(label, value, context) {
+	if (!isRecord(value)) throw new Error(`${label} returned an unexpected response`);
+	const answers = [];
+	for (const [id, question] of Object.entries(context.questions)) {
+		const answer = value[id];
+		if (!isRecord(answer)) throw new Error(`${label} did not return an answer for ${id}`);
+		if (question.type === "choice") {
+			if (answer.type !== "choice" || typeof answer.choice !== "string") throw new Error(`${label} did not return a choice answer for ${id}`);
+			answers.push([id, {
+				type: "choice",
+				choice: answer.choice,
+				probabilities: probabilities(label, answer.probabilities, id),
+				confidence: requiredNumber(label, answer.confidence, `confidence for ${id}`)
+			}]);
+		} else if (question.type === "score") {
+			if (answer.type !== "score") throw new Error(`${label} did not return a score answer for ${id}`);
+			answers.push([id, {
+				type: "score",
+				score: requiredNumber(label, answer.score, `score for ${id}`),
+				confidence: requiredNumber(label, answer.confidence, `confidence for ${id}`)
+			}]);
+		} else {
+			if (answer.type !== "noul") throw new Error(`${label} did not return a bool answer for ${id}`);
+			answers.push([id, {
+				type: "bool",
+				probability: requiredNumber(label, answer.noul, `probability for ${id}`)
+			}]);
+		}
+	}
+	return Object.fromEntries(answers);
+}
+function tokenCount(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : 0;
+}
+/**
+* Usage from System One's `{ input_tokens, output_tokens }`, priced from the model catalog like chat
+* usage. A missing or malformed usage object leaves the result without usage instead of failing it.
+*/
+function parseUsage(value, model) {
+	if (!isRecord(value) || value.input_tokens === void 0 && value.output_tokens === void 0) return void 0;
+	const input = tokenCount(value.input_tokens);
+	const output = tokenCount(value.output_tokens);
+	const usage = {
+		input,
+		output,
+		cacheRead: 0,
+		cacheWrite: 0,
+		totalTokens: input + output,
+		cost: {
+			input: 0,
+			output: 0,
+			cacheRead: 0,
+			cacheWrite: 0,
+			total: 0
+		}
+	};
+	calculateCost(model, usage);
+	return usage;
+}
+/** Maps public `bool` questions to TypeSafe's wire-level `noul` type. */
+function wireRequest(context) {
+	return {
+		state: context.state,
+		questions: Object.fromEntries(Object.entries(context.questions).map(([id, question]) => [id, question.type === "bool" ? {
+			...question,
+			type: "noul"
+		} : question]))
+	};
+}
+function requestHeaders(model, apiKey, optionsHeaders) {
+	return providerHeadersToRecord({
+		authorization: `Bearer ${apiKey}`,
+		"content-type": "application/json"
+	}, model.headers, optionsHeaders) ?? {};
+}
+/** Runs one System One classification over the given transport. */
+async function classifySystemOne(transport, model, context, options) {
+	const output = {
+		api: model.api,
+		provider: model.provider,
+		model: model.id,
+		answers: {},
+		stopReason: "stop",
+		timestamp: Date.now()
+	};
+	try {
+		if (model.api !== transport.api) throw new Error(`Unsupported classifier API: ${model.api}`);
+		if (!options?.apiKey) throw new Error(`No API key for provider: ${model.provider}`);
+		const apiKey = options.apiKey;
+		let payload = transport.payload(model, wireRequest(context));
+		const transformed = await options.onPayload?.(payload, model);
+		if (transformed !== void 0) payload = transformed;
+		const requestFetch = options.fetch ?? globalThis.fetch;
+		const { response, body } = await retryProviderRequest(async () => {
+			const timeoutSignal = options.timeoutMs !== void 0 ? AbortSignal.timeout(options.timeoutMs) : void 0;
+			const signal = options.signal && timeoutSignal ? AbortSignal.any([options.signal, timeoutSignal]) : options.signal ?? timeoutSignal;
+			try {
+				const next = await requestFetch(transport.url(model), {
+					method: "POST",
+					headers: requestHeaders(model, apiKey, options.headers),
+					body: JSON.stringify(payload),
+					signal
+				});
+				if (!next.ok) throw httpError(transport.label, next, await next.text());
+				return {
+					response: next,
+					body: await next.json()
+				};
+			} catch (error) {
+				if (timeoutSignal?.aborted && !options.signal?.aborted) throw timeoutError(options.timeoutMs);
+				throw error;
+			}
+		}, {
+			maxRetries: options.maxRetries ?? 2,
+			maxRetryDelayMs: options.maxRetryDelayMs,
+			signal: options.signal
+		});
+		await options.onResponse?.({
+			status: response.status,
+			headers: headersToRecord(response.headers)
+		}, model);
+		const result = transport.output(body);
+		const usage = parseUsage(result.usage, model);
+		if (usage) output.usage = usage;
+		output.answers = parseAnswers(transport.label, result.answers, context);
+		return output;
+	} catch (error) {
+		output.stopReason = options?.signal?.aborted ? "aborted" : "error";
+		output.errorMessage = formatProviderError(normalizeProviderError(error), `${transport.label} error`);
+		return output;
+	}
+}
+//#endregion
+export { isRecord as n, classifySystemOne as t };
+
+//# sourceMappingURL=system-one-shared-Dl10ZF7Z.js.map

package/dist/system-one-shared-Dl10ZF7Z.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-one-shared-Dl10ZF7Z.js","names":[],"sources":["../node_modules/@earendil-works/pi-ai/dist/api/system-one-shared.js"],"sourcesContent":["import { calculateCost } from \"../models.js\";\nimport { formatProviderError, normalizeProviderError } from \"../utils/error-body.js\";\nimport { headersToRecord, providerHeadersToRecord } from \"../utils/headers.js\";\nimport { retryProviderRequest } from \"../utils/provider-retry.js\";\nfunction httpError(label, response, body) {\n    const error = new Error(`${label} returned ${response.status}`);\n    error.status = response.status;\n    error.headers = response.headers;\n    error.body = body;\n    return error;\n}\nfunction timeoutError(timeoutMs) {\n    const error = new Error(`Request timed out after ${timeoutMs}ms`);\n    error.name = \"TimeoutError\";\n    error.status = undefined;\n    error.headers = undefined;\n    error.body = \"\";\n    return error;\n}\nexport function isRecord(value) {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\nfunction requiredNumber(label, value, field) {\n    if (typeof value !== \"number\" || !Number.isFinite(value)) {\n        throw new Error(`${label} returned an invalid ${field}`);\n    }\n    return value;\n}\nfunction probabilities(label, value, id) {\n    if (!isRecord(value))\n        throw new Error(`${label} returned invalid probabilities for ${id}`);\n    return Object.fromEntries(Object.entries(value).map(([key, probability]) => [\n        key,\n        requiredNumber(label, probability, `probability for ${id}.${key}`),\n    ]));\n}\nfunction parseAnswers(label, value, context) {\n    if (!isRecord(value))\n        throw new Error(`${label} returned an unexpected response`);\n    const answers = [];\n    for (const [id, question] of Object.entries(context.questions)) {\n        const answer = value[id];\n        if (!isRecord(answer))\n            throw new Error(`${label} did not return an answer for ${id}`);\n        if (question.type === \"choice\") {\n            if (answer.type !== \"choice\" || typeof answer.choice !== \"string\") {\n                throw new Error(`${label} did not return a choice answer for ${id}`);\n            }\n            answers.push([\n                id,\n                {\n                    type: \"choice\",\n                    choice: answer.choice,\n                    probabilities: probabilities(label, answer.probabilities, id),\n                    confidence: requiredNumber(label, answer.confidence, `confidence for ${id}`),\n                },\n            ]);\n        }\n        else if (question.type === \"score\") {\n            if (answer.type !== \"score\")\n                throw new Error(`${label} did not return a score answer for ${id}`);\n            answers.push([\n                id,\n                {\n                    type: \"score\",\n                    score: requiredNumber(label, answer.score, `score for ${id}`),\n                    confidence: requiredNumber(label, answer.confidence, `confidence for ${id}`),\n                },\n            ]);\n        }\n        else {\n            if (answer.type !== \"noul\")\n                throw new Error(`${label} did not return a bool answer for ${id}`);\n            answers.push([\n                id,\n                {\n                    type: \"bool\",\n                    probability: requiredNumber(label, answer.noul, `probability for ${id}`),\n                },\n            ]);\n        }\n    }\n    return Object.fromEntries(answers);\n}\nfunction tokenCount(value) {\n    return typeof value === \"number\" && Number.isFinite(value) && value > 0 ? value : 0;\n}\n/**\n * Usage from System One's `{ input_tokens, output_tokens }`, priced from the model catalog like chat\n * usage. A missing or malformed usage object leaves the result without usage instead of failing it.\n */\nfunction parseUsage(value, model) {\n    if (!isRecord(value) || (value.input_tokens === undefined && value.output_tokens === undefined))\n        return undefined;\n    const input = tokenCount(value.input_tokens);\n    const output = tokenCount(value.output_tokens);\n    const usage = {\n        input,\n        output,\n        cacheRead: 0,\n        cacheWrite: 0,\n        totalTokens: input + output,\n        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n    };\n    calculateCost(model, usage);\n    return usage;\n}\n/** Maps public `bool` questions to TypeSafe's wire-level `noul` type. */\nfunction wireRequest(context) {\n    return {\n        state: context.state,\n        questions: Object.fromEntries(Object.entries(context.questions).map(([id, question]) => [\n            id,\n            question.type === \"bool\" ? { ...question, type: \"noul\" } : question,\n        ])),\n    };\n}\nfunction requestHeaders(model, apiKey, optionsHeaders) {\n    return (providerHeadersToRecord({ authorization: `Bearer ${apiKey}`, \"content-type\": \"application/json\" }, model.headers, optionsHeaders) ?? {});\n}\n/** Runs one System One classification over the given transport. */\nexport async function classifySystemOne(transport, model, context, options) {\n    const output = {\n        api: model.api,\n        provider: model.provider,\n        model: model.id,\n        answers: {},\n        stopReason: \"stop\",\n        timestamp: Date.now(),\n    };\n    try {\n        if (model.api !== transport.api)\n            throw new Error(`Unsupported classifier API: ${model.api}`);\n        if (!options?.apiKey)\n            throw new Error(`No API key for provider: ${model.provider}`);\n        const apiKey = options.apiKey;\n        let payload = transport.payload(model, wireRequest(context));\n        const transformed = await options.onPayload?.(payload, model);\n        if (transformed !== undefined)\n            payload = transformed;\n        const requestFetch = options.fetch ?? globalThis.fetch;\n        const { response, body } = await retryProviderRequest(async () => {\n            const timeoutSignal = options.timeoutMs !== undefined ? AbortSignal.timeout(options.timeoutMs) : undefined;\n            const signal = options.signal && timeoutSignal\n                ? AbortSignal.any([options.signal, timeoutSignal])\n                : (options.signal ?? timeoutSignal);\n            try {\n                const next = await requestFetch(transport.url(model), {\n                    method: \"POST\",\n                    headers: requestHeaders(model, apiKey, options.headers),\n                    body: JSON.stringify(payload),\n                    signal,\n                });\n                if (!next.ok)\n                    throw httpError(transport.label, next, await next.text());\n                return { response: next, body: (await next.json()) };\n            }\n            catch (error) {\n                if (timeoutSignal?.aborted && !options.signal?.aborted)\n                    throw timeoutError(options.timeoutMs);\n                throw error;\n            }\n        }, {\n            maxRetries: options.maxRetries ?? 2,\n            maxRetryDelayMs: options.maxRetryDelayMs,\n            signal: options.signal,\n        });\n        await options.onResponse?.({ status: response.status, headers: headersToRecord(response.headers) }, model);\n        const result = transport.output(body);\n        // Set before parsing answers: a request with malformed answers was still billed.\n        const usage = parseUsage(result.usage, model);\n        if (usage)\n            output.usage = usage;\n        output.answers = parseAnswers(transport.label, result.answers, context);\n        return output;\n    }\n    catch (error) {\n        output.stopReason = options?.signal?.aborted ? \"aborted\" : \"error\";\n        output.errorMessage = formatProviderError(normalizeProviderError(error), `${transport.label} error`);\n        return output;\n    }\n}\n//# sourceMappingURL=system-one-shared.js.map"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/tanstack-start/index.d.ts

@@ -1,13 +1,29 @@
-import { r as SeoGraphLoader } from "../vite-graph-loader-Btgjz5RH.js";
-import { i as SiteRuntime, n as PagegraphOptions, r as RobotsPolicy, t as AppGraph } from "../graph-CBIY71w6.js";
+import { a as SiteRuntime, c as AppGraph, i as SeoGraphLoader, l as PagegraphOptions, r as LoadedSeoGraph, u as RobotsPolicy } from "../vite-graph-loader-DZCwejuJ.js";
 import { Plugin } from "vite";
 //#region src/tanstack-start/plugin.d.ts
-declare function pagegraph(options: PagegraphOptions): Array<Plugin>;
+/** Start prerenders this private endpoint once; its callback writes public Markdown twins. */
+interface MarkdownPrerenderPage {
+  readonly path: string;
+  readonly sitemap: {
+    readonly exclude: true;
+  };
+  readonly prerender: {
+    readonly onSuccess: (result: {
+      html: string;
+    }) => Promise<void>;
+  };
+}
+type PagegraphPlugins = Array<Plugin> & {
+  readonly prerenderPages: Array<MarkdownPrerenderPage>;
+};
+declare function pagegraph(options: PagegraphOptions): PagegraphPlugins;
 //#endregion
 //#region src/tanstack-start/load.d.ts
 interface EvaluateAppGraphOptions {
-  /** The app's Vite root. */
+  /** Directory used to find the Vite config and as its default root. */
   readonly root: string;
+  /** Vite command to evaluate. Graph evaluation defaults to `serve`. */
+  readonly command?: "serve" | "build" | undefined;
   /** The app's Vite config file. Defaults to Vite's lookup from `root`. */
   readonly configFile?: string | undefined;
   /**
@@ -17,24 +33,24 @@ interface EvaluateAppGraphOptions {
   readonly mode?: string | undefined;
 }
 /**
- * Resolve the app's Vite config in serve mode, evaluate the graph in its
- * `pagegraph` environment, and release it — the dev server's evaluation path
- * without a server. A config that branches on `command` sees `serve`; pass
- * `mode` for the deployment the graph should describe.
+ * Resolve the app's Vite config, evaluate the graph in its `pagegraph`
+ * environment, and release it. The command defaults to `serve`; callers can
+ * request `build` to match the deployed site configuration.
  */
-declare function evaluateAppGraph(options: EvaluateAppGraphOptions): Promise<AppGraph>;
+declare function evaluateAppGraph(options: EvaluateAppGraphOptions): Promise<AppGraph & {
+  readonly pagegraph: NonNullable<LoadedSeoGraph["pagegraph"]>;
+}>;
 /**
- * A `seo.config.ts` graph loader for a TanStack Start app: the same graph the
- * `pagegraph()` plugin ships to the runtime, with its robots policy.
+ * A `pagegraph.config.ts` graph loader for a TanStack Start app. It uses the
+ * built site's identity by default; pass `command: "serve"` for a dev host.
  *
  * ```ts
  * export default defineSeoConfig({
- *   origin: "https://example.com",
  *   loadGraph: tanstackStartGraph({ root: import.meta.dirname }),
  * });
  * ```
  */
 declare const tanstackStartGraph: (options: EvaluateAppGraphOptions) => SeoGraphLoader;
 //#endregion
-export { type AppGraph, type EvaluateAppGraphOptions, type PagegraphOptions, type RobotsPolicy, type SiteRuntime, evaluateAppGraph, pagegraph, tanstackStartGraph };
+export { type AppGraph, type EvaluateAppGraphOptions, type MarkdownPrerenderPage, type PagegraphOptions, type PagegraphPlugins, type RobotsPolicy, type SiteRuntime, evaluateAppGraph, pagegraph, tanstackStartGraph };
 //# sourceMappingURL=index.d.ts.map