@undefineds.co/xpod 0.2.0-preview.2 → 0.2.1

package/dist/vocab/udfs.js

@@ -35,12 +35,16 @@ exports.UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
     // --- 凭据 ---
     /** 凭据基类 */
     Credential: 'Credential',
+    /** API Key 凭据 */
+    ApiKeyCredential: 'ApiKeyCredential',
+    /** OAuth 凭据 */
+    OAuthCredential: 'OAuthCredential',
     // --- AI 供应商和模型 ---
     /** AI 供应商（Embedding 用） */
     Provider: 'Provider',
     /** AI 模型 */
     Model: 'Model',
-    /** Agent 供应商（指定 executorType） */
+    /** @deprecated 旧 AgentProvider 名义，当前统一收敛到 Provider */
     AgentProvider: 'AgentProvider',
     /** Agent 配置 */
     AgentConfig: 'AgentConfig',
@@ -94,6 +98,13 @@ exports.UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
     failCount: 'failCount',
     /** 限流重置时间 */
     rateLimitResetAt: 'rateLimitResetAt',
+    // --- OAuth 凭据属性 ---
+    /** OAuth Refresh Token */
+    oauthRefreshToken: 'oauthRefreshToken',
+    /** OAuth Access Token */
+    oauthAccessToken: 'oauthAccessToken',
+    /** OAuth Token 过期时间 */
+    oauthExpiresAt: 'oauthExpiresAt',
     /** 项目 ID (Vertex AI) */
     projectId: 'projectId',
     /** 组织 ID (OpenAI) */
@@ -117,8 +128,10 @@ exports.UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
     hasModel: 'hasModel',
     /** 默认模型 */
     defaultModel: 'defaultModel',
+    /** 运行时类型 (claude, codebuddy) */
+    runtimeKind: 'runtimeKind',
     // --- Agent 属性 ---
-    /** 执行器类型 (claude, openai, gemini, codebuddy) */
+    /** @deprecated 运行时应使用 runtimeKind */
     executorType: 'executorType',
     /** System Prompt */
     systemPrompt: 'systemPrompt',
@@ -156,6 +169,28 @@ exports.UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
     messageStatus: 'messageStatus',
     /** Thread 状态 (active/locked/closed) */
     threadStatus: 'threadStatus',
+    // --- 工具调用属性 ---
+    /** 工具名称 (bash, write, edit, etc.) */
+    toolName: 'toolName',
+    /** 工具调用 ID */
+    toolCallId: 'toolCallId',
+    /** 工具参数 (JSON) */
+    toolArguments: 'toolArguments',
+    /** 工具输出 */
+    toolOutput: 'toolOutput',
+    /** 工具状态 (pending/completed/failed) */
+    toolStatus: 'toolStatus',
+    // --- 权限审批属性 ---
+    /** 权限请求的工具 */
+    permissionTool: 'permissionTool',
+    /** 权限请求原因 */
+    permissionReason: 'permissionReason',
+    /** 权限状态 (pending/approved/rejected) */
+    permissionStatus: 'permissionStatus',
+    /** 审批人 */
+    approvedBy: 'approvedBy',
+    /** 审批时间 */
+    approvedAt: 'approvedAt',
     // --- 向量存储属性 ---
     /** 名称 */
     name: 'name',

package/dist/vocab/udfs.js.map

