@undefineds.co/models 0.2.3 → 0.2.12

package/README.md

@@ -40,6 +40,23 @@ LinX 的所有数据存储在 Solid Pod 中，使用标准的 RDF 格式。本
 
 ---
 
+## Chat / Thread / Message / Session 语义
+
+这组语义是 CLI、App、watch/runtime 共享的 models 级业务真相，不应在 UI、CLI 壳层或 skill 文件中重新定义。
+
+- **Chat** 表示对话对象/counterpart：用户正在和谁或什么对话，例如默认 AI secretary、某个人、群组、Codex、Claude Code，或后续具体 AI 身份。
+- **Thread** 表示具体场所、时间线和 runtime context：workspace、watch 场景、AI 产品运行时 session、外部 agent session 等上下文都归在 thread 上。
+- **Message** 同时属于一个 `chat` 和一个 `thread`：chat 回答“跟谁聊”，thread 回答“在哪个运行/时间线里聊”。
+- **Session** 表示通用 AI 产品/agent runtime 的运行生命周期投影：它必须指向对应的 `chat` URI 和 `thread` URI，不能作为另一套对话根。
+
+存储层规则：
+
+- Pod schema 使用 `chat`、`thread` 这类 URI-valued RDF relation 字段。
+- `chatId`、`threadId` 只允许作为 UI 状态、函数参数、runtime protocol 字段或 metadata 中的兼容信息，不允许作为持久 RDF link 字段。
+- 新增 shared model 代码优先使用 `chatResource`、`threadResource`、`messageResource`、`sessionResource` 等 Solid resource 命名；`*Table` 只作为兼容 alias 逐步退出。
+
+---
+
 ## 标准词汇表
 
 LinX 遵循 Solid 生态的最佳实践，优先使用标准 RDF 词汇表：
@@ -575,4 +592,3 @@ MIT License
 
 
 
-

package/dist/chat.schema.d.ts

@@ -3,18 +3,39 @@ export interface ChatMetadata {
     memberRoles?: Record<string, ChatMemberRole>;
 }
 /**
- * Chat schema (channel/place).
+ * Chat resource.
  *
- * CP0 baseline (alignment):
- * - Chat is a container for messages/widgets regardless of counterpart type.
- * - Do not encode counterpart-specific behavior in Chat (no chatType/subtype).
- * - Participants use Solid chat-aligned flow vocabulary (wf/flow).
+ * Product semantics:
+ * - Chat means "who/what the user is talking with": a person, group, AI agent, or
+ *   default AI secretary. It is the counterpart/conversation object, not the place
+ *   where a runtime executes.
+ * - Runtime/workspace/place/session context belongs on Thread.
+ * - Direct LinX CLI entry should use a chat representing the AI secretary.
+ * - Watch entry should use a chat representing the watched agent/tool, such as
+ *   Codex, Claude Code, or a concrete AI identity when available.
  *
  * Storage structure (aligned with xpod):
  * - Chat metadata stored as #this in index.ttl
  * - Location: /.data/chat/{id}/index.ttl#this
  * - Threads stored as fragments in same file: /.data/chat/{id}/index.ttl#{threadId}
  */
+export declare const chatResource: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
+    id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
+    title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;
+    description: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    avatarUrl: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    starred: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"boolean", null, false, true>;
+    muted: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"boolean", null, false, true>;
+    unreadCount: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"integer", null, false, true>;
+    contact: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    participants: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"array", "uri", false, false>;
+    metadata: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"object", null, false, false>;
+    lastActiveAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    lastMessageId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    lastMessagePreview: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
+    updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
+}>>;
 export declare const chatTable: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
     id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
     title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;
@@ -32,6 +53,6 @@ export declare const chatTable: import("@undefineds.co/drizzle-solid/dist/core/s
     createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
     updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
 }>>;
