@assistant-ui/core 0.1.0

package/dist/store/scopes/thread-list-item.d.ts

@@ -0,0 +1,50 @@
+import type { ThreadListItemRuntime, ThreadListItemStatus } from "../../runtime/index.js";
+export type ThreadListItemState = {
+    readonly id: string;
+    readonly remoteId: string | undefined;
+    readonly externalId: string | undefined;
+    readonly title?: string | undefined;
+    readonly status: ThreadListItemStatus;
+};
+export type ThreadListItemMethods = {
+    getState(): ThreadListItemState;
+    switchTo(): void;
+    rename(newTitle: string): void;
+    archive(): void;
+    unarchive(): void;
+    delete(): void;
+    generateTitle(): void;
+    initialize(): Promise<{
+        remoteId: string;
+        externalId: string | undefined;
+    }>;
+    detach(): void;
+    __internal_getRuntime?(): ThreadListItemRuntime;
+};
+export type ThreadListItemMeta = {
+    source: "threads";
+    query: {
+        type: "main";
+    } | {
+        type: "id";
+        id: string;
+    } | {
+        type: "index";
+        index: number;
+        archived?: boolean;
+    };
+};
+export type ThreadListItemEvents = {
+    "threadListItem.switchedTo": {
+        threadId: string;
+    };
+    "threadListItem.switchedAway": {
+        threadId: string;
+    };
+};
+export type ThreadListItemClientSchema = {
+    methods: ThreadListItemMethods;
+    meta: ThreadListItemMeta;
+    events: ThreadListItemEvents;
+};
+//# sourceMappingURL=thread-list-item.d.ts.map

package/dist/store/scopes/thread-list-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-list-item.d.ts","sourceRoot":"","sources":["../../../src/store/scopes/thread-list-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,+BAAsB;AAEvB,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,IAAI,mBAAmB,CAAC;IAChC,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,IAAI,IAAI,CAAC;IAChB,SAAS,IAAI,IAAI,CAAC;IAClB,MAAM,IAAI,IAAI,CAAC;IACf,aAAa,IAAI,IAAI,CAAC;IACtB,UAAU,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IAC5E,MAAM,IAAI,IAAI,CAAC;IACf,qBAAqB,CAAC,IAAI,qBAAqB,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EACD;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChB;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAC1B;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,2BAA2B,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,6BAA6B,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;CAC9B,CAAC"}

package/dist/store/scopes/thread-list-item.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thread-list-item.js.map

package/dist/store/scopes/thread-list-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-list-item.js","sourceRoot":"","sources":["../../../src/store/scopes/thread-list-item.ts"],"names":[],"mappings":""}

package/dist/store/scopes/thread.d.ts

