@copilotkit/web-inspector 1.77.0 → 1.77.1

package/dist/lib/hud-config.cjs

@@ -0,0 +1,93 @@
+let semver = require("semver");
+
+//#region src/lib/hud-config.ts
+const HUD_FEATURE_IDS = ["threads", "learning"];
+const HUD_LABEL_MAX_LENGTH = 32;
+const HUD_DESCRIPTION_MAX_LENGTH = 140;
+const frameworkPattern = /^[a-z][a-z0-9-]{0,31}$/;
+const featureIdPattern = /^[a-z][a-z0-9-]{0,31}$/;
+const destinationPattern = /^[a-z][a-z0-9-]{0,63}$/;
+const controlCharacters = /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/;
+function record(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function onlyKeys(value, keys) {
+	return Object.keys(value).every((key) => keys.includes(key));
+}
+function text(value, max) {
+	return typeof value === "string" && value.trim().length > 0 && value.length <= max && !controlCharacters.test(value);
+}
+function parseFeature(value) {
+	if (!record(value) || !Object.keys(value).length || !onlyKeys(value, [
+		"label",
+		"description",
+		"destination"
+	])) return null;
+	if (value.label !== void 0 && !text(value.label, HUD_LABEL_MAX_LENGTH)) return null;
+	if (value.description !== void 0 && !text(value.description, HUD_DESCRIPTION_MAX_LENGTH)) return null;
+	if (value.destination !== void 0 && (typeof value.destination !== "string" || !destinationPattern.test(value.destination))) return null;
+	return {
+		...value.label === void 0 ? {} : { label: value.label },
+		...value.description === void 0 ? {} : { description: value.description },
+		...value.destination === void 0 ? {} : { destination: value.destination }
+	};
+}
+function parseRule(value) {
+	if (!record(value) || !onlyKeys(value, [
+		"framework",
+		"sdkVersion",
+		"features"
+	]) || typeof value.framework !== "string" || !frameworkPattern.test(value.framework) || !text(value.sdkVersion, 256) || (0, semver.validRange)(value.sdkVersion) === null || !record(value.features) || !Object.keys(value.features).length) return null;
+	const features = {};
+	for (const [id, entry] of Object.entries(value.features)) {
+		if (!featureIdPattern.test(id)) return null;
+		const feature = parseFeature(entry);
+		if (!feature) return null;
+		features[id] = feature;
+	}
+	return {
+		framework: value.framework,
+		sdkVersion: value.sdkVersion,
+		features
+	};
+}
+/** Parse the public envelope. Any invalid entry rejects the whole feed. */
+function parseHudFeed(value) {
+	if (!record(value) || !onlyKeys(value, ["schemaVersion", "rules"]) || value.schemaVersion !== 1 || !Array.isArray(value.rules) || value.rules.length > 100) return null;
+	const rules = [];
+	for (const entry of value.rules) {
+		const rule = parseRule(entry);
+		if (!rule) return null;
+		rules.push(rule);
+	}
+	return {
+		schemaVersion: 1,
+		rules
+	};
+}
+/** Return the first rule for a development client with a known stable SDK. */
+function matchHudRule(feed, context) {
+	const { development, framework, sdkVersion } = context;
+	if (!development || !framework || !sdkVersion || (0, semver.valid)(sdkVersion) === null || (0, semver.prerelease)(sdkVersion) !== null) return null;
+	return feed.rules.find((rule) => rule.framework === framework && (0, semver.satisfies)(sdkVersion, rule.sdkVersion)) ?? null;
+}
+/** Overlay the matching rule on the built-in content, field by field. */
+function resolveHudContent(feed, context, options) {
+	const rule = feed ? matchHudRule(feed, context) : null;
+	const content = {};
+	for (const id of HUD_FEATURE_IDS) {
+		const fallback = options.defaults[id];
+		const override = rule?.features[id];
+		content[id] = {
+			label: override?.label ?? fallback.label,
+			description: override?.description ?? fallback.description,
+			destination: override?.destination !== void 0 && options.supportedDestinations.includes(override.destination) ? override.destination : fallback.destination
+		};
+	}
+	return content;
+}
+
+//#endregion
+exports.parseHudFeed = parseHudFeed;
+exports.resolveHudContent = resolveHudContent;
+//# sourceMappingURL=hud-config.cjs.map

package/dist/lib/hud-config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hud-config.cjs","names":[],"sources":["../../src/lib/hud-config.ts"],"sourcesContent":["import { prerelease, satisfies, valid, validRange } from \"semver\";\nimport type { NotificationContext } from \"./notifications.js\";\n\n/** Versioned CDN HUD contract. Keep the Intelligence copy and fixtures aligned. */\nexport type HudFramework = \"react\" | \"vue\" | \"angular\";\nexport type HudFeatureId = \"threads\" | \"learning\";\nexport interface HudFeatureContent {\n  label: string;\n  description: string;\n  destination: string;\n}\nexport type HudContent = Record<HudFeatureId, HudFeatureContent>;\nexport type HudFeatureOverride = Partial<HudFeatureContent>;\nexport interface HudRule {\n  /** Frameworks unknown to this SDK are kept but never match. */\n  framework: string;\n  sdkVersion: string;\n  /** Keyed by feature ID; IDs unknown to this SDK are kept but never applied. */\n  features: Record<string, HudFeatureOverride>;\n}\nexport interface HudFeed {\n  schemaVersion: 1;\n  rules: HudRule[];\n}\nexport type HudContext = Pick<\n  NotificationContext,\n  \"development\" | \"framework\" | \"sdkVersion\"\n>;\nexport interface HudResolveOptions {\n  defaults: HudContent;\n  /** Destination keys this SDK can open; anything else keeps the default. */\n  supportedDestinations: readonly string[];\n}\n\nexport const HUD_FEATURE_IDS: readonly HudFeatureId[] = [\"threads\", \"learning\"];\nexport const HUD_LABEL_MAX_LENGTH = 32;\nexport const HUD_DESCRIPTION_MAX_LENGTH = 140;\nconst frameworkPattern = /^[a-z][a-z0-9-]{0,31}$/;\nconst featureIdPattern = /^[a-z][a-z0-9-]{0,31}$/;\nconst destinationPattern = /^[a-z][a-z0-9-]{0,63}$/;\n// eslint-disable-next-line no-control-regex\nconst controlCharacters = /[\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029]/;\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\nfunction onlyKeys(value: Record<string, unknown>, keys: string[]): boolean {\n  return Object.keys(value).every((key) => keys.includes(key));\n}\nfunction text(value: unknown, max: number): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.trim().length > 0 &&\n    value.length <= max &&\n    !controlCharacters.test(value)\n  );\n}\nfunction parseFeature(value: unknown): HudFeatureOverride | null {\n  if (\n    !record(value) ||\n    !Object.keys(value).length ||\n    !onlyKeys(value, [\"label\", \"description\", \"destination\"])\n  )\n    return null;\n  if (value.label !== undefined && !text(value.label, HUD_LABEL_MAX_LENGTH))\n    return null;\n  if (\n    value.description !== undefined &&\n    !text(value.description, HUD_DESCRIPTION_MAX_LENGTH)\n  )\n    return null;\n  if (\n    value.destination !== undefined &&\n    (typeof value.destination !== \"string\" ||\n      !destinationPattern.test(value.destination))\n  )\n    return null;\n  return {\n    ...(value.label === undefined ? {} : { label: value.label }),\n    ...(value.description === undefined\n      ? {}\n      : { description: value.description }),\n    ...(value.destination === undefined\n      ? {}\n      : { destination: value.destination }),\n  };\n}\nfunction parseRule(value: unknown): HudRule | null {\n  if (\n    !record(value) ||\n    !onlyKeys(value, [\"framework\", \"sdkVersion\", \"features\"]) ||\n    typeof value.framework !== \"string\" ||\n    !frameworkPattern.test(value.framework) ||\n    !text(value.sdkVersion, 256) ||\n    validRange(value.sdkVersion) === null ||\n    !record(value.features) ||\n    !Object.keys(value.features).length\n  )\n    return null;\n  const features: Record<string, HudFeatureOverride> = {};\n  for (const [id, entry] of Object.entries(value.features)) {\n    if (!featureIdPattern.test(id)) return null;\n    const feature = parseFeature(entry);\n    if (!feature) return null;\n    features[id] = feature;\n  }\n  return {\n    framework: value.framework,\n    sdkVersion: value.sdkVersion,\n    features,\n  };\n}\n\n/** Parse the public envelope. Any invalid entry rejects the whole feed. */\nexport function parseHudFeed(value: unknown): HudFeed | null {\n  if (\n    !record(value) ||\n    !onlyKeys(value, [\"schemaVersion\", \"rules\"]) ||\n    value.schemaVersion !== 1 ||\n    !Array.isArray(value.rules) ||\n    value.rules.length > 100\n  )\n    return null;\n  const rules: HudRule[] = [];\n  for (const entry of value.rules) {\n    const rule = parseRule(entry);\n    if (!rule) return null;\n    rules.push(rule);\n  }\n  return { schemaVersion: 1, rules };\n}\n\n/** Return the first rule for a development client with a known stable SDK. */\nexport function matchHudRule(\n  feed: HudFeed,\n  context: HudContext,\n): HudRule | null {\n  const { development, framework, sdkVersion } = context;\n  if (\n    !development ||\n    !framework ||\n    !sdkVersion ||\n    valid(sdkVersion) === null ||\n    prerelease(sdkVersion) !== null\n  )\n    return null;\n  return (\n    feed.rules.find(\n      (rule) =>\n        rule.framework === framework && satisfies(sdkVersion, rule.sdkVersion),\n    ) ?? null\n  );\n}\n\n/** Overlay the matching rule on the built-in content, field by field. */\nexport function resolveHudContent(\n  feed: HudFeed | null,\n  context: HudContext,\n  options: HudResolveOptions,\n): HudContent {\n  const rule = feed ? matchHudRule(feed, context) : null;\n  const content = {} as HudContent;\n  for (const id of HUD_FEATURE_IDS) {\n    const fallback = options.defaults[id];\n    const override = rule?.features[id];\n    content[id] = {\n      label: override?.label ?? fallback.label,\n      description: override?.description ?? fallback.description,\n      destination:\n        override?.destination !== undefined &&\n        options.supportedDestinations.includes(override.destination)\n          ? override.destination\n          : fallback.destination,\n    };\n  }\n  return content;\n}\n"],"mappings":"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"}

