@astralyn/pi 1.0.5 → 1.2.0

package/dist/extensions/web-search/results.d.ts

@@ -1,35 +0,0 @@
-/**
- * Result normalization, bounding, deduplication, and ranking for web_search providers.
- */
-import type { ProviderSearchResult, WebSearchHit } from "./types.ts";
-export declare const MAX_OUTPUT_HITS = 12;
-export declare const MAX_QUERY_LENGTH = 500;
-export declare const MAX_TITLE_LENGTH = 200;
-export declare const MAX_URL_LENGTH = 2048;
-export declare const MAX_SNIPPET_LENGTH = 200;
-export declare const MAX_DATE_LENGTH = 100;
-export declare const MAX_RELATED_SEARCHES = 8;
-export declare const MAX_RELATED_SEARCH_LENGTH = 200;
-export declare const MAX_SYNTHESIS_LENGTH = 6000;
-export declare const MAX_ERROR_MESSAGE_LENGTH = 500;
-/** Provider arrays are transport-bounded too, but avoid scanning an entire hostile payload. */
-export declare const MAX_PROVIDER_HIT_SCAN = 200;
-export declare const MAX_PROVIDER_RELATED_SCAN = 64;
-/** Historical session details predate the current bounds and may contain oversized arrays. */
-export declare const MAX_HISTORICAL_HIT_SCAN: number;
-export declare const MAX_HISTORICAL_SOURCE_SCAN = 32;
-export declare const MAX_HISTORICAL_RELATED_SCAN: number;
-export interface FusedSearchResults {
-    hits: WebSearchHit[];
-    relatedSearches?: string[];
-    deepseekSynthesis?: string;
-}
-/** Normalize and bound a provider-controlled single-line text field. */
-export declare function boundSingleLineText(value: unknown, maxLength: number): string | undefined;
-/** Trim and bound provider-controlled text that intentionally preserves lines. */
-export declare function boundMultilineText(value: unknown, maxLength: number): string | undefined;
-/** Normalize a usable HTTP(S) source URL without changing non-tracking query values. */
-export declare function normalizeUrl(rawUrl: unknown): string | undefined;
-/** Bound provider results, deduplicate URLs, and rank them with reciprocal-rank fusion. */
-export declare function fuseSearchHits(results: ProviderSearchResult[]): FusedSearchResults;
-//# sourceMappingURL=results.d.ts.map

package/dist/extensions/web-search/results.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../../src/extensions/web-search/results.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAqB,oBAAoB,EAAsB,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5G,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,+FAA+F;AAC/F,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,8FAA8F;AAC9F,eAAO,MAAM,uBAAuB,QAAuB,CAAC;AAC5D,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,2BAA2B,QAA2B,CAAC;AAqBpE,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIzF;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIxF;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAoBhE;AA6BD,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,kBAAkB,CA0DlF"}

package/dist/extensions/web-search/results.js

@@ -1,167 +0,0 @@
-/**
- * Result normalization, bounding, deduplication, and ranking for web_search providers.
- */
-export const MAX_OUTPUT_HITS = 12;
-export const MAX_QUERY_LENGTH = 500;
-export const MAX_TITLE_LENGTH = 200;
-export const MAX_URL_LENGTH = 2048;
-export const MAX_SNIPPET_LENGTH = 200;
-export const MAX_DATE_LENGTH = 100;
-export const MAX_RELATED_SEARCHES = 8;
-export const MAX_RELATED_SEARCH_LENGTH = 200;
-export const MAX_SYNTHESIS_LENGTH = 6000;
-export const MAX_ERROR_MESSAGE_LENGTH = 500;
-/** Provider arrays are transport-bounded too, but avoid scanning an entire hostile payload. */
-export const MAX_PROVIDER_HIT_SCAN = 200;
-export const MAX_PROVIDER_RELATED_SCAN = 64;
-/** Historical session details predate the current bounds and may contain oversized arrays. */
-export const MAX_HISTORICAL_HIT_SCAN = MAX_OUTPUT_HITS * 20;
-export const MAX_HISTORICAL_SOURCE_SCAN = 32;
-export const MAX_HISTORICAL_RELATED_SCAN = MAX_RELATED_SEARCHES * 8;
-const RRF_K = 60;
-const TRACKING_PARAMS = new Set([
-    "utm_source",
-    "utm_medium",
-    "utm_campaign",
-    "utm_term",
-    "utm_content",
-    "ref",
-    "fbclid",
-    "gclid",
-    "trk",
-    "gi",
-]);
-function truncateText(text, maxLength) {
-    if (text.length <= maxLength)
-        return text;
-    if (maxLength <= 3)
-        return text.slice(0, maxLength);
-    return `${text.slice(0, maxLength - 3).trimEnd()}...`;
-}
-/** Normalize and bound a provider-controlled single-line text field. */
-export function boundSingleLineText(value, maxLength) {
-    if (typeof value !== "string")
-        return undefined;
-    const normalized = value.replace(/\s+/g, " ").trim();
-    return normalized ? truncateText(normalized, maxLength) : undefined;
-}
-/** Trim and bound provider-controlled text that intentionally preserves lines. */
-export function boundMultilineText(value, maxLength) {
-    if (typeof value !== "string")
-        return undefined;
-    const normalized = value.trim();
-    return normalized ? truncateText(normalized, maxLength) : undefined;
-}
-/** Normalize a usable HTTP(S) source URL without changing non-tracking query values. */
-export function normalizeUrl(rawUrl) {
-    if (typeof rawUrl !== "string")
-        return undefined;
-    const trimmed = rawUrl.trim();
-    if (!trimmed || trimmed.length > MAX_URL_LENGTH)
-        return undefined;
-    try {
-        const url = new URL(trimmed);
-        if (url.protocol !== "http:" && url.protocol !== "https:")
-            return undefined;
-        url.hash = "";
-        for (const parameter of TRACKING_PARAMS) {
-            if (url.searchParams.has(parameter))
-                url.searchParams.delete(parameter);
-        }
-        if (url.pathname.length > 1 && url.pathname.endsWith("/")) {
-            url.pathname = url.pathname.replace(/\/+$/, "");
-        }
-        const normalized = url.toString();
-        return normalized.length <= MAX_URL_LENGTH ? normalized : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function normalizeHit(hit) {
-    const url = normalizeUrl(hit.url);
-    if (!url)
-        return undefined;
-    return {
-        title: boundSingleLineText(hit.title, MAX_TITLE_LENGTH) ?? url,
-        url,
-        snippet: boundSingleLineText(hit.snippet, MAX_SNIPPET_LENGTH),
-        date: boundSingleLineText(hit.date, MAX_DATE_LENGTH),
-    };
-}
-function isUrlFallbackTitle(title, url) {
-    const normalizedTitle = normalizeUrl(title);
-    return normalizedTitle !== undefined && normalizedTitle === normalizeUrl(url);
-}
-function reciprocalRankScore(candidate) {
-    let score = 0;
-    for (const rank of candidate.ranks.values())
-        score += 1 / (RRF_K + rank);
-    return score;
-}
-function bestRank(candidate) {
-    return Math.min(...candidate.ranks.values());
-}
-/** Bound provider results, deduplicate URLs, and rank them with reciprocal-rank fusion. */
-export function fuseSearchHits(results) {
-    const candidates = new Map();
-    const relatedSearches = new Set();
-    let deepseekSynthesis;
-    for (const result of results) {
-        const providerRelated = Array.isArray(result.relatedSearches) ? result.relatedSearches : [];
-        const relatedScanLimit = Math.min(providerRelated.length, MAX_PROVIDER_RELATED_SCAN);
-        for (let index = 0; index < relatedScanLimit && relatedSearches.size < MAX_RELATED_SEARCHES; index++) {
-            const normalized = boundSingleLineText(providerRelated[index], MAX_RELATED_SEARCH_LENGTH);
-            if (normalized)
-                relatedSearches.add(normalized);
-        }
-        const synthesis = boundMultilineText(result.synthesisText, MAX_SYNTHESIS_LENGTH);
-        if (synthesis)
-            deepseekSynthesis = synthesis;
-        const providerHits = Array.isArray(result.hits) ? result.hits : [];
-        const hitScanLimit = Math.min(providerHits.length, MAX_PROVIDER_HIT_SCAN);
-        for (let index = 0; index < hitScanLimit; index++) {
-            const rawHit = providerHits[index];
-            if (!rawHit)
-                continue;
-            const hit = normalizeHit(rawHit);
-            if (!hit)
-                continue;
-            const rank = index + 1;
-            const existing = candidates.get(hit.url);
-            if (!existing) {
-                candidates.set(hit.url, { hit, ranks: new Map([[result.source, rank]]) });
-                continue;
-            }
-            const previousRank = existing.ranks.get(result.source);
-            if (previousRank === undefined || rank < previousRank)
-                existing.ranks.set(result.source, rank);
-            if (isUrlFallbackTitle(existing.hit.title, existing.hit.url) && !isUrlFallbackTitle(hit.title, hit.url)) {
-                existing.hit.title = hit.title;
-            }
-            if ((!existing.hit.snippet || existing.hit.snippet.length < (hit.snippet?.length ?? 0)) && hit.snippet) {
-                existing.hit.snippet = hit.snippet;
-            }
-            if (!existing.hit.date && hit.date)
-                existing.hit.date = hit.date;
-        }
-    }
-    const ranked = [...candidates.entries()]
-        .sort(([leftUrl, left], [rightUrl, right]) => {
-        const scoreDifference = reciprocalRankScore(right) - reciprocalRankScore(left);
-        if (scoreDifference !== 0)
-            return scoreDifference;
-        const rankDifference = bestRank(left) - bestRank(right);
-        if (rankDifference !== 0)
-            return rankDifference;
-        return leftUrl.localeCompare(rightUrl);
-    })
-        .map(([, candidate]) => ({ ...candidate.hit, sources: [...candidate.ranks.keys()] }))
-        .slice(0, MAX_OUTPUT_HITS);
-    return {
-        hits: ranked,
-        relatedSearches: relatedSearches.size > 0 ? [...relatedSearches] : undefined,
-        deepseekSynthesis,
-    };
-}
-//# sourceMappingURL=results.js.map

package/dist/extensions/web-search/results.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../src/extensions/web-search/results.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Result normalization, bounding, deduplication, and ranking for web_search providers.\n */\n\nimport type { ProviderSearchHit, ProviderSearchResult, SearchEngineSource, WebSearchHit } from \"./types.ts\";\n\nexport const MAX_OUTPUT_HITS = 12;\nexport const MAX_QUERY_LENGTH = 500;\nexport const MAX_TITLE_LENGTH = 200;\nexport const MAX_URL_LENGTH = 2048;\nexport const MAX_SNIPPET_LENGTH = 200;\nexport const MAX_DATE_LENGTH = 100;\nexport const MAX_RELATED_SEARCHES = 8;\nexport const MAX_RELATED_SEARCH_LENGTH = 200;\nexport const MAX_SYNTHESIS_LENGTH = 6000;\nexport const MAX_ERROR_MESSAGE_LENGTH = 500;\n/** Provider arrays are transport-bounded too, but avoid scanning an entire hostile payload. */\nexport const MAX_PROVIDER_HIT_SCAN = 200;\nexport const MAX_PROVIDER_RELATED_SCAN = 64;\n/** Historical session details predate the current bounds and may contain oversized arrays. */\nexport const MAX_HISTORICAL_HIT_SCAN = MAX_OUTPUT_HITS * 20;\nexport const MAX_HISTORICAL_SOURCE_SCAN = 32;\nexport const MAX_HISTORICAL_RELATED_SCAN = MAX_RELATED_SEARCHES * 8;\n\nconst RRF_K = 60;\nconst TRACKING_PARAMS = new Set([\n\t\"utm_source\",\n\t\"utm_medium\",\n\t\"utm_campaign\",\n\t\"utm_term\",\n\t\"utm_content\",\n\t\"ref\",\n\t\"fbclid\",\n\t\"gclid\",\n\t\"trk\",\n\t\"gi\",\n]);\n\ninterface FusionCandidate {\n\thit: ProviderSearchHit;\n\tranks: Map<SearchEngineSource, number>;\n}\n\nexport interface FusedSearchResults {\n\thits: WebSearchHit[];\n\trelatedSearches?: string[];\n\tdeepseekSynthesis?: string;\n}\n\nfunction truncateText(text: string, maxLength: number): string {\n\tif (text.length <= maxLength) return text;\n\tif (maxLength <= 3) return text.slice(0, maxLength);\n\treturn `${text.slice(0, maxLength - 3).trimEnd()}...`;\n}\n\n/** Normalize and bound a provider-controlled single-line text field. */\nexport function boundSingleLineText(value: unknown, maxLength: number): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tconst normalized = value.replace(/\\s+/g, \" \").trim();\n\treturn normalized ? truncateText(normalized, maxLength) : undefined;\n}\n\n/** Trim and bound provider-controlled text that intentionally preserves lines. */\nexport function boundMultilineText(value: unknown, maxLength: number): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tconst normalized = value.trim();\n\treturn normalized ? truncateText(normalized, maxLength) : undefined;\n}\n\n/** Normalize a usable HTTP(S) source URL without changing non-tracking query values. */\nexport function normalizeUrl(rawUrl: unknown): string | undefined {\n\tif (typeof rawUrl !== \"string\") return undefined;\n\tconst trimmed = rawUrl.trim();\n\tif (!trimmed || trimmed.length > MAX_URL_LENGTH) return undefined;\n\n\ttry {\n\t\tconst url = new URL(trimmed);\n\t\tif (url.protocol !== \"http:\" && url.protocol !== \"https:\") return undefined;\n\t\turl.hash = \"\";\n\t\tfor (const parameter of TRACKING_PARAMS) {\n\t\t\tif (url.searchParams.has(parameter)) url.searchParams.delete(parameter);\n\t\t}\n\t\tif (url.pathname.length > 1 && url.pathname.endsWith(\"/\")) {\n\t\t\turl.pathname = url.pathname.replace(/\\/+$/, \"\");\n\t\t}\n\t\tconst normalized = url.toString();\n\t\treturn normalized.length <= MAX_URL_LENGTH ? normalized : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction normalizeHit(hit: ProviderSearchHit): ProviderSearchHit | undefined {\n\tconst url = normalizeUrl(hit.url);\n\tif (!url) return undefined;\n\n\treturn {\n\t\ttitle: boundSingleLineText(hit.title, MAX_TITLE_LENGTH) ?? url,\n\t\turl,\n\t\tsnippet: boundSingleLineText(hit.snippet, MAX_SNIPPET_LENGTH),\n\t\tdate: boundSingleLineText(hit.date, MAX_DATE_LENGTH),\n\t};\n}\n\nfunction isUrlFallbackTitle(title: string, url: string): boolean {\n\tconst normalizedTitle = normalizeUrl(title);\n\treturn normalizedTitle !== undefined && normalizedTitle === normalizeUrl(url);\n}\n\nfunction reciprocalRankScore(candidate: FusionCandidate): number {\n\tlet score = 0;\n\tfor (const rank of candidate.ranks.values()) score += 1 / (RRF_K + rank);\n\treturn score;\n}\n\nfunction bestRank(candidate: FusionCandidate): number {\n\treturn Math.min(...candidate.ranks.values());\n}\n\n/** Bound provider results, deduplicate URLs, and rank them with reciprocal-rank fusion. */\nexport function fuseSearchHits(results: ProviderSearchResult[]): FusedSearchResults {\n\tconst candidates = new Map<string, FusionCandidate>();\n\tconst relatedSearches = new Set<string>();\n\tlet deepseekSynthesis: string | undefined;\n\n\tfor (const result of results) {\n\t\tconst providerRelated = Array.isArray(result.relatedSearches) ? result.relatedSearches : [];\n\t\tconst relatedScanLimit = Math.min(providerRelated.length, MAX_PROVIDER_RELATED_SCAN);\n\t\tfor (let index = 0; index < relatedScanLimit && relatedSearches.size < MAX_RELATED_SEARCHES; index++) {\n\t\t\tconst normalized = boundSingleLineText(providerRelated[index], MAX_RELATED_SEARCH_LENGTH);\n\t\t\tif (normalized) relatedSearches.add(normalized);\n\t\t}\n\t\tconst synthesis = boundMultilineText(result.synthesisText, MAX_SYNTHESIS_LENGTH);\n\t\tif (synthesis) deepseekSynthesis = synthesis;\n\n\t\tconst providerHits = Array.isArray(result.hits) ? result.hits : [];\n\t\tconst hitScanLimit = Math.min(providerHits.length, MAX_PROVIDER_HIT_SCAN);\n\t\tfor (let index = 0; index < hitScanLimit; index++) {\n\t\t\tconst rawHit = providerHits[index];\n\t\t\tif (!rawHit) continue;\n\t\t\tconst hit = normalizeHit(rawHit);\n\t\t\tif (!hit) continue;\n\t\t\tconst rank = index + 1;\n\t\t\tconst existing = candidates.get(hit.url);\n\n\t\t\tif (!existing) {\n\t\t\t\tcandidates.set(hit.url, { hit, ranks: new Map([[result.source, rank]]) });\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst previousRank = existing.ranks.get(result.source);\n\t\t\tif (previousRank === undefined || rank < previousRank) existing.ranks.set(result.source, rank);\n\t\t\tif (isUrlFallbackTitle(existing.hit.title, existing.hit.url) && !isUrlFallbackTitle(hit.title, hit.url)) {\n\t\t\t\texisting.hit.title = hit.title;\n\t\t\t}\n\t\t\tif ((!existing.hit.snippet || existing.hit.snippet.length < (hit.snippet?.length ?? 0)) && hit.snippet) {\n\t\t\t\texisting.hit.snippet = hit.snippet;\n\t\t\t}\n\t\t\tif (!existing.hit.date && hit.date) existing.hit.date = hit.date;\n\t\t}\n\t}\n\n\tconst ranked = [...candidates.entries()]\n\t\t.sort(([leftUrl, left], [rightUrl, right]) => {\n\t\t\tconst scoreDifference = reciprocalRankScore(right) - reciprocalRankScore(left);\n\t\t\tif (scoreDifference !== 0) return scoreDifference;\n\t\t\tconst rankDifference = bestRank(left) - bestRank(right);\n\t\t\tif (rankDifference !== 0) return rankDifference;\n\t\t\treturn leftUrl.localeCompare(rightUrl);\n\t\t})\n\t\t.map(([, candidate]) => ({ ...candidate.hit, sources: [...candidate.ranks.keys()] }))\n\t\t.slice(0, MAX_OUTPUT_HITS);\n\n\treturn {\n\t\thits: ranked,\n\t\trelatedSearches: relatedSearches.size > 0 ? [...relatedSearches] : undefined,\n\t\tdeepseekSynthesis,\n\t};\n}\n"]}