@@ -0,0 +1,135 @@
+import type { ReadonlyJSONValue } from "assistant-stream/utils";
+import type { RuntimeCapabilities, SpeechState, ThreadSuggestion, ExportedMessageRepository, ThreadMessageLike, CreateAppendMessage, CreateStartRunConfig, CreateResumeRunConfig, ThreadRuntime } from "../../runtime/index.js";
+import type { ModelContext } from "../../model-context/index.js";
+import type { MessageMethods, MessageState } from "./message.js";
+import type { ComposerMethods, ComposerState } from "./composer.js";
+export type ThreadState = {
+    /**
+     * Whether the thread is empty. A thread is considered empty when it has no messages and is not loading.
+     */
+    readonly isEmpty: boolean;
+    /**
+     * Whether the thread is disabled. Disabled threads cannot receive new messages.
+     */
+    readonly isDisabled: boolean;
+    /**
+     * Whether the thread is loading its history.
+     */
+    readonly isLoading: boolean;
+    /**
+     * Whether the thread is running. A thread is considered running when there is an active stream connection to the backend.
+     */
+    readonly isRunning: boolean;
+    /**
+     * The capabilities of the thread, such as whether the thread supports editing, branch switching, etc.
+     */
+    readonly capabilities: RuntimeCapabilities;
+    /**
+     * The messages in the currently selected branch of the thread.
+     */
+    readonly messages: readonly MessageState[];
+    /**
+     * The thread state.
+     * @deprecated This feature is experimental
+     */
+    readonly state: ReadonlyJSONValue;
+    /**
+     * Follow up message suggestions to show the user.
+     */
+    readonly suggestions: readonly ThreadSuggestion[];
+    /**
+     * Custom extra information provided by the runtime.
+     */
+    readonly extras: unknown;
+    /** @deprecated This API is still under active development and might change without notice. */
+    readonly speech: SpeechState | undefined;
+    readonly composer: ComposerState;
+};
+export type ThreadMethods = {
+    /**
+     * Get the current state of the thread.
+     */
+    getState(): ThreadState;
+    /**
+     * The thread composer runtime.
+     */
+    composer(): ComposerMethods;
+    /**
+     * Append a new message to the thread.
+     *
+     * @example ```ts
+     * // append a new user message with the text "Hello, world!"
+     * threadRuntime.append("Hello, world!");
+     * ```
+     *
+     * @example ```ts
+     * // append a new assistant message with the text "Hello, world!"
+     * threadRuntime.append({
+     *   role: "assistant",
+     *   content: [{ type: "text", text: "Hello, world!" }],
+     * });
+     * ```
+     */
+    append(message: CreateAppendMessage): void;
+    /**
+     * Start a new run with the given configuration.
+     * @param config The configuration for starting the run
+     */
+    startRun(config: CreateStartRunConfig): void;
+    /**
+     * Resume a run with the given configuration.
+     * @param config The configuration for resuming the run
+     */
+    unstable_resumeRun(config: CreateResumeRunConfig): void;
+    cancelRun(): void;
+    getModelContext(): ModelContext;
+    export(): ExportedMessageRepository;
+    import(repository: ExportedMessageRepository): void;
+    /**
+     * Reset the thread with optional initial messages.
+     * @param initialMessages - Optional array of initial messages to populate the thread
+     */
+    reset(initialMessages?: readonly ThreadMessageLike[]): void;
+    message(selector: {
+        id: string;
+    } | {
+        index: number;
+    }): MessageMethods;
+    /** @deprecated This API is still under active development and might change without notice. */
+    stopSpeaking(): void;
+    /**
+     * Start the voice session for the thread. Establishes any necessary media connections.
+     */
+    startVoice(): Promise<void>;
+    /**
+     * Stop the currently active voice session.
+     */
+    stopVoice(): Promise<void>;
+    __internal_getRuntime?(): ThreadRuntime;
+};
+export type ThreadMeta = {
+    source: "threads";
+    query: {
+        type: "main";
+    };
+};
+export type ThreadEvents = {
+    "thread.runStart": {
+        threadId: string;
+    };
+    "thread.runEnd": {
+        threadId: string;
+    };
+    "thread.initialize": {
+        threadId: string;
+    };
+    "thread.modelContextUpdate": {
+        threadId: string;
+    };
+};
+export type ThreadClientSchema = {
+    methods: ThreadMethods;
+    meta: ThreadMeta;
+    events: ThreadEvents;
+};
+//# sourceMappingURL=thread.d.ts.map

package/dist/store/scopes/thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../../src/store/scopes/thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACd,+BAAsB;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,qCAA4B;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,qBAAkB;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,sBAAmB;AAEjE,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,QAAQ,IAAI,WAAW,CAAC;IACxB;;OAEG;IACH,QAAQ,IAAI,eAAe,CAAC;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC7C;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACxD,SAAS,IAAI,IAAI,CAAC;IAClB,eAAe,IAAI,YAAY,CAAC;IAChC,MAAM,IAAI,yBAAyB,CAAC;IACpC,MAAM,CAAC,UAAU,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACpD;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,EAAE,SAAS,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAC5D,OAAO,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC;IACtE,8FAA8F;IAC9F,YAAY,IAAI,IAAI,CAAC;IACrB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,qBAAqB,CAAC,IAAI,aAAa,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,iBAAiB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,eAAe,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,mBAAmB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,2BAA2B,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC"}