@@ -1 +1 @@
-{"version":3,"file":"udfs.js","sourceRoot":"","sources":["../../src/vocab/udfs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * UDFS Vocabulary - Undefineds.co 词汇表\n *\n * 命名空间: https://undefineds.co/ns#\n * 前缀: udfs\n *\n * 命名规范:\n * - Class: 大写开头 (Credential, Provider, Model)\n * - Property: 小写开头 (apiKey, baseUrl, status)\n */\n\n// ============================================\n// Namespace Builder\n// ============================================\n\ntype NamespaceObject<T extends Record<string, string>> = ((term: string) => string) & {\n  prefix: string;\n  uri: string;\n  /** @deprecated Use `uri` instead */\n  NAMESPACE: string;\n} & { [K in keyof T]: string };\n\nfunction createNamespace<T extends Record<string, string>>(\n  prefix: string,\n  baseUri: string,\n  terms: T,\n): NamespaceObject<T> {\n  const ABSOLUTE_IRI = /^[a-zA-Z][a-zA-Z\\d+.-]*:/;\n\n  const builder = ((term: string) =>\n    ABSOLUTE_IRI.test(term) ? term : `${baseUri}${term}`) as NamespaceObject<T>;\n\n  builder.prefix = prefix;\n  builder.uri = baseUri;\n  builder.NAMESPACE = baseUri;\n\n  for (const [key, local] of Object.entries(terms)) {\n    Object.defineProperty(builder, key, {\n      value: builder(local),\n      enumerable: true,\n    });\n  }\n\n  return builder;\n}\n\n// ============================================\n// UDFS Vocabulary\n// ============================================\n\nexport const UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {\n  // ========================================\n  // Classes (大写开头)\n  // ========================================\n\n  // --- 凭据 ---\n  /** 凭据基类 */\n  Credential: 'Credential',\n\n  // --- AI 供应商和模型 ---\n  /** AI 供应商（Embedding 用） */\n  Provider: 'Provider',\n  /** AI 模型 */\n  Model: 'Model',\n  /** Agent 供应商（指定 executorType） */\n  AgentProvider: 'AgentProvider',\n  /** Agent 配置 */\n  AgentConfig: 'AgentConfig',\n  /** Agent 运行状态 */\n  AgentStatus: 'AgentStatus',\n  /** Pod 级别 AI 配置（单例） */\n  AIConfig: 'AIConfig',\n\n  // --- 向量存储 ---\n  /** 向量知识库 */\n  VectorStore: 'VectorStore',\n  /** 已索引文件 */\n  IndexedFile: 'IndexedFile',\n\n  // --- 任务 ---\n  /** 异步任务 */\n  Task: 'Task',\n\n  // --- 索引 ---\n  /** 文本分块 */\n  TextChunk: 'TextChunk',\n\n  // ========================================\n  // Properties (小写开头)\n  // ========================================\n\n  // --- 通用属性 ---\n  /** 状态 */\n  status: 'status',\n  /** 标签/名称 */\n  label: 'label',\n  /** 是否启用 */\n  enabled: 'enabled',\n  /** 创建时间 */\n  createdAt: 'createdAt',\n  /** 更新时间 */\n  updatedAt: 'updatedAt',\n  /** 显示名称 */\n  displayName: 'displayName',\n  /** 描述 */\n  description: 'description',\n\n  // --- 凭据属性 ---\n  /** API 密钥 */\n  apiKey: 'apiKey',\n  /** API 基础 URL */\n  baseUrl: 'baseUrl',\n  /** 代理 URL */\n  proxyUrl: 'proxyUrl',\n  /** 服务类型 (ai, storage, dns) */\n  service: 'service',\n  /** 关联的供应商 */\n  provider: 'provider',\n  /** 最后使用时间 */\n  lastUsedAt: 'lastUsedAt',\n  /** 失败次数 */\n  failCount: 'failCount',\n  /** 限流重置时间 */\n  rateLimitResetAt: 'rateLimitResetAt',\n  /** 项目 ID (Vertex AI) */\n  projectId: 'projectId',\n  /** 组织 ID (OpenAI) */\n  organizationId: 'organizationId',\n\n  // --- AI 模型属性 ---\n  /** 模型类型 (embedding, chat, completion) */\n  modelType: 'modelType',\n  /** 向量维度 */\n  dimension: 'dimension',\n  /** 当前 embedding 模型 */\n  embeddingModel: 'embeddingModel',\n  /** 迁移前的模型 */\n  previousModel: 'previousModel',\n  /** 迁移状态 */\n  migrationStatus: 'migrationStatus',\n  /** 迁移进度 */\n  migrationProgress: 'migrationProgress',\n  /** 模型所属供应商 */\n  isProvidedBy: 'isProvidedBy',\n  /** 供应商拥有的模型 */\n  hasModel: 'hasModel',\n  /** 默认模型 */\n  defaultModel: 'defaultModel',\n\n  // --- Agent 属性 ---\n  /** 执行器类型 (claude, openai, gemini, codebuddy) */\n  executorType: 'executorType',\n  /** System Prompt */\n  systemPrompt: 'systemPrompt',\n  /** 最大轮数 */\n  maxTurns: 'maxTurns',\n  /** 超时时间 */\n  timeout: 'timeout',\n  /** Agent ID */\n  agentId: 'agentId',\n  /** 启动时间 */\n  startedAt: 'startedAt',\n  /** 完成时间 */\n  completedAt: 'completedAt',\n  /** 最后活动时间 */\n  lastActivityAt: 'lastActivityAt',\n  /** 当前任务 ID */\n  currentTaskId: 'currentTaskId',\n  /** 错误信息 */\n  errorMessage: 'errorMessage',\n\n  // --- 任务属性 ---\n  /** 目标 Agent */\n  agent: 'agent',\n  /** 任务消息 */\n  message: 'message',\n  /** 执行结果 */\n  result: 'result',\n  /** 错误 */\n  error: 'error',\n\n  // --- Chat/Thread 属性 (扩展 SolidOS chat) ---\n  /** 消息角色 (user/assistant/system) */\n  role: 'role',\n  /** 推理选项 (model, temperature, etc.) */\n  inferenceOptions: 'inferenceOptions',\n  /** 消息状态 (in_progress/completed/incomplete) */\n  messageStatus: 'messageStatus',\n  /** Thread 状态 (active/locked/closed) */\n  threadStatus: 'threadStatus',\n\n  // --- 向量存储属性 ---\n  /** 名称 */\n  name: 'name',\n  /** 关联的容器 */\n  container: 'container',\n  /** 分块策略 */\n  chunkingStrategy: 'chunkingStrategy',\n  /** 最后活跃时间 */\n  lastActiveAt: 'lastActiveAt',\n\n  // --- 索引文件属性 ---\n  /** 文件 URL */\n  fileUrl: 'fileUrl',\n  /** 向量 ID */\n  vectorId: 'vectorId',\n  /** 使用字节数 */\n  usageBytes: 'usageBytes',\n  /** 最后错误 */\n  lastError: 'lastError',\n  /** 索引时间 */\n  indexedAt: 'indexedAt',\n\n  // --- 索引层级属性 ---\n  /** 索引层级 (L0, L1, L2) */\n  indexLevel: 'indexLevel',\n  /** 最后索引时间 */\n  lastIndexedAt: 'lastIndexedAt',\n  /** 缓存的 Markdown */\n  cachedMarkdown: 'cachedMarkdown',\n  /** 文档的分块 */\n  hasChunk: 'hasChunk',\n  /** 父分块 */\n  parentChunk: 'parentChunk',\n  /** 分块层级 */\n  level: 'level',\n  /** 标题 */\n  heading: 'heading',\n  /** 起始偏移 */\n  startOffset: 'startOffset',\n  /** 结束偏移 */\n  endOffset: 'endOffset',\n\n  // --- 向量状态属性 (用于 .meta) ---\n  /** 向量状态 */\n  vectorStatus: 'vectorStatus',\n  /** 分块数量 */\n  chunkCount: 'chunkCount',\n  /** 内容哈希 */\n  contentHash: 'contentHash',\n  /** 已索引数量 */\n  indexedCount: 'indexedCount',\n  /** 失败数量 */\n  failedCount: 'failedCount',\n});\n\n/**\n * UDFS 命名空间配置（用于 drizzle-solid）\n */\nexport const UDFS_NAMESPACE = {\n  prefix: UDFS.prefix,\n  uri: UDFS.uri,\n};\n"]}
+{"version":3,"file":"udfs.js","sourceRoot":"","sources":["../../src/vocab/udfs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * UDFS Vocabulary - Undefineds.co 词汇表\n *\n * 命名空间: https://undefineds.co/ns#\n * 前缀: udfs\n *\n * 命名规范:\n * - Class: 大写开头 (Credential, Provider, Model)\n * - Property: 小写开头 (apiKey, baseUrl, status)\n */\n\n// ============================================\n// Namespace Builder\n// ============================================\n\ntype NamespaceObject<T extends Record<string, string>> = ((term: string) => string) & {\n  prefix: string;\n  uri: string;\n  /** @deprecated Use `uri` instead */\n  NAMESPACE: string;\n} & { [K in keyof T]: string };\n\nfunction createNamespace<T extends Record<string, string>>(\n  prefix: string,\n  baseUri: string,\n  terms: T,\n): NamespaceObject<T> {\n  const ABSOLUTE_IRI = /^[a-zA-Z][a-zA-Z\\d+.-]*:/;\n\n  const builder = ((term: string) =>\n    ABSOLUTE_IRI.test(term) ? term : `${baseUri}${term}`) as NamespaceObject<T>;\n\n  builder.prefix = prefix;\n  builder.uri = baseUri;\n  builder.NAMESPACE = baseUri;\n\n  for (const [key, local] of Object.entries(terms)) {\n    Object.defineProperty(builder, key, {\n      value: builder(local),\n      enumerable: true,\n    });\n  }\n\n  return builder;\n}\n\n// ============================================\n// UDFS Vocabulary\n// ============================================\n\nexport const UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {\n  // ========================================\n  // Classes (大写开头)\n  // ========================================\n\n  // --- 凭据 ---\n  /** 凭据基类 */\n  Credential: 'Credential',\n  /** API Key 凭据 */\n  ApiKeyCredential: 'ApiKeyCredential',\n  /** OAuth 凭据 */\n  OAuthCredential: 'OAuthCredential',\n\n  // --- AI 供应商和模型 ---\n  /** AI 供应商（Embedding 用） */\n  Provider: 'Provider',\n  /** AI 模型 */\n  Model: 'Model',\n  /** @deprecated 旧 AgentProvider 名义，当前统一收敛到 Provider */\n  AgentProvider: 'AgentProvider',\n  /** Agent 配置 */\n  AgentConfig: 'AgentConfig',\n  /** Agent 运行状态 */\n  AgentStatus: 'AgentStatus',\n  /** Pod 级别 AI 配置（单例） */\n  AIConfig: 'AIConfig',\n\n  // --- 向量存储 ---\n  /** 向量知识库 */\n  VectorStore: 'VectorStore',\n  /** 已索引文件 */\n  IndexedFile: 'IndexedFile',\n\n  // --- 任务 ---\n  /** 异步任务 */\n  Task: 'Task',\n\n  // --- 索引 ---\n  /** 文本分块 */\n  TextChunk: 'TextChunk',\n\n  // ========================================\n  // Properties (小写开头)\n  // ========================================\n\n  // --- 通用属性 ---\n  /** 状态 */\n  status: 'status',\n  /** 标签/名称 */\n  label: 'label',\n  /** 是否启用 */\n  enabled: 'enabled',\n  /** 创建时间 */\n  createdAt: 'createdAt',\n  /** 更新时间 */\n  updatedAt: 'updatedAt',\n  /** 显示名称 */\n  displayName: 'displayName',\n  /** 描述 */\n  description: 'description',\n\n  // --- 凭据属性 ---\n  /** API 密钥 */\n  apiKey: 'apiKey',\n  /** API 基础 URL */\n  baseUrl: 'baseUrl',\n  /** 代理 URL */\n  proxyUrl: 'proxyUrl',\n  /** 服务类型 (ai, storage, dns) */\n  service: 'service',\n  /** 关联的供应商 */\n  provider: 'provider',\n  /** 最后使用时间 */\n  lastUsedAt: 'lastUsedAt',\n  /** 失败次数 */\n  failCount: 'failCount',\n  /** 限流重置时间 */\n  rateLimitResetAt: 'rateLimitResetAt',\n\n  // --- OAuth 凭据属性 ---\n  /** OAuth Refresh Token */\n  oauthRefreshToken: 'oauthRefreshToken',\n  /** OAuth Access Token */\n  oauthAccessToken: 'oauthAccessToken',\n  /** OAuth Token 过期时间 */\n  oauthExpiresAt: 'oauthExpiresAt',\n  /** 项目 ID (Vertex AI) */\n  projectId: 'projectId',\n  /** 组织 ID (OpenAI) */\n  organizationId: 'organizationId',\n\n  // --- AI 模型属性 ---\n  /** 模型类型 (embedding, chat, completion) */\n  modelType: 'modelType',\n  /** 向量维度 */\n  dimension: 'dimension',\n  /** 当前 embedding 模型 */\n  embeddingModel: 'embeddingModel',\n  /** 迁移前的模型 */\n  previousModel: 'previousModel',\n  /** 迁移状态 */\n  migrationStatus: 'migrationStatus',\n  /** 迁移进度 */\n  migrationProgress: 'migrationProgress',\n  /** 模型所属供应商 */\n  isProvidedBy: 'isProvidedBy',\n  /** 供应商拥有的模型 */\n  hasModel: 'hasModel',\n  /** 默认模型 */\n  defaultModel: 'defaultModel',\n  /** 运行时类型 (claude, codebuddy) */\n  runtimeKind: 'runtimeKind',\n\n  // --- Agent 属性 ---\n  /** @deprecated 运行时应使用 runtimeKind */\n  executorType: 'executorType',\n  /** System Prompt */\n  systemPrompt: 'systemPrompt',\n  /** 最大轮数 */\n  maxTurns: 'maxTurns',\n  /** 超时时间 */\n  timeout: 'timeout',\n  /** Agent ID */\n  agentId: 'agentId',\n  /** 启动时间 */\n  startedAt: 'startedAt',\n  /** 完成时间 */\n  completedAt: 'completedAt',\n  /** 最后活动时间 */\n  lastActivityAt: 'lastActivityAt',\n  /** 当前任务 ID */\n  currentTaskId: 'currentTaskId',\n  /** 错误信息 */\n  errorMessage: 'errorMessage',\n\n  // --- 任务属性 ---\n  /** 目标 Agent */\n  agent: 'agent',\n  /** 任务消息 */\n  message: 'message',\n  /** 执行结果 */\n  result: 'result',\n  /** 错误 */\n  error: 'error',\n\n  // --- Chat/Thread 属性 (扩展 SolidOS chat) ---\n  /** 消息角色 (user/assistant/system) */\n  role: 'role',\n  /** 推理选项 (model, temperature, etc.) */\n  inferenceOptions: 'inferenceOptions',\n  /** 消息状态 (in_progress/completed/incomplete) */\n  messageStatus: 'messageStatus',\n  /** Thread 状态 (active/locked/closed) */\n  threadStatus: 'threadStatus',\n\n  // --- 工具调用属性 ---\n  /** 工具名称 (bash, write, edit, etc.) */\n  toolName: 'toolName',\n  /** 工具调用 ID */\n  toolCallId: 'toolCallId',\n  /** 工具参数 (JSON) */\n  toolArguments: 'toolArguments',\n  /** 工具输出 */\n  toolOutput: 'toolOutput',\n  /** 工具状态 (pending/completed/failed) */\n  toolStatus: 'toolStatus',\n\n  // --- 权限审批属性 ---\n  /** 权限请求的工具 */\n  permissionTool: 'permissionTool',\n  /** 权限请求原因 */\n  permissionReason: 'permissionReason',\n  /** 权限状态 (pending/approved/rejected) */\n  permissionStatus: 'permissionStatus',\n  /** 审批人 */\n  approvedBy: 'approvedBy',\n  /** 审批时间 */\n  approvedAt: 'approvedAt',\n\n  // --- 向量存储属性 ---\n  /** 名称 */\n  name: 'name',\n  /** 关联的容器 */\n  container: 'container',\n  /** 分块策略 */\n  chunkingStrategy: 'chunkingStrategy',\n  /** 最后活跃时间 */\n  lastActiveAt: 'lastActiveAt',\n\n  // --- 索引文件属性 ---\n  /** 文件 URL */\n  fileUrl: 'fileUrl',\n  /** 向量 ID */\n  vectorId: 'vectorId',\n  /** 使用字节数 */\n  usageBytes: 'usageBytes',\n  /** 最后错误 */\n  lastError: 'lastError',\n  /** 索引时间 */\n  indexedAt: 'indexedAt',\n\n  // --- 索引层级属性 ---\n  /** 索引层级 (L0, L1, L2) */\n  indexLevel: 'indexLevel',\n  /** 最后索引时间 */\n  lastIndexedAt: 'lastIndexedAt',\n  /** 缓存的 Markdown */\n  cachedMarkdown: 'cachedMarkdown',\n  /** 文档的分块 */\n  hasChunk: 'hasChunk',\n  /** 父分块 */\n  parentChunk: 'parentChunk',\n  /** 分块层级 */\n  level: 'level',\n  /** 标题 */\n  heading: 'heading',\n  /** 起始偏移 */\n  startOffset: 'startOffset',\n  /** 结束偏移 */\n  endOffset: 'endOffset',\n\n  // --- 向量状态属性 (用于 .meta) ---\n  /** 向量状态 */\n  vectorStatus: 'vectorStatus',\n  /** 分块数量 */\n  chunkCount: 'chunkCount',\n  /** 内容哈希 */\n  contentHash: 'contentHash',\n  /** 已索引数量 */\n  indexedCount: 'indexedCount',\n  /** 失败数量 */\n  failedCount: 'failedCount',\n});\n\n/**\n * UDFS 命名空间配置（用于 drizzle-solid）\n */\nexport const UDFS_NAMESPACE = {\n  prefix: UDFS.prefix,\n  uri: UDFS.uri,\n};\n"]}

package/node_modules/@undefineds.co/drizzle-solid/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 undefinedsco
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/@undefineds.co/drizzle-solid/README.md

@@ -0,0 +1,254 @@
+# drizzle-solid
+
+Chinese version: [`README.zh-CN.md`](README.zh-CN.md)
+
+`drizzle-solid` stores application-owned data in Solid Pods with typed schemas and a Drizzle-aligned developer experience.
+
+Use it when you want:
+
+- TypeScript schemas for Pod data
+- explicit Pod layout through `base` and `subjectTemplate`
+- a choice between a Solid-first API (`pod()`) and a Drizzle-shaped API (`drizzle()`)
+- exact entity reads and writes by IRI or locator
+- SPARQL-backed reads when your backend exposes query capability
+
+## What it is good at
+
+- application-owned data in your Pod or a user Pod
+- typed CRUD over known resource layouts
+- gradual migration from `drizzle-orm`
+- Pod-native concepts such as IRIs, documents, links, discovery, notifications, and federation
+
+## What it is not trying to be
+
+- a general-purpose RDF exploration toolkit
+- full SQL/database parity across every Solid backend
+- a library that hides Pod boundaries, permissions, or network costs
+- a raw SQL-first abstraction
+
+## Install
+
+```bash
+yarn add @undefineds.co/drizzle-solid drizzle-orm
+# optional: install when your app wants the built-in SPARQL engine
+yarn add @comunica/query-sparql-solid
+```
+
+```bash
+npm install @undefineds.co/drizzle-solid drizzle-orm
+# optional: install when your app wants the built-in SPARQL engine
+npm install @comunica/query-sparql-solid
+```
+
+`@comunica/query-sparql-solid` is an optional peer dependency.
+
+Current support stance:
+
+- supported: `@comunica/query-sparql-solid` `4.x`
+- not in the current supported matrix: `3.x`
+
+If another in-process runtime already ships Comunica, inject that engine instead of installing a second copy.
+
+## Choose your API style
+
+### `pod(session)`
+
+Use this for new code when you want Solid concepts to be explicit in the API:
+
+- `collection(table)`
+- `entity(table, iri)`
+- `bind(schema, options)`
+- `sparql(query)`
+
+### `drizzle(session)`
+
+Use this when you are migrating from `drizzle-orm` or want to keep builder-shaped code:
+
+- `select / insert / update / delete`
+- `db.query.<table>`
+- `findByLocator / findByIri`
+- `updateByLocator / updateByIri`
+- `deleteByLocator / deleteByIri`
+
+Both styles use the same runtime. The difference is API shape, not storage behavior.
+
+## Quick start
+
+```ts
+import { pod, podTable, string, datetime } from '@undefineds.co/drizzle-solid';
+
+const posts = podTable('posts', {
+  id: string('id').primaryKey(),
+  title: string('title').predicate('http://schema.org/headline'),
+  content: string('content').predicate('http://schema.org/text'),
+  createdAt: datetime('createdAt').predicate('http://schema.org/dateCreated'),
+}, {
+  base: 'https://alice.example/data/posts/',
+  subjectTemplate: '{id}.ttl',
+  type: 'http://schema.org/CreativeWork',
+});
+
+const client = pod(session);
+await client.init(posts);
+
+const created = await client.collection(posts).create({
+  id: 'post-1',
+  title: 'Hello Solid',
+  content: 'Stored as RDF in a Pod document.',
+  createdAt: new Date(),
+});
+
+if (!created) {
+  throw new Error('Create failed');
+}
+
+const post = client.entity(posts, created['@id']);
+
+console.log(await post.get());
+await post.update({ title: 'Updated title' });
+await post.delete();
+```
+
+## Drizzle-style exact operations
+
+```ts
+import { drizzle, podTable, string } from '@undefineds.co/drizzle-solid';
+
+const posts = podTable('posts', {
+  id: string('id').primaryKey(),
+  title: string('title').predicate('http://schema.org/headline'),
+}, {
+  base: 'https://alice.example/data/posts/',
+  subjectTemplate: '{id}.ttl',
+  type: 'http://schema.org/CreativeWork',
+});
+
+const db = drizzle(session);
+await db.init(posts);
+
+await db.insert(posts).values({
+  id: 'post-1',
+  title: 'Hello Solid',
+});
+
+const row = await db.findByLocator(posts, { id: 'post-1' });
+
+await db.updateByLocator(posts, { id: 'post-1' }, {
+  title: 'Updated title',
+});
+
+await db.deleteByLocator(posts, { id: 'post-1' });
+```
+
+## How Pod layout works
+
+Every model describes both shape and placement.
+
+- `base` defines where documents live
+- `subjectTemplate` defines how business fields map to an IRI
+- `type` is the primary persisted `rdf:type`
+
+Common `subjectTemplate` patterns:
+
+- `#{id}` — many entities in one document
+- `{id}.ttl` — one document per entity
+- `{id}.ttl#it` — one document per entity with a stable fragment
+- `{chatId}/messages.ttl#{id}` — partitioned layout with multiple locator variables
+
+If your template uses multiple variables, exact lookup requires either:
+
+- the full IRI, or
+- a complete locator with every required variable
+
+## Collection reads vs exact entity operations
+
+This is the most important runtime rule.
+
+### Collection reads
+
+Use collection reads when you want a list or filtered subset:
+
+- `client.collection(table).list(...)`
+- `db.select().from(table)...`
+- `db.query.<table>.findMany(...)`
+
+### Exact entity operations
+
+Use exact-target helpers when you mean one concrete entity:
+
+- `client.entity(table, iri)`
+- `db.findByIri(table, iri)`
+- `db.findByLocator(table, locator)`
+- `db.updateByIri(...)`
+- `db.updateByLocator(...)`
+- `db.deleteByIri(...)`
+- `db.deleteByLocator(...)`
+
+Do not rely on `where({ id: ... })` or `where(eq(table.id, ...))` as an exact-target shortcut.
+
+## SPARQL support and backend behavior
+
+`drizzle-solid` works across different Solid runtimes, but capabilities differ.
+
+| Capability | Community Solid Server | xpod |
+| --- | --- | --- |
+| Basic CRUD | ✅ | ✅ |
+| Document notifications | ✅ | ✅ |
+| Drizzle-style read facade | ✅ | ✅ |
+| SPARQL pushdown | ⚠️ Limited / often client-assisted | ✅ Better in-process support |
+| Filter / aggregation pushdown | ❌ Mostly client-side execution | ✅ Better server-side support |
+| Federated queries | ⚠️ Client-side federation | ⚠️ Client-side federation |
+| In-process local runtime | ⚠️ External setup | ✅ via `@undefineds.co/xpod` |
+
+Practical rule:
+
+- if you have a SPARQL endpoint or sidecar, use it for collection queries
+- if you only have plain LDP document access, exact-target reads and writes still work
+- plain-LDP document mode does not silently widen exact operations into scans
+
+## Examples
+
+The canonical examples in `examples/` are part of the integration verification flow:
+
+- `examples/01-quick-start.ts`
+- `examples/02-relational-query.ts`
+- `examples/03-zero-config-discovery.ts`
+- `examples/04-notifications.ts`
+- `examples/05-data-discovery.ts`
+- `examples/06-federated-query.ts`
+- `examples/07-hooks-and-profile.ts`
+- `examples/08-iri-based-operations.ts`
+- `examples/08-schema-inheritance.ts`
+- `examples/09-multi-variable-templates.ts`
+
+## Documentation
+
+Start here:
+
+- `docs/guides/installation.md`
+- `docs/api/README.md`
+- `docs/guides/migrating-from-drizzle-orm.md`
+- `docs/guides/multi-variable-templates.md`
+- `docs/guides/notifications.md`
+- `docs/guides/data-discovery.md`
+
+## Contributing
+
+Before pushing:
+
+```bash
+yarn quality
+SOLID_ENABLE_REAL_TESTS=true SOLID_SERIAL_TESTS=true yarn vitest --run tests/integration/css
+```
+
+Examples must remain runnable and verified.
+
+## License
+
+MIT
+
+## Related links
+
+- GitHub: https://github.com/undefinedsco/drizzle-solid
+- npm: https://www.npmjs.com/package/@undefineds.co/drizzle-solid
+- xpod: https://github.com/undefinedsco/xpod

