@undefineds.co/xpod 0.4.20 → 0.4.27

package/node_modules/@undefineds.co/models/dist/namespaces.js

@@ -256,6 +256,8 @@ export const UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
     observedAt: 'observedAt',
     lastUsedAt: 'lastUsedAt',
     failCount: 'failCount',
+    lastFailureCode: 'lastFailureCode',
+    lastFailureAt: 'lastFailureAt',
     rateLimitResetAt: 'rateLimitResetAt',
     authMode: 'authMode',
     // Which offering of a provider a credential uses (`api-platform`,
@@ -396,6 +398,7 @@ export const UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
     createdAt: 'createdAt',
     updatedAt: 'updatedAt',
     completedAt: 'completedAt',
+    dueAt: 'dueAt',
     nextRunAt: 'nextRunAt',
     lastRunAt: 'lastRunAt',
     lastTriggeredAt: 'lastTriggeredAt',

package/node_modules/@undefineds.co/models/dist/pod-storage-descriptor.d.ts

@@ -295,6 +295,16 @@ export declare const credentialDescriptor: PodModelDescriptorWithFields<{
         readonly predicate: string;
         readonly description: "Timestamp when the provider rate limit is expected to reset.";
     };
+    readonly lastFailureCode: {
+        readonly type: "string";
+        readonly predicate: string;
+        readonly description: "Stable credential failure category. No upstream response body or secret.";
+    };
+    readonly lastFailureAt: {
+        readonly type: "timestamp";
+        readonly predicate: string;
+        readonly description: "Time when the most recent credential failure was observed.";
+    };
     readonly oauthRefreshToken: {
         readonly type: "string";
         readonly predicate: string;
@@ -1817,6 +1827,21 @@ export declare const taskDescriptor: PodModelDescriptorWithFields<{
         readonly predicate: string;
         readonly description: "Priority.";
     };
+    readonly dueAt: {
+        readonly type: "timestamp";
+        readonly predicate: string;
+        readonly description: "Deadline, independent of execution scheduling.";
+    };
+    readonly completedAt: {
+        readonly type: "timestamp";
+        readonly predicate: string;
+        readonly description: "Time the task was completed.";
+    };
+    readonly notes: {
+        readonly type: "text";
+        readonly predicate: string;
+        readonly description: "User notes about the task.";
+    };
     readonly assignedTo: {
         readonly type: "uri";
         readonly predicate: string;
@@ -2695,6 +2720,16 @@ export declare const officialPodModelDescriptors: readonly [PodModelDescriptorWi
         readonly predicate: string;
         readonly description: "Timestamp when the provider rate limit is expected to reset.";
     };
+    readonly lastFailureCode: {
+        readonly type: "string";
+        readonly predicate: string;
+        readonly description: "Stable credential failure category. No upstream response body or secret.";
+    };
+    readonly lastFailureAt: {
+        readonly type: "timestamp";
+        readonly predicate: string;
+        readonly description: "Time when the most recent credential failure was observed.";
+    };
     readonly oauthRefreshToken: {
         readonly type: "string";
         readonly predicate: string;
@@ -3695,6 +3730,21 @@ export declare const officialPodModelDescriptors: readonly [PodModelDescriptorWi
         readonly predicate: string;
         readonly description: "Priority.";
     };
+    readonly dueAt: {
+        readonly type: "timestamp";
+        readonly predicate: string;
+        readonly description: "Deadline, independent of execution scheduling.";
+    };
+    readonly completedAt: {
+        readonly type: "timestamp";
+        readonly predicate: string;
+        readonly description: "Time the task was completed.";
+    };
+    readonly notes: {
+        readonly type: "text";
+        readonly predicate: string;
+        readonly description: "User notes about the task.";
+    };
     readonly assignedTo: {
         readonly type: "uri";
         readonly predicate: string;

package/node_modules/@undefineds.co/models/dist/pod-storage-descriptor.js

@@ -189,6 +189,16 @@ export const credentialDescriptor = definePodModelDescriptor({
             predicate: UDFS.rateLimitResetAt,
             description: 'Timestamp when the provider rate limit is expected to reset.',
         },
+        lastFailureCode: {
+            type: 'string',
+            predicate: UDFS.lastFailureCode,
+            description: 'Stable credential failure category. No upstream response body or secret.',
+        },
+        lastFailureAt: {
+            type: 'timestamp',
+            predicate: UDFS.lastFailureAt,
+            description: 'Time when the most recent credential failure was observed.',
+        },
         oauthRefreshToken: {
             type: 'string',
             predicate: UDFS.oauthRefreshToken,
@@ -257,6 +267,8 @@ export const credentialDescriptor = definePodModelDescriptor({
         'appliedAt',
         'failCount',
         'rateLimitResetAt',
+        'lastFailureCode',
+        'lastFailureAt',
         'oauthRefreshToken',
         'oauthAccessToken',
         'oauthExpiresAt',
@@ -1479,6 +1491,9 @@ export const taskDescriptor = definePodModelDescriptor({
         workspace: { type: 'uri', predicate: UDFS.workspace, required: true, description: 'Workspace URI.' },
         status: { type: 'string', predicate: UDFS.status, description: 'Task lifecycle status.' },
         priority: { type: 'string', predicate: UDFS.priority, description: 'Priority.' },
+        dueAt: { type: 'timestamp', predicate: UDFS.dueAt, description: 'Deadline, independent of execution scheduling.' },
+        completedAt: { type: 'timestamp', predicate: UDFS.completedAt, description: 'Time the task was completed.' },
+        notes: { type: 'text', predicate: DCTerms.description, description: 'User notes about the task.' },
         assignedTo: { type: 'uri', predicate: UDFS.assignedTo, description: 'Assignee WebID or agent URI.' },
         source: { type: 'uri', predicate: DCTerms.source, description: 'Source resource.' },
         metadata: { type: 'json', predicate: UDFS.metadata, description: 'Opaque adapter metadata.' },
@@ -1486,7 +1501,7 @@ export const taskDescriptor = definePodModelDescriptor({
     uniqueBy: ['id'],
     writableFields: [
         'title', 'instruction', 'prompt', 'issue', 'message', 'workspace',
-        'status', 'priority', 'assignedTo', 'source', 'metadata',
+        'status', 'priority', 'dueAt', 'completedAt', 'notes', 'assignedTo', 'source', 'metadata',
     ],
     mergePolicy: 'upsert',
     examples: [

package/node_modules/@undefineds.co/models/dist/schema.d.ts

@@ -184,6 +184,9 @@ export declare const solidResources: {
         workspace: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
         status: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
         priority: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+        dueAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+        completedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+        notes: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
         assignedTo: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         source: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         metadata: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"object", null, false, false>;
@@ -348,6 +351,8 @@ export declare const solidResources: {
         appliedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
         failCount: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"integer", null, false, true>;
         rateLimitResetAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+        lastFailureCode: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+        lastFailureAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
         oauthRefreshToken: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
         oauthAccessToken: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
         oauthExpiresAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
@@ -952,6 +957,9 @@ export declare const solidSchema: {
         workspace: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
         status: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
         priority: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+        dueAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+        completedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+        notes: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
         assignedTo: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         source: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         metadata: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"object", null, false, false>;
@@ -1078,6 +1086,8 @@ export declare const solidSchema: {
         appliedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
         failCount: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"integer", null, false, true>;
         rateLimitResetAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+        lastFailureCode: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+        lastFailureAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
         oauthRefreshToken: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
         oauthAccessToken: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
         oauthExpiresAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;

package/node_modules/@undefineds.co/models/dist/task.schema.d.ts

@@ -25,6 +25,9 @@ export declare const taskResource: import("@undefineds.co/drizzle-solid/dist/cor
     workspace: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
     status: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
     priority: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    dueAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    completedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    notes: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
     assignedTo: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     source: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     metadata: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"object", null, false, false>;
@@ -41,6 +44,9 @@ export declare const taskTable: import("@undefineds.co/drizzle-solid/dist/core/s
     workspace: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
     status: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
     priority: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    dueAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    completedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
+    notes: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
     assignedTo: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     source: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     metadata: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"object", null, false, false>;

package/node_modules/@undefineds.co/models/dist/task.schema.js

@@ -26,6 +26,9 @@ export const taskResource = podTable('task', {
     workspace: uri('workspace').predicate(UDFS.workspace).notNull(),
     status: string('status').predicate(UDFS.status).notNull().default(TaskStatus.OPEN),
     priority: string('priority').predicate(UDFS.priority),
+    dueAt: timestamp('dueAt').predicate(UDFS.dueAt),
+    completedAt: timestamp('completedAt').predicate(UDFS.completedAt),
+    notes: text('notes').predicate(DCTerms.description),
     assignedTo: uri('assignedTo').predicate(UDFS.assignedTo),
     source: uri('source').predicate(DCTerms.source),
     metadata: object('metadata').predicate(UDFS.metadata),

package/node_modules/@undefineds.co/models/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/models",
-  "version": "0.2.59",
+  "version": "0.2.60",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -97,7 +97,7 @@
     "test": "vitest run",
     "test:types": "tsc -p tsconfig.types.json",
     "test:dist-types": "node scripts/check-dist-types.mjs",
-    "test:ci": "tsc -p tsconfig.types.json && node scripts/check-dist-types.mjs && vitest run tests/ai-config.test.ts tests/ai-runtime-repository.test.ts tests/ai-runtime-schema.test.ts tests/ai-gateway-schema.test.ts tests/chat-project.test.ts tests/client.test.ts tests/contracts-chat-contact.contract.test.ts tests/discovery-vercel.test.ts tests/discovery.test.ts tests/issue-schema.test.ts tests/message-repository.test.ts tests/profile.test.ts tests/protocol-metadata.test.ts tests/repository.test.ts tests/resource-utils.test.ts tests/session-schema.test.ts tests/sidecar-events.contract.test.ts tests/resource-schema.test.ts tests/resource-id-defaults.test.ts tests/pod-storage-descriptor.test.ts tests/pod-storage-descriptor.types.test.ts tests/capture-schema.test.ts tests/udfs-cli.test.ts",
+    "test:ci": "tsc -p tsconfig.types.json && node scripts/check-dist-types.mjs && vitest run tests/ai-config.test.ts tests/ai-runtime-repository.test.ts tests/ai-runtime-schema.test.ts tests/ai-gateway-schema.test.ts tests/chat-project.test.ts tests/client.test.ts tests/contracts-chat-contact.contract.test.ts tests/discovery-vercel.test.ts tests/discovery.test.ts tests/issue-schema.test.ts tests/message-repository.test.ts tests/profile.test.ts tests/protocol-metadata.test.ts tests/repository.test.ts tests/resource-utils.test.ts tests/session-schema.test.ts tests/sidecar-events.contract.test.ts tests/resource-schema.test.ts tests/resource-id-defaults.test.ts tests/pod-storage-descriptor.test.ts tests/pod-storage-descriptor.types.test.ts tests/capture-schema.test.ts tests/udfs-cli.test.ts tests/task-todo-contract.test.ts tests/credential-failure-state.test.ts tests/approval-decision.test.ts",
     "test:pod": "dotenv -e ../linx-models/.env -- vitest run tests/pod.integration.test.ts"
   },
   "dependencies": {

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

@@ -39,28 +39,28 @@ var __export = (target, all) => {
 // src/index.ts
 var exports_src = {};
 __export(exports_src, {
-  writeOnlyFields: () => writeOnlyFields,
-  valueToTerm: () => valueToTerm,
-  tableColumnsWithoutDescriptorField: () => tableColumnsWithoutDescriptorField,
-  subjectIriForRow: () => subjectIriForRow,
-  stripVirtualProps: () => stripVirtualProps,
-  sessionFetchOf: () => sessionFetchOf,
-  rowKeyOf: () => rowKeyOf,
-  resourceIdForRow: () => resourceIdForRow,
-  resolveTableDocument: () => resolveTableDocument,
-  projectionHash: () => projectionHash,
-  projectionFieldOrder: () => projectionFieldOrder,
-  podCollectionInternals: () => podCollectionInternals,
-  mapSubjectRows: () => mapSubjectRows,
-  fieldBindings: () => fieldBindings,
-  descriptorFieldsWithoutColumn: () => descriptorFieldsWithoutColumn,
-  definePodCollection: () => definePodCollection,
-  conditionalDocumentRead: () => conditionalDocumentRead,
-  computeDocumentDiff: () => computeDocumentDiff,
-  coerceFieldValue: () => coerceFieldValue,
-  PodCollectionError: () => PodCollectionError,
+  DEFAULT_COALESCE_MS: () => DEFAULT_COALESCE_MS,
   DEFAULT_CONFIRM_RETRIES: () => DEFAULT_CONFIRM_RETRIES,
-  DEFAULT_COALESCE_MS: () => DEFAULT_COALESCE_MS
+  PodCollectionError: () => PodCollectionError,
+  coerceFieldValue: () => coerceFieldValue,
+  computeDocumentDiff: () => computeDocumentDiff,
+  conditionalDocumentRead: () => conditionalDocumentRead,
+  definePodCollection: () => definePodCollection,
+  descriptorFieldsWithoutColumn: () => descriptorFieldsWithoutColumn,
+  fieldBindings: () => fieldBindings,
+  mapSubjectRows: () => mapSubjectRows,
+  podCollectionInternals: () => podCollectionInternals,
+  projectionFieldOrder: () => projectionFieldOrder,
+  projectionHash: () => projectionHash,
+  resolveTableDocument: () => resolveTableDocument,
+  resourceIdForRow: () => resourceIdForRow,
+  rowKeyOf: () => rowKeyOf,
+  sessionFetchOf: () => sessionFetchOf,
+  stripVirtualProps: () => stripVirtualProps,
+  subjectIriForRow: () => subjectIriForRow,
+  tableColumnsWithoutDescriptorField: () => tableColumnsWithoutDescriptorField,
+  valueToTerm: () => valueToTerm,
+  writeOnlyFields: () => writeOnlyFields
 });
 module.exports = __toCommonJS(exports_src);
 var import_db = require("@tanstack/db");
@@ -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);
@@ -852,7 +899,7 @@ function createPodSync(options) {
     return task;
   }
   async function passOnce() {
-    const sync2 = await ensureParams();
+    const sync = await ensureParams();
     if (disposed)
       return;
     let read;
@@ -862,7 +909,7 @@ function createPodSync(options) {
       syncState = "degraded";
       if (!ready && !failureReported) {
         failureReported = true;
-        sync2.markError(error);
+        sync.markError(error);
       }
       return;
     }
@@ -870,9 +917,9 @@ function createPodSync(options) {
       lastEtag = read.etag;
     const rows = mapSubjectRows(descriptor, table, read.subjects);
     const next = new Map(rows.map((row) => [String(row.id), row]));
-    const presentKeys = [...sync2.collection.keys()].map((key) => String(key));
+    const presentKeys = [...sync.collection.keys()].map((key) => String(key));
     const knownHash = (key) => {
-      const entry = sync2.metadata?.row.get(key);
+      const entry = sync.metadata?.row.get(key);
       return entry?.hash;
     };
     const diff = computeDocumentDiff({
@@ -881,32 +928,32 @@ function createPodSync(options) {
       pendingKeys: pending.keys,
       knownHash,
       hashOf,
-      presentRow: (key) => sync2.collection.get(key)
+      presentRow: (key) => sync.collection.get(key)
     });
     if (diff.inserts.length + diff.updates.length + diff.deletes.length > 0) {
-      sync2.begin({ immediate: true });
+      sync.begin({ immediate: true });
       for (const entry of diff.inserts) {
-        sync2.write({ type: "insert", value: stripVirtualProps(entry.row) });
+        sync.write({ type: "insert", value: stripVirtualProps(entry.row) });
       }
       for (const entry of diff.updates) {
-        sync2.write({ type: "update", value: stripVirtualProps(entry.row) });
+        sync.write({ type: "update", value: stripVirtualProps(entry.row) });
       }
       for (const entry of diff.deletes) {
-        sync2.write({
+        sync.write({
           type: "delete",
           key: entry.key,
           value: stripVirtualProps(entry.row)
         });
       }
       for (const entry of [...diff.inserts, ...diff.updates]) {
-        sync2.metadata?.row.set(entry.key, { hash: hashOf(entry.row) });
+        sync.metadata?.row.set(entry.key, { hash: hashOf(entry.row) });
       }
-      await sync2.commit();
+      await sync.commit();
     }
     if (!ready) {
       ready = true;
       failureReported = false;
-      sync2.markReady();
+      sync.markReady();
     }
     reconcilePendingWrites(pending, next, hashOf, writeOnly);
     syncState = feedAvailable ? "live" : "unavailable";

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)