@constructive-io/react 0.15.2 → 0.15.3

package/esm/public/hooks/queries/useAgentMessageQuery.d.ts

@@ -0,0 +1,65 @@
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { AgentMessageSelect, AgentMessageWithRelations } from '../../orm/input-types';
+import type { InferSelectResult, HookStrictSelect } from '../../orm/select-types';
+export type { AgentMessageSelect, AgentMessageWithRelations } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const agentMessageQueryKey: (id: string | number) => readonly ["agentmessage", "detail", string | number];
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useAgentMessageQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true, name: true } },
+ * });
+ * ```
+ */
+export declare function useAgentMessageQuery<S extends AgentMessageSelect, TData = {
+    agentMessage: InferSelectResult<AgentMessageWithRelations, S> | null;
+}>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, AgentMessageSelect>;
+} & Omit<UseQueryOptions<{
+    agentMessage: InferSelectResult<AgentMessageWithRelations, S> | null;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```ts
+ * const data = await fetchAgentMessageQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true } },
+ * });
+ * ```
+ */
+export declare function fetchAgentMessageQuery<S extends AgentMessageSelect>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, AgentMessageSelect>;
+}): Promise<{
+    agentMessage: InferSelectResult<AgentMessageWithRelations, S> | null;
+}>;
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```ts
+ * await prefetchAgentMessageQuery(queryClient, { id: 'some-id', selection: { fields: { id: true } } });
+ * ```
+ */
+export declare function prefetchAgentMessageQuery<S extends AgentMessageSelect>(queryClient: QueryClient, params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, AgentMessageSelect>;
+}): Promise<void>;

package/esm/public/hooks/queries/useAgentMessageQuery.js

@@ -0,0 +1,47 @@
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildSelectionArgs } from '../selection';
+import { agentMessageKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const agentMessageQueryKey = agentMessageKeys.detail;
+export function useAgentMessageQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: agentMessageKeys.detail(params.id),
+        queryFn: () => getClient()
+            .agentMessage.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchAgentMessageQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    return getClient()
+        .agentMessage.findOne({
+        id: params.id,
+        select: args.select,
+    })
+        .unwrap();
+}
+export async function prefetchAgentMessageQuery(queryClient, params) {
+    const args = buildSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: agentMessageKeys.detail(params.id),
+        queryFn: () => getClient()
+            .agentMessage.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+    });
+}

package/esm/public/hooks/queries/useAgentMessagesQuery.d.ts

@@ -0,0 +1,69 @@
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { ListSelectionConfig } from '../selection';
+import type { AgentMessageSelect, AgentMessageWithRelations, AgentMessageFilter, AgentMessageOrderBy } from '../../orm/input-types';
+import type { InferSelectResult, ConnectionResult, HookStrictSelect } from '../../orm/select-types';
+export type { AgentMessageSelect, AgentMessageWithRelations, AgentMessageFilter, AgentMessageOrderBy, } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const agentMessagesQueryKey: (variables?: object) => readonly ["agentmessage", "list", object];
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useAgentMessagesQuery({
+ *   selection: {
+ *     fields: { id: true, name: true },
+ *     where: { name: { equalTo: "example" } },
+ *     orderBy: ['CREATED_AT_DESC'],
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function useAgentMessagesQuery<S extends AgentMessageSelect, TData = {
+    agentMessages: ConnectionResult<InferSelectResult<AgentMessageWithRelations, S>>;
+}>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, AgentMessageFilter, AgentMessageOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, AgentMessageSelect>;
+} & Omit<UseQueryOptions<{
+    agentMessages: ConnectionResult<InferSelectResult<AgentMessageWithRelations, S>>;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```ts
+ * const data = await fetchAgentMessagesQuery({
+ *   selection: {
+ *     fields: { id: true },
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function fetchAgentMessagesQuery<S extends AgentMessageSelect>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, AgentMessageFilter, AgentMessageOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, AgentMessageSelect>;
+}): Promise<{
+    agentMessages: ConnectionResult<InferSelectResult<AgentMessageWithRelations, S>>;
+}>;
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```ts
+ * await prefetchAgentMessagesQuery(queryClient, { selection: { fields: { id: true }, first: 10 } });
+ * ```
+ */
+export declare function prefetchAgentMessagesQuery<S extends AgentMessageSelect>(queryClient: QueryClient, params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, AgentMessageFilter, AgentMessageOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, AgentMessageSelect>;
+}): Promise<void>;

package/esm/public/hooks/queries/useAgentMessagesQuery.js

@@ -0,0 +1,32 @@
+/**
+ * A single message in an agent_thread. The full client-rendered content (TextPart and ToolPart, including the ToolPart state machine and inline approval object) lives in the `parts` jsonb column — there is no separate agent_tool_call or agent_tool_approval table in v1. Cascade-deleted with the parent thread; RLS is owner-only.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildListSelectionArgs } from '../selection';
+import { agentMessageKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const agentMessagesQueryKey = agentMessageKeys.list;
+export function useAgentMessagesQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: agentMessageKeys.list(args),
+        queryFn: () => getClient().agentMessage.findMany(args).unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchAgentMessagesQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    return getClient().agentMessage.findMany(args).unwrap();
+}
+export async function prefetchAgentMessagesQuery(queryClient, params) {
+    const args = buildListSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: agentMessageKeys.list(args),
+        queryFn: () => getClient().agentMessage.findMany(args).unwrap(),
+    });
+}

package/esm/public/hooks/queries/useAgentTaskQuery.d.ts

@@ -0,0 +1,65 @@
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { AgentTaskSelect, AgentTaskWithRelations } from '../../orm/input-types';
+import type { InferSelectResult, HookStrictSelect } from '../../orm/select-types';
+export type { AgentTaskSelect, AgentTaskWithRelations } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const agentTaskQueryKey: (id: string | number) => readonly ["agenttask", "detail", string | number];
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useAgentTaskQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true, name: true } },
+ * });
+ * ```
+ */
+export declare function useAgentTaskQuery<S extends AgentTaskSelect, TData = {
+    agentTask: InferSelectResult<AgentTaskWithRelations, S> | null;
+}>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, AgentTaskSelect>;
+} & Omit<UseQueryOptions<{
+    agentTask: InferSelectResult<AgentTaskWithRelations, S> | null;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```ts
+ * const data = await fetchAgentTaskQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true } },
+ * });
+ * ```
+ */
+export declare function fetchAgentTaskQuery<S extends AgentTaskSelect>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, AgentTaskSelect>;
+}): Promise<{
+    agentTask: InferSelectResult<AgentTaskWithRelations, S> | null;
+}>;
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```ts
+ * await prefetchAgentTaskQuery(queryClient, { id: 'some-id', selection: { fields: { id: true } } });
+ * ```
+ */
+export declare function prefetchAgentTaskQuery<S extends AgentTaskSelect>(queryClient: QueryClient, params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, AgentTaskSelect>;
+}): Promise<void>;

package/esm/public/hooks/queries/useAgentTaskQuery.js

@@ -0,0 +1,47 @@
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildSelectionArgs } from '../selection';
+import { agentTaskKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const agentTaskQueryKey = agentTaskKeys.detail;
+export function useAgentTaskQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: agentTaskKeys.detail(params.id),
+        queryFn: () => getClient()
+            .agentTask.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchAgentTaskQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    return getClient()
+        .agentTask.findOne({
+        id: params.id,
+        select: args.select,
+    })
+        .unwrap();
+}
+export async function prefetchAgentTaskQuery(queryClient, params) {
+    const args = buildSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: agentTaskKeys.detail(params.id),
+        queryFn: () => getClient()
+            .agentTask.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+    });
+}

package/esm/public/hooks/queries/useAgentTasksQuery.d.ts

