@undefineds.co/models 0.2.15 → 0.2.18

package/README.md

@@ -1,7 +1,7 @@
 # LinX 数据模型
 
 > 基于 Solid Pod 标准的 LinX 核心数据模型定义
-> 
+>
 > 使用 `drizzle-solid` ORM，兼容标准 RDF 词汇表（VCARD, FOAF, SIOC, DCTerms 等）
 
 ---
@@ -56,6 +56,12 @@ LinX 的所有数据存储在 Solid Pod 中，使用标准的 RDF 格式。本
 - 新增 shared model 代码优先使用 `chatResource`、`threadResource`、`messageResource`、`sessionResource` 等 Solid resource 命名；`*Table` 只作为兼容 alias 逐步退出。
 - 如果壳层需要新的查询、upsert、resolve-by-uri、审计或审批状态变更能力，优先在本包新增 repository/helper 和 tests；不要在 CLI/App 中复制 predicate、subject template、Turtle 读写或 shared 状态机。
 - `approval` / `grant` / `audit` / `inboxNotification` / `session` 等跨端控制面也属于本包的 shared resource 语义。CLI/App 只负责把 Pi/Codex/Claude 等运行时事件映射成本包定义的 insert/update DTO，不能另建一套存储路径或审批策略。
+- approval 的倒计时和可选决策也属于 shared resource 语义：使用 `approvalResource.expiresAt` 表示截止时间，使用 `approvalResource.approvalOptions` 存储上游原生协议给出的可选决策（例如 `allow_once` / `allow_always` / `reject_once`）。CLI/App 不得各自用私有 predicate 或本地状态推断这些字段。
+- grant 是可维护的 LLM Wiki 文档资源，不是一次请求的 fingerprint。`grantResource` 使用 `/settings/autonomy/grants/{id}.ttl`，文档 URI 本身就是 RDF subject；通过 `title/summary/body/schema/pageKind/wikiStatus/tags/source/sourceHash/compiledAt/compiledFrom/related/context` 描述页面语义、来源和上下文。
+- `grant.schema` 使用 `dcterms:conformsTo` 指向 Solid schema/shape URI，例如 `/settings/autonomy/schema/grant.ttl#GrantWikiPage`；它不是 `path`/`wikiPath` 字符串，TTL wiki page 也不需要 `.meta` subject。
+- `grant.target`、`grant.action`、`grant.riskCeiling` 只用于候选筛选或排序，不得作为最终自动审批判定。最终是否覆盖必须看 wiki page 的 `body/summary/tags/source/provenance/context` 与当前请求的语义匹配结果。
+- CLI/App 不得为 shared 控制面字段自定义业务 predicate。新增 approval/grant/audit 字段必须先在本包的 namespace、vocab、schema 和 tests 中定义。
+- structured user-input 与 approval 一样属于 watch 共享协议：AI secretary 只能在答案能从请求上下文明确推出时代答，否则必须回到人工输入。
 
 ---
 
@@ -122,26 +128,26 @@ LinX 遵循 Solid 生态的最佳实践，优先使用标准 RDF 词汇表：
   givenName: string;      // vcard:givenName
   familyName: string;     // vcard:familyName
   nickname: string;       // foaf:nick
-  
+
   // 联系方式
   email: string;          // vcard:hasEmail
   telephone: string;      // vcard:hasTelephone
   mobile: string;
-  
+
   // 地址
   homeAddress: string;    // vcard:hasAddress (JSON)
   workAddress: string;
-  
+
   // 组织
   organization: string;   // vcard:organizationName
   title: string;          // vcard:title
-  
+
   // Solid 身份
   webId: string;          // foaf:weblog
-  
+
   // AI 联系人
   aiAssistantId: string;  // linx:aiAssistant
-  
+
   // 关系和标签
   relationship: string;   // vcard:hasRelated
   tags: string;           // dcterms:subject (JSON)
@@ -199,7 +205,7 @@ LinX 遵循 Solid 生态的最佳实践，优先使用标准 RDF 词汇表：
   modifiedAt: timestamp;      // dcterms:modified (编辑时间)
   deletedAt: timestamp;       // linx:deletedAt (软删除)
   readBy: string;             // linx:readBy (JSON)
-  
+
   // 附件（如果是文件/图片消息）
   attachmentUri: string;      // schema:about
   attachmentName: string;     // schema:name
@@ -254,12 +260,12 @@ LinX 遵循 Solid 生态的最佳实践，优先使用标准 RDF 词汇表：
   description: string;        // dcterms:description
   favoriteType: string;       // linx:favoriteType
   targetUri: string;          // linx:favoriteTarget ⭐ 必需
-  
+
   // 快照（避免查询原始资源）
   snapshotContent: string;    // schema:text
   snapshotAuthor: string;     // schema:author
   snapshotCreatedAt: timestamp; // schema:dateCreated
-  
+
   owner: string;              // dcterms:creator
   folder: string;             // linx:conversation
   tags: string;               // dcterms:subject (JSON)
@@ -344,37 +350,37 @@ POD_CACHE_SIZE: "pod.cacheSize"
   description: string;        // dcterms:description
   avatarUrl: string;          // foaf:depiction
   assistantType: string;      // dcterms:type (system, custom, shared)
-  
+
   // 模型配置
   provider: string;           // linx:aiProvider (openai, anthropic, ollama, custom)
   modelId: string;            // linx:aiModel (gpt-4, claude-3, llama2)
   systemPrompt: string;       // linx:systemPrompt
-  
+
   // 模型参数
   temperature: float;         // linx:temperature (0-2)
   maxTokens: integer;         // linx:maxTokens
   topP: float;
   frequencyPenalty: float;
   presencePenalty: float;
-  
+
   // 功能配置
   enableStreaming: boolean;
   enableFunctionCalling: boolean;
   allowedFunctions: string;   // JSON 数组
-  
+
   // Pod 访问权限
   podAccessLevel: string;     // linx:status (read, write, full)
   allowedContainers: string;  // JSON 数组
-  
+
   // 共享
   owner: string;              // dcterms:creator
   isPublic: boolean;
   sharedWith: string;         // JSON
-  
+
   // 统计
   messageCount: integer;
   lastUsedAt: timestamp;
-  
+
   status: string;             // linx:status (active, disabled, archived)
   createdAt: timestamp;
   modifiedAt: timestamp;
@@ -401,7 +407,7 @@ yarn workspace @linq/models install
 import {
   // 词汇表
   LINQ, SIOC, DCTerms, SCHEMA,
-  
+
   // 模型表
   contactTable,
   chatTable,
@@ -410,12 +416,12 @@ import {
   favoriteTable,
   settingsTable,
   aiAssistantTable,
-  
+
   // 类型
   type ContactRow,
   type ChatRow,
   type MessageRow,
-  
+
   // 常量
   CONTACT_TYPES,
   SETTING_KEYS,
@@ -585,11 +591,3 @@ yarn workspace @linq/models typecheck
 ## 许可证
 
 MIT License
-
-
-
-
-
-
-
-

package/dist/agent.providers.js

@@ -1,4 +1,15 @@
 export const DEFAULT_AGENT_PROVIDERS = [
+    {
+        slug: 'undefineds',
+        displayName: 'undefineds',
+        baseUrl: 'https://api.undefineds.co/v1',
+        homepage: 'https://undefineds.co/linx',
+        logoUrl: 'https://undefineds.co/favicon.ico',
+        models: [
+            { id: 'linx-lite', displayName: 'LinX Lite' },
+            { id: 'linx', displayName: 'LinX' },
+        ],
+    },
     {
         slug: 'openai',
         displayName: 'OpenAI',

package/dist/agent.repository.d.ts

@@ -1,4 +1,4 @@
-export declare const agentRepository: import("./repository").PodRepositoryDescriptor<import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
+export declare const agentRepository: import("@undefineds.co/drizzle-solid/dist/core/repository").PodRepositoryDescriptor<import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
     id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
     name: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, false>;
     description: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;

package/dist/ai-config/index.d.ts

@@ -43,16 +43,24 @@ export interface AIConfigMutationPlan {
     modelUpserts: AIModelInsert[];
     modelDeleteIds: string[];
 }
+export declare const UNDEFINEDS_AI_PROVIDER_ID = "undefineds";
+export declare const UNDEFINEDS_AI_PROVIDER_DISPLAY_NAME = "undefineds";
+export declare const UNDEFINEDS_AI_BASE_URL = "https://api.undefineds.co/v1";
+export declare const LINX_LITE_MODEL_ID = "linx-lite";
+export declare const LINX_MODEL_ID = "linx";
+export declare const DEFAULT_LINX_MODEL_ID = "linx-lite";
+export declare const UNDEFINEDS_AI_MODEL_IDS: readonly ["linx-lite", "linx"];
 export declare function getAIConfigProviderCatalog(): readonly AIConfigProviderCatalogEntry[];
 export declare function getAIConfigProviderMetadata(providerId: string): AIConfigProviderCatalogEntry;
 export declare function normalizeAIConfigResourceId(raw?: string | null): string;
+export declare function normalizeAIConfigModelId(raw?: string | null, providerId?: string | null): string;
 export declare function normalizeAIConfigProviderId(raw?: string | null): string;
 export declare function sameAIConfigProviderFamily(left?: string | null, right?: string | null): boolean;
 export declare function getAIConfigProviderFamilyIds(providerId: string): string[];
 export declare function getAIConfigDefaultBaseUrl(providerId: string): string | undefined;
 export declare function getDefaultAIConfigCredentialId(providerId: string): string;
-export declare function aiConfigProviderUri(providerId: string): string;
-export declare function aiConfigModelUri(modelId: string): string;
+export declare function aiConfigProviderRef(providerId: string): string;
+export declare function aiConfigModelRef(providerId: string, modelId?: string): string;
 export declare function buildAIConfigProviderStateMap(options: BuildAIConfigProviderStateMapOptions): Record<string, AIConfigProviderState>;
 export declare function buildAIConfigMutationPlan(input: {
     providerId: string;

package/dist/ai-config/index.js

@@ -1,3 +1,10 @@
+export const UNDEFINEDS_AI_PROVIDER_ID = 'undefineds';
+export const UNDEFINEDS_AI_PROVIDER_DISPLAY_NAME = 'undefineds';
+export const UNDEFINEDS_AI_BASE_URL = 'https://api.undefineds.co/v1';
+export const LINX_LITE_MODEL_ID = 'linx-lite';
+export const LINX_MODEL_ID = 'linx';
+export const DEFAULT_LINX_MODEL_ID = LINX_LITE_MODEL_ID;
+export const UNDEFINEDS_AI_MODEL_IDS = [LINX_LITE_MODEL_ID, LINX_MODEL_ID];
 const AI_CONFIG_PROVIDER_CATALOG = [
     {
         id: 'openai',
@@ -69,6 +76,7 @@ const AI_CONFIG_PROVIDER_CATALOG = [
     },
 ];
 const AI_CONFIG_PROVIDER_MAP = new Map(AI_CONFIG_PROVIDER_CATALOG.map((entry) => [entry.id, entry]));
+const ABSOLUTE_IRI = /^[a-zA-Z][a-zA-Z\d+.-]*:/;
 function normalizeText(value) {
     return value.trim().toLowerCase();
 }
@@ -111,12 +119,34 @@ export function getAIConfigProviderMetadata(providerId) {
 export function normalizeAIConfigResourceId(raw) {
     if (!raw)
         return '';
-    if (raw.includes('#'))
-        return raw.split('#').pop() || raw;
-    const clean = raw.replace(/\/$/, '');
+    const value = raw.trim();
+    if (!value)
+        return '';
+    if (value.includes('#'))
+        return value.split('#').pop() || value;
+    if (!ABSOLUTE_IRI.test(value) && !value.endsWith('.ttl')) {
+        return value;
+    }
+    const clean = value.replace(/\/$/, '');
+    if (!ABSOLUTE_IRI.test(value)) {
+        return clean.endsWith('.ttl') ? clean.slice(0, -4) : clean;
+    }
     const tail = clean.split('/').pop() || clean;
     return tail.endsWith('.ttl') ? tail.slice(0, -4) : tail;
 }
+export function normalizeAIConfigModelId(raw, providerId) {
+    const modelId = normalizeAIConfigResourceId(raw);
+    if (!modelId.includes('/'))
+        return modelId;
+    const [prefix, ...rest] = modelId.split('/');
+    if (rest.length === 0)
+        return modelId;
+    if (!providerId)
+        return modelId;
+    return normalizeAIConfigProviderId(prefix) === normalizeAIConfigProviderId(providerId)
+        ? rest.join('/')
+        : modelId;
+}
 export function normalizeAIConfigProviderId(raw) {
     const normalized = normalizeText(normalizeAIConfigResourceId(raw));
     if (!normalized)
@@ -128,6 +158,9 @@ export function normalizeAIConfigProviderId(raw) {
     }
     return normalized;
 }
+function normalizeAIConfigModelStorageId(raw, providerId) {
+    return normalizeAIConfigModelId(raw, providerId);
+}
 export function sameAIConfigProviderFamily(left, right) {
     const normalizedLeft = normalizeAIConfigProviderId(left);
     const normalizedRight = normalizeAIConfigProviderId(right);
@@ -143,11 +176,16 @@ export function getAIConfigDefaultBaseUrl(providerId) {
 export function getDefaultAIConfigCredentialId(providerId) {
     return `${normalizeAIConfigProviderId(providerId)}-default`;
 }
-export function aiConfigProviderUri(providerId) {
-    return `/settings/ai/providers.ttl#${normalizeAIConfigProviderId(providerId)}`;
+export function aiConfigProviderRef(providerId) {
+    return normalizeAIConfigProviderId(providerId);
 }
-export function aiConfigModelUri(modelId) {
-    return `/settings/ai/models.ttl#${normalizeAIConfigResourceId(modelId)}`;
+export function aiConfigModelRef(providerId, modelId) {
+    if (modelId === undefined) {
+        return normalizeAIConfigResourceId(providerId);
+    }
+    const provider = normalizeAIConfigProviderId(providerId);
+    const model = normalizeAIConfigModelStorageId(modelId, provider);
+    return provider && model ? `/settings/ai/models/${provider}.ttl#${model}` : model;
 }
 export function buildAIConfigProviderStateMap(options) {
     const catalog = options.catalog ?? AI_CONFIG_PROVIDER_CATALOG;
@@ -175,7 +213,7 @@ export function buildAIConfigProviderStateMap(options) {
         const providerId = normalizeAIConfigProviderId(String(row.isProvidedBy ?? ''));
         if (!providerId)
             continue;
-        const modelId = normalizeAIConfigResourceId(String(row.id ?? row['@id'] ?? ''));
+        const modelId = normalizeAIConfigModelStorageId(String(row.id ?? row['@id'] ?? ''), providerId);
         if (!modelId)
             continue;
         const list = modelMap.get(providerId) ?? [];
@@ -213,7 +251,7 @@ export function buildAIConfigProviderStateMap(options) {
                 enabled: true,
                 capabilities: [],
             }));
-        const selectedModelId = normalizeAIConfigResourceId(typeof providerRow?.hasModel === 'string' ? providerRow.hasModel : '') || preferredSelectedModelId(models);
+        const selectedModelId = normalizeAIConfigModelStorageId(typeof providerRow?.hasModel === 'string' ? providerRow.hasModel : '', providerId) || preferredSelectedModelId(models);
         states[providerId] = {
             id: providerId,
             enabled: (typeof credentialRow?.status === 'string' ? credentialRow.status : 'inactive') === 'active',
@@ -241,21 +279,21 @@ export function buildAIConfigMutationPlan(input) {
     if (hasConfigUpdate || input.updates.models !== undefined) {
         const selectedModelId = input.updates.models
             ? preferredSelectedModelId(input.updates.models)
-            : normalizeAIConfigResourceId(typeof existingProvider?.hasModel === 'string' ? existingProvider.hasModel : '');
+            : normalizeAIConfigModelStorageId(typeof existingProvider?.hasModel === 'string' ? existingProvider.hasModel : '', providerId);
         providerPayload = {
             id: providerId,
             baseUrl: input.updates.baseUrl ??
                 (typeof existingProvider?.baseUrl === 'string' ? existingProvider.baseUrl : undefined) ??
                 metadata.defaultBaseUrl,
             proxyUrl: typeof existingProvider?.proxyUrl === 'string' ? existingProvider.proxyUrl : undefined,
-            hasModel: selectedModelId ? aiConfigModelUri(selectedModelId) : undefined,
+            hasModel: selectedModelId ? aiConfigModelRef(providerId, selectedModelId) : undefined,
         };
     }
     if (hasConfigUpdate) {
         credentialPayload = {
             id: normalizeAIConfigResourceId(typeof existingCredential?.id === 'string' ? existingCredential.id : '') ||
                 getDefaultAIConfigCredentialId(providerId),
-            provider: aiConfigProviderUri(providerId),
+            provider: aiConfigProviderRef(providerId),
             service: typeof existingCredential?.service === 'string' && existingCredential.service ? existingCredential.service : 'ai',
             status: input.updates.enabled !== undefined
                 ? input.updates.enabled
@@ -275,12 +313,12 @@ export function buildAIConfigMutationPlan(input) {
     }
     if (input.updates.models !== undefined) {
         const existingById = new Map(existingModels.map((row) => [
-            normalizeAIConfigResourceId(String(row.id ?? row['@id'] ?? '')),
+            normalizeAIConfigModelStorageId(String(row.id ?? row['@id'] ?? ''), providerId),
             row,
         ]));
         const nextIds = new Set();
         for (const model of input.updates.models) {
-            const modelId = normalizeAIConfigResourceId(model.id);
+            const modelId = normalizeAIConfigModelStorageId(model.id, providerId);
             if (!modelId)
                 continue;
             nextIds.add(modelId);
@@ -290,7 +328,7 @@ export function buildAIConfigMutationPlan(input) {
                 id: modelId,
                 displayName: model.name || modelId,
                 modelType: 'chat',
-                isProvidedBy: aiConfigProviderUri(providerId),
+                isProvidedBy: aiConfigProviderRef(providerId),
                 status: model.enabled ? 'active' : 'inactive',
                 createdAt: existingDate(existing?.createdAt) ?? now,
                 updatedAt: now,

package/dist/ai-model.schema.js

@@ -1,17 +1,18 @@
 import { id, integer, podTable, string, timestamp, uri } from "@undefineds.co/drizzle-solid";
+import { aiProviderTable } from "./ai-provider.schema.js";
 import { XPOD_AI } from "./namespaces.js";
 export const aiModelTable = podTable("aiModel", {
     id: id("id"),
     displayName: string("displayName").predicate(XPOD_AI.displayName),
     modelType: string("modelType").predicate(XPOD_AI.modelType).default("chat"),
-    isProvidedBy: uri("isProvidedBy").predicate(XPOD_AI.isProvidedBy),
+    isProvidedBy: uri("isProvidedBy").predicate(XPOD_AI.isProvidedBy).link(aiProviderTable),
     dimension: integer("dimension").predicate(XPOD_AI.dimension),
     status: string("status").predicate(XPOD_AI.status).default("active"),
     createdAt: timestamp("createdAt").predicate(XPOD_AI.createdAt).notNull().defaultNow(),
     updatedAt: timestamp("updatedAt").predicate(XPOD_AI.updatedAt).notNull().defaultNow(),
 }, {
-    base: "/settings/ai/models.ttl",
+    base: "/settings/ai/models/",
     type: XPOD_AI.Model,
     namespace: XPOD_AI,
-    subjectTemplate: "#{id}",
+    subjectTemplate: "{isProvidedBy|id}.ttl#{id}",
 });

package/dist/ai-provider.schema.js

@@ -4,7 +4,7 @@ export const aiProviderTable = podTable("aiProvider", {
     id: id("id"),
     baseUrl: string("baseUrl").predicate(XPOD_AI.baseUrl),
     proxyUrl: string("proxyUrl").predicate(XPOD_AI.proxyUrl),
-    hasModel: uri("hasModel").predicate(XPOD_AI.hasModel),
+    hasModel: uri("hasModel").predicate(XPOD_AI.hasModel).link("aiModel"),
 }, {
     base: "/settings/ai/providers.ttl",
     type: XPOD_AI.Provider,

package/dist/approval.schema.d.ts

@@ -1,4 +1,4 @@
-export declare function buildApprovalSubjectPath(approvalId: string, createdAt?: Date | string | number): string;
+export declare function extractApprovalIdFromApprovalRef(approvalRef: string | null | undefined): string | null;
 export declare const approvalResource: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
     id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
     session: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
@@ -13,8 +13,11 @@ export declare const approvalResource: import("@undefineds.co/drizzle-solid/dist
     decisionRole: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
     onBehalfOf: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     reason: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    context: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    approvalOptions: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
     policyVersion: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
     createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
+    expiresAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
     resolvedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
 }>>;
 export declare const approvalTable: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
@@ -31,8 +34,11 @@ export declare const approvalTable: import("@undefineds.co/drizzle-solid/dist/co
     decisionRole: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
     onBehalfOf: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     reason: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    context: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    approvalOptions: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
     policyVersion: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
     createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
+    expiresAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
     resolvedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
 }>>;
 export type ApprovalRow = typeof approvalResource.$inferSelect;

package/dist/approval.schema.js

@@ -1,12 +1,7 @@
-import { podTable, uri, string, text, timestamp, id } from '@undefineds.co/drizzle-solid';
+import { extractPodResourceTemplateValue, podTable, uri, string, text, timestamp, id } from '@undefineds.co/drizzle-solid';
 import { ODRL, UDFS, DCTerms } from './namespaces.js';
-export function buildApprovalSubjectPath(approvalId, createdAt = new Date()) {
-    const date = createdAt instanceof Date ? createdAt : new Date(createdAt);
-    const safeDate = Number.isFinite(date.getTime()) ? date : new Date();
-    const yyyy = String(safeDate.getUTCFullYear());
-    const mm = String(safeDate.getUTCMonth() + 1).padStart(2, '0');
-    const dd = String(safeDate.getUTCDate()).padStart(2, '0');
-    return `/.data/approvals/${yyyy}/${mm}/${dd}.ttl#${encodeURIComponent(approvalId)}`;
+export function extractApprovalIdFromApprovalRef(approvalRef) {
+    return extractPodResourceTemplateValue(approvalResource, approvalRef);
 }
 // Approval request resource (separate from Solid inbox notifications).
 export const approvalResource = podTable('approval', {
@@ -28,9 +23,12 @@ export const approvalResource = podTable('approval', {
     decisionRole: string('decisionRole').predicate(UDFS.decisionRole),
     onBehalfOf: uri('onBehalfOf').predicate(UDFS.onBehalfOf),
     reason: text('reason').predicate(UDFS.reason),
+    context: text('context').predicate(UDFS.context),
+    approvalOptions: text('approvalOptions').predicate(UDFS.approvalOptions),
     policyVersion: string('policyVersion').predicate(UDFS.policyVersion),
     // Timestamps
     createdAt: timestamp('createdAt').predicate(DCTerms.created).notNull().defaultNow(),
+    expiresAt: timestamp('expiresAt').predicate(UDFS.expiresAt),
     resolvedAt: timestamp('resolvedAt').predicate(UDFS.resolvedAt),
 }, {
     base: '/.data/approvals/',

package/dist/audit.presentation.d.ts

@@ -0,0 +1,23 @@
+import type { ApprovalRow } from './approval.schema';
+import type { AuditRow } from './audit.schema';
+export interface AuditPresentation {
+    title: string;
+    description: string;
+    category: 'auth_required' | 'audit';
+    status?: string;
+    chatId: string | null;
+    threadId: string | null;
+    thread: string | null;
+    about: string | null;
+    authUrl: string | null;
+    authMethod: string | null;
+    authMessage: string | null;
+    actorRoleLabel: string;
+}
+type RelatedApproval = Pick<ApprovalRow, 'target' | 'toolName' | 'risk' | 'reason' | 'status' | 'context'> | null | undefined;
+export declare function buildAuditDetailRecord(audit: AuditRow, relatedApproval?: RelatedApproval): Record<string, unknown>;
+export declare function formatInboxStatusLabel(status?: string | null): string | null;
+export declare function formatAuditActorRole(role?: string | null): string;
+export declare function createResolvedAuthTimestampsIndex(audits: AuditRow[]): Map<string, number[]>;
+export declare function buildAuditPresentation(audit: AuditRow, resolvedAuthTimestampsByKey: Map<string, number[]>, relatedApproval?: RelatedApproval): AuditPresentation;
+export {};