@undefineds.co/xpod 0.2.45 → 0.3.0

package/dist/vocab/index.d.ts

@@ -14,12 +14,8 @@
  * // 动态构建 URI
  * const custom = UDFS('CustomTerm');  // 'https://undefineds.co/ns#CustomTerm'
  *
- * // 用于 drizzle-solid
- * import { UDFS_NAMESPACE } from '@/vocab';
- * const table = podTable('Credential', {...}, {
- *   type: UDFS.Credential,
- *   namespace: UDFS_NAMESPACE,
- * });
+ * // 用于本地 adapter schema
+ * const predicate = UDFS('systemPrompt');
  * ```
  */
 export { UDFS, UDFS_NAMESPACE } from './udfs';

package/dist/vocab/index.js

@@ -15,12 +15,8 @@
  * // 动态构建 URI
  * const custom = UDFS('CustomTerm');  // 'https://undefineds.co/ns#CustomTerm'
  *
- * // 用于 drizzle-solid
- * import { UDFS_NAMESPACE } from '@/vocab';
- * const table = podTable('Credential', {...}, {
- *   type: UDFS.Credential,
- *   namespace: UDFS_NAMESPACE,
- * });
+ * // 用于本地 adapter schema
+ * const predicate = UDFS('systemPrompt');
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/vocab/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vocab/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;AAEH,WAAW;AACX,+BAA8C;AAArC,4FAAA,IAAI,OAAA;AAAE,sGAAA,cAAc,OAAA;AAE7B,UAAU;AACV,uCAAuG;AAA9F,mGAAA,OAAO,OAAA;AAAE,+FAAA,GAAG,OAAA;AAAE,kGAAA,MAAM,OAAA;AAAE,+FAAA,GAAG,OAAA;AAAE,gGAAA,IAAI,OAAA;AAAE,+FAAA,GAAG,OAAA;AAAE,gGAAA,IAAI,OAAA;AAAE,+FAAA,GAAG,OAAA;AAAE,iGAAA,KAAK,OAAA;AAAE,gGAAA,IAAI,OAAA;AAAE,mGAAA,OAAO,OAAA;AAAE,8FAAA,EAAE,OAAA","sourcesContent":["/**\n * Vocabulary 统一导出\n *\n * 使用方式:\n * ```typescript\n * import { UDFS, DCTerms, LDP } from '@/vocab';\n *\n * // 使用 Class\n * const type = UDFS.Credential;  // 'https://undefineds.co/ns#Credential'\n *\n * // 使用 Property\n * const prop = UDFS.apiKey;  // 'https://undefineds.co/ns#apiKey'\n *\n * // 动态构建 URI\n * const custom = UDFS('CustomTerm');  // 'https://undefineds.co/ns#CustomTerm'\n *\n * // 用于 drizzle-solid\n * import { UDFS_NAMESPACE } from '@/vocab';\n * const table = podTable('Credential', {...}, {\n *   type: UDFS.Credential,\n *   namespace: UDFS_NAMESPACE,\n * });\n * ```\n */\n\n// UDFS 词汇表\nexport { UDFS, UDFS_NAMESPACE } from './udfs';\n\n// 外部标准词汇表\nexport { DCTerms, LDP, Schema, RDF, RDFS, XSD, FOAF, ACL, Solid, SIOC, Meeting, WF } from './external';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vocab/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,WAAW;AACX,+BAA8C;AAArC,4FAAA,IAAI,OAAA;AAAE,sGAAA,cAAc,OAAA;AAE7B,UAAU;AACV,uCAAuG;AAA9F,mGAAA,OAAO,OAAA;AAAE,+FAAA,GAAG,OAAA;AAAE,kGAAA,MAAM,OAAA;AAAE,+FAAA,GAAG,OAAA;AAAE,gGAAA,IAAI,OAAA;AAAE,+FAAA,GAAG,OAAA;AAAE,gGAAA,IAAI,OAAA;AAAE,+FAAA,GAAG,OAAA;AAAE,iGAAA,KAAK,OAAA;AAAE,gGAAA,IAAI,OAAA;AAAE,mGAAA,OAAO,OAAA;AAAE,8FAAA,EAAE,OAAA","sourcesContent":["/**\n * Vocabulary 统一导出\n *\n * 使用方式:\n * ```typescript\n * import { UDFS, DCTerms, LDP } from '@/vocab';\n *\n * // 使用 Class\n * const type = UDFS.Credential;  // 'https://undefineds.co/ns#Credential'\n *\n * // 使用 Property\n * const prop = UDFS.apiKey;  // 'https://undefineds.co/ns#apiKey'\n *\n * // 动态构建 URI\n * const custom = UDFS('CustomTerm');  // 'https://undefineds.co/ns#CustomTerm'\n *\n * // 用于本地 adapter schema\n * const predicate = UDFS('systemPrompt');\n * ```\n */\n\n// UDFS 词汇表\nexport { UDFS, UDFS_NAMESPACE } from './udfs';\n\n// 外部标准词汇表\nexport { DCTerms, LDP, Schema, RDF, RDFS, XSD, FOAF, ACL, Solid, SIOC, Meeting, WF } from './external';\n"]}