package/dist/lib/hud-config.mjs

@@ -0,0 +1,92 @@
+import { prerelease, satisfies, valid, validRange } from "semver";
+
+//#region src/lib/hud-config.ts
+const HUD_FEATURE_IDS = ["threads", "learning"];
+const HUD_LABEL_MAX_LENGTH = 32;
+const HUD_DESCRIPTION_MAX_LENGTH = 140;
+const frameworkPattern = /^[a-z][a-z0-9-]{0,31}$/;
+const featureIdPattern = /^[a-z][a-z0-9-]{0,31}$/;
+const destinationPattern = /^[a-z][a-z0-9-]{0,63}$/;
+const controlCharacters = /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/;
+function record(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function onlyKeys(value, keys) {
+	return Object.keys(value).every((key) => keys.includes(key));
+}
+function text(value, max) {
+	return typeof value === "string" && value.trim().length > 0 && value.length <= max && !controlCharacters.test(value);
+}
+function parseFeature(value) {
+	if (!record(value) || !Object.keys(value).length || !onlyKeys(value, [
+		"label",
+		"description",
+		"destination"
+	])) return null;
+	if (value.label !== void 0 && !text(value.label, HUD_LABEL_MAX_LENGTH)) return null;
+	if (value.description !== void 0 && !text(value.description, HUD_DESCRIPTION_MAX_LENGTH)) return null;
+	if (value.destination !== void 0 && (typeof value.destination !== "string" || !destinationPattern.test(value.destination))) return null;
+	return {
+		...value.label === void 0 ? {} : { label: value.label },
+		...value.description === void 0 ? {} : { description: value.description },
+		...value.destination === void 0 ? {} : { destination: value.destination }
+	};
+}
+function parseRule(value) {
+	if (!record(value) || !onlyKeys(value, [
+		"framework",
+		"sdkVersion",
+		"features"
+	]) || typeof value.framework !== "string" || !frameworkPattern.test(value.framework) || !text(value.sdkVersion, 256) || validRange(value.sdkVersion) === null || !record(value.features) || !Object.keys(value.features).length) return null;
+	const features = {};
+	for (const [id, entry] of Object.entries(value.features)) {
+		if (!featureIdPattern.test(id)) return null;
+		const feature = parseFeature(entry);
+		if (!feature) return null;
+		features[id] = feature;
+	}
+	return {
+		framework: value.framework,
+		sdkVersion: value.sdkVersion,
+		features
+	};
+}
+/** Parse the public envelope. Any invalid entry rejects the whole feed. */
+function parseHudFeed(value) {
+	if (!record(value) || !onlyKeys(value, ["schemaVersion", "rules"]) || value.schemaVersion !== 1 || !Array.isArray(value.rules) || value.rules.length > 100) return null;
+	const rules = [];
+	for (const entry of value.rules) {
+		const rule = parseRule(entry);
+		if (!rule) return null;
+		rules.push(rule);
+	}
+	return {
+		schemaVersion: 1,
+		rules
+	};
+}
+/** Return the first rule for a development client with a known stable SDK. */
+function matchHudRule(feed, context) {
+	const { development, framework, sdkVersion } = context;
+	if (!development || !framework || !sdkVersion || valid(sdkVersion) === null || prerelease(sdkVersion) !== null) return null;
+	return feed.rules.find((rule) => rule.framework === framework && satisfies(sdkVersion, rule.sdkVersion)) ?? null;
+}
+/** Overlay the matching rule on the built-in content, field by field. */
+function resolveHudContent(feed, context, options) {
+	const rule = feed ? matchHudRule(feed, context) : null;
+	const content = {};
+	for (const id of HUD_FEATURE_IDS) {
+		const fallback = options.defaults[id];
+		const override = rule?.features[id];
+		content[id] = {
+			label: override?.label ?? fallback.label,
+			description: override?.description ?? fallback.description,
+			destination: override?.destination !== void 0 && options.supportedDestinations.includes(override.destination) ? override.destination : fallback.destination
+		};
+	}
+	return content;
+}
+
+//#endregion
+export { parseHudFeed, resolveHudContent };
+//# sourceMappingURL=hud-config.mjs.map

package/dist/lib/hud-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hud-config.mjs","names":[],"sources":["../../src/lib/hud-config.ts"],"sourcesContent":["import { prerelease, satisfies, valid, validRange } from \"semver\";\nimport type { NotificationContext } from \"./notifications.js\";\n\n/** Versioned CDN HUD contract. Keep the Intelligence copy and fixtures aligned. */\nexport type HudFramework = \"react\" | \"vue\" | \"angular\";\nexport type HudFeatureId = \"threads\" | \"learning\";\nexport interface HudFeatureContent {\n  label: string;\n  description: string;\n  destination: string;\n}\nexport type HudContent = Record<HudFeatureId, HudFeatureContent>;\nexport type HudFeatureOverride = Partial<HudFeatureContent>;\nexport interface HudRule {\n  /** Frameworks unknown to this SDK are kept but never match. */\n  framework: string;\n  sdkVersion: string;\n  /** Keyed by feature ID; IDs unknown to this SDK are kept but never applied. */\n  features: Record<string, HudFeatureOverride>;\n}\nexport interface HudFeed {\n  schemaVersion: 1;\n  rules: HudRule[];\n}\nexport type HudContext = Pick<\n  NotificationContext,\n  \"development\" | \"framework\" | \"sdkVersion\"\n>;\nexport interface HudResolveOptions {\n  defaults: HudContent;\n  /** Destination keys this SDK can open; anything else keeps the default. */\n  supportedDestinations: readonly string[];\n}\n\nexport const HUD_FEATURE_IDS: readonly HudFeatureId[] = [\"threads\", \"learning\"];\nexport const HUD_LABEL_MAX_LENGTH = 32;\nexport const HUD_DESCRIPTION_MAX_LENGTH = 140;\nconst frameworkPattern = /^[a-z][a-z0-9-]{0,31}$/;\nconst featureIdPattern = /^[a-z][a-z0-9-]{0,31}$/;\nconst destinationPattern = /^[a-z][a-z0-9-]{0,63}$/;\n// eslint-disable-next-line no-control-regex\nconst controlCharacters = /[\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029]/;\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\nfunction onlyKeys(value: Record<string, unknown>, keys: string[]): boolean {\n  return Object.keys(value).every((key) => keys.includes(key));\n}\nfunction text(value: unknown, max: number): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.trim().length > 0 &&\n    value.length <= max &&\n    !controlCharacters.test(value)\n  );\n}\nfunction parseFeature(value: unknown): HudFeatureOverride | null {\n  if (\n    !record(value) ||\n    !Object.keys(value).length ||\n    !onlyKeys(value, [\"label\", \"description\", \"destination\"])\n  )\n    return null;\n  if (value.label !== undefined && !text(value.label, HUD_LABEL_MAX_LENGTH))\n    return null;\n  if (\n    value.description !== undefined &&\n    !text(value.description, HUD_DESCRIPTION_MAX_LENGTH)\n  )\n    return null;\n  if (\n    value.destination !== undefined &&\n    (typeof value.destination !== \"string\" ||\n      !destinationPattern.test(value.destination))\n  )\n    return null;\n  return {\n    ...(value.label === undefined ? {} : { label: value.label }),\n    ...(value.description === undefined\n      ? {}\n      : { description: value.description }),\n    ...(value.destination === undefined\n      ? {}\n      : { destination: value.destination }),\n  };\n}\nfunction parseRule(value: unknown): HudRule | null {\n  if (\n    !record(value) ||\n    !onlyKeys(value, [\"framework\", \"sdkVersion\", \"features\"]) ||\n    typeof value.framework !== \"string\" ||\n    !frameworkPattern.test(value.framework) ||\n    !text(value.sdkVersion, 256) ||\n    validRange(value.sdkVersion) === null ||\n    !record(value.features) ||\n    !Object.keys(value.features).length\n  )\n    return null;\n  const features: Record<string, HudFeatureOverride> = {};\n  for (const [id, entry] of Object.entries(value.features)) {\n    if (!featureIdPattern.test(id)) return null;\n    const feature = parseFeature(entry);\n    if (!feature) return null;\n    features[id] = feature;\n  }\n  return {\n    framework: value.framework,\n    sdkVersion: value.sdkVersion,\n    features,\n  };\n}\n\n/** Parse the public envelope. Any invalid entry rejects the whole feed. */\nexport function parseHudFeed(value: unknown): HudFeed | null {\n  if (\n    !record(value) ||\n    !onlyKeys(value, [\"schemaVersion\", \"rules\"]) ||\n    value.schemaVersion !== 1 ||\n    !Array.isArray(value.rules) ||\n    value.rules.length > 100\n  )\n    return null;\n  const rules: HudRule[] = [];\n  for (const entry of value.rules) {\n    const rule = parseRule(entry);\n    if (!rule) return null;\n    rules.push(rule);\n  }\n  return { schemaVersion: 1, rules };\n}\n\n/** Return the first rule for a development client with a known stable SDK. */\nexport function matchHudRule(\n  feed: HudFeed,\n  context: HudContext,\n): HudRule | null {\n  const { development, framework, sdkVersion } = context;\n  if (\n    !development ||\n    !framework ||\n    !sdkVersion ||\n    valid(sdkVersion) === null ||\n    prerelease(sdkVersion) !== null\n  )\n    return null;\n  return (\n    feed.rules.find(\n      (rule) =>\n        rule.framework === framework && satisfies(sdkVersion, rule.sdkVersion),\n    ) ?? null\n  );\n}\n\n/** Overlay the matching rule on the built-in content, field by field. */\nexport function resolveHudContent(\n  feed: HudFeed | null,\n  context: HudContext,\n  options: HudResolveOptions,\n): HudContent {\n  const rule = feed ? matchHudRule(feed, context) : null;\n  const content = {} as HudContent;\n  for (const id of HUD_FEATURE_IDS) {\n    const fallback = options.defaults[id];\n    const override = rule?.features[id];\n    content[id] = {\n      label: override?.label ?? fallback.label,\n      description: override?.description ?? fallback.description,\n      destination:\n        override?.destination !== undefined &&\n        options.supportedDestinations.includes(override.destination)\n          ? override.destination\n          : fallback.destination,\n    };\n  }\n  return content;\n}\n"],"mappings":"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"}

