better-supabase 0.8.0 → 0.9.0

package/dist/blocks/ai-chat/index.d.ts

@@ -1,6 +1,9 @@
-import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-inD4fFq-.js";
+import { g as AiToolEventData, m as AiChatEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
 import { a as AiMessagePart, c as AiReasoningPart, d as AiTextPart, f as AiToolApprovalPart, g as isAiMessage, h as aiMessageSchema, i as AiMessage, l as AiSourcePart, m as AiToolResultPart, n as AiDataPart, o as AiMessagePartType, p as AiToolCallPart, r as AiFilePart, s as AiMessageRole, t as AI_MESSAGE_SCHEMA_ID, u as AiStepPart } from "../../message-B0fNJgq8.js";
-import { $ as AiRunStep, A as AiStoredMessageStatus, B as AiSandbox, C as AiProject, D as AiSaveResult, E as AiRunStatus, F as AiUserMessageTrigger, G as AiHarnessSession, H as AiSandboxStopper, I as SharedAiChat, J as AiHarnessStatus, K as AiHarnessSessionPatch, L as aiChatListTopic, M as AiToolApproval, N as AiToolApprovalRequest, O as AiShareLink, P as AiToolPolicy, Q as AiRunState, R as aiChatTopic, S as AiPendingInputRequest, T as AiRunRelease, U as AiSandboxes, V as AiSandboxStatus, W as NewAiSandbox, X as AiRun, Y as AiPendingApproval, Z as AiRunQuery, _ as AiModerationAction, a as AiChatInput, b as AiModerationStage, c as AiChatPatch, d as AiChatShare, et as AiRunStepInput, f as AiChatVisibility, g as AiModelInput, h as AiModel, i as AiChat, j as AiStreamClaim, k as AiStoredMessage, l as AiChatQuery, m as AiMessageSibling, n as AiApprovalDecision, nt as AiRuns, o as AiChatOptions, p as AiFeedback, q as AiHarnessSessions, r as AiAssistantMessageOptions, rt as createHarnessSessions, s as AiChatPage, t as AiAppendResult, tt as AiRunStepStatus, u as AiChatRecord, v as AiModerationEvent, w as AiProjectInput, x as AiPendingInput, y as AiModerationInput, z as createAiChat } from "../../ai-chat-DXkMy74O.js";
+import { $ as AiRunStep, A as AiStoredMessageStatus, B as AiSandbox, C as AiProject, D as AiSaveResult, E as AiRunStatus, F as AiUserMessageTrigger, G as AiHarnessSession, H as AiSandboxStopper, I as SharedAiChat, J as AiHarnessStatus, K as AiHarnessSessionPatch, L as aiChatListTopic, M as AiToolApproval, N as AiToolApprovalRequest, O as AiShareLink, P as AiToolPolicy, Q as AiRunState, R as aiChatTopic, S as AiPendingInputRequest, T as AiRunRelease, U as AiSandboxes, V as AiSandboxStatus, W as NewAiSandbox, X as AiRun, Y as AiPendingApproval, Z as AiRunQuery, _ as AiModerationAction, a as AiChatInput, b as AiModerationStage, c as AiChatPatch, d as AiChatShare, et as AiRunStepInput, f as AiChatVisibility, g as AiModelInput, h as AiModel, i as AiChat, j as AiStreamClaim, k as AiStoredMessage, l as AiChatQuery, m as AiMessageSibling, n as AiApprovalDecision, nt as AiRuns, o as AiChatOptions, p as AiFeedback, q as AiHarnessSessions, r as AiAssistantMessageOptions, rt as createHarnessSessions, s as AiChatPage, t as AiAppendResult, tt as AiRunStepStatus, u as AiChatRecord, v as AiModerationEvent, w as AiProjectInput, x as AiPendingInput, y as AiModerationInput, z as createAiChat } from "../../ai-chat-3GBSlFR4.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+import { _ as createAiChatTreeController, a as AiChatsActions, b as createAiShareController, c as AiChatsSnapshot, d as AiModelsControllerOptions, f as AiModelsSnapshot, g as AiShareSnapshot, h as AiShareControllerOptions, i as AiChatTreeSnapshot, l as AiModelsActions, m as AiShareController, n as AiChatTreeController, o as AiChatsController, p as AiShareActions, r as AiChatTreeControllerOptions, s as AiChatsControllerOptions, t as AiChatTreeActions, u as AiModelsController, v as createAiChatsController, y as createAiModelsController } from "../../client-DdfSIZ3M.js";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/core/contracts/ai-message.d.ts
 /** The `type` of each part in the canonical AI message (version 1); the SQL module and the message code both read it. */
@@ -33,4 +36,20 @@ export declare const INTERRUPTED_TOOL_OUTPUT = "The tool call was interrupted.";
  */
 export declare function repairDanglingToolCalls(messages: readonly AiMessage[]): AiMessage[];
 //#endregion
-export { AI_MESSAGE_SCHEMA_ID, type AiAppendResult, type AiApprovalDecision, type AiAssistantMessageOptions, type AiChat, type AiChatInput, type AiChatOptions, type AiChatPage, type AiChatPatch, type AiChatQuery, type AiChatRecord, type AiChatShare, type AiChatVisibility, type AiDataPart, type AiFeedback, type AiFilePart, type AiHarnessSession, type AiHarnessSessionPatch, type AiHarnessSessions, type AiHarnessStatus, type AiMessage, type AiMessageCheck, type AiMessagePart, type AiMessagePartType, type AiMessageRole, type AiMessageSibling, type AiModel, type AiModelInput, type AiModerationAction, type AiModerationEvent, type AiModerationInput, type AiModerationStage, type AiPendingApproval, type AiPendingInput, type AiPendingInputRequest, type AiProject, type AiProjectInput, type AiReasoningPart, type AiRun, type AiRunQuery, type AiRunRelease, type AiRunState, type AiRunStatus, type AiRunStep, type AiRunStepInput, type AiRunStepStatus, type AiRuns, type AiSandbox, type AiSandboxStatus, type AiSandboxStopper, type AiSandboxes, type AiSaveResult, type AiShareLink, type AiSourcePart, type AiStepPart, type AiStoredMessage, type AiStoredMessageStatus, type AiStreamClaim, type AiTextPart, type AiToolApproval, type AiToolApprovalPart, type AiToolApprovalRequest, type AiToolCallPart, type AiToolPolicy, type AiToolResultPart, type AiUserMessageTrigger, type BlockTransport, type NewAiSandbox, type SharedAiChat, aiChatListTopic, aiChatTopic, aiMessageSchema, createAiChat, createHarnessSessions, dbTransport, isAiMessage, rpcTransport, sqlTransport };
+//#region src/blocks/ai-chat/events.d.ts
+/** The events of the `ai-chat` block: type to data. */
+type AiChatEvents = {
+  readonly "ai_tool_policy.set": AiToolEventData;
+  readonly "ai_tool_approval.decided": AiToolEventData;
+  readonly "ai_chat_message.completed": AiChatEventData;
+  readonly "ai_chat.shared": AiChatEventData;
+  readonly "ai_chat.share_revoked": AiChatEventData;
+};
+/** The `ai-chat` block's event types, for its manifest and `onBlockEvent`. */
+export declare const aiChatEvents: Events<AiChatEvents>;
+//#endregion
+//#region src/blocks/ai-chat/manifest.d.ts
+/** The `ai-chat` block's manifest (ADR 0029). */
+export declare const aiChatBlock: BlockOf<"ai-chat", typeof createAiChat, AiChatEvents>;
+//#endregion
+export { AI_MESSAGE_SCHEMA_ID, type AiAppendResult, type AiApprovalDecision, type AiAssistantMessageOptions, type AiChat, type AiChatEvents, type AiChatInput, type AiChatOptions, type AiChatPage, type AiChatPatch, type AiChatQuery, type AiChatRecord, type AiChatShare, type AiChatTreeActions, type AiChatTreeController, type AiChatTreeControllerOptions, type AiChatTreeSnapshot, type AiChatVisibility, type AiChatsActions, type AiChatsController, type AiChatsControllerOptions, type AiChatsSnapshot, type AiDataPart, type AiFeedback, type AiFilePart, type AiHarnessSession, type AiHarnessSessionPatch, type AiHarnessSessions, type AiHarnessStatus, type AiMessage, type AiMessageCheck, type AiMessagePart, type AiMessagePartType, type AiMessageRole, type AiMessageSibling, type AiModel, type AiModelInput, type AiModelsActions, type AiModelsController, type AiModelsControllerOptions, type AiModelsSnapshot, type AiModerationAction, type AiModerationEvent, type AiModerationInput, type AiModerationStage, type AiPendingApproval, type AiPendingInput, type AiPendingInputRequest, type AiProject, type AiProjectInput, type AiReasoningPart, type AiRun, type AiRunQuery, type AiRunRelease, type AiRunState, type AiRunStatus, type AiRunStep, type AiRunStepInput, type AiRunStepStatus, type AiRuns, type AiSandbox, type AiSandboxStatus, type AiSandboxStopper, type AiSandboxes, type AiSaveResult, type AiShareActions, type AiShareController, type AiShareControllerOptions, type AiShareLink, type AiShareSnapshot, type AiSourcePart, type AiStepPart, type AiStoredMessage, type AiStoredMessageStatus, type AiStreamClaim, type AiTextPart, type AiToolApproval, type AiToolApprovalPart, type AiToolApprovalRequest, type AiToolCallPart, type AiToolPolicy, type AiToolResultPart, type AiUserMessageTrigger, type BlockTransport, type NewAiSandbox, type SharedAiChat, aiChatListTopic, aiChatTopic, aiMessageSchema, createAiChat, createAiChatTreeController, createAiChatsController, createAiModelsController, createAiShareController, createHarnessSessions, dbTransport, isAiMessage, rpcTransport, sqlTransport };

package/dist/blocks/ai-chat/index.js

@@ -1,5 +1,31 @@
-import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-bAKh-dGc.js";
+import { n as event, t as defineEvents } from "../../event-map-Dy2vKHai.js";
+import { i as sqlTransport, r as rpcTransport, t as dbTransport } from "../../block-transport-G4t1umrR.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
 import { t as AI_MESSAGE_PART_TYPES } from "../../ai-message-DfaP8sis.js";
 import { a as AI_MESSAGE_SCHEMA_ID, i as validateMessage, n as pathToHistory, o as aiMessageSchema, r as repairDanglingToolCalls, s as isAiMessage, t as INTERRUPTED_TOOL_OUTPUT } from "../../history-GH1HJWQV.js";
-import { i as createHarnessSessions, n as aiChatTopic, r as createAiChat, t as aiChatListTopic } from "../../ai-chat-CVLRWbtS.js";
-export { AI_MESSAGE_PART_TYPES, AI_MESSAGE_SCHEMA_ID, INTERRUPTED_TOOL_OUTPUT, aiChatListTopic, aiChatTopic, aiMessageSchema, createAiChat, createHarnessSessions, dbTransport, isAiMessage, pathToHistory, repairDanglingToolCalls, rpcTransport, sqlTransport, validateMessage };
+import { a as aiChatListTopic, c as createHarnessSessions, i as createAiShareController, n as createAiChatsController, o as aiChatTopic, r as createAiModelsController, s as createAiChat, t as createAiChatTreeController } from "../../client-BUGIS__1.js";
+import { t as aiChatSqlOptions } from "../../options-qU8vgxhO.js";
+//#region src/blocks/ai-chat/events.ts
+/** The `ai-chat` block's event types, for its manifest and `onBlockEvent`. */
+const aiChatEvents = defineEvents({
+	"ai_tool_policy.set": event(),
+	"ai_tool_approval.decided": event(),
+	"ai_chat_message.completed": event(),
+	"ai_chat.shared": event(),
+	"ai_chat.share_revoked": event()
+});
+//#endregion
+//#region src/blocks/ai-chat/manifest.ts
+/** The `ai-chat` block's manifest (ADR 0029). */
+const aiChatBlock = defineBlock({
+	name: "ai-chat",
+	sql: ["ai-chat"],
+	options: { "ai-chat": aiChatSqlOptions },
+	events: aiChatEvents,
+	create: createAiChat,
+	client: "ai-chat",
+	category: "ai",
+	recipes: ["chat-with-history"]
+});
+//#endregion
+export { AI_MESSAGE_PART_TYPES, AI_MESSAGE_SCHEMA_ID, INTERRUPTED_TOOL_OUTPUT, aiChatBlock, aiChatEvents, aiChatListTopic, aiChatTopic, aiMessageSchema, createAiChat, createAiChatTreeController, createAiChatsController, createAiModelsController, createAiShareController, createHarnessSessions, dbTransport, isAiMessage, pathToHistory, repairDanglingToolCalls, rpcTransport, sqlTransport, validateMessage };

package/dist/blocks/ai-chat/react/index.d.ts

@@ -1,28 +1,15 @@
-import { b as DbError } from "../../../result-BchM1XZn.js";
-import { O as AiShareLink, a as AiChatInput, c as AiChatPatch, d as AiChatShare, h as AiModel, k as AiStoredMessage, l as AiChatQuery, u as AiChatRecord } from "../../../ai-chat-DXkMy74O.js";
-import { x as SubscriptionStatus } from "../../../index-BCHR4Ucl.js";
+import { l as AiChatQuery } from "../../../ai-chat-3GBSlFR4.js";
+import { a as AiChatsActions, c as AiChatsSnapshot, f as AiModelsSnapshot, g as AiShareSnapshot, i as AiChatTreeSnapshot, l as AiModelsActions, p as AiShareActions, t as AiChatTreeActions } from "../../../client-DdfSIZ3M.js";
 //#region src/blocks/ai-chat/react/index.d.ts
 interface ClientOptions {
-  /** The schema the calls go to: the module schema (default `better_supabase`), or the API schema from `sql.modules["ai-chat"].api`. */
+  /** The schema the calls go to: the module schema (default `better_supabase`), or the API schema from `blocks["ai-chat"].api`. */
   readonly schema?: string;
 }
-export interface UseAiChatsOptions extends ClientOptions, Omit<AiChatQuery, "after" | "cursor"> {
-  /** The prefix of the list topic (`sql.modules["ai-chat"].options.listTopic`); `null` loads once. */
+export interface UseAiChatsOptions extends ClientOptions, Omit<AiChatQuery, "cursor"> {
+  /** The prefix of the list topic (`blockConfig["ai-chat"].options.listTopic` from `blocks.generated.ts`); `null` loads once. */
   readonly topic?: string | null;
 }
-export interface AiChatsState {
-  /** `undefined` until the first load. */
-  readonly items: readonly AiChatRecord[] | undefined;
-  /** Whether `loadMore` has another page. */
-  readonly hasMore: boolean;
-  readonly status: SubscriptionStatus;
-  readonly error: DbError | undefined;
-  readonly loadMore: () => Promise<void>;
-  readonly refresh: () => Promise<void>;
-  readonly create: (input?: AiChatInput) => Promise<AiChatRecord | undefined>;
-  readonly update: (chatId: string, patch: AiChatPatch) => Promise<AiChatRecord | undefined>;
-  readonly remove: (chatId: string) => Promise<void>;
-}
+export interface AiChatsState extends AiChatsSnapshot, AiChatsActions {}
 /**
  * The signed-in user's chats in a tenant, newest first, loaded again when
  * any of their chats changes.
@@ -33,20 +20,10 @@ export interface AiChatsState {
  */
 export declare function useAiChats(options?: UseAiChatsOptions): AiChatsState;
 export interface UseAiChatTreeOptions extends ClientOptions {
-  /** The prefix of the chat topic (`sql.modules["ai-chat"].options.topic`); `null` loads once. */
+  /** The prefix of the chat topic (`blockConfig["ai-chat"].options.topic` from `blocks.generated.ts`); `null` loads once. */
   readonly topic?: string | null;
 }
-export interface AiChatTreeState {
-  /** The active branch, root first; `undefined` until the first load. */
-  readonly path: readonly AiStoredMessage[] | undefined;
-  readonly status: SubscriptionStatus;
-  readonly error: DbError | undefined;
-  readonly refresh: () => Promise<void>;
-  /** Shows the branch through `messageId`. */
-  readonly switchBranch: (messageId: string) => Promise<void>;
-  /** Shows the sibling `offset` places from `messageId` (`-1` older, `1` newer). */
-  readonly step: (messageId: string, offset: number) => Promise<void>;
-}
+export interface AiChatTreeState extends AiChatTreeSnapshot, AiChatTreeActions {}
 /**
  * One chat's active branch, loaded again when a message is saved or the
  * branch changes, in this tab or another.
@@ -56,22 +33,11 @@ export interface AiChatTreeState {
  * ```
  */
 export declare function useAiChatTree(chatId: string | null | undefined, options?: UseAiChatTreeOptions): AiChatTreeState;
-export interface AiModelsState {
-  /** `undefined` until loaded. */
-  readonly models: readonly AiModel[] | undefined;
-  readonly error: DbError | undefined;
-  readonly refresh: () => Promise<void>;
-}
+export interface AiModelsState extends AiModelsSnapshot, AiModelsActions {}
 /** The models the tenant's plans allow, for a model picker. */
 export declare function useAiModels(organizationId?: string | null, options?: ClientOptions): AiModelsState;
-export interface AiShareState {
-  /** The chat's share links, newest first; `undefined` until loaded. */
-  readonly shares: readonly AiChatShare[] | undefined;
-  readonly error: DbError | undefined;
-  /** Makes a link to the active branch, or to `leafId`; the token is in the result only. */
-  readonly create: (leafId?: string) => Promise<AiShareLink | undefined>;
-  readonly revoke: (shareId: string) => Promise<void>;
-}
+export interface AiShareState extends AiShareSnapshot, AiShareActions {}
 /** Share links for one chat the user owns. */
 export declare function useAiShare(chatId: string | null | undefined, options?: ClientOptions): AiShareState;
-//#endregion
+//#endregion
+export {};

package/dist/blocks/ai-chat/react/index.js

@@ -1,46 +1,17 @@
 "use client";
-import { a as ok } from "../../../result-DEqHCMKP.js";
-import { i as useAuth, l as useSupabase } from "../../../hooks-Bhza9Hnr.js";
-import { r as rpcTransport } from "../../../block-transport-bAKh-dGc.js";
-import { y as pageOf } from "../../../block-helpers-Cy3pB96I.js";
-import { t as watchTopic } from "../../../react-topic-seAWjL3_.js";
-import { n as aiChatTopic, r as createAiChat, t as aiChatListTopic } from "../../../ai-chat-CVLRWbtS.js";
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { r as rpcTransport } from "../../../block-transport-G4t1umrR.js";
+import { t as useController } from "../../../react-controller-Xn-IU44p.js";
+import { t as useBlockEnv } from "../../../react-env-Cc7Vf6eb.js";
+import { i as createAiShareController, n as createAiChatsController, r as createAiModelsController, s as createAiChat, t as createAiChatTreeController } from "../../../client-BUGIS__1.js";
+import { useMemo } from "react";
 //#region src/blocks/ai-chat/react/index.ts
 function useAiChatClient(schema) {
-	const supabase = useSupabase();
+	const { supabase } = useBlockEnv();
 	return useMemo(() => createAiChat({
 		transport: rpcTransport(supabase),
 		...schema === void 0 ? {} : { schema }
 	}), [supabase, schema]);
 }
-/** Keeps a result's data, or its error next to the last good data. */
-function useResultState() {
-	const [data, setData] = useState(void 0);
-	const [error, setError] = useState(void 0);
-	return {
-		data,
-		error,
-		apply: useCallback((result) => {
-			if (result.ok) {
-				setData(result.data);
-				setError(void 0);
-			} else setError(result.error);
-		}, []),
-		fail: setError,
-		set: setData,
-		reset: useCallback(() => {
-			setData(void 0);
-			setError(void 0);
-		}, [])
-	};
-}
-/** Runs a write and returns its data, or records the error and returns `undefined`. */
-async function attempt(write, fail) {
-	const result = await write;
-	if (result.ok) return result.data;
-	fail(result.error);
-}
 /**
 * The signed-in user's chats in a tenant, newest first, loaded again when
 * any of their chats changes.
@@ -50,160 +21,34 @@ async function attempt(write, fail) {
 * ```
 */
 function useAiChats(options = {}) {
-	const supabase = useSupabase();
-	const auth = useAuth();
+	const { auth, ports } = useBlockEnv();
 	const client = useAiChatClient(options.schema);
-	const state = useResultState();
-	const [next, setNext] = useState(void 0);
-	const [status, setStatus] = useState("closed");
-	const userId = auth.user?.id ?? null;
-	const prefix = options.topic === void 0 ? "ai-chats" : options.topic;
-	const { organizationId, search, projectId, pinned, archived } = options;
-	const { limit } = pageOf(options);
-	const query = useMemo(() => ({
-		organizationId: organizationId ?? null,
-		...search === void 0 ? {} : { search },
-		...projectId === void 0 ? {} : { projectId },
-		...pinned === void 0 ? {} : { pinned },
-		...archived === void 0 ? {} : { archived },
-		...limit === void 0 ? {} : { limit }
+	const { topic, organizationId, search, projectId, pinned, archived, limit } = options;
+	return useController(() => createAiChatsController({
+		client,
+		auth,
+		ports,
+		query: {
+			organizationId: organizationId ?? null,
+			...search === void 0 ? {} : { search },
+			...projectId === void 0 ? {} : { projectId },
+			...pinned === void 0 ? {} : { pinned },
+			...archived === void 0 ? {} : { archived },
+			...limit === void 0 ? {} : { limit }
+		},
+		...topic === void 0 ? {} : { topic }
 	}), [
+		client,
+		auth,
+		ports,
+		topic,
 		organizationId,
 		search,
 		projectId,
 		pinned,
 		archived,
 		limit
-	]);
-	const { apply, fail, set, reset } = state;
-	const scope = useMemo(() => ({
-		client,
-		query,
-		userId
-	}), [
-		client,
-		query,
-		userId
-	]);
-	const [shown, setShown] = useState(scope);
-	if (shown !== scope) {
-		setShown(scope);
-		reset();
-		setNext(void 0);
-	}
-	const current = useRef(scope);
-	const ticket = useRef(0);
-	const pages = useRef(1);
-	const loadWindow = useCallback(async () => {
-		if (scope.userId === null || current.current !== scope) return;
-		const run = ++ticket.current;
-		const items = [];
-		let page;
-		for (let loaded = 0; loaded < pages.current; loaded += 1) {
-			const result = await scope.client.chats.list(page?.next === void 0 ? scope.query : {
-				...scope.query,
-				cursor: page.next
-			});
-			if (run !== ticket.current) return;
-			if (!result.ok) {
-				fail(result.error);
-				return;
-			}
-			page = result.data;
-			items.push(...page.items);
-			if (page.next === void 0) break;
-		}
-		apply(ok(items));
-		setNext(page?.next);
-	}, [
-		scope,
-		apply,
-		fail
-	]);
-	const loadMore = useCallback(async () => {
-		if (next === void 0 || current.current !== scope) return;
-		const run = ++ticket.current;
-		pages.current += 1;
-		const result = await scope.client.chats.list({
-			...scope.query,
-			cursor: next
-		});
-		if (run !== ticket.current) return;
-		if (!result.ok) {
-			pages.current -= 1;
-			fail(result.error);
-			return;
-		}
-		const page = result.data;
-		set((items) => [...items ?? [], ...page.items]);
-		setNext(page.next);
-	}, [
-		scope,
-		next,
-		fail,
-		set
-	]);
-	const create = useCallback(async (input) => {
-		if (!organizationId) return;
-		const chat = await attempt(client.chats.create(organizationId, input), fail);
-		if (chat && !chat.temporary && current.current === scope) set((items) => [chat, ...(items ?? []).filter((item) => item.id !== chat.id)]);
-		return chat;
-	}, [
-		client,
-		scope,
-		organizationId,
-		fail,
-		set
-	]);
-	const update = useCallback(async (chatId, patch) => {
-		const chat = await attempt(client.chats.update(chatId, patch), fail);
-		if (chat && current.current === scope) set((items) => items?.map((item) => item.id === chat.id ? chat : item));
-		return chat;
-	}, [
-		client,
-		scope,
-		fail,
-		set
-	]);
-	const remove = useCallback(async (chatId) => {
-		if (await attempt(client.chats.remove(chatId), fail) && current.current === scope) set((items) => items?.filter((item) => item.id !== chatId));
-	}, [
-		client,
-		scope,
-		fail,
-		set
-	]);
-	useEffect(() => {
-		current.current = scope;
-		ticket.current += 1;
-		pages.current = 1;
-		loadWindow();
-	}, [scope, loadWindow]);
-	useEffect(() => {
-		if (userId === null || !prefix) return;
-		const reload = () => void loadWindow();
-		return watchTopic(supabase, aiChatListTopic(userId, prefix), {
-			onMessage: reload,
-			onRejoin: reload,
-			onStatus: setStatus
-		});
-	}, [
-		supabase,
-		prefix,
-		userId,
-		loadWindow
-	]);
-	return {
-		items: state.data,
-		hasMore: next !== void 0,
-		status,
-		error: state.error,
-		loadMore,
-		refresh: loadWindow,
-		create,
-		update,
-		remove
-	};
+	]).view;
 }
 /**
 * One chat's active branch, loaded again when a message is saved or the
@@ -214,174 +59,37 @@ function useAiChats(options = {}) {
 * ```
 */
 function useAiChatTree(chatId, options = {}) {
-	const supabase = useSupabase();
+	const { ports } = useBlockEnv();
 	const client = useAiChatClient(options.schema);
-	const state = useResultState();
-	const [status, setStatus] = useState("closed");
-	const prefix = options.topic === void 0 ? "ai-chat" : options.topic;
-	const { apply, fail, reset } = state;
-	const path = state.data;
-	const scope = useMemo(() => ({
+	const { topic } = options;
+	return useController(() => createAiChatTreeController({
 		client,
-		chatId
-	}), [client, chatId]);
-	const [shown, setShown] = useState(scope);
-	if (shown !== scope) {
-		setShown(scope);
-		reset();
-	}
-	const current = useRef(scope);
-	const ticket = useRef(0);
-	const loadPath = useCallback(async (leafId) => {
-		const id = scope.chatId;
-		if (!id || current.current !== scope) return;
-		const run = ++ticket.current;
-		const result = await scope.client.messages.path(id, leafId === void 0 ? void 0 : { leafId });
-		if (run === ticket.current) apply(result);
-	}, [scope, apply]);
-	const refresh = useCallback(() => loadPath(), [loadPath]);
-	const switchBranch = useCallback(async (messageId) => {
-		const id = scope.chatId;
-		if (!id || current.current !== scope) return;
-		const result = await scope.client.messages.switchBranch(id, messageId);
-		if (current.current !== scope) return;
-		if (result.ok) await loadPath(result.data);
-		else fail(result.error);
-	}, [
-		scope,
-		loadPath,
-		fail
-	]);
-	const step = useCallback(async (messageId, offset) => {
-		const id = scope.chatId;
-		if (!id || current.current !== scope) return;
-		const result = await scope.client.messages.siblings(id, messageId);
-		if (current.current !== scope) return;
-		if (!result.ok) {
-			fail(result.error);
-			return;
-		}
-		const siblings = result.data;
-		const index = siblings.findIndex((item) => item.id === messageId);
-		const target = siblings[index + offset];
-		if (index >= 0 && target) await switchBranch(target.id);
-	}, [
-		scope,
-		fail,
-		switchBranch
-	]);
-	useEffect(() => {
-		current.current = scope;
-		ticket.current += 1;
-		loadPath();
-	}, [scope, loadPath]);
-	useEffect(() => {
-		if (!chatId || !prefix) return;
-		const reload = () => void loadPath();
-		return watchTopic(supabase, aiChatTopic(chatId, prefix), {
-			onMessage: (event) => {
-				if (event === "message.saved" || event === "leaf.changed") reload();
-			},
-			onRejoin: reload,
-			onStatus: setStatus
-		});
-	}, [
-		supabase,
-		prefix,
+		ports,
 		chatId,
-		loadPath
-	]);
-	return {
-		path,
-		status,
-		error: state.error,
-		refresh,
-		switchBranch,
-		step
-	};
+		...topic === void 0 ? {} : { topic }
+	}), [
+		client,
+		ports,
+		chatId,
+		topic
+	]).view;
 }
 /** The models the tenant's plans allow, for a model picker. */
 function useAiModels(organizationId, options = {}) {
 	const client = useAiChatClient(options.schema);
-	const state = useResultState();
 	const tenant = organizationId ?? null;
-	const { apply } = state;
-	const refresh = useCallback(async () => {
-		apply(await client.models.allowed(tenant));
-	}, [
+	return useController(() => createAiModelsController({
 		client,
-		tenant,
-		apply
-	]);
-	useEffect(() => {
-		let active = true;
-		client.models.allowed(tenant).then((result) => {
-			if (active) apply(result);
-		});
-		return () => {
-			active = false;
-		};
-	}, [
-		client,
-		tenant,
-		apply
-	]);
-	return {
-		models: state.data,
-		error: state.error,
-		refresh
-	};
+		organizationId: tenant
+	}), [client, tenant]).view;
 }
 /** Share links for one chat the user owns. */
 function useAiShare(chatId, options = {}) {
 	const client = useAiChatClient(options.schema);
-	const state = useResultState();
-	const { apply, fail } = state;
-	const reload = useCallback(async () => {
-		if (chatId) apply(await client.shares.list(chatId));
-	}, [
-		client,
-		chatId,
-		apply
-	]);
-	const create = useCallback(async (leafId) => {
-		if (!chatId) return;
-		const link = await attempt(client.shares.create(chatId, leafId), fail);
-		if (link) await reload();
-		return link;
-	}, [
+	return useController(() => createAiShareController({
 		client,
-		chatId,
-		fail,
-		reload
-	]);
-	const revoke = useCallback(async (shareId) => {
-		if (await attempt(client.shares.revoke(shareId), fail)) await reload();
-	}, [
-		client,
-		fail,
-		reload
-	]);
-	useEffect(() => {
-		if (!chatId) return;
-		let active = true;
-		client.shares.list(chatId).then((result) => {
-			if (active) apply(result);
-		});
-		return () => {
-			active = false;
-		};
-	}, [
-		client,
-		chatId,
-		apply
-	]);
-	return {
-		shares: state.data,
-		error: state.error,
-		create,
-		revoke
-	};
+		chatId
+	}), [client, chatId]).view;
 }
 //#endregion
 export { useAiChatTree, useAiChats, useAiModels, useAiShare };

package/dist/blocks/ai-chat/solid/index.d.ts

@@ -0,0 +1,34 @@
+import { a as AiChatsActions, c as AiChatsSnapshot, d as AiModelsControllerOptions, f as AiModelsSnapshot, g as AiShareSnapshot, h as AiShareControllerOptions, i as AiChatTreeSnapshot, l as AiModelsActions, p as AiShareActions, r as AiChatTreeControllerOptions, s as AiChatsControllerOptions, t as AiChatTreeActions } from "../../../client-DdfSIZ3M.js";
+import { t as BlockOptions } from "../../../block-env-Dxl7rsI0.js";
+import { t as SolidController } from "../../../solid-controller-DqlvYFZa.js";
+//#region src/blocks/ai-chat/solid/index.d.ts
+/**
+ * `createAiChatsController` as a Solid primitive: `state()` reads the snapshot.
+ * Call it in a component; the work starts on mount and the controller is
+ * disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useAiChats(options: BlockOptions<AiChatsControllerOptions>): SolidController<AiChatsSnapshot, AiChatsActions>;
+/**
+ * `createAiChatTreeController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useAiChatTree(options: BlockOptions<AiChatTreeControllerOptions>): SolidController<AiChatTreeSnapshot, AiChatTreeActions>;
+/**
+ * `createAiModelsController` as a Solid primitive: `state()` reads the
+ * snapshot. Call it in a component; the work starts on mount and the controller
+ * is disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useAiModels(options: BlockOptions<AiModelsControllerOptions>): SolidController<AiModelsSnapshot, AiModelsActions>;
+/**
+ * `createAiShareController` as a Solid primitive: `state()` reads the snapshot.
+ * Call it in a component; the work starts on mount and the controller is
+ * disposed with the owner. `auth` and `ports` default to the client of
+ * `<BetterSupabaseProvider client={bs}>`.
+ */
+export declare function useAiShare(options: BlockOptions<AiShareControllerOptions>): SolidController<AiShareSnapshot, AiShareActions>;
+//#endregion
+export type { AiChatTreeActions, AiChatTreeControllerOptions, AiChatTreeSnapshot, AiChatsActions, AiChatsControllerOptions, AiChatsSnapshot, AiModelsActions, AiModelsControllerOptions, AiModelsSnapshot, AiShareActions, AiShareControllerOptions, AiShareSnapshot, BlockOptions, SolidController };

package/dist/blocks/ai-chat/solid/index.js

@@ -0,0 +1,41 @@
+import { t as useBlockController } from "../../../solid-controller-DLsmrczT.js";
+import { i as createAiShareController, n as createAiChatsController, r as createAiModelsController, t as createAiChatTreeController } from "../../../client-BUGIS__1.js";
+//#region src/blocks/ai-chat/solid/index.ts
+/**
+* `createAiChatsController` as a Solid primitive: `state()` reads the snapshot.
+* Call it in a component; the work starts on mount and the controller is
+* disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useAiChats(options) {
+	return useBlockController(createAiChatsController, options);
+}
+/**
+* `createAiChatTreeController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useAiChatTree(options) {
+	return useBlockController(createAiChatTreeController, options);
+}
+/**
+* `createAiModelsController` as a Solid primitive: `state()` reads the
+* snapshot. Call it in a component; the work starts on mount and the controller
+* is disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useAiModels(options) {
+	return useBlockController(createAiModelsController, options, false);
+}
+/**
+* `createAiShareController` as a Solid primitive: `state()` reads the snapshot.
+* Call it in a component; the work starts on mount and the controller is
+* disposed with the owner. `auth` and `ports` default to the client of
+* `<BetterSupabaseProvider client={bs}>`.
+*/
+function useAiShare(options) {
+	return useBlockController(createAiShareController, options, false);
+}
+//#endregion
+export { useAiChatTree, useAiChats, useAiModels, useAiShare };