-export type ChatRow = typeof chatTable.$inferSelect;
-export type ChatInsert = typeof chatTable.$inferInsert;
-export type ChatUpdate = typeof chatTable.$inferUpdate;
+export type ChatRow = typeof chatResource.$inferSelect;
+export type ChatInsert = typeof chatResource.$inferInsert;
+export type ChatUpdate = typeof chatResource.$inferUpdate;

package/dist/chat.schema.js

@@ -1,19 +1,23 @@
 import { boolean, object, podTable, string, text, timestamp, uri, id, integer } from '@undefineds.co/drizzle-solid';
 import { UDFS, DCTerms, SCHEMA, MEETING, WF } from './namespaces.js';
 /**
- * Chat schema (channel/place).
+ * Chat resource.
  *
- * CP0 baseline (alignment):
- * - Chat is a container for messages/widgets regardless of counterpart type.
- * - Do not encode counterpart-specific behavior in Chat (no chatType/subtype).
- * - Participants use Solid chat-aligned flow vocabulary (wf/flow).
+ * Product semantics:
+ * - Chat means "who/what the user is talking with": a person, group, AI agent, or
+ *   default AI secretary. It is the counterpart/conversation object, not the place
+ *   where a runtime executes.
+ * - Runtime/workspace/place/session context belongs on Thread.
+ * - Direct LinX CLI entry should use a chat representing the AI secretary.
+ * - Watch entry should use a chat representing the watched agent/tool, such as
+ *   Codex, Claude Code, or a concrete AI identity when available.
  *
  * Storage structure (aligned with xpod):
  * - Chat metadata stored as #this in index.ttl
  * - Location: /.data/chat/{id}/index.ttl#this
  * - Threads stored as fragments in same file: /.data/chat/{id}/index.ttl#{threadId}
  */
