better-supabase 0.7.1 → 0.9.0

package/dist/blocks/access-requests/index.d.ts

@@ -0,0 +1,98 @@
+/// <reference lib="esnext.temporal" />
+import { t as AsyncResult, w as ErrorMapper } from "../../result-Cj3yWhjH.js";
+import { f as AccessRequestEventData, wt as Events } from "../../events-CTreRrgP.js";
+import { n as Logger } from "../../logger-DWVYUmwi.js";
+import { t as StandardSchemaV1 } from "../../standard-C3_AAF3g.js";
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { r as BlockTemporalOptions } from "../../block-helpers-C86hPEjI.js";
+import { n as BlockHooks } from "../../block-hooks-BLPWD3Jt.js";
+import { r as FieldsOf } from "../../block-fields-5UA84ZUg.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+//#region src/blocks/access-requests/access-requests.d.ts
+interface AccessRequestsOptions<S extends StandardSchemaV1 | undefined = undefined> extends BlockTemporalOptions {
+  readonly transport: BlockTransport;
+  /** The module schema, or its API schema: `defineBlocks` passes it from `blocks.generated.ts`. */
+  readonly schema?: string;
+  /**
+   * A Standard Schema for the request columns the app adds
+   * (`blocks.access-requests.options.extraColumns`), keyed by column name.
+   * It types and parses them on every read, and validates them on
+   * `request`, which returns a `validation` error for a bad value.
+   */
+  readonly fields?: S;
+  /** `withBlockHooks` hooks around the client's methods. */
+  readonly hooks?: NoInfer<BlockHooks<AccessRequests<FieldsOf<S>>>>;
+  /** Receives the errors `after` hooks throw. Default: `console`. */
+  readonly logger?: Logger;
+  readonly mappers?: readonly ErrorMapper[];
+}
+/**
+ * `pending`, `rejected`, `cancelled` and `expired` follow the approval
+ * request; `granted` and `ended` follow the role itself.
+ */
+type AccessRequestStatus = "pending" | "granted" | "rejected" | "cancelled" | "expired" | "ended";
+interface AccessRequest {
+  readonly id: string;
+  readonly organizationId: string;
+  readonly userId: string;
+  readonly role: string;
+  /** The role the member held before the grant; unset for a new member. */
+  readonly previousRole?: string;
+  readonly reason?: string;
+  readonly duration?: Temporal.Duration;
+  readonly status: AccessRequestStatus;
+  /** The approvals request; approve, reject or cancel it there. */
+  readonly approvalId?: string;
+  readonly grantedAt?: Temporal.Instant;
+  /** When the grant ends; unset for a grant without a duration. */
+  readonly expiresAt?: Temporal.Instant;
+  readonly endedAt?: Temporal.Instant;
+  readonly createdAt: Temporal.Instant;
+}
+interface AccessRequestInput {
+  readonly organizationId: string;
+  readonly role: string;
+  readonly reason?: string;
+  /** How long the role lasts. Default: `options.maxDuration`, else no end. */
+  readonly duration?: Temporal.Duration;
+}
+interface AccessRequestListOptions {
+  /** Default: every status. */
+  readonly status?: AccessRequestStatus;
+  /** Only the caller's requests, even for readers of the organization. */
+  readonly mine?: boolean;
+  readonly pageSize?: number;
+  /** Requests made before this time, for the next page. */
+  readonly before?: Temporal.Instant;
+}
+/** `F` is the extra fields `options.fields` describes. */
+interface AccessRequests<F extends object = Record<never, never>> {
+  /**
+   * Asks for a role; the approvals module routes it to the approvers. Keys
+   * besides the input's own are the request's extra columns.
+   */
+  request(input: AccessRequestInput & Partial<F>): AsyncResult<AccessRequest & F>;
+  /** Ends a granted role early: a manager, or the holder giving it up. */
+  end(id: string): AsyncResult<AccessRequest & F>;
+  get(id: string): AsyncResult<AccessRequest & F>;
+  /** Newest first. */
+  list(organizationId: string, options?: AccessRequestListOptions): AsyncResult<readonly (AccessRequest & F)[]>;
+}
+/** The `access-requests` SQL module as typed calls. */
+export declare function createAccessRequests<S extends StandardSchemaV1 | undefined = undefined>(options: AccessRequestsOptions<S>): AccessRequests<FieldsOf<S>>;
+//#endregion
+//#region src/blocks/access-requests/events.d.ts
+/** The events of the `access-requests` block: type to data. */
+type AccessRequestsEvents = {
+  readonly "access.requested": AccessRequestEventData;
+  readonly "access.request_approved": AccessRequestEventData;
+  readonly "access.ended": AccessRequestEventData;
+};
+/** The `access-requests` block's event types, for its manifest and `onBlockEvent`. */
+export declare const accessRequestsEvents: Events<AccessRequestsEvents>;
+//#endregion
+//#region src/blocks/access-requests/manifest.d.ts
+/** The `access-requests` block's manifest (ADR 0029). */
+export declare const accessRequestsBlock: BlockOf<"access-requests", typeof createAccessRequests, AccessRequestsEvents>;
+//#endregion
+export { type AccessRequest, type AccessRequestInput, type AccessRequestListOptions, type AccessRequestStatus, type AccessRequests, type AccessRequestsEvents, type AccessRequestsOptions, type BlockTransport, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/access-requests/index.js

@@ -0,0 +1,99 @@
+import { t as temporal } from "../../temporal-required-DqRzr7i0.js";
+import { t as AsyncResult } from "../../result-BlgnMB0H.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 { A as requiredInstant, C as optionalText, D as recordOf, I as textOf, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
+import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { c as withFields, n as blockFields, r as extraFieldsArg, t as allWithFields } from "../../block-fields-ffD6Gxe4.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as accessRequestsSqlOptions } from "../../options-Ctac2R0Q.js";
+//#region src/blocks/access-requests/access-requests.ts
+const STATUSES = [
+	"pending",
+	"granted",
+	"rejected",
+	"cancelled",
+	"expired",
+	"ended"
+];
+function statusOf(value) {
+	const status = STATUSES.find((item) => item === value);
+	if (status === void 0) throw new TypeError(`unknown access request status ${String(value)}`);
+	return status;
+}
+const instant = (value, name) => value === null || value === void 0 ? {} : { [name]: requiredInstant(value, name) };
+function durationOf(value) {
+	const text = optionalText(value);
+	return text === void 0 ? {} : { duration: temporal().Duration.from(text) };
+}
+function requestOf(value, fn) {
+	const row = recordOf(value, fn);
+	const previousRole = optionalText(row["previousRole"]);
+	const reason = optionalText(row["reason"]);
+	const approvalId = optionalText(row["approvalId"]);
+	return {
+		id: textOf(row["id"]),
+		organizationId: textOf(row["organizationId"]),
+		userId: textOf(row["userId"]),
+		role: textOf(row["role"]),
+		status: statusOf(row["status"]),
+		createdAt: requiredInstant(row["createdAt"], "createdAt"),
+		...previousRole === void 0 ? {} : { previousRole },
+		...reason === void 0 ? {} : { reason },
+		...approvalId === void 0 ? {} : { approvalId },
+		...durationOf(row["duration"]),
+		...instant(row["grantedAt"], "grantedAt"),
+		...instant(row["expiresAt"], "expiresAt"),
+		...instant(row["endedAt"], "endedAt")
+	};
+}
+/** The `access-requests` SQL module as typed calls. */
+function createAccessRequests(options) {
+	applyTemporal(options);
+	const call = blockCall(options.transport, options.schema, options.mappers);
+	const fields = blockFields(options.fields, "access request fields");
+	const one = (fn, args) => call(fn, args, (value) => [value, requestOf(value, fn)]).andThen(([raw, row]) => withFields(fields, raw, row));
+	return withBlockHooks({
+		request: ({ organizationId, role, reason, duration, ...extra }) => AsyncResult.from(() => extraFieldsArg(fields, extra)).andThen((more) => one("request_access", {
+			tenant: organizationId,
+			role,
+			reason: reason ?? null,
+			duration: duration?.toString() ?? null,
+			...more
+		})),
+		end: (id) => one("end_access", { request_id: id }),
+		get: (id) => one("get_access_request", { request_id: id }),
+		list: (organizationId, list = {}) => call("list_access_requests", {
+			tenant: organizationId,
+			status: list.status ?? null,
+			mine: list.mine ?? false,
+			page_size: list.pageSize ?? null,
+			before: list.before?.toString() ?? null
+		}, (value) => recordsOf(value, "list_access_requests").map((raw) => [raw, requestOf(raw, "list_access_requests")])).andThen((rows) => allWithFields(fields, rows))
+	}, options.hooks, {
+		block: "access-requests",
+		...options.logger ? { logger: options.logger } : {}
+	});
+}
+//#endregion
+//#region src/blocks/access-requests/events.ts
+/** The `access-requests` block's event types, for its manifest and `onBlockEvent`. */
+const accessRequestsEvents = defineEvents({
+	"access.requested": event(),
+	"access.request_approved": event(),
+	"access.ended": event()
+});
+//#endregion
+//#region src/blocks/access-requests/manifest.ts
+/** The `access-requests` block's manifest (ADR 0029). */
+const accessRequestsBlock = defineBlock({
+	name: "access-requests",
+	sql: ["access-requests"],
+	options: { "access-requests": accessRequestsSqlOptions },
+	events: accessRequestsEvents,
+	create: createAccessRequests,
+	category: "identity",
+	recipes: ["access-requests-inbox"]
+});
+//#endregion
+export { accessRequestsBlock, accessRequestsEvents, createAccessRequests, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/agents/index.d.ts

@@ -1,3 +1,21 @@
-import { i as sqlTransport, r as rpcTransport, t as BlockTransport } from "../../block-transport-DvaoPuZ9.js";
-import { a as AgentSkill, c as AgentsOptions, i as AgentKnowledgeScope, l as NewAgent, n as AgentFields, o as AgentVisibility, r as AgentFilter, s as Agents, t as Agent, u as createAgents } from "../../agents-CVHGd7It.js";
-export { type Agent, type AgentFields, type AgentFilter, type AgentKnowledgeScope, type AgentSkill, type AgentVisibility, type Agents, type AgentsOptions, type BlockTransport, type NewAgent, createAgents, rpcTransport, sqlTransport };
+import { p as AgentEventData, 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 AgentSkill, c as AgentsOptions, i as AgentKnowledgeScope, l as NewAgent, n as AgentFields, o as AgentVisibility, r as AgentFilter, s as Agents, t as Agent, u as createAgents } from "../../agents-BCNhIxVZ.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+//#region src/blocks/agents/events.d.ts
+/** The events of the `agents` block: type to data. */
+type AgentsEvents = {
+  readonly "agent.saved": AgentEventData;
+  readonly "agent.published": AgentEventData;
+  readonly "agent.deleted": AgentEventData;
+  readonly "agent.installed": AgentEventData;
+  readonly "agent.uninstalled": AgentEventData;
+};
+/** The `agents` block's event types, for its manifest and `onBlockEvent`. */
+export declare const agentsEvents: Events<AgentsEvents>;
+//#endregion
+//#region src/blocks/agents/manifest.d.ts
+/** The `agents` block's manifest (ADR 0029). */
+export declare const agentsBlock: BlockOf<"agents", typeof createAgents, AgentsEvents>;
+//#endregion
+export { type Agent, type AgentFields, type AgentFilter, type AgentKnowledgeScope, type AgentSkill, type AgentVisibility, type Agents, type AgentsEvents, type AgentsOptions, type BlockTransport, type NewAgent, createAgents, dbTransport, rpcTransport, sqlTransport };

package/dist/blocks/agents/index.js

@@ -1,6 +1,12 @@
-import { t as AsyncResult } from "../../result-DzUbqgdW.js";
-import { n as rpcTransport, r as sqlTransport } from "../../block-transport-BLr-ZgLc.js";
-import { D as stringsOf, O as textOf, d as isRecord, f as notFoundError, h as optionalText, i as blockCall, k as toInstant, m as optionalInstant, n as applyTemporal, x as recordsOf, y as recordOf } from "../../block-helpers-DWHxHsEQ.js";
+import { t as AsyncResult } from "../../result-BlgnMB0H.js";
+import { n as isRecord } from "../../guards-6F2bCtQR.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 { C as optionalText, D as recordOf, F as stringsOf, I as textOf, S as optionalInstant, _ as notFoundError, h as instantOf, k as recordsOf, n as applyTemporal, o as blockCall } from "../../block-helpers-CfG_MvDR.js";
+import { r as withBlockHooks } from "../../block-hooks-BsXncUlZ.js";
+import { c as withFields, i as extraOf, n as blockFields, t as allWithFields } from "../../block-fields-ffD6Gxe4.js";
+import { n as defineBlock } from "../../define-block-B6Gjs57G.js";
+import { t as agentsSqlOptions } from "../../options-BxcFLL1G.js";
 //#region src/blocks/agents/agents.ts
 const VISIBILITIES = /* @__PURE__ */ new Set([
 	"private",
@@ -11,7 +17,6 @@ const visibilityOf = (value) => {
 	const text = textOf(value);
 	return VISIBILITIES.has(text) ? text : "private";
 };
-const instant = (value) => value instanceof Date ? toInstant(value) : toInstant(textOf(value));
 function scopesOf(value) {
 	if (!Array.isArray(value)) return [];
 	return value.filter(isRecord).map((item) => {
@@ -56,11 +61,22 @@ function agentOf(value) {
 		installed: row["installed"] === true,
 		myRating: rating === null || rating === void 0 ? void 0 : Number(rating),
 		skills: skillsOf(row["skills"]),
-		createdAt: instant(row["created_at"]),
-		updatedAt: instant(row["updated_at"])
+		createdAt: instantOf(row["created_at"]),
+		updatedAt: instantOf(row["updated_at"])
 	};
 }
 const notFound = () => notFoundError("No agent you can see has this id", "AGENT_NOT_FOUND");
+const AGENT_FIELDS = /* @__PURE__ */ new Set([
+	"slug",
+	"name",
+	"description",
+	"instructions",
+	"model",
+	"tools",
+	"connectorIds",
+	"knowledgeScopes",
+	"starters"
+]);
 function fieldsArg(fields) {
 	const out = {};
 	if (fields.slug !== void 0) out["slug"] = fields.slug;
@@ -78,13 +94,19 @@ function fieldsArg(fields) {
 function createAgents(options) {
 	applyTemporal(options);
 	const call = blockCall(options.transport, options.schema, options.mappers);
-	const found = (value) => isRecord(value) ? AsyncResult.ok(agentOf(value)) : AsyncResult.err(notFound());
-	const save = (organizationId, agentId, fields) => call("save_agent", {
+	const fields = blockFields(options.fields, "agent fields");
+	const typed = (value) => AsyncResult.from(() => withFields(fields, value, agentOf(value)));
+	const one = (fn, args) => call(fn, args, (value) => value).andThen(typed);
+	const found = (value) => isRecord(value) ? typed(value) : AsyncResult.err(notFound());
+	const save = (organizationId, agentId, agent) => AsyncResult.from(() => fields.write(extraOf(agent, AGENT_FIELDS))).andThen((extra) => one("save_agent", {
 		tenant: organizationId,
 		id: agentId,
-		fields: fieldsArg(fields)
-	}, agentOf);
-	return {
+		fields: {
+			...extra,
+			...fieldsArg(agent)
+		}
+	}));
+	return withBlockHooks({
 		create: (organizationId, agent) => save(organizationId, void 0, agent),
 		update: (organizationId, agentId, fields) => save(organizationId, agentId, fields),
 		get: (agentId) => call("get_agent", { id: agentId }, (value) => value).andThen(found),
@@ -97,27 +119,52 @@ function createAgents(options) {
 			filter: listOptions.filter,
 			search: listOptions.search,
 			max_rows: listOptions.limit
-		}, (value) => recordsOf(value, "list_agents").map(agentOf)),
-		publish: (agentId, visibility) => call("publish_agent", {
+		}, (value) => recordsOf(value, "list_agents").map((raw) => [raw, agentOf(raw)])).andThen((rows) => allWithFields(fields, rows)),
+		publish: (agentId, visibility) => one("publish_agent", {
 			id: agentId,
 			visibility
-		}, agentOf),
+		}),
 		install: (organizationId, agentId, installed = true) => call("install_agent", {
 			tenant: organizationId,
 			agent_id: agentId,
 			installed
 		}, (value) => value === true),
-		rate: (agentId, rating, comment) => call("rate_agent", {
+		rate: (agentId, rating, comment) => one("rate_agent", {
 			agent_id: agentId,
 			rating,
 			comment
-		}, agentOf),
+		}),
 		setSkills: (agentId, skills) => call("set_agent_skills", {
 			agent_id: agentId,
 			skills: { items: skills }
 		}, Number),
 		remove: (agentId) => call("delete_agent", { id: agentId }, (value) => value === true)
-	};
+	}, options.hooks, {
+		block: "agents",
+		...options.logger ? { logger: options.logger } : {}
+	});
 }
 //#endregion
-export { createAgents, rpcTransport, sqlTransport };
+//#region src/blocks/agents/events.ts
+/** The `agents` block's event types, for its manifest and `onBlockEvent`. */
+const agentsEvents = defineEvents({
+	"agent.saved": event(),
+	"agent.published": event(),
+	"agent.deleted": event(),
+	"agent.installed": event(),
+	"agent.uninstalled": event()
+});
+//#endregion
+//#region src/blocks/agents/manifest.ts
+/** The `agents` block's manifest (ADR 0029). */
+const agentsBlock = defineBlock({
+	name: "agents",
+	sql: ["agents"],
+	options: { agents: agentsSqlOptions },
+	events: agentsEvents,
+	create: createAgents,
+	category: "ai",
+	recipes: ["agent-run-trace"]
+});
+//#endregion
+export { agentsBlock, agentsEvents, createAgents, dbTransport, rpcTransport, sqlTransport };

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

@@ -1,3 +1,8 @@
-import { i as sqlTransport, r as rpcTransport, t as BlockTransport } from "../../block-transport-DvaoPuZ9.js";
-import { a as AiCacheSetOptions, i as AiCacheOptions, n as AiCacheEntry, o as cacheKey, r as AiCacheKind, s as createAiCache, t as AiCache } from "../../ai-cache-DaDu_G5L.js";
-export { type AiCache, type AiCacheEntry, type AiCacheKind, type AiCacheOptions, type AiCacheSetOptions, type BlockTransport, cacheKey, createAiCache, rpcTransport, sqlTransport };
+import { a as dbTransport, o as rpcTransport, s as sqlTransport, t as BlockTransport } from "../../block-transport-DaGGXjIw.js";
+import { a as AiCacheSetOptions, i as AiCacheOptions, n as AiCacheEntry, o as cacheKey, r as AiCacheKind, s as createAiCache, t as AiCache } from "../../ai-cache-Dps7aRu1.js";
+import { s as BlockOf } from "../../define-block-CLZMEFeK.js";
+//#region src/blocks/ai-cache/manifest.d.ts
+/** The `ai-cache` block's manifest (ADR 0029). */
+export declare const aiCacheBlock: BlockOf<"ai-cache", typeof createAiCache>;
+//#endregion
+export { type AiCache, type AiCacheEntry, type AiCacheKind, type AiCacheOptions, type AiCacheSetOptions, type BlockTransport, cacheKey, createAiCache, dbTransport, rpcTransport, sqlTransport };

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

@@ -1,3 +1,15 @@
-import { n as rpcTransport, r as sqlTransport } from "../../block-transport-BLr-ZgLc.js";
-import { n as createAiCache, t as cacheKey } from "../../ai-cache-CBWs1W0k.js";
-export { cacheKey, createAiCache, rpcTransport, sqlTransport };
+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 { n as createAiCache, t as cacheKey } from "../../ai-cache-zeUL94pB.js";
+import { t as aiCacheSqlOptions } from "../../options-BlOPivzq.js";
+//#region src/blocks/ai-cache/manifest.ts
+/** The `ai-cache` block's manifest (ADR 0029). */
+const aiCacheBlock = defineBlock({
+	name: "ai-cache",
+	sql: ["ai-cache"],
+	options: { "ai-cache": aiCacheSqlOptions },
+	create: createAiCache,
+	category: "ai"
+});
+//#endregion
+export { aiCacheBlock, cacheKey, createAiCache, dbTransport, rpcTransport, sqlTransport };

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

@@ -1,7 +1,15 @@
-import { i as sqlTransport, r as rpcTransport, t as BlockTransport } from "../../block-transport-DvaoPuZ9.js";
-import { _ as isAiMessage, a as AiMessage, c as AiMessageRole, d as AiStepPart, f as AiTextPart, g as aiMessageSchema, h as AiToolResultPart, i as AiFilePart, l as AiReasoningPart, m as AiToolCallPart, n as AI_MESSAGE_SCHEMA_ID, o as AiMessagePart, p as AiToolApprovalPart, r as AiDataPart, s as AiMessagePartType, t as AI_MESSAGE_PART_TYPES, u as AiSourcePart } from "../../message-CfDoR0Y6.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-7amvXjmQ.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-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. */
+type AiMessagePartTypeName = "text" | "reasoning" | "file" | "tool-call" | "tool-result" | "tool-approval" | "source" | "data" | "step";
+export declare const AI_MESSAGE_PART_TYPES: readonly AiMessagePartTypeName[];
+//#endregion
 //#region src/blocks/ai-chat/history.d.ts
 /** What `validateMessage` returns: the message, or the schema's issues. */
 type AiMessageCheck = {
@@ -28,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_PART_TYPES, 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, 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 { n as rpcTransport, r as sqlTransport } from "../../block-transport-BLr-ZgLc.js";
-import { i as isAiMessage, n as AI_MESSAGE_SCHEMA_ID, r as aiMessageSchema, t as AI_MESSAGE_PART_TYPES } from "../../message-CaKlqdsX.js";
-import { i as createHarnessSessions, n as aiChatTopic, r as createAiChat, t as aiChatListTopic } from "../../ai-chat-B24UI962.js";
-import { i as validateMessage, n as pathToHistory, r as repairDanglingToolCalls, t as INTERRUPTED_TOOL_OUTPUT } from "../../history-BZih6SFP.js";
-export { AI_MESSAGE_PART_TYPES, AI_MESSAGE_SCHEMA_ID, INTERRUPTED_TOOL_OUTPUT, aiChatListTopic, aiChatTopic, aiMessageSchema, createAiChat, createHarnessSessions, isAiMessage, pathToHistory, repairDanglingToolCalls, rpcTransport, sqlTransport, validateMessage };
+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 { 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-D7y2fT87.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-7amvXjmQ.js";
-import { x as SubscriptionStatus } from "../../../index-DunNRdnT.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 {};