@mdxui/do 2.1.1 → 4.0.0

package/dist/lib/index.js

@@ -0,0 +1,6 @@
+export { APIError, NetworkError, SyncError, ValidationError, isAPIError, isNetworkError, isSyncError, isValidationError } from '../chunk-JJLAES6W.js';
+export { agentsKeys, createQueryKeys, relationshipsKeys, thingsKeys, workflowsKeys } from '../chunk-4KXVN3EQ.js';
+export { $CapnwebContext, $JsonRpcContext, $MockContext, DEFAULT_REQUEST_TIMEOUT, MOCK_TYPES, createCapnwebClient, createFetchWithTimeout, createJsonRpcClient, createMockClient, deriveRpcUrl, fetchWithTimeout, generateInitialMockData, generateMockSchema, generateMockThing, generateMockThings, useHealthCheck } from '../chunk-OVLO7UOH.js';
+export { camelToTitle, capitalize, cn, debounce, formatBytes, formatDate, formatDateTime, formatDuration, formatNumber, formatRelativeTime, formatSemanticId, generateId, groupBy, parseSemanticId, retryWithBackoff, truncate } from '../chunk-Y52IEYVM.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

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

package/dist/providers/index.d.ts

@@ -1,13 +1,27 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React from 'react';
-import { QueryClient } from '@tanstack/react-query';
-import { DotdoContextValue } from '@dotdo/react';
 import { DataProvider } from '@mdxui/app';
-import { D as DOAdminConfig, S as SyncStatus } from '../do-CaQVueZw.js';
+import { QueryClient } from '@tanstack/react-query';
+export { useQueryClient } from '@tanstack/react-query';
+import * as React from 'react';
+import { $ as $CapnwebContext } from '../capnweb-client-Bq78FtEA.js';
+import { i as DOAdminConfig } from '../do-D27i5bU0.js';
 import 'zod';
 