package/dist/extensions/web-search/schema.d.ts

@@ -1,10 +0,0 @@
-/**
- * schema.ts — TypeBox parameter schema and argument normalizer for web_search.
- */
-import { type Static, Type } from "typebox";
-export declare const WebSearchParamsSchema: Type.TObject<{
-    query: Type.TString;
-}>;
-export type WebSearchParams = Static<typeof WebSearchParamsSchema>;
-export declare function normalizeWebSearchParams(raw: unknown): WebSearchParams;
-//# sourceMappingURL=schema.d.ts.map

package/dist/extensions/web-search/schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/extensions/web-search/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG5C,eAAO,MAAM,qBAAqB;;EAMhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAuBtE"}

package/dist/extensions/web-search/schema.js

@@ -1,36 +0,0 @@
-/**
- * schema.ts — TypeBox parameter schema and argument normalizer for web_search.
- */
-import { Type } from "typebox";
-import { MAX_QUERY_LENGTH } from "./results.js";
-export const WebSearchParamsSchema = Type.Object({
-    query: Type.String({
-        minLength: 1,
-        maxLength: MAX_QUERY_LENGTH,
-        description: "The search query. Aim for 3-5 keywords; include a year when freshness matters.",
-    }),
-});
-export function normalizeWebSearchParams(raw) {
-    if (typeof raw === "string") {
-        return { query: raw.trim() };
-    }
-    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-        return { query: String(raw ?? "").trim() };
-    }
-    const record = raw;
-    let query = "";
-    if (typeof record.query === "string") {
-        query = record.query.trim();
-    }
-    else if (typeof record.q === "string") {
-        query = record.q.trim();
-    }
-    else if (typeof record.search_query === "string") {
-        query = record.search_query.trim();
-    }
-    else if (typeof record.prompt === "string") {
-        query = record.prompt.trim();
-    }
-    return { query };
-}
-//# sourceMappingURL=schema.js.map