package/dist/store/scopes/thread.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=thread.js.map

package/dist/store/scopes/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../../../src/store/scopes/thread.ts"],"names":[],"mappings":""}

package/dist/store/scopes/threads.d.ts

@@ -0,0 +1,29 @@
+import type { AssistantRuntime } from "../../runtime/index.js";
+import type { ThreadListItemMethods, ThreadListItemState } from "./thread-list-item.js";
+import type { ThreadMethods, ThreadState } from "./thread.js";
+export type ThreadsState = {
+    readonly mainThreadId: string;
+    readonly newThreadId: string | null;
+    readonly isLoading: boolean;
+    readonly threadIds: readonly string[];
+    readonly archivedThreadIds: readonly string[];
+    readonly threadItems: readonly ThreadListItemState[];
+    readonly main: ThreadState;
+};
+export type ThreadsMethods = {
+    getState(): ThreadsState;
+    switchToThread(threadId: string): void;
+    switchToNewThread(): void;
+    item(threadIdOrOptions: "main" | {
+        id: string;
+    } | {
+        index: number;
+        archived?: boolean;
+    }): ThreadListItemMethods;
+    thread(selector: "main"): ThreadMethods;
+    __internal_getAssistantRuntime?(): AssistantRuntime;
+};
+export type ThreadsClientSchema = {
+    methods: ThreadsMethods;
+};
+//# sourceMappingURL=threads.d.ts.map

package/dist/store/scopes/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/store/scopes/threads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,+BAAsB;AACtD,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACpB,8BAA2B;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAiB;AAE3D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,IAAI,YAAY,CAAC;IACzB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,iBAAiB,IAAI,IAAI,CAAC;IAC1B,IAAI,CACF,iBAAiB,EACb,MAAM,GACN;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GACd;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GACxC,qBAAqB,CAAC;IACzB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IACxC,8BAA8B,CAAC,IAAI,gBAAgB,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,cAAc,CAAC;CACzB,CAAC"}

package/dist/store/scopes/threads.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=threads.js.map

package/dist/store/scopes/threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../../src/store/scopes/threads.ts"],"names":[],"mappings":""}

package/dist/store/types/client.d.ts