package/dist/vocab/udfs.d.ts

@@ -107,6 +107,18 @@ export declare const UDFS: NamespaceObject<{
     executorType: string;
     /** System Prompt */
     systemPrompt: string;
+    /** ACP 权限模式 */
+    permissionMode: string;
+    /** 允许工具 */
+    allowedTool: string;
+    /** 禁用工具 */
+    disallowedTool: string;
+    /** Agent skill package */
+    skill: string;
+    /** @deprecated Codex rules are stored under .codex/rules, not Agent Profile refs */
+    rule: string;
+    /** Agent MCP server config definition */
+    mcpServer: string;
     /** 最大轮数 */
     maxTurns: string;
     /** 超时时间 */

package/dist/vocab/udfs.js

@@ -135,6 +135,18 @@ exports.UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
     executorType: 'executorType',
     /** System Prompt */
     systemPrompt: 'systemPrompt',
+    /** ACP 权限模式 */
+    permissionMode: 'permissionMode',
+    /** 允许工具 */
+    allowedTool: 'allowedTool',
+    /** 禁用工具 */
+    disallowedTool: 'disallowedTool',
+    /** Agent skill package */
+    skill: 'skill',
+    /** @deprecated Codex rules are stored under .codex/rules, not Agent Profile refs */
+    rule: 'rule',
+    /** Agent MCP server config definition */
+    mcpServer: 'mcpServer',
     /** 最大轮数 */
     maxTurns: 'maxTurns',
     /** 超时时间 */

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  /** 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"]}
+{"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  /** ACP 权限模式 */\n  permissionMode: 'permissionMode',\n  /** 允许工具 */\n  allowedTool: 'allowedTool',\n  /** 禁用工具 */\n  disallowedTool: 'disallowedTool',\n  /** Agent skill package */\n  skill: 'skill',\n  /** @deprecated Codex rules are stored under .codex/rules, not Agent Profile refs */\n  rule: 'rule',\n  /** Agent MCP server config definition */\n  mcpServer: 'mcpServer',\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/README.md

@@ -7,9 +7,9 @@ Chinese version: [`README.zh-CN.md`](README.zh-CN.md)
 Use it when you want:
 
 - TypeScript schemas for Pod data
-- explicit Pod layout through `base` and `subjectTemplate`
+- explicit Pod layout through `base` and base-relative resource ids
 - a choice between a Solid-first API (`pod()`) and a Drizzle-shaped API (`drizzle()`)
-- exact entity reads and writes by IRI or locator
+- exact resource reads and writes by base-relative id or IRI
 - SPARQL-backed reads when your backend exposes query capability
 
 ## What it is good at
@@ -56,7 +56,7 @@ If another in-process runtime already ships Comunica, inject that engine instead
 Use this for new code when you want Solid concepts to be explicit in the API:
 
 - `collection(table)`
-- `entity(table, iri)`
+- `entity(resource, iri)`
 - `bind(schema, options)`
 - `sparql(query)`
 
@@ -65,10 +65,10 @@ Use this for new code when you want Solid concepts to be explicit in the API:
 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`
+- `db.query.<resource>`
+- `findById / findByIri`
+- `updateById / updateByIri`
+- `deleteById / deleteByIri`
 
 Both styles use the same runtime. The difference is API shape, not storage behavior.
 
@@ -84,7 +84,6 @@ const posts = podTable('posts', {
   createdAt: datetime('createdAt').predicate('http://schema.org/dateCreated'),
 }, {
   base: 'https://alice.example/data/posts/',
-  subjectTemplate: '{id}.ttl',
   type: 'http://schema.org/CreativeWork',
 });
 
@@ -92,7 +91,7 @@ const client = pod(session);
 await client.init(posts);
 
 const created = await client.collection(posts).create({
-  id: 'post-1',
+  id: 'post-1.ttl',
   title: 'Hello Solid',
   content: 'Stored as RDF in a Pod document.',
   createdAt: new Date(),
@@ -119,7 +118,6 @@ const posts = podTable('posts', {
   title: string('title').predicate('http://schema.org/headline'),
 }, {
   base: 'https://alice.example/data/posts/',
-  subjectTemplate: '{id}.ttl',
   type: 'http://schema.org/CreativeWork',
 });
 
@@ -127,17 +125,17 @@ const db = drizzle(session);
 await db.init(posts);
 
 await db.insert(posts).values({
-  id: 'post-1',
+  id: 'post-1.ttl',
   title: 'Hello Solid',
 });
 
-const row = await db.findByLocator(posts, { id: 'post-1' });
+const row = await db.findById(posts, 'post-1.ttl');
 
-await db.updateByLocator(posts, { id: 'post-1' }, {
+await db.updateById(posts, 'post-1.ttl', {
   title: 'Updated title',
 });
 
-await db.deleteByLocator(posts, { id: 'post-1' });
+await db.deleteById(posts, 'post-1.ttl');
 ```
 
 ## How Pod layout works
@@ -145,20 +143,22 @@ await db.deleteByLocator(posts, { id: 'post-1' });
 Every model describes both shape and placement.
 
 - `base` defines where documents live
-- `subjectTemplate` defines how business fields map to an IRI
+- `id` is a base-relative resource id, such as `post-1.ttl` or `chat-1/messages.ttl#msg-1`
 - `type` is the primary persisted `rdf:type`
 
-Common `subjectTemplate` patterns:
+`subjectTemplate` is deprecated and kept only for legacy or explicit compatibility layouts. New schemas should omit it and store the exact resource path in the `id` column.
+
+Legacy `subjectTemplate` patterns still supported for compatibility:
 
 - `#{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:
+If a legacy template uses multiple variables, exact lookup requires either:
 
 - the full IRI, or
-- a complete locator with every required variable
+- the base-relative resource id, for example `chat-1/messages.ttl#msg-1`
 
 ## Collection reads vs exact entity operations
 
@@ -170,19 +170,24 @@ Use collection reads when you want a list or filtered subset:
 
 - `client.collection(table).list(...)`
 - `db.select().from(table)...`
-- `db.query.<table>.findMany(...)`
+- `db.query.<resource>.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)`
+- `client.entity(resource, iri)`
+- `db.query.<resource>.findById(id)`
+- `db.findById(resource, id)`
+- `db.findByIri(resource, iri)`
+- `db.updateById(resource, id, data)`
+- `db.deleteById(resource, id)`
 - `db.updateByIri(...)`
-- `db.updateByLocator(...)`
 - `db.deleteByIri(...)`
-- `db.deleteByLocator(...)`
+
+`findByLocator` / `updateByLocator` / `deleteByLocator` remain temporarily for
+compatibility, but are deprecated. Prefer base-relative resource ids, generic
+`*ByResource` helpers for mixed exact targets, or full IRIs.
 
 Do not rely on `where({ id: ... })` or `where(eq(table.id, ...))` as an exact-target shortcut.
 
@@ -232,6 +237,29 @@ Start here:
 - `docs/guides/notifications.md`
 - `docs/guides/data-discovery.md`
 
+## Support and collaboration
+
+`drizzle-solid` is maintained as an open source infrastructure project.
+
+If this library is useful to you, there are three practical ways to support it:
+
+- become a design partner for an upcoming work package
+- fund a specific roadmap item
+- adopt it in a real Solid application and share requirements, edge cases, and feedback
+
+See [`docs/SUPPORT.md`](docs/SUPPORT.md) for current priorities and collaboration options.
+
+## 2026 roadmap priorities
+
+The current public roadmap is centered on the following Solid application infrastructure gaps:
+
+1. Schema lifecycle and migration support
+2. Access-aware discovery across TypeIndex / SAI-related flows
+3. Cross-Pod exact operations with explicit source scoping
+4. Interoperability testing across CSS, xpod, and plain-LDP-style setups
+
+These are intentionally infrastructure-focused. The goal is to reduce app-specific Solid glue code and make Pod-native application development more dependable for downstream projects.
+
 ## Contributing
 
 Before pushing:

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

@@ -7,9 +7,9 @@ English version: [`README.md`](README.md)
 适合在你需要下面这些能力时使用：
 
 - 用 TypeScript schema 描述 Pod 数据
-- 用 `base` 和 `subjectTemplate` 明确声明数据布局
+- 用 `base` 和 base-relative resource id 明确声明数据布局
 - 在 `pod()` 和 `drizzle()` 两种 API 风格之间选择
-- 通过 IRI 或 locator 精确读写单个实体
+- 通过 base-relative id 或 IRI 精确读写单个资源
 - 在后端提供查询能力时走 SPARQL 读取
 
 ## 它擅长什么
@@ -56,7 +56,7 @@ npm install @comunica/query-sparql-solid
 适合新代码，或者你希望 API 直接体现 Solid 语义：
 
 - `collection(table)`
-- `entity(table, iri)`
+- `entity(resource, iri)`
 - `bind(schema, options)`
 - `sparql(query)`
 
@@ -65,10 +65,10 @@ npm install @comunica/query-sparql-solid
 适合从 `drizzle-orm` 迁移，或者你想保留 builder 形状：
 
 - `select / insert / update / delete`
-- `db.query.<table>`
-- `findByLocator / findByIri`
-- `updateByLocator / updateByIri`
-- `deleteByLocator / deleteByIri`
+- `db.query.<resource>`
+- `findById / findByIri`
+- `updateById / updateByIri`
+- `deleteById / deleteByIri`
 
 两者底层是同一个运行时。区别是 API 组织方式，不是存储行为。
 
@@ -84,7 +84,6 @@ const posts = podTable('posts', {
   createdAt: datetime('createdAt').predicate('http://schema.org/dateCreated'),
 }, {
   base: 'https://alice.example/data/posts/',
-  subjectTemplate: '{id}.ttl',
   type: 'http://schema.org/CreativeWork',
 });
 
@@ -92,7 +91,7 @@ const client = pod(session);
 await client.init(posts);
 
 const created = await client.collection(posts).create({
-  id: 'post-1',
+  id: 'post-1.ttl',
   title: 'Hello Solid',
   content: 'Stored as RDF in a Pod document.',
   createdAt: new Date(),
@@ -119,7 +118,6 @@ const posts = podTable('posts', {
   title: string('title').predicate('http://schema.org/headline'),
 }, {
   base: 'https://alice.example/data/posts/',
-  subjectTemplate: '{id}.ttl',
   type: 'http://schema.org/CreativeWork',
 });
 
@@ -127,17 +125,17 @@ const db = drizzle(session);
 await db.init(posts);
 
 await db.insert(posts).values({
-  id: 'post-1',
+  id: 'post-1.ttl',
   title: 'Hello Solid',
 });
 
-const row = await db.findByLocator(posts, { id: 'post-1' });
+const row = await db.findById(posts, 'post-1.ttl');
 
-await db.updateByLocator(posts, { id: 'post-1' }, {
+await db.updateById(posts, 'post-1.ttl', {
   title: 'Updated title',
 });
 
-await db.deleteByLocator(posts, { id: 'post-1' });
+await db.deleteById(posts, 'post-1.ttl');
 ```
 
 ## Pod 布局怎么理解
@@ -145,20 +143,22 @@ await db.deleteByLocator(posts, { id: 'post-1' });
 每个模型不仅描述字段，也描述落点。
 
 - `base` 决定文档位置
-- `subjectTemplate` 决定业务字段如何映射成 IRI
+- `id` 是 base-relative resource id，例如 `post-1.ttl` 或 `chat-1/messages.ttl#msg-1`
 - `type` 是主持久化 `rdf:type`
 
-常见 `subjectTemplate`：
+`subjectTemplate` 已废弃，只为旧布局或显式兼容保留。新 schema 应该省略它，把精确资源路径放在 `id` 列里。
+
+旧 `subjectTemplate` 模式仍兼容：
 
 - `#{id}`：一个文档里多个实体
 - `{id}.ttl`：一个实体一个文档
 - `{id}.ttl#it`：一个实体一个文档，并带稳定 fragment
 - `{chatId}/messages.ttl#{id}`：多变量分区布局
 
-如果模板用了多个变量，精确定位就必须提供：
+如果旧模板用了多个变量，精确定位就必须提供：
 
 - 完整 IRI，或
-- 完整 locator
+- base-relative resource id，例如 `chat-1/messages.ttl#msg-1`
 
 ## 集合读取 vs 精确实体操作
 
@@ -170,19 +170,25 @@ await db.deleteByLocator(posts, { id: 'post-1' });
 
 - `client.collection(table).list(...)`
 - `db.select().from(table)...`
-- `db.query.<table>.findMany(...)`
+- `db.query.<resource>.findMany(...)`
 
 ### 精确实体操作
 
 当你要操作一个明确实体时，用：
 
-- `client.entity(table, iri)`
-- `db.findByIri(table, iri)`
-- `db.findByLocator(table, locator)`
+- `client.entity(resource, iri)`
+- `db.query.<resource>.findById(id)`
+- `db.findById(resource, id)`
+- `db.findByIri(resource, iri)`
+- `db.updateById(resource, id, data)`
+- `db.deleteById(resource, id)`
 - `db.updateByIri(...)`
-- `db.updateByLocator(...)`
 - `db.deleteByIri(...)`
-- `db.deleteByLocator(...)`
+
+`findByLocator` / `updateByLocator` / `deleteByLocator` 仍临时保留以兼容旧代码，
+但已经废弃。精确定位优先使用 base-relative resource id；如果调用方拿到的是
+IRI、row、locator 或 id 的混合 target，再用通用 `*ByResource` helper；已知完整
+IRI 时直接用 `*ByIri`。
 
 不要再把 `where({ id: ... })` 或 `where(eq(table.id, ...))` 当成精确单体捷径。
 

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

@@ -36,7 +36,9 @@ export interface DataLocation {
     container: string;
     /** 主体 URI 模式 (可选) - deprecated, use subjectTemplate */
     subjectPattern?: string;
-    /** Subject URI 模板 (e.g., "{id}.ttl" for document mode, "#{id}" for fragment mode) */
+    /**
+     * @deprecated Legacy/explicit Subject URI template. Prefer exact base-relative ids.
+     */
     subjectTemplate?: string;
     /** 可用的 Shape 列表（按注册顺序） */
     shapes: ShapeInfo[];
@@ -82,7 +84,9 @@ export interface DataRegistrationInfo {
     shapeTree: string;
     /** Shape URL - 实际的 SHACL Shape 定义 */
     shape?: string;
-    /** Subject URI 模板 (e.g., "{id}.ttl" for document mode, "#{id}" for fragment mode) */
+    /**
+     * @deprecated Legacy/explicit Subject URI template. Prefer exact base-relative ids.
+     */
     subjectTemplate?: string;
     /** 注册此数据的应用/代理 */
     registeredBy?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/discovery/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,sBAAsB;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IAEZ,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,WAAW;IACX,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,0BAA0B;IAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,sBAAsB;IACtB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAE3B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,eAAe,EAAE,MAAM,CAAC;IAExB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAElB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IAEjB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,kBAAkB;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,WAAW;IACX,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE/E;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD;;OAEG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAEhD;;;OAGG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACxD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/discovery/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,sBAAsB;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IAEZ,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,WAAW;IACX,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,0BAA0B;IAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;IAEpB,sBAAsB;IACtB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAE3B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,eAAe,EAAE,MAAM,CAAC;IAExB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAElB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IAEjB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,kBAAkB;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,WAAW;IACX,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE/E;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD;;OAEG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAEhD;;;OAGG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACxD"}

package/node_modules/@undefineds.co/drizzle-solid/dist/core/execution/ldp-executor.d.ts

@@ -27,6 +27,7 @@ export declare class LdpExecutor {
      */
     executeInsert(rows: any[], table: PodTable, resourceUrl: string, options?: {
         ensureContainerExists?: (containerUrl: string) => Promise<void>;
+        skipResourceExistenceCheck?: boolean;
         tableRegistry?: Map<string, PodTable[]>;
         tableNameRegistry?: Map<string, PodTable>;
     }): Promise<any[]>;

package/node_modules/@undefineds.co/drizzle-solid/dist/core/execution/ldp-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ldp-executor.d.ts","sourceRoot":"","sources":["../../../src/core/execution/ldp-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AA6B1C,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,WAAW,CAAc;gBAErB,cAAc,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW;IAOnG;;;;OAIG;IACH,gBAAgB,CACd,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EACtC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAClC,IAAI;IAIP;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,GAAG,EAAE,EACX,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QACP,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxC,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;KACtC,GACL,OAAO,CAAC,GAAG,EAAE,CAAC;IAuMjB;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,EAAE,CAAC;IA2FjB;;OAEG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,EAAE,CAAC;IAmCjB;;OAEG;YACW,gBAAgB;IAqC9B;;OAEG;YACW,eAAe;YAaf,uBAAuB;IAqFrC;;;;;;OAMG;YACW,cAAc;IAwD5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;YACW,sBAAsB;IAoDpC,OAAO,CAAC,UAAU;YA2BJ,6BAA6B;YA+C7B,oBAAoB;YAgBpB,oBAAoB;CAUnC"}
+{"version":3,"file":"ldp-executor.d.ts","sourceRoot":"","sources":["../../../src/core/execution/ldp-executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AA6B1C,qBAAa,WAAW;IACtB,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,WAAW,CAAc;gBAErB,cAAc,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW;IAOnG;;;;OAIG;IACH,gBAAgB,CACd,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EACtC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAClC,IAAI;IAIP;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,GAAG,EAAE,EACX,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QACP,qBAAqB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,0BAA0B,CAAC,EAAE,OAAO,CAAC;QACrC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxC,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;KACtC,GACL,OAAO,CAAC,GAAG,EAAE,CAAC;IAwOjB;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,EAAE,CAAC;IA2FjB;;OAEG;IACG,aAAa,CACjB,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,EAAE,CAAC;IAmCjB;;OAEG;YACW,gBAAgB;IAqC9B;;OAEG;YACW,eAAe;YAaf,uBAAuB;IAqFrC;;;;;;OAMG;YACW,cAAc;IAwD5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;YACW,sBAAsB;IAoDpC,OAAO,CAAC,UAAU;YA2BJ,6BAA6B;YA+C7B,oBAAoB;YAgBpB,oBAAoB;CAUnC"}

package/node_modules/@undefineds.co/drizzle-solid/dist/core/execution/ldp-executor.js

@@ -122,8 +122,12 @@ class LdpExecutor {
                     if (recordTriples.length === 0)
                         continue;
                     // 按 resourceUrl 分组
-                    const existing = resourceTriples.get(docResourceUrl) || [];
-                    existing.push(...recordTriples);
+                    const existing = resourceTriples.get(docResourceUrl) || {
+                        triples: [],
+                        hasFragmentSubject: false,
+                    };
+                    existing.triples.push(...recordTriples);
+                    existing.hasFragmentSubject = existing.hasFragmentSubject || subject.includes('#');
                     resourceTriples.set(docResourceUrl, existing);
                 }
                 finally {
@@ -132,16 +136,41 @@ class LdpExecutor {
             }
             // 对每个唯一的 resourceUrl 执行一次写入
             const results = [];
-            for (const [docResourceUrl, triples] of resourceTriples.entries()) {
+            for (const [docResourceUrl, group] of resourceTriples.entries()) {
+                const triples = group.triples;
                 const containerUrl = getContainerUrl(docResourceUrl);
                 if (containerUrl && options.ensureContainerExists) {
                     await options.ensureContainerExists(containerUrl);
                 }
-                // 检查资源是否已存在，如果存在则使用 PATCH 追加
-                const headRes = await this.fetchFn(docResourceUrl, { method: 'HEAD' });
-                const resourceExists = headRes.ok || headRes.status === 405;
+                // 检查资源是否已存在，如果存在则使用 PATCH 追加。
+                // Some Solid sidecars are slow or unreliable on HEAD; callers that own
+                // resource creation can skip this probe and fall back from PATCH to PUT.
+                let resourceExists = false;
+                if (!options.skipResourceExistenceCheck) {
+                    const headRes = await this.fetchFn(docResourceUrl, { method: 'HEAD' });
+                    resourceExists = headRes.ok || headRes.status === 405;
+                }
                 let response;
-                if (resourceExists) {
+                let via;
+                if (options.skipResourceExistenceCheck) {
+                    const sparql = `INSERT DATA {\n${triples.join('\n')}\n}`;
+                    response = await this.fetchFn(docResourceUrl, {
+                        method: 'PATCH',
+                        headers: { 'Content-Type': 'application/sparql-update' },
+                        body: sparql
+                    });
+                    via = 'patch';
+                    if (response.status === 404) {
+                        const body = triples.join('\n');
+                        response = await this.fetchFn(docResourceUrl, {
+                            method: 'PUT',
+                            headers: { 'Content-Type': 'text/turtle' },
+                            body
+                        });
+                        via = 'put';
+                    }
+                }
+                else if (resourceExists) {
                     // 资源已存在，使用 SPARQL UPDATE 追加三元组
                     const sparql = `INSERT DATA {\n${triples.join('\n')}\n}`;
                     response = await this.fetchFn(docResourceUrl, {
@@ -149,6 +178,7 @@ class LdpExecutor {
                         headers: { 'Content-Type': 'application/sparql-update' },
                         body: sparql
                     });
+                    via = 'patch';
                 }
                 else {
                     // 资源不存在，使用 PUT 创建
@@ -158,6 +188,7 @@ class LdpExecutor {
                         headers: { 'Content-Type': 'text/turtle' },
                         body
                     });
+                    via = 'put';
                 }
                 if (![200, 201, 202, 204, 205].includes(response.status)) {
                     const text = await response.text().catch(() => '');
@@ -171,7 +202,7 @@ class LdpExecutor {
                 }
                 // Also invalidate global cache to ensure SPARQL endpoint queries see the new data
                 await this.sparqlExecutor.invalidateHttpCache(undefined).catch(() => undefined);
-                results.push({ success: true, source: docResourceUrl, status: response.status, via: resourceExists ? 'patch' : 'put' });
+                results.push({ success: true, source: docResourceUrl, status: response.status, via });
             }
             return results;
         }
@@ -191,8 +222,10 @@ class LdpExecutor {
         // 如果资源不存在 (404) 或创建后仍不可访问，先 PUT 创建再重试
         if (response.status === 404 || response.status === 201) {
             // 验证资源是否真的存在
-            const checkRes = await this.fetchFn(resourceUrl, { method: 'HEAD' });
-            if (!checkRes.ok && checkRes.status !== 405) {
+            const needsCreate = options.skipResourceExistenceCheck
+                ? true
+                : await this.fetchFn(resourceUrl, { method: 'HEAD' }).then((checkRes) => !checkRes.ok && checkRes.status !== 405);
+            if (needsCreate) {
                 // 资源不存在，先创建
                 const createRes = await this.fetchFn(resourceUrl, {
                     method: 'PUT',