package/dist/lib/hud-defaults.cjs

@@ -0,0 +1,19 @@
+
+//#region src/lib/hud-defaults.ts
+/** Built-in HUD copy and destinations; a matching feed rule overrides fields. */
+const HUD_DEFAULT_CONTENT = {
+	threads: {
+		label: "Rich Threads",
+		description: "Click to learn more",
+		destination: "threads"
+	},
+	learning: {
+		label: "Automatic Learning",
+		description: "Click to learn more",
+		destination: "memories"
+	}
+};
+
+//#endregion
+exports.HUD_DEFAULT_CONTENT = HUD_DEFAULT_CONTENT;
+//# sourceMappingURL=hud-defaults.cjs.map

package/dist/lib/hud-defaults.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hud-defaults.cjs","names":[],"sources":["../../src/lib/hud-defaults.ts"],"sourcesContent":["import type { HudContent } from \"./hud-config.js\";\n\n/** Built-in HUD copy and destinations; a matching feed rule overrides fields. */\nexport const HUD_DEFAULT_CONTENT: HudContent = {\n  threads: {\n    label: \"Rich Threads\",\n    description: \"Click to learn more\",\n    destination: \"threads\",\n  },\n  learning: {\n    label: \"Automatic Learning\",\n    description: \"Click to learn more\",\n    destination: \"memories\",\n  },\n};\n"],"mappings":";;;AAGA,MAAa,sBAAkC;CAC7C,SAAS;EACP,OAAO;EACP,aAAa;EACb,aAAa;EACd;CACD,UAAU;EACR,OAAO;EACP,aAAa;EACb,aAAa;EACd;CACF"}

package/dist/lib/hud-defaults.mjs

@@ -0,0 +1,18 @@
+//#region src/lib/hud-defaults.ts
+/** Built-in HUD copy and destinations; a matching feed rule overrides fields. */
+const HUD_DEFAULT_CONTENT = {
+	threads: {
+		label: "Rich Threads",
+		description: "Click to learn more",
+		destination: "threads"
+	},
+	learning: {
+		label: "Automatic Learning",
+		description: "Click to learn more",
+		destination: "memories"
+	}
+};
+
+//#endregion
+export { HUD_DEFAULT_CONTENT };
+//# sourceMappingURL=hud-defaults.mjs.map

package/dist/lib/hud-defaults.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hud-defaults.mjs","names":[],"sources":["../../src/lib/hud-defaults.ts"],"sourcesContent":["import type { HudContent } from \"./hud-config.js\";\n\n/** Built-in HUD copy and destinations; a matching feed rule overrides fields. */\nexport const HUD_DEFAULT_CONTENT: HudContent = {\n  threads: {\n    label: \"Rich Threads\",\n    description: \"Click to learn more\",\n    destination: \"threads\",\n  },\n  learning: {\n    label: \"Automatic Learning\",\n    description: \"Click to learn more\",\n    destination: \"memories\",\n  },\n};\n"],"mappings":";;AAGA,MAAa,sBAAkC;CAC7C,SAAS;EACP,OAAO;EACP,aAAa;EACb,aAAa;EACd;CACD,UAAU;EACR,OAAO;EACP,aAAa;EACb,aAAa;EACd;CACF"}

package/dist/lib/hud-loader.cjs

@@ -0,0 +1,26 @@
+const require_hud_config = require('./hud-config.cjs');
+
+//#region src/lib/hud-loader.ts
+const HUD_FEED_URL = "https://cdn.copilotkit.ai/inspector-hud/v1.json";
+let request = null;
+/** Load the HUD feed once per page. The request carries no client data. */
+function loadHudFeed() {
+	if (typeof window === "undefined" || typeof fetch === "undefined") return Promise.resolve(null);
+	request ??= Promise.resolve().then(() => fetch(HUD_FEED_URL, {
+		cache: "no-cache",
+		credentials: "omit"
+	})).then(async (response) => {
+		if (!response.ok) throw new Error(`Feed request failed (${response.status})`);
+		const feed = require_hud_config.parseHudFeed(await response.json());
+		if (!feed) throw new Error("Feed failed validation");
+		return feed;
+	}).catch((error) => {
+		console.warn("[CopilotKit Inspector] Failed to load HUD content", error);
+		return null;
+	});
+	return request;
+}
+
+//#endregion
+exports.loadHudFeed = loadHudFeed;
+//# sourceMappingURL=hud-loader.cjs.map

package/dist/lib/hud-loader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hud-loader.cjs","names":["parseHudFeed"],"sources":["../../src/lib/hud-loader.ts"],"sourcesContent":["import { parseHudFeed } from \"./hud-config.js\";\nimport type { HudFeed } from \"./hud-config.js\";\n\nexport const HUD_FEED_URL = \"https://cdn.copilotkit.ai/inspector-hud/v1.json\";\nlet request: Promise<HudFeed | null> | null = null;\n\n/** Load the HUD feed once per page. The request carries no client data. */\nexport function loadHudFeed(): Promise<HudFeed | null> {\n  if (typeof window === \"undefined\" || typeof fetch === \"undefined\")\n    return Promise.resolve(null);\n  // Start inside a promise so even a synchronous fetch failure resolves null.\n  request ??= Promise.resolve()\n    .then(() => fetch(HUD_FEED_URL, { cache: \"no-cache\", credentials: \"omit\" }))\n    .then(async (response) => {\n      if (!response.ok)\n        throw new Error(`Feed request failed (${response.status})`);\n      const feed = parseHudFeed(await response.json());\n      if (!feed) throw new Error(\"Feed failed validation\");\n      return feed;\n    })\n    .catch((error: unknown) => {\n      // The HUD keeps its built-in copy; the warning makes that debuggable.\n      console.warn(\"[CopilotKit Inspector] Failed to load HUD content\", error);\n      return null;\n    });\n  return request;\n}\n"],"mappings":";;;AAGA,MAAa,eAAe;AAC5B,IAAI,UAA0C;;AAG9C,SAAgB,cAAuC;AACrD,KAAI,OAAO,WAAW,eAAe,OAAO,UAAU,YACpD,QAAO,QAAQ,QAAQ,KAAK;AAE9B,aAAY,QAAQ,SAAS,CAC1B,WAAW,MAAM,cAAc;EAAE,OAAO;EAAY,aAAa;EAAQ,CAAC,CAAC,CAC3E,KAAK,OAAO,aAAa;AACxB,MAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,wBAAwB,SAAS,OAAO,GAAG;EAC7D,MAAM,OAAOA,gCAAa,MAAM,SAAS,MAAM,CAAC;AAChD,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,yBAAyB;AACpD,SAAO;GACP,CACD,OAAO,UAAmB;AAEzB,UAAQ,KAAK,qDAAqD,MAAM;AACxE,SAAO;GACP;AACJ,QAAO"}

package/dist/lib/hud-loader.mjs

@@ -0,0 +1,26 @@
+import { parseHudFeed } from "./hud-config.mjs";
+
+//#region src/lib/hud-loader.ts
+const HUD_FEED_URL = "https://cdn.copilotkit.ai/inspector-hud/v1.json";
+let request = null;
+/** Load the HUD feed once per page. The request carries no client data. */
+function loadHudFeed() {
+	if (typeof window === "undefined" || typeof fetch === "undefined") return Promise.resolve(null);
+	request ??= Promise.resolve().then(() => fetch(HUD_FEED_URL, {
+		cache: "no-cache",
+		credentials: "omit"
+	})).then(async (response) => {
+		if (!response.ok) throw new Error(`Feed request failed (${response.status})`);
+		const feed = parseHudFeed(await response.json());
+		if (!feed) throw new Error("Feed failed validation");
+		return feed;
+	}).catch((error) => {
+		console.warn("[CopilotKit Inspector] Failed to load HUD content", error);
+		return null;
+	});
+	return request;
+}
+
+//#endregion
+export { loadHudFeed };
+//# sourceMappingURL=hud-loader.mjs.map

package/dist/lib/hud-loader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hud-loader.mjs","names":[],"sources":["../../src/lib/hud-loader.ts"],"sourcesContent":["import { parseHudFeed } from \"./hud-config.js\";\nimport type { HudFeed } from \"./hud-config.js\";\n\nexport const HUD_FEED_URL = \"https://cdn.copilotkit.ai/inspector-hud/v1.json\";\nlet request: Promise<HudFeed | null> | null = null;\n\n/** Load the HUD feed once per page. The request carries no client data. */\nexport function loadHudFeed(): Promise<HudFeed | null> {\n  if (typeof window === \"undefined\" || typeof fetch === \"undefined\")\n    return Promise.resolve(null);\n  // Start inside a promise so even a synchronous fetch failure resolves null.\n  request ??= Promise.resolve()\n    .then(() => fetch(HUD_FEED_URL, { cache: \"no-cache\", credentials: \"omit\" }))\n    .then(async (response) => {\n      if (!response.ok)\n        throw new Error(`Feed request failed (${response.status})`);\n      const feed = parseHudFeed(await response.json());\n      if (!feed) throw new Error(\"Feed failed validation\");\n      return feed;\n    })\n    .catch((error: unknown) => {\n      // The HUD keeps its built-in copy; the warning makes that debuggable.\n      console.warn(\"[CopilotKit Inspector] Failed to load HUD content\", error);\n      return null;\n    });\n  return request;\n}\n"],"mappings":";;;AAGA,MAAa,eAAe;AAC5B,IAAI,UAA0C;;AAG9C,SAAgB,cAAuC;AACrD,KAAI,OAAO,WAAW,eAAe,OAAO,UAAU,YACpD,QAAO,QAAQ,QAAQ,KAAK;AAE9B,aAAY,QAAQ,SAAS,CAC1B,WAAW,MAAM,cAAc;EAAE,OAAO;EAAY,aAAa;EAAQ,CAAC,CAAC,CAC3E,KAAK,OAAO,aAAa;AACxB,MAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,wBAAwB,SAAS,OAAO,GAAG;EAC7D,MAAM,OAAO,aAAa,MAAM,SAAS,MAAM,CAAC;AAChD,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,yBAAyB;AACpD,SAAO;GACP,CACD,OAAO,UAAmB;AAEzB,UAAQ,KAAK,qDAAqD,MAAM;AACxE,SAAO;GACP;AACJ,QAAO"}

package/dist/lib/inspector-nav.cjs

@@ -51,6 +51,7 @@ function shouldUseIconRail(args) {
 
 //#endregion
 exports.INSPECTOR_GROUPS = INSPECTOR_GROUPS;
+exports.INSPECTOR_MENU_KEYS = INSPECTOR_MENU_KEYS;
 exports.INSPECTOR_NAV_SECTIONS = INSPECTOR_NAV_SECTIONS;
 exports.getGroupForMenu = getGroupForMenu;
 exports.isInspectorMenuKey = isInspectorMenuKey;

package/dist/lib/inspector-nav.mjs

@@ -49,5 +49,5 @@ function shouldUseIconRail(args) {
 }
 
 //#endregion
-export { INSPECTOR_GROUPS, INSPECTOR_NAV_SECTIONS, getGroupForMenu, isInspectorMenuKey, shouldUseIconRail };
+export { INSPECTOR_GROUPS, INSPECTOR_MENU_KEYS, INSPECTOR_NAV_SECTIONS, getGroupForMenu, isInspectorMenuKey, shouldUseIconRail };
 //# sourceMappingURL=inspector-nav.mjs.map

package/dist/package.cjs

@@ -1,6 +1,6 @@
 
 //#region package.json
-var version = "1.77.0";
+var version = "1.77.1";
 
 //#endregion
 Object.defineProperty(exports, 'version', {

package/dist/package.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.77.0";
+var version = "1.77.1";
 
 //#endregion
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@copilotkit/web-inspector",
-  "version": "1.77.0",
+  "version": "1.77.1",
   "description": "Lit-based web component for the CopilotKit web inspector",
   "license": "MIT",
   "repository": {
@@ -27,13 +27,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@ag-ui/client": "1.0.1",
+    "@ag-ui/client": "1.0.2",
     "lit": "^3.2.0",
     "lucide": "^0.525.0",
     "marked": "^12.0.2",
     "semver": "^7.8.5",
-    "@copilotkit/core": "1.77.0",
-    "@copilotkit/shared": "1.77.0"
+    "@copilotkit/core": "1.77.1",
+    "@copilotkit/shared": "1.77.1"
   },
   "devDependencies": {
     "@playwright/test": "^1.59.1",