package/dist/extensions/web-search/schema.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/extensions/web-search/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,gBAAgB;QAC3B,WAAW,EAAE,gFAAgF;KAC7F,CAAC;CACF,CAAC,CAAC;AAIH,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACpD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,MAAM,GAAG,GAA8B,CAAC;IAE9C,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACpD,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9C,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AAClB,CAAC","sourcesContent":["/**\n * schema.ts — TypeBox parameter schema and argument normalizer for web_search.\n */\n\nimport { type Static, Type } from \"typebox\";\nimport { MAX_QUERY_LENGTH } from \"./results.ts\";\n\nexport const WebSearchParamsSchema = Type.Object({\n\tquery: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: MAX_QUERY_LENGTH,\n\t\tdescription: \"The search query. Aim for 3-5 keywords; include a year when freshness matters.\",\n\t}),\n});\n\nexport type WebSearchParams = Static<typeof WebSearchParamsSchema>;\n\nexport function normalizeWebSearchParams(raw: unknown): WebSearchParams {\n\tif (typeof raw === \"string\") {\n\t\treturn { query: raw.trim() };\n\t}\n\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n\t\treturn { query: String(raw ?? \"\").trim() };\n\t}\n\n\tconst record = raw as Record<string, unknown>;\n\n\tlet query = \"\";\n\tif (typeof record.query === \"string\") {\n\t\tquery = record.query.trim();\n\t} else if (typeof record.q === \"string\") {\n\t\tquery = record.q.trim();\n\t} else if (typeof record.search_query === \"string\") {\n\t\tquery = record.search_query.trim();\n\t} else if (typeof record.prompt === \"string\") {\n\t\tquery = record.prompt.trim();\n\t}\n\n\treturn { query };\n}\n"]}

package/dist/extensions/web-search/types.d.ts

@@ -1,51 +0,0 @@
-/**
- * types.ts — Type definitions for web_search extension providers and fusion engine.
- */
-export type SearchEngineType = "minimax" | "deepseek" | "dual" | "none";
-export type SearchEngineSource = "MiniMax" | "DeepSeek";
-export interface ProviderSearchHit {
-    title: string;
-    url: string;
-    snippet?: string;
-    date?: string;
-}
-export interface WebSearchHit extends ProviderSearchHit {
-    sources: SearchEngineSource[];
-}
-export interface WebSearchDetails {
-    query: string;
-    durationMs: number;
-    status: "success" | "error" | "disabled";
-    engine: SearchEngineType;
-    totalHits: number;
-    hits: WebSearchHit[];
-    relatedSearches?: string[];
-    deepseekSynthesis?: string;
-    errorMessage?: string;
-}
-/**
- * MiniMax search credential. `host` is always present alongside `key` so
- * callers never guard the two separately.
- */
-export interface MiniMaxSearchCredential {
-    key: string;
-    host: string;
-}
-/**
- * Resolved credentials: presence of a group means that engine is configured,
- * so impossible states (mode without key, key without host) are unrepresentable.
- * Use `configuredEngine()` from auth.ts to derive the SearchEngineType label.
- */
-export interface ResolvedSearchCredentials {
-    minimax?: MiniMaxSearchCredential;
-    deepseek?: {
-        key: string;
-    };
-}
-export interface ProviderSearchResult {
-    source: SearchEngineSource;
-    hits: ProviderSearchHit[];
-    relatedSearches?: string[];
-    synthesisText?: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/extensions/web-search/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extensions/web-search/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,CAAC;AAExD,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACtD,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACzC,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACzC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/extensions/web-search/types.js

@@ -1,5 +0,0 @@
-/**
- * types.ts — Type definitions for web_search extension providers and fusion engine.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/extensions/web-search/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extensions/web-search/types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * types.ts — Type definitions for web_search extension providers and fusion engine.\n */\n\nexport type SearchEngineType = \"minimax\" | \"deepseek\" | \"dual\" | \"none\";\nexport type SearchEngineSource = \"MiniMax\" | \"DeepSeek\";\n\nexport interface ProviderSearchHit {\n\ttitle: string;\n\turl: string;\n\tsnippet?: string;\n\tdate?: string;\n}\n\nexport interface WebSearchHit extends ProviderSearchHit {\n\tsources: SearchEngineSource[];\n}\n\nexport interface WebSearchDetails {\n\tquery: string;\n\tdurationMs: number;\n\tstatus: \"success\" | \"error\" | \"disabled\";\n\tengine: SearchEngineType;\n\ttotalHits: number;\n\thits: WebSearchHit[];\n\trelatedSearches?: string[];\n\tdeepseekSynthesis?: string;\n\terrorMessage?: string;\n}\n\n/**\n * MiniMax search credential. `host` is always present alongside `key` so\n * callers never guard the two separately.\n */\nexport interface MiniMaxSearchCredential {\n\tkey: string;\n\thost: string;\n}\n\n/**\n * Resolved credentials: presence of a group means that engine is configured,\n * so impossible states (mode without key, key without host) are unrepresentable.\n * Use `configuredEngine()` from auth.ts to derive the SearchEngineType label.\n */\nexport interface ResolvedSearchCredentials {\n\tminimax?: MiniMaxSearchCredential;\n\tdeepseek?: { key: string };\n}\n\nexport interface ProviderSearchResult {\n\tsource: SearchEngineSource;\n\thits: ProviderSearchHit[];\n\trelatedSearches?: string[];\n\tsynthesisText?: string;\n}\n"]}

package/dist/modes/interactive/theme/theme-json.d.ts

@@ -1,85 +0,0 @@
-/**
- * Theme JSON validation, kept out of `theme.ts` on purpose.
- *
- * Validating user-authored theme files needs typebox, which costs ~17 MB of module graph to import.
- * Palette lookup does not, so a presentation that only uses built-in themes should never pay for it.
- * `interactive-mode.ts` installs this validator; anything that does not simply skips validation, as
- * built-in themes already do.
- */
-import { type Static, Type } from "typebox";
-declare const ColorValueSchema: Type.TUnion<[Type.TString, Type.TInteger]>;
-declare const ThemeJsonSchema: Type.TObject<{
-    $schema: Type.TOptional<Type.TString>;
-    name: Type.TString;
-    appearance: Type.TOptional<Type.TUnion<[Type.TLiteral<"dark">, Type.TLiteral<"light">]>>;
-    vars: Type.TOptional<Type.TRecord<"^.*$", Type.TUnion<[Type.TString, Type.TInteger]>>>;
-    colors: Type.TObject<{
-        accent: Type.TUnion<[Type.TString, Type.TInteger]>;
-        border: Type.TUnion<[Type.TString, Type.TInteger]>;
-        borderAccent: Type.TUnion<[Type.TString, Type.TInteger]>;
-        borderMuted: Type.TUnion<[Type.TString, Type.TInteger]>;
-        success: Type.TUnion<[Type.TString, Type.TInteger]>;
-        error: Type.TUnion<[Type.TString, Type.TInteger]>;
-        warning: Type.TUnion<[Type.TString, Type.TInteger]>;
-        muted: Type.TUnion<[Type.TString, Type.TInteger]>;
-        dim: Type.TUnion<[Type.TString, Type.TInteger]>;
-        text: Type.TUnion<[Type.TString, Type.TInteger]>;
-        thinkingText: Type.TUnion<[Type.TString, Type.TInteger]>;
-        scrollbarTrack: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
-        scrollbarThumb: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
-        selectedBg: Type.TUnion<[Type.TString, Type.TInteger]>;
-        searchMatchBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
-        searchMatchText: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
-        userMessageBg: Type.TUnion<[Type.TString, Type.TInteger]>;
-        userMessageText: Type.TUnion<[Type.TString, Type.TInteger]>;
-        customMessageBg: Type.TUnion<[Type.TString, Type.TInteger]>;
-        customMessageText: Type.TUnion<[Type.TString, Type.TInteger]>;
-        customMessageLabel: Type.TUnion<[Type.TString, Type.TInteger]>;
-        toolPendingBg: Type.TUnion<[Type.TString, Type.TInteger]>;
-        toolSuccessBg: Type.TUnion<[Type.TString, Type.TInteger]>;
-        toolErrorBg: Type.TUnion<[Type.TString, Type.TInteger]>;
-        toolTitle: Type.TUnion<[Type.TString, Type.TInteger]>;
-        toolOutput: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdHeading: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdLink: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdLinkUrl: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdCode: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdCodeBlock: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdCodeBlockBorder: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdQuote: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdQuoteBorder: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdHr: Type.TUnion<[Type.TString, Type.TInteger]>;
-        mdListBullet: Type.TUnion<[Type.TString, Type.TInteger]>;
-        toolDiffAdded: Type.TUnion<[Type.TString, Type.TInteger]>;
-        toolDiffRemoved: Type.TUnion<[Type.TString, Type.TInteger]>;
-        toolDiffContext: Type.TUnion<[Type.TString, Type.TInteger]>;
-        syntaxComment: Type.TUnion<[Type.TString, Type.TInteger]>;
-        syntaxKeyword: Type.TUnion<[Type.TString, Type.TInteger]>;
-        syntaxFunction: Type.TUnion<[Type.TString, Type.TInteger]>;
-        syntaxVariable: Type.TUnion<[Type.TString, Type.TInteger]>;
-        syntaxString: Type.TUnion<[Type.TString, Type.TInteger]>;
-        syntaxNumber: Type.TUnion<[Type.TString, Type.TInteger]>;
-        syntaxType: Type.TUnion<[Type.TString, Type.TInteger]>;
-        syntaxOperator: Type.TUnion<[Type.TString, Type.TInteger]>;
-        syntaxPunctuation: Type.TUnion<[Type.TString, Type.TInteger]>;
-        thinkingOff: Type.TUnion<[Type.TString, Type.TInteger]>;
-        thinkingMinimal: Type.TUnion<[Type.TString, Type.TInteger]>;
-        thinkingLow: Type.TUnion<[Type.TString, Type.TInteger]>;
-        thinkingMedium: Type.TUnion<[Type.TString, Type.TInteger]>;
-        thinkingHigh: Type.TUnion<[Type.TString, Type.TInteger]>;
-        thinkingXhigh: Type.TUnion<[Type.TString, Type.TInteger]>;
-        thinkingMax: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
-        bashMode: Type.TUnion<[Type.TString, Type.TInteger]>;
-    }>;
-    export: Type.TOptional<Type.TObject<{
-        pageBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
-        cardBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
-        infoBg: Type.TOptional<Type.TUnion<[Type.TString, Type.TInteger]>>;
-    }>>;
-}>;
-export type ThemeColorValue = Static<typeof ColorValueSchema>;
-export type ValidatedThemeJson = Static<typeof ThemeJsonSchema>;
-/** Validate one theme document, throwing a message that names the offending tokens. */
-export declare function validateThemeJson(label: string, json: unknown): ValidatedThemeJson;
-export {};
-//# sourceMappingURL=theme-json.d.ts.map