+/**
+ * Type for the DO client instance
+ *
+ * The client provides a structured interface for RPC operations.
+ * Common patterns:
+ * - client.Thing.list({ type: 'User' })
+ * - client.Thing.get({ id: 'xxx' })
+ * - client.Thing.create({ type: 'User', name: 'Alice', data: {} })
+ * - client.Schema.discover()
+ */
+type DOClient = ReturnType<typeof $CapnwebContext>;
 /**
  * DO Context value
+ *
+ * Provides access to config, connection state, RPC URL, and the @dotdo/client instance.
  */
 interface DOContextValue {
     /** Admin configuration */
@@ -22,36 +36,85 @@ interface DOContextValue {
     isConnected: boolean;
     /** Connection error */
     connectionError?: Error;
-    /** Sync status (TanStack DB mode) */
-    syncStatus: SyncStatus;
-    /** RPC URL derived from doUrl */
-    rpcUrl: string | null;
-    /** Sync URL derived from doUrl */
-    syncUrl: string | null;
-    /** Whether using TanStack DB mode */
-    isTanStackDBMode: boolean;
-    /** TanStack DB context from @dotdo/react (null in REST mode) */
-    db: DotdoContextValue | null;
-    /** Collections being synced */
-    collections: readonly string[];
+    /** RPC URL for capnweb session */
+    rpcUrl: string;
+    /** @dotdo/client instance for direct RPC calls */
+    client: DOClient;
 }
 /**
- * Hook to access DO context
+ * Primary hook for accessing the DO provider context.
+ *
+ * This is the **main hook for application development** with @mdxui/do.
+ * It provides access to configuration, connection state, RPC URL, and the client.
+ *
+ * @returns The DO context value containing config, state, rpcUrl, and client
+ * @throws Error if called outside of a `DOProvider`
+ *
+ * @example
+ * ```tsx
+ * import { useDO } from '@mdxui/do'
+ *
+ * function ConnectionStatus() {
+ *   const { isConnected, namespace, rpcUrl, client } = useDO()
+ *
+ *   const handleFetch = async () => {
+ *     const users = await client.Thing.list({ type: 'User' })
+ *     console.log(users)
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <span>Namespace: {namespace}</span>
+ *       <span>Connected: {isConnected ? 'Yes' : 'No'}</span>
+ *       <button onClick={handleFetch}>Fetch Users</button>
+ *     </div>
+ *   )
+ * }
+ * ```
  */
 declare function useDO(): DOContextValue;
 /**
- * Hook to access derived URLs for sync operations
+ * Hook to access the @dotdo/client instance directly.
+ *
+ * Convenience hook for components that only need the RPC client.
+ *
+ * @returns The @dotdo/client instance
+ * @throws Error if called outside of a `DOProvider`
+ *
+ * @example
+ * ```tsx
+ * import { useDOClient } from '@mdxui/do'
+ *
+ * function UserList() {
+ *   const client = useDOClient()
+ *   const [users, setUsers] = useState([])
+ *
+ *   useEffect(() => {
+ *     client.Thing.list({ type: 'User' }).then(setUsers)
+ *   }, [client])
+ *
+ *   return <ul>{users.map(u => <li key={u.id}>{u.name}</li>)}</ul>
+ * }
+ * ```
+ */
+declare function useDOClient(): DOClient;
+/**
+ * Convenience hook to access derived URLs for API operations.
+ *
+ * Returns URL endpoints from the DOProvider configuration,
+ * useful for making direct API calls or debugging connection issues.
+ *
+ * @returns Object containing rpcUrl and apiEndpoint
  */
 declare function useDOUrls(): {
-    rpcUrl: string | null;
-    syncUrl: string | null;
+    rpcUrl: string;
     apiEndpoint: string;
-    doUrl: string | null;
 };
 /**
- * Hook to check sync status
+ * @deprecated Sync status is no longer available in the simplified RPC-only architecture.
+ * This function is kept for backward compatibility but always returns 'disconnected'.
  */
-declare function useSyncStatus(): SyncStatus;
+declare function useSyncStatus(): 'disconnected';
 /**
  * Props for DOProvider
  */
@@ -67,24 +130,57 @@ interface DOProviderProps {
     /** Custom QueryClient (for testing) */
     queryClient?: QueryClient;
 }
-declare function DOProvider({ config, initialNamespace, userId, children, queryClient: providedQueryClient, }: DOProviderProps): react_jsx_runtime.JSX.Element;
-
 /**
- * Hook to safely access the DataProvider, returning null if not available.
+ * DOProvider - Main provider for @mdxui/do
  *
- * This is useful for hooks that can optionally use a DataProvider when one
- * is configured, but should fall back to RPC when no DataProvider is present.
+ * Provides a single-mode RPC-first architecture using @dotdo/client for typed RPC calls.
+ * All data operations go through the RPC endpoint using promise pipelining.
+ *
+ * Namespace state is managed via TanStack Query with localStorage persistence,
+ * allowing it to be shared across components and persist across sessions.
  *
  * @example
  * ```tsx
- * const dataProvider = useDataProviderSafe()
- * if (dataProvider) {
- *   // Use DataProvider
- * } else {
- *   // Fall back to RPC
+ * <DOProvider
+ *   config={{
+ *     apiEndpoint: 'https://admin.do.ai',
+ *     authMethod: 'jwt',
+ *     authToken: 'xxx',
+ *     bindings: [...],
+ *     realTimeUpdates: false,
+ *   }}
+ *   initialNamespace="my-app"
+ *   userId="user_123"
+ * >
+ *   <App />
+ * </DOProvider>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Accessing the client in a child component
+ * function MyComponent() {
+ *   const { client } = useDO()
+ *
+ *   const fetchData = async () => {
+ *     // Promise pipelining - efficient batched RPC calls
+ *     const [users, projects] = await Promise.all([
+ *       client.Thing.list({ type: 'User' }),
+ *       client.Thing.list({ type: 'Project' }),
+ *     ])
+ *     return { users, projects }
+ *   }
  * }
  * ```
  */
+declare function DOProvider({ config, initialNamespace, userId, children, queryClient: providedQueryClient, }: DOProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Hook to safely access the DataProvider, returning null if not available.
+ *
+ * This is useful for hooks that can optionally use a DataProvider when one
+ * is configured, but should fall back to RPC when no DataProvider is present.
+ */
 declare function useDataProviderSafe(): DataProvider | null;
 
-export { type DOContextValue, DOProvider, type DOProviderProps, useDO, useDOUrls, useDataProviderSafe, useSyncStatus };
+export { type DOClient, type DOContextValue, DOProvider, type DOProviderProps, useDO, useDOClient, useDOUrls, useDataProviderSafe, useSyncStatus };

package/dist/providers/index.js

@@ -1,5 +1,6 @@
 import '../chunk-GKSP5RIA.js';
-export { DOProvider, useDO, useDOUrls, useDataProviderSafe, useSyncStatus } from '../chunk-XF6LKY2M.js';
-import '../chunk-G3PMV62Z.js';
+export { DOProvider, useDO, useDOClient, useDOUrls, useDataProviderSafe, useQueryClient, useSyncStatus } from '../chunk-WMNT4OIE.js';
+import '../chunk-OVLO7UOH.js';
+import '../chunk-Y52IEYVM.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/query-keys-CZNFikIi.d.ts

@@ -0,0 +1,153 @@
+import * as zod from 'zod';
+import { EntityReference } from './schemas/index.js';
+import { c as ThingFilter, d as ThingSort, e as ThingPagination } from './thing-BF25aUtJ.js';
+import { a5 as AgentFilter, a6 as AgentExecutionFilter, B as WorkflowFilter, F as ExecutionFilter, e as RelationshipFilter, G as GraphPattern } from './agents-2_r9e9i7.js';
+
+/**
+ * Generic pagination parameters for list queries
+ */
+interface Pagination {
+    page?: number;
+    perPage?: number;
+    cursor?: string;
+}
+/**
+ * Query keys for Things resource
+ *
+ * Things have a special key structure because:
+ * - List queries include filter, sort, and pagination
+ * - Detail queries use composite keys (ns, type, id) instead of a single id
+ * - Additional sub-queries for versions and type stats
+ */
+declare const thingsKeys: {
+    all: readonly ["things"];
+    lists: () => readonly ["things", "list"];
+    list: (filter: ThingFilter, sort?: ThingSort, pagination?: ThingPagination) => readonly ["things", "list", {
+        readonly filter: zod.objectOutputType<{
+            ns: zod.ZodOptional<zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>>;
+            type: zod.ZodOptional<zod.ZodUnion<[zod.ZodString, zod.ZodArray<zod.ZodString, "many">]>>;
+            idPattern: zod.ZodOptional<zod.ZodString>;
+            nameSearch: zod.ZodOptional<zod.ZodString>;
+            createdAfter: zod.ZodOptional<zod.ZodDate>;
+            createdBefore: zod.ZodOptional<zod.ZodDate>;
+            updatedAfter: zod.ZodOptional<zod.ZodDate>;
+            updatedBefore: zod.ZodOptional<zod.ZodDate>;
+            includeDeleted: zod.ZodOptional<zod.ZodBoolean>;
+            properties: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnknown>>;
+            variant: zod.ZodOptional<zod.ZodString>;
+        }, zod.ZodTypeAny, "passthrough">;
+        readonly sort: {
+            order: "desc" | "asc";
+            field: "type" | "name" | "ts" | "createdAt" | "updatedAt";
+        } | undefined;
+        readonly pagination: {
+            page: number;
+            perPage: number;
+        } | undefined;
+    }];
+    details: () => readonly ["things", "detail"];
+    detail: (ns: string, type: string, id: string) => readonly ["things", "detail", string, string, string];
+    versions: (ns: string, type: string, id: string) => readonly ["things", "detail", string, string, string, "versions"];
+    types: () => readonly ["things", "types"];
+    typeStats: (ns: string, type: string) => readonly ["things", "types", string, string];
+};
+/**
+ * Query keys for Agents resource
+ *
+ * Includes keys for:
+ * - Agent lists and details
+ * - Agent metrics (per-agent)
+ * - Agent executions (list and detail)
+ */
+declare const agentsKeys: {
+    all: readonly ["agents"];
+    lists: () => readonly ["agents", "list"];
+    list: (filter: AgentFilter) => readonly ["agents", "list", AgentFilter];
+    details: () => readonly ["agents", "detail"];
+    detail: (id: string) => readonly ["agents", "detail", string];
+    metrics: (id: string) => readonly ["agents", "detail", string, "metrics"];
+    executions: () => readonly ["agents", "executions"];
+    executionsList: (filter: AgentExecutionFilter) => readonly ["agents", "executions", "list", AgentExecutionFilter];
+    execution: (id: string) => readonly ["agents", "executions", "detail", string];
+};
+/**
+ * Query keys for Workflows resource
+ *
+ * Includes keys for:
+ * - Workflow lists and details
+ * - Workflow executions (list and detail)
+ */
+declare const workflowsKeys: {
+    all: readonly ["workflows"];
+    lists: () => readonly ["workflows", "list"];
+    list: (filter: WorkflowFilter) => readonly ["workflows", "list", WorkflowFilter];
+    details: () => readonly ["workflows", "detail"];
+    detail: (id: string) => readonly ["workflows", "detail", string];
+    executions: () => readonly ["workflows", "executions"];
+    executionsList: (filter: ExecutionFilter) => readonly ["workflows", "executions", "list", ExecutionFilter];
+    execution: (id: string) => readonly ["workflows", "executions", "detail", string];
+};
+/**
+ * Query keys for Relationships resource
+ *
+ * Includes keys for:
+ * - Relationship lists and details
+ * - Graph traversal queries
+ * - Graph statistics
+ */
+declare const relationshipsKeys: {
+    all: readonly ["relationships"];
+    lists: () => readonly ["relationships", "list"];
+    list: (filter: RelationshipFilter) => readonly ["relationships", "list", RelationshipFilter];
+    details: () => readonly ["relationships", "detail"];
+    detail: (id: string) => readonly ["relationships", "detail", string];
+    graph: () => readonly ["relationships", "graph"];
+    traverse: (entity: EntityReference, pattern: GraphPattern) => readonly ["relationships", "graph", {
+        id: string;
+        type: string;
+        ns: string;
+        semanticId: string;
+        name?: string | undefined;
+    }, GraphPattern];
+    stats: () => readonly ["relationships", "stats"];
+};
+/**
+ * Base query keys structure that all resources share
+ */
+interface QueryKeys<TFilter = unknown> {
+    /** Root key for all queries of this resource */
+    all: readonly [string];
+    /** Key for all list queries */
+    lists: () => readonly [string, 'list'];
+    /** Key for a specific list query with filter */
+    list: (filter: TFilter) => readonly unknown[];
+    /** Key for all detail queries */
+    details: () => readonly [string, 'detail'];
+    /** Key for a specific detail query */
+    detail: (id: string) => readonly [string, 'detail', string];
+}
+/**
+ * Create a basic query key factory for a resource
+ *
+ * @param resource - The resource name (e.g., 'agents', 'workflows')
+ * @returns Query key factory with type-safe keys
+ *
+ * @example
+ * ```typescript
+ * const customKeys = createQueryKeys<CustomFilter>('custom')
+ *
+ * // All queries
+ * customKeys.all // ['custom']
+ *
+ * // List queries
+ * customKeys.lists() // ['custom', 'list']
+ * customKeys.list({ status: 'active' }) // ['custom', 'list', { status: 'active' }]
+ *
+ * // Detail queries
+ * customKeys.details() // ['custom', 'detail']
+ * customKeys.detail('item-1') // ['custom', 'detail', 'item-1']
+ * ```
+ */
+declare function createQueryKeys<TFilter = unknown>(resource: string): QueryKeys<TFilter>;
+
+export { type Pagination as P, type QueryKeys as Q, agentsKeys as a, createQueryKeys as c, relationshipsKeys as r, thingsKeys as t, workflowsKeys as w };

package/dist/schemas/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export { N as Namespace, x as NamespaceSchema, g as SemanticProperty, v as SemanticPropertySchema, S as SemanticType, w as SemanticTypeSchema, T as Thing, b as ThingCreateInput, r as ThingCreateInputSchema, f as ThingData, l as ThingDataSchema, i as ThingDeleteOptions, t as ThingDeleteOptionsSchema, c as ThingFilter, n as ThingFilterSchema, e as ThingPagination, p as ThingPaginationSchema, a as ThingQueryResult, q as ThingQueryResultSchema, m as ThingSchema, d as ThingSort, o as ThingSortSchema, h as ThingUpdateInput, s as ThingUpdateInputSchema, j as ThingVersion, u as ThingVersionSchema, k as TypeStats, y as TypeStatsSchema } from '../thing-DtI25yZh.js';
+export { N as Namespace, x as NamespaceSchema, b as SemanticProperty, v as SemanticPropertySchema, S as SemanticType, w as SemanticTypeSchema, T as Thing, g as ThingCreateInput, r as ThingCreateInputSchema, a as ThingData, l as ThingDataSchema, i as ThingDeleteOptions, t as ThingDeleteOptionsSchema, c as ThingFilter, n as ThingFilterSchema, e as ThingPagination, p as ThingPaginationSchema, f as ThingQueryResult, q as ThingQueryResultSchema, m as ThingSchema, d as ThingSort, o as ThingSortSchema, h as ThingUpdateInput, s as ThingUpdateInputSchema, j as ThingVersion, u as ThingVersionSchema, k as TypeStats, y as TypeStatsSchema } from '../thing-BF25aUtJ.js';
 
 /**
  * Common Zod Schemas - Shared Schema Definitions
@@ -41,15 +41,15 @@ declare const EntityReferenceSchema: z.ZodObject<{
     /** Display name (if loaded) */
     name: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    id: string;
     type: string;
     ns: string;
-    id: string;
     semanticId: string;
     name?: string | undefined;
 }, {
+    id: string;
     type: string;
     ns: string;
-    id: string;
     semanticId: string;
     name?: string | undefined;
 }>;
@@ -175,15 +175,15 @@ declare const PaginatedResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) =
     /** Total number of pages */
     totalPages: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
+    data: T["_output"][];
     page: number;
     perPage: number;
-    data: T["_output"][];
     total: number;
     totalPages: number;
 }, {
+    data: T["_input"][];
     page: number;
     perPage: number;
-    data: T["_input"][];
     total: number;
     totalPages: number;
 }>;

package/dist/schemas/index.js

@@ -1,6 +1,6 @@
-import '../chunk-G3PMV62Z.js';
 import { z } from 'zod';
 
+// src/types/schemas/common.ts
 var DateSchema = z.coerce.date();
 var OptionalDateSchema = z.union([DateSchema, z.null()]).optional();
 var EntityReferenceSchema = z.object({
@@ -212,7 +212,7 @@ var SemanticTypeSchema = z.object({
   /** Human-readable label */
   label: z.string(),
   /** Type description */
-  description: z.string(),
+  description: z.string().optional(),
   /** Parent types (inheritance) */
   parentTypes: z.array(z.string()),
   /** Properties defined by this type */

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/schemas/common.ts","../../src/schemas/thing.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Common Zod Schemas - Shared Schema Definitions\n *\n * This file contains Zod schemas that are used across multiple domains.\n * Types are derived from these schemas to ensure a single source of truth.\n *\n * @remarks\n * Import schemas from here for validation.\n * Import types from here or from domain files for TypeScript types.\n */\n\nimport { z } from 'zod'\n\n// =============================================================================\n// Date Handling\n// =============================================================================\n\n/**\n * Schema for Date fields that can be either Date objects or ISO strings.\n * API responses typically return ISO strings, not Date objects.\n */\nexport const DateSchema = z.coerce.date()\n\n/**\n * Optional nullable date for responses\n */\nexport const OptionalDateSchema = z.union([DateSchema, z.null()]).optional()\n\n// =============================================================================\n// EntityReference\n// =============================================================================\n\n/**\n * Schema for EntityReference - reference to a Thing in the semantic graph.\n *\n * Used by:\n * - Relationships (subject/object in semantic triples)\n * - Events (subject/object in semantic events)\n * - Graph traversal results\n */\nexport const EntityReferenceSchema = z.object({\n  /** Namespace */\n  ns: z.string(),\n  /** Entity type */\n  type: z.string(),\n  /** Entity ID */\n  id: z.string(),\n  /** Semantic ID (ns/type/id) */\n  semanticId: z.string(),\n  /** Display name (if loaded) */\n  name: z.string().optional(),\n})\n\n/**\n * Reference to an entity (Thing) in the semantic graph.\n */\nexport type EntityReference = z.infer<typeof EntityReferenceSchema>\n\n// =============================================================================\n// TokenUsage\n// =============================================================================\n\n/**\n * Schema for TokenUsage - token usage metrics for AI operations.\n *\n * Used by:\n * - Agent executions\n * - Function executions (generative/agentic)\n * - Agent trace entries\n */\nexport const TokenUsageSchema = z.object({\n  /** Input/prompt tokens */\n  inputTokens: z.number(),\n  /** Output/completion tokens */\n  outputTokens: z.number(),\n  /** Total tokens (input + output) */\n  totalTokens: z.number(),\n  /** Thinking tokens (for reasoning models like o1, Claude with thinking) */\n  thinkingTokens: z.number().optional(),\n  /** Estimated cost in USD */\n  costUsd: z.number().optional(),\n})\n\n/**\n * Token usage metrics for AI operations.\n */\nexport type TokenUsage = z.infer<typeof TokenUsageSchema>\n\n// =============================================================================\n// ExecutionError\n// =============================================================================\n\n/**\n * Schema for ExecutionError - error information for execution failures.\n *\n * Used by:\n * - Workflow executions\n * - Function executions\n * - Step executions\n */\nexport const ExecutionErrorSchema = z.object({\n  /** Error code (e.g., 'TIMEOUT', 'VALIDATION_ERROR', 'RATE_LIMITED') */\n  code: z.string(),\n  /** Human-readable error message */\n  message: z.string(),\n  /** Stack trace (for debugging) */\n  stack: z.string().optional(),\n  /** ID of the step that failed (for workflow executions) */\n  failedStep: z.string().optional(),\n  /** Number of retry attempts made (for function executions) */\n  retryCount: z.number().optional(),\n  /** Whether this error is retryable (for function executions) */\n  retryable: z.boolean().optional(),\n})\n\n/**\n * Error information for execution failures.\n */\nexport type ExecutionError = z.infer<typeof ExecutionErrorSchema>\n\n// =============================================================================\n// SortDirection\n// =============================================================================\n\n/**\n * Schema for SortDirection - sort direction for list queries.\n */\nexport const SortDirectionSchema = z.enum(['asc', 'desc'])\n\n/**\n * Sort direction for list queries.\n */\nexport type SortDirection = z.infer<typeof SortDirectionSchema>\n\n// =============================================================================\n// Pagination Types\n// =============================================================================\n\n/**\n * Schema for Pagination - pagination input parameters for list queries.\n */\nexport const PaginationSchema = z.object({\n  /** Page number (1-indexed) */\n  page: z.number().int().positive(),\n  /** Items per page */\n  perPage: z.number().int().positive(),\n})\n\n/**\n * Pagination input parameters for list queries.\n */\nexport type Pagination = z.infer<typeof PaginationSchema>\n\n/**\n * Schema factory for paginated responses.\n */\nexport const PaginatedResponseSchema = <T extends z.ZodTypeAny>(dataSchema: T) =>\n  z.object({\n    /** Array of items for the current page */\n    data: z.array(dataSchema),\n    /** Total number of items across all pages */\n    total: z.number(),\n    /** Current page number (1-indexed) */\n    page: z.number(),\n    /** Items per page */\n    perPage: z.number(),\n    /** Total number of pages */\n    totalPages: z.number(),\n  })\n\n/**\n * Paginated response wrapper for list queries.\n */\nexport interface PaginatedResponse<T> {\n  /** Array of items for the current page */\n  data: T[]\n  /** Total number of items across all pages */\n  total: number\n  /** Current page number (1-indexed) */\n  page: number\n  /** Items per page */\n  perPage: number\n  /** Total number of pages */\n  totalPages: number\n}\n","/**\n * Thing Zod Schemas - Semantic Entity Management\n *\n * Things are the core entities in the .do platform, stored in the Things table\n * with ClickHouse's ReplacingMergeTree engine for immutable, versioned storage.\n *\n * All types are derived from Zod schemas to ensure a single source of truth.\n *\n * @remarks\n * Key patterns:\n * - Semantic IDs: `[namespace]/[Name]` (e.g., `schema.org/Person`)\n * - JSON-LD compatible data structure\n * - Full version history via Events table\n * - Soft deletes with deletedAt timestamp\n */\n\nimport { z } from 'zod'\nimport { DateSchema, OptionalDateSchema, SortDirectionSchema } from './common'\n\n// =============================================================================\n// ThingData Schema\n// =============================================================================\n\n/**\n * Schema for ThingData - JSON-LD compatible data structure for Things.\n */\nexport const ThingDataSchema = z\n  .object({\n    /** JSON-LD context */\n    '@context': z.union([z.string(), z.record(z.unknown())]).optional(),\n    /** JSON-LD type (should match Thing.type) */\n    '@type': z.string().optional(),\n    /** JSON-LD identifier */\n    '@id': z.string().optional(),\n  })\n  .passthrough()\n\n/**\n * JSON-LD compatible data structure for Things.\n */\nexport type ThingData = z.infer<typeof ThingDataSchema>\n\n// =============================================================================\n// Thing Schema\n// =============================================================================\n\n/**\n * Schema for Thing - base Thing record from database.\n */\nexport const ThingSchema = z.object({\n  /** Namespace (tenant/domain) */\n  ns: z.string(),\n  /** Entity type (e.g., 'Person', 'Organization', 'Agent') */\n  type: z.string(),\n  /** Unique identifier within namespace/type */\n  id: z.string(),\n  /** Version timestamp for deduplication */\n  ts: DateSchema,\n  /** Display name */\n  name: z.string(),\n  /** Creation timestamp */\n  createdAt: DateSchema,\n  /** Last update timestamp */\n  updatedAt: DateSchema,\n  /** Creator user ID */\n  createdBy: z.string().optional(),\n  /** Last updater user ID */\n  updatedBy: z.string().optional(),\n  /** Soft delete timestamp */\n  deletedAt: OptionalDateSchema,\n  /** A/B test variant */\n  variant: z.string().optional(),\n  /** JSON-LD data blob */\n  data: ThingDataSchema,\n})\n\n/**\n * Base Thing record from database.\n */\nexport type Thing = z.infer<typeof ThingSchema>\n\n// =============================================================================\n// ThingFilter Schema\n// =============================================================================\n\n/**\n * Schema for ThingFilter - query filters for Things.\n */\nexport const ThingFilterSchema = z\n  .object({\n    /** Filter by namespace - single string or array of strings */\n    ns: z.union([z.string(), z.array(z.string())]).optional(),\n    /** Filter by type - single string or array of strings */\n    type: z.union([z.string(), z.array(z.string())]).optional(),\n    /** Filter by ID pattern (supports wildcards) */\n    idPattern: z.string().optional(),\n    /** Filter by name (case-insensitive search) */\n    nameSearch: z.string().optional(),\n    /** Filter by creation date range - start */\n    createdAfter: z.coerce.date().optional(),\n    /** Filter by creation date range - end */\n    createdBefore: z.coerce.date().optional(),\n    /** Filter by update date range - start */\n    updatedAfter: z.coerce.date().optional(),\n    /** Filter by update date range - end */\n    updatedBefore: z.coerce.date().optional(),\n    /** Include soft-deleted things */\n    includeDeleted: z.boolean().optional(),\n    /** Filter by specific property values in data */\n    properties: z.record(z.unknown()).optional(),\n    /** Filter by variant */\n    variant: z.string().optional(),\n  })\n  .passthrough()\n\n/**\n * Query filters for Things.\n */\nexport type ThingFilter = z.infer<typeof ThingFilterSchema>\n\n// =============================================================================\n// ThingSort Schema\n// =============================================================================\n\n/**\n * Schema for ThingSort - sort options for Things.\n */\nexport const ThingSortSchema = z.object({\n  /** Field to sort by */\n  field: z.enum(['name', 'createdAt', 'updatedAt', 'ts', 'type']),\n  /** Sort direction */\n  order: SortDirectionSchema,\n})\n\n/**\n * Sort options for Things.\n */\nexport type ThingSort = z.infer<typeof ThingSortSchema>\n\n// =============================================================================\n// ThingPagination Schema\n// =============================================================================\n\n/**\n * Schema for ThingPagination - pagination for Things queries.\n */\nexport const ThingPaginationSchema = z.object({\n  /** Page number (1-indexed, must be positive) */\n  page: z.number().int().positive(),\n  /** Items per page (must be positive, max 1000) */\n  perPage: z.number().int().positive().max(1000),\n})\n\n/**\n * Pagination for Things queries.\n */\nexport type ThingPagination = z.infer<typeof ThingPaginationSchema>\n\n// =============================================================================\n// ThingQueryResult Schema\n// =============================================================================\n\n/**\n * Schema for ThingQueryResult - result of a Things query.\n */\nexport const ThingQueryResultSchema = z.object({\n  /** Matching things */\n  data: z.array(ThingSchema),\n  /** Total count (without pagination) */\n  total: z.number(),\n  /** Current page */\n  page: z.number(),\n  /** Items per page */\n  perPage: z.number(),\n  /** Total pages */\n  totalPages: z.number(),\n})\n\n/**\n * Result of a Things query.\n */\nexport type ThingQueryResult = z.infer<typeof ThingQueryResultSchema>\n\n// =============================================================================\n// ThingCreateInput Schema\n// =============================================================================\n\n/**\n * Schema for ThingCreateInput - thing creation payload.\n */\nexport const ThingCreateInputSchema = z.object({\n  /** Namespace (required, non-empty string) */\n  ns: z.string().min(1, 'Namespace is required'),\n  /** Type (required, non-empty string) */\n  type: z.string().min(1, 'Type is required'),\n  /** ID (optional, auto-generated if not provided) */\n  id: z.string().optional(),\n  /** Display name (required, non-empty string) */\n  name: z.string().min(1, 'Name is required'),\n  /** JSON-LD data */\n  data: ThingDataSchema,\n  /** Variant for A/B testing */\n  variant: z.string().optional(),\n})\n\n/**\n * Thing creation payload.\n */\nexport type ThingCreateInput = z.infer<typeof ThingCreateInputSchema>\n\n// =============================================================================\n// ThingUpdateInput Schema\n// =============================================================================\n\n/**\n * Schema for ThingUpdateInput - thing update payload.\n */\nexport const ThingUpdateInputSchema = z.object({\n  /** Updated name */\n  name: z.string().min(1, 'Name cannot be empty').optional(),\n  /** Updated data (merged with existing) */\n  data: ThingDataSchema.partial().optional(),\n  /** Updated variant */\n  variant: z.string().optional(),\n})\n\n/**\n * Thing update payload.\n */\nexport type ThingUpdateInput = z.infer<typeof ThingUpdateInputSchema>\n\n// =============================================================================\n// ThingDeleteOptions Schema\n// =============================================================================\n\n/**\n * Schema for ThingDeleteOptions - delete options.\n */\nexport const ThingDeleteOptionsSchema = z.object({\n  /** Hard delete (permanent) vs soft delete */\n  hard: z.boolean().optional(),\n})\n\n/**\n * Thing delete options.\n */\nexport type ThingDeleteOptions = z.infer<typeof ThingDeleteOptionsSchema>\n\n// =============================================================================\n// ThingVersion Schema\n// =============================================================================\n\n/**\n * Schema for ThingVersion - thing version from Events table.\n */\nexport const ThingVersionSchema = z.object({\n  /** Event ID */\n  eventId: z.string(),\n  /** Event type (create, update, delete) */\n  eventType: z.enum(['create', 'update', 'delete', 'create_version', 'update_version']),\n  /** Version timestamp */\n  ts: DateSchema,\n  /** User who made the change */\n  userId: z.string(),\n  /** Full data snapshot at this version */\n  data: ThingDataSchema,\n  /** Delta from previous version */\n  delta: ThingDataSchema.optional(),\n  /** Event metadata */\n  metadata: z.record(z.unknown()),\n})\n\n/**\n * Thing version from Events table.\n */\nexport type ThingVersion = z.infer<typeof ThingVersionSchema>\n\n// =============================================================================\n// SemanticProperty Schema\n// =============================================================================\n\n/**\n * Schema for SemanticProperty - property definition for semantic types.\n */\nexport const SemanticPropertySchema = z.object({\n  /** Property name */\n  name: z.string(),\n  /** Property label */\n  label: z.string(),\n  /** Property description */\n  description: z.string(),\n  /** Expected value types */\n  rangeIncludes: z.array(z.string()),\n  /** Types that use this property */\n  domainIncludes: z.array(z.string()),\n  /** Is this property required? */\n  required: z.boolean(),\n  /** Is this property an array? */\n  isArray: z.boolean(),\n  /** Default value */\n  defaultValue: z.unknown().optional(),\n})\n\n/**\n * Property definition for semantic types.\n */\nexport type SemanticProperty = z.infer<typeof SemanticPropertySchema>\n\n// =============================================================================\n// SemanticType Schema\n// =============================================================================\n\n/**\n * Schema for SemanticType - semantic type definition (like schema.org types).\n */\nexport const SemanticTypeSchema = z.object({\n  /** Type namespace (e.g., 'schema.org') */\n  namespace: z.string(),\n  /** Type name (e.g., 'Person') */\n  name: z.string(),\n  /** Full semantic ID */\n  id: z.string(),\n  /** Human-readable label */\n  label: z.string(),\n  /** Type description */\n  description: z.string(),\n  /** Parent types (inheritance) */\n  parentTypes: z.array(z.string()),\n  /** Properties defined by this type */\n  properties: z.array(SemanticPropertySchema),\n  /** Child types */\n  subtypes: z.array(z.string()),\n  /** Example instances */\n  examples: z.array(ThingDataSchema).optional(),\n})\n\n/**\n * Semantic type definition (like schema.org types).\n */\nexport type SemanticType = z.infer<typeof SemanticTypeSchema>\n\n// =============================================================================\n// Namespace Schema\n// =============================================================================\n\n/**\n * Schema for Namespace - namespace definition (tenant/domain).\n */\nexport const NamespaceSchema = z.object({\n  /** Namespace identifier */\n  id: z.string(),\n  /** Namespace name */\n  name: z.string(),\n  /** Namespace description */\n  description: z.string().optional(),\n  /** Base URL for the namespace */\n  baseUrl: z.string().optional(),\n  /** Available types in this namespace */\n  types: z.array(z.string()),\n  /** Thing count in this namespace */\n  thingCount: z.number(),\n  /** Creation timestamp */\n  createdAt: DateSchema,\n})\n\n/**\n * Namespace definition (tenant/domain).\n */\nexport type Namespace = z.infer<typeof NamespaceSchema>\n\n// =============================================================================\n// TypeStats Schema\n// =============================================================================\n\n/**\n * Schema for TypeStats - statistics for a type.\n */\nexport const TypeStatsSchema = z.object({\n  /** Type name */\n  type: z.string(),\n  /** Namespace */\n  ns: z.string(),\n  /** Total count */\n  count: z.number(),\n  /** Active count (not deleted) */\n  activeCount: z.number(),\n  /** Created today */\n  createdToday: z.number(),\n  /** Updated today */\n  updatedToday: z.number(),\n  /** Most recent creation */\n  lastCreatedAt: DateSchema.optional(),\n  /** Most recent update */\n  lastUpdatedAt: DateSchema.optional(),\n})\n\n/**\n * Statistics for a type.\n */\nexport type TypeStats = z.infer<typeof TypeStatsSchema>\n"]}
+{"version":3,"sources":["../../src/types/schemas/common.ts","../../src/types/schemas/thing.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Common Zod Schemas - Shared Schema Definitions\n *\n * This file contains Zod schemas that are used across multiple domains.\n * Types are derived from these schemas to ensure a single source of truth.\n *\n * @remarks\n * Import schemas from here for validation.\n * Import types from here or from domain files for TypeScript types.\n */\n\nimport { z } from 'zod'\n\n// =============================================================================\n// Date Handling\n// =============================================================================\n\n/**\n * Schema for Date fields that can be either Date objects or ISO strings.\n * API responses typically return ISO strings, not Date objects.\n */\nexport const DateSchema = z.coerce.date()\n\n/**\n * Optional nullable date for responses\n */\nexport const OptionalDateSchema = z.union([DateSchema, z.null()]).optional()\n\n// =============================================================================\n// EntityReference\n// =============================================================================\n\n/**\n * Schema for EntityReference - reference to a Thing in the semantic graph.\n *\n * Used by:\n * - Relationships (subject/object in semantic triples)\n * - Events (subject/object in semantic events)\n * - Graph traversal results\n */\nexport const EntityReferenceSchema = z.object({\n  /** Namespace */\n  ns: z.string(),\n  /** Entity type */\n  type: z.string(),\n  /** Entity ID */\n  id: z.string(),\n  /** Semantic ID (ns/type/id) */\n  semanticId: z.string(),\n  /** Display name (if loaded) */\n  name: z.string().optional(),\n})\n\n/**\n * Reference to an entity (Thing) in the semantic graph.\n */\nexport type EntityReference = z.infer<typeof EntityReferenceSchema>\n\n// =============================================================================\n// TokenUsage\n// =============================================================================\n\n/**\n * Schema for TokenUsage - token usage metrics for AI operations.\n *\n * Used by:\n * - Agent executions\n * - Function executions (generative/agentic)\n * - Agent trace entries\n */\nexport const TokenUsageSchema = z.object({\n  /** Input/prompt tokens */\n  inputTokens: z.number(),\n  /** Output/completion tokens */\n  outputTokens: z.number(),\n  /** Total tokens (input + output) */\n  totalTokens: z.number(),\n  /** Thinking tokens (for reasoning models like o1, Claude with thinking) */\n  thinkingTokens: z.number().optional(),\n  /** Estimated cost in USD */\n  costUsd: z.number().optional(),\n})\n\n/**\n * Token usage metrics for AI operations.\n */\nexport type TokenUsage = z.infer<typeof TokenUsageSchema>\n\n// =============================================================================\n// ExecutionError\n// =============================================================================\n\n/**\n * Schema for ExecutionError - error information for execution failures.\n *\n * Used by:\n * - Workflow executions\n * - Function executions\n * - Step executions\n */\nexport const ExecutionErrorSchema = z.object({\n  /** Error code (e.g., 'TIMEOUT', 'VALIDATION_ERROR', 'RATE_LIMITED') */\n  code: z.string(),\n  /** Human-readable error message */\n  message: z.string(),\n  /** Stack trace (for debugging) */\n  stack: z.string().optional(),\n  /** ID of the step that failed (for workflow executions) */\n  failedStep: z.string().optional(),\n  /** Number of retry attempts made (for function executions) */\n  retryCount: z.number().optional(),\n  /** Whether this error is retryable (for function executions) */\n  retryable: z.boolean().optional(),\n})\n\n/**\n * Error information for execution failures.\n */\nexport type ExecutionError = z.infer<typeof ExecutionErrorSchema>\n\n// =============================================================================\n// SortDirection\n// =============================================================================\n\n/**\n * Schema for SortDirection - sort direction for list queries.\n */\nexport const SortDirectionSchema = z.enum(['asc', 'desc'])\n\n/**\n * Sort direction for list queries.\n */\nexport type SortDirection = z.infer<typeof SortDirectionSchema>\n\n// =============================================================================\n// Pagination Types\n// =============================================================================\n\n/**\n * Schema for Pagination - pagination input parameters for list queries.\n */\nexport const PaginationSchema = z.object({\n  /** Page number (1-indexed) */\n  page: z.number().int().positive(),\n  /** Items per page */\n  perPage: z.number().int().positive(),\n})\n\n/**\n * Pagination input parameters for list queries.\n */\nexport type Pagination = z.infer<typeof PaginationSchema>\n\n/**\n * Schema factory for paginated responses.\n */\nexport const PaginatedResponseSchema = <T extends z.ZodTypeAny>(dataSchema: T) =>\n  z.object({\n    /** Array of items for the current page */\n    data: z.array(dataSchema),\n    /** Total number of items across all pages */\n    total: z.number(),\n    /** Current page number (1-indexed) */\n    page: z.number(),\n    /** Items per page */\n    perPage: z.number(),\n    /** Total number of pages */\n    totalPages: z.number(),\n  })\n\n/**\n * Paginated response wrapper for list queries.\n */\nexport interface PaginatedResponse<T> {\n  /** Array of items for the current page */\n  data: T[]\n  /** Total number of items across all pages */\n  total: number\n  /** Current page number (1-indexed) */\n  page: number\n  /** Items per page */\n  perPage: number\n  /** Total number of pages */\n  totalPages: number\n}\n","/**\n * Thing Zod Schemas - Semantic Entity Management\n *\n * Things are the core entities in the .do platform, stored in the Things table\n * with ClickHouse's ReplacingMergeTree engine for immutable, versioned storage.\n *\n * All types are derived from Zod schemas to ensure a single source of truth.\n *\n * @remarks\n * Key patterns:\n * - Semantic IDs: `[namespace]/[Name]` (e.g., `schema.org/Person`)\n * - JSON-LD compatible data structure\n * - Full version history via Events table\n * - Soft deletes with deletedAt timestamp\n */\n\nimport { z } from 'zod'\nimport { DateSchema, OptionalDateSchema, SortDirectionSchema } from './common'\n\n// =============================================================================\n// ThingData Schema\n// =============================================================================\n\n/**\n * Schema for ThingData - JSON-LD compatible data structure for Things.\n */\nexport const ThingDataSchema = z\n  .object({\n    /** JSON-LD context */\n    '@context': z.union([z.string(), z.record(z.unknown())]).optional(),\n    /** JSON-LD type (should match Thing.type) */\n    '@type': z.string().optional(),\n    /** JSON-LD identifier */\n    '@id': z.string().optional(),\n  })\n  .passthrough()\n\n/**\n * JSON-LD compatible data structure for Things.\n */\nexport type ThingData = z.infer<typeof ThingDataSchema>\n\n// =============================================================================\n// Thing Schema\n// =============================================================================\n\n/**\n * Schema for Thing - base Thing record from database.\n */\nexport const ThingSchema = z.object({\n  /** Namespace (tenant/domain) */\n  ns: z.string(),\n  /** Entity type (e.g., 'Person', 'Organization', 'Agent') */\n  type: z.string(),\n  /** Unique identifier within namespace/type */\n  id: z.string(),\n  /** Version timestamp for deduplication */\n  ts: DateSchema,\n  /** Display name */\n  name: z.string(),\n  /** Creation timestamp */\n  createdAt: DateSchema,\n  /** Last update timestamp */\n  updatedAt: DateSchema,\n  /** Creator user ID */\n  createdBy: z.string().optional(),\n  /** Last updater user ID */\n  updatedBy: z.string().optional(),\n  /** Soft delete timestamp */\n  deletedAt: OptionalDateSchema,\n  /** A/B test variant */\n  variant: z.string().optional(),\n  /** JSON-LD data blob */\n  data: ThingDataSchema,\n})\n\n/**\n * Base Thing record from database.\n */\nexport type Thing = z.infer<typeof ThingSchema>\n\n// =============================================================================\n// ThingFilter Schema\n// =============================================================================\n\n/**\n * Schema for ThingFilter - query filters for Things.\n */\nexport const ThingFilterSchema = z\n  .object({\n    /** Filter by namespace - single string or array of strings */\n    ns: z.union([z.string(), z.array(z.string())]).optional(),\n    /** Filter by type - single string or array of strings */\n    type: z.union([z.string(), z.array(z.string())]).optional(),\n    /** Filter by ID pattern (supports wildcards) */\n    idPattern: z.string().optional(),\n    /** Filter by name (case-insensitive search) */\n    nameSearch: z.string().optional(),\n    /** Filter by creation date range - start */\n    createdAfter: z.coerce.date().optional(),\n    /** Filter by creation date range - end */\n    createdBefore: z.coerce.date().optional(),\n    /** Filter by update date range - start */\n    updatedAfter: z.coerce.date().optional(),\n    /** Filter by update date range - end */\n    updatedBefore: z.coerce.date().optional(),\n    /** Include soft-deleted things */\n    includeDeleted: z.boolean().optional(),\n    /** Filter by specific property values in data */\n    properties: z.record(z.unknown()).optional(),\n    /** Filter by variant */\n    variant: z.string().optional(),\n  })\n  .passthrough()\n\n/**\n * Query filters for Things.\n */\nexport type ThingFilter = z.infer<typeof ThingFilterSchema>\n\n// =============================================================================\n// ThingSort Schema\n// =============================================================================\n\n/**\n * Schema for ThingSort - sort options for Things.\n */\nexport const ThingSortSchema = z.object({\n  /** Field to sort by */\n  field: z.enum(['name', 'createdAt', 'updatedAt', 'ts', 'type']),\n  /** Sort direction */\n  order: SortDirectionSchema,\n})\n\n/**\n * Sort options for Things.\n */\nexport type ThingSort = z.infer<typeof ThingSortSchema>\n\n// =============================================================================\n// ThingPagination Schema\n// =============================================================================\n\n/**\n * Schema for ThingPagination - pagination for Things queries.\n */\nexport const ThingPaginationSchema = z.object({\n  /** Page number (1-indexed, must be positive) */\n  page: z.number().int().positive(),\n  /** Items per page (must be positive, max 1000) */\n  perPage: z.number().int().positive().max(1000),\n})\n\n/**\n * Pagination for Things queries.\n */\nexport type ThingPagination = z.infer<typeof ThingPaginationSchema>\n\n// =============================================================================\n// ThingQueryResult Schema\n// =============================================================================\n\n/**\n * Schema for ThingQueryResult - result of a Things query.\n */\nexport const ThingQueryResultSchema = z.object({\n  /** Matching things */\n  data: z.array(ThingSchema),\n  /** Total count (without pagination) */\n  total: z.number(),\n  /** Current page */\n  page: z.number(),\n  /** Items per page */\n  perPage: z.number(),\n  /** Total pages */\n  totalPages: z.number(),\n})\n\n/**\n * Result of a Things query.\n */\nexport type ThingQueryResult = z.infer<typeof ThingQueryResultSchema>\n\n// =============================================================================\n// ThingCreateInput Schema\n// =============================================================================\n\n/**\n * Schema for ThingCreateInput - thing creation payload.\n */\nexport const ThingCreateInputSchema = z.object({\n  /** Namespace (required, non-empty string) */\n  ns: z.string().min(1, 'Namespace is required'),\n  /** Type (required, non-empty string) */\n  type: z.string().min(1, 'Type is required'),\n  /** ID (optional, auto-generated if not provided) */\n  id: z.string().optional(),\n  /** Display name (required, non-empty string) */\n  name: z.string().min(1, 'Name is required'),\n  /** JSON-LD data */\n  data: ThingDataSchema,\n  /** Variant for A/B testing */\n  variant: z.string().optional(),\n})\n\n/**\n * Thing creation payload.\n */\nexport type ThingCreateInput = z.infer<typeof ThingCreateInputSchema>\n\n// =============================================================================\n// ThingUpdateInput Schema\n// =============================================================================\n\n/**\n * Schema for ThingUpdateInput - thing update payload.\n */\nexport const ThingUpdateInputSchema = z.object({\n  /** Updated name */\n  name: z.string().min(1, 'Name cannot be empty').optional(),\n  /** Updated data (merged with existing) */\n  data: ThingDataSchema.partial().optional(),\n  /** Updated variant */\n  variant: z.string().optional(),\n})\n\n/**\n * Thing update payload.\n */\nexport type ThingUpdateInput = z.infer<typeof ThingUpdateInputSchema>\n\n// =============================================================================\n// ThingDeleteOptions Schema\n// =============================================================================\n\n/**\n * Schema for ThingDeleteOptions - delete options.\n */\nexport const ThingDeleteOptionsSchema = z.object({\n  /** Hard delete (permanent) vs soft delete */\n  hard: z.boolean().optional(),\n})\n\n/**\n * Thing delete options.\n */\nexport type ThingDeleteOptions = z.infer<typeof ThingDeleteOptionsSchema>\n\n// =============================================================================\n// ThingVersion Schema\n// =============================================================================\n\n/**\n * Schema for ThingVersion - thing version from Events table.\n */\nexport const ThingVersionSchema = z.object({\n  /** Event ID */\n  eventId: z.string(),\n  /** Event type (create, update, delete) */\n  eventType: z.enum(['create', 'update', 'delete', 'create_version', 'update_version']),\n  /** Version timestamp */\n  ts: DateSchema,\n  /** User who made the change */\n  userId: z.string(),\n  /** Full data snapshot at this version */\n  data: ThingDataSchema,\n  /** Delta from previous version */\n  delta: ThingDataSchema.optional(),\n  /** Event metadata */\n  metadata: z.record(z.unknown()),\n})\n\n/**\n * Thing version from Events table.\n */\nexport type ThingVersion = z.infer<typeof ThingVersionSchema>\n\n// =============================================================================\n// SemanticProperty Schema\n// =============================================================================\n\n/**\n * Schema for SemanticProperty - property definition for semantic types.\n */\nexport const SemanticPropertySchema = z.object({\n  /** Property name */\n  name: z.string(),\n  /** Property label */\n  label: z.string(),\n  /** Property description */\n  description: z.string(),\n  /** Expected value types */\n  rangeIncludes: z.array(z.string()),\n  /** Types that use this property */\n  domainIncludes: z.array(z.string()),\n  /** Is this property required? */\n  required: z.boolean(),\n  /** Is this property an array? */\n  isArray: z.boolean(),\n  /** Default value */\n  defaultValue: z.unknown().optional(),\n})\n\n/**\n * Property definition for semantic types.\n */\nexport type SemanticProperty = z.infer<typeof SemanticPropertySchema>\n\n// =============================================================================\n// SemanticType Schema\n// =============================================================================\n\n/**\n * Schema for SemanticType - semantic type definition (like schema.org types).\n */\nexport const SemanticTypeSchema = z.object({\n  /** Type namespace (e.g., 'schema.org') */\n  namespace: z.string(),\n  /** Type name (e.g., 'Person') */\n  name: z.string(),\n  /** Full semantic ID */\n  id: z.string(),\n  /** Human-readable label */\n  label: z.string(),\n  /** Type description */\n  description: z.string().optional(),\n  /** Parent types (inheritance) */\n  parentTypes: z.array(z.string()),\n  /** Properties defined by this type */\n  properties: z.array(SemanticPropertySchema),\n  /** Child types */\n  subtypes: z.array(z.string()),\n  /** Example instances */\n  examples: z.array(ThingDataSchema).optional(),\n})\n\n/**\n * Semantic type definition (like schema.org types).\n */\nexport type SemanticType = z.infer<typeof SemanticTypeSchema>\n\n// =============================================================================\n// Namespace Schema\n// =============================================================================\n\n/**\n * Schema for Namespace - namespace definition (tenant/domain).\n */\nexport const NamespaceSchema = z.object({\n  /** Namespace identifier */\n  id: z.string(),\n  /** Namespace name */\n  name: z.string(),\n  /** Namespace description */\n  description: z.string().optional(),\n  /** Base URL for the namespace */\n  baseUrl: z.string().optional(),\n  /** Available types in this namespace */\n  types: z.array(z.string()),\n  /** Thing count in this namespace */\n  thingCount: z.number(),\n  /** Creation timestamp */\n  createdAt: DateSchema,\n})\n\n/**\n * Namespace definition (tenant/domain).\n */\nexport type Namespace = z.infer<typeof NamespaceSchema>\n\n// =============================================================================\n// TypeStats Schema\n// =============================================================================\n\n/**\n * Schema for TypeStats - statistics for a type.\n */\nexport const TypeStatsSchema = z.object({\n  /** Type name */\n  type: z.string(),\n  /** Namespace */\n  ns: z.string(),\n  /** Total count */\n  count: z.number(),\n  /** Active count (not deleted) */\n  activeCount: z.number(),\n  /** Created today */\n  createdToday: z.number(),\n  /** Updated today */\n  updatedToday: z.number(),\n  /** Most recent creation */\n  lastCreatedAt: DateSchema.optional(),\n  /** Most recent update */\n  lastUpdatedAt: DateSchema.optional(),\n})\n\n/**\n * Statistics for a type.\n */\nexport type TypeStats = z.infer<typeof TypeStatsSchema>\n"]}