@undefineds.co/xpod 0.4.25 → 0.4.27

package/node_modules/@undefineds.co/ai-connections/dist/AiSortableCredentialList.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useLayoutEffect, useRef, useState } from 'react';
-import { cn } from '@undefineds.co/shared-ui';
+import { cn, interactiveFocusClass, ListSurface } from '@undefineds.co/shared-ui';
 import { GripVertical } from 'lucide-react';
 import { credentialDisplayLabel } from './credential-labels.js';
 export function AiSortableCredentialList({ credentials, disabled, onMove, children }) {
@@ -133,64 +133,64 @@ export function AiSortableCredentialList({ credentials, disabled, onMove, childr
             row.style.transform = `translateY(${shift}px)`;
         });
     };
-    return (_jsxs("div", { ref: listRef, className: cn(credentials.length > 0 && 'rounded-xl border border-border/70'), children: [_jsx("span", { className: "sr-only", role: "status", children: announcement }), credentials.map((credential, index) => (_jsx("div", { "data-sortable-credential": credential.id, className: "border-b border-border/60 first-of-type:rounded-t-xl last-of-type:rounded-b-xl last:border-b-0", children: children(credential, onMove ? (_jsx("button", { type: "button", disabled: unavailable, "aria-label": `拖动排序 ${credentialDisplayLabel(credential)}`, title: credentials.length < 2 ? '至少添加两条连接后可拖动排序' : '拖动调整优先级，或使用方向键、Home / End 排序', className: "flex h-8 w-6 shrink-0 touch-none select-none items-center justify-center rounded text-muted-foreground hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary disabled:opacity-40 enabled:cursor-grab active:cursor-grabbing", onKeyDown: (event) => {
-                        if (event.key === 'Escape') {
-                            finish(false);
-                            return;
-                        }
-                        const next = event.key === 'ArrowUp' ? index - 1 : event.key === 'ArrowDown' ? index + 1
-                            : event.key === 'Home' ? 0 : event.key === 'End' ? credentials.length - 1 : undefined;
-                        if (next === undefined)
-                            return;
-                        event.preventDefault();
-                        move(index, next);
-                    }, onPointerDown: (event) => {
-                        if (unavailable || event.button !== 0 || dragRef.current)
-                            return;
-                        event.preventDefault();
-                        dropRef.current = null;
-                        clearMotion();
-                        event.currentTarget.focus();
-                        event.currentTarget.setPointerCapture?.(event.pointerId);
-                        const elements = rows();
-                        const reduced = window.matchMedia?.('(prefers-reduced-motion: reduce)').matches ?? false;
-                        dragRef.current = { id: credential.id, from: index, to: index, pointerId: event.pointerId,
-                            startY: event.clientY, y: event.clientY, handle: event.currentTarget, rows: elements,
-                            rects: elements.map((row) => row.getBoundingClientRect()) };
-                        for (const [rowIndex, row] of elements.entries()) {
-                            row.style.willChange = 'transform';
-                            row.style.transition = reduced || rowIndex === index ? 'none' : 'transform 160ms ease-out';
-                            if (rowIndex === index) {
-                                row.dataset.dragging = 'true';
-                                row.style.position = 'relative';
-                                row.style.zIndex = '10';
-                                row.style.boxShadow = '0 8px 24px rgb(0 0 0 / 0.18)';
-                                row.style.backgroundColor = 'hsl(var(--card))';
+    return (_jsx(ListSurface, { asChild: true, ref: listRef, className: cn('divide-y-0 bg-transparent', credentials.length > 0 ? 'border-border/70' : 'border-0 rounded-none'), children: _jsxs("div", { children: [_jsx("span", { className: "sr-only", role: "status", children: announcement }), credentials.map((credential, index) => (_jsx("div", { "data-sortable-credential": credential.id, className: "border-b border-border/60 first-of-type:rounded-t-xl last-of-type:rounded-b-xl last:border-b-0", children: children(credential, onMove ? (_jsx("button", { type: "button", disabled: unavailable, "aria-label": `拖动排序 ${credentialDisplayLabel(credential)}`, title: credentials.length < 2 ? '至少添加两条连接后可拖动排序' : '拖动调整优先级，或使用方向键、Home / End 排序', className: cn('flex h-8 w-6 shrink-0 touch-none select-none items-center justify-center rounded text-muted-foreground hover:text-foreground disabled:opacity-40 enabled:cursor-grab active:cursor-grabbing', interactiveFocusClass), onKeyDown: (event) => {
+                            if (event.key === 'Escape') {
+                                finish(false);
+                                return;
                             }
-                        }
-                    }, onPointerMove: (event) => {
-                        const drag = dragRef.current;
-                        if (!drag || drag.pointerId !== event.pointerId || unavailable)
-                            return;
-                        drag.y = event.clientY;
-                        let distance = Infinity;
-                        drag.rects.forEach((rect, rowIndex) => {
-                            const delta = Math.abs(event.clientY - (rect.top + rect.bottom) / 2);
-                            if (delta < distance) {
-                                distance = delta;
-                                drag.to = rowIndex;
+                            const next = event.key === 'ArrowUp' ? index - 1 : event.key === 'ArrowDown' ? index + 1
+                                : event.key === 'Home' ? 0 : event.key === 'End' ? credentials.length - 1 : undefined;
+                            if (next === undefined)
+                                return;
+                            event.preventDefault();
+                            move(index, next);
+                        }, onPointerDown: (event) => {
+                            if (unavailable || event.button !== 0 || dragRef.current)
+                                return;
+                            event.preventDefault();
+                            dropRef.current = null;
+                            clearMotion();
+                            event.currentTarget.focus();
+                            event.currentTarget.setPointerCapture?.(event.pointerId);
+                            const elements = rows();
+                            const reduced = window.matchMedia?.('(prefers-reduced-motion: reduce)').matches ?? false;
+                            dragRef.current = { id: credential.id, from: index, to: index, pointerId: event.pointerId,
+                                startY: event.clientY, y: event.clientY, handle: event.currentTarget, rows: elements,
+                                rects: elements.map((row) => row.getBoundingClientRect()) };
+                            for (const [rowIndex, row] of elements.entries()) {
+                                row.style.willChange = 'transform';
+                                row.style.transition = reduced || rowIndex === index ? 'none' : 'transform 160ms ease-out';
+                                if (rowIndex === index) {
+                                    row.dataset.dragging = 'true';
+                                    row.style.position = 'relative';
+                                    row.style.zIndex = '10';
+                                    row.style.boxShadow = '0 8px 24px rgb(0 0 0 / 0.18)';
+                                    row.style.backgroundColor = 'hsl(var(--card))';
+                                }
                             }
-                        });
-                        if (frameRef.current === undefined)
-                            frameRef.current = requestAnimationFrame(paintDrag);
-                    }, onPointerUp: (event) => {
-                        if (dragRef.current?.pointerId === event.pointerId)
-                            finish(true);
-                    }, onPointerCancel: (event) => {
-                        if (dragRef.current?.pointerId === event.pointerId)
-                            finish(false);
-                    }, onLostPointerCapture: (event) => {
-                        if (dragRef.current?.pointerId === event.pointerId)
-                            finish(false);
-                    }, children: _jsx(GripVertical, { "aria-hidden": "true", className: "h-4 w-4" }) })) : null) }, credential.id)))] }));
+                        }, onPointerMove: (event) => {
+                            const drag = dragRef.current;
+                            if (!drag || drag.pointerId !== event.pointerId || unavailable)
+                                return;
+                            drag.y = event.clientY;
+                            let distance = Infinity;
+                            drag.rects.forEach((rect, rowIndex) => {
+                                const delta = Math.abs(event.clientY - (rect.top + rect.bottom) / 2);
+                                if (delta < distance) {
+                                    distance = delta;
+                                    drag.to = rowIndex;
+                                }
+                            });
+                            if (frameRef.current === undefined)
+                                frameRef.current = requestAnimationFrame(paintDrag);
+                        }, onPointerUp: (event) => {
+                            if (dragRef.current?.pointerId === event.pointerId)
+                                finish(true);
+                        }, onPointerCancel: (event) => {
+                            if (dragRef.current?.pointerId === event.pointerId)
+                                finish(false);
+                        }, onLostPointerCapture: (event) => {
+                            if (dragRef.current?.pointerId === event.pointerId)
+                                finish(false);
+                        }, children: _jsx(GripVertical, { "aria-hidden": "true", className: "h-4 w-4" }) })) : null) }, credential.id)))] }) }));
 }

package/node_modules/@undefineds.co/ai-connections/dist/collection-runtime.js

@@ -188,7 +188,9 @@ export function collectionCredentialMutations(credentials, store) {
             const before = collection.get(key);
             if (Object.keys(patch).length > 0)
                 await updateCredentialRow(collection, key, patch);
+            // Replacement secrets belong only to store completion, never to projected rows.
             const attributes = {
+                ...(input.apiKey === undefined ? {} : { apiKey: input.apiKey }),
                 ...(input.priority === undefined ? {} : { priority: input.priority }),
                 ...(input.baseUrl === undefined ? {} : { baseUrl: input.baseUrl }),
                 ...(input.proxyUrl === undefined ? {} : { proxyUrl: input.proxyUrl }),

package/node_modules/@undefineds.co/ai-connections/dist/collections.js

@@ -105,6 +105,10 @@ export function credentialSummaryFromRow(row, provider, carrier) {
         enabled: status === undefined ? carrier?.enabled ?? true : status === 'active',
         priority: carrier?.priority ?? 100,
         health: reauthRequired ? 'expired' : carrier?.health ?? 'unknown',
+        lastFailureCode: stringValue(row.lastFailureCode),
+        lastFailureAt: isoStringValue(row.lastFailureAt),
+        rateLimitResetAt: isoStringValue(row.rateLimitResetAt),
+        failCount: numberValue(row.failCount),
         maskedHint: carrier?.maskedHint,
         baseUrl: carrier?.baseUrl,
         proxyUrl: carrier?.proxyUrl,
@@ -115,7 +119,7 @@ export function credentialSummaryFromRow(row, provider, carrier) {
 }
 /** The provider's credential list, rebuilt from the live rows of one table document. */
 export function credentialSummariesForProvider(provider, rows, carrier = []) {
-    const byId = new Map(carrier.map((credential) => [credential.id, credential]));
+    const byId = new Map(carrier.map((credential) => [credentialResource.buildId({ id: credential.id }), credential]));
     const summaries = [];
     for (const row of rows) {
         if (providerOfCredentialRow(row) !== provider)
@@ -137,11 +141,15 @@ export function credentialCarriers(storeProducts, overlayProducts) {
     const carriers = {};
     for (const provider of AI_CONNECTIONS_PROVIDERS) {
         const byId = new Map();
-        for (const credential of overlayProducts[provider]?.credentials ?? []) {
-            byId.set(credential.id, credential);
-        }
-        for (const credential of storeProducts[provider]?.credentials ?? []) {
-            byId.set(credential.id, credential);
+        for (const credential of [
+            ...(storeProducts[provider]?.credentials ?? []),
+            ...(overlayProducts[provider]?.credentials ?? []),
+        ]) {
+            const id = credentialResource.buildId({ id: credential.id });
+            const current = byId.get(id);
+            // Each persisted mutation advances the version; a later store echo can supersede it.
+            if (!current || credential.version >= current.version)
+                byId.set(id, credential);
         }
         carriers[provider] = [...byId.values()];
     }

package/node_modules/@undefineds.co/ai-connections/dist/contract/ai-connections-client.d.ts

@@ -11,7 +11,8 @@
  * parsers under `./client` are internal, and `export *` would publish them.
  */
 export { AI_CONNECTIONS_PROVIDERS } from './client/types.js';
-export type { AiConnectAttempt, AiConnectionBeginOptions, AiConnectionsClient, AiConnectionsCredential, AiConnectionsMode, AiConnectionsProvider, AiConnectStatus, AiGatewayModel, AiProviderAuthorizationMethod, AiProviderAuthorizationMethodId, AiProviderAuthorizationMethodsSummary, AiProviderConnectionSummary, AiProviderCredentialSummary, AiProviderOffering, AiProviderSummary, AiProviderSummaryStatus, AiQuotaSnapshot, AiQuotaWindow, CreateApiKeyCredentialInput, CreatedGatewayKey, CustomProviderModel, DiscoveredProviderModel, GatewayKeyRecord, ProviderModelDiscovery, TestProviderCredentialInput, UpdateProviderCredentialInput, } from './client/types.js';
+export { PLATFORM_MODEL_ROLES, matchesPlatformModelRole } from './client/gateway-model-roles.js';
+export type { AiConnectAttempt, AiConnectionBeginOptions, AiConnectionsClient, AiConnectionsCredential, AiConnectionsMode, AiConnectionsProvider, AiConnectStatus, AiGatewayModel, AiGatewayCatalogModel, AiProviderAuthorizationMethod, AiProviderAuthorizationMethodId, AiProviderAuthorizationMethodsSummary, AiProviderConnectionSummary, AiProviderCredentialSummary, AiProviderOffering, AiProviderSummary, AiProviderSummaryStatus, AiQuotaSnapshot, AiQuotaWindow, CreateApiKeyCredentialInput, CreatedGatewayKey, CustomProviderModel, DiscoveredProviderModel, GatewayKeyRecord, ProviderModelDiscovery, TestProviderCredentialInput, UpdateProviderCredentialInput, } from './client/types.js';
 export { AiConnectionsRequestError, aiConnectionsErrorCode, normalizeProxyUrl, redactProxyUrl, } from './client/normalize.js';
 export { createAiConnectionsClient, resolveAiConnectionsApiBase } from './client/request.js';
 /**

package/node_modules/@undefineds.co/ai-connections/dist/contract/ai-connections-client.js

@@ -11,6 +11,7 @@
  * parsers under `./client` are internal, and `export *` would publish them.
  */
 export { AI_CONNECTIONS_PROVIDERS } from './client/types.js';
+export { PLATFORM_MODEL_ROLES, matchesPlatformModelRole } from './client/gateway-model-roles.js';
 export { AiConnectionsRequestError, aiConnectionsErrorCode, normalizeProxyUrl, redactProxyUrl, } from './client/normalize.js';
 export { createAiConnectionsClient, resolveAiConnectionsApiBase } from './client/request.js';
 /**

package/node_modules/@undefineds.co/ai-connections/dist/contract/client/gateway-model-roles.d.ts

@@ -0,0 +1,11 @@
+/** Platform routing roles published by the Gateway, independent of Pod model resources. */
+export declare const PLATFORM_MODEL_ROLES: {
+    readonly smart: {
+        readonly id: "linx";
+    };
+    readonly fast: {
+        readonly id: "linx-lite";
+    };
+};
+/** Match only the Gateway's published bare IDs or its existing protocol namespace. */
+export declare function matchesPlatformModelRole(modelId: string, role: keyof typeof PLATFORM_MODEL_ROLES): boolean;

package/node_modules/@undefineds.co/ai-connections/dist/contract/client/gateway-model-roles.js

@@ -0,0 +1,11 @@
+/** Platform routing roles published by the Gateway, independent of Pod model resources. */
+export const PLATFORM_MODEL_ROLES = {
+    smart: { id: 'linx' },
+    fast: { id: 'linx-lite' },
+};
+/** Match only the Gateway's published bare IDs or its existing protocol namespace. */
+export function matchesPlatformModelRole(modelId, role) {
+    const normalized = modelId.toLowerCase();
+    const id = PLATFORM_MODEL_ROLES[role].id;
+    return normalized === id || normalized === `undefineds/${id}`;
+}

package/node_modules/@undefineds.co/ai-connections/dist/contract/client/normalize.d.ts

@@ -1,4 +1,4 @@
-import type { AiConnectAttempt, AiConnectionsCredential, AiConnectionsProvider, AiGatewayModel, AiProviderAuthorizationMethodsSummary, AiProviderCredentialSummary, AiProviderSummary, CustomProviderModel, GatewayKeyRecord, ProviderModelDiscovery } from './types.js';
+import type { AiConnectAttempt, AiConnectionsCredential, AiConnectionsProvider, AiGatewayModel, AiGatewayCatalogModel, AiProviderAuthorizationMethodsSummary, AiProviderCredentialSummary, AiProviderSummary, CustomProviderModel, GatewayKeyRecord, ProviderModelDiscovery } from './types.js';
 /**
  * Everything that turns untrusted API payloads, user input and failures into the
  * shapes the rest of the app can rely on: proxy/pod URL normalising, error text,
@@ -41,6 +41,7 @@ export declare function assertProvider(provider: string): asserts provider is Ai
 export declare function parseGatewayKeyRecord(value: unknown): GatewayKeyRecord | undefined;
 export declare function parseCustomModelList(value: unknown): CustomProviderModel[];
 export declare function parseGatewayModel(value: unknown): AiGatewayModel | undefined;
+export declare function parseGatewayCatalogModel(value: unknown): AiGatewayCatalogModel | undefined;
 export declare function parseProviderSummaries(values: unknown[]): AiProviderSummary[];
 export declare function parseAuthorizationMethodsSummary(value: unknown): AiProviderAuthorizationMethodsSummary | undefined;
 export declare function parseProviderCredentialSummary(value: unknown): AiProviderCredentialSummary | undefined;

package/node_modules/@undefineds.co/ai-connections/dist/contract/client/normalize.js

@@ -1,6 +1,7 @@
 import { PROVIDER_LABELS } from '../provider-catalog.js';
 import { AI_MODEL_CLASS } from '@undefineds.co/models';
 import { AI_CONNECTIONS_PROVIDERS } from './types.js';
+import { PLATFORM_MODEL_ROLES, matchesPlatformModelRole } from './gateway-model-roles.js';
 /**
  * Everything that turns untrusted API payloads, user input and failures into the
  * shapes the rest of the app can rely on: proxy/pod URL normalising, error text,
@@ -188,6 +189,15 @@ export function parseGatewayModel(value) {
         capabilities: modelCapabilitiesFromWire(value),
     });
 }
+export function parseGatewayCatalogModel(value) {
+    if (!isRecord(value) || typeof value.id !== 'string' || !value.id)
+        return undefined;
+    return compactObject({
+        id: value.id,
+        displayName: stringValue(value.displayName) ?? stringValue(value.display_name) ?? stringValue(value.name),
+        provider: stringValue(value.provider) ?? stringValue(value.providerId) ?? stringValue(value.owned_by),
+    });
+}
 function modalitiesFromWire(value, direction) {
     if (!isRecord(value))
         return undefined;
@@ -226,11 +236,8 @@ function modelCapabilitiesFromWire(value) {
     return capabilities.length > 0 ? capabilities : undefined;
 }
 function isPlatformModelId(modelId) {
-    const normalized = modelId.toLowerCase();
-    return normalized === 'linx'
-        || normalized === 'linx-lite'
-        || normalized === 'undefineds/linx'
-        || normalized === 'undefineds/linx-lite';
+    return Object.keys(PLATFORM_MODEL_ROLES)
+        .some(role => matchesPlatformModelRole(modelId, role));
 }
 function providerValue(value) {
     if (typeof value !== 'string')

package/node_modules/@undefineds.co/ai-connections/dist/contract/client/request.js

@@ -1,4 +1,4 @@
-import { AiConnectionsRequestError, assertProvider, compactObject, isDefined, isRecord, parseAuthorizationMethodsSummary, parseConnectAttempt, parseCredential, parseCustomModelList, parseGatewayKeyRecord, parseGatewayModel, parseModelDiscovery, parseProviderCredentialSummary, parseProviderSummaries, readJson, sanitizePublicObject, } from './normalize.js';
+import { AiConnectionsRequestError, assertProvider, compactObject, isDefined, isRecord, parseAuthorizationMethodsSummary, parseConnectAttempt, parseCredential, parseCustomModelList, parseGatewayKeyRecord, parseGatewayModel, parseGatewayCatalogModel, parseModelDiscovery, parseProviderCredentialSummary, parseProviderSummaries, readJson, sanitizePublicObject, } from './normalize.js';
 /**
  * The HTTP client itself: one factory over the Pod base URL and an authenticated
  * fetch, with every response normalised by `normalize.ts`.
@@ -37,8 +37,9 @@ export function createAiConnectionsClient({ webId, podBaseUrl, authenticatedFetc
         const payload = await request(`${providerPath(provider)}${path}`, method, body, { provider });
         return parseConnectAttempt(payload, provider);
     };
+    const requestGatewayModels = () => request('/v1/models', 'GET');
     const listGatewayModels = async () => {
-        const payload = await request('/v1/models', 'GET');
+        const payload = await requestGatewayModels();
         return Array.isArray(payload.data)
             ? payload.data.map(parseGatewayModel).filter(isDefined)
             : [];
@@ -72,6 +73,13 @@ export function createAiConnectionsClient({ webId, podBaseUrl, authenticatedFetc
         },
         listModels: listGatewayModels,
         listGatewayModels,
+        async listGatewayCatalogModels() {
+            const payload = await requestGatewayModels();
+            if (!isRecord(payload) || !Array.isArray(payload.data)) {
+                throw new Error('AI Connection returned an invalid Gateway model catalog response');
+            }
+            return payload.data.map(parseGatewayCatalogModel).filter(isDefined);
+        },
         async listGatewayKeys() {
             const payload = await request('/api/ai/gateway/keys', 'GET');
             return Array.isArray(payload.data)

package/node_modules/@undefineds.co/ai-connections/dist/contract/client/types.d.ts

@@ -106,6 +106,12 @@ export interface AiGatewayModel extends AiConnectionsModelSelection {
     outputModalities?: string[];
     capabilities?: string[];
 }
+/** Public Gateway directory entries can belong to a platform or an unknown provider. */
+export interface AiGatewayCatalogModel {
+    id: string;
+    displayName?: string;
+    provider?: string;
+}
 /**
  * What the provider's own model list said a model is.
  *
@@ -238,6 +244,8 @@ export interface CreateApiKeyCredentialInput {
     compatibility?: 'auto' | 'openai' | 'anthropic';
 }
 export interface UpdateProviderCredentialInput {
+    /** Nonempty replacement only; omission preserves the existing secret. */
+    apiKey?: string;
     expectedVersion: number;
     label?: string;
     enabled?: boolean;
@@ -273,6 +281,8 @@ export interface AiConnectionsClient {
     listModels(): Promise<AiGatewayModel[]>;
     /** Active Gateway routing projection, independent of a host's Pod catalog. */
     listGatewayModels?(): Promise<AiGatewayModel[]>;
+    /** Complete Gateway directory, including platform routing roles and unattributed entries. */
+    listGatewayCatalogModels?(): Promise<AiGatewayCatalogModel[]>;
     listGatewayKeys(): Promise<GatewayKeyRecord[]>;
     createGatewayKey(input: {
         name: string;

package/node_modules/@undefineds.co/ai-connections/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/ai-connections",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "private": false,
   "type": "module",
   "sideEffects": false,

package/node_modules/@undefineds.co/extension-sdk/dist/web.d.ts

@@ -115,6 +115,7 @@ export interface AiConnectionsPodStore {
     saveOAuthCredential?(provider: string, input: AiConnectionsOAuthCredential): Promise<unknown>;
     updateOAuthCredential?(provider: string, credentialId: string, expectedVersion: number, input: AiConnectionsOAuthCredential): Promise<unknown>;
     updateProviderCredential?(provider: string, credentialId: string, input: {
+        apiKey?: string;
         expectedVersion: number;
         label?: string;
         enabled?: boolean;

package/node_modules/@undefineds.co/extension-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/extension-sdk",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "private": false,
   "type": "module",
   "sideEffects": false,

package/node_modules/@undefineds.co/pod-collections/dist/index.cjs

@@ -216,6 +216,7 @@ function rowBelongsToDocument(descriptor, documentUrl, podUrl, row) {
 
 // src/mapping.ts
 var XSD = "http://www.w3.org/2001/XMLSchema#";
+var ABSOLUTE_URI = /^[a-z][a-z0-9+.-]*:/iu;
 function tableColumnPredicates(table) {
   const mapping = table.getMapping();
   const predicates = new Map;
@@ -403,6 +404,47 @@ function descriptorRowToColumnValues(descriptor, table, row, options) {
 function isUriArrayField(field) {
   return field.array === true && field.type === "uri";
 }
+function normalizeUriArray(value, document) {
+  return (Array.isArray(value) ? value : [value]).filter((item) => typeof item === "string" && item.length > 0).map((item) => ABSOLUTE_URI.test(item) ? item : new URL(item, document).toString());
+}
+function normalizeMutationRow(descriptor, table, row, options) {
+  const normalized = { ...row };
+  const record = descriptorRowToColumnValues(descriptor, table, row, { resourceId: options.resourceId });
+  const bindings = fieldBindings(descriptor, table);
+  const tables = new Set([table]);
+  for (const candidate of Object.values(options.database.schema ?? {})) {
+    if (candidate && typeof candidate === "object" && "config" in candidate && "columns" in candidate) {
+      tables.add(candidate);
+    }
+  }
+  const tableNameRegistry = new Map;
+  const tableRegistry = new Map;
+  for (const entry of tables) {
+    tableNameRegistry.set(entry.config.name, entry);
+    const type = entry.getType();
+    tableRegistry.set(type, [...tableRegistry.get(type) ?? [], entry]);
+  }
+  for (const [field, binding] of bindings) {
+    const value = normalized[field];
+    if (binding.descriptor.type !== "uri" || value === undefined || value === null)
+      continue;
+    if (binding.descriptor.array) {
+      normalized[field] = normalizeUriArray(value, options.document);
+      continue;
+    }
+    if (!binding.column || typeof value !== "string" || !value || ABSOLUTE_URI.test(value))
+      continue;
+    const resolver = options.database.getDialect().getUriResolver();
+    normalized[field] = resolver.resolveLink(value, table.columns[binding.column], {
+      baseUri: options.podUrl,
+      tableRegistry,
+      tableNameRegistry,
+      currentTable: table,
+      record
+    });
+  }
+  return normalized;
+}
 
 // src/read.ts
 async function selectSubjectRows(table, database) {
@@ -609,21 +651,14 @@ function reconcilePendingWrites(pending, next, hashOf, writeOnly = EMPTY_WRITE_O
   }
 }
 var EMPTY_WRITE_ONLY = new Set;
-function absoluteUri(value, base) {
-  if (typeof value !== "string" || value.length === 0)
-    return;
-  if (/^[a-z][a-z0-9+.-]*:/iu.test(value))
-    return value;
-  return new URL(value, base).toString();
-}
 async function writeField(context, fieldName, options) {
   const field = context.descriptor.fields[fieldName];
   if (!field || !isUriArrayField(field)) {
     throw new PodCollectionError("write_field_not_uri_array", `field ${fieldName} is not array+uri; it must go through the ORM`);
   }
   const documentUrl = documentOfIri(context.document);
-  const previous = (Array.isArray(options.previous) ? options.previous : [options.previous]).map((value) => absoluteUri(value, documentUrl)).filter((value) => value !== undefined);
-  const next = (Array.isArray(options.next) ? options.next : [options.next]).map((value) => absoluteUri(value, documentUrl)).filter((value) => value !== undefined);
+  const previous = normalizeUriArray(options.previous, documentUrl);
+  const next = normalizeUriArray(options.next, documentUrl);
   const triples = (iris) => iris.map((iri) => `<${options.subjectIri}> <${field.predicate}> <${iri}> .`).join(`
 `);
   const operations = [
@@ -669,10 +704,16 @@ function createMutationHandlers(context) {
   return {
     onInsert: async ({ transaction }) => {
       for (const mutation of transaction.mutations) {
-        const row = mutation.modified;
         const key = String(mutation.key);
         const resourceId = resourceIdForRow(descriptor, context.document, context.podUrl, key);
         const subjectIri = subjectIriForRow(descriptor, context.document, key);
+        const row = normalizeMutationRow(descriptor, table, mutation.modified, {
+          database: context.database,
+          podUrl: context.podUrl,
+          document: context.document,
+          resourceId
+        });
+        Object.assign(mutation.modified, row);
         pending.register({
           key,
           intent: row,
@@ -693,10 +734,16 @@ function createMutationHandlers(context) {
       for (const mutation of transaction.mutations) {
         const key = String(mutation.key);
         const original = mutation.original;
-        const modified = mutation.modified;
         const changes = mutation.changes;
         const resourceId = resourceIdForRow(descriptor, context.document, context.podUrl, key);
         const subjectIri = subjectIriForRow(descriptor, context.document, key);
+        const modified = normalizeMutationRow(descriptor, table, mutation.modified, {
+          database: context.database,
+          podUrl: context.podUrl,
+          document: context.document,
+          resourceId
+        });
+        Object.assign(mutation.modified, modified);
         const beforeHash = original && Object.keys(original).length > 0 ? hashOf(original) : undefined;
         pending.register({
           key,
@@ -706,13 +753,13 @@ function createMutationHandlers(context) {
         });
         await runWrite(key, async () => {
           const columnChanges = {};
-          for (const [field, value] of Object.entries(changes)) {
+          for (const field of Object.keys(changes)) {
             if (uriArrayFieldNames.has(field))
               continue;
             const column = columnOf(field);
             if (column === undefined)
               continue;
-            columnChanges[column] = value;
+            columnChanges[column] = modified[field];
           }
           if (Object.keys(columnChanges).length > 0) {
             const updated = await context.database.updateById(table, resourceId, columnChanges);

package/node_modules/@undefineds.co/pod-collections/dist/mapping.d.ts

@@ -1,4 +1,4 @@
-import type { AnyPodTable } from '@undefineds.co/drizzle-solid';
+import type { AnyPodTable, SolidDatabase } from '@undefineds.co/drizzle-solid';
 import type { PodModelDescriptor, PodModelFieldDescriptor } from '@undefineds.co/models';
 import type { PodSubjectRow, RowOf } from './types.js';
 /** RDF term（只覆盖本层会产生的两种）。 */
@@ -74,5 +74,20 @@ export declare function descriptorRowToColumnValues(descriptor: PodModelDescript
 }): Record<string, unknown>;
 /** 该字段是否走 §4.1 的 PATCH 旁路：`array: true` + `type: 'uri'`。 */
 export declare function isUriArrayField(field: PodModelFieldDescriptor): boolean;
+/** URI arrays use the existing document-relative PATCH representation. */
+export declare function normalizeUriArray(value: unknown, document: string): string[];
+/**
+ * The pending intent must use the same URI representation as the ORM's RDF read.
+ * Resolve declared scalar links with the current database's public resolver/schema;
+ * array links retain writeField's document-relative PATCH semantics.
+ */
+export declare function normalizeMutationRow<D extends PodModelDescriptor, R extends object>(descriptor: D, table: AnyPodTable, row: R, options: {
+    database: Pick<SolidDatabase, 'getDialect'> & {
+        schema?: Record<string, unknown>;
+    };
+    podUrl: string;
+    document: string;
+    resourceId: string;
+}): R;
 /** descriptor 里所有走 PATCH 旁路的字段。 */
 export declare function uriArrayFields(descriptor: PodModelDescriptor): string[];

package/node_modules/@undefineds.co/pod-collections/dist/mapping.js

@@ -19,6 +19,7 @@ import { rowKeyOf, rowKeyVariable } from './layout.js';
  * 交给 drizzle-solid 自己格式化。
  */
 const XSD = 'http://www.w3.org/2001/XMLSchema#';
+const ABSOLUTE_URI = /^[a-z][a-z0-9+.-]*:/iu;
 /** 表列 → 谓词（跳过 `@id` 虚列）。 */
 export function tableColumnPredicates(table) {
     const mapping = table.getMapping();
@@ -279,6 +280,56 @@ export function descriptorRowToColumnValues(descriptor, table, row, options) {
 export function isUriArrayField(field) {
     return field.array === true && field.type === 'uri';
 }
+/** URI arrays use the existing document-relative PATCH representation. */
+export function normalizeUriArray(value, document) {
+    return (Array.isArray(value) ? value : [value])
+        .filter((item) => typeof item === 'string' && item.length > 0)
+        .map(item => ABSOLUTE_URI.test(item) ? item : new URL(item, document).toString());
+}
+/**
+ * The pending intent must use the same URI representation as the ORM's RDF read.
+ * Resolve declared scalar links with the current database's public resolver/schema;
+ * array links retain writeField's document-relative PATCH semantics.
+ */
+export function normalizeMutationRow(descriptor, table, row, options) {
+    const normalized = { ...row };
+    const record = descriptorRowToColumnValues(descriptor, table, row, { resourceId: options.resourceId });
+    const bindings = fieldBindings(descriptor, table);
+    // Registries are derived only from the actual schema registered with this DB.
+    const tables = new Set([table]);
+    for (const candidate of Object.values(options.database.schema ?? {})) {
+        if (candidate && typeof candidate === 'object' && 'config' in candidate && 'columns' in candidate) {
+            tables.add(candidate);
+        }
+    }
+    const tableNameRegistry = new Map();
+    const tableRegistry = new Map();
+    for (const entry of tables) {
+        tableNameRegistry.set(entry.config.name, entry);
+        const type = entry.getType();
+        tableRegistry.set(type, [...(tableRegistry.get(type) ?? []), entry]);
+    }
+    for (const [field, binding] of bindings) {
+        const value = normalized[field];
+        if (binding.descriptor.type !== 'uri' || value === undefined || value === null)
+            continue;
+        if (binding.descriptor.array) {
+            normalized[field] = normalizeUriArray(value, options.document);
+            continue;
+        }
+        if (!binding.column || typeof value !== 'string' || !value || ABSOLUTE_URI.test(value))
+            continue;
+        const resolver = options.database.getDialect().getUriResolver();
+        normalized[field] = resolver.resolveLink(value, table.columns[binding.column], {
+            baseUri: options.podUrl,
+            tableRegistry,
+            tableNameRegistry,
+            currentTable: table,
+            record,
+        });
+    }
+    return normalized;
+}
 /** descriptor 里所有走 PATCH 旁路的字段。 */
 export function uriArrayFields(descriptor) {
     return Object.entries(descriptor.fields)