@undefineds.co/xpod 0.4.11 → 0.4.12

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

@@ -1,5 +1,23 @@
 import { AS, DCTerms, FOAF, MEETING, ODRL, RDF, SCHEMA, SIOC, UDFS, VCARD, WF } from './namespaces.js';
-export const credentialDescriptor = {
+/**
+ * Declares a descriptor while keeping the literal field map.
+ *
+ * Annotating a descriptor with `PodModelDescriptor` erases `fields` into
+ * `Record<string, PodModelFieldDescriptor>`: `keyof fields` collapses to
+ * `string | number` and every `type`/`array`/`secret` literal widens to its
+ * union. Consumers that derive row types from descriptors (a mapped type over
+ * `D['fields']`) then get an index signature, so a stale field name compiles and
+ * reads `undefined` at runtime. The `const F` type parameter is the whole
+ * point: declare with `definePodModelDescriptor({...})` and the literal keys,
+ * field types, and flags survive into the published `.d.ts`.
+ *
+ * Runtime behaviour is the identity function: the returned value is the same
+ * object the caller passed.
+ */
+export function definePodModelDescriptor(descriptor) {
+    return descriptor;
+}
+export const credentialDescriptor = definePodModelDescriptor({
     uri: UDFS.Credential,
     version: '1.0.0',
     source: 'official',
@@ -17,30 +35,34 @@ export const credentialDescriptor = {
             type: 'string',
             predicate: UDFS.term('id'),
             required: true,
-            description: 'Local credential id.',
+            description: 'Base-relative credential row id. Every credential in a provider pool keeps its own id.',
         },
-        service: {
+        provider: {
+            type: 'uri',
+            predicate: UDFS.provider,
+            references: { resource: 'provider', key: 'id' },
+            description: 'Provider resource URI this credential connects through, as a URI relation to the provider row.',
+        },
+        authMode: {
             type: 'string',
-            predicate: UDFS.service,
-            required: true,
-            description: 'Credential service grouping, for example ai or infra.',
+            predicate: UDFS.authMode,
+            description: 'Authentication mode such as apiKey, oauth, deviceCode, or console.',
         },
-        providerId: {
+        offeringId: {
             type: 'string',
-            predicate: UDFS.provider,
-            required: true,
-            description: 'Provider identifier such as openai or cloudflare.',
+            predicate: UDFS.offeringId,
+            description: 'Offering id this credential connects through. Offerings are catalog content, so this stays a plain attribute, not a relation.',
         },
-        secretType: {
+        service: {
             type: 'string',
-            predicate: UDFS.secretType,
+            predicate: UDFS.service,
             required: true,
-            description: 'Provider-specific secret kind such as api-key or tunnel-token.',
+            description: 'Credential service grouping, for example ai or infra.',
         },
-        label: {
+        status: {
             type: 'string',
-            predicate: UDFS.label,
-            description: 'User-facing credential label.',
+            predicate: UDFS.status,
+            description: 'Credential health status.',
         },
         apiKey: {
             type: 'string',
@@ -48,11 +70,6 @@ export const credentialDescriptor = {
             secret: true,
             description: 'Secret token or API key material.',
         },
-        authMode: {
-            type: 'string',
-            predicate: UDFS.authMode,
-            description: 'Authentication mode such as apiKey, oauth, deviceCode, or console.',
-        },
         storageMode: {
             type: 'string',
             predicate: UDFS.storageMode,
@@ -112,17 +129,112 @@ export const credentialDescriptor = {
             predicate: UDFS.reauthRequired,
             description: 'Whether this credential requires user reauthentication.',
         },
-        status: {
+        baseUrl: {
             type: 'string',
-            predicate: UDFS.status,
-            description: 'Credential health status.',
+            predicate: UDFS.baseUrl,
+            description: 'Provider API base URL recorded on the credential.',
+        },
+        proxyUrl: {
+            type: 'string',
+            predicate: UDFS.proxyUrl,
+            description: 'Proxy URL used for requests made with this credential.',
+        },
+        label: {
+            type: 'string',
+            predicate: UDFS.label,
+            description: 'User-facing credential label.',
+        },
+        isDefault: {
+            type: 'boolean',
+            predicate: UDFS.isDefault,
+            description: 'Whether this credential is the default credential for its provider.',
+        },
+        createdAt: {
+            type: 'timestamp',
+            predicate: DCTerms.created,
+            description: 'Creation timestamp, set by the store.',
+        },
+        lastUsedAt: {
+            type: 'timestamp',
+            predicate: UDFS.lastUsedAt,
+            description: 'Last successful use timestamp.',
+        },
+        clientCredentialId: {
+            type: 'string',
+            predicate: UDFS.clientCredentialId,
+            description: 'Client the issued credential belongs to. An external runtime identifier, not an RDF link.',
+        },
+        appliedTo: {
+            type: 'string',
+            predicate: UDFS.appliedTo,
+            description: 'Client application id the credential is in effect for. A runtime identifier, not an RDF link.',
+        },
+        appliedOn: {
+            type: 'string',
+            predicate: UDFS.appliedOn,
+            description: 'Device id that wrote the applied configuration. A runtime identifier, not an RDF link.',
+        },
+        appliedAt: {
+            type: 'timestamp',
+            predicate: UDFS.appliedAt,
+            description: 'Timestamp when the credential was applied.',
+        },
+        failCount: {
+            type: 'number',
+            predicate: UDFS.failCount,
+            description: 'Failed use count recorded for the credential.',
+        },
+        rateLimitResetAt: {
+            type: 'timestamp',
+            predicate: UDFS.rateLimitResetAt,
+            description: 'Timestamp when the provider rate limit is expected to reset.',
+        },
+        oauthRefreshToken: {
+            type: 'string',
+            predicate: UDFS.oauthRefreshToken,
+            secret: true,
+            description: 'OAuth refresh token.',
+        },
+        oauthAccessToken: {
+            type: 'string',
+            predicate: UDFS.oauthAccessToken,
+            secret: true,
+            description: 'OAuth access token.',
+        },
+        oauthExpiresAt: {
+            type: 'timestamp',
+            predicate: UDFS.oauthExpiresAt,
+            description: 'OAuth access token expiry timestamp.',
+        },
+        projectId: {
+            type: 'string',
+            predicate: UDFS.projectId,
+            description: 'Provider project identifier recorded for the credential.',
+        },
+        organizationId: {
+            type: 'string',
+            predicate: UDFS.organizationId,
+            description: 'Provider organization identifier recorded for the credential.',
+        },
+        metadata: {
+            type: 'json',
+            predicate: UDFS.metadata,
+            description: 'Opaque adapter-local metadata bag; shared relations must be explicit fields.',
         },
     },
-    uniqueBy: ['service', 'providerId', 'secretType'],
+    // A credential pool holds several credentials per provider and offering (one
+    // per account or key), so `service`, `provider`, and `offeringId` are not
+    // unique together, and `secretType` is a resolution hint rather than a column.
+    // The row id is the only column that identifies a credential, so it is the
+    // whole key here; provider and offering stay attributes of the credential.
+    uniqueBy: ['id'],
     writableFields: [
-        'label',
-        'apiKey',
+        'provider',
         'authMode',
+        'offeringId',
+        'service',
+        'status',
+        'apiKey',
         'storageMode',
         'secretPayload',
         'encryptedSecret',
@@ -134,29 +246,41 @@ export const credentialDescriptor = {
         'accountLabel',
         'lastRefreshAt',
         'reauthRequired',
-        'status',
+        'baseUrl',
+        'proxyUrl',
+        'label',
+        'isDefault',
+        'lastUsedAt',
+        'clientCredentialId',
+        'appliedTo',
+        'appliedOn',
+        'appliedAt',
+        'failCount',
+        'rateLimitResetAt',
+        'oauthRefreshToken',
+        'oauthAccessToken',
+        'oauthExpiresAt',
+        'projectId',
+        'organizationId',
+        'metadata',
     ],
     mergePolicy: 'upsert',
     examples: [
         {
             request: '保存 Cloudflare tunnel token',
             match: {
-                service: 'infra',
-                providerId: 'cloudflare',
-                secretType: 'tunnel-token',
+                id: 'cloudflare-5f2c9a1e',
             },
         },
         {
             request: '保存 OpenAI API key',
             match: {
-                service: 'ai',
-                providerId: 'openai',
-                secretType: 'api-key',
+                id: 'openai-2b7d4e10',
             },
         },
     ],
-};
-export const gatewayAccessKeyDescriptor = {
+});
+export const gatewayAccessKeyDescriptor = definePodModelDescriptor({
     uri: UDFS.GatewayAccessKey,
     version: '1.0.0',
     source: 'official',
@@ -218,16 +342,16 @@ export const gatewayAccessKeyDescriptor = {
             predicate: UDFS.lastUsedAt,
             description: 'Last successful Gateway use timestamp.',
         },
-        disabledAt: {
-            type: 'timestamp',
-            predicate: UDFS.disabledAt,
-            description: 'Temporary disable timestamp. Clear it to enable the key again.',
-        },
         revokedAt: {
             type: 'timestamp',
             predicate: UDFS.revokedAt,
             description: 'Revocation timestamp. Presence means the key is no longer valid.',
         },
+        disabledAt: {
+            type: 'timestamp',
+            predicate: UDFS.disabledAt,
+            description: 'Temporary disable timestamp. Clear it to enable the key again.',
+        },
     },
     uniqueBy: ['id'],
     writableFields: [
@@ -249,8 +373,8 @@ export const gatewayAccessKeyDescriptor = {
             match: { id: 'ai/gateway/access-keys.ttl#key_1' },
         },
     ],
-};
-export const quotaSnapshotDescriptor = {
+});
+export const quotaSnapshotDescriptor = definePodModelDescriptor({
     uri: UDFS.QuotaSnapshot,
     version: '1.0.0',
     source: 'official',
@@ -270,6 +394,7 @@ export const quotaSnapshotDescriptor = {
         credential: {
             type: 'uri',
             predicate: UDFS.credential,
+            references: { resource: 'credential', key: 'id' },
             required: true,
             description: 'Credential resource URI this quota snapshot describes.',
         },
@@ -340,8 +465,225 @@ export const quotaSnapshotDescriptor = {
             match: { id: 'ai/gateway/quota.ttl#quota_1' },
         },
     ],
-};
-export const approvalDescriptor = {
+});
+export const aiProviderDescriptor = definePodModelDescriptor({
+    uri: UDFS.Provider,
+    version: '1.0.0',
+    source: 'official',
+    trustLevel: 'high',
+    namespace: UDFS.NAMESPACE,
+    class: UDFS.Provider,
+    resourceKind: 'provider',
+    description: 'AI provider endpoint configured in the Pod: endpoint, proxy, console entry, backend support, and the models it exposes. Its model rows live in the same provider document and are linked from here through hasModel.',
+    // One document per provider: the table id default is `{key}.ttl` against the
+    // `/settings/providers/` base, so `buildId({ id: provider })` resolves to
+    // `<provider>.ttl` and its model rows are subjects inside that document.
+    storage: {
+        base: '/settings/providers/',
+        resourceIdPattern: '{key}.ttl',
+    },
+    fields: {
+        id: {
+            type: 'string',
+            predicate: UDFS.term('id'),
+            required: true,
+            description: 'Base-relative provider row id, for example openai.ttl.',
+        },
+        displayName: {
+            type: 'string',
+            predicate: UDFS.displayName,
+            description: 'Provider display name stored on the provider row.',
+        },
+        baseUrl: {
+            type: 'string',
+            predicate: UDFS.baseUrl,
+            description: 'Provider API base URL.',
+        },
+        proxyUrl: {
+            type: 'string',
+            predicate: UDFS.proxyUrl,
+            description: 'Proxy URL used for provider requests.',
+        },
+        homepage: {
+            type: 'string',
+            predicate: UDFS.homepage,
+            description: 'Provider homepage URL.',
+        },
+        apiKeyUrl: {
+            type: 'string',
+            predicate: UDFS.apiKeyUrl,
+            description: 'URL where a user creates an API key for this provider.',
+        },
+        connectMode: {
+            type: 'string',
+            predicate: UDFS.connectMode,
+            description: 'Connection mode recorded for the provider authorization method.',
+        },
+        hasModel: {
+            type: 'uri',
+            predicate: UDFS.hasModel,
+            references: { resource: 'ai-model', key: 'id' },
+            array: true,
+            description: 'Model rows this provider exposes, as subjects inside the provider document.',
+        },
+        defaultModel: {
+            type: 'uri',
+            predicate: UDFS.defaultModel,
+            references: { resource: 'ai-model', key: 'id' },
+            description: 'Default model for this provider when a request does not select one.',
+        },
+        supportsBackend: {
+            type: 'string',
+            predicate: UDFS.supportsBackend,
+            description: 'Backends this provider can serve, read as a backend list by the AI config selector.',
+        },
+        capabilities: {
+            type: 'string',
+            predicate: UDFS.capability,
+            array: true,
+            description: 'Provider capability tags.',
+        },
+        rotationPolicy: {
+            type: 'string',
+            predicate: UDFS.rotationPolicy,
+            description: 'Credential rotation policy recorded for the provider.',
+        },
+    },
+    uniqueBy: ['id'],
+    writableFields: [
+        'displayName',
+        'baseUrl',
+        'proxyUrl',
+        'homepage',
+        'apiKeyUrl',
+        'connectMode',
+        'hasModel',
+        'defaultModel',
+        'supportsBackend',
+        'capabilities',
+        'rotationPolicy',
+    ],
+    mergePolicy: 'upsert',
+    examples: [
+        {
+            request: 'Describe the provider document a Pod AI connection writes',
+            match: { id: 'openai.ttl' },
+        },
+    ],
+});
+export const aiModelDescriptor = definePodModelDescriptor({
+    uri: UDFS.AIModel,
+    version: '1.0.0',
+    source: 'official',
+    trustLevel: 'high',
+    namespace: UDFS.NAMESPACE,
+    class: UDFS.AIModel,
+    resourceKind: 'ai-model',
+    description: 'AI model exposed by a provider, stored as a subject inside that provider document. The provider relation and model capabilities are URI facts, while pricing and modality facts stay literals.',
+    // Model rows are subjects inside the provider document: the table id default
+    // is `{isProvidedBy.doc}#{key}` against the `/settings/providers/` base, so
+    // `buildId({ id: modelKey, isProvidedBy: providerIri })` resolves to
+    // `<provider>.ttl#<modelKey>`.
+    storage: {
+        base: '/settings/providers/',
+        resourceIdPattern: '{isProvidedBy.doc}#{key}',
+    },
+    fields: {
+        id: {
+            type: 'string',
+            predicate: UDFS.term('id'),
+            required: true,
+            description: 'Base-relative model row id: provider document plus model key, for example openai.ttl#gpt-4o.',
+        },
+        rdfType: {
+            type: 'uri',
+            predicate: RDF.type,
+            array: true,
+            description: 'RDF class of the model row. The base table defaults to AIModel, and subclass tables narrow it.',
+        },
+        displayName: {
+            type: 'string',
+            predicate: UDFS.displayName,
+            description: 'Model display name stored on the model row.',
+        },
+        isProvidedBy: {
+            type: 'uri',
+            predicate: UDFS.isProvidedBy,
+            references: { resource: 'provider', key: 'id' },
+            description: 'Provider document this model row belongs to, as a URI relation to the provider row.',
+        },
+        inputModalities: {
+            type: 'text',
+            predicate: UDFS.inputModality,
+            array: true,
+            description: 'Input modalities the model accepts.',
+        },
+        outputModalities: {
+            type: 'text',
+            predicate: UDFS.outputModality,
+            array: true,
+            description: 'Output modalities the model produces.',
+        },
+        runtimeCapabilities: {
+            type: 'string',
+            predicate: UDFS.capability,
+            array: true,
+            description: 'Adapter/runtime endpoint capabilities, kept separate from semantic model capabilities.',
+        },
+        capabilities: {
+            type: 'uri',
+            predicate: UDFS.hasCapability,
+            array: true,
+            description: 'Semantic capabilities of the model, as URIs.',
+        },
+        pricingInput: {
+            type: 'number',
+            predicate: UDFS.pricingInput,
+            description: 'Input token price recorded for the model.',
+        },
+        pricingOutput: {
+            type: 'number',
+            predicate: UDFS.pricingOutput,
+            description: 'Output token price recorded for the model.',
+        },
+        status: {
+            type: 'string',
+            predicate: UDFS.status,
+            description: 'Model availability status.',
+        },
+        createdAt: {
+            type: 'timestamp',
+            predicate: UDFS.createdAt,
+            description: 'Creation timestamp, set by the store.',
+        },
+        updatedAt: {
+            type: 'timestamp',
+            predicate: UDFS.updatedAt,
+            description: 'Last update timestamp.',
+        },
+    },
+    uniqueBy: ['id'],
+    writableFields: [
+        'displayName',
+        'isProvidedBy',
+        'inputModalities',
+        'outputModalities',
+        'runtimeCapabilities',
+        'capabilities',
+        'pricingInput',
+        'pricingOutput',
+        'status',
+        'updatedAt',
+    ],
+    mergePolicy: 'upsert',
+    examples: [
+        {
+            request: 'Describe a model row inside a provider document',
+            match: { id: 'openai.ttl#gpt-4o' },
+        },
+    ],
+});
+export const approvalDescriptor = definePodModelDescriptor({
     uri: UDFS.ApprovalRequest,
     version: '1.0.0',
     source: 'official',
@@ -370,11 +712,13 @@ export const approvalDescriptor = {
         chat: {
             type: 'uri',
             predicate: UDFS.conversation,
+            references: { resource: 'chat', key: 'id' },
             description: 'Related chat command surface.',
         },
         thread: {
             type: 'uri',
             predicate: UDFS.inThread,
+            references: { resource: 'thread', key: 'id' },
             description: 'Related concrete thread/work site.',
         },
         toolCallId: {
@@ -511,8 +855,8 @@ export const approvalDescriptor = {
             },
         },
     ],
-};
-export const inputRequestDescriptor = {
+});
+export const inputRequestDescriptor = definePodModelDescriptor({
     uri: UDFS.InputRequest,
     version: '1.0.0',
     source: 'official',
@@ -541,21 +885,25 @@ export const inputRequestDescriptor = {
         chat: {
             type: 'uri',
             predicate: UDFS.conversation,
+            references: { resource: 'chat', key: 'id' },
             description: 'Related chat command surface.',
         },
         thread: {
             type: 'uri',
             predicate: UDFS.inThread,
+            references: { resource: 'thread', key: 'id' },
             description: 'Related concrete thread/work site.',
         },
         run: {
             type: 'uri',
             predicate: UDFS.run,
+            references: { resource: 'run', key: 'id' },
             description: 'Run waiting for input.',
         },
         task: {
             type: 'uri',
             predicate: UDFS.task,
+            references: { resource: 'task', key: 'id' },
             description: 'Task whose execution requires input.',
         },
         requester: {
@@ -679,7 +1027,7 @@ export const inputRequestDescriptor = {
             },
         },
     ],
-};
+});
 function exactIdStorage(base = '/.data/') {
     return {
         base,
@@ -692,7 +1040,7 @@ const idField = {
     required: true,
     description: 'Base-relative resource id. For exact-id descriptors this includes the full document path and optional fragment.',
 };
-export const captureCandidateDescriptor = {
+export const captureCandidateDescriptor = definePodModelDescriptor({
     uri: UDFS.CaptureCandidate,
     version: '1.0.0',
     source: 'official',
@@ -712,10 +1060,10 @@ export const captureCandidateDescriptor = {
         reason: { type: 'text', predicate: UDFS.reason, description: 'Short rationale for why this source might be worth capturing.' },
         status: { type: 'string', predicate: UDFS.status, description: 'Candidate lifecycle status such as candidate, promoted, rejected, duplicate, ignored, or superseded.' },
         sourceHash: { type: 'string', predicate: UDFS.sourceHash, description: 'Optional source digest for duplicate detection.' },
-        chat: { type: 'uri', predicate: UDFS.conversation, description: 'Related chat command surface.' },
-        thread: { type: 'uri', predicate: UDFS.inThread, description: 'Related concrete thread/work site.' },
-        task: { type: 'uri', predicate: UDFS.task, description: 'Related task.' },
-        run: { type: 'uri', predicate: UDFS.run, description: 'Related run.' },
+        chat: { type: 'uri', predicate: UDFS.conversation, references: { resource: 'chat', key: 'id' }, description: 'Related chat command surface.' },
+        thread: { type: 'uri', predicate: UDFS.inThread, references: { resource: 'thread', key: 'id' }, description: 'Related concrete thread/work site.' },
+        task: { type: 'uri', predicate: UDFS.task, references: { resource: 'task', key: 'id' }, description: 'Related task.' },
+        run: { type: 'uri', predicate: UDFS.run, references: { resource: 'run', key: 'id' }, description: 'Related run.' },
         actor: { type: 'uri', predicate: DCTerms.creator, description: 'Secretary, user, or worker that created the candidate.' },
         metadata: { type: 'json', predicate: UDFS.metadata, description: 'Opaque adapter-local metadata; shared relations must be explicit fields.' },
         createdAt: { type: 'timestamp', predicate: DCTerms.created, description: 'Creation timestamp.' },
@@ -748,8 +1096,8 @@ export const captureCandidateDescriptor = {
             },
         },
     ],
-};
-export const captureEventDescriptor = {
+});
+export const captureEventDescriptor = definePodModelDescriptor({
     uri: UDFS.CaptureEvent,
     version: '1.0.0',
     source: 'official',
@@ -762,7 +1110,7 @@ export const captureEventDescriptor = {
     fields: {
         id: idField,
         source: { type: 'uri', predicate: DCTerms.source, required: true, description: 'Original message, file, URL, fetched document, or resource considered by capture.' },
-        captureCandidate: { type: 'uri', predicate: UDFS.captureCandidate, description: 'Candidate resource involved in this event, when applicable.' },
+        captureCandidate: { type: 'uri', predicate: UDFS.captureCandidate, references: { resource: 'capture-candidate', key: 'id' }, description: 'Candidate resource involved in this event, when applicable.' },
         targetResource: { type: 'uri', predicate: UDFS.targetResource, description: 'Formal resource affected by this capture decision.' },
         decision: { type: 'string', predicate: UDFS.captureDecision, required: true, description: 'Decision such as direct_commit, optimistic_commit, candidate_created, promoted, rejected, corrected, rollback, duplicate, or ignored.' },
         suggestedType: { type: 'uri', predicate: UDFS.suggestedType, description: 'Type suggested at decision time.' },
@@ -770,12 +1118,12 @@ export const captureEventDescriptor = {
         confidence: { type: 'string', predicate: UDFS.confidence, description: 'Classifier confidence at decision time.' },
         reason: { type: 'text', predicate: UDFS.reason, description: 'Explanation for the capture decision.' },
         userCorrection: { type: 'text', predicate: UDFS.userCorrection, description: 'User correction to type, target, title, summary, or content.' },
-        approval: { type: 'uri', predicate: UDFS.approval, description: 'ApprovalRequest controlling an authority gate, if any.' },
-        inputRequest: { type: 'uri', predicate: UDFS.inputRequest, description: 'InputRequest controlling missing information, if any.' },
-        chat: { type: 'uri', predicate: UDFS.conversation, description: 'Related chat command surface.' },
-        thread: { type: 'uri', predicate: UDFS.inThread, description: 'Related concrete thread/work site.' },
-        task: { type: 'uri', predicate: UDFS.task, description: 'Related task.' },
-        run: { type: 'uri', predicate: UDFS.run, description: 'Related run.' },
+        approval: { type: 'uri', predicate: UDFS.approval, references: { resource: 'approval', key: 'id' }, description: 'ApprovalRequest controlling an authority gate, if any.' },
+        inputRequest: { type: 'uri', predicate: UDFS.inputRequest, references: { resource: 'input-request', key: 'id' }, description: 'InputRequest controlling missing information, if any.' },
+        chat: { type: 'uri', predicate: UDFS.conversation, references: { resource: 'chat', key: 'id' }, description: 'Related chat command surface.' },
+        thread: { type: 'uri', predicate: UDFS.inThread, references: { resource: 'thread', key: 'id' }, description: 'Related concrete thread/work site.' },
+        task: { type: 'uri', predicate: UDFS.task, references: { resource: 'task', key: 'id' }, description: 'Related task.' },
+        run: { type: 'uri', predicate: UDFS.run, references: { resource: 'run', key: 'id' }, description: 'Related run.' },
         actor: { type: 'uri', predicate: DCTerms.creator, description: 'Secretary, user, or worker that made or recorded the decision.' },
         about: { type: 'uri', predicate: SCHEMA.about, description: 'Control object or semantic subject the event is about.' },
         metadata: { type: 'json', predicate: UDFS.metadata, description: 'Opaque adapter-local metadata; shared relations must be explicit fields.' },
@@ -811,8 +1159,8 @@ export const captureEventDescriptor = {
             },
         },
     ],
-};
-export const contactDescriptor = {
+});
+export const contactDescriptor = definePodModelDescriptor({
     uri: UDFS.Contact,
     version: '1.0.0',
     source: 'official',
@@ -850,8 +1198,8 @@ export const contactDescriptor = {
     ],
     mergePolicy: 'upsert',
     examples: [{ request: 'Create an AI agent contact projection', match: { id: 'agent-secretary.ttl' } }],
-};
-export const chatDescriptor = {
+});
+export const chatDescriptor = definePodModelDescriptor({
     uri: MEETING.LongChat,
     version: '1.0.0',
     source: 'official',
@@ -871,7 +1219,7 @@ export const chatDescriptor = {
         starred: { type: 'boolean', predicate: UDFS.favorite, description: 'Favorite flag.' },
         muted: { type: 'boolean', predicate: UDFS.muted, description: 'Muted flag.' },
         unreadCount: { type: 'number', predicate: UDFS.unreadCount, description: 'Unread message count.' },
-        contact: { type: 'uri', predicate: UDFS.hasContact, description: 'Optional counterpart/contact represented by this channel.' },
+        contact: { type: 'uri', predicate: UDFS.hasContact, references: { resource: 'contact', key: 'id' }, description: 'Optional counterpart/contact represented by this channel.' },
         participants: { type: 'uri', predicate: WF.participant, array: true, description: 'Participant resource URIs.' },
         metadata: { type: 'json', predicate: UDFS.metadata, description: 'Opaque adapter/UI metadata.' },
         lastActiveAt: { type: 'timestamp', predicate: UDFS.lastActiveAt, description: 'Last activity timestamp.' },
@@ -886,8 +1234,8 @@ export const chatDescriptor = {
     ],
     mergePolicy: 'upsert',
     examples: [{ request: 'Create a team chat surface', match: { id: 'team/index.ttl#this' } }],
-};
-export const threadDescriptor = {
+});
+export const threadDescriptor = definePodModelDescriptor({
     uri: SIOC.Thread,
     version: '1.0.0',
     source: 'official',
@@ -910,8 +1258,8 @@ export const threadDescriptor = {
     writableFields: ['parent', 'title', 'status', 'starred', 'workspace', 'metadata'],
     mergePolicy: 'upsert',
     examples: [{ request: 'Create a thread under a chat surface', match: { id: 'chat/team/index.ttl#thread' } }],
-};
-export const messageDescriptor = {
+});
+export const messageDescriptor = definePodModelDescriptor({
     uri: MEETING.Message,
     version: '1.0.0',
     source: 'official',
@@ -924,8 +1272,8 @@ export const messageDescriptor = {
     fields: {
         id: idField,
         parent: { type: 'uri', predicate: SIOC.has_parent, required: true, description: 'Parent command surface/container URI.' },
-        chat: { type: 'uri', predicate: WF.message, description: 'Solid Chat compatibility containment relation.' },
-        thread: { type: 'uri', predicate: SIOC.has_member, description: 'Thread containment relation.' },
+        chat: { type: 'uri', predicate: WF.message, references: { resource: 'chat', key: 'id' }, description: 'Solid Chat compatibility containment relation.' },
+        thread: { type: 'uri', predicate: SIOC.has_member, references: { resource: 'thread', key: 'id' }, description: 'Thread containment relation.' },
         maker: { type: 'uri', predicate: FOAF.maker, description: 'Author resource IRI.' },
         role: { type: 'string', predicate: UDFS.messageType, description: 'Message role.' },
         content: { type: 'text', predicate: SIOC.content, required: true, description: 'Plain text content.' },
@@ -953,8 +1301,8 @@ export const messageDescriptor = {
     ],
     mergePolicy: 'append',
     examples: [{ request: 'Append a message under a team chat', match: { id: 'chat/team/2026/06/14/messages.ttl#msg_1' } }],
-};
-export const chatProjectContextDescriptor = {
+});
+export const chatProjectContextDescriptor = definePodModelDescriptor({
     uri: UDFS.ChatProjectContext,
     version: '1.0.0',
     source: 'official',
@@ -976,8 +1324,8 @@ export const chatProjectContextDescriptor = {
     writableFields: ['workspace', 'instructions', 'memoryEnabled', 'createdAt', 'updatedAt'],
     mergePolicy: 'upsert',
     examples: [{ request: 'Save shared instructions for a workspace', match: { id: 'workspace-key.ttl' } }],
-};
-export const chatProjectMemoryDescriptor = {
+});
+export const chatProjectMemoryDescriptor = definePodModelDescriptor({
     uri: UDFS.ProjectMemory,
     version: '1.0.0',
     source: 'official',
@@ -999,8 +1347,8 @@ export const chatProjectMemoryDescriptor = {
     writableFields: ['workspace', 'text', 'sourceMessage', 'createdAt', 'updatedAt'],
     mergePolicy: 'upsert',
     examples: [{ request: 'Remember an explicit project fact', match: { id: 'memory-id.ttl' } }],
-};
-export const conversationShareDescriptor = {
+});
+export const conversationShareDescriptor = definePodModelDescriptor({
     uri: UDFS.ConversationShare,
     version: '1.0.0',
     source: 'official',
@@ -1023,8 +1371,8 @@ export const conversationShareDescriptor = {
     writableFields: ['thread', 'resourceUrl', 'includeToolDetails', 'excludedMessageIds', 'createdAt', 'revokedAt'],
     mergePolicy: 'upsert',
     examples: [{ request: 'Record a read-only conversation share', match: { id: 'share-id.ttl' } }],
-};
-export const ideaDescriptor = {
+});
+export const ideaDescriptor = definePodModelDescriptor({
     uri: UDFS.Idea,
     version: '1.0.0',
     source: 'official',
@@ -1048,8 +1396,8 @@ export const ideaDescriptor = {
         conflicts: { type: 'text', predicate: UDFS.conflicts, array: true, description: 'Potential semantic conflicts.' },
         nextStep: { type: 'text', predicate: UDFS.nextStep, description: 'Suggested next action.' },
         promotedTo: { type: 'uri', predicate: UDFS.promotedTo, description: 'Committed resource created from the idea.' },
-        chat: { type: 'uri', predicate: UDFS.conversation, description: 'Source chat.' },
-        thread: { type: 'uri', predicate: UDFS.inThread, description: 'Source thread.' },
+        chat: { type: 'uri', predicate: UDFS.conversation, references: { resource: 'chat', key: 'id' }, description: 'Source chat.' },
+        thread: { type: 'uri', predicate: UDFS.inThread, references: { resource: 'thread', key: 'id' }, description: 'Source thread.' },
         sourceMessages: { type: 'uri', predicate: DCTerms.source, array: true, description: 'Source messages.' },
         createdBy: { type: 'uri', predicate: DCTerms.creator, description: 'Creator WebID or agent URI.' },
         metadata: { type: 'json', predicate: UDFS.metadata, description: 'Opaque adapter metadata.' },
@@ -1067,8 +1415,8 @@ export const ideaDescriptor = {
             match: { id: '2026/05/28.ttl#idea_symphony_quality_metrics' },
         },
     ],
-};
-export const issueDescriptor = {
+});
+export const issueDescriptor = definePodModelDescriptor({
     uri: UDFS.Issue,
     version: '1.0.0',
     source: 'official',
@@ -1089,9 +1437,9 @@ export const issueDescriptor = {
         status: { type: 'string', predicate: UDFS.status, description: 'Issue lifecycle status.' },
         priority: { type: 'string', predicate: UDFS.priority, description: 'Issue priority.' },
         labels: { type: 'text', predicate: UDFS.tags, array: true, description: 'Tags or labels.' },
-        chat: { type: 'uri', predicate: UDFS.conversation, description: 'Owning or source chat.' },
-        thread: { type: 'uri', predicate: UDFS.inThread, description: 'Owning or source thread.' },
-        parentIssue: { type: 'uri', predicate: UDFS.parentIssue, description: 'Parent issue.' },
+        chat: { type: 'uri', predicate: UDFS.conversation, references: { resource: 'chat', key: 'id' }, description: 'Owning or source chat.' },
+        thread: { type: 'uri', predicate: UDFS.inThread, references: { resource: 'thread', key: 'id' }, description: 'Owning or source thread.' },
+        parentIssue: { type: 'uri', predicate: UDFS.parentIssue, references: { resource: 'issue', key: 'id' }, description: 'Parent issue.' },
         tasks: { type: 'uri', predicate: UDFS.task, array: true, description: 'Executable task slices.' },
         createdBy: { type: 'uri', predicate: DCTerms.creator, description: 'Creator WebID or agent URI.' },
         assignedTo: { type: 'uri', predicate: UDFS.assignedTo, description: 'Assignee WebID or agent URI.' },
@@ -1110,8 +1458,8 @@ export const issueDescriptor = {
             match: { id: 'issue_symphony_runtime_projection.ttl' },
         },
     ],
-};
-export const taskDescriptor = {
+});
+export const taskDescriptor = definePodModelDescriptor({
     uri: UDFS.Task,
     version: '1.0.0',
     source: 'official',
@@ -1126,7 +1474,7 @@ export const taskDescriptor = {
         title: { type: 'string', predicate: DCTerms.title, description: 'Task title.' },
         instruction: { type: 'text', predicate: UDFS.instruction, required: true, description: 'Executable instruction.' },
         prompt: { type: 'text', predicate: UDFS.prompt, description: 'Runtime prompt projection.' },
-        issue: { type: 'uri', predicate: UDFS.issue, description: 'Originating issue.' },
+        issue: { type: 'uri', predicate: UDFS.issue, references: { resource: 'issue', key: 'id' }, description: 'Originating issue.' },
         message: { type: 'uri', predicate: UDFS.message, description: 'Message that produced this task.' },
         workspace: { type: 'uri', predicate: UDFS.workspace, required: true, description: 'Workspace URI.' },
         status: { type: 'string', predicate: UDFS.status, description: 'Task lifecycle status.' },
@@ -1147,8 +1495,8 @@ export const taskDescriptor = {
             match: { id: 'task_symphony_worker_projection' },
         },
     ],
-};
-export const scheduleDescriptor = {
+});
+export const scheduleDescriptor = definePodModelDescriptor({
     uri: UDFS.Schedule,
     version: '1.0.0',
     source: 'official',
@@ -1160,7 +1508,7 @@ export const scheduleDescriptor = {
     storage: exactIdStorage(),
     fields: {
         id: idField,
-        task: { type: 'uri', predicate: UDFS.task, required: true, description: 'Scheduled task.' },
+        task: { type: 'uri', predicate: UDFS.task, references: { resource: 'task', key: 'id' }, required: true, description: 'Scheduled task.' },
         status: { type: 'string', predicate: UDFS.status, description: 'Schedule lifecycle status.' },
         scheduleKind: { type: 'string', predicate: UDFS.scheduleKind, description: 'Schedule kind: once, interval, or cron.' },
         cron: { type: 'string', predicate: UDFS.cron, description: 'Cron expression.' },
@@ -1175,8 +1523,8 @@ export const scheduleDescriptor = {
     writableFields: ['task', 'status', 'scheduleKind', 'cron', 'intervalSeconds', 'timezone', 'startsAt', 'nextRunAt', 'lastRunAt', 'metadata'],
     mergePolicy: 'upsert',
     examples: [{ request: 'Create a time trigger for a task', match: { id: 'schedules/schedule_1.ttl' } }],
-};
-export const automationRuleDescriptor = {
+});
+export const automationRuleDescriptor = definePodModelDescriptor({
     uri: UDFS.AutomationRule,
     version: '1.0.0',
     source: 'official',
@@ -1192,8 +1540,8 @@ export const automationRuleDescriptor = {
         description: { type: 'text', predicate: DCTerms.description, description: 'Rule description.' },
         status: { type: 'string', predicate: UDFS.status, description: 'Rule lifecycle status.' },
         ruleKind: { type: 'string', predicate: UDFS.ruleKind, description: 'Rule kind: event, schedule, or manual.' },
-        task: { type: 'uri', predicate: UDFS.task, description: 'Task dispatched by this rule.' },
-        schedule: { type: 'uri', predicate: UDFS.schedule, description: 'Schedule that triggers this rule.' },
+        task: { type: 'uri', predicate: UDFS.task, references: { resource: 'task', key: 'id' }, description: 'Task dispatched by this rule.' },
+        schedule: { type: 'uri', predicate: UDFS.schedule, references: { resource: 'schedule', key: 'id' }, description: 'Schedule that triggers this rule.' },
         source: { type: 'uri', predicate: DCTerms.source, description: 'Source resource.' },
         target: { type: 'uri', predicate: AS.target, description: 'Target resource.' },
         condition: { type: 'json', predicate: UDFS.condition, description: 'Structured condition.' },
@@ -1206,8 +1554,8 @@ export const automationRuleDescriptor = {
     writableFields: ['title', 'description', 'status', 'ruleKind', 'task', 'schedule', 'source', 'target', 'condition', 'actions', 'metadata', 'lastTriggeredAt', 'lastRunStatus'],
     mergePolicy: 'upsert',
     examples: [{ request: 'Create an automation rule that dispatches a task', match: { id: 'automation/rule_1.ttl' } }],
-};
-export const deliveryDescriptor = {
+});
+export const deliveryDescriptor = definePodModelDescriptor({
     uri: UDFS.Delivery,
     version: '1.0.0',
     source: 'official',
@@ -1221,12 +1569,12 @@ export const deliveryDescriptor = {
         id: idField,
         kind: { type: 'string', predicate: UDFS.deliveryKind, description: 'Delivery kind.' },
         status: { type: 'string', predicate: UDFS.status, description: 'Delivery lifecycle status.' },
-        task: { type: 'uri', predicate: UDFS.task, description: 'Task being delivered.' },
+        task: { type: 'uri', predicate: UDFS.task, references: { resource: 'task', key: 'id' }, description: 'Task being delivered.' },
         source: { type: 'uri', predicate: DCTerms.source, description: 'Source resource.' },
         target: { type: 'uri', predicate: AS.target, description: 'Target resource.' },
-        chat: { type: 'uri', predicate: UDFS.conversation, description: 'Related chat.' },
-        thread: { type: 'uri', predicate: UDFS.inThread, description: 'Source thread.' },
-        targetThread: { type: 'uri', predicate: UDFS.targetThread, description: 'Target thread.' },
+        chat: { type: 'uri', predicate: UDFS.conversation, references: { resource: 'chat', key: 'id' }, description: 'Related chat.' },
+        thread: { type: 'uri', predicate: UDFS.inThread, references: { resource: 'thread', key: 'id' }, description: 'Source thread.' },
+        targetThread: { type: 'uri', predicate: UDFS.targetThread, references: { resource: 'thread', key: 'id' }, description: 'Target thread.' },
         targetSession: { type: 'uri', predicate: UDFS.targetSession, description: 'Target session.' },
         actor: { type: 'uri', predicate: AS.actor, description: 'Actor.' },
         object: { type: 'uri', predicate: AS.object, description: 'Object resource.' },
@@ -1248,8 +1596,8 @@ export const deliveryDescriptor = {
     ],
     mergePolicy: 'upsert',
     examples: [{ request: 'Create a worker delivery package', match: { id: 'task/symphony/2026/05/28/deliveries.ttl#delivery_1' } }],
-};
-export const runDescriptor = {
+});
+export const runDescriptor = definePodModelDescriptor({
     uri: UDFS.Run,
     version: '1.0.0',
     source: 'official',
@@ -1261,11 +1609,11 @@ export const runDescriptor = {
     storage: exactIdStorage(),
     fields: {
         id: idField,
-        task: { type: 'uri', predicate: UDFS.task, description: 'Task being executed.' },
-        delivery: { type: 'uri', predicate: UDFS.delivery, description: 'Delivery that caused or carries this run.' },
+        task: { type: 'uri', predicate: UDFS.task, references: { resource: 'task', key: 'id' }, description: 'Task being executed.' },
+        delivery: { type: 'uri', predicate: UDFS.delivery, references: { resource: 'delivery', key: 'id' }, description: 'Delivery that caused or carries this run.' },
         trigger: { type: 'uri', predicate: UDFS.trigger, description: 'Resource that triggered the run.' },
         input: { type: 'uri', predicate: UDFS.input, description: 'Concrete input/context projection resource.' },
-        thread: { type: 'uri', predicate: UDFS.inThread, required: true, description: 'Runtime thread.' },
+        thread: { type: 'uri', predicate: UDFS.inThread, references: { resource: 'thread', key: 'id' }, required: true, description: 'Runtime thread.' },
         workspace: { type: 'uri', predicate: UDFS.workspace, required: true, description: 'Workspace URI.' },
         status: { type: 'string', predicate: UDFS.status, description: 'Run lifecycle status.' },
         runner: { type: 'string', predicate: UDFS.runner, required: true, description: 'Runtime implementation.' },
@@ -1288,8 +1636,8 @@ export const runDescriptor = {
     ],
     mergePolicy: 'upsert',
     examples: [{ request: 'Record a runtime execution attempt', match: { id: 'task/symphony/2026/05/28/runs.ttl#run_1' } }],
-};
-export const runStepDescriptor = {
+});
+export const runStepDescriptor = definePodModelDescriptor({
     uri: UDFS.RunStep,
     version: '1.0.0',
     source: 'official',
@@ -1301,7 +1649,7 @@ export const runStepDescriptor = {
     storage: exactIdStorage(),
     fields: {
         id: idField,
-        run: { type: 'uri', predicate: UDFS.run, required: true, description: 'Run this step belongs to.' },
+        run: { type: 'uri', predicate: UDFS.run, references: { resource: 'run', key: 'id' }, required: true, description: 'Run this step belongs to.' },
         stepType: { type: 'string', predicate: UDFS.stepType, required: true, description: 'RunStep event type.' },
         message: { type: 'string', predicate: DCTerms.description, description: 'Human-readable step message.' },
         payload: { type: 'json', predicate: UDFS.payload, description: 'Structured step payload.' },
@@ -1310,8 +1658,8 @@ export const runStepDescriptor = {
     writableFields: ['run', 'stepType', 'message', 'payload'],
     mergePolicy: 'append',
     examples: [{ request: 'Append a runtime tool call step', match: { id: 'task/symphony/2026/05/28/runs.ttl#run-step_1' } }],
-};
-export const evidenceDescriptor = {
+});
+export const evidenceDescriptor = definePodModelDescriptor({
     uri: UDFS.Evidence,
     version: '1.0.0',
     source: 'official',
@@ -1325,11 +1673,11 @@ export const evidenceDescriptor = {
         id: idField,
         evidenceKind: { type: 'string', predicate: UDFS.evidenceKind, required: true, description: 'Evidence kind.' },
         about: { type: 'uri', predicate: SCHEMA.about, required: true, description: 'Control object this evidence supports.' },
-        issue: { type: 'uri', predicate: UDFS.issue, description: 'Related issue.' },
-        task: { type: 'uri', predicate: UDFS.task, description: 'Related task.' },
-        delivery: { type: 'uri', predicate: UDFS.delivery, description: 'Related delivery.' },
-        run: { type: 'uri', predicate: UDFS.run, description: 'Related run.' },
-        thread: { type: 'uri', predicate: UDFS.inThread, description: 'Related thread.' },
+        issue: { type: 'uri', predicate: UDFS.issue, references: { resource: 'issue', key: 'id' }, description: 'Related issue.' },
+        task: { type: 'uri', predicate: UDFS.task, references: { resource: 'task', key: 'id' }, description: 'Related task.' },
+        delivery: { type: 'uri', predicate: UDFS.delivery, references: { resource: 'delivery', key: 'id' }, description: 'Related delivery.' },
+        run: { type: 'uri', predicate: UDFS.run, references: { resource: 'run', key: 'id' }, description: 'Related run.' },
+        thread: { type: 'uri', predicate: UDFS.inThread, references: { resource: 'thread', key: 'id' }, description: 'Related thread.' },
         summary: { type: 'text', predicate: DCTerms.abstract, description: 'Evidence summary.' },
         source: { type: 'uri', predicate: DCTerms.source, description: 'Source artifact or document.' },
         actor: { type: 'uri', predicate: DCTerms.creator, description: 'Actor that produced the evidence.' },
@@ -1340,8 +1688,8 @@ export const evidenceDescriptor = {
     writableFields: ['evidenceKind', 'about', 'issue', 'task', 'delivery', 'run', 'thread', 'summary', 'source', 'actor', 'outcome', 'metadata'],
     mergePolicy: 'append',
     examples: [{ request: 'Record test evidence for a task', match: { id: 'task/symphony/2026/05/28/evidence.ttl#evidence_1' } }],
-};
-export const reportDescriptor = {
+});
+export const reportDescriptor = definePodModelDescriptor({
     uri: UDFS.Report,
     version: '1.0.0',
     source: 'official',
@@ -1357,12 +1705,12 @@ export const reportDescriptor = {
         status: { type: 'string', predicate: UDFS.status, description: 'Report lifecycle status.' },
         outcome: { type: 'string', predicate: UDFS.outcome, description: 'Reported outcome.' },
         about: { type: 'uri', predicate: SCHEMA.about, required: true, description: 'Control object being summarized.' },
-        issue: { type: 'uri', predicate: UDFS.issue, description: 'Related issue.' },
-        task: { type: 'uri', predicate: UDFS.task, description: 'Related task.' },
-        delivery: { type: 'uri', predicate: UDFS.delivery, description: 'Related delivery.' },
-        run: { type: 'uri', predicate: UDFS.run, description: 'Related run.' },
-        thread: { type: 'uri', predicate: UDFS.inThread, description: 'Related thread.' },
-        evidence: { type: 'uri', predicate: UDFS.evidence, array: true, description: 'Evidence summarized by this report.' },
+        issue: { type: 'uri', predicate: UDFS.issue, references: { resource: 'issue', key: 'id' }, description: 'Related issue.' },
+        task: { type: 'uri', predicate: UDFS.task, references: { resource: 'task', key: 'id' }, description: 'Related task.' },
+        delivery: { type: 'uri', predicate: UDFS.delivery, references: { resource: 'delivery', key: 'id' }, description: 'Related delivery.' },
+        run: { type: 'uri', predicate: UDFS.run, references: { resource: 'run', key: 'id' }, description: 'Related run.' },
+        thread: { type: 'uri', predicate: UDFS.inThread, references: { resource: 'thread', key: 'id' }, description: 'Related thread.' },
+        evidence: { type: 'uri', predicate: UDFS.evidence, references: { resource: 'evidence', key: 'id' }, array: true, description: 'Evidence summarized by this report.' },
         summary: { type: 'text', predicate: DCTerms.abstract, required: true, description: 'Report summary.' },
         reviewer: { type: 'uri', predicate: SCHEMA.reviewedBy, description: 'Reviewer.' },
         actor: { type: 'uri', predicate: DCTerms.creator, description: 'Actor that produced the report.' },
@@ -1379,8 +1727,8 @@ export const reportDescriptor = {
     ],
     mergePolicy: 'upsert',
     examples: [{ request: 'Publish a worker handoff report', match: { id: 'task/symphony/2026/05/28/reports.ttl#report_1' } }],
-};
-export const sessionDescriptor = {
+});
+export const sessionDescriptor = definePodModelDescriptor({
     uri: UDFS.term('Session'),
     version: '1.0.0',
     source: 'official',
@@ -1393,8 +1741,8 @@ export const sessionDescriptor = {
     fields: {
         id: idField,
         owner: { type: 'uri', predicate: UDFS.actor, required: true, description: 'Session owner.' },
-        chat: { type: 'uri', predicate: UDFS.conversation, description: 'Related chat.' },
-        thread: { type: 'uri', predicate: UDFS.inThread, description: 'Related thread.' },
+        chat: { type: 'uri', predicate: UDFS.conversation, references: { resource: 'chat', key: 'id' }, description: 'Related chat.' },
+        thread: { type: 'uri', predicate: UDFS.inThread, references: { resource: 'thread', key: 'id' }, description: 'Related thread.' },
         status: { type: 'string', predicate: UDFS.sessionStatus, description: 'Session lifecycle status.' },
         tool: { type: 'string', predicate: UDFS.sessionTool, description: 'Runtime tool or backend.' },
         tokenUsage: { type: 'number', predicate: UDFS.tokenUsage, description: 'Token usage.' },
@@ -1408,11 +1756,13 @@ export const sessionDescriptor = {
     writableFields: ['owner', 'chat', 'thread', 'status', 'tool', 'tokenUsage', 'messages', 'policy', 'policyVersion', 'metadata', 'archivedAt'],
     mergePolicy: 'upsert',
     examples: [{ request: 'Record a worker runtime session', match: { id: '2026/05/28/sess_1.ttl' } }],
-};
+});
 export const officialPodModelDescriptors = [
     credentialDescriptor,
     gatewayAccessKeyDescriptor,
     quotaSnapshotDescriptor,
+    aiProviderDescriptor,
+    aiModelDescriptor,
     contactDescriptor,
     chatDescriptor,
     threadDescriptor,