@vibesdotdev/chat 0.0.0-stage → 1.0.0-rc.1

package/dist/svelte/components/utils/typing-indicator.d.ts

@@ -0,0 +1,17 @@
+import type { RuntimeEnvironmentImplementation } from "@vibesdotdev/kernel/schemas/registry";
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+export interface TypingIndicatorPoster {
+    /** POST the typing state for a room. Best-effort; never throws. */
+    post(roomId: string, isTyping: boolean): Promise<void>;
+}
+interface CreateTypingIndicatorPosterOptions {
+    /** Chat-web's origin for a cross-origin embed; `null` posts same-origin. */
+    base: string | null;
+    /** Injectable for tests; defaults to global fetch. */
+    fetchImpl?: NonNullable<RuntimeEnvironmentImplementation['httpFetch']>;
+    /** The runtime a failed post is reported on; without one a failure is not reported (it is still never raised). */
+    runtime?: RuntimeRef;
+}
+export declare function createTypingIndicatorPoster(options: CreateTypingIndicatorPosterOptions): TypingIndicatorPoster;
+export {};
+//# sourceMappingURL=typing-indicator.d.ts.map

package/dist/svelte/components/utils/typing-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-indicator.d.ts","sourceRoot":"","sources":["../../../../src/svelte/components/utils/typing-indicator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAe7F,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACrC,mEAAmE;IACnE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,UAAU,kCAAkC;IAC3C,4EAA4E;IAC5E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sDAAsD;IACtD,SAAS,CAAC,EAAE,WAAW,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,kHAAkH;IAClH,OAAO,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,kCAAkC,GACzC,qBAAqB,CA8BvB"}

package/dist/svelte/components/utils/typing-indicator.js

@@ -0,0 +1,46 @@
+/**
+ * Typing-indicator poster for the runtime chat composer.
+ *
+ * The `/api/chat/typing` endpoint is owned by chat-web. A host app EMBEDDING
+ * chat from another origin (e.g. an org portal on `portal.example.com`) does not
+ * serve that route, so a same-origin POST would 404 on every keystroke window
+ * (the cross-origin embed failure mode). The embedding app receives chat-web's origin
+ * through its layout data (rc04 §2.4) and hands it in as `base`; chat-web
+ * itself passes none and posts same-origin. After a 404 the poster disables
+ * itself. Typing indicators stay best-effort — no failure here may ever
+ * surface as a send error or block the composer.
+ */
+import { getLogger } from '@vibesdotdev/logging';
+import { settle, valueFreeFailure } from '@vibesdotdev/kernel';
+export function createTypingIndicatorPoster(options) {
+    const base = options.base ? options.base.replace(/\/+$/, '') : null;
+    // Feature-detect: after a 404 the endpoint does not exist at the resolved
+    // base (an unregistered host with no cross-origin chat base) — stop posting
+    // instead of 404ing on every throttle window.
+    let unsupported = false;
+    return {
+        async post(roomId, isTyping) {
+            if (unsupported)
+                return;
+            const settled = await settle(async () => {
+                const fetchImpl = options.fetchImpl ?? fetch;
+                const response = await fetchImpl(`${base ?? ''}/api/chat/typing`, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json' },
+                    // Cross-subdomain embeds carry the `.vibes.dev` session cookie;
+                    // same-origin keeps the tighter default.
+                    credentials: base ? 'include' : 'same-origin',
+                    body: JSON.stringify({ chatRoomId: roomId, isTyping })
+                });
+                if (response.status === 404)
+                    unsupported = true;
+            });
+            if (!settled.ok && options.runtime) {
+                getLogger('chat.typing-indicator', options.runtime).warn('typing indicator post failed', {
+                    roomId,
+                    failure: valueFreeFailure(settled.cause)
+                });
+            }
+        }
+    };
+}

package/dist/svelte/composer-actions.d.ts

@@ -0,0 +1,4 @@
+export * from '@vibesdotdev/chat/surface/composer-actions';
+export declare const CHAT_COMPOSER_ACTIONS_CHANGED_EVENT = "chat:composer-actions:changed";
+export declare function announceRuntimeChatComposerActionsChanged(): void;
+//# sourceMappingURL=composer-actions.d.ts.map