-export const chatTable = podTable('chats', {
+export const chatResource = podTable('chats', {
     id: id('id'),
     // Display
     title: string('title').predicate(DCTerms.title).notNull(),
@@ -33,7 +37,9 @@ export const chatTable = podTable('chats', {
     metadata: object('metadata').predicate(UDFS.metadata),
     // Last activity
     lastActiveAt: timestamp('lastActiveAt').predicate(UDFS.lastActiveAt),
-    lastMessageId: uri('lastMessageId').predicate(WF.message),
+    // Latest-message pointer. Do not reuse WF.message here: WF.message is the
+    // Solid Chat containment relation used by message.chat inverse links.
+    lastMessageId: uri('lastMessageId').predicate(UDFS.lastMessage),
     lastMessagePreview: text('lastMessagePreview').predicate(SCHEMA.text),
     // Timestamps
     createdAt: timestamp('createdAt').predicate(DCTerms.created).notNull().defaultNow(),
@@ -45,3 +51,5 @@ export const chatTable = podTable('chats', {
     namespace: UDFS,
     subjectTemplate: '{id}/index.ttl#this',
 });
+// Compatibility alias. New model code should prefer `chatResource`.
+export const chatTable = chatResource;

package/dist/client/index.js

@@ -126,6 +126,12 @@ export function parseLinxClientSecrets(raw) {
             clientSecret: raw.clientSecret,
         };
     }
+    if (typeof raw.secret_id === 'string' && typeof raw.secret_key === 'string') {
+        return {
+            clientId: raw.secret_id,
+            clientSecret: raw.secret_key,
+        };
+    }
     if (typeof raw.oidcRefreshToken === 'string'
         && typeof raw.oidcAccessToken === 'string'
         && typeof raw.oidcExpiresAt === 'string') {

package/dist/comunica-patches.d.ts

@@ -0,0 +1,3 @@
+type NodeRequire = (id: string) => unknown;
+export declare function applySolidComunicaPatches(requireModule?: NodeRequire): boolean;
+export {};

package/dist/comunica-patches.js

@@ -0,0 +1,49 @@
+const COMUNICA_OBSERVER_MODULES = [
+    '@comunica/actor-query-result-serialize-sparql-json',
+    '@comunica/actor-query-result-serialize-stats',
+    '@comunica/query-sparql-solid/node_modules/@comunica/actor-query-result-serialize-sparql-json',
+    '@comunica/query-sparql-solid/node_modules/@comunica/actor-query-result-serialize-stats',
+];
+export function applySolidComunicaPatches(requireModule) {
+    const resolvedRequire = requireModule ?? createNodeRequire();
+    if (!resolvedRequire) {
+        return false;
+    }
+    return COMUNICA_OBSERVER_MODULES
+        .map((moduleName) => patchActionObserverHttp(resolvedRequire, moduleName))
+        .some(Boolean);
+}
+function createNodeRequire() {
+    const nodeProcess = typeof globalThis.process === 'object'
+        ? globalThis.process
+        : undefined;
+    const createRequire = nodeProcess?.getBuiltinModule?.('module')?.createRequire;
+    if (typeof createRequire !== 'function') {
+        return null;
+    }
+    return createRequire(import.meta.url);
+}
+function patchActionObserverHttp(requireModule, moduleName) {
+    try {
+        const module = requireModule(moduleName);
+        const prototype = module.ActionObserverHttp?.prototype;
+        const originalOnRun = prototype?.onRun;
+        if (!prototype || typeof originalOnRun !== 'function') {
+            return false;
+        }
+        if (prototype.__linxObservedActorsPatchApplied) {
+            return true;
+        }
+        prototype.onRun = function patchedActionObserverOnRun(actor, action, output) {
+            if (!Array.isArray(this.observedActors)) {
+                this.observedActors = [];
+            }
+            return originalOnRun.call(this, actor, action, output);
+        };
+        prototype.__linxObservedActorsPatchApplied = true;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/grant.schema.d.ts

@@ -1,6 +1,6 @@
 export declare const grantTable: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
     id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
-    rdfType: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, true>;
+    rdfType: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"array", "uri", true, true>;
     target: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
     action: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
     effect: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;

package/dist/grant.schema.js

@@ -4,9 +4,9 @@ import { RDF, ODRL, UDFS, DCTerms } from './namespaces.js';
 // This is the durable "delegation" layer (distinct from one-off approvals and append-only audit entries).
 export const grantTable = podTable('grant', {
     id: id('id'),
-    // Also tag the instance with our company-level class for easy discovery.
-    // Primary rdf:type is ODRL.Policy (standard).
-    rdfType: uri('rdfType').predicate(RDF.type).notNull().default(UDFS.AutonomyGrant),
+    // Table-level type writes odrl:Policy. Keep the project-specific class as
+    // an additional rdf:type, so readback treats RDF class membership as multi-valued.
+    rdfType: uri('rdfType').array().predicate(RDF.type).notNull().default([UDFS.AutonomyGrant]),
     // Minimal ODRL surface (CP0): allow/deny action on target.
     target: uri('target').predicate(ODRL.target).notNull(),
     action: uri('action').predicate(ODRL.action).notNull(),

package/dist/index.d.ts

@@ -5,11 +5,11 @@ export * from './profile.repository';
 export * from './profile.schema';
 export { contactTable, ContactClass, ContactType, isAgentContact, isGroupContact, type ContactRow, type ContactInsert, type ContactUpdate, type ContactClassValue, type ContactTypeValue, } from './contact.schema';
 export { contactRepository } from './contact.repository';
-export { chatTable, type ChatMetadata, type ChatMemberRole, type ChatRow, type ChatInsert, type ChatUpdate, } from './chat.schema';
+export { chatResource, chatTable, type ChatMetadata, type ChatMemberRole, type ChatRow, type ChatInsert, type ChatUpdate, } from './chat.schema';
 export { chatRepository } from './chat.repository';
-export { threadTable, type ThreadRow, type ThreadInsert, type ThreadUpdate, } from './thread.schema';
+export { threadResource, threadTable, type ThreadRow, type ThreadInsert, type ThreadUpdate, } from './thread.schema';
 export { threadRepository } from './thread.repository';
-export { messageTable, type MessageRow, type MessageInsert, type MessageUpdate, } from './message.schema';
+export { messageResource, messageTable, type MessageRow, type MessageInsert, type MessageUpdate, } from './message.schema';
 export { messageRepository } from './message.repository';
 export { MessageBlockType, MessageBlockStatus, type BaseMessageBlock, type PlaceholderMessageBlock, type MainTextMessageBlock, type ThinkingMessageBlock, type ImageMessageBlock, type CodeMessageBlock, type ToolMessageBlock, type FileMessageBlock, type ErrorMessageBlock, type CitationMessageBlock, type MessageBlock, type MessageRichContent, createMessageBlock, isBlockType, parseMessageBlocks, serializeMessageBlocks, } from './types/message-block';
 export { type ToolApprovalBlock, type ToolCallBlock, type TaskProgressBlock, type CollaborationRichBlock, type ToolRisk, type ToolApprovalStatus, type ToolCallStatus, type TaskProgressStepStatus, } from "./types/collaboration-blocks";
@@ -20,7 +20,7 @@ export { settingsTable, SETTING_KEYS, type SettingKey, type SettingsRow, type Se
 export { agentTable, type AgentRow, type AgentInsert, type AgentUpdate, } from './agent.schema';
 export { agentRepository } from './agent.repository';
 export { DEFAULT_AGENT_PROVIDERS, type AgentProviderMetadata, type AgentModelOption, } from './agent.providers';
-export { sessionTable, type SessionType, type SessionStatus, type SessionRow, type SessionInsert, type SessionUpdate, } from './session';
+export { sessionResource, sessionTable, type SessionType, type SessionStatus, type SessionRow, type SessionInsert, type SessionUpdate, } from './session';
 export { sessionRepository } from './session.repository';
 export { approvalTable, type ApprovalRow, type ApprovalInsert, type ApprovalUpdate, } from './approval.schema';
 export { auditTable, type AuditRow, type AuditInsert, type AuditUpdate, } from './audit.schema';
@@ -36,8 +36,9 @@ export { aiProviderTable, type AIProviderRow, type AIProviderInsert, type AIProv
 export { aiModelTable, type AIModelRow, type AIModelInsert, type AIModelUpdate, } from "./ai-model.schema";
 export { aiConfigModelUri, aiConfigProviderUri, buildAIConfigMutationPlan, buildAIConfigProviderStateMap, getAIConfigDefaultBaseUrl, getAIConfigProviderCatalog, getAIConfigProviderFamilyIds, getAIConfigProviderMetadata, getDefaultAIConfigCredentialId, normalizeAIConfigProviderId, normalizeAIConfigResourceId, sameAIConfigProviderFamily, type AIConfigModel, type AIConfigMutationPlan, type AIConfigProviderCatalogEntry, type AIConfigProviderState, type AIConfigUpdate, type BuildAIConfigProviderStateMapOptions, } from './ai-config';
 export { buildAcpPermissionResponse, buildWatchThreadMetadata, buildWatchTranscriptMessages, buildWatchUserInputResponse, createWatchSessionId, detectWatchAuthFailure, formatWatchAutoFallbackMessage, formatWatchBackendAuthMessage, extractWatchSessionIdFromJsonLine, getWatchArchiveRelativePaths, getWatchAuthLoginCommand, looksLikeWatchAuthFailureText, normalizeAcpInteractionRequest, normalizeAcpRequest, normalizeAcpSessionNotification, normalizeCodexAppServerNotification, normalizeCodexAppServerRequest, normalizeWatchCredentialSource, parseWatchClaudeAuthStatus, parseWatchJsonLine, parseWatchJsonProtocolLine, resolveWatchAutoApprovalDecision, resolveWatchCredentialSourceResolution, resolveWatchInteractionAutoResponse, resolveWatchQuestionAnswer, shouldAttemptCloudCredentialProbe, WATCH_EVENTS_FILE_NAME, WATCH_HOME_DIRNAME, WATCH_SESSIONS_DIRNAME, WATCH_SESSION_FILE_NAME, type WatchApprovalDecision, type WatchApprovalRequest, type CreateWatchSessionIdOptions, type WatchAuthFailure, type WatchAuthState, type WatchAuthStatus, type WatchArchiveRelativePaths, type WatchBackend, type WatchCloudCredentialProbe, type WatchCloudCredentialProbeStatus, type WatchCredentialSource, type WatchCredentialSourceResolution, type WatchEventLogEntry, type WatchMode, type WatchNormalizedEvent, type WatchOutputStream, type WatchResolvedCredentialSource, type WatchRuntime, type WatchSessionRecord, type WatchSessionStatus, type WatchThreadMetadata, type WatchTranscriptMessage, type WatchTranscriptMessageRole, } from './watch';
+export { applySolidComunicaPatches, } from './comunica-patches';
 export { createRepositoryDescriptor, definePodRepository, findPodRowByStorageId, initSolidTables, resolveRowId, resolvePodUri, whereByPodStorageId, type AnyPodTable, type PodRepositoryDescriptor, type RepositoryCacheOptions, type RepositoryInvalidations, type RepositoryScope, type SolidDatabase, } from './repository';
 export { importJobSchema } from './import';
 export { eq, ne, and, or, drizzle } from '@undefineds.co/drizzle-solid';
-export { solidSchema } from './schema';
+export { solidResources, solidSchema } from './schema';
 export * from './discovery';

package/dist/index.js

@@ -23,11 +23,11 @@ export * from './profile.schema.js';
 export { contactTable, ContactClass, ContactType, isAgentContact, isGroupContact, } from './contact.schema.js';
 export { contactRepository } from './contact.repository.js';
 // Chat & Message - 聊天和消息
-export { chatTable, } from './chat.schema.js';
+export { chatResource, chatTable, } from './chat.schema.js';
 export { chatRepository } from './chat.repository.js';
-export { threadTable, } from './thread.schema.js';
+export { threadResource, threadTable, } from './thread.schema.js';
 export { threadRepository } from './thread.repository.js';
-export { messageTable, } from './message.schema.js';
+export { messageResource, messageTable, } from './message.schema.js';
 export { messageRepository } from './message.repository.js';
 // Message Block - 消息块类型系统 (Block-based Message System)
 export { MessageBlockType, MessageBlockStatus, createMessageBlock, isBlockType, parseMessageBlocks, serializeMessageBlocks, } from './types/message-block.js';
@@ -49,7 +49,7 @@ export { DEFAULT_AGENT_PROVIDERS, } from './agent.providers.js';
 // 其他模型
 // ============================================
 // Session - 会话管理
-export { sessionTable, } from './session/index.js';
+export { sessionResource, sessionTable, } from './session/index.js';
 export { sessionRepository } from './session.repository.js';
 // Approval / Audit / Grant / Inbox Notification
 export { approvalTable, } from './approval.schema.js';
@@ -70,6 +70,7 @@ export { aiProviderTable, } from "./ai-provider.schema.js";
 export { aiModelTable, } from "./ai-model.schema.js";
 export { aiConfigModelUri, aiConfigProviderUri, buildAIConfigMutationPlan, buildAIConfigProviderStateMap, getAIConfigDefaultBaseUrl, getAIConfigProviderCatalog, getAIConfigProviderFamilyIds, getAIConfigProviderMetadata, getDefaultAIConfigCredentialId, normalizeAIConfigProviderId, normalizeAIConfigResourceId, sameAIConfigProviderFamily, } from './ai-config/index.js';
 export { buildAcpPermissionResponse, buildWatchThreadMetadata, buildWatchTranscriptMessages, buildWatchUserInputResponse, createWatchSessionId, detectWatchAuthFailure, formatWatchAutoFallbackMessage, formatWatchBackendAuthMessage, extractWatchSessionIdFromJsonLine, getWatchArchiveRelativePaths, getWatchAuthLoginCommand, looksLikeWatchAuthFailureText, normalizeAcpInteractionRequest, normalizeAcpRequest, normalizeAcpSessionNotification, normalizeCodexAppServerNotification, normalizeCodexAppServerRequest, normalizeWatchCredentialSource, parseWatchClaudeAuthStatus, parseWatchJsonLine, parseWatchJsonProtocolLine, resolveWatchAutoApprovalDecision, resolveWatchCredentialSourceResolution, resolveWatchInteractionAutoResponse, resolveWatchQuestionAnswer, shouldAttemptCloudCredentialProbe, WATCH_EVENTS_FILE_NAME, WATCH_HOME_DIRNAME, WATCH_SESSIONS_DIRNAME, WATCH_SESSION_FILE_NAME, } from './watch/index.js';
+export { applySolidComunicaPatches, } from './comunica-patches.js';
 export { createRepositoryDescriptor, definePodRepository, findPodRowByStorageId, initSolidTables, resolveRowId, resolvePodUri, whereByPodStorageId, } from './repository.js';
 // Import Job - 导入任务
 export { importJobSchema } from './import/index.js';
@@ -80,7 +81,7 @@ export { eq, ne, and, or, drizzle } from '@undefineds.co/drizzle-solid';
 // ============================================
 // Schema registry
 // ============================================
-export { solidSchema } from './schema.js';
+export { solidResources, solidSchema } from './schema.js';
 // ============================================
 // Discovery Service (发现服务)
 // ============================================

package/dist/message.schema.d.ts

@@ -1,11 +1,37 @@
 /**
- * Message schema (aligned with xpod).
+ * Message resource (aligned with xpod).
+ *
+ * Product semantics:
+ * - Message belongs to both a Chat counterpart and a concrete Thread timeline.
+ * - Chat answers "who/what is this conversation with".
+ * - Thread answers "which run/timeline/place does this message belong to".
  *
  * Storage structure:
- * - Location: /.data/chat/{chat}/{yyyy}/{MM}/{dd}/messages.ttl#{id}
+ * - Location: /.data/chat/{chat|id}/{yyyy}/{MM}/{dd}/messages.ttl#{id}
  * - Date-based path for efficient time-range queries
  * - chat/thread are RDF URI relations. Short ids remain accepted at API/query call sites via ORM URI template resolution.
  */
+export declare const messageResource: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
+    id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
+    chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+    thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+    maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+    role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
+    content: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;
+    richContent: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    status: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
+    replacedBy: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    deletedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    senderName: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    senderAvatarUrl: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    mentions: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"array", "uri", false, false>;
+    replyTo: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    routedBy: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    routeTargetAgentId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    coordinationId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
+    updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+}>>;
 export declare const messageTable: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
     id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
     chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
@@ -27,6 +53,6 @@ export declare const messageTable: import("@undefineds.co/drizzle-solid/dist/cor
     createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
     updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
 }>>;
-export type MessageRow = typeof messageTable.$inferSelect;
-export type MessageInsert = typeof messageTable.$inferInsert;
-export type MessageUpdate = typeof messageTable.$inferUpdate;
+export type MessageRow = typeof messageResource.$inferSelect;
+export type MessageInsert = typeof messageResource.$inferInsert;
+export type MessageUpdate = typeof messageResource.$inferUpdate;

package/dist/message.schema.js

@@ -1,20 +1,26 @@
 import { podTable, uri, string, text, timestamp, id } from '@undefineds.co/drizzle-solid';
 import { UDFS, DCTerms, FOAF, LINX_MSG, MEETING, SCHEMA, SIOC, WF } from './namespaces.js';
-import { threadTable } from './thread.schema.js';
+import { chatResource } from './chat.schema.js';
+import { threadResource } from './thread.schema.js';
 /**
- * Message schema (aligned with xpod).
+ * Message resource (aligned with xpod).
+ *
+ * Product semantics:
+ * - Message belongs to both a Chat counterpart and a concrete Thread timeline.
+ * - Chat answers "who/what is this conversation with".
+ * - Thread answers "which run/timeline/place does this message belong to".
  *
  * Storage structure:
- * - Location: /.data/chat/{chat}/{yyyy}/{MM}/{dd}/messages.ttl#{id}
+ * - Location: /.data/chat/{chat|id}/{yyyy}/{MM}/{dd}/messages.ttl#{id}
  * - Date-based path for efficient time-range queries
  * - chat/thread are RDF URI relations. Short ids remain accepted at API/query call sites via ORM URI template resolution.
  */
-export const messageTable = podTable('chat_message', {
+export const messageResource = podTable('chat_message', {
     id: id('id'),
     // Chat relation. In RDF this is an inverse Solid Chat link: <chat> wf:message <message>.
-    chat: uri('chat').predicate(WF.message).inverse().notNull().link('chats'),
+    chat: uri('chat').predicate(WF.message).inverse().notNull().link(chatResource),
     // Thread relation. In RDF this is an inverse Solid Chat/SIOC link: <thread> sioc:has_member <message>.
-    thread: uri('thread').predicate(SIOC.has_member).inverse().notNull().link(threadTable),
+    thread: uri('thread').predicate(SIOC.has_member).inverse().notNull().link(threadResource),
     // maker is the entity URI of the message author:
     // - User: their WebID (https://user.pod/profile/card#me)
     // - AI: Agent URI (/.data/agents/{id}.ttl#this)
@@ -43,5 +49,7 @@ export const messageTable = podTable('chat_message', {
     sparqlEndpoint: '/.data/chat/-/sparql',
     type: MEETING.Message,
     namespace: UDFS,
-    subjectTemplate: '{chat}/{yyyy}/{MM}/{dd}/messages.ttl#{id}',
+    subjectTemplate: '{chat|id}/{yyyy}/{MM}/{dd}/messages.ttl#{id}',
 });
+// Compatibility alias. New model code should prefer `messageResource`.
+export const messageTable = messageResource;

package/dist/profile.d.ts

@@ -1,7 +1,6 @@
 import type { SolidProfileRow } from "./profile.schema.js";
 import { type SolidProfileIdentity } from "./profile.repository.js";
 export { pickSolidProfileDisplayName, profileRepository, type SolidProfileIdentity, } from "./profile.repository.js";
-type NodeRequire = (id: string) => unknown;
 export interface SolidProfileSessionLike {
     info?: {
         webId?: string;
@@ -12,11 +11,19 @@ export interface SolidProfileReader<TTable = unknown> {
     findByIri(table: TTable, iri: string): Promise<unknown | null>;
 }
 export declare function createSolidProfileDatabase(session: unknown): Promise<SolidProfileReader>;
-export declare function applySolidProfileComunicaPatches(requireModule?: NodeRequire): Promise<boolean>;
+export declare function applySolidProfileComunicaPatches(): boolean;
 export declare function resolveSolidProfile(db: SolidProfileReader, webId: string): Promise<SolidProfileRow | null>;
 export declare function resolveSolidProfileWithTable<TTable>(db: SolidProfileReader<TTable>, webId: string, table: TTable): Promise<SolidProfileRow | null>;
 export declare function resolveSolidProfileDisplayName(db: SolidProfileReader, webId: string): Promise<string | null>;
 export declare function resolveSolidProfileIdentityWithReader(db: SolidProfileReader, webId: string): Promise<SolidProfileIdentity | null>;
+export declare function resolveSolidProfileIdentityFromWebIdDocument(session: SolidProfileSessionLike, options?: {
+    webId?: string;
+}): Promise<SolidProfileIdentity | null>;
 export declare function resolveSolidProfileIdentity(session: SolidProfileSessionLike, options?: {
     webId?: string;
 }): Promise<SolidProfileIdentity | null>;
+export declare function parseSolidProfileDocument(source: string, options: {
+    contentType?: string;
+    profileDocumentUrl: string;
+    webId: string;
+}): Promise<SolidProfileRow | null>;