@@ -0,0 +1,69 @@
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { ListSelectionConfig } from '../selection';
+import type { AgentTaskSelect, AgentTaskWithRelations, AgentTaskFilter, AgentTaskOrderBy } from '../../orm/input-types';
+import type { InferSelectResult, ConnectionResult, HookStrictSelect } from '../../orm/select-types';
+export type { AgentTaskSelect, AgentTaskWithRelations, AgentTaskFilter, AgentTaskOrderBy, } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const agentTasksQueryKey: (variables?: object) => readonly ["agenttask", "list", object];
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useAgentTasksQuery({
+ *   selection: {
+ *     fields: { id: true, name: true },
+ *     where: { name: { equalTo: "example" } },
+ *     orderBy: ['CREATED_AT_DESC'],
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function useAgentTasksQuery<S extends AgentTaskSelect, TData = {
+    agentTasks: ConnectionResult<InferSelectResult<AgentTaskWithRelations, S>>;
+}>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, AgentTaskFilter, AgentTaskOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, AgentTaskSelect>;
+} & Omit<UseQueryOptions<{
+    agentTasks: ConnectionResult<InferSelectResult<AgentTaskWithRelations, S>>;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```ts
+ * const data = await fetchAgentTasksQuery({
+ *   selection: {
+ *     fields: { id: true },
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function fetchAgentTasksQuery<S extends AgentTaskSelect>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, AgentTaskFilter, AgentTaskOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, AgentTaskSelect>;
+}): Promise<{
+    agentTasks: ConnectionResult<InferSelectResult<AgentTaskWithRelations, S>>;
+}>;
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ *
+ * @example
+ * ```ts
+ * await prefetchAgentTasksQuery(queryClient, { selection: { fields: { id: true }, first: 10 } });
+ * ```
+ */
+export declare function prefetchAgentTasksQuery<S extends AgentTaskSelect>(queryClient: QueryClient, params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, AgentTaskFilter, AgentTaskOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, AgentTaskSelect>;
+}): Promise<void>;

package/esm/public/hooks/queries/useAgentTasksQuery.js

@@ -0,0 +1,32 @@
+/**
+ * An agent- or user-authored todo item attached to an agent_thread. Captures the planning surface for agent-mode conversations: each row is a single discrete unit of work with a status lifecycle (pending → in-progress → done|failed). Cascade-deleted with the parent thread; RLS is owner-only.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildListSelectionArgs } from '../selection';
+import { agentTaskKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const agentTasksQueryKey = agentTaskKeys.list;
+export function useAgentTasksQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: agentTaskKeys.list(args),
+        queryFn: () => getClient().agentTask.findMany(args).unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchAgentTasksQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    return getClient().agentTask.findMany(args).unwrap();
+}
+export async function prefetchAgentTasksQuery(queryClient, params) {
+    const args = buildListSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: agentTaskKeys.list(args),
+        queryFn: () => getClient().agentTask.findMany(args).unwrap(),
+    });
+}

package/esm/public/hooks/queries/useAgentThreadQuery.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { AgentThreadSelect, AgentThreadWithRelations } from '../../orm/input-types';
+import type { InferSelectResult, HookStrictSelect } from '../../orm/select-types';
+export type { AgentThreadSelect, AgentThreadWithRelations } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const agentThreadQueryKey: (id: string | number) => readonly ["agentthread", "detail", string | number];
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useAgentThreadQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true, name: true } },
+ * });
+ * ```
+ */
+export declare function useAgentThreadQuery<S extends AgentThreadSelect, TData = {
+    agentThread: InferSelectResult<AgentThreadWithRelations, S> | null;
+}>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, AgentThreadSelect>;
+} & Omit<UseQueryOptions<{
+    agentThread: InferSelectResult<AgentThreadWithRelations, S> | null;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ *
+ * @example
+ * ```ts
+ * const data = await fetchAgentThreadQuery({
+ *   id: 'some-id',
+ *   selection: { fields: { id: true } },
+ * });
+ * ```
+ */
+export declare function fetchAgentThreadQuery<S extends AgentThreadSelect>(params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, AgentThreadSelect>;
+}): Promise<{
+    agentThread: InferSelectResult<AgentThreadWithRelations, S> | null;
+}>;
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ *
+ * @example
+ * ```ts
+ * await prefetchAgentThreadQuery(queryClient, { id: 'some-id', selection: { fields: { id: true } } });
+ * ```
+ */
+export declare function prefetchAgentThreadQuery<S extends AgentThreadSelect>(queryClient: QueryClient, params: {
+    id: string;
+    selection: {
+        fields: S;
+    } & HookStrictSelect<NoInfer<S>, AgentThreadSelect>;
+}): Promise<void>;

package/esm/public/hooks/queries/useAgentThreadQuery.js

@@ -0,0 +1,47 @@
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildSelectionArgs } from '../selection';
+import { agentThreadKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const agentThreadQueryKey = agentThreadKeys.detail;
+export function useAgentThreadQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: agentThreadKeys.detail(params.id),
+        queryFn: () => getClient()
+            .agentThread.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchAgentThreadQuery(params) {
+    const args = buildSelectionArgs(params.selection);
+    return getClient()
+        .agentThread.findOne({
+        id: params.id,
+        select: args.select,
+    })
+        .unwrap();
+}
+export async function prefetchAgentThreadQuery(queryClient, params) {
+    const args = buildSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: agentThreadKeys.detail(params.id),
+        queryFn: () => getClient()
+            .agentThread.findOne({
+            id: params.id,
+            select: args.select,
+        })
+            .unwrap(),
+    });
+}

