npm - @undefineds.co/xpod - Versions diffs - 0.2.44 → 0.3.0 - Mend

@undefineds.co/xpod 0.2.44 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (431) hide show

package/dist/storage/vector/VectorIndexingListener.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"VectorIndexingListener.js","sourceRoot":"","sources":["../../../src/storage/vector/VectorIndexingListener.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n VectorIndexingListener - 向量索引监听器\n \n 监听资源变更事件，自动触发向量索引更新。\n \n 工作流程：\n * 1. 收到资源变更事件\n * 2. 检查资源是否在某个 VectorStore 的 scope 内\n * 3. 如果是，读取资源内容，生成 embedding，存入向量库\n /\n\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { ResourceChangeEvent, ResourceChangeListener } from '../ObservableResourceStore';\nimport type { VectorStore } from '../vector/VectorStore';\nimport type { EmbeddingService } from '../../ai/service/EmbeddingService';\nimport type { SparqlEngine } from '../sparql/SubgraphQueryEngine';\nimport type { AiCredential } from '../../ai/service/types';\nimport type { ResourceStore, RepresentationPreferences } from '@solid/community-server';\n\n/\n VectorStore 定义（从 RDF 读取）\n /\nexport interface VectorStoreDefinition {\n /* VectorStore URI /\n uri: string;\n /* 索引范围（Container URI） /\n scope: string;\n /* embedding 模型 /\n model: string;\n /* 状态 /\n status: 'active' \| 'paused';\n /* 分块大小 /\n chunkSize?: number;\n /* 分块重叠 /\n chunkOverlap?: number;\n}\n\nexport interface VectorIndexingListenerOptions {\n /* SPARQL 引擎（用于查询 VectorStore 定义和 AI 凭据） /\n sparqlEngine: SparqlEngine;\n /* 向量存储 /\n vectorStore: VectorStore;\n /* Embedding 服务 /\n embeddingService: EmbeddingService;\n /* 资源存储（用于读取资源内容） /\n resourceStore: ResourceStore;\n /* 默认 embedding 模型 /\n defaultModel?: string;\n /* 支持的文件扩展名 /\n supportedExtensions?: string[];\n}\n\n/\n VectorIndexingListener - 自动向量索引\n /\nexport class VectorIndexingListener implements ResourceChangeListener {\n protected readonly logger = getLoggerFor(this);\n\n private readonly sparqlEngine: SparqlEngine;\n private readonly vectorStore: VectorStore;\n private readonly embeddingService: EmbeddingService;\n private readonly resourceStore: ResourceStore;\n private readonly defaultModel: string;\n private readonly supportedExtensions: Set<string>;\n\n // 缓存 VectorStore 定义，避免频繁查询\n private vectorStoreCache = new Map<string, VectorStoreDefinition[]>();\n private cacheExpiry = 0;\n private readonly cacheTtlMs = 60000; // 1 分钟缓存\n\n public constructor(options: VectorIndexingListenerOptions) {\n this.sparqlEngine = options.sparqlEngine;\n this.vectorStore = options.vectorStore;\n this.embeddingService = options.embeddingService;\n this.resourceStore = options.resourceStore;\n this.defaultModel = options.defaultModel ?? 'text-embedding-004';\n this.supportedExtensions = new Set(\n options.supportedExtensions ?? ['.txt', '.md', '.html', '.json', '.ttl', '.jsonld'],\n );\n }\n\n /\n 处理资源变更事件\n /\n public async onResourceChanged(event: ResourceChangeEvent): Promise<void> {\n const { path, action, isContainer } = event;\n\n // 跳过容器变更\n if (isContainer) {\n this.logger.debug(`Skipping container: ${path}`);\n return;\n }\n\n // 检查文件扩展名\n if (!this.isSupportedFile(path)) {\n this.logger.debug(`Skipping unsupported file type: ${path}`);\n return;\n }\n\n // 获取 Pod base URL\n const podBaseUrl = this.getPodBaseUrl(path);\n if (!podBaseUrl) {\n this.logger.debug(`Cannot determine pod base URL for: ${path}`);\n return;\n }\n\n // 如果是 VectorStore 配置文件或 Credential 配置文件更新，清除缓存\n if (path.includes('vector-stores') \|\| path.includes('credentials')) {\n this.logger.debug(`Configuration file updated, clearing cache for ${podBaseUrl}`);\n this.vectorStoreCache.delete(podBaseUrl);\n // 配置文件本身不需要索引，直接返回\n return;\n }\n\n try {\n // 查找覆盖此路径的 VectorStore\n const vectorStores = await this.findVectorStoresForPath(path, podBaseUrl);\n if (vectorStores.length === 0) {\n this.logger.debug(`No VectorStore configured for: ${path}`);\n return;\n }\n\n this.logger.info(`Processing ${action} for ${path}, matched ${vectorStores.length} VectorStore(s)`);\n\n // 根据 action 执行索引操作\n if (action === 'delete') {\n await this.handleDelete(path, vectorStores);\n } else {\n await this.handleCreateOrUpdate(path, podBaseUrl, vectorStores);\n }\n } catch (error) {\n this.logger.error(`Failed to process ${action} for ${path}: ${error}`);\n }\n }\n\n /\n 处理删除操作\n /\n private async handleDelete(path: string, vectorStores: VectorStoreDefinition[]): Promise<void> {\n const vectorId = this.pathToVectorId(path);\n\n for (const vs of vectorStores) {\n try {\n await this.vectorStore.deleteVector(vs.model, vectorId);\n this.logger.info(`Deleted vector for ${path} from model ${vs.model}`);\n } catch (error) {\n this.logger.error(`Failed to delete vector for ${path}: ${error}`);\n }\n }\n }\n\n /\n 处理创建或更新操作\n /\n private async handleCreateOrUpdate(\n path: string,\n podBaseUrl: string,\n vectorStores: VectorStoreDefinition[],\n ): Promise<void> {\n // 读取资源内容\n const content = await this.getResourceContent(path);\n if (!content \|\| content.trim().length === 0) {\n this.logger.debug(`Empty content for ${path}, skipping`);\n return;\n }\n\n // 获取 AI 凭据\n const credential = await this.getAiCredential(podBaseUrl);\n if (!credential) {\n this.logger.warn(`No AI credential found for ${podBaseUrl}, skipping indexing`);\n return;\n }\n\n // 为每个 VectorStore 生成 embedding 并存储\n // 注意：如果多个 VectorStore 使用相同的 model，只需要生成一次 embedding\n const modelEmbeddings = new Map<string, number[]>();\n\n for (const vs of vectorStores) {\n if (vs.status !== 'active') {\n this.logger.debug(`VectorStore ${vs.uri} is ${vs.status}, skipping`);\n continue;\n }\n\n const model = vs.model \|\| this.defaultModel;\n\n try {\n // 检查是否已经生成过这个 model 的 embedding\n let embedding = modelEmbeddings.get(model);\n if (!embedding) {\n embedding = await this.embeddingService.embed(content, credential, model);\n modelEmbeddings.set(model, embedding);\n }\n\n // 确保向量表存在\n await this.vectorStore.ensureVectorTable(model);\n\n // 存储向量\n const vectorId = this.pathToVectorId(path);\n await this.vectorStore.upsertVector(model, vectorId, embedding);\n\n this.logger.info(`Indexed ${path} to model ${model}, vectorId=${vectorId}`);\n } catch (error) {\n this.logger.error(`Failed to index ${path} to model ${model}: ${error}`);\n }\n }\n }\n\n /\n 查找覆盖指定路径的 VectorStore\n /\n private async findVectorStoresForPath(\n path: string,\n podBaseUrl: string,\n ): Promise<VectorStoreDefinition[]> {\n const allStores = await this.getVectorStoreDefinitions(podBaseUrl);\n\n return allStores.filter((vs) => {\n // 检查 path 是否在 scope 内\n const scope = vs.scope.endsWith('/') ? vs.scope : `${vs.scope}/`;\n return path.startsWith(scope);\n });\n }\n\n /\n 获取 Pod 的所有 VectorStore 定义\n /\n private async getVectorStoreDefinitions(podBaseUrl: string): Promise<VectorStoreDefinition[]> {\n // 检查缓存\n if (Date.now() < this.cacheExpiry && this.vectorStoreCache.has(podBaseUrl)) {\n return this.vectorStoreCache.get(podBaseUrl)!;\n }\n\n try {\n // 使用 undefineds.co/ns# 命名空间，与 drizzle-solid schema 一致\n const query = `\n PREFIX udfs: <https://undefineds.co/ns#>\n SELECT ?vs ?scope ?model ?status ?chunkSize ?chunkOverlap WHERE {\n ?vs a udfs:VectorStore ;\n udfs:container ?scope .\n OPTIONAL { ?vs udfs:chunkingStrategy ?model }\n OPTIONAL { ?vs udfs:status ?status }\n OPTIONAL { ?vs udfs:chunkSize ?chunkSize }\n OPTIONAL { ?vs udfs:chunkOverlap ?chunkOverlap }\n }\n `;\n\n const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);\n const definitions: VectorStoreDefinition[] = [];\n\n for await (const binding of bindingsStream) {\n const vs = binding.get('vs');\n const scope = binding.get('scope');\n const model = binding.get('model');\n const status = binding.get('status');\n const chunkSize = binding.get('chunkSize');\n const chunkOverlap = binding.get('chunkOverlap');\n\n if (vs && scope) {\n definitions.push({\n uri: vs.value,\n scope: this.resolveUri(scope.value, podBaseUrl),\n model: model?.value \|\| this.defaultModel,\n status: (status?.value as 'active' \| 'paused') \|\| 'active',\n chunkSize: chunkSize ? parseInt(chunkSize.value, 10) : undefined,\n chunkOverlap: chunkOverlap ? parseInt(chunkOverlap.value, 10) : undefined,\n });\n }\n }\n\n // 更新缓存\n this.vectorStoreCache.set(podBaseUrl, definitions);\n this.cacheExpiry = Date.now() + this.cacheTtlMs;\n\n this.logger.debug(`Found ${definitions.length} VectorStore(s) for ${podBaseUrl}`);\n return definitions;\n } catch (error) {\n this.logger.error(`Failed to query VectorStore definitions: ${error}`);\n return [];\n }\n }\n\n /\n 获取 AI 凭据\n /\n private async getAiCredential(podBaseUrl: string): Promise<AiCredential \| null> {\n try {\n // 使用 undefineds.co/ns# 命名空间，与 drizzle-solid schema 一致\n // Credential -> Provider 关联，从 Provider 获取 baseUrl 和 proxyUrl\n const query = `\n PREFIX udfs: <https://undefineds.co/ns#>\n SELECT ?apiKey ?baseUrl ?providerUri ?proxyUrl WHERE {\n ?cred a udfs:Credential ;\n udfs:service \"ai\" ;\n udfs:status \"active\" ;\n udfs:apiKey ?apiKey .\n OPTIONAL { ?cred udfs:provider ?providerUri }\n OPTIONAL { \n ?cred udfs:provider ?providerUri .\n ?providerUri udfs:baseUrl ?baseUrl .\n }\n OPTIONAL { \n ?cred udfs:provider ?providerUri .\n ?providerUri udfs:proxyUrl ?proxyUrl .\n }\n } LIMIT 1\n `;\n\n const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);\n\n for await (const binding of bindingsStream) {\n const apiKey = binding.get('apiKey');\n const baseUrl = binding.get('baseUrl');\n const providerUri = binding.get('providerUri');\n const proxyUrl = binding.get('proxyUrl');\n\n if (apiKey) {\n // 从 provider URI 提取 provider 名称（如 #google -> google）\n let providerName = 'google';\n if (providerUri?.value) {\n const match = providerUri.value.match(/#([^#]+)$/);\n if (match) providerName = match[1];\n }\n \n return {\n apiKey: apiKey.value,\n baseUrl: baseUrl?.value,\n provider: providerName,\n proxyUrl: proxyUrl?.value,\n };\n }\n }\n\n return null;\n } catch (error) {\n this.logger.error(`Failed to query AI credential: ${error}`);\n return null;\n }\n }\n\n /\n 读取资源内容\n /\n private async getResourceContent(path: string): Promise<string \| null> {\n try {\n const preferences: RepresentationPreferences = {\n type: { 'text/plain': 1, 'text/markdown': 0.9, 'text/turtle': 0.8, '/': 0.1 },\n };\n\n const representation = await this.resourceStore.getRepresentation({ path }, preferences);\n const chunks: Buffer[] = [];\n\n for await (const chunk of representation.data) {\n chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n }\n\n return Buffer.concat(chunks).toString('utf-8');\n } catch (error) {\n this.logger.error(`Failed to read resource ${path}: ${error}`);\n return null;\n }\n }\n\n /\n 检查是否为支持的文件类型\n /\n private isSupportedFile(path: string): boolean {\n const ext = this.getExtension(path);\n return this.supportedExtensions.has(ext);\n }\n\n /\n 获取文件扩展名\n /\n private getExtension(path: string): string {\n const lastDot = path.lastIndexOf('.');\n if (lastDot === -1) return '';\n return path.slice(lastDot).toLowerCase();\n }\n\n /\n 从路径提取 Pod base URL\n /\n private getPodBaseUrl(path: string): string \| null {\n // 假设路径格式为 /username/... 或 https://pod.example.com/username/...\n try {\n const url = new URL(path, 'http://localhost');\n const parts = url.pathname.split('/').filter(Boolean);\n if (parts.length > 0) {\n return `${url.origin}/${parts[0]}/`;\n }\n } catch {\n // 相对路径\n const parts = path.split('/').filter(Boolean);\n if (parts.length > 0) {\n return `/${parts[0]}/`;\n }\n }\n return null;\n }\n\n /\n 解析相对 URI\n /\n private resolveUri(uri: string, baseUrl: string): string {\n if (uri.startsWith('http://') \|\| uri.startsWith('https://')) {\n return uri;\n }\n if (uri.startsWith('/')) {\n try {\n const base = new URL(baseUrl);\n return `${base.origin}${uri}`;\n } catch {\n return uri;\n }\n }\n return `${baseUrl}${uri}`;\n }\n\n /\n 将路径转换为向量 ID（使用 hash）\n /\n private pathToVectorId(path: string): number {\n let hash = 2166136261; // FNV offset basis\n for (let i = 0; i < path.length; i++) {\n hash ^= path.charCodeAt(i);\n hash = Math.imul(hash, 16777619); // FNV prime\n }\n return Math.abs(hash);\n }\n\n /\n 清除缓存\n */\n public clearCache(): void {\n this.vectorStoreCache.clear();\n this.cacheExpiry = 0;\n }\n}\n"]}
1	+ {"version":3,"file":"VectorIndexingListener.js","sourceRoot":"","sources":["../../../src/storage/vector/VectorIndexingListener.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n VectorIndexingListener - 向量索引监听器\n \n 监听资源变更事件，自动触发向量索引更新。\n \n 工作流程：\n * 1. 收到资源变更事件\n * 2. 检查资源是否在某个 VectorStore 的 scope 内\n * 3. 如果是，读取资源内容，生成 embedding，存入向量库\n /\n\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { ResourceChangeEvent, ResourceChangeListener } from '../ObservableResourceStore';\nimport type { VectorStore } from '../vector/VectorStore';\nimport type { EmbeddingService } from '../../ai/service/EmbeddingService';\nimport type { SparqlEngine } from '../sparql/SubgraphQueryEngine';\nimport type { AiCredential } from '../../ai/service/types';\nimport type { ResourceStore, RepresentationPreferences } from '@solid/community-server';\nimport { XPOD_AI, XPOD_CREDENTIAL, normalizeAIConfigProviderId } from '@undefineds.co/models';\n\n/\n VectorStore 定义（从 RDF 读取）\n /\nexport interface VectorStoreDefinition {\n /* VectorStore URI /\n uri: string;\n /* 索引范围（Container URI） /\n scope: string;\n /* embedding 模型 /\n model: string;\n /* 状态 /\n status: 'active' \| 'paused';\n /* 分块大小 /\n chunkSize?: number;\n /* 分块重叠 /\n chunkOverlap?: number;\n}\n\nexport interface VectorIndexingListenerOptions {\n /* SPARQL 引擎（用于查询 VectorStore 定义和 AI 凭据） /\n sparqlEngine: SparqlEngine;\n /* 向量存储 /\n vectorStore: VectorStore;\n /* Embedding 服务 /\n embeddingService: EmbeddingService;\n /* 资源存储（用于读取资源内容） /\n resourceStore: ResourceStore;\n /* 默认 embedding 模型 /\n defaultModel?: string;\n /* 支持的文件扩展名 /\n supportedExtensions?: string[];\n}\n\n/\n VectorIndexingListener - 自动向量索引\n /\nexport class VectorIndexingListener implements ResourceChangeListener {\n protected readonly logger = getLoggerFor(this);\n\n private readonly sparqlEngine: SparqlEngine;\n private readonly vectorStore: VectorStore;\n private readonly embeddingService: EmbeddingService;\n private readonly resourceStore: ResourceStore;\n private readonly defaultModel: string;\n private readonly supportedExtensions: Set<string>;\n\n // 缓存 VectorStore 定义，避免频繁查询\n private vectorStoreCache = new Map<string, VectorStoreDefinition[]>();\n private cacheExpiry = 0;\n private readonly cacheTtlMs = 60000; // 1 分钟缓存\n\n public constructor(options: VectorIndexingListenerOptions) {\n this.sparqlEngine = options.sparqlEngine;\n this.vectorStore = options.vectorStore;\n this.embeddingService = options.embeddingService;\n this.resourceStore = options.resourceStore;\n this.defaultModel = options.defaultModel ?? 'text-embedding-004';\n this.supportedExtensions = new Set(\n options.supportedExtensions ?? ['.txt', '.md', '.html', '.json', '.ttl', '.jsonld'],\n );\n }\n\n /\n 处理资源变更事件\n /\n public async onResourceChanged(event: ResourceChangeEvent): Promise<void> {\n const { path, action, isContainer } = event;\n\n // 跳过容器变更\n if (isContainer) {\n this.logger.debug(`Skipping container: ${path}`);\n return;\n }\n\n // 检查文件扩展名\n if (!this.isSupportedFile(path)) {\n this.logger.debug(`Skipping unsupported file type: ${path}`);\n return;\n }\n\n // 获取 Pod base URL\n const podBaseUrl = this.getPodBaseUrl(path);\n if (!podBaseUrl) {\n this.logger.debug(`Cannot determine pod base URL for: ${path}`);\n return;\n }\n\n // 如果是 VectorStore 配置文件或 Credential 配置文件更新，清除缓存\n if (path.includes('vector-stores') \|\| path.includes('credentials')) {\n this.logger.debug(`Configuration file updated, clearing cache for ${podBaseUrl}`);\n this.vectorStoreCache.delete(podBaseUrl);\n // 配置文件本身不需要索引，直接返回\n return;\n }\n\n try {\n // 查找覆盖此路径的 VectorStore\n const vectorStores = await this.findVectorStoresForPath(path, podBaseUrl);\n if (vectorStores.length === 0) {\n this.logger.debug(`No VectorStore configured for: ${path}`);\n return;\n }\n\n this.logger.info(`Processing ${action} for ${path}, matched ${vectorStores.length} VectorStore(s)`);\n\n // 根据 action 执行索引操作\n if (action === 'delete') {\n await this.handleDelete(path, vectorStores);\n } else {\n await this.handleCreateOrUpdate(path, podBaseUrl, vectorStores);\n }\n } catch (error) {\n this.logger.error(`Failed to process ${action} for ${path}: ${error}`);\n }\n }\n\n /\n 处理删除操作\n /\n private async handleDelete(path: string, vectorStores: VectorStoreDefinition[]): Promise<void> {\n const vectorId = this.pathToVectorId(path);\n\n for (const vs of vectorStores) {\n try {\n await this.vectorStore.deleteVector(vs.model, vectorId);\n this.logger.info(`Deleted vector for ${path} from model ${vs.model}`);\n } catch (error) {\n this.logger.error(`Failed to delete vector for ${path}: ${error}`);\n }\n }\n }\n\n /\n 处理创建或更新操作\n /\n private async handleCreateOrUpdate(\n path: string,\n podBaseUrl: string,\n vectorStores: VectorStoreDefinition[],\n ): Promise<void> {\n // 读取资源内容\n const content = await this.getResourceContent(path);\n if (!content \|\| content.trim().length === 0) {\n this.logger.debug(`Empty content for ${path}, skipping`);\n return;\n }\n\n // 获取 AI 凭据\n const credential = await this.getAiCredential(podBaseUrl);\n if (!credential) {\n this.logger.warn(`No AI credential found for ${podBaseUrl}, skipping indexing`);\n return;\n }\n\n // 为每个 VectorStore 生成 embedding 并存储\n // 注意：如果多个 VectorStore 使用相同的 model，只需要生成一次 embedding\n const modelEmbeddings = new Map<string, number[]>();\n\n for (const vs of vectorStores) {\n if (vs.status !== 'active') {\n this.logger.debug(`VectorStore ${vs.uri} is ${vs.status}, skipping`);\n continue;\n }\n\n const model = vs.model \|\| this.defaultModel;\n\n try {\n // 检查是否已经生成过这个 model 的 embedding\n let embedding = modelEmbeddings.get(model);\n if (!embedding) {\n embedding = await this.embeddingService.embed(content, credential, model);\n modelEmbeddings.set(model, embedding);\n }\n\n // 确保向量表存在\n await this.vectorStore.ensureVectorTable(model);\n\n // 存储向量\n const vectorId = this.pathToVectorId(path);\n await this.vectorStore.upsertVector(model, vectorId, embedding);\n\n this.logger.info(`Indexed ${path} to model ${model}, vectorId=${vectorId}`);\n } catch (error) {\n this.logger.error(`Failed to index ${path} to model ${model}: ${error}`);\n }\n }\n }\n\n /\n 查找覆盖指定路径的 VectorStore\n /\n private async findVectorStoresForPath(\n path: string,\n podBaseUrl: string,\n ): Promise<VectorStoreDefinition[]> {\n const allStores = await this.getVectorStoreDefinitions(podBaseUrl);\n\n return allStores.filter((vs) => {\n // 检查 path 是否在 scope 内\n const scope = vs.scope.endsWith('/') ? vs.scope : `${vs.scope}/`;\n return path.startsWith(scope);\n });\n }\n\n /\n 获取 Pod 的所有 VectorStore 定义\n /\n private async getVectorStoreDefinitions(podBaseUrl: string): Promise<VectorStoreDefinition[]> {\n // 检查缓存\n if (Date.now() < this.cacheExpiry && this.vectorStoreCache.has(podBaseUrl)) {\n return this.vectorStoreCache.get(podBaseUrl)!;\n }\n\n try {\n // 使用 undefineds.co/ns# 命名空间，与 drizzle-solid schema 一致\n const query = `\n PREFIX udfs: <https://undefineds.co/ns#>\n SELECT ?vs ?scope ?model ?status ?chunkSize ?chunkOverlap WHERE {\n ?vs a udfs:VectorStore ;\n udfs:container ?scope .\n OPTIONAL { ?vs udfs:chunkingStrategy ?model }\n OPTIONAL { ?vs udfs:status ?status }\n OPTIONAL { ?vs udfs:chunkSize ?chunkSize }\n OPTIONAL { ?vs udfs:chunkOverlap ?chunkOverlap }\n }\n `;\n\n const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);\n const definitions: VectorStoreDefinition[] = [];\n\n for await (const binding of bindingsStream) {\n const vs = binding.get('vs');\n const scope = binding.get('scope');\n const model = binding.get('model');\n const status = binding.get('status');\n const chunkSize = binding.get('chunkSize');\n const chunkOverlap = binding.get('chunkOverlap');\n\n if (vs && scope) {\n definitions.push({\n uri: vs.value,\n scope: this.resolveUri(scope.value, podBaseUrl),\n model: model?.value \|\| this.defaultModel,\n status: (status?.value as 'active' \| 'paused') \|\| 'active',\n chunkSize: chunkSize ? parseInt(chunkSize.value, 10) : undefined,\n chunkOverlap: chunkOverlap ? parseInt(chunkOverlap.value, 10) : undefined,\n });\n }\n }\n\n // 更新缓存\n this.vectorStoreCache.set(podBaseUrl, definitions);\n this.cacheExpiry = Date.now() + this.cacheTtlMs;\n\n this.logger.debug(`Found ${definitions.length} VectorStore(s) for ${podBaseUrl}`);\n return definitions;\n } catch (error) {\n this.logger.error(`Failed to query VectorStore definitions: ${error}`);\n return [];\n }\n }\n\n /\n 获取 AI 凭据\n /\n private async getAiCredential(podBaseUrl: string): Promise<AiCredential \| null> {\n try {\n // Credential -> Provider 关联，从 Provider 获取 baseUrl 和 proxyUrl\n const query = `\n PREFIX cred: <${XPOD_CREDENTIAL.NAMESPACE}>\n PREFIX ai: <${XPOD_AI.NAMESPACE}>\n SELECT ?apiKey ?baseUrl ?providerUri ?proxyUrl WHERE {\n ?cred a cred:Credential ;\n cred:service \"ai\" ;\n cred:status \"active\" ;\n cred:apiKey ?apiKey .\n OPTIONAL { ?cred cred:provider ?providerUri }\n OPTIONAL { \n ?cred cred:provider ?providerUri .\n ?providerUri ai:baseUrl ?baseUrl .\n }\n OPTIONAL { \n ?cred cred:provider ?providerUri .\n ?providerUri ai:proxyUrl ?proxyUrl .\n }\n } LIMIT 1\n `;\n\n const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);\n\n for await (const binding of bindingsStream) {\n const apiKey = binding.get('apiKey');\n const baseUrl = binding.get('baseUrl');\n const providerUri = binding.get('providerUri');\n const proxyUrl = binding.get('proxyUrl');\n\n if (apiKey) {\n const providerName = normalizeAIConfigProviderId(providerUri?.value \|\| 'google') \|\| 'google';\n \n return {\n apiKey: apiKey.value,\n baseUrl: baseUrl?.value,\n provider: providerName,\n proxyUrl: proxyUrl?.value,\n };\n }\n }\n\n return null;\n } catch (error) {\n this.logger.error(`Failed to query AI credential: ${error}`);\n return null;\n }\n }\n\n /\n 读取资源内容\n /\n private async getResourceContent(path: string): Promise<string \| null> {\n try {\n const preferences: RepresentationPreferences = {\n type: { 'text/plain': 1, 'text/markdown': 0.9, 'text/turtle': 0.8, '/': 0.1 },\n };\n\n const representation = await this.resourceStore.getRepresentation({ path }, preferences);\n const chunks: Buffer[] = [];\n\n for await (const chunk of representation.data) {\n chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n }\n\n return Buffer.concat(chunks).toString('utf-8');\n } catch (error) {\n this.logger.error(`Failed to read resource ${path}: ${error}`);\n return null;\n }\n }\n\n /\n 检查是否为支持的文件类型\n /\n private isSupportedFile(path: string): boolean {\n const ext = this.getExtension(path);\n return this.supportedExtensions.has(ext);\n }\n\n /\n 获取文件扩展名\n /\n private getExtension(path: string): string {\n const lastDot = path.lastIndexOf('.');\n if (lastDot === -1) return '';\n return path.slice(lastDot).toLowerCase();\n }\n\n /\n 从路径提取 Pod base URL\n /\n private getPodBaseUrl(path: string): string \| null {\n // 假设路径格式为 /username/... 或 https://pod.example.com/username/...\n try {\n const url = new URL(path, 'http://localhost');\n const parts = url.pathname.split('/').filter(Boolean);\n if (parts.length > 0) {\n return `${url.origin}/${parts[0]}/`;\n }\n } catch {\n // 相对路径\n const parts = path.split('/').filter(Boolean);\n if (parts.length > 0) {\n return `/${parts[0]}/`;\n }\n }\n return null;\n }\n\n /\n 解析相对 URI\n /\n private resolveUri(uri: string, baseUrl: string): string {\n if (uri.startsWith('http://') \|\| uri.startsWith('https://')) {\n return uri;\n }\n if (uri.startsWith('/')) {\n try {\n const base = new URL(baseUrl);\n return `${base.origin}${uri}`;\n } catch {\n return uri;\n }\n }\n return `${baseUrl}${uri}`;\n }\n\n /\n 将路径转换为向量 ID（使用 hash）\n /\n private pathToVectorId(path: string): number {\n let hash = 2166136261; // FNV offset basis\n for (let i = 0; i < path.length; i++) {\n hash ^= path.charCodeAt(i);\n hash = Math.imul(hash, 16777619); // FNV prime\n }\n return Math.abs(hash);\n }\n\n /\n 清除缓存\n */\n public clearCache(): void {\n this.vectorStoreCache.clear();\n this.cacheExpiry = 0;\n }\n}\n"]}