package/dist/svelte/composer-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-actions.d.ts","sourceRoot":"","sources":["../../src/svelte/composer-actions.ts"],"names":[],"mappings":"AAEA,cAAc,4CAA4C,CAAC;AAE3D,eAAO,MAAM,mCAAmC,kCAAkC,CAAC;AAEnF,wBAAgB,yCAAyC,IAAI,IAAI,CAGhE"}

package/dist/svelte/composer-actions.js

@@ -0,0 +1,8 @@
+import { BROWSER } from 'esm-env';
+export * from '@vibesdotdev/chat/surface/composer-actions';
+export const CHAT_COMPOSER_ACTIONS_CHANGED_EVENT = 'chat:composer-actions:changed';
+export function announceRuntimeChatComposerActionsChanged() {
+    if (!BROWSER)
+        return;
+    window.dispatchEvent(new CustomEvent(CHAT_COMPOSER_ACTIONS_CHANGED_EVENT));
+}

package/dist/svelte/composer-augments.d.ts

@@ -0,0 +1,41 @@
+import type { Component } from 'svelte';
+import type { AIAugmentDescriptor } from '@vibesdotdev/ai/augmentations/schemas/augment';
+import type { ChatComposerOptions } from '@vibesdotdev/chat/client/contracts';
+import type { ChatWorkspaceCatalog, ChatWorkspaceResolver } from './workspace-catalog.ts';
+export declare const CHAT_COMPOSER_AUGMENT_UI_ROLE = "composer";
+export type ChatComposerAugmentPresentation = 'composer' | 'setup';
+export type ChatComposerAugmentProps = {
+    presentation?: ChatComposerAugmentPresentation;
+    options: ChatComposerOptions;
+    workspaceCatalog?: ChatWorkspaceCatalog;
+    onPrepareWorkspace?: ChatWorkspaceResolver;
+    onCreateWorkspace?: () => void;
+    creatingWorkspace?: boolean;
+    permissionsEnabled?: boolean;
+    defaultModeId?: string;
+    preferredAgentId?: string;
+    loading?: boolean;
+};
+export type LoadedChatComposerAugment = {
+    id: string;
+    title: string;
+    placement: 'primary' | 'overflow';
+    priority: number;
+    component: Component<ChatComposerAugmentProps>;
+};
+export declare function chatComposerAugmentUiId(augmentId: string): string;
+export declare function placementOf(descriptor: AIAugmentDescriptor): 'primary' | 'overflow' | 'command';
+export interface ChatComposerAugmentRuntimeQuery<TDescriptor> {
+    enabled(): {
+        descriptors(): TDescriptor[];
+    };
+    withId(id: string): {
+        resolve(): Promise<object | Function | null>;
+    };
+}
+export interface ChatComposerAugmentRuntime {
+    hasKind(kind: string): boolean;
+    query<TDescriptor = object>(kind: string): ChatComposerAugmentRuntimeQuery<TDescriptor>;
+}
+export declare function loadChatComposerAugments(runtime: ChatComposerAugmentRuntime): Promise<LoadedChatComposerAugment[]>;
+//# sourceMappingURL=composer-augments.d.ts.map

package/dist/svelte/composer-augments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-augments.d.ts","sourceRoot":"","sources":["../../src/svelte/composer-augments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAEzF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG1F,eAAO,MAAM,6BAA6B,aAAa,CAAC;AAExD,MAAM,MAAM,+BAA+B,GAAG,UAAU,GAAG,OAAO,CAAC;AAEnE,MAAM,MAAM,wBAAwB,GAAG;IACtC,YAAY,CAAC,EAAE,+BAA+B,CAAC;IAC/C,OAAO,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;IAC3C,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC,wBAAwB,CAAC,CAAC;CAC/C,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAoBD,wBAAgB,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAI/F;AAQD,MAAM,WAAW,+BAA+B,CAAC,WAAW;IAC3D,OAAO,IAAI;QAAE,WAAW,IAAI,WAAW,EAAE,CAAA;KAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAA;KAAE,CAAC;CACrE;AAED,MAAM,WAAW,0BAA0B;IAC1C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,KAAK,CAAC,WAAW,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,+BAA+B,CAAC,WAAW,CAAC,CAAC;CACxF;AAED,wBAAsB,wBAAwB,CAC7C,OAAO,EAAE,0BAA0B,GACjC,OAAO,CAAC,yBAAyB,EAAE,CAAC,CA4CtC"}

package/dist/svelte/composer-augments.js

@@ -0,0 +1,70 @@
+import * as z from 'zod/v4';
+import { settle } from '@vibesdotdev/kernel';
+export const CHAT_COMPOSER_AUGMENT_UI_ROLE = 'composer';
+export function chatComposerAugmentUiId(augmentId) {
+    return `${augmentId}.composer`;
+}
+const componentSchema = z.custom((val) => val instanceof Function || (val !== null && val instanceof Object));
+const moduleDefaultSchema = z.looseObject({
+    default: componentSchema
+});
+function asComponent(value) {
+    const direct = componentSchema.safeParse(value);
+    if (direct.success) {
+        const mod = moduleDefaultSchema.safeParse(value);
+        if (mod.success)
+            return mod.data.default;
+        return direct.data;
+    }
+    return null;
+}
+export function placementOf(descriptor) {
+    return descriptor.placement === 'primary' || descriptor.placement === 'overflow'
+        ? descriptor.placement
+        : 'command';
+}
+function isSurfacedPlacement(placement) {
+    return placement === 'primary' || placement === 'overflow';
+}
+export async function loadChatComposerAugments(runtime) {
+    if (!runtime.hasKind('ai/augment') || !runtime.hasKind('ai/context.ui'))
+        return [];
+    const augments = runtime
+        .query('ai/augment')
+        .enabled()
+        .descriptors()
+        .filter((descriptor) => isSurfacedPlacement(descriptor.placement))
+        .sort((left, right) => (right.priority ?? 0) - (left.priority ?? 0));
+    const loaded = [];
+    for (const augment of augments) {
+        const settled = await settle(async () => {
+            const uiId = chatComposerAugmentUiId(augment.id);
+            const uiDescriptors = runtime
+                .query('ai/context.ui')
+                .enabled()
+                .descriptors();
+            const ui = uiDescriptors.find((descriptor) => descriptor.id === uiId &&
+                descriptor.role === CHAT_COMPOSER_AUGMENT_UI_ROLE &&
+                descriptor.targetId === augment.id);
+            if (!ui)
+                return null;
+            const component = asComponent(await runtime.query('ai/context.ui').withId(uiId).resolve());
+            if (!component)
+                return null;
+            const placement = augment.placement;
+            if (!isSurfacedPlacement(placement))
+                return null;
+            return {
+                id: augment.id,
+                title: augment.title || augment.name || augment.id,
+                placement,
+                priority: augment.priority ?? 0,
+                component
+            };
+        });
+        if (settled.ok && settled.value) {
+            loaded.push(settled.value);
+        }
+    }
+    return loaded;
+}

package/dist/svelte/context/components/ContextBuilder.svelte

@@ -0,0 +1,116 @@
+<script lang="ts">
+	import * as z from 'zod/v4';
+	import type { TextGenerationStagedContext } from '@vibesdotdev/ai-schemas/generation/contracts';
+	import { onMount, type Snippet } from 'svelte';
+	import { settle, settleNow, valueFreeFailure, type ValueFreeFailure } from '@vibesdotdev/kernel';
+	import type { ContextProviderDescriptor } from '@vibesdotdev/ai/augmentations/schemas/augmentation';
+	import type { AIAugmentationImplementation } from '@vibesdotdev/ai/augmentations/interfaces/augmentation';
+	import {
+		buildStagedContextSchema,
+		createEmptyStagedContext
+	} from '@vibesdotdev/ai/context/schemas/staged-context-helpers';
+	import { loadContextRuntimeAssets } from '@vibesdotdev/ai/context/client/services/runtime-assets';
+	import { getRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte';
+	import { ensureChatRuntimeRegistered } from '../../runtime.js';
+
+	type ContextBuilderProps = {
+		value?: TextGenerationStagedContext;
+		config?: object;
+		children: Snippet<
+			[
+				{
+					value: TextGenerationStagedContext;
+					hasStaged: boolean;
+					clearAll: () => void;
+				}
+			]
+		>;
+	};
+
+	let {
+		value = $bindable(createEmptyStagedContext()),
+		config = {},
+		children
+	}: ContextBuilderProps = $props();
+
+	const providers = $state<ContextProviderDescriptor[]>([]);
+	const providerImpls = $state<Map<string, AIAugmentationImplementation<object, object>>>(
+		new Map()
+	);
+
+	const runtimeStore = getRuntimeSvelteContext();
+
+	let initializationFailure = $state<ValueFreeFailure | null>(null);
+	onMount(() => {
+		let retired = false;
+		void settle(async () => {
+		const runtime = await runtimeStore.load();
+		await ensureChatRuntimeRegistered(runtime);
+		const snapshot = await loadContextRuntimeAssets(runtime, {
+			includeProviderImplementations: true
+		});
+		if (retired) return;
+		providers.length = 0;
+		providers.push(...snapshot.providers);
+		providerImpls.clear();
+		for (const [id, implementation] of snapshot.providerImplementations.entries()) {
+			providerImpls.set(id, implementation);
+		}
+		}).then((result) => {
+			if (!retired && !result.ok) initializationFailure = valueFreeFailure(result.cause);
+		});
+		return () => { retired = true; };
+	});
+
+	const stagedSchema = $derived(buildStagedContextSchema(providers));
+
+	$effect(() => {
+		const schema = stagedSchema;
+
+		const stringCheck = z.string().safeParse(value);
+		if (stringCheck.success) {
+			const parsedJson = settleNow(() => JSON.parse(stringCheck.data));
+			if (parsedJson.ok) {
+				const parsed = schema.safeParse(parsedJson.value);
+				value = parsed.success ? parsed.data : schema.parse({});
+			} else {
+				value = schema.parse({});
+			}
+			return;
+		}
+
+		if (!value) {
+			value = schema.parse({});
+			return;
+		}
+
+		if (!value.data) {
+			value = { ...value, data: {} };
+			return;
+		}
+
+		const validated = schema.safeParse(value);
+		if (!validated.success) {
+			value = schema.parse({});
+		}
+	});
+
+	// Calculate if we have any staged context using providers
+	const hasStaged = $derived.by(() => {
+		if (!value) return false;
+		for (const impl of providerImpls.values()) {
+			if (impl.hasStaged(value)) return true;
+		}
+		return false;
+	});
+
+	function clearAll() {
+		value = createEmptyStagedContext(providers);
+	}
+</script>
+
+{#if initializationFailure}
+	<span role="status">Context unavailable: {initializationFailure.reason ?? initializationFailure.name}</span>
+{/if}
+
+{@render children({ value, hasStaged, clearAll })}

package/dist/svelte/context/components/ContextBuilder.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { TextGenerationStagedContext } from '@vibesdotdev/ai-schemas/generation/contracts';
+import { type Snippet } from 'svelte';
+type ContextBuilderProps = {
+    value?: TextGenerationStagedContext;
+    config?: object;
+    children: Snippet<[
+        {
+            value: TextGenerationStagedContext;
+            hasStaged: boolean;
+            clearAll: () => void;
+        }
+    ]>;
+};
+declare const ContextBuilder: import("svelte").Component<ContextBuilderProps, {}, "value">;
+type ContextBuilder = ReturnType<typeof ContextBuilder>;
+export default ContextBuilder;
+//# sourceMappingURL=ContextBuilder.svelte.d.ts.map

package/dist/svelte/context/components/ContextBuilder.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextBuilder.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/context/components/ContextBuilder.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAChG,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAa9C,KAAK,mBAAmB,GAAG;IAC1B,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAChB;QACC;YACC,KAAK,EAAE,2BAA2B,CAAC;YACnC,SAAS,EAAE,OAAO,CAAC;YACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;SACrB;KACD,CACD,CAAC;CACF,CAAC;AAwGH,QAAA,MAAM,cAAc,8DAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/svelte/context/components/ContextBuilderProviderActions.svelte

@@ -0,0 +1,193 @@
+<script lang="ts">
+	import { onMount } from 'svelte';
+	import type { Component } from 'svelte';
+	import * as z from 'zod/v4';
+	import type { ContextProviderDescriptor } from '@vibesdotdev/ai/augmentations/schemas/augmentation';
+	import type { ContextBuilderProviderActionsProps } from '@vibesdotdev/ai/context/schemas/runtime-assets';
+	import { settle, valueFreeFailure } from '@vibesdotdev/kernel';
+	import { getRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte';
+	import * as Tooltip from '@vibesdotdev/kit/components/ui/tooltip';
+	import { loadContextRuntimeAssets } from '@vibesdotdev/ai/context/client/services/runtime-assets';
+
+	const contextActionValueSchema = z.record(
+		z.string(),
+		z.union([z.string(), z.number(), z.boolean(), z.null(), z.undefined()])
+	);
+	type ContextActionValue = z.infer<typeof contextActionValueSchema>;
+
+	type ContextActionProps = {
+		value?: ContextActionValue;
+		disabled?: boolean;
+	};
+
+	type ContextActionComponent = Component<ContextActionProps>;
+
+	function isActionComponent(candidate: unknown): candidate is ContextActionComponent {
+		return candidate instanceof Function;
+	}
+
+	const stagedParserSchema = z.object({
+		safeParse: z.custom<(input: Record<string, never>) => { readonly success: boolean; readonly data?: unknown }>(
+			(fn) => fn instanceof Function
+		)
+	});
+
+	const runtimeStore = getRuntimeSvelteContext();
+
+	let {
+		value = $bindable({
+			data: {}
+		}),
+		config = {}
+	}: ContextBuilderProviderActionsProps = $props();
+
+	const providers = $state<ContextProviderDescriptor[]>([]);
+	const actionComponents = $state<Map<string, ContextActionComponent>>(new Map());
+	const providerDefaults = $state<Map<string, ContextActionValue>>(new Map());
+	let isLoading = $state(true);
+	let initError = $state<string | null>(null);
+
+	function computeProviderDefault(provider: ContextProviderDescriptor): ContextActionValue {
+		const staged = provider.schemas?.staged;
+		const parsed = stagedParserSchema.safeParse(staged);
+		if (parsed.success) {
+			const outcome = parsed.data.safeParse({});
+			if (outcome.success) {
+				const validated = contextActionValueSchema.safeParse(outcome.data);
+				if (validated.success) {
+					return validated.data;
+				}
+			}
+		}
+		return {};
+	}
+
+	function ensureProviderDefaults() {
+		const currentData = value.data ?? {};
+		const nextData = { ...currentData };
+		let changed = false;
+		for (const provider of providers) {
+			const existing = nextData[provider.id];
+			if (existing !== undefined) continue;
+			const fallback = providerDefaults.get(provider.id) ?? {};
+			nextData[provider.id] = { ...fallback };
+			changed = true;
+		}
+		if (changed) {
+			value = { ...value, data: nextData };
+		}
+	}
+
+	onMount(async () => {
+		isLoading = true;
+		initError = null;
+
+		const settled = await settle(async () => {
+			const snapshot = await loadContextRuntimeAssets(await runtimeStore.load(), { uiVariants: ['action'] });
+			providers.length = 0;
+			providers.push(...snapshot.providers);
+			providerDefaults.clear();
+			for (const provider of providers) {
+				providerDefaults.set(provider.id, computeProviderDefault(provider));
+			}
+
+			actionComponents.clear();
+			for (const provider of providers) {
+				const component = snapshot.uiComponents.action.get(provider.id);
+				if (isActionComponent(component)) {
+					actionComponents.set(provider.id, component);
+				}
+			}
+			ensureProviderDefaults();
+		});
+
+		if (!settled.ok) {
+			const failure = valueFreeFailure(settled.cause);
+			initError = failure.reason ?? failure.name ?? 'Failed to load context tools.';
+		}
+		isLoading = false;
+	});
+
+	// Ensure value.data exists and is reactive
+	$effect(() => {
+		if (!value.data) {
+			value = { ...value, data: {} };
+		}
+	});
+
+	$effect(() => {
+		const _count = providers.length;
+		const _data = value.data;
+		ensureProviderDefaults();
+	});
+
+	// Create reactive getters/setters for each provider
+	function createProviderBinding(providerId: string) {
+		return {
+			get value(): ContextActionValue {
+				const data = value.data?.[providerId];
+				const parsed = contextActionValueSchema.safeParse(data);
+				if (parsed.success) {
+					return parsed.data;
+				}
+				return providerDefaults.get(providerId) ?? {};
+			},
+			set value(newValue: ContextActionValue | undefined) {
+				const currentData = value.data ?? {};
+				if (newValue === undefined) {
+					const nextData = { ...currentData };
+					delete nextData[providerId];
+					value = { ...value, data: nextData };
+					return;
+				}
+				value = { ...value, data: { ...currentData, [providerId]: newValue } };
+			}
+		};
+	}
+
+	const actionProviders = $derived.by(() =>
+		providers.filter((provider) => actionComponents.has(provider.id))
+	);
+</script>
+
+{#if isLoading}
+	<div class="text-muted-foreground px-2 py-1 text-xs">Loading context tools...</div>
+{:else if initError}
+	<div class="text-muted-foreground px-2 py-1 text-xs">
+		Context tools unavailable: {initError}
+	</div>
+{:else if actionProviders.length === 0}
+	<div class="text-muted-foreground px-2 py-1 text-xs">
+		No context tools are currently available.
+	</div>
+{:else}
+	<!-- Render provider action components with bound values -->
+	{#each actionProviders as provider}
+		{@const Component = actionComponents.get(provider.id)}
+		{@const binding = createProviderBinding(provider.id)}
+		<svelte:boundary onerror={(e) => console.error('[ContextUIAction failed]', provider.id, e)}>
+			{#snippet failed(err, reset)}
+				<span class="text-muted-foreground text-xs">{provider.name ?? provider.id} unavailable</span
+				>
+			{/snippet}
+			{#if Component}
+				{#if provider.description}
+					<Tooltip.Root>
+						<Tooltip.Trigger>
+							{#snippet child(props)}
+								<div {...props}>
+									<Component bind:value={binding.value} disabled={config?.disabled} />
+								</div>
+							{/snippet}
+						</Tooltip.Trigger>
+						<Tooltip.Content>
+							<p class="max-w-xs text-xs">{provider.description}</p>
+						</Tooltip.Content>
+					</Tooltip.Root>
+				{:else}
+					<Component bind:value={binding.value} disabled={config?.disabled} />
+				{/if}
+			{/if}
+		</svelte:boundary>
+	{/each}
+{/if}

package/dist/svelte/context/components/ContextBuilderProviderActions.svelte.d.ts

@@ -0,0 +1,6 @@
+import type { Component } from 'svelte';
+import type { ContextBuilderProviderActionsProps } from '@vibesdotdev/ai/context/schemas/runtime-assets';
+declare const ContextBuilderProviderActions: Component<ContextBuilderProviderActionsProps, {}, "value">;
+type ContextBuilderProviderActions = ReturnType<typeof ContextBuilderProviderActions>;
+export default ContextBuilderProviderActions;
+//# sourceMappingURL=ContextBuilderProviderActions.svelte.d.ts.map

package/dist/svelte/context/components/ContextBuilderProviderActions.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextBuilderProviderActions.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/context/components/ContextBuilderProviderActions.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGxC,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,gDAAgD,CAAC;AAwMzG,QAAA,MAAM,6BAA6B,4DAAwC,CAAC;AAC5E,KAAK,6BAA6B,GAAG,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACtF,eAAe,6BAA6B,CAAC"}

package/dist/svelte/context/components/ContextBuilderProviderStatus.svelte

@@ -0,0 +1,110 @@
+<script lang="ts">
+	import { onMount } from 'svelte';
+	import { settle, valueFreeFailure, type ValueFreeFailure } from '@vibesdotdev/kernel';
+	import type { Component } from 'svelte';
+	import type { ContextProviderDescriptor } from '@vibesdotdev/ai/augmentations/schemas/augmentation';
+	import type { AIAugmentationImplementation } from '@vibesdotdev/ai/augmentations/interfaces/augmentation';
+	import type { TextGenerationStagedContext } from '@vibesdotdev/ai-schemas/generation/contracts';
+	import type { ContextBuilderProviderStatusProps } from '@vibesdotdev/ai/context/schemas/runtime-assets';
+	import { getRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte';
+	import { loadContextRuntimeAssets } from '@vibesdotdev/ai/context/client/services/runtime-assets';
+
+	import { createEmptyStagedContext } from '@vibesdotdev/ai/context/schemas/staged-context-helpers';
+
+	type ContextBadgeProps = {
+		value?: unknown;
+		compact?: boolean;
+		onClear?: () => void;
+	};
+
+	type ContextBadgeComponent = Component<ContextBadgeProps>;
+
+	function isBadgeComponent(candidate: unknown): candidate is ContextBadgeComponent {
+		return candidate instanceof Function;
+	}
+
+	const runtimeStore = getRuntimeSvelteContext();
+
+	let { value = $bindable() }: ContextBuilderProviderStatusProps = $props();
+
+	const providers = $state<ContextProviderDescriptor[]>([]);
+	const providerImpls = $state<Map<string, AIAugmentationImplementation<object, object>>>(
+		new Map()
+	);
+	const badgeComponents = $state<Map<string, ContextBadgeComponent>>(new Map());
+
+	let initializationFailure = $state<ValueFreeFailure | null>(null);
+	onMount(() => {
+		let retired = false;
+		void settle(async () => {
+			const snapshot = await loadContextRuntimeAssets(await runtimeStore.load(), {
+				includeProviderImplementations: true,
+				uiVariants: ['badge']
+			});
+			if (retired) return;
+			providers.length = 0;
+			providers.push(...snapshot.providers);
+			providerImpls.clear();
+			for (const [id, implementation] of snapshot.providerImplementations.entries()) {
+				providerImpls.set(id, implementation);
+			}
+
+			badgeComponents.clear();
+			for (const provider of providers) {
+				const component = snapshot.uiComponents.badge.get(provider.id);
+				if (isBadgeComponent(component)) {
+					badgeComponents.set(provider.id, component);
+				}
+			}
+		}).then((result) => {
+			if (!retired && !result.ok) initializationFailure = valueFreeFailure(result.cause);
+		});
+		return () => { retired = true; };
+	});
+
+	$effect(() => {
+		if (!value) {
+			value = createEmptyStagedContext(providers);
+		} else if (!value.data) {
+			value = { ...value, data: {} };
+		}
+	});
+
+	// Check if any provider has staged content
+	const activeProviders = $derived.by(() => {
+		const currentValue = value;
+		if (!currentValue) return [];
+		return providers.filter((provider) => {
+			const impl = providerImpls.get(provider.id);
+			return impl ? impl.hasStaged(currentValue) : false;
+		});
+	});
+</script>
+
+{#if initializationFailure}
+	<span role="status">Context unavailable: {initializationFailure.reason ?? initializationFailure.name}</span>
+{/if}
+
+<!-- Render status badges for active providers -->
+{#each activeProviders as provider}
+	{#if badgeComponents.has(provider.id)}
+		{@const Component = badgeComponents.get(provider.id)}
+		<svelte:boundary onerror={(e) => console.error('[ContextUIBadge failed]', provider.id, e)}>
+			{#snippet failed(err, reset)}
+				<!-- Skip a failing badge silently to allow others to render -->
+			{/snippet}
+			<Component
+				value={value?.data?.[provider.id]}
+				compact={true}
+				onClear={() => {
+					const ctx = value;
+					const data = ctx?.data;
+					if (!ctx || !data) return;
+					const next = { ...data };
+					delete next[provider.id];
+					value = { ...ctx, data: next };
+				}}
+			/>
+		</svelte:boundary>
+	{/if}
+{/each}

package/dist/svelte/context/components/ContextBuilderProviderStatus.svelte.d.ts

@@ -0,0 +1,6 @@
+import type { Component } from 'svelte';
+import type { ContextBuilderProviderStatusProps } from '@vibesdotdev/ai/context/schemas/runtime-assets';
+declare const ContextBuilderProviderStatus: Component<ContextBuilderProviderStatusProps, {}, "value">;
+type ContextBuilderProviderStatus = ReturnType<typeof ContextBuilderProviderStatus>;
+export default ContextBuilderProviderStatus;
+//# sourceMappingURL=ContextBuilderProviderStatus.svelte.d.ts.map

package/dist/svelte/context/components/ContextBuilderProviderStatus.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContextBuilderProviderStatus.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/context/components/ContextBuilderProviderStatus.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAIxC,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gDAAgD,CAAC;AAkHxG,QAAA,MAAM,4BAA4B,2DAAwC,CAAC;AAC3E,KAAK,4BAA4B,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;AACpF,eAAe,4BAA4B,CAAC"}