@@ -0,0 +1,137 @@
+import type { ResourceElement } from "@assistant-ui/tap";
+import type { AssistantEventName, AssistantEventCallback, AssistantEventSelector } from "./events.js";
+import type { ThreadsClientSchema } from "../scopes/threads.js";
+import type { ThreadListItemClientSchema } from "../scopes/thread-list-item.js";
+import type { ThreadClientSchema } from "../scopes/thread.js";
+import type { MessageClientSchema } from "../scopes/message.js";
+import type { PartClientSchema } from "../scopes/part.js";
+import type { ComposerClientSchema } from "../scopes/composer.js";
+import type { AttachmentClientSchema } from "../scopes/attachment.js";
+import type { ModelContextClientSchema } from "../scopes/model-context.js";
+import type { SuggestionsClientSchema } from "../scopes/suggestions.js";
+import type { SuggestionClientSchema } from "../scopes/suggestion.js";
+import type { ChainOfThoughtClientSchema } from "../scopes/chain-of-thought.js";
+/**
+ * Base type for methods that can be called on a client.
+ */
+export interface ClientMethods {
+    [key: string | symbol]: (...args: any[]) => any;
+}
+type ClientMetaType = {
+    source: ClientNames;
+    query: Record<string, unknown>;
+};
+/**
+ * Module augmentation interface for assistant-ui store type extensions.
+ *
+ * @example
+ * ```typescript
+ * declare module "@assistant-ui/core/store" {
+ *   interface ScopeRegistry {
+ *     // Simple client (meta and events are optional)
+ *     foo: {
+ *       methods: {
+ *         getState: () => { bar: string };
+ *         updateBar: (bar: string) => void;
+ *       };
+ *     };
+ *     // Full client with meta and events
+ *     bar: {
+ *       methods: {
+ *         getState: () => { id: string };
+ *         update: () => void;
+ *       };
+ *       meta: { source: "fooList"; query: { index: number } };
+ *       events: {
+ *         "bar.updated": { id: string };
+ *       };
+ *     };
+ *   }
+ * }
+ * ```
+ */
+export interface ScopeRegistry {
+    threads: ThreadsClientSchema;
+    threadListItem: ThreadListItemClientSchema;
+    thread: ThreadClientSchema;
+    message: MessageClientSchema;
+    part: PartClientSchema;
+    composer: ComposerClientSchema;
+    attachment: AttachmentClientSchema;
+    modelContext: ModelContextClientSchema;
+    suggestions: SuggestionsClientSchema;
+    suggestion: SuggestionClientSchema;
+    chainOfThought: ChainOfThoughtClientSchema;
+}
+type ClientEventsType<K extends ClientNames> = Record<`${K}.${string}`, unknown>;
+type ClientError<E extends string> = {
+    methods: Record<E, () => E>;
+    meta: {
+        source: ClientNames;
+        query: Record<E, E>;
+    };
+    events: Record<`${E}.`, E>;
+};
+type ValidateClient<K extends keyof ScopeRegistry> = ScopeRegistry[K] extends {
+    methods: ClientMethods;
+} ? "meta" extends keyof ScopeRegistry[K] ? ScopeRegistry[K]["meta"] extends ClientMetaType ? "events" extends keyof ScopeRegistry[K] ? ScopeRegistry[K]["events"] extends ClientEventsType<K> ? ScopeRegistry[K] : ClientError<`ERROR: ${K & string} has invalid events type`> : ScopeRegistry[K] : ClientError<`ERROR: ${K & string} has invalid meta type`> : "events" extends keyof ScopeRegistry[K] ? ScopeRegistry[K]["events"] extends ClientEventsType<K> ? ScopeRegistry[K] : ClientError<`ERROR: ${K & string} has invalid events type`> : ScopeRegistry[K] : ClientError<`ERROR: ${K & string} has invalid methods type`>;
+type ClientSchemas = keyof ScopeRegistry extends never ? {
+    "ERROR: No clients were defined": ClientError<"ERROR: No clients were defined">;
+} : {
+    [K in keyof ScopeRegistry]: ValidateClient<K>;
+};
+/**
+ * Output type that client resources return (just methods).
+ *
+ * @example
+ * ```typescript
+ * const FooResource = resource((): ClientResourceOutput<"foo"> => {
+ *   const [state, setState] = tapState({ bar: "hello" });
+ *   return {
+ *     getState: () => state,
+ *     updateBar: (b) => setState({ bar: b }),
+ *   };
+ * });
+ * ```
+ */
+export type ClientOutput<K extends ClientNames> = ClientSchemas[K]["methods"] & ClientMethods;
+export type ClientNames = keyof ClientSchemas extends infer U ? U : never;
+export type ClientEvents<K extends ClientNames> = "events" extends keyof ClientSchemas[K] ? ClientSchemas[K]["events"] extends ClientEventsType<K> ? ClientSchemas[K]["events"] : never : never;
+export type ClientMeta<K extends ClientNames> = "meta" extends keyof ClientSchemas[K] ? Pick<ClientSchemas[K]["meta"] extends ClientMetaType ? ClientSchemas[K]["meta"] : never, "source" | "query"> : never;
+export type ClientElement<K extends ClientNames> = ResourceElement<ClientOutput<K>>;
+/**
+ * Unsubscribe function type.
+ */
+export type Unsubscribe = () => void;
+/**
+ * State type extracted from all clients via their getState() methods.
+ */
+export type AssistantState = {
+    [K in ClientNames]: ClientSchemas[K]["methods"] extends {
+        getState: () => infer S;
+    } ? S : never;
+};
+/**
+ * Type for a client accessor - a function that returns the methods,
+ * with source/query metadata attached (derived from meta).
+ */
+export type AssistantClientAccessor<K extends ClientNames> = (() => ClientSchemas[K]["methods"]) & (ClientMeta<K> | {
+    source: "root";
+    query: Record<string, never>;
+} | {
+    source: null;
+    query: null;
+}) & {
+    name: K;
+};
+/**
+ * The assistant client type with all registered clients.
+ */
+export type AssistantClient = {
+    [K in ClientNames]: AssistantClientAccessor<K>;
+} & {
+    subscribe(listener: () => void): Unsubscribe;
+    on<TEvent extends AssistantEventName>(selector: AssistantEventSelector<TEvent>, callback: AssistantEventCallback<TEvent>): Unsubscribe;
+};
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/store/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/store/types/client.ts"],"names":[],"mappings":"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"}

