@undefineds.co/xpod 0.3.6 → 0.3.15

package/dist/api/chatkit/pod-store.js

@@ -268,12 +268,12 @@ class PodChatKitStore {
         const match = chatId.match(/^([^/]+)\/index\.ttl#this$/);
         return match ? decodeURIComponent(match[1]) : undefined;
     }
-    chatSurfaceIdFromIri(chatIri) {
-        if (!chatIri) {
+    chatSurfaceIdFromResource(chat) {
+        if (!chat) {
             return undefined;
         }
         try {
-            const url = new URL(chatIri);
+            const url = new URL(chat);
             const match = url.pathname.match(/\/\.data\/chat\/([^/]+)\/index\.ttl$/);
             if (match && url.hash === '#this') {
                 return decodeURIComponent(match[1]);
@@ -282,7 +282,7 @@ class PodChatKitStore {
         catch {
             // Fall through to base-relative parsing.
         }
-        return this.chatSurfaceIdFromResourceId(chatIri);
+        return this.chatSurfaceIdFromResourceId(chat);
     }
     /**
      * 确保 Chat 容器存在，如果不存在则创建
@@ -315,9 +315,9 @@ class PodChatKitStore {
      * 将 ThreadRecord 转为 ThreadMetadata
      * ChatKit 边界继续暴露 metadata.chat_id；内部同一值叫 surface_id。
      */
-    threadRecordToMetadata(record, chatUriMap) {
+    threadRecordToMetadata(record, chatResourceMap) {
         const commandKind = record.commandKind === 'task' ? 'task' : 'chat';
-        const surfaceId = record.surfaceId || this.resolveChatSurfaceFromUri(record.chat, chatUriMap, PodChatKitStore.DEFAULT_CHAT_ID);
+        const surfaceId = record.surfaceId || this.resolveChatSurfaceFromResource(record.chat, chatResourceMap, PodChatKitStore.DEFAULT_CHAT_ID);
         const extra = this.parseJsonObject(record.metadata);
         return {
             id: record.id,
@@ -459,7 +459,7 @@ class PodChatKitStore {
         const { yyyy, MM, dd } = this.datePathFromTimestamp(input.createdAt);
         return `${input.commandKind}/${input.surfaceId}/${yyyy}/${MM}/${dd}/messages.ttl#${(0, store_1.extractResourceLocalId)(input.key)}`;
     }
-    resolveDataResourceUriFromId(resourceId, context) {
+    resolveDataResource(resourceId, context) {
         if (/^https?:\/\//.test(resourceId)) {
             return resourceId;
         }
@@ -468,23 +468,23 @@ class PodChatKitStore {
         if (!podBaseUrl) {
             throw new Error(`Cannot resolve Pod base URL for resource id: ${resourceId}`);
         }
-        return (0, store_1.resolveDataResourceIri)(podBaseUrl, resourceId);
+        return (0, store_1.resolveDataResource)(podBaseUrl, resourceId);
     }
-    baseRelativeIdFromSubjectUri(subjectUri, context) {
+    baseRelativeIdFromResource(resource, context) {
         const podBaseUrl = this.getCachedPodBaseUrl(context)
             ?? this.derivePodBaseUrl(this.getWebId(context));
         if (podBaseUrl) {
             const dataPrefix = `${podBaseUrl.replace(/\/$/, '')}/.data/`;
-            if (subjectUri.startsWith(dataPrefix)) {
-                return subjectUri.slice(dataPrefix.length);
+            if (resource.startsWith(dataPrefix)) {
+                return resource.slice(dataPrefix.length);
             }
         }
         const marker = '/.data/';
-        const markerIndex = subjectUri.indexOf(marker);
+        const markerIndex = resource.indexOf(marker);
         if (markerIndex >= 0) {
-            return subjectUri.slice(markerIndex + marker.length);
+            return resource.slice(markerIndex + marker.length);
         }
-        return subjectUri;
+        return resource;
     }
     runRecordToData(record) {
         return {
@@ -587,12 +587,12 @@ class PodChatKitStore {
         }
     }
     /**
-     * 获取或构建 Chat IRI -> surface id 的映射缓存。
-     * drizzle-solid 的 uri().link(Chat) 字段返回完整 URI，通过 Chat 的 @id 比对还原路径槽位。
+     * 获取或构建 Chat resource -> surface id 的映射缓存。
+     * drizzle-solid 的 link(Chat) 字段返回完整资源引用，通过 Chat 的 @id 比对还原路径槽位。
      */
-    async getChatUriMap(context) {
-        if (context._chatUriMap) {
-            return context._chatUriMap;
+    async getChatResourceMap(context) {
+        if (context._chatResourceMap) {
+            return context._chatResourceMap;
         }
         const db = await this.getDb(context);
         const map = new Map();
@@ -610,25 +610,25 @@ class PodChatKitStore {
                 // ignore
             }
         }
-        context._chatUriMap = map;
+        context._chatResourceMap = map;
         return map;
     }
     /**
-     * 从 Chat URI 还原 surface id。
+     * 从 Chat resource 还原 surface id。
      * 优先通过 @id 映射；若调用方本来给的是裸 ID，则原样使用。
      */
-    resolveChatSurfaceFromUri(chatUri, chatUriMap, defaultSurfaceId) {
-        if (!chatUri)
+    resolveChatSurfaceFromResource(chat, chatResourceMap, defaultSurfaceId) {
+        if (!chat)
             return defaultSurfaceId;
-        const bare = chatUriMap.get(chatUri);
+        const bare = chatResourceMap.get(chat);
         if (bare)
             return bare;
-        const parsed = this.chatSurfaceIdFromIri(chatUri);
+        const parsed = this.chatSurfaceIdFromResource(chat);
         if (parsed)
             return parsed;
-        return chatUri.includes('/') ? defaultSurfaceId : chatUri;
+        return chat.includes('/') ? defaultSurfaceId : chat;
     }
-    isAbsoluteHttpIri(value) {
+    isAbsoluteHttpResource(value) {
         try {
             const url = new URL(value);
             return url.protocol === 'http:' || url.protocol === 'https:';
@@ -637,9 +637,9 @@ class PodChatKitStore {
             return false;
         }
     }
-    parseThreadIri(threadIri) {
+    parseThreadResource(thread) {
         try {
-            const url = new URL(threadIri);
+            const url = new URL(thread);
             const match = url.pathname.match(/\/\.data\/(chat|task)\/([^/]+)\/index\.ttl$/);
             const localThreadId = url.hash.startsWith('#') ? decodeURIComponent(url.hash.slice(1)) : '';
             if (!match || !localThreadId) {
@@ -651,7 +651,7 @@ class PodChatKitStore {
                 threadId: `${commandKind}/${surfaceId}/index.ttl#${localThreadId}`,
                 commandKind,
                 surfaceId,
-                threadUri: url.toString(),
+                thread: url.toString(),
             };
         }
         catch {
@@ -675,41 +675,41 @@ class PodChatKitStore {
         };
     }
     async resolveThreadRef(thread, context) {
-        const threadIdOrIri = thread.thread_id;
-        if (this.isAbsoluteHttpIri(threadIdOrIri)) {
-            const parsed = this.parseThreadIri(threadIdOrIri);
+        const threadRef = thread.thread_id;
+        if (this.isAbsoluteHttpResource(threadRef)) {
+            const parsed = this.parseThreadResource(threadRef);
             if (!parsed) {
-                throw new Error(`Invalid thread IRI: ${threadIdOrIri}`);
+                throw new Error(`Invalid thread resource: ${threadRef}`);
             }
             this.cacheThreadSurfaceId(context, parsed.threadId, parsed.surfaceId);
             return parsed;
         }
-        const parsedResourceId = this.parseThreadResourceId(threadIdOrIri);
+        const parsedResourceId = this.parseThreadResourceId(threadRef);
         if (parsedResourceId) {
-            const threadUri = this.resolveDataResourceUriFromId(parsedResourceId.threadId, context);
+            const threadResource = this.resolveDataResource(parsedResourceId.threadId, context);
             this.cacheThreadSurfaceId(context, parsedResourceId.threadId, parsedResourceId.surfaceId);
             return {
                 ...parsedResourceId,
-                threadUri,
+                thread: threadResource,
             };
         }
         if (!('chat_id' in thread) || !thread.chat_id) {
-            throw new Error(`chat_id is required when thread_id "${threadIdOrIri}" is not a full thread resource id`);
+            throw new Error(`chat_id is required when thread_id "${threadRef}" is not a full thread resource id`);
         }
         const surfaceId = thread.chat_id;
         const commandKind = 'chat';
         const threadId = this.generateThreadResourceId({
-            key: threadIdOrIri,
+            key: threadRef,
             commandKind,
             surfaceId,
         });
-        const threadUri = this.resolveDataResourceUriFromId(threadId, context);
+        const threadResource = this.resolveDataResource(threadId, context);
         this.cacheThreadSurfaceId(context, threadId, surfaceId);
         return {
             threadId,
             commandKind,
             surfaceId,
-            threadUri,
+            thread: threadResource,
         };
     }
     /**
@@ -765,7 +765,7 @@ class PodChatKitStore {
       SELECT ?msg ?maker ?messageType ?legacyRole ?content ?messageStatus ?legacyStatus ?createdAt ?legacyCreatedAt ?toolName ?toolCallId ?metadata
       WHERE {
         ?msg a meeting:Message ;
-             sioc:has_container <${resolvedThread.threadUri}> .
+             sioc:has_container <${resolvedThread.thread}> .
         OPTIONAL { ?msg foaf:maker ?maker . }
         OPTIONAL { ?msg udfs:messageType ?messageType . }
         OPTIONAL { ?msg udfs:role ?legacyRole . }
@@ -795,9 +795,9 @@ class PodChatKitStore {
         const json = await response.json();
         const bindings = json.results?.bindings ?? [];
         return bindings.map((binding) => ({
-            id: this.baseRelativeIdFromSubjectUri(this.parseSparqlBindingValue(binding, 'msg') ?? '', context),
+            id: this.baseRelativeIdFromResource(this.parseSparqlBindingValue(binding, 'msg') ?? '', context),
             chat: null,
-            thread: resolvedThread.threadUri,
+            thread: resolvedThread.thread,
             maker: this.parseSparqlBindingValue(binding, 'maker'),
             role: this.parseSparqlBindingValue(binding, 'messageType') ?? this.parseSparqlBindingValue(binding, 'legacyRole'),
             content: this.parseSparqlBindingValue(binding, 'content'),
@@ -806,7 +806,7 @@ class PodChatKitStore {
             toolName: this.parseSparqlBindingValue(binding, 'toolName'),
             toolCallId: this.parseSparqlBindingValue(binding, 'toolCallId'),
             metadata: this.parseSparqlBindingValue(binding, 'metadata'),
-            subjectUri: this.parseSparqlBindingValue(binding, 'msg'),
+            resource: this.parseSparqlBindingValue(binding, 'msg'),
         }));
     }
     datePathFromTimestamp(timestamp) {
@@ -851,12 +851,12 @@ class PodChatKitStore {
             throw new Error('Cannot access Pod: invalid credentials');
         }
         const resolvedThread = await this.resolveThreadRef(thread, context);
-        const threadRecord = await db.findByIri(schema_1.Thread, resolvedThread.threadUri);
+        const threadRecord = await db.findByIri(schema_1.Thread, resolvedThread.thread);
         if (!threadRecord) {
             throw new Error(`Thread not found: ${resolvedThread.threadId}`);
         }
-        const chatUriMap = await this.getChatUriMap(context);
-        const metadata = this.threadRecordToMetadata(threadRecord, chatUriMap);
+        const chatResourceMap = await this.getChatResourceMap(context);
+        const metadata = this.threadRecordToMetadata(threadRecord, chatResourceMap);
         // 缓存结果
         this.cacheThreadMetadata(context, metadata);
         this.cacheThreadSurfaceId(context, metadata.id, resolvedThread.surfaceId);
@@ -892,12 +892,12 @@ class PodChatKitStore {
         });
         thread.id = threadResourceId;
         this.cacheThreadSurfaceId(context, thread.id, surfaceId);
-        const threadUri = this.resolveDataResourceUriFromId(threadResourceId, context);
+        const threadResource = this.resolveDataResource(threadResourceId, context);
         // 检查 Thread 是否存在
-        const existing = await db.findByIri(schema_1.Thread, threadUri);
+        const existing = await db.findByIri(schema_1.Thread, threadResource);
         if (existing) {
             // Update
-            await db.updateByIri(schema_1.Thread, threadUri, {
+            await db.updateByIri(schema_1.Thread, threadResource, {
                 commandKind,
                 surfaceId,
                 chat: commandKind === 'chat' ? this.buildChatResourceId(surfaceId) : null,
@@ -958,9 +958,9 @@ class PodChatKitStore {
             }
             const slice = threads.slice(startIndex, startIndex + limit);
             const hasMore = startIndex + limit < threads.length;
-            const chatUriMap = await this.getChatUriMap(context);
+            const chatResourceMap = await this.getChatResourceMap(context);
             return {
-                data: slice.map((t) => this.threadRecordToMetadata(t, chatUriMap)),
+                data: slice.map((t) => this.threadRecordToMetadata(t, chatResourceMap)),
                 has_more: hasMore,
                 after: slice.length > 0 ? slice[slice.length - 1].id : undefined,
             };
@@ -978,7 +978,7 @@ class PodChatKitStore {
         }
         // 删除关联到此 Thread 的消息
         try {
-            await db.delete(schema_1.Message).where((0, drizzle_solid_1.eq)(schema_1.Message.thread, resolvedThread.threadUri));
+            await db.delete(schema_1.Message).where((0, drizzle_solid_1.eq)(schema_1.Message.thread, resolvedThread.thread));
         }
         catch (err) {
             if (!err.message?.includes('404') && !err.message?.includes('Could not retrieve') && !err.message?.includes('Parse error')) {
@@ -988,7 +988,7 @@ class PodChatKitStore {
         }
         // 删除 Thread
         try {
-            await db.deleteByIri(schema_1.Thread, resolvedThread.threadUri);
+            await db.deleteByIri(schema_1.Thread, resolvedThread.thread);
         }
         catch (err) {
             if (!err.message?.includes('404') && !err.message?.includes('Could not retrieve') && !err.message?.includes('Parse error')) {
@@ -1097,7 +1097,7 @@ class PodChatKitStore {
             commandKind: resolvedThread.commandKind,
             surfaceId: resolvedThread.surfaceId,
             chat: resolvedThread.commandKind === 'chat' ? this.buildChatResourceId(resolvedThread.surfaceId) : null,
-            thread: resolvedThread.threadUri,
+            thread: resolvedThread.thread,
             maker: role === schema_1.MessageRole.USER ? webId : null,
             role,
             content,
@@ -1186,9 +1186,9 @@ class PodChatKitStore {
         if (!cachedFetch) {
             throw new Error('No cached session for direct PATCH - call getDb first');
         }
-        const subjectUri = this.resolveDataResourceUriFromId(messageResourceId, context);
-        const hashIndex = subjectUri.lastIndexOf('#');
-        const resourceUrl = hashIndex >= 0 ? subjectUri.slice(0, hashIndex) : subjectUri;
+        const messageResource = this.resolveDataResource(messageResourceId, context);
+        const hashIndex = messageResource.lastIndexOf('#');
+        const resourceUrl = hashIndex >= 0 ? messageResource.slice(0, hashIndex) : messageResource;
         // 构建 SPARQL UPDATE：删除旧值，插入新值
         const deletePatterns = [];
         const insertTriples = [];
@@ -1212,16 +1212,16 @@ class PodChatKitStore {
             return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
         };
         // Content 更新
-        deletePatterns.push(`<${subjectUri}> <http://rdfs.org/sioc/ns#content> ?oldContent .`);
-        insertTriples.push(`<${subjectUri}> <http://rdfs.org/sioc/ns#content> ${escapeForSparql(content)} .`);
+        deletePatterns.push(`<${messageResource}> <http://rdfs.org/sioc/ns#content> ?oldContent .`);
+        insertTriples.push(`<${messageResource}> <http://rdfs.org/sioc/ns#content> ${escapeForSparql(content)} .`);
         // Status 更新
         if (status) {
-            deletePatterns.push(`<${subjectUri}> <https://undefineds.co/ns#messageStatus> ?oldStatus .`);
-            insertTriples.push(`<${subjectUri}> <https://undefineds.co/ns#messageStatus> "${status}" .`);
+            deletePatterns.push(`<${messageResource}> <https://undefineds.co/ns#messageStatus> ?oldStatus .`);
+            insertTriples.push(`<${messageResource}> <https://undefineds.co/ns#messageStatus> "${status}" .`);
         }
         if (metadata) {
-            deletePatterns.push(`<${subjectUri}> <https://undefineds.co/ns#metadata> ?oldMetadata .`);
-            insertTriples.push(`<${subjectUri}> <https://undefineds.co/ns#metadata> ${escapeForSparql(JSON.stringify(metadata))} .`);
+            deletePatterns.push(`<${messageResource}> <https://undefineds.co/ns#metadata> ?oldMetadata .`);
+            insertTriples.push(`<${messageResource}> <https://undefineds.co/ns#metadata> ${escapeForSparql(JSON.stringify(metadata))} .`);
         }
         const sparql = `
 DELETE { ${deletePatterns.join(' ')} }
@@ -1238,17 +1238,17 @@ WHERE { ${deletePatterns.join(' ')} }
             throw new Error(`Direct PATCH failed: ${response.status} ${response.statusText} - ${text}`);
         }
     }
-    async directDeleteMessage(context, subjectUri) {
-        if (!subjectUri) {
-            throw new Error('Cannot delete message without subject URI');
+    async directDeleteMessage(context, resource) {
+        if (!resource) {
+            throw new Error('Cannot delete message without resource');
         }
         const cachedFetch = context._cachedFetch;
         if (!cachedFetch) {
             throw new Error('No cached session for direct DELETE - call getDb first');
         }
-        const hashIndex = subjectUri.lastIndexOf('#');
-        const resourceUrl = hashIndex >= 0 ? subjectUri.slice(0, hashIndex) : subjectUri;
-        const sparql = `DELETE WHERE { <${subjectUri}> ?p ?o . }`;
+        const hashIndex = resource.lastIndexOf('#');
+        const resourceUrl = hashIndex >= 0 ? resource.slice(0, hashIndex) : resource;
+        const sparql = `DELETE WHERE { <${resource}> ?p ?o . }`;
         const response = await cachedFetch(resourceUrl, {
             method: 'PATCH',
             headers: { 'Content-Type': 'application/sparql-update' },
@@ -1278,7 +1278,7 @@ WHERE { ${deletePatterns.join(' ')} }
         if (!target) {
             return;
         }
-        await this.directDeleteMessage(context, target.subjectUri);
+        await this.directDeleteMessage(context, target.resource);
     }
     // =========================================================================
     // Attachment Operations (存 Pod 文件)
@@ -1402,7 +1402,7 @@ WHERE { ${deletePatterns.join(' ')} }
         if (!(0, store_1.isRunResourceId)(runId)) {
             throw new Error(`loadRunSteps requires a base-relative Run id: ${runId}`);
         }
-        // runId is a local query field; RunStep.run remains the semantic RDF URI relation.
+        // runId is a local query field; RunStep.run remains the semantic RDF relation.
         const records = await db.select().from(schema_2.RunStep).where((0, drizzle_solid_1.eq)(schema_2.RunStep.runId, runId));
         return records
             .map((record) => this.runStepRecordToData(record))
@@ -1590,7 +1590,7 @@ WHERE { ${deletePatterns.join(' ')} }
         }
         models.push(item);
     }
-    resolvePodResourceIri(context, resource) {
+    resolvePodResource(context, resource) {
         if (/^https?:\/\//.test(resource)) {
             return resource;
         }
@@ -1605,13 +1605,13 @@ WHERE { ${deletePatterns.join(' ')} }
         const candidates = new Set();
         candidates.add(providerRef);
         if (!/^https?:\/\//.test(providerRef)) {
-            candidates.add(this.resolvePodResourceIri(context, providerRef));
+            candidates.add(this.resolvePodResource(context, providerRef));
         }
         const providerId = (0, models_1.normalizeAIConfigProviderId)(providerRef);
         if (providerId) {
             candidates.add(providerId);
             candidates.add(`/settings/providers/${providerId}.ttl`);
-            candidates.add(this.resolvePodResourceIri(context, `/settings/providers/${providerId}.ttl`));
+            candidates.add(this.resolvePodResource(context, `/settings/providers/${providerId}.ttl`));
         }
         for (const candidate of candidates) {
             try {
@@ -1628,6 +1628,42 @@ WHERE { ${deletePatterns.join(' ')} }
         }
         return null;
     }
+    sortAiCredentialCandidates(credentials) {
+        return [...credentials].sort((left, right) => {
+            const defaultDelta = Number(this.isTruthyValue(right.isDefault)) - Number(this.isTruthyValue(left.isDefault));
+            if (defaultDelta !== 0) {
+                return defaultDelta;
+            }
+            const leftLastUsedAt = this.timestampValue(left.lastUsedAt);
+            const rightLastUsedAt = this.timestampValue(right.lastUsedAt);
+            if (leftLastUsedAt !== rightLastUsedAt) {
+                return leftLastUsedAt - rightLastUsedAt;
+            }
+            const leftFailCount = typeof left.failCount === 'number' && Number.isFinite(left.failCount) ? left.failCount : 0;
+            const rightFailCount = typeof right.failCount === 'number' && Number.isFinite(right.failCount) ? right.failCount : 0;
+            if (leftFailCount !== rightFailCount) {
+                return leftFailCount - rightFailCount;
+            }
+            return (0, models_1.normalizeAIConfigResourceId)(left.id ?? '')
+                .localeCompare((0, models_1.normalizeAIConfigResourceId)(right.id ?? ''));
+        });
+    }
+    isTruthyValue(value) {
+        return value === true || value === 'true' || value === 1 || value === '1';
+    }
+    timestampValue(value) {
+        if (value instanceof Date) {
+            return value.getTime();
+        }
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            return value;
+        }
+        if (typeof value === 'string' && value.trim()) {
+            const timestamp = Date.parse(value);
+            return Number.isFinite(timestamp) ? timestamp : 0;
+        }
+        return 0;
+    }
     async getAiConfig(context) {
         const db = await this.getDb(context);
         if (!db) {
@@ -1641,8 +1677,8 @@ WHERE { ${deletePatterns.join(' ')} }
             if (credentials.length === 0) {
                 return undefined;
             }
-            // 遍历凭据，找到有效的 Provider
-            for (const cred of credentials) {
+            // Select deterministically; RDF document serialization order is not config semantics.
+            for (const cred of this.sortAiCredentialCandidates(credentials)) {
                 if (!cred.provider)
                     continue;
                 const provider = await this.findProviderForCredential(db, context, cred.provider);