package/node_modules/@undefineds.co/drizzle-solid/README.zh-CN.md

@@ -0,0 +1,254 @@
+# drizzle-solid
+
+English version: [`README.md`](README.md)
+
+`drizzle-solid` 用类型化 schema 和 Drizzle 对齐的开发体验，把应用自有数据存进 Solid Pod。
+
+适合在你需要下面这些能力时使用：
+
+- 用 TypeScript schema 描述 Pod 数据
+- 用 `base` 和 `subjectTemplate` 明确声明数据布局
+- 在 `pod()` 和 `drizzle()` 两种 API 风格之间选择
+- 通过 IRI 或 locator 精确读写单个实体
+- 在后端提供查询能力时走 SPARQL 读取
+
+## 它擅长什么
+
+- 应用自有数据存储在你的 Pod 或用户 Pod 中
+- 对已知资源布局做类型化 CRUD
+- 从 `drizzle-orm` 逐步迁移，而不假装 Pod 就是 SQL 表
+- 使用 IRI、文档、链接、发现、通知、联邦等 Pod 原生概念
+
+## 它不打算做什么
+
+- 通用 RDF 图探索工具
+- 所有 Solid 后端上的完整 SQL / 数据库能力对齐
+- 隐藏 Pod 边界、权限或网络成本
+- raw SQL 优先的抽象层
+
+## 安装
+
+```bash
+yarn add @undefineds.co/drizzle-solid drizzle-orm
+# 可选：当你的应用需要内置 SPARQL 引擎时再安装
+yarn add @comunica/query-sparql-solid
+```
+
+```bash
+npm install @undefineds.co/drizzle-solid drizzle-orm
+# 可选：当你的应用需要内置 SPARQL 引擎时再安装
+npm install @comunica/query-sparql-solid
+```
+
+`@comunica/query-sparql-solid` 是可选 peer dependency。
+
+当前支持范围：
+
+- 支持：`@comunica/query-sparql-solid` `4.x`
+- 当前不在支持矩阵中：`3.x`
+
+如果宿主运行时已经自带 Comunica，就注入那一份，不要再装第二份。
+
+## 选择 API 风格
+
+### `pod(session)`
+
+适合新代码，或者你希望 API 直接体现 Solid 语义：
+
+- `collection(table)`
+- `entity(table, iri)`
+- `bind(schema, options)`
+- `sparql(query)`
+
+### `drizzle(session)`
+
+适合从 `drizzle-orm` 迁移，或者你想保留 builder 形状：
+
+- `select / insert / update / delete`
+- `db.query.<table>`
+- `findByLocator / findByIri`
+- `updateByLocator / updateByIri`
+- `deleteByLocator / deleteByIri`
+
+两者底层是同一个运行时。区别是 API 组织方式，不是存储行为。
+
+## 快速开始
+
+```ts
+import { pod, podTable, string, datetime } from '@undefineds.co/drizzle-solid';
+
+const posts = podTable('posts', {
+  id: string('id').primaryKey(),
+  title: string('title').predicate('http://schema.org/headline'),
+  content: string('content').predicate('http://schema.org/text'),
+  createdAt: datetime('createdAt').predicate('http://schema.org/dateCreated'),
+}, {
+  base: 'https://alice.example/data/posts/',
+  subjectTemplate: '{id}.ttl',
+  type: 'http://schema.org/CreativeWork',
+});
+
+const client = pod(session);
+await client.init(posts);
+
+const created = await client.collection(posts).create({
+  id: 'post-1',
+  title: 'Hello Solid',
+  content: 'Stored as RDF in a Pod document.',
+  createdAt: new Date(),
+});
+
+if (!created) {
+  throw new Error('Create failed');
+}
+
+const post = client.entity(posts, created['@id']);
+
+console.log(await post.get());
+await post.update({ title: 'Updated title' });
+await post.delete();
+```
+
+## Drizzle 风格的精确操作
+
+```ts
+import { drizzle, podTable, string } from '@undefineds.co/drizzle-solid';
+
+const posts = podTable('posts', {
+  id: string('id').primaryKey(),
+  title: string('title').predicate('http://schema.org/headline'),
+}, {
+  base: 'https://alice.example/data/posts/',
+  subjectTemplate: '{id}.ttl',
+  type: 'http://schema.org/CreativeWork',
+});
+
+const db = drizzle(session);
+await db.init(posts);
+
+await db.insert(posts).values({
+  id: 'post-1',
+  title: 'Hello Solid',
+});
+
+const row = await db.findByLocator(posts, { id: 'post-1' });
+
+await db.updateByLocator(posts, { id: 'post-1' }, {
+  title: 'Updated title',
+});
+
+await db.deleteByLocator(posts, { id: 'post-1' });
+```
+
+## Pod 布局怎么理解
+
+每个模型不仅描述字段，也描述落点。
+
+- `base` 决定文档位置
+- `subjectTemplate` 决定业务字段如何映射成 IRI
+- `type` 是主持久化 `rdf:type`
+
+常见 `subjectTemplate`：
+
+- `#{id}`：一个文档里多个实体
+- `{id}.ttl`：一个实体一个文档
+- `{id}.ttl#it`：一个实体一个文档，并带稳定 fragment
+- `{chatId}/messages.ttl#{id}`：多变量分区布局
+
+如果模板用了多个变量，精确定位就必须提供：
+
+- 完整 IRI，或
+- 完整 locator
+
+## 集合读取 vs 精确实体操作
+
+这是最重要的一条运行时规则。
+
+### 集合读取
+
+当你要拿一批数据时，用：
+
+- `client.collection(table).list(...)`
+- `db.select().from(table)...`
+- `db.query.<table>.findMany(...)`
+
+### 精确实体操作
+
+当你要操作一个明确实体时，用：
+
+- `client.entity(table, iri)`
+- `db.findByIri(table, iri)`
+- `db.findByLocator(table, locator)`
+- `db.updateByIri(...)`
+- `db.updateByLocator(...)`
+- `db.deleteByIri(...)`
+- `db.deleteByLocator(...)`
+
+不要再把 `where({ id: ... })` 或 `where(eq(table.id, ...))` 当成精确单体捷径。
+
+## SPARQL 支持与后端差异
+
+`drizzle-solid` 可以跑在不同 Solid 运行时上，但能力有差异。
+
+| 能力 | Community Solid Server | xpod |
+| --- | --- | --- |
+| 基础 CRUD | ✅ | ✅ |
+| 文档通知 | ✅ | ✅ |
+| Drizzle 风格读 facade | ✅ | ✅ |
+| SPARQL 下推 | ⚠️ 有限 / 经常依赖客户端辅助 | ✅ 更好的进程内支持 |
+| 过滤 / 聚合下推 | ❌ 多数走客户端执行 | ✅ 更好的服务端支持 |
+| 联邦查询 | ⚠️ 客户端联邦 | ⚠️ 客户端联邦 |
+| 进程内本地运行时 | ⚠️ 需要额外启动 | ✅ 通过 `@undefineds.co/xpod` |
+
+实用规则：
+
+- 有 SPARQL endpoint 或 sidecar 时，集合查询优先走它
+- 只有 plain LDP document access 时，精确读写仍然可用
+- plain-LDP document mode 不会把精确操作静默扩成扫描
+
+## 示例
+
+仓库里的标准示例会进入集成验证：
+
+- `examples/01-quick-start.ts`
+- `examples/02-relational-query.ts`
+- `examples/03-zero-config-discovery.ts`
+- `examples/04-notifications.ts`
+- `examples/05-data-discovery.ts`
+- `examples/06-federated-query.ts`
+- `examples/07-hooks-and-profile.ts`
+- `examples/08-iri-based-operations.ts`
+- `examples/08-schema-inheritance.ts`
+- `examples/09-multi-variable-templates.ts`
+
+## 文档入口
+
+建议从这里开始：
+
+- `docs/guides/installation.zh-CN.md`
+- `docs/api/README.zh-CN.md`
+- `docs/guides/migrating-from-drizzle-orm.zh-CN.md`
+- `docs/guides/multi-variable-templates.zh-CN.md`
+- `docs/guides/notifications.md`
+- `docs/guides/data-discovery.md`
+
+## 贡献
+
+推送前运行：
+
+```bash
+yarn quality
+SOLID_ENABLE_REAL_TESTS=true SOLID_SERIAL_TESTS=true yarn vitest --run tests/integration/css
+```
+
+示例必须保持可运行且已验证。
+
+## License
+
+MIT
+
+## 相关链接
+
+- GitHub: https://github.com/undefinedsco/drizzle-solid
+- npm: https://www.npmjs.com/package/@undefineds.co/drizzle-solid
+- xpod: https://github.com/undefinedsco/xpod

package/node_modules/@undefineds.co/drizzle-solid/dist/core/aggregates.d.ts

@@ -0,0 +1,19 @@
+import { PodColumnBase } from './schema';
+export type AggregateFunction = 'count' | 'sum' | 'avg' | 'min' | 'max';
+export interface AggregateExpression {
+    kind: 'aggregate';
+    func: AggregateFunction;
+    column?: PodColumnBase | string;
+    distinct?: boolean;
+}
+interface AggregateOptions {
+    distinct?: boolean;
+}
+export declare function count(column?: PodColumnBase | string, options?: AggregateOptions): AggregateExpression;
+export declare function sum(column: PodColumnBase | string, options?: AggregateOptions): AggregateExpression;
+export declare function avg(column: PodColumnBase | string, options?: AggregateOptions): AggregateExpression;
+export declare function min(column: PodColumnBase | string, options?: AggregateOptions): AggregateExpression;
+export declare function max(column: PodColumnBase | string, options?: AggregateOptions): AggregateExpression;
+export declare function isAggregateExpression(value: unknown): value is AggregateExpression;
+export {};
+//# sourceMappingURL=aggregates.d.ts.map

package/node_modules/@undefineds.co/drizzle-solid/dist/core/aggregates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregates.d.ts","sourceRoot":"","sources":["../../src/core/aggregates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA8BD,wBAAgB,KAAK,CACnB,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACzB,mBAAmB,CAErB;AAED,wBAAgB,GAAG,CACjB,MAAM,EAAE,aAAa,GAAG,MAAM,EAC9B,OAAO,CAAC,EAAE,gBAAgB,GACzB,mBAAmB,CAGrB;AAED,wBAAgB,GAAG,CACjB,MAAM,EAAE,aAAa,GAAG,MAAM,EAC9B,OAAO,CAAC,EAAE,gBAAgB,GACzB,mBAAmB,CAGrB;AAED,wBAAgB,GAAG,CACjB,MAAM,EAAE,aAAa,GAAG,MAAM,EAC9B,OAAO,CAAC,EAAE,gBAAgB,GACzB,mBAAmB,CAGrB;AAED,wBAAgB,GAAG,CACjB,MAAM,EAAE,aAAa,GAAG,MAAM,EAC9B,OAAO,CAAC,EAAE,gBAAgB,GACzB,mBAAmB,CAGrB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF"}