package/esm/public/hooks/queries/useAgentThreadsQuery.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import type { UseQueryOptions, UseQueryResult, QueryClient } from '@tanstack/react-query';
+import type { ListSelectionConfig } from '../selection';
+import type { AgentThreadSelect, AgentThreadWithRelations, AgentThreadFilter, AgentThreadOrderBy } from '../../orm/input-types';
+import type { InferSelectResult, ConnectionResult, HookStrictSelect } from '../../orm/select-types';
+export type { AgentThreadSelect, AgentThreadWithRelations, AgentThreadFilter, AgentThreadOrderBy, } from '../../orm/input-types';
+/** Query key factory - re-exported from query-keys.ts */
+export declare const agentThreadsQueryKey: (variables?: object) => readonly ["agentthread", "list", object];
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ *
+ * @example
+ * ```tsx
+ * const { data, isLoading } = useAgentThreadsQuery({
+ *   selection: {
+ *     fields: { id: true, name: true },
+ *     where: { name: { equalTo: "example" } },
+ *     orderBy: ['CREATED_AT_DESC'],
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function useAgentThreadsQuery<S extends AgentThreadSelect, TData = {
+    agentThreads: ConnectionResult<InferSelectResult<AgentThreadWithRelations, S>>;
+}>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, AgentThreadFilter, AgentThreadOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, AgentThreadSelect>;
+} & Omit<UseQueryOptions<{
+    agentThreads: ConnectionResult<InferSelectResult<AgentThreadWithRelations, S>>;
+}, Error, TData>, 'queryKey' | 'queryFn'>): UseQueryResult<TData>;
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ *
+ * @example
+ * ```ts
+ * const data = await fetchAgentThreadsQuery({
+ *   selection: {
+ *     fields: { id: true },
+ *     first: 10,
+ *   },
+ * });
+ * ```
+ */
+export declare function fetchAgentThreadsQuery<S extends AgentThreadSelect>(params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, AgentThreadFilter, AgentThreadOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, AgentThreadSelect>;
+}): Promise<{
+    agentThreads: ConnectionResult<InferSelectResult<AgentThreadWithRelations, S>>;
+}>;
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ *
+ * @example
+ * ```ts
+ * await prefetchAgentThreadsQuery(queryClient, { selection: { fields: { id: true }, first: 10 } });
+ * ```
+ */
+export declare function prefetchAgentThreadsQuery<S extends AgentThreadSelect>(queryClient: QueryClient, params: {
+    selection: {
+        fields: S;
+    } & Omit<ListSelectionConfig<S, AgentThreadFilter, AgentThreadOrderBy>, 'fields'> & HookStrictSelect<NoInfer<S>, AgentThreadSelect>;
+}): Promise<void>;

package/esm/public/hooks/queries/useAgentThreadsQuery.js

@@ -0,0 +1,32 @@
+/**
+ * Top-level AI/LLM conversation. Owns the chat-mode + model + system-prompt snapshot for the lifetime of the conversation, and is the entity-scoping anchor — descendants (agent_message, agent_task) inherit entity_id from this row via DataInheritFromParent. RLS is owner-only (AuthzDirectOwner); entity_id is a grouping dimension, not a security dimension.
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../client';
+import { buildListSelectionArgs } from '../selection';
+import { agentThreadKeys } from '../query-keys';
+/** Query key factory - re-exported from query-keys.ts */
+export const agentThreadsQueryKey = agentThreadKeys.list;
+export function useAgentThreadsQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    const { selection: _selection, ...queryOptions } = params ?? {};
+    void _selection;
+    return useQuery({
+        queryKey: agentThreadKeys.list(args),
+        queryFn: () => getClient().agentThread.findMany(args).unwrap(),
+        ...queryOptions,
+    });
+}
+export async function fetchAgentThreadsQuery(params) {
+    const args = buildListSelectionArgs(params.selection);
+    return getClient().agentThread.findMany(args).unwrap();
+}
+export async function prefetchAgentThreadsQuery(queryClient, params) {
+    const args = buildListSelectionArgs(params.selection);
+    await queryClient.prefetchQuery({
+        queryKey: agentThreadKeys.list(args),
+        queryFn: () => getClient().agentThread.findMany(args).unwrap(),
+    });
+}