package/dist/util/identifiers/ClusterIdentifierStrategy.js CHANGED Viewed

@@ -5,6 +5,21 @@ const node_url_1 = require("node:url");
 const global_logger_factory_1 = require("global-logger-factory");
 const community_server_1 = require("@solid/community-server");
 const PathUtil_1 = require("@solid/community-server/dist/util/PathUtil");
+const SERVER_ROOT_SEGMENTS = new Set([
+    '.account',
+    '.oidc',
+    '.well-known',
+    'admin',
+    'api',
+    'app',
+    'auth',
+    'dashboard',
+    'login',
+    'logout',
+    'provision',
+    'register',
+    'settings',
+]);
 /**
  * Identifier strategy that accepts both the primary cluster host and any
  * node subdomain under the same base domain.
@@ -60,7 +75,20 @@ class ClusterIdentifierStrategy extends community_server_1.BaseIdentifierStrateg
         try {
             const target = new node_url_1.URL(identifier.path);
             if (target.hostname.toLowerCase() === this.baseHost) {
-                return (0, PathUtil_1.ensureTrailingSlash)(target.href) === this.baseUrl;
+                if ((0, PathUtil_1.ensureTrailingSlash)(target.href) === this.baseUrl) {
+                    return true;
+                }
+                const basePath = new node_url_1.URL(this.baseUrl).pathname;
+                if (!target.pathname.endsWith('/')) {
+                    return false;
+                }
+                const pathname = (0, PathUtil_1.ensureTrailingSlash)(target.pathname);
+                if (!pathname.startsWith(basePath)) {
+                    return false;
+                }
+                const relative = pathname.slice(basePath.length).replace(/^\/+/, '');
+                const segments = relative.split('/').filter(Boolean);
+                return segments.length === 1 && !SERVER_ROOT_SEGMENTS.has(segments[0].toLowerCase());
             }
             return target.pathname === '/' || target.pathname === '';
         }

package/dist/util/identifiers/ClusterIdentifierStrategy.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ClusterIdentifierStrategy.js","sourceRoot":"","sources":["../../../src/util/identifiers/ClusterIdentifierStrategy.ts"],"names":[],"mappings":"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~~OAAO~~,IAAA,8BAAmB,EAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC;~~YAC3D~~,CAAC;YACD,OAAO,MAAM,CAAC,QAAQ,KAAK,GAAG,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;~~AApED~~,~~8DAoEC~~","sourcesContent":["import { URL } from 'node:url';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { BaseIdentifierStrategy } from '@solid/community-server';\nimport type { ResourceIdentifier } from '@solid/community-server';\nimport { ensureTrailingSlash } from '@solid/community-server/dist/util/PathUtil';\n\nexport interface ClusterIdentifierStrategyOptions {\n baseUrl: string;\n /*\n 允许的额外 host 列表（用于 Docker/容器环境）\n * 可以是数组或逗号分隔的字符串，例如: ['cloud', 'idp'] 或 \"cloud,idp,localhost\"\n /\n allowedHosts?: string[] \| string;\n}\n\n/\n Identifier strategy that accepts both the primary cluster host and any\n * node subdomain under the same base domain.\n */\nexport class ClusterIdentifierStrategy extends BaseIdentifierStrategy {\n private readonly logger = getLoggerFor(this);\n private readonly baseUrl: string;\n private readonly baseHost: string;\n private readonly allowedHosts: string[];\n\n public constructor(options: ClusterIdentifierStrategyOptions) {\n super();\n if (!options.baseUrl) {\n throw new Error('ClusterIdentifierStrategy requires a baseUrl.');\n }\n const parsed = new URL(options.baseUrl);\n this.baseHost = parsed.hostname.toLowerCase();\n this.baseUrl = ensureTrailingSlash(parsed.href);\n // 处理 allowedHosts：可以是数组或逗号分隔的字符串\n const hostsInput = options.allowedHosts ?? [];\n const hostsArray = Array.isArray(hostsInput)\n ? hostsInput\n : typeof hostsInput === 'string' && hostsInput.length > 0\n ? hostsInput.split(',').map(h => h.trim())\n : [];\n this.allowedHosts = hostsArray.map(h => h.toLowerCase());\n this.logger.info(`ClusterIdentifierStrategy initialized: baseUrl=${this.baseUrl}, baseHost=${this.baseHost}, allowedHosts=[${this.allowedHosts.join(', ')}]`);\n }\n\n public override supportsIdentifier(identifier: ResourceIdentifier): boolean {\n try {\n const target = new URL(identifier.path);\n const host = target.hostname.toLowerCase();\n\n // 检查是否在允许的 hosts 列表中\n if (this.allowedHosts.includes(host)) {\n this.logger.debug(`supportsIdentifier: ${identifier.path} -> true (allowedHosts match: ${host})`);\n return true;\n }\n\n const hostMatches = host === this.baseHost \|\| host.endsWith(`.${this.baseHost}`);\n\n if (!hostMatches) {\n this.logger.debug(`supportsIdentifier: ${identifier.path} -> false (host mismatch: ${host} vs ${this.baseHost})`);\n return false;\n }\n\n if (host === this.baseHost) {\n const supported = identifier.path.startsWith(this.baseUrl);\n this.logger.debug(`supportsIdentifier: ${identifier.path} -> ${supported} (baseUrl check)`);\n return supported;\n }\n\n this.logger.debug(`supportsIdentifier: ${identifier.path} -> true (subdomain match)`);\n return true;\n } catch (error: unknown) {\n this.logger.warn(`Failed to parse identifier ${identifier.path}: ${(error as Error).message}`);\n return false;\n }\n }\n\n public override isRootContainer(identifier: ResourceIdentifier): boolean {\n try {\n const target = new URL(identifier.path);\n if (target.hostname.toLowerCase() === this.baseHost) {\n ~~return~~ ensureTrailingSlash(target.href) === this.baseUrl;\n }\n return target.pathname === '/' \|\| target.pathname === '';\n } catch {\n return false;\n }\n }\n}\n"]}
1	+ {"version":3,"file":"ClusterIdentifierStrategy.js","sourceRoot":"","sources":["../../../src/util/identifiers/ClusterIdentifierStrategy.ts"],"names":[],"mappings":"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","sourcesContent":["import { URL } from 'node:url';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { BaseIdentifierStrategy } from '@solid/community-server';\nimport type { ResourceIdentifier } from '@solid/community-server';\nimport { ensureTrailingSlash } from '@solid/community-server/dist/util/PathUtil';\n\nexport interface ClusterIdentifierStrategyOptions {\n baseUrl: string;\n /*\n 允许的额外 host 列表（用于 Docker/容器环境）\n * 可以是数组或逗号分隔的字符串，例如: ['cloud', 'idp'] 或 \"cloud,idp,localhost\"\n /\n allowedHosts?: string[] \| string;\n}\n\nconst SERVER_ROOT_SEGMENTS = new Set([\n '.account',\n '.oidc',\n '.well-known',\n 'admin',\n 'api',\n 'app',\n 'auth',\n 'dashboard',\n 'login',\n 'logout',\n 'provision',\n 'register',\n 'settings',\n]);\n\n/\n Identifier strategy that accepts both the primary cluster host and any\n * node subdomain under the same base domain.\n */\nexport class ClusterIdentifierStrategy extends BaseIdentifierStrategy {\n private readonly logger = getLoggerFor(this);\n private readonly baseUrl: string;\n private readonly baseHost: string;\n private readonly allowedHosts: string[];\n\n public constructor(options: ClusterIdentifierStrategyOptions) {\n super();\n if (!options.baseUrl) {\n throw new Error('ClusterIdentifierStrategy requires a baseUrl.');\n }\n const parsed = new URL(options.baseUrl);\n this.baseHost = parsed.hostname.toLowerCase();\n this.baseUrl = ensureTrailingSlash(parsed.href);\n // 处理 allowedHosts：可以是数组或逗号分隔的字符串\n const hostsInput = options.allowedHosts ?? [];\n const hostsArray = Array.isArray(hostsInput)\n ? hostsInput\n : typeof hostsInput === 'string' && hostsInput.length > 0\n ? hostsInput.split(',').map(h => h.trim())\n : [];\n this.allowedHosts = hostsArray.map(h => h.toLowerCase());\n this.logger.info(`ClusterIdentifierStrategy initialized: baseUrl=${this.baseUrl}, baseHost=${this.baseHost}, allowedHosts=[${this.allowedHosts.join(', ')}]`);\n }\n\n public override supportsIdentifier(identifier: ResourceIdentifier): boolean {\n try {\n const target = new URL(identifier.path);\n const host = target.hostname.toLowerCase();\n\n // 检查是否在允许的 hosts 列表中\n if (this.allowedHosts.includes(host)) {\n this.logger.debug(`supportsIdentifier: ${identifier.path} -> true (allowedHosts match: ${host})`);\n return true;\n }\n\n const hostMatches = host === this.baseHost \|\| host.endsWith(`.${this.baseHost}`);\n\n if (!hostMatches) {\n this.logger.debug(`supportsIdentifier: ${identifier.path} -> false (host mismatch: ${host} vs ${this.baseHost})`);\n return false;\n }\n\n if (host === this.baseHost) {\n const supported = identifier.path.startsWith(this.baseUrl);\n this.logger.debug(`supportsIdentifier: ${identifier.path} -> ${supported} (baseUrl check)`);\n return supported;\n }\n\n this.logger.debug(`supportsIdentifier: ${identifier.path} -> true (subdomain match)`);\n return true;\n } catch (error: unknown) {\n this.logger.warn(`Failed to parse identifier ${identifier.path}: ${(error as Error).message}`);\n return false;\n }\n }\n\n public override isRootContainer(identifier: ResourceIdentifier): boolean {\n try {\n const target = new URL(identifier.path);\n if (target.hostname.toLowerCase() === this.baseHost) {\n if (ensureTrailingSlash(target.href) === this.baseUrl) {\n return true;\n }\n\n const basePath = new URL(this.baseUrl).pathname;\n if (!target.pathname.endsWith('/')) {\n return false;\n }\n\n const pathname = ensureTrailingSlash(target.pathname);\n if (!pathname.startsWith(basePath)) {\n return false;\n }\n\n const relative = pathname.slice(basePath.length).replace(/^\\/+/, '');\n const segments = relative.split('/').filter(Boolean);\n return segments.length === 1 && !SERVER_ROOT_SEGMENTS.has(segments[0].toLowerCase());\n }\n return target.pathname === '/' \|\| target.pathname === '';\n } catch {\n return false;\n }\n }\n}\n"]}

package/dist/vocab/index.d.ts CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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"]}
1	+ {"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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +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"]}
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 /* 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 CHANGED Viewed

@@ -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: