@mdxui/do 2.1.1 → 3.0.0

package/dist/{agents-xcIn2dUB.d.ts → agents-2_r9e9i7.d.ts}

@@ -1,4 +1,215 @@
-import { ExecutionError, TokenUsage } from './schemas/index.js';
+import { EntityReference, ExecutionError, TokenUsage } from './schemas/index.js';
+
+/**
+ * Relationship Types - Semantic Graph Connections
+ *
+ * Relationships form a semantic knowledge graph connecting Things.
+ * Uses the $.Subject.predicate.Object pattern throughout.
+ *
+ * @remarks
+ * The Relationships table uses MergeTree with ORDER BY (toNs, toId, fromNs, fromId)
+ * optimized for reverse lookups ("who references me?").
+ *
+ * 64+ semantic predicates across categories:
+ * - Temporal: before, after, during, since, until...
+ * - Spatial: above, below, near, between, within...
+ * - Directional: through, toward, from, into, across...
+ * - Relational: of, about, for, including, regarding...
+ * - Causal: because, considering, but
+ */
+
+/**
+ * Core relationship record from database
+ */
+interface Relationship {
+    /** Unique relationship identifier */
+    relationshipId: string;
+    /** Semantic predicate type */
+    relationshipType: SemanticPredicate;
+    /** Source entity namespace */
+    fromNs: string;
+    /** Source entity type */
+    fromType: string;
+    /** Source entity ID */
+    fromId: string;
+    /** Target entity namespace */
+    toNs: string;
+    /** Target entity type */
+    toType: string;
+    /** Target entity ID */
+    toId: string;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Creator user ID */
+    createdBy: string;
+    /** Soft delete timestamp */
+    deletedAt?: Date | null;
+    /** Deleter user ID */
+    deletedBy?: string;
+    /** Additional relationship metadata */
+    metadata: RelationshipMetadata;
+}
+/**
+ * Semantic predicate categories
+ */
+type SemanticPredicateCategory = 'temporal' | 'spatial' | 'directional' | 'relational' | 'causal' | 'ownership' | 'membership' | 'dependency' | 'custom';
+/**
+ * Built-in semantic predicates
+ */
+type SemanticPredicate = 'before' | 'after' | 'during' | 'since' | 'until' | 'by' | 'at' | 'in' | 'on' | 'past' | 'throughout' | 'till' | 'above' | 'below' | 'under' | 'near' | 'between' | 'among' | 'beside' | 'within' | 'amid' | 'around' | 'behind' | 'beneath' | 'beyond' | 'inside' | 'upon' | 'outside' | 'over' | 'opposite' | 'underneath' | 'round' | 'through' | 'toward' | 'to' | 'from' | 'into' | 'across' | 'along' | 'against' | 'down' | 'off' | 'onto' | 'up' | 'via' | 'out' | 'with' | 'of' | 'about' | 'concerning' | 'for' | 'including' | 'regarding' | 'like' | 'as' | 'than' | 'unlike' | 'besides' | 'except' | 'despite' | 'without' | 'per' | 'because' | 'considering' | 'but' | 'owns' | 'worksFor' | 'contains' | 'belongsTo' | 'employs' | 'locatedAt' | 'handoff' | 'uses' | 'validates' | 'blocks' | 'dependsOn' | 'references' | 'parentOf' | 'childOf' | 'siblingOf' | string;
+/**
+ * Predicate definition with metadata
+ */
+interface PredicateDefinition {
+    /** Predicate name */
+    name: SemanticPredicate;
+    /** Category */
+    category: SemanticPredicateCategory;
+    /** Human-readable label */
+    label: string;
+    /** Description */
+    description: string;
+    /** Inverse predicate (e.g., 'owns' -> 'ownedBy') */
+    inverse?: SemanticPredicate;
+    /** Is this predicate symmetric? */
+    symmetric: boolean;
+    /** Is this predicate transitive? */
+    transitive: boolean;
+    /** Valid source types (empty = any) */
+    validFromTypes: string[];
+    /** Valid target types (empty = any) */
+    validToTypes: string[];
+}
+/**
+ * Additional metadata for relationships
+ */
+interface RelationshipMetadata {
+    /** Relationship strength/weight (0-1) */
+    weight?: number;
+    /** Confidence score (0-1) */
+    confidence?: number;
+    /** Source of the relationship (manual, inferred, imported) */
+    source?: 'manual' | 'inferred' | 'imported' | 'system';
+    /** Start date (for temporal relationships) */
+    startDate?: Date;
+    /** End date (for temporal relationships) */
+    endDate?: Date;
+    /** Additional properties */
+    [key: string]: unknown;
+}
+/**
+ * Semantic triple representation ($.Subject.predicate.Object)
+ */
+interface SemanticTriple {
+    /** Subject (from) entity reference */
+    subject: EntityReference;
+    /** Predicate (relationship type) */
+    predicate: SemanticPredicate;
+    /** Object (to) entity reference */
+    object: EntityReference;
+}
+/**
+ * Graph query pattern for finding relationships
+ */
+interface GraphPattern {
+    /** Subject pattern (supports wildcards) */
+    subject?: Partial<EntityReference> & {
+        pattern?: string;
+    };
+    /** Predicate filter */
+    predicate?: SemanticPredicate | SemanticPredicate[];
+    /** Object pattern (supports wildcards) */
+    object?: Partial<EntityReference> & {
+        pattern?: string;
+    };
+    /** Maximum depth for traversal */
+    depth?: number;
+    /** Direction of traversal */
+    direction?: 'outgoing' | 'incoming' | 'both';
+}
+/**
+ * Relationship creation payload
+ */
+interface RelationshipCreateInput {
+    /** Predicate type */
+    relationshipType: SemanticPredicate;
+    /** Source entity */
+    from: EntityReference;
+    /** Target entity */
+    to: EntityReference;
+    /** Metadata */
+    metadata?: RelationshipMetadata;
+}
+/**
+ * Query filters for relationships
+ */
+interface RelationshipFilter {
+    /** Filter by predicate type */
+    predicates?: SemanticPredicate[];
+    /** Filter by source entity */
+    from?: Partial<EntityReference>;
+    /** Filter by target entity */
+    to?: Partial<EntityReference>;
+    /** Filter by category */
+    categories?: SemanticPredicateCategory[];
+    /** Include deleted */
+    includeDeleted?: boolean;
+    /** Filter by metadata */
+    metadata?: Partial<RelationshipMetadata>;
+    /** Date range */
+    createdAfter?: Date;
+    createdBefore?: Date;
+}
+/**
+ * Graph traversal result
+ */
+interface GraphTraversalResult {
+    /** Root entity */
+    root: EntityReference;
+    /** All nodes found */
+    nodes: EntityReference[];
+    /** All edges (relationships) found */
+    edges: Relationship[];
+    /** Traversal depth reached */
+    depth: number;
+    /** Paths from root to each node */
+    paths: GraphPath[];
+}
+/**
+ * A path in the graph
+ */
+interface GraphPath {
+    /** Starting node */
+    start: EntityReference;
+    /** Ending node */
+    end: EntityReference;
+    /** Edges traversed */
+    edges: Relationship[];
+    /** Total weight (sum of edge weights) */
+    totalWeight: number;
+    /** Path length (number of edges) */
+    length: number;
+}
+/**
+ * Statistics for the relationship graph
+ */
+interface GraphStats {
+    /** Total relationships */
+    totalRelationships: number;
+    /** Active relationships (not deleted) */
+    activeRelationships: number;
+    /** Count by predicate type */
+    byPredicate: Record<string, number>;
+    /** Count by category */
+    byCategory: Record<SemanticPredicateCategory, number>;
+    /** Average degree (connections per node) */
+    averageDegree: number;
+    /** Most connected nodes */
+    topConnectedNodes: Array<{
+        entity: EntityReference;
+        degree: number;
+    }>;
+}
 
 /**
  * Workflow Types - Business Process Orchestration
@@ -829,4 +1040,4 @@ interface AgentExecutionFilter {
     minRating?: number;
 }
 
-export type { AIStepConfig as A, AgentMetrics as B, ChoiceCondition as C, DatabaseStepConfig as D, EventTrigger as E, AgentExecution as F, AgentExecutionStatus as G, HttpStepConfig as H, AgentInput as I, AgentOutput as J, AgentArtifact as K, AgentTrace as L, ManualTrigger as M, NotificationConfig as N, AgentHandoff as O, GuardrailViolation as P, AgentFeedback as Q, RetryConfig as R, ScheduleTrigger as S, TriggerType as T, AgentFilter as U, AgentExecutionFilter as V, WorkflowStatus as W, Workflow as a, TriggerBase as b, WebhookTrigger as c, WorkflowTrigger as d, StepType as e, WorkflowStep as f, StepConfig as g, EventStepConfig as h, ErrorHandlingConfig as i, CompensationConfig as j, WorkflowConfig as k, ExecutionStatus as l, WorkflowExecution as m, TriggerData as n, ExecutionContext as o, StepExecution as p, WorkflowFilter as q, ExecutionFilter as r, Agent as s, AgentType as t, RoleCategory as u, AgentClassification as v, CharacterBible as w, AgentGuardrail as x, HandoffRule as y, AgentStatus as z };
+export type { AgentOutput as $, AIStepConfig as A, WorkflowFilter as B, ChoiceCondition as C, DatabaseStepConfig as D, EventTrigger as E, ExecutionFilter as F, GraphPattern as G, HttpStepConfig as H, Agent as I, AgentType as J, RoleCategory as K, AgentClassification as L, ManualTrigger as M, NotificationConfig as N, CharacterBible as O, PredicateDefinition as P, AgentGuardrail as Q, Relationship as R, SemanticPredicateCategory as S, TriggerType as T, HandoffRule as U, AgentStatus as V, WorkflowStatus as W, AgentMetrics as X, AgentExecution as Y, AgentExecutionStatus as Z, AgentInput as _, SemanticPredicate as a, AgentArtifact as a0, AgentTrace as a1, AgentHandoff as a2, GuardrailViolation as a3, AgentFeedback as a4, AgentFilter as a5, AgentExecutionFilter as a6, RelationshipMetadata as b, SemanticTriple as c, RelationshipCreateInput as d, RelationshipFilter as e, GraphTraversalResult as f, GraphPath as g, GraphStats as h, Workflow as i, TriggerBase as j, ScheduleTrigger as k, WebhookTrigger as l, WorkflowTrigger as m, StepType as n, WorkflowStep as o, StepConfig as p, EventStepConfig as q, RetryConfig as r, ErrorHandlingConfig as s, CompensationConfig as t, WorkflowConfig as u, ExecutionStatus as v, WorkflowExecution as w, TriggerData as x, ExecutionContext as y, StepExecution as z };

package/dist/app/index.d.ts

@@ -0,0 +1,347 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { d as DOShellConfig, e as DOShellContextValue } from '../config-CmZBQQaT.js';
+import { Sidebar } from '@mdxui/primitives';
+import { useAuth } from '@workos-inc/authkit-react';
+export { DOClient, DOContextValue, DOProvider, DOProviderProps, useDO, useDOClient, useDOUrls, useDataProviderSafe, useSyncStatus } from '../providers/index.js';
+export { useQueryClient } from '@tanstack/react-query';
+import { z } from 'zod';
+import '../do-C-t9UgjT.js';
+import '@mdxui/app';
+
+interface DOAppProps {
+    /** Shell configuration */
+    config: DOShellConfig;
+    /** Optional custom content to render in the shell header */
+    headerContent?: React.ReactNode;
+    /** Optional custom content to render in the sidebar header */
+    sidebarHeaderContent?: React.ReactNode;
+}
+/**
+ * DOApp - Complete routed DO Admin Dashboard application with authentication
+ *
+ * This is the main entry point for using DO Admin with WorkOS authentication and routing.
+ * It sets up all necessary providers, routing, and the shell.
+ *
+ * @example
+ * ```tsx
+ * import { DOApp } from '@mdxui/do'
+ *
+ * function App() {
+ *   return (
+ *     <DOApp
+ *       config={{
+ *         do: {
+ *           apiEndpoint: 'https://api.do.ai',
+ *           authMethod: 'jwt',
+ *           bindings: [],
+ *           realTimeUpdates: true,
+ *         },
+ *         identity: {
+ *           clientId: 'client_xxx',
+ *           devMode: true,
+ *         },
+ *         branding: {
+ *           name: 'My DO Admin',
+ *         },
+ *         defaultNamespace: 'production',
+ *       }}
+ *     />
+ *   )
+ * }
+ * ```
+ */
+declare function DOApp({ config, headerContent, sidebarHeaderContent }: DOAppProps): react_jsx_runtime.JSX.Element;
+
+interface DOShellProps {
+    /** Optional children to render instead of using Outlet */
+    children?: React.ReactNode;
+    /** Optional header content for the sidebar */
+    sidebarHeaderContent?: React.ReactNode;
+    /** Optional content to render in the header after breadcrumbs */
+    headerContent?: React.ReactNode;
+    /** Breadcrumb items to display (future enhancement) */
+    breadcrumbs?: Array<{
+        label: string;
+        href?: string;
+    }>;
+}
+/**
+ * DOShell - Main layout wrapper for the DO Admin Dashboard.
+ *
+ * This layout provides:
+ * - Authentication gate (shows landing page if not authenticated)
+ * - A collapsible sidebar with navigation on the left
+ * - A main content area with a header containing breadcrumbs
+ * - Toast notifications via Sonner
+ * - Responsive design that works on mobile and desktop
+ *
+ * The layout uses react-router-dom's Outlet for nested routes.
+ *
+ * @example
+ * ```tsx
+ * // As a route layout using Outlet
+ * <DOShell />
+ *
+ * // With custom children
+ * <DOShell>
+ *   <CustomContent />
+ * </DOShell>
+ *
+ * // With header content
+ * <DOShell headerContent={<SearchBar />} />
+ * ```
+ */
+declare function DOShell({ children, sidebarHeaderContent, headerContent, breadcrumbs, }: DOShellProps): react_jsx_runtime.JSX.Element;
+
+interface DOShellNavProps extends React.ComponentProps<typeof Sidebar> {
+    /** Optional header content to display at the top of the sidebar */
+    headerContent?: React.ReactNode;
+}
+/**
+ * DOShellNav - Sidebar navigation component for the DO Shell.
+ *
+ * Features:
+ * - Highlights active route based on current location
+ * - Uses lucide-react icons for each navigation item
+ * - Collapsible on mobile via the Sidebar component
+ * - Supports custom header content
+ * - Routes can be enabled/disabled via config
+ */
+declare function DOShellNav({ headerContent, ...props }: DOShellNavProps): react_jsx_runtime.JSX.Element;
+
+interface UserMenuProps {
+    /** Whether to show in compact mode (icon only) */
+    compact?: boolean;
+}
+/**
+ * UserMenu - User dropdown with profile info and sign out
+ *
+ * Displays the current user's avatar and name, with options for
+ * settings and signing out.
+ */
+declare function UserMenu({ compact }: UserMenuProps): react_jsx_runtime.JSX.Element | null;
+
+interface AuthGateProps {
+    children: ReactNode;
+}
+/**
+ * AuthGate handles authentication state and shows appropriate UI:
+ * - Loading state while checking auth
+ * - Landing page or redirect when not authenticated
+ * - Children (dashboard) when authenticated
+ */
+declare function AuthGate({ children }: AuthGateProps): react_jsx_runtime.JSX.Element;
+
+interface DOShellProviderProps {
+    config: DOShellConfig;
+    children: ReactNode;
+}
+/**
+ * DOShellProvider - Context provider for DOShell configuration
+ *
+ * Provides shell configuration to all child components.
+ * Should be used inside the DOAppProviders composition.
+ */
+declare function DOShellProvider({ config, children }: DOShellProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access DOShell configuration
+ */
+declare function useDOShell(): DOShellContextValue;
+/**
+ * Hook to access enabled routes configuration
+ */
+declare function useDOShellRoutes(): Partial<Record<string, boolean>>;
+
+interface AppProvidersProps {
+    config: DOShellConfig;
+    children: ReactNode;
+}
+/**
+ * AppProviders - Composed provider hierarchy for DOShell
+ *
+ * Provider hierarchy:
+ * - ThemeProvider (next-themes) - Theme mode (light/dark/system)
+ * - DOShellProvider - Shell config context
+ * - DOIdentityProvider - WorkOS AuthKit authentication
+ * - DOProvider - RPC client, namespace, TanStack Query
+ *
+ * @example
+ * ```tsx
+ * <AppProviders
+ *   config={{
+ *     do: { apiEndpoint: '...', authMethod: 'jwt', bindings: [], realTimeUpdates: true },
+ *     identity: { clientId: 'client_xxx', devMode: true },
+ *   }}
+ * >
+ *   <DOShell />
+ * </AppProviders>
+ * ```
+ */
+declare function AppProviders({ config, children }: AppProvidersProps): react_jsx_runtime.JSX.Element;
+declare const DOAppProviders: typeof AppProviders;
+
+/**
+ * Hook to access identity/auth state.
+ * Re-exports useAuth from WorkOS AuthKit for convenience.
+ */
+declare const useIdentity: typeof useAuth;
+interface DOIdentityProviderProps {
+    children: ReactNode;
+}
+/**
+ * Identity provider that wraps the shell with WorkOS AuthKit authentication.
+ *
+ * Provides authentication context to all child components.
+ */
+declare function DOIdentityProvider({ children }: DOIdentityProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * OverviewPage - Main dashboard landing page
+ *
+ * Shows stats, quick actions, and recent activity.
+ */
+declare function OverviewPage(): react_jsx_runtime.JSX.Element;
+
+/**
+ * ThingsPage - Renders DataBrowserView with route params
+ *
+ * Route: /things/:ns?/:type?
+ */
+declare function ThingsPage(): react_jsx_runtime.JSX.Element;
+
+/**
+ * DatabasesPage - Renders DataGridView with route params
+ *
+ * Route: /databases/:ns?/:type?
+ */
+declare function DatabasesPage(): react_jsx_runtime.JSX.Element;
+
+/**
+ * DocumentPage - Renders DocumentEditorView with route params
+ *
+ * Route: /things/:ns/:type/:id
+ */
+declare function DocumentPage(): react_jsx_runtime.JSX.Element;
+
+/**
+ * FunctionsPage - Renders FunctionEditorView
+ *
+ * Route: /functions
+ */
+declare function FunctionsPage(): react_jsx_runtime.JSX.Element;
+
+interface PlaceholderPageProps {
+    /** Title for the page */
+    title: string;
+    /** Description of what this page will contain */
+    description?: string;
+}
+/**
+ * PlaceholderPage - Shows a "coming soon" message for unimplemented routes
+ */
+declare function PlaceholderPage({ title, description }: PlaceholderPageProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Route parameter schemas for DO Shell routes
+ *
+ * These Zod schemas define and validate route parameters.
+ */
+
+/**
+ * Schema for database route params
+ */
+declare const DatabaseRouteParams: z.ZodObject<{
+    ns: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type?: string | undefined;
+    ns?: string | undefined;
+}, {
+    type?: string | undefined;
+    ns?: string | undefined;
+}>;
+type DatabaseRouteParamsType = z.infer<typeof DatabaseRouteParams>;
+/**
+ * Schema for things browse route params
+ */
+declare const ThingsRouteParams: z.ZodObject<{
+    ns: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type?: string | undefined;
+    ns?: string | undefined;
+}, {
+    type?: string | undefined;
+    ns?: string | undefined;
+}>;
+type ThingsRouteParamsType = z.infer<typeof ThingsRouteParams>;
+/**
+ * Schema for document route params
+ */
+declare const DocumentRouteParams: z.ZodObject<{
+    ns: z.ZodString;
+    type: z.ZodString;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    ns: string;
+    id: string;
+}, {
+    type: string;
+    ns: string;
+    id: string;
+}>;
+type DocumentRouteParamsType = z.infer<typeof DocumentRouteParams>;
+/**
+ * Schema for generic type-filtered route params
+ */
+declare const TypeFilteredRouteParams: z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type?: string | undefined;
+}, {
+    type?: string | undefined;
+}>;
+type TypeFilteredRouteParamsType = z.infer<typeof TypeFilteredRouteParams>;
+
+/**
+ * DO Shell Routes
+ *
+ * Route definitions and parameter schemas for the DO Admin Dashboard.
+ */
+
+/**
+ * Route paths for DO Shell navigation
+ *
+ * These paths are used throughout the shell for navigation links
+ * and route matching.
+ */
+declare const doRoutePaths: {
+    readonly overview: "/";
+    readonly agents: "/agents";
+    readonly functions: "/functions";
+    readonly workflows: "/workflows";
+    readonly databases: "/databases";
+    readonly databaseTable: "/databases/:ns/:type";
+    readonly things: "/things";
+    readonly thingsBrowse: "/things/:ns/:type?";
+    readonly document: "/things/:ns/:type/:id";
+    readonly nouns: "/nouns";
+    readonly verbs: "/verbs";
+    readonly actions: "/actions";
+    readonly relationships: "/relationships";
+    readonly events: "/events";
+    readonly customers: "/customers";
+    readonly subscriptions: "/subscriptions";
+    readonly integrations: "/integrations";
+    readonly orgs: "/orgs";
+    readonly roles: "/roles";
+    readonly users: "/users";
+    readonly apiKeys: "/api-keys";
+    readonly settings: "/settings";
+};
+type DORoutePath = typeof doRoutePaths[keyof typeof doRoutePaths];
+
+export { AppProviders, type AppProvidersProps, AuthGate, type AuthGateProps, DOApp, type DOAppProps, DOAppProviders, DOIdentityProvider, type DOIdentityProviderProps, type DORoutePath, DOShell, DOShellNav, type DOShellNavProps, type DOShellProps, DOShellProvider, DatabaseRouteParams, type DatabaseRouteParamsType, DatabasesPage, DocumentPage, DocumentRouteParams, type DocumentRouteParamsType, FunctionsPage, OverviewPage, PlaceholderPage, ThingsPage, ThingsRouteParams, type ThingsRouteParamsType, TypeFilteredRouteParams, type TypeFilteredRouteParamsType, UserMenu, doRoutePaths, useDOShell, useDOShellRoutes, useIdentity };

package/dist/app/index.js

@@ -0,0 +1,13 @@
+export { AppProviders, AuthGate, DOApp, DOAppProviders, DOIdentityProvider, DOShell, DOShellNav, DOShellProvider, DatabaseRouteParams, DatabasesPage, DocumentPage, DocumentRouteParams, FunctionsPage, OverviewPage, PlaceholderPage, ThingsPage, ThingsRouteParams, TypeFilteredRouteParams, UserMenu, doRoutePaths, useDOShell, useDOShellRoutes, useIdentity } from '../chunk-NTSEARBC.js';
+import '../chunk-YGIBMNRH.js';
+import '../chunk-5AWTQDRF.js';
+import '../chunk-GKSP5RIA.js';
+import '../chunk-IESVTECE.js';
+import '../chunk-JWKIONEO.js';
+import '../chunk-4KXVN3EQ.js';
+export { DOProvider, useDO, useDOClient, useDOUrls, useDataProviderSafe, useQueryClient, useSyncStatus } from '../chunk-FO3N7SXV.js';
+import '../chunk-OWEAW4U6.js';
+import '../chunk-Y52IEYVM.js';
+import '../chunk-GGO5GW72.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/chunk-4KXVN3EQ.js

@@ -0,0 +1,56 @@
+// src/lib/query-keys.ts
+var thingsKeys = {
+  all: ["things"],
+  lists: () => [...thingsKeys.all, "list"],
+  list: (filter, sort, pagination) => [...thingsKeys.lists(), { filter, sort, pagination }],
+  details: () => [...thingsKeys.all, "detail"],
+  detail: (ns, type, id) => [...thingsKeys.details(), ns, type, id],
+  versions: (ns, type, id) => [...thingsKeys.detail(ns, type, id), "versions"],
+  types: () => [...thingsKeys.all, "types"],
+  typeStats: (ns, type) => [...thingsKeys.types(), ns, type]
+};
+var agentsKeys = {
+  all: ["agents"],
+  lists: () => [...agentsKeys.all, "list"],
+  list: (filter) => [...agentsKeys.lists(), filter],
+  details: () => [...agentsKeys.all, "detail"],
+  detail: (id) => [...agentsKeys.details(), id],
+  metrics: (id) => [...agentsKeys.detail(id), "metrics"],
+  executions: () => [...agentsKeys.all, "executions"],
+  executionsList: (filter) => [...agentsKeys.executions(), "list", filter],
+  execution: (id) => [...agentsKeys.executions(), "detail", id]
+};
+var workflowsKeys = {
+  all: ["workflows"],
+  lists: () => [...workflowsKeys.all, "list"],
+  list: (filter) => [...workflowsKeys.lists(), filter],
+  details: () => [...workflowsKeys.all, "detail"],
+  detail: (id) => [...workflowsKeys.details(), id],
+  executions: () => [...workflowsKeys.all, "executions"],
+  executionsList: (filter) => [...workflowsKeys.executions(), "list", filter],
+  execution: (id) => [...workflowsKeys.executions(), "detail", id]
+};
+var relationshipsKeys = {
+  all: ["relationships"],
+  lists: () => [...relationshipsKeys.all, "list"],
+  list: (filter) => [...relationshipsKeys.lists(), filter],
+  details: () => [...relationshipsKeys.all, "detail"],
+  detail: (id) => [...relationshipsKeys.details(), id],
+  graph: () => [...relationshipsKeys.all, "graph"],
+  traverse: (entity, pattern) => [...relationshipsKeys.graph(), entity, pattern],
+  stats: () => [...relationshipsKeys.all, "stats"]
+};
+function createQueryKeys(resource) {
+  const keys = {
+    all: [resource],
+    lists: () => [resource, "list"],
+    list: (filter) => [...keys.lists(), filter],
+    details: () => [resource, "detail"],
+    detail: (id) => [resource, "detail", id]
+  };
+  return keys;
+}
+
+export { agentsKeys, createQueryKeys, relationshipsKeys, thingsKeys, workflowsKeys };
+//# sourceMappingURL=chunk-4KXVN3EQ.js.map
+//# sourceMappingURL=chunk-4KXVN3EQ.js.map

package/dist/chunk-4KXVN3EQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/query-keys.ts"],"names":[],"mappings":";AAoDO,IAAM,UAAA,GAAa;AAAA,EACxB,GAAA,EAAK,CAAC,QAAQ,CAAA;AAAA,EACd,OAAO,MAAM,CAAC,GAAG,UAAA,CAAW,KAAK,MAAM,CAAA;AAAA,EACvC,IAAA,EAAM,CAAC,MAAA,EAAqB,IAAA,EAAkB,eAC5C,CAAC,GAAG,UAAA,CAAW,KAAA,EAAM,EAAG,EAAE,MAAA,EAAQ,IAAA,EAAM,YAAY,CAAA;AAAA,EACtD,SAAS,MAAM,CAAC,GAAG,UAAA,CAAW,KAAK,QAAQ,CAAA;AAAA,EAC3C,MAAA,EAAQ,CAAC,EAAA,EAAY,IAAA,EAAc,EAAA,KAAe,CAAC,GAAG,UAAA,CAAW,OAAA,EAAQ,EAAG,EAAA,EAAI,IAAA,EAAM,EAAE,CAAA;AAAA,EACxF,QAAA,EAAU,CAAC,EAAA,EAAY,IAAA,EAAc,EAAA,KACnC,CAAC,GAAG,UAAA,CAAW,MAAA,CAAO,EAAA,EAAI,IAAA,EAAM,EAAE,GAAG,UAAU,CAAA;AAAA,EACjD,OAAO,MAAM,CAAC,GAAG,UAAA,CAAW,KAAK,OAAO,CAAA;AAAA,EACxC,SAAA,EAAW,CAAC,EAAA,EAAY,IAAA,KAAiB,CAAC,GAAG,UAAA,CAAW,KAAA,EAAM,EAAG,EAAA,EAAI,IAAI;AAC3E;AAUO,IAAM,UAAA,GAAa;AAAA,EACxB,GAAA,EAAK,CAAC,QAAQ,CAAA;AAAA,EACd,OAAO,MAAM,CAAC,GAAG,UAAA,CAAW,KAAK,MAAM,CAAA;AAAA,EACvC,IAAA,EAAM,CAAC,MAAA,KAAwB,CAAC,GAAG,UAAA,CAAW,KAAA,IAAS,MAAM,CAAA;AAAA,EAC7D,SAAS,MAAM,CAAC,GAAG,UAAA,CAAW,KAAK,QAAQ,CAAA;AAAA,EAC3C,MAAA,EAAQ,CAAC,EAAA,KAAe,CAAC,GAAG,UAAA,CAAW,OAAA,IAAW,EAAE,CAAA;AAAA,EACpD,OAAA,EAAS,CAAC,EAAA,KAAe,CAAC,GAAG,UAAA,CAAW,MAAA,CAAO,EAAE,CAAA,EAAG,SAAS,CAAA;AAAA,EAC7D,YAAY,MAAM,CAAC,GAAG,UAAA,CAAW,KAAK,YAAY,CAAA;AAAA,EAClD,cAAA,EAAgB,CAAC,MAAA,KAAiC,CAAC,GAAG,UAAA,CAAW,UAAA,EAAW,EAAG,MAAA,EAAQ,MAAM,CAAA;AAAA,EAC7F,SAAA,EAAW,CAAC,EAAA,KAAe,CAAC,GAAG,UAAA,CAAW,UAAA,EAAW,EAAG,QAAA,EAAU,EAAE;AACtE;AASO,IAAM,aAAA,GAAgB;AAAA,EAC3B,GAAA,EAAK,CAAC,WAAW,CAAA;AAAA,EACjB,OAAO,MAAM,CAAC,GAAG,aAAA,CAAc,KAAK,MAAM,CAAA;AAAA,EAC1C,IAAA,EAAM,CAAC,MAAA,KAA2B,CAAC,GAAG,aAAA,CAAc,KAAA,IAAS,MAAM,CAAA;AAAA,EACnE,SAAS,MAAM,CAAC,GAAG,aAAA,CAAc,KAAK,QAAQ,CAAA;AAAA,EAC9C,MAAA,EAAQ,CAAC,EAAA,KAAe,CAAC,GAAG,aAAA,CAAc,OAAA,IAAW,EAAE,CAAA;AAAA,EACvD,YAAY,MAAM,CAAC,GAAG,aAAA,CAAc,KAAK,YAAY,CAAA;AAAA,EACrD,cAAA,EAAgB,CAAC,MAAA,KAA4B,CAAC,GAAG,aAAA,CAAc,UAAA,EAAW,EAAG,MAAA,EAAQ,MAAM,CAAA;AAAA,EAC3F,SAAA,EAAW,CAAC,EAAA,KAAe,CAAC,GAAG,aAAA,CAAc,UAAA,EAAW,EAAG,QAAA,EAAU,EAAE;AACzE;AAUO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,GAAA,EAAK,CAAC,eAAe,CAAA;AAAA,EACrB,OAAO,MAAM,CAAC,GAAG,iBAAA,CAAkB,KAAK,MAAM,CAAA;AAAA,EAC9C,IAAA,EAAM,CAAC,MAAA,KAA+B,CAAC,GAAG,iBAAA,CAAkB,KAAA,IAAS,MAAM,CAAA;AAAA,EAC3E,SAAS,MAAM,CAAC,GAAG,iBAAA,CAAkB,KAAK,QAAQ,CAAA;AAAA,EAClD,MAAA,EAAQ,CAAC,EAAA,KAAe,CAAC,GAAG,iBAAA,CAAkB,OAAA,IAAW,EAAE,CAAA;AAAA,EAC3D,OAAO,MAAM,CAAC,GAAG,iBAAA,CAAkB,KAAK,OAAO,CAAA;AAAA,EAC/C,QAAA,EAAU,CAAC,MAAA,EAAyB,OAAA,KAClC,CAAC,GAAG,iBAAA,CAAkB,KAAA,EAAM,EAAG,MAAA,EAAQ,OAAO,CAAA;AAAA,EAChD,OAAO,MAAM,CAAC,GAAG,iBAAA,CAAkB,KAAK,OAAO;AACjD;AA4CO,SAAS,gBAAmC,QAAA,EAAsC;AACvF,EAAA,MAAM,IAAA,GAA2B;AAAA,IAC/B,GAAA,EAAK,CAAC,QAAQ,CAAA;AAAA,IACd,KAAA,EAAO,MAAM,CAAC,QAAA,EAAU,MAAM,CAAA;AAAA,IAC9B,IAAA,EAAM,CAAC,MAAA,KAAoB,CAAC,GAAG,IAAA,CAAK,KAAA,IAAS,MAAM,CAAA;AAAA,IACnD,OAAA,EAAS,MAAM,CAAC,QAAA,EAAU,QAAQ,CAAA;AAAA,IAClC,QAAQ,CAAC,EAAA,KAAe,CAAC,QAAA,EAAU,UAAU,EAAE;AAAA,GACjD;AACA,EAAA,OAAO,IAAA;AACT","file":"chunk-4KXVN3EQ.js","sourcesContent":["/**\n * Query Key Factory Pattern\n *\n * Provides a generic factory for creating type-safe TanStack Query keys.\n * Eliminates copy-paste duplication across hook files while maintaining\n * consistent cache invalidation patterns.\n *\n * @example\n * ```typescript\n * // Create typed keys for a resource\n * export const agentsKeys = createQueryKeys<AgentFilter>('agents')\n *\n * // Usage in hooks\n * const queryKey = agentsKeys.list({ status: ['active'] })\n * queryClient.invalidateQueries({ queryKey: agentsKeys.all })\n * ```\n */\n\nimport type {\n  ThingFilter,\n  ThingSort,\n  ThingPagination,\n  AgentFilter,\n  AgentExecutionFilter,\n  WorkflowFilter,\n  ExecutionFilter,\n  RelationshipFilter,\n  EntityReference,\n  GraphPattern,\n} from '../types'\n\n/**\n * Generic pagination parameters for list queries\n */\nexport interface Pagination {\n  page?: number\n  perPage?: number\n  cursor?: string\n}\n\n// ============================================================================\n// Pre-defined keys for known resources\n// ============================================================================\n\n/**\n * Query keys for Things resource\n *\n * Things have a special key structure because:\n * - List queries include filter, sort, and pagination\n * - Detail queries use composite keys (ns, type, id) instead of a single id\n * - Additional sub-queries for versions and type stats\n */\nexport const thingsKeys = {\n  all: ['things'] as const,\n  lists: () => [...thingsKeys.all, 'list'] as const,\n  list: (filter: ThingFilter, sort?: ThingSort, pagination?: ThingPagination) =>\n    [...thingsKeys.lists(), { filter, sort, pagination }] as const,\n  details: () => [...thingsKeys.all, 'detail'] as const,\n  detail: (ns: string, type: string, id: string) => [...thingsKeys.details(), ns, type, id] as const,\n  versions: (ns: string, type: string, id: string) =>\n    [...thingsKeys.detail(ns, type, id), 'versions'] as const,\n  types: () => [...thingsKeys.all, 'types'] as const,\n  typeStats: (ns: string, type: string) => [...thingsKeys.types(), ns, type] as const,\n}\n\n/**\n * Query keys for Agents resource\n *\n * Includes keys for:\n * - Agent lists and details\n * - Agent metrics (per-agent)\n * - Agent executions (list and detail)\n */\nexport const agentsKeys = {\n  all: ['agents'] as const,\n  lists: () => [...agentsKeys.all, 'list'] as const,\n  list: (filter: AgentFilter) => [...agentsKeys.lists(), filter] as const,\n  details: () => [...agentsKeys.all, 'detail'] as const,\n  detail: (id: string) => [...agentsKeys.details(), id] as const,\n  metrics: (id: string) => [...agentsKeys.detail(id), 'metrics'] as const,\n  executions: () => [...agentsKeys.all, 'executions'] as const,\n  executionsList: (filter: AgentExecutionFilter) => [...agentsKeys.executions(), 'list', filter] as const,\n  execution: (id: string) => [...agentsKeys.executions(), 'detail', id] as const,\n}\n\n/**\n * Query keys for Workflows resource\n *\n * Includes keys for:\n * - Workflow lists and details\n * - Workflow executions (list and detail)\n */\nexport const workflowsKeys = {\n  all: ['workflows'] as const,\n  lists: () => [...workflowsKeys.all, 'list'] as const,\n  list: (filter: WorkflowFilter) => [...workflowsKeys.lists(), filter] as const,\n  details: () => [...workflowsKeys.all, 'detail'] as const,\n  detail: (id: string) => [...workflowsKeys.details(), id] as const,\n  executions: () => [...workflowsKeys.all, 'executions'] as const,\n  executionsList: (filter: ExecutionFilter) => [...workflowsKeys.executions(), 'list', filter] as const,\n  execution: (id: string) => [...workflowsKeys.executions(), 'detail', id] as const,\n}\n\n/**\n * Query keys for Relationships resource\n *\n * Includes keys for:\n * - Relationship lists and details\n * - Graph traversal queries\n * - Graph statistics\n */\nexport const relationshipsKeys = {\n  all: ['relationships'] as const,\n  lists: () => [...relationshipsKeys.all, 'list'] as const,\n  list: (filter: RelationshipFilter) => [...relationshipsKeys.lists(), filter] as const,\n  details: () => [...relationshipsKeys.all, 'detail'] as const,\n  detail: (id: string) => [...relationshipsKeys.details(), id] as const,\n  graph: () => [...relationshipsKeys.all, 'graph'] as const,\n  traverse: (entity: EntityReference, pattern: GraphPattern) =>\n    [...relationshipsKeys.graph(), entity, pattern] as const,\n  stats: () => [...relationshipsKeys.all, 'stats'] as const,\n}\n\n// ============================================================================\n// Generic Factory Functions (for custom resources)\n// ============================================================================\n\n/**\n * Base query keys structure that all resources share\n */\nexport interface QueryKeys<TFilter = unknown> {\n  /** Root key for all queries of this resource */\n  all: readonly [string]\n  /** Key for all list queries */\n  lists: () => readonly [string, 'list']\n  /** Key for a specific list query with filter */\n  list: (filter: TFilter) => readonly unknown[]\n  /** Key for all detail queries */\n  details: () => readonly [string, 'detail']\n  /** Key for a specific detail query */\n  detail: (id: string) => readonly [string, 'detail', string]\n}\n\n/**\n * Create a basic query key factory for a resource\n *\n * @param resource - The resource name (e.g., 'agents', 'workflows')\n * @returns Query key factory with type-safe keys\n *\n * @example\n * ```typescript\n * const customKeys = createQueryKeys<CustomFilter>('custom')\n *\n * // All queries\n * customKeys.all // ['custom']\n *\n * // List queries\n * customKeys.lists() // ['custom', 'list']\n * customKeys.list({ status: 'active' }) // ['custom', 'list', { status: 'active' }]\n *\n * // Detail queries\n * customKeys.details() // ['custom', 'detail']\n * customKeys.detail('item-1') // ['custom', 'detail', 'item-1']\n * ```\n */\nexport function createQueryKeys<TFilter = unknown>(resource: string): QueryKeys<TFilter> {\n  const keys: QueryKeys<TFilter> = {\n    all: [resource] as const,\n    lists: () => [resource, 'list'] as const,\n    list: (filter: TFilter) => [...keys.lists(), filter] as const,\n    details: () => [resource, 'detail'] as const,\n    detail: (id: string) => [resource, 'detail', id] as const,\n  }\n  return keys\n}\n"]}