package/dist/store/types/client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.js.map

package/dist/store/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/store/types/client.ts"],"names":[],"mappings":""}

package/dist/store/types/events.d.ts

@@ -0,0 +1,33 @@
+import type { AssistantClientAccessor, ClientEvents, ClientNames } from "./client.js";
+type UnionToIntersection<U> = (U extends unknown ? (x: U) => void : never) extends (x: infer I) => void ? I : never;
+type ClientEventMap = UnionToIntersection<{
+    [K in ClientNames]: ClientEvents<K>;
+}[ClientNames]>;
+type WildcardPayload = {
+    [K in keyof ClientEventMap]: {
+        event: K;
+        payload: ClientEventMap[K];
+    };
+}[keyof ClientEventMap];
+export type AssistantEventPayload = ClientEventMap & {
+    "*": WildcardPayload;
+};
+export type AssistantEventName = keyof AssistantEventPayload;
+type EventSource<T extends AssistantEventName> = T extends `${infer Source}.${string}` ? Source : never;
+type ParentOf<K extends ClientNames> = AssistantClientAccessor<K> extends {
+    source: infer S;
+} ? S extends ClientNames ? S : never : never;
+type AncestorsOf<K extends ClientNames, Seen extends ClientNames = never> = K extends Seen ? never : ParentOf<K> extends never ? never : ParentOf<K> | AncestorsOf<ParentOf<K>, Seen | K>;
+/** Valid scopes: `"*"` | event source | ancestors of event source */
+export type AssistantEventScope<TEvent extends AssistantEventName> = "*" | EventSource<TEvent> | (EventSource<TEvent> extends ClientNames ? AncestorsOf<EventSource<TEvent>> : never);
+export type AssistantEventSelector<TEvent extends AssistantEventName> = TEvent | {
+    scope: AssistantEventScope<TEvent>;
+    event: TEvent;
+};
+export declare const normalizeEventSelector: <TEvent extends AssistantEventName>(selector: AssistantEventSelector<TEvent>) => {
+    scope: AssistantEventScope<TEvent>;
+    event: TEvent;
+};
+export type AssistantEventCallback<TEvent extends AssistantEventName> = (payload: AssistantEventPayload[TEvent]) => void;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/store/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/store/types/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACZ,oBAAiB;AAGlB,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAC5B,CAAC,SAAS,OAAO,GACb,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GACd,KAAK,CACV,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,GAC1B,CAAC,GACD,KAAK,CAAC;AAEV,KAAK,cAAc,GAAG,mBAAmB,CACvC;KAAG,CAAC,IAAI,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC;CAAE,CAAC,WAAW,CAAC,CACrD,CAAC;AAIF,KAAK,eAAe,GAAG;KACpB,CAAC,IAAI,MAAM,cAAc,GAAG;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;KAAE;CACtE,CAAC,MAAM,cAAc,CAAC,CAAC;AAExB,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG;IAAE,GAAG,EAAE,eAAe,CAAA;CAAE,CAAC;AAE9E,MAAM,MAAM,kBAAkB,GAAG,MAAM,qBAAqB,CAAC;AAE7D,KAAK,WAAW,CAAC,CAAC,SAAS,kBAAkB,IAC3C,CAAC,SAAS,GAAG,MAAM,MAAM,IAAI,MAAM,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC;AAIzD,KAAK,QAAQ,CAAC,CAAC,SAAS,WAAW,IACjC,uBAAuB,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClD,CAAC,SAAS,WAAW,GACnB,CAAC,GACD,KAAK,GACP,KAAK,CAAC;AAEZ,KAAK,WAAW,CACd,CAAC,SAAS,WAAW,EACrB,IAAI,SAAS,WAAW,GAAG,KAAK,IAC9B,CAAC,SAAS,IAAI,GACd,KAAK,GACL,QAAQ,CAAC,CAAC,CAAC,SAAS,KAAK,GACvB,KAAK,GACL,QAAQ,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;AAEvD,qEAAqE;AACrE,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,kBAAkB,IAC7D,GAAG,GACH,WAAW,CAAC,MAAM,CAAC,GACnB,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,WAAW,GACpC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAChC,KAAK,CAAC,CAAC;AAIf,MAAM,MAAM,sBAAsB,CAAC,MAAM,SAAS,kBAAkB,IAChE,MAAM,GACN;IAAE,KAAK,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,eAAO,MAAM,sBAAsB,GAAI,MAAM,SAAS,kBAAkB,EACtE,UAAU,sBAAsB,CAAC,MAAM,CAAC;;;CAOzC,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAAC,MAAM,SAAS,kBAAkB,IAAI,CACtE,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,KACnC,IAAI,CAAC"}