package/dist/modes/interactive/theme/theme-json.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"theme-json.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/theme/theme-json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG5C,QAAA,MAAM,gBAAgB,4CAGpB,CAAC;AAEH,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+EnB,CAAC;AAIH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAEhE,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,kBAAkB,CA2ClF"}

package/dist/modes/interactive/theme/theme-json.js

@@ -1,132 +0,0 @@
-/**
- * Theme JSON validation, kept out of `theme.ts` on purpose.
- *
- * Validating user-authored theme files needs typebox, which costs ~17 MB of module graph to import.
- * Palette lookup does not, so a presentation that only uses built-in themes should never pay for it.
- * `interactive-mode.ts` installs this validator; anything that does not simply skips validation, as
- * built-in themes already do.
- */
-import { Type } from "typebox";
-import { Compile } from "typebox/compile";
-const ColorValueSchema = Type.Union([
-    Type.String(), // hex, OKLCH, OKHSL, var ref "primary", or empty ""
-    Type.Integer({ minimum: 0, maximum: 255 }), // 256-color index
-]);
-const ThemeJsonSchema = Type.Object({
-    $schema: Type.Optional(Type.String()),
-    name: Type.String(),
-    // Background the theme is designed for. Detected from the theme colors when omitted.
-    appearance: Type.Optional(Type.Union([Type.Literal("dark"), Type.Literal("light")])),
-    vars: Type.Optional(Type.Record(Type.String(), ColorValueSchema)),
-    colors: Type.Object({
-        // Core UI (11 colors)
-        accent: ColorValueSchema,
-        border: ColorValueSchema,
-        borderAccent: ColorValueSchema,
-        borderMuted: ColorValueSchema,
-        success: ColorValueSchema,
-        error: ColorValueSchema,
-        warning: ColorValueSchema,
-        muted: ColorValueSchema,
-        dim: ColorValueSchema,
-        text: ColorValueSchema,
-        thinkingText: ColorValueSchema,
-        // Scrollbar (2 optional colors)
-        scrollbarTrack: Type.Optional(ColorValueSchema),
-        scrollbarThumb: Type.Optional(ColorValueSchema),
-        // Backgrounds & Content Text (11 required, 2 optional)
-        selectedBg: ColorValueSchema,
-        searchMatchBg: Type.Optional(ColorValueSchema),
-        searchMatchText: Type.Optional(ColorValueSchema),
-        userMessageBg: ColorValueSchema,
-        userMessageText: ColorValueSchema,
-        customMessageBg: ColorValueSchema,
-        customMessageText: ColorValueSchema,
-        customMessageLabel: ColorValueSchema,
-        toolPendingBg: ColorValueSchema,
-        toolSuccessBg: ColorValueSchema,
-        toolErrorBg: ColorValueSchema,
-        toolTitle: ColorValueSchema,
-        toolOutput: ColorValueSchema,
-        // Markdown (10 colors)
-        mdHeading: ColorValueSchema,
-        mdLink: ColorValueSchema,
-        mdLinkUrl: ColorValueSchema,
-        mdCode: ColorValueSchema,
-        mdCodeBlock: ColorValueSchema,
-        mdCodeBlockBorder: ColorValueSchema,
-        mdQuote: ColorValueSchema,
-        mdQuoteBorder: ColorValueSchema,
-        mdHr: ColorValueSchema,
-        mdListBullet: ColorValueSchema,
-        // Tool Diffs (3 colors)
-        toolDiffAdded: ColorValueSchema,
-        toolDiffRemoved: ColorValueSchema,
-        toolDiffContext: ColorValueSchema,
-        // Syntax Highlighting (9 colors)
-        syntaxComment: ColorValueSchema,
-        syntaxKeyword: ColorValueSchema,
-        syntaxFunction: ColorValueSchema,
-        syntaxVariable: ColorValueSchema,
-        syntaxString: ColorValueSchema,
-        syntaxNumber: ColorValueSchema,
-        syntaxType: ColorValueSchema,
-        syntaxOperator: ColorValueSchema,
-        syntaxPunctuation: ColorValueSchema,
-        // Thinking Level Borders (6 colors)
-        thinkingOff: ColorValueSchema,
-        thinkingMinimal: ColorValueSchema,
-        thinkingLow: ColorValueSchema,
-        thinkingMedium: ColorValueSchema,
-        thinkingHigh: ColorValueSchema,
-        thinkingXhigh: ColorValueSchema,
-        thinkingMax: Type.Optional(ColorValueSchema),
-        // Bash Mode (1 color)
-        bashMode: ColorValueSchema,
-    }),
-    export: Type.Optional(Type.Object({
-        pageBg: Type.Optional(ColorValueSchema),
-        cardBg: Type.Optional(ColorValueSchema),
-        infoBg: Type.Optional(ColorValueSchema),
-    })),
-});
-const compiledThemeSchema = Compile(ThemeJsonSchema);
-/** Validate one theme document, throwing a message that names the offending tokens. */
-export function validateThemeJson(label, json) {
-    if (!compiledThemeSchema.Check(json)) {
-        const errors = Array.from(compiledThemeSchema.Errors(json));
-        const missingColors = new Set();
-        const otherErrors = [];
-        for (const error of errors) {
-            if (error.keyword === "required" && error.instancePath === "/colors") {
-                const requiredProperties = error.params.requiredProperties;
-                for (const requiredProperty of requiredProperties ?? []) {
-                    missingColors.add(requiredProperty);
-                }
-                continue;
-            }
-            const path = error.instancePath || "/";
-            otherErrors.push(`  - ${path}: ${error.message}`);
-        }
-        let errorMessage = `Invalid theme "${label}":\n`;
-        if (missingColors.size > 0) {
-            errorMessage += "\nMissing required color tokens:\n";
-            errorMessage += Array.from(missingColors)
-                .sort()
-                .map((color) => `  - ${color}`)
-                .join("\n");
-            errorMessage += '\n\nPlease add these colors to your theme\'s "colors" object.';
-            errorMessage += "\nSee the built-in themes (dark.json, light.json) for reference values.";
-        }
-        if (otherErrors.length > 0) {
-            errorMessage += `\n\nOther errors:\n${otherErrors.join("\n")}`;
-        }
-        throw new Error(errorMessage);
-    }
-    const themeJson = json;
-    if (themeJson.name.includes("/")) {
-        throw new Error(`Invalid theme name "${themeJson.name}": theme names cannot contain "/" because it is reserved for automatic light/dark theme settings.`);
-    }
-    return themeJson;
-}
-//# sourceMappingURL=theme-json.js.map

package/dist/modes/interactive/theme/theme-json.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"theme-json.js","sourceRoot":"","sources":["../../../../src/modes/interactive/theme/theme-json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,EAAE,oDAAoD;IACnE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,kBAAkB;CAC9D,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACrC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;IACnB,qFAAqF;IACrF,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpF,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACjE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QACnB,sBAAsB;QACtB,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE,gBAAgB;QACxB,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,gBAAgB;QACzB,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,gBAAgB;QACzB,KAAK,EAAE,gBAAgB;QACvB,GAAG,EAAE,gBAAgB;QACrB,IAAI,EAAE,gBAAgB;QACtB,YAAY,EAAE,gBAAgB;QAC9B,gCAAgC;QAChC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC/C,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC/C,uDAAuD;QACvD,UAAU,EAAE,gBAAgB;QAC5B,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC9C,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAChD,aAAa,EAAE,gBAAgB;QAC/B,eAAe,EAAE,gBAAgB;QACjC,eAAe,EAAE,gBAAgB;QACjC,iBAAiB,EAAE,gBAAgB;QACnC,kBAAkB,EAAE,gBAAgB;QACpC,aAAa,EAAE,gBAAgB;QAC/B,aAAa,EAAE,gBAAgB;QAC/B,WAAW,EAAE,gBAAgB;QAC7B,SAAS,EAAE,gBAAgB;QAC3B,UAAU,EAAE,gBAAgB;QAC5B,uBAAuB;QACvB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,gBAAgB;QACxB,SAAS,EAAE,gBAAgB;QAC3B,MAAM,EAAE,gBAAgB;QACxB,WAAW,EAAE,gBAAgB;QAC7B,iBAAiB,EAAE,gBAAgB;QACnC,OAAO,EAAE,gBAAgB;QACzB,aAAa,EAAE,gBAAgB;QAC/B,IAAI,EAAE,gBAAgB;QACtB,YAAY,EAAE,gBAAgB;QAC9B,wBAAwB;QACxB,aAAa,EAAE,gBAAgB;QAC/B,eAAe,EAAE,gBAAgB;QACjC,eAAe,EAAE,gBAAgB;QACjC,iCAAiC;QACjC,aAAa,EAAE,gBAAgB;QAC/B,aAAa,EAAE,gBAAgB;QAC/B,cAAc,EAAE,gBAAgB;QAChC,cAAc,EAAE,gBAAgB;QAChC,YAAY,EAAE,gBAAgB;QAC9B,YAAY,EAAE,gBAAgB;QAC9B,UAAU,EAAE,gBAAgB;QAC5B,cAAc,EAAE,gBAAgB;QAChC,iBAAiB,EAAE,gBAAgB;QACnC,oCAAoC;QACpC,WAAW,EAAE,gBAAgB;QAC7B,eAAe,EAAE,gBAAgB;QACjC,WAAW,EAAE,gBAAgB;QAC7B,cAAc,EAAE,gBAAgB;QAChC,YAAY,EAAE,gBAAgB;QAC9B,aAAa,EAAE,gBAAgB;QAC/B,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC5C,sBAAsB;QACtB,QAAQ,EAAE,gBAAgB;KAC1B,CAAC;IACF,MAAM,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC;QACX,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACvC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACvC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;KACvC,CAAC,CACF;CACD,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAKrD,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,IAAa;IAC7D,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QACxC,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACtE,MAAM,kBAAkB,GAAI,KAAK,CAAC,MAA4C,CAAC,kBAAkB,CAAC;gBAClG,KAAK,MAAM,gBAAgB,IAAI,kBAAkB,IAAI,EAAE,EAAE,CAAC;oBACzD,aAAa,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;gBACrC,CAAC;gBACD,SAAS;YACV,CAAC;YAED,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,IAAI,GAAG,CAAC;YACvC,WAAW,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,YAAY,GAAG,kBAAkB,KAAK,MAAM,CAAC;QACjD,IAAI,aAAa,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC5B,YAAY,IAAI,oCAAoC,CAAC;YACrD,YAAY,IAAI,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC;iBACvC,IAAI,EAAE;iBACN,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC;iBAC9B,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,YAAY,IAAI,+DAA+D,CAAC;YAChF,YAAY,IAAI,yEAAyE,CAAC;QAC3F,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,YAAY,IAAI,sBAAsB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,SAAS,GAAG,IAA0B,CAAC;IAC7C,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACd,uBAAuB,SAAS,CAAC,IAAI,mGAAmG,CACxI,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Theme JSON validation, kept out of `theme.ts` on purpose.\n *\n * Validating user-authored theme files needs typebox, which costs ~17 MB of module graph to import.\n * Palette lookup does not, so a presentation that only uses built-in themes should never pay for it.\n * `interactive-mode.ts` installs this validator; anything that does not simply skips validation, as\n * built-in themes already do.\n */\n\nimport { type Static, Type } from \"typebox\";\nimport { Compile } from \"typebox/compile\";\n\nconst ColorValueSchema = Type.Union([\n\tType.String(), // hex, OKLCH, OKHSL, var ref \"primary\", or empty \"\"\n\tType.Integer({ minimum: 0, maximum: 255 }), // 256-color index\n]);\n\nconst ThemeJsonSchema = Type.Object({\n\t$schema: Type.Optional(Type.String()),\n\tname: Type.String(),\n\t// Background the theme is designed for. Detected from the theme colors when omitted.\n\tappearance: Type.Optional(Type.Union([Type.Literal(\"dark\"), Type.Literal(\"light\")])),\n\tvars: Type.Optional(Type.Record(Type.String(), ColorValueSchema)),\n\tcolors: Type.Object({\n\t\t// Core UI (11 colors)\n\t\taccent: ColorValueSchema,\n\t\tborder: ColorValueSchema,\n\t\tborderAccent: ColorValueSchema,\n\t\tborderMuted: ColorValueSchema,\n\t\tsuccess: ColorValueSchema,\n\t\terror: ColorValueSchema,\n\t\twarning: ColorValueSchema,\n\t\tmuted: ColorValueSchema,\n\t\tdim: ColorValueSchema,\n\t\ttext: ColorValueSchema,\n\t\tthinkingText: ColorValueSchema,\n\t\t// Scrollbar (2 optional colors)\n\t\tscrollbarTrack: Type.Optional(ColorValueSchema),\n\t\tscrollbarThumb: Type.Optional(ColorValueSchema),\n\t\t// Backgrounds & Content Text (11 required, 2 optional)\n\t\tselectedBg: ColorValueSchema,\n\t\tsearchMatchBg: Type.Optional(ColorValueSchema),\n\t\tsearchMatchText: Type.Optional(ColorValueSchema),\n\t\tuserMessageBg: ColorValueSchema,\n\t\tuserMessageText: ColorValueSchema,\n\t\tcustomMessageBg: ColorValueSchema,\n\t\tcustomMessageText: ColorValueSchema,\n\t\tcustomMessageLabel: ColorValueSchema,\n\t\ttoolPendingBg: ColorValueSchema,\n\t\ttoolSuccessBg: ColorValueSchema,\n\t\ttoolErrorBg: ColorValueSchema,\n\t\ttoolTitle: ColorValueSchema,\n\t\ttoolOutput: ColorValueSchema,\n\t\t// Markdown (10 colors)\n\t\tmdHeading: ColorValueSchema,\n\t\tmdLink: ColorValueSchema,\n\t\tmdLinkUrl: ColorValueSchema,\n\t\tmdCode: ColorValueSchema,\n\t\tmdCodeBlock: ColorValueSchema,\n\t\tmdCodeBlockBorder: ColorValueSchema,\n\t\tmdQuote: ColorValueSchema,\n\t\tmdQuoteBorder: ColorValueSchema,\n\t\tmdHr: ColorValueSchema,\n\t\tmdListBullet: ColorValueSchema,\n\t\t// Tool Diffs (3 colors)\n\t\ttoolDiffAdded: ColorValueSchema,\n\t\ttoolDiffRemoved: ColorValueSchema,\n\t\ttoolDiffContext: ColorValueSchema,\n\t\t// Syntax Highlighting (9 colors)\n\t\tsyntaxComment: ColorValueSchema,\n\t\tsyntaxKeyword: ColorValueSchema,\n\t\tsyntaxFunction: ColorValueSchema,\n\t\tsyntaxVariable: ColorValueSchema,\n\t\tsyntaxString: ColorValueSchema,\n\t\tsyntaxNumber: ColorValueSchema,\n\t\tsyntaxType: ColorValueSchema,\n\t\tsyntaxOperator: ColorValueSchema,\n\t\tsyntaxPunctuation: ColorValueSchema,\n\t\t// Thinking Level Borders (6 colors)\n\t\tthinkingOff: ColorValueSchema,\n\t\tthinkingMinimal: ColorValueSchema,\n\t\tthinkingLow: ColorValueSchema,\n\t\tthinkingMedium: ColorValueSchema,\n\t\tthinkingHigh: ColorValueSchema,\n\t\tthinkingXhigh: ColorValueSchema,\n\t\tthinkingMax: Type.Optional(ColorValueSchema),\n\t\t// Bash Mode (1 color)\n\t\tbashMode: ColorValueSchema,\n\t}),\n\texport: Type.Optional(\n\t\tType.Object({\n\t\t\tpageBg: Type.Optional(ColorValueSchema),\n\t\t\tcardBg: Type.Optional(ColorValueSchema),\n\t\t\tinfoBg: Type.Optional(ColorValueSchema),\n\t\t}),\n\t),\n});\n\nconst compiledThemeSchema = Compile(ThemeJsonSchema);\n\nexport type ThemeColorValue = Static<typeof ColorValueSchema>;\nexport type ValidatedThemeJson = Static<typeof ThemeJsonSchema>;\n\n/** Validate one theme document, throwing a message that names the offending tokens. */\nexport function validateThemeJson(label: string, json: unknown): ValidatedThemeJson {\n\tif (!compiledThemeSchema.Check(json)) {\n\t\tconst errors = Array.from(compiledThemeSchema.Errors(json));\n\t\tconst missingColors = new Set<string>();\n\t\tconst otherErrors: string[] = [];\n\n\t\tfor (const error of errors) {\n\t\t\tif (error.keyword === \"required\" && error.instancePath === \"/colors\") {\n\t\t\t\tconst requiredProperties = (error.params as { requiredProperties?: string[] }).requiredProperties;\n\t\t\t\tfor (const requiredProperty of requiredProperties ?? []) {\n\t\t\t\t\tmissingColors.add(requiredProperty);\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst path = error.instancePath || \"/\";\n\t\t\totherErrors.push(`  - ${path}: ${error.message}`);\n\t\t}\n\n\t\tlet errorMessage = `Invalid theme \"${label}\":\\n`;\n\t\tif (missingColors.size > 0) {\n\t\t\terrorMessage += \"\\nMissing required color tokens:\\n\";\n\t\t\terrorMessage += Array.from(missingColors)\n\t\t\t\t.sort()\n\t\t\t\t.map((color) => `  - ${color}`)\n\t\t\t\t.join(\"\\n\");\n\t\t\terrorMessage += '\\n\\nPlease add these colors to your theme\\'s \"colors\" object.';\n\t\t\terrorMessage += \"\\nSee the built-in themes (dark.json, light.json) for reference values.\";\n\t\t}\n\t\tif (otherErrors.length > 0) {\n\t\t\terrorMessage += `\\n\\nOther errors:\\n${otherErrors.join(\"\\n\")}`;\n\t\t}\n\n\t\tthrow new Error(errorMessage);\n\t}\n\n\tconst themeJson = json as ValidatedThemeJson;\n\tif (themeJson.name.includes(\"/\")) {\n\t\tthrow new Error(\n\t\t\t`Invalid theme name \"${themeJson.name}\": theme names cannot contain \"/\" because it is reserved for automatic light/dark theme settings.`,\n\t\t);\n\t}\n\treturn themeJson;\n}\n"]}