@undefineds.co/models 0.2.36 → 0.2.38

package/README.md

@@ -163,13 +163,14 @@ Contact
   entity: Agent context-root URI
 
 Agent
-  root: /agents/__secretary__/
-  meta: /agents/__secretary__/.meta
+  id: /.data/agents/__secretary__/index.ttl#this
+  root: /.data/agents/__secretary__/
+  meta: /.data/agents/__secretary__/.meta
 ```
 
 External people, services, or bots may appear as Contacts without being LinX
 Agents. If something is modeled as an executable LinX Agent, the Agent resource
-identity is the context-root container itself.
+identity is `index.ttl#this` inside the context-root container.
 
 ## Resource Ownership
 
@@ -203,7 +204,7 @@ Representative paths:
 /.data/chat/{chatId}/index.ttl#this
 /.data/chat/{chatId}/index.ttl#{threadId}
 /.data/chat/{chatId}/{yyyy}/{MM}/{dd}/messages.ttl#{messageId}
-/agents/{agentId}/
+/.data/agents/{agentId}/index.ttl#this
 /.data/sessions/{yyyy}/{MM}/{dd}/{sessionId}.ttl
 /settings/providers/{providerId}.ttl
 /settings/providers/{providerId}.ttl#{modelId}

package/dist/agent.schema.js

@@ -1,7 +1,8 @@
 import { boolean, object, podTable, string, integer, timestamp, text, real, uri, id } from "@undefineds.co/drizzle-solid";
 import { UDFS, DCTerms, FOAF, VCARD } from "./namespaces.js";
+import { agentResourceId } from "./resource-identity.js";
 export const agentResource = podTable("agent", {
-    id: id("id").default("{key}/"),
+    id: id("id").default((key) => agentResourceId(key)),
     name: string("name").predicate(FOAF.name).notNull(),
     description: text("description").predicate(DCTerms.description),
     avatarUrl: uri("avatarUrl").predicate(VCARD.hasPhoto),
@@ -29,8 +30,8 @@ export const agentResource = podTable("agent", {
     updatedAt: timestamp("updatedAt").predicate(DCTerms.modified).notNull().defaultNow(),
     deletedAt: timestamp("deletedAt").predicate(UDFS.deletedAt),
 }, {
-    base: '/agents/',
-    sparqlEndpoint: '/agents/-/sparql',
+    base: '/.data/agents/',
+    sparqlEndpoint: '/.data/agents/-/sparql',
     type: FOAF.Agent,
     namespace: UDFS,
 });

package/dist/evidence.schema.d.ts

@@ -13,9 +13,11 @@ export declare const EvidenceKind: {
 /**
  * Evidence resource.
  *
- * Evidence is append-only proof or finding. The resource subject is the
- * evidence file/record itself; `about` points to the work/control object it
- * supports. It is not a status owner by itself.
+ * Evidence is append-only proof or finding metadata. Long evidence bodies
+ * such as logs, patches, screenshots, transcripts, and reports are Pod files;
+ * this TTL record stores the queryable meta and `source` points to the
+ * evidence file when one exists. `about` points to the work/control object it
+ * supports. Evidence is not a status owner by itself.
  */
 export declare const evidenceResource: 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>;

package/dist/evidence.schema.js

@@ -19,9 +19,11 @@ export const EvidenceKind = {
 /**
  * Evidence resource.
  *
- * Evidence is append-only proof or finding. The resource subject is the
- * evidence file/record itself; `about` points to the work/control object it
- * supports. It is not a status owner by itself.
+ * Evidence is append-only proof or finding metadata. Long evidence bodies
+ * such as logs, patches, screenshots, transcripts, and reports are Pod files;
+ * this TTL record stores the queryable meta and `source` points to the
+ * evidence file when one exists. `about` points to the work/control object it
+ * supports. Evidence is not a status owner by itself.
  */
 export const evidenceResource = podTable('evidence', {
     id: id('id').default('evidence/{yyyy}/{MM}/{dd}.ttl#{key}'),

package/dist/fixtures/contracts-chat-contact.js

@@ -12,7 +12,7 @@ export const fixtureContactAgentWorkspace = {
     name: 'Secretary@linx',
     rdfType: ContactClass.AGENT,
     contactType: 'agent',
-    entity: 'https://pod.example/agents/__secretary__/',
+    entity: 'https://pod.example/.data/agents/__secretary__/index.ttl#this',
     isPublic: false,
 };
 export const fixtureChatDirectAI = {

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { ChatStatus, chatResource, chatTable, type ChatMetadata, type ChatMember
 export { chatRepository } from './chat.repository';
 export { buildChatTargetRef, extractChatIdFromChatRef, extractChatTargetRef, extractChatThreadRef, extractThreadIdFromThreadRef, resolveThreadChatId, toTimestamp, type ChatTargetRef, type ChatThreadRef, } from './chat.utils';
 export { buildModelResourceId, buildModelResourceIri, buildModelResourceIriForDatabase, resolveModelResourceIri, resolveModelResourceIriForDatabase, type ModelResourceTarget, } from './resource-refs';
+export { agentHomeDirFromResourceId, agentHomePathFromResourceId, agentKeyFromResourceRef, agentKeyFromResourceId, agentResourceId, asBaseRelativeResourceId, asResourceIri, requireRowResourceId, type BaseRelativeResourceId, type ResourceIri, } from './resource-identity';
 export { ThreadStatus, threadResource, threadTable, type ThreadStatusType, type ThreadRow, type ThreadInsert, type ThreadUpdate, } from './thread.schema';
 export { threadRepository } from './thread.repository';
 export { MessageRole, MessageStatus, messageResource, messageTable, type MessageRoleType, type MessageStatusType, type MessageRow, type MessageInsert, type MessageUpdate, } from './message.schema';

package/dist/index.js

@@ -21,6 +21,7 @@ export { ChatStatus, chatResource, chatTable, } from './chat.schema.js';
 export { chatRepository } from './chat.repository.js';
 export { buildChatTargetRef, extractChatIdFromChatRef, extractChatTargetRef, extractChatThreadRef, extractThreadIdFromThreadRef, resolveThreadChatId, toTimestamp, } from './chat.utils.js';
 export { buildModelResourceId, buildModelResourceIri, buildModelResourceIriForDatabase, resolveModelResourceIri, resolveModelResourceIriForDatabase, } from './resource-refs.js';
+export { agentHomeDirFromResourceId, agentHomePathFromResourceId, agentKeyFromResourceRef, agentKeyFromResourceId, agentResourceId, asBaseRelativeResourceId, asResourceIri, requireRowResourceId, } from './resource-identity.js';
 export { ThreadStatus, threadResource, threadTable, } from './thread.schema.js';
 export { threadRepository } from './thread.repository.js';
 export { MessageRole, MessageStatus, messageResource, messageTable, } from './message.schema.js';

package/dist/message.repository.d.ts

@@ -1,6 +1,7 @@
 export declare const messageRepository: 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>;
-    chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+    scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
@@ -23,6 +24,7 @@ export declare const messageRepository: import("@undefineds.co/drizzle-solid/dis
     updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
 }>>, {
     id: string;
+    scope: string;
     chat: string;
     thread: string;
     maker: string;
@@ -45,9 +47,10 @@ export declare const messageRepository: import("@undefineds.co/drizzle-solid/dis
     createdAt: Date;
     updatedAt: Date;
 }, {
-    chat: string;
     content: string;
     id?: string | undefined;
+    scope?: string | undefined;
+    chat?: string | undefined;
     thread?: string | undefined;
     maker?: string | undefined;
     role?: string | undefined;
@@ -69,7 +72,8 @@ export declare const messageRepository: import("@undefineds.co/drizzle-solid/dis
     updatedAt?: Date | undefined;
 }, {
     id?: string | null | undefined;
-    chat?: string | undefined;
+    scope?: string | null | undefined;
+    chat?: string | null | undefined;
     thread?: string | null | undefined;
     maker?: string | null | undefined;
     role?: string | undefined;

package/dist/message.schema.d.ts

@@ -15,9 +15,13 @@ export declare const MessageStatus: {
  * Message resource (aligned with xpod).
  *
  * Product semantics:
- * - Message belongs to a Chat counterpart.
- * - Thread is optional and appears only when a message participates in an
- *   explicit AI/task/branch timeline.
+ * - Message belongs to a neutral product scope: usually a Chat, sometimes a
+ *   Task/thread execution timeline.
+ * - Chat remains the Solid Chat compatibility relation. When present, the
+ *   message is written under the Chat message bucket and projected through
+ *   wf:message.
+ * - Thread is optional and appears when a message participates in an explicit
+ *   AI/task/branch timeline.
  *
  * Storage structure:
  * - Location: /.data/chat/{chat|id}/{yyyy}/{MM}/{dd}/messages.ttl#{id}
@@ -26,7 +30,8 @@ export declare const MessageStatus: {
  */
 export declare const messageResource: 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>;
-    chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+    scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
@@ -50,7 +55,8 @@ export declare const messageResource: import("@undefineds.co/drizzle-solid/dist/
 }>>;
 export declare const messageTable: 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>;
-    chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+    scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;

package/dist/message.schema.js

@@ -1,7 +1,8 @@
-import { object, podTable, uri, string, text, timestamp, id } from '@undefineds.co/drizzle-solid';
+import { object, podTable, uri, string, text, timestamp, id, renderDefaultIdTemplate } from '@undefineds.co/drizzle-solid';
 import { UDFS, DCTerms, FOAF, MEETING, SCHEMA, SIOC, WF } from './namespaces.js';
 import { chatResource } from './chat.schema.js';
 import { threadResource } from './thread.schema.js';
+import { resourceKey } from './resource-id-defaults.js';
 export const MessageRole = {
     USER: 'user',
     ASSISTANT: 'assistant',
@@ -17,9 +18,13 @@ export const MessageStatus = {
  * Message resource (aligned with xpod).
  *
  * Product semantics:
- * - Message belongs to a Chat counterpart.
- * - Thread is optional and appears only when a message participates in an
- *   explicit AI/task/branch timeline.
+ * - Message belongs to a neutral product scope: usually a Chat, sometimes a
+ *   Task/thread execution timeline.
+ * - Chat remains the Solid Chat compatibility relation. When present, the
+ *   message is written under the Chat message bucket and projected through
+ *   wf:message.
+ * - Thread is optional and appears when a message participates in an explicit
+ *   AI/task/branch timeline.
  *
  * Storage structure:
  * - Location: /.data/chat/{chat|id}/{yyyy}/{MM}/{dd}/messages.ttl#{id}
@@ -27,14 +32,27 @@ export const MessageStatus = {
  * - chat/thread are RDF URI relations. Short ids remain accepted at API/query call sites via ORM URI template resolution.
  */
 export const messageResource = podTable('chat_message', {
-    id: id('id').default('chat/{chat.key}/{yyyy}/{MM}/{dd}/messages.ttl#{key}'),
-    // Chat relation. In RDF this is an inverse Solid Chat link: <chat> wf:message <message>.
-    chat: uri('chat').predicate(WF.message).inverse().notNull().link(chatResource),
+    id: id('id').default((key, row) => (renderDefaultIdTemplate(row?.chat
+        ? 'chat/{chat.key}/{yyyy}/{MM}/{dd}/messages.ttl#{key}'
+        : row?.thread
+            ? '{thread.dir}/{yyyy}/{MM}/{dd}/messages.ttl#{key}'
+            : '{scope.dir}/{yyyy}/{MM}/{dd}/messages.ttl#{key}', {
+        key: resourceKey(key, 'msg'),
+        row,
+        links: {
+            chat: chatResource,
+            thread: threadResource,
+        },
+    }))),
+    // Canonical product owner scope. The object can be a Chat, Task, Thread, or future command surface.
+    scope: uri('scope').predicate(UDFS.inScope),
+    // Solid Chat compatibility relation. In RDF this is an inverse link: <chat> wf:message <message>.
+    chat: uri('chat').predicate(WF.message).inverse().link(chatResource),
     // Optional Thread relation. In RDF this is an inverse Solid Chat/SIOC link: <thread> sioc:has_member <message>.
     thread: uri('thread').predicate(SIOC.has_member).inverse().link(threadResource),
     // maker is the entity URI of the message author:
     // - User: their WebID (https://user.pod/profile/card#me)
-    // - AI: Agent URI (/agents/{id}/)
+    // - AI: Agent URI (/.data/agents/{id}/index.ttl#this)
     // - External: Contact URI (/.data/contacts/{id}.ttl#this)
     // No reference() constraint - accepts any valid URI.
     maker: uri('maker').predicate(FOAF.maker),

package/dist/namespaces.js

@@ -132,6 +132,7 @@ export const UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
     sortKey: 'sortKey',
     hasThread: 'hasThread',
     inThread: 'inThread',
+    inScope: 'inScope',
     participants: 'participants',
     message: 'message',
     messageContent: 'messageContent',
@@ -314,9 +315,7 @@ export const UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
     evidenceKind: 'evidenceKind',
     report: 'report',
     reportKind: 'reportKind',
-    subject: 'subject',
     outcome: 'outcome',
-    artifact: 'artifact',
     metricFacts: 'metricFacts',
     publishedAt: 'publishedAt',
     reviewer: 'reviewer',

package/dist/resource-identity.d.ts

@@ -0,0 +1,19 @@
+declare const baseRelativeResourceIdBrand: unique symbol;
+declare const resourceIriBrand: unique symbol;
+export type BaseRelativeResourceId = string & {
+    readonly [baseRelativeResourceIdBrand]: 'BaseRelativeResourceId';
+};
+export type ResourceIri = string & {
+    readonly [resourceIriBrand]: 'ResourceIri';
+};
+export declare function asBaseRelativeResourceId(value: string, label?: string): BaseRelativeResourceId;
+export declare function asResourceIri(value: string, label?: string): ResourceIri;
+export declare function requireRowResourceId(row: {
+    id?: string | null;
+} | null | undefined, label?: string): BaseRelativeResourceId;
+export declare function agentResourceId(key?: string | null): BaseRelativeResourceId;
+export declare function agentKeyFromResourceId(resourceId: string): string;
+export declare function agentKeyFromResourceRef(resourceRef: string): string;
+export declare function agentHomeDirFromResourceId(resourceId: string): BaseRelativeResourceId;
+export declare function agentHomePathFromResourceId(resourceId: string): string;
+export {};

package/dist/resource-identity.js

@@ -0,0 +1,68 @@
+const ABSOLUTE_IRI = /^[a-zA-Z][a-zA-Z\d+.-]*:/;
+const AGENT_RESOURCE_ID = /^([A-Za-z0-9_.-]+)\/index\.ttl#this$/;
+const AGENT_KEY = /^[A-Za-z0-9_.-]+$/;
+export function asBaseRelativeResourceId(value, label = 'Resource id') {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty base-relative resource id.`);
+    }
+    const normalized = value.trim();
+    if (ABSOLUTE_IRI.test(normalized) || normalized.startsWith('/') || normalized.startsWith('//')) {
+        throw new Error(`${label} must be a base-relative resource id.`);
+    }
+    return normalized;
+}
+export function asResourceIri(value, label = 'Resource IRI') {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty resource IRI.`);
+    }
+    const normalized = value.trim();
+    if (!ABSOLUTE_IRI.test(normalized)) {
+        throw new Error(`${label} must be a full resource IRI.`);
+    }
+    return normalized;
+}
+export function requireRowResourceId(row, label = 'Pod row') {
+    if (!row || typeof row.id !== 'string' || row.id.trim().length === 0) {
+        throw new Error(`${label} row is missing row.id.`);
+    }
+    return asBaseRelativeResourceId(row.id, `${label} row.id`);
+}
+function defaultAgentKey() {
+    return `agent_${Math.random().toString(36).slice(2, 12)}`;
+}
+export function agentResourceId(key) {
+    const raw = typeof key === 'string' ? key.trim() : '';
+    const value = raw || defaultAgentKey();
+    if (AGENT_RESOURCE_ID.test(value)) {
+        return asBaseRelativeResourceId(value, 'Agent resource id');
+    }
+    if (!AGENT_KEY.test(value)) {
+        throw new Error('Agent key must be a local key using letters, numbers, dot, underscore, or dash.');
+    }
+    return asBaseRelativeResourceId(`${value}/index.ttl#this`, 'Agent resource id');
+}
+export function agentKeyFromResourceId(resourceId) {
+    const id = asBaseRelativeResourceId(resourceId, 'Agent resource id');
+    const match = id.match(AGENT_RESOURCE_ID);
+    if (!match?.[1]) {
+        throw new Error('Agent resource id must use {agentKey}/index.ttl#this.');
+    }
+    return match[1];
+}
+export function agentKeyFromResourceRef(resourceRef) {
+    if (typeof resourceRef !== 'string' || resourceRef.trim().length === 0) {
+        throw new Error('Agent resource ref must be a non-empty Agent id or IRI.');
+    }
+    const normalized = resourceRef.trim();
+    const iriMatch = normalized.match(/\/\.data\/agents\/([A-Za-z0-9_.-]+)\/index\.ttl#this$/);
+    if (iriMatch?.[1]) {
+        return iriMatch[1];
+    }
+    return agentKeyFromResourceId(normalized);
+}
+export function agentHomeDirFromResourceId(resourceId) {
+    return asBaseRelativeResourceId(`${agentKeyFromResourceId(resourceId)}/`, 'Agent home dir');
+}
+export function agentHomePathFromResourceId(resourceId) {
+    return `/.data/agents/${agentKeyFromResourceId(resourceId)}/`;
+}

package/dist/schema.d.ts

@@ -116,6 +116,7 @@ export declare const solidResources: {
     }>>;
     threadResource: 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>;
+        scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
@@ -128,7 +129,8 @@ export declare const solidResources: {
     }>>;
     messageResource: 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>;
-        chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+        scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+        chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
@@ -626,6 +628,7 @@ export declare const solidSchema: {
     }>>;
     threadTable: 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>;
+        scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
@@ -638,7 +641,8 @@ export declare const solidSchema: {
     }>>;
     messageTable: 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>;
-        chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+        scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+        chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
         role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;

package/dist/skill.schema.js

@@ -1,6 +1,8 @@
 import { boolean, id, object, podTable, string, timestamp, uri } from '@undefineds.co/drizzle-solid';
 import { agentResource } from './agent.schema.js';
 import { DCTerms, UDFS } from './namespaces.js';
+import { resourceKey } from './resource-id-defaults.js';
+import { agentKeyFromResourceRef } from './resource-identity.js';
 /**
  * Skill binding resource.
  *
@@ -8,7 +10,10 @@ import { DCTerms, UDFS } from './namespaces.js';
  * binding and lightweight load metadata; it does not duplicate full skill text.
  */
 export const skillResource = podTable('skill', {
-    id: id('id').default('{agent.key}/skills/{key}/'),
+    id: id('id').default((key, row) => {
+        const agentRef = typeof row?.agent === 'string' ? row.agent : '';
+        return `${agentKeyFromResourceRef(agentRef)}/skills/${resourceKey(key, 'skill')}/`;
+    }),
     agent: uri('agent').predicate(UDFS.agent).notNull().link(agentResource),
     root: uri('root').predicate(UDFS.root),
     name: string('name').predicate(UDFS.name).notNull(),
@@ -22,8 +27,8 @@ export const skillResource = podTable('skill', {
     createdAt: timestamp('createdAt').predicate(DCTerms.created).notNull().defaultNow(),
     updatedAt: timestamp('updatedAt').predicate(DCTerms.modified).notNull().defaultNow(),
 }, {
-    base: '/agents/',
-    sparqlEndpoint: '/agents/-/sparql',
+    base: '/.data/agents/',
+    sparqlEndpoint: '/.data/agents/-/sparql',
     type: UDFS.Skill,
     namespace: UDFS,
 });

package/dist/thread.repository.d.ts

@@ -1,5 +1,6 @@
 export declare const threadRepository: 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>;
+    scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
@@ -11,6 +12,7 @@ export declare const threadRepository: import("@undefineds.co/drizzle-solid/dist
     updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
 }>>, {
     id: string;
+    scope: string;
     chat: string;
     task: string;
     title: string;
@@ -22,6 +24,7 @@ export declare const threadRepository: import("@undefineds.co/drizzle-solid/dist
     updatedAt: Date;
 }, {
     id?: string | undefined;
+    scope?: string | undefined;
     chat?: string | undefined;
     task?: string | undefined;
     title?: string | undefined;
@@ -33,6 +36,7 @@ export declare const threadRepository: import("@undefineds.co/drizzle-solid/dist
     updatedAt?: Date | undefined;
 }, {
     id?: string | null | undefined;
+    scope?: string | null | undefined;
     chat?: string | null | undefined;
     task?: string | null | undefined;
     title?: string | null | undefined;

package/dist/thread.schema.d.ts

@@ -10,6 +10,10 @@ export declare const ThreadStatus: {
  * Product semantics:
  * - Thread is the implicit concrete timeline/place under exactly one surface:
  *   Chat for conversation timelines, or Task for task execution timelines.
+ * - `scope` is the neutral LinX ownership relation for that surface. When the
+ *   scope is a Chat, also write `chat` so Solid Chat clients can keep using
+ *   sioc:has_parent. When the scope is a Task, also write `task` for workflow
+ *   indexes.
  * - AI product runtime sessions map to Thread when they represent a concrete
  *   conversation timeline/place/run.
  * - Thread carries workspace/place relations and runtime metadata. Chat only
@@ -29,6 +33,7 @@ export declare const ThreadStatus: {
  */
 export declare const threadResource: 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>;
+    scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
@@ -41,6 +46,7 @@ export declare const threadResource: import("@undefineds.co/drizzle-solid/dist/c
 }>>;
 export declare const threadTable: 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>;
+    scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
     title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;

package/dist/thread.schema.js

@@ -14,6 +14,10 @@ export const ThreadStatus = {
  * Product semantics:
  * - Thread is the implicit concrete timeline/place under exactly one surface:
  *   Chat for conversation timelines, or Task for task execution timelines.
+ * - `scope` is the neutral LinX ownership relation for that surface. When the
+ *   scope is a Chat, also write `chat` so Solid Chat clients can keep using
+ *   sioc:has_parent. When the scope is a Task, also write `task` for workflow
+ *   indexes.
  * - AI product runtime sessions map to Thread when they represent a concrete
  *   conversation timeline/place/run.
  * - Thread carries workspace/place relations and runtime metadata. Chat only
@@ -32,9 +36,11 @@ export const ThreadStatus = {
  *   container URI here and store portable metadata with that container/resource.
  */
 export const threadResource = podTable('thread', {
-    id: id('id').default((key, row) => (renderDefaultIdTemplate(row?.task
-        ? 'task/{task.key}/index.ttl#{key}'
-        : 'chat/{chat.key}/index.ttl#{key}', {
+    id: id('id').default((key, row) => (renderDefaultIdTemplate(row?.chat
+        ? 'chat/{chat.key}/index.ttl#{key}'
+        : row?.task
+            ? 'task/{task.key}/index.ttl#{key}'
+            : '{scope.dir}/index.ttl#{key}', {
         key: resourceKey(key, 'thread'),
         row,
         links: {
@@ -42,9 +48,11 @@ export const threadResource = podTable('thread', {
             task: taskResource,
         },
     }))),
-    // Owner surface for conversation timelines. Do not set together with `task`.
+    // Canonical product owner surface. The object can be a Chat, Task, or future command surface.
+    scope: uri('scope').predicate(UDFS.inScope),
+    // Solid Chat compatibility owner for conversation timelines. Do not set together with `task`.
     chat: uri('chat').predicate(SIOC.has_parent).link(chatResource),
-    // Owner surface for task execution timelines. Do not set together with `chat`.
+    // Workflow compatibility/index owner for task execution timelines. Do not set together with `chat`.
     task: uri('task').predicate(UDFS.task).link(taskResource),
     // Display / state
     title: string('title').predicate(DCTerms.title),

package/dist/vocab/message.vocab.d.ts

@@ -1,4 +1,5 @@
 export declare const MessageVocab: {
+    readonly scope: string;
     readonly thread: string;
     readonly chat: string;
     readonly maker: string;

package/dist/vocab/message.vocab.js

@@ -1,6 +1,7 @@
 import { DCTerms, FOAF, SCHEMA, SIOC, UDFS, WF } from '../namespaces.js';
 export const MessageVocab = {
     // Existing
+    scope: UDFS.inScope,
     thread: SIOC.has_member,
     chat: WF.message,
     maker: FOAF.maker,

package/dist/vocab/thread.vocab.d.ts

@@ -1,4 +1,5 @@
 export declare const ThreadVocab: {
+    readonly scope: string;
     readonly chat: string;
     readonly task: string;
     readonly title: string;

package/dist/vocab/thread.vocab.js

@@ -1,5 +1,6 @@
 import { DCTerms, SIOC, UDFS } from '../namespaces.js';
 export const ThreadVocab = {
+    scope: UDFS.inScope,
     chat: SIOC.has_parent,
     task: UDFS.task,
     title: DCTerms.title,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/models",
-  "version": "0.2.36",
+  "version": "0.2.38",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",

package/skills/solid-modeling/SKILL.md

@@ -36,9 +36,14 @@ Before adding a schema, decide what the resource fundamentally is.
 - File-primary resources have a meaningful body: markdown, JSONL, source file,
   artifact, uploaded file, or generated report. Examples include `Spec`,
   `Plan`, `Report`, and most `Evidence`.
-- For file-primary resources, model the queryable metadata: subject, kind,
-  status or outcome, actor/reviewer, evidence links, revision, body/artifact
-  URI, and relations to the controlling issue/task/run.
+- For file-primary resources, model only queryable metadata: aboutness, kind,
+  status or outcome, abstract/summary when it is needed for indexing,
+  actor/reviewer, evidence links, revision, and relations to the controlling
+  issue/task/run.
+- Evidence is file-primary when the proof body is a log, diff, patch,
+  transcript, screenshot, or report. Keep the body as a Pod file and store only
+  queryable metadata in TTL; use `schema:about` for the control object and
+  `dcterms:source` for the concrete evidence file when needed.
 - Do not create a parallel model just because a file needs metadata. Add schema
   fields only for facts that must be searched, joined, synchronized, audited, or
   used for routing/recovery across clients.
@@ -170,8 +175,9 @@ Use these concepts consistently across products:
   triggered, or one-off task intent.
 - `Thread`: implicit concrete timeline/place under exactly one command surface:
   Chat for conversation timelines, or Task for task execution timelines.
-- `Message`: human/runtime communication item in a Chat, optionally linked to a
-  Thread when it participates in an AI/task/branch timeline.
+- `Message`: human/runtime communication item in a command scope. It usually
+  belongs to a Chat, but task/runtime messages may belong to a Task or Thread
+  scope without inventing a Chat.
 - `Run`: one concrete execution attempt by an Agent Runtime.
 - `RunStep`: append-only execution facts for a Run.
 
@@ -185,11 +191,18 @@ Align with graph semantics:
 
 | Concept | Preferred RDF direction | Typical predicate |
 |---|---|---|
+| resource belongs to command scope | `resource -> scope` | `udfs:inScope` |
 | chat contains message | `chat -> message` | `wf:message` / project vocabulary |
+| chat owns thread | `thread -> chat` | `sioc:has_parent` for compatibility |
 | thread contains message | `thread -> message` | `sioc:has_member` or equivalent |
 | reply points to original | `replyMessage -> originalMessage` | `sioc:has_reply` / project predicate |
 | author/maker | `message -> maker` | `foaf:maker` |
 
+Use `udfs:inScope` for LinX product semantics when a Thread or Message can
+belong to either Chat or Task. Preserve Solid Chat compatibility by also writing
+`sioc:has_parent` for Chat-scoped Threads and `wf:message` for Chat-scoped
+Messages. Do not stretch Solid Chat predicates to mean Task ownership.
+
 When inverse predicates are supported, use them for read/write symmetry. If the
 ORM cannot safely express the inverse write, put the relation writer in the
 repository and cover it with integration tests.