package/dist/store/types/events.js

@@ -0,0 +1,8 @@
+export const normalizeEventSelector = (selector) => {
+    if (typeof selector === "string") {
+        const source = selector.split(".")[0];
+        return { scope: source, event: selector };
+    }
+    return { scope: selector.scope, event: selector.event };
+};
+//# sourceMappingURL=events.js.map

package/dist/store/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/store/types/events.ts"],"names":[],"mappings":"AAgEA,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,QAAwC,EACxC,EAAE;IACF,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAgC,CAAC;QACrE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC1D,CAAC,CAAC"}

package/dist/store/types/index.d.ts

@@ -0,0 +1,3 @@
+export type { ClientMethods, ClientSchema, ScopeRegistry, ClientOutput, ClientNames, ClientEvents, ClientMeta, ClientElement, Unsubscribe, AssistantState, AssistantClientAccessor, AssistantClient, } from "./client.js";
+export { normalizeEventSelector, type AssistantEventPayload, type AssistantEventName, type AssistantEventScope, type AssistantEventSelector, type AssistantEventCallback, } from "./events.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/store/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/store/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,eAAe,GAChB,oBAAiB;AAElB,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,oBAAiB"}

package/dist/store/types/index.js

@@ -0,0 +1,2 @@
+export { normalizeEventSelector, } from "./events.js";
+//# sourceMappingURL=index.js.map

package/dist/store/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/types/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,sBAAsB,GAMvB,oBAAiB"}

package/dist/store/utils/attach-transform-scopes.d.ts

@@ -0,0 +1,11 @@
+import type { ResourceElement } from "@assistant-ui/tap";
+import type { AssistantClient, ClientElement, ClientNames } from "../types/client.js";
+import type { DerivedElement } from "./derived.js";
+export type ScopesConfig = {
+    [K in ClientNames]?: ClientElement<K> | DerivedElement<K>;
+};
+type TransformScopesFn = (scopes: ScopesConfig, parent: AssistantClient) => ScopesConfig;
+export declare function attachTransformScopes<T extends (...args: any[]) => ResourceElement<any>>(resource: T, transform: TransformScopesFn): void;
+export declare function getTransformScopes<T extends (...args: any[]) => ResourceElement<any>>(resource: T): TransformScopesFn | undefined;
+export {};
+//# sourceMappingURL=attach-transform-scopes.d.ts.map

package/dist/store/utils/attach-transform-scopes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-transform-scopes.d.ts","sourceRoot":"","sources":["../../../src/store/utils/attach-transform-scopes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACZ,2BAAwB;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAkB;AAIhD,MAAM,MAAM,YAAY,GAAG;KACxB,CAAC,IAAI,WAAW,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF,KAAK,iBAAiB,GAAG,CACvB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,eAAe,KACpB,YAAY,CAAC;AAMlB,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,EAClD,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAMjD;AAED,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC,GAAG,CAAC,EAClD,QAAQ,EAAE,CAAC,GAAG,iBAAiB,GAAG,SAAS,CAE5C"}

package/dist/store/utils/attach-transform-scopes.js

@@ -0,0 +1,12 @@
+const TRANSFORM_SCOPES = Symbol("assistant-ui.transform-scopes");
+export function attachTransformScopes(resource, transform) {
+    const r = resource;
+    if (r[TRANSFORM_SCOPES]) {
+        throw new Error("transformScopes is already attached to this resource");
+    }
+    r[TRANSFORM_SCOPES] = transform;
+}
+export function getTransformScopes(resource) {
+    return resource[TRANSFORM_SCOPES];
+}
+//# sourceMappingURL=attach-transform-scopes.js.map

package/dist/store/utils/attach-transform-scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-transform-scopes.js","sourceRoot":"","sources":["../../../src/store/utils/attach-transform-scopes.ts"],"names":[],"mappings":"AAQA,MAAM,gBAAgB,GAAG,MAAM,CAAC,+BAA+B,CAAC,CAAC;AAejE,MAAM,UAAU,qBAAqB,CAEnC,QAAW,EAAE,SAA4B;IACzC,MAAM,CAAC,GAAG,QAA2C,CAAC;IACtD,IAAI,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,CAAC,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAEhC,QAAW;IACX,OAAQ,QAA4C,CAAC,gBAAgB,CAAC,CAAC;AACzE,CAAC"}

package/dist/store/utils/base-proxy-handler.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Handles common proxy introspection properties.
+ * Returns the appropriate value for toStringTag, toJSON, and props that should return undefined.
+ * Returns `false` if the prop should be handled by the subclass.
+ */
+export declare const handleIntrospectionProp: (prop: string | symbol, name: string) => unknown | false;
+export declare abstract class BaseProxyHandler implements ProxyHandler<object> {
+    abstract get(_: unknown, prop: string | symbol, receiver?: unknown): unknown;
+    abstract ownKeys(): ArrayLike<string | symbol>;
+    abstract has(_: unknown, prop: string | symbol): boolean;
+    getOwnPropertyDescriptor(_: unknown, prop: string | symbol): {
+        value: {} | null;
+        writable: boolean;
+        enumerable: boolean;
+        configurable: boolean;
+    } | undefined;
+    set(): boolean;
+    setPrototypeOf(): boolean;
+    defineProperty(): boolean;
+    deleteProperty(): boolean;
+    preventExtensions(): boolean;
+}
+//# sourceMappingURL=base-proxy-handler.d.ts.map

package/dist/store/utils/base-proxy-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-proxy-handler.d.ts","sourceRoot":"","sources":["../../../src/store/utils/base-proxy-handler.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,GAAG,MAAM,EACrB,MAAM,MAAM,KACX,OAAO,GAAG,KAMZ,CAAC;AAEF,8BAAsB,gBAAiB,YAAW,YAAY,CAAC,MAAM,CAAC;IACpE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO;IAC5E,QAAQ,CAAC,OAAO,IAAI,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAExD,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;;;;;;IAW1D,GAAG;IAGH,cAAc;IAGd,cAAc;IAGd,cAAc;IAGd,iBAAiB,IAAI,OAAO;CAG7B"}

package/dist/store/utils/base-proxy-handler.js

@@ -0,0 +1,46 @@
+const INTROSPECTION_PROPS = new Set(["$$typeof", "nodeType", "then"]);
+/**
+ * Handles common proxy introspection properties.
+ * Returns the appropriate value for toStringTag, toJSON, and props that should return undefined.
+ * Returns `false` if the prop should be handled by the subclass.
+ */
+export const handleIntrospectionProp = (prop, name) => {
+    if (prop === Symbol.toStringTag)
+        return name;
+    if (typeof prop === "symbol")
+        return undefined;
+    if (prop === "toJSON")
+        return () => name;
+    if (INTROSPECTION_PROPS.has(prop))
+        return undefined;
+    return false;
+};
+export class BaseProxyHandler {
+    getOwnPropertyDescriptor(_, prop) {
+        const value = this.get(_, prop);
+        if (value === undefined)
+            return undefined;
+        return {
+            value,
+            writable: false,
+            enumerable: true,
+            configurable: false,
+        };
+    }
+    set() {
+        return false;
+    }
+    setPrototypeOf() {
+        return false;
+    }
+    defineProperty() {
+        return false;
+    }
+    deleteProperty() {
+        return false;
+    }
+    preventExtensions() {
+        return false;
+    }
+}
+//# sourceMappingURL=base-proxy-handler.js.map

package/dist/store/utils/base-proxy-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-proxy-handler.js","sourceRoot":"","sources":["../../../src/store/utils/base-proxy-handler.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,IAAqB,EACrB,IAAY,EACK,EAAE;IACnB,IAAI,IAAI,KAAK,MAAM,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;IACzC,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,OAAgB,gBAAgB;IAKpC,wBAAwB,CAAC,CAAU,EAAE,IAAqB;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,OAAO;YACL,KAAK;YACL,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,KAAK;SACpB,CAAC;IACJ,CAAC;IAED,GAAG;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,cAAc;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IACD,cAAc;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IACD,cAAc;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IACD,iBAAiB;QACf,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/store/utils/derived.d.ts

@@ -0,0 +1,34 @@
+import { ResourceElement } from "@assistant-ui/tap";
+import type { AssistantClient, ClientNames, AssistantClientAccessor, ClientMeta } from "../types/client.js";
+/**
+ * Creates a derived client field that references a client from a parent scope.
+ * The get callback always calls the most recent version (useEffectEvent pattern).
+ *
+ * IMPORTANT: The `get` callback must return a client that was created via
+ * `tapClientResource` (or `tapClientLookup`/`tapClientList` which use it internally).
+ * This is required for event scoping to work correctly.
+ *
+ * @example
+ * ```typescript
+ * const aui = useAui({
+ *   message: Derived({
+ *     source: "thread",
+ *     query: { index: 0 },
+ *     get: (aui) => aui.thread().message({ index: 0 }),
+ *   }),
+ * });
+ * ```
+ */
+export declare const Derived: <K extends ClientNames>(props: Derived.Props<K>) => ResourceElement<null, Derived.Props<K>>;
+export type DerivedElement<K extends ClientNames> = ResourceElement<null, Derived.Props<K>>;
+export declare namespace Derived {
+    /**
+     * Props passed to a derived client resource element.
+     */
+    type Props<K extends ClientNames> = {
+        get: (client: AssistantClient) => ReturnType<AssistantClientAccessor<K>>;
+    } & (ClientMeta<K> | {
+        getMeta: (client: AssistantClient) => ClientMeta<K>;
+    });
+}
+//# sourceMappingURL=derived.d.ts.map

package/dist/store/utils/derived.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived.d.ts","sourceRoot":"","sources":["../../../src/store/utils/derived.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,uBAAuB,EACvB,UAAU,EACX,2BAAwB;AAEzB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,GACjB,CAAC,SAAS,WAAW,qEAGvB,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI,eAAe,CACjE,IAAI,EACJ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CACjB,CAAC;AAEF,yBAAiB,OAAO,CAAC;IACvB;;OAEG;IACH,KAAY,KAAK,CAAC,CAAC,SAAS,WAAW,IAAI;QACzC,GAAG,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC;KAC1E,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC,CAAC;CAC/E"}