@undefineds.co/models 0.2.2 → 0.2.11

package/dist/session/session.schema.js

@@ -1,32 +1,36 @@
 import { object, podTable, string, timestamp, uri, id, integer } from '@undefineds.co/drizzle-solid';
 import { DCTerms, UDFS } from '../namespaces.js';
+import { chatResource } from '../chat.schema.js';
+import { threadResource } from '../thread.schema.js';
 /**
- * Runtime / collaboration session schema.
+ * Runtime / collaboration session resource.
  *
- * This is the durable session truth layer for Pi/xpod-aligned runtime state.
+ * This preserves generic AI product runtime/session lifecycle state.
  * It is intentionally separate from:
  * - UI-only local state (focus, draft text, scroll position, expand/collapse)
  * - transient transport/session-manager internals
+ * - the durable conversation timeline, which is Thread
  *
  * Storage structure:
  * - Location: /.data/session/{id}.ttl
- * - Primary use: durable cross-app session state / lifecycle projection
+ * - Primary use: runtime lifecycle projection for a concrete Thread
  *
- * Contract notes for this baseline:
+ * Contract notes:
+ * - Chat identifies the counterpart/conversation object.
+ * - Thread identifies the concrete conversation timeline/place/run. AI product
+ *   runtime sessions map to Thread; this Session resource records lifecycle state
+ *   and points to that Thread.
  * - `archived` is a persistence-layer/session-lifecycle status; interactive runtime
  *   surfaces may continue to use the narrower active/paused/completed/error subset
  *   until they explicitly adopt archival semantics.
- * - `chatId` and `threadId` are intentionally stored as opaque string references for
- *   now. This keeps the initial session baseline decoupled from any single runtime or
- *   RDF-linking strategy while the writer/reader contract is still being designed.
  * - `tool` is intentionally open-string in this baseline so the durable table does not
  *   prematurely overfit to today's sidecar enum before all writers are aligned.
  */
-export const sessionTable = podTable('session', {
+export const sessionResource = podTable('session', {
     id: id('id'),
     ownerWebId: uri('ownerWebId').predicate(UDFS.actor).notNull(),
-    chatId: string('chatId').predicate(UDFS.conversation),
-    threadId: string('threadId').predicate(UDFS.inThread),
+    chat: uri('chat').predicate(UDFS.conversation).link(chatResource),
+    thread: uri('thread').predicate(UDFS.inThread).link(threadResource),
     sessionType: string('sessionType').predicate(UDFS.conversationType).notNull().default('direct'),
     status: string('status').predicate(UDFS.sessionStatus).notNull().default('active'),
     tool: string('tool').predicate(UDFS.sessionTool),
@@ -44,3 +48,5 @@ export const sessionTable = podTable('session', {
     namespace: UDFS,
     subjectTemplate: '{id}.ttl',
 });
+// Compatibility alias. New model code should prefer `sessionResource`.
+export const sessionTable = sessionResource;

package/dist/session.repository.d.ts

@@ -1,8 +1,8 @@
 export declare const sessionRepository: import("./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>;
     ownerWebId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
-    chatId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
-    threadId: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", 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>;
     sessionType: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
     status: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
     tool: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
@@ -16,8 +16,8 @@ export declare const sessionRepository: import("./repository").PodRepositoryDesc
 }>>, {
     id: string;
     ownerWebId: string;
-    chatId: string;
-    threadId: string;
+    chat: string;
+    thread: string;
     sessionType: string;
     status: string;
     tool: string;
@@ -31,8 +31,8 @@ export declare const sessionRepository: import("./repository").PodRepositoryDesc
 }, {
     ownerWebId: string;
     id?: string | undefined;
-    chatId?: string | undefined;
-    threadId?: string | undefined;
+    chat?: string | undefined;
+    thread?: string | undefined;
     sessionType?: string | undefined;
     status?: string | undefined;
     tool?: string | undefined;
@@ -46,8 +46,8 @@ export declare const sessionRepository: import("./repository").PodRepositoryDesc
 }, {
     id?: string | null | undefined;
     ownerWebId?: string | undefined;
-    chatId?: string | null | undefined;
-    threadId?: string | null | undefined;
+    chat?: string | null | undefined;
+    thread?: string | null | undefined;
     sessionType?: string | undefined;
     status?: string | undefined;
     tool?: string | null | undefined;

package/dist/session.repository.js

@@ -3,6 +3,6 @@ import { sessionTable, } from './session/index.js';
 export const sessionRepository = definePodRepository({
     namespace: 'session',
     table: sessionTable,
-    searchableFields: ['chatId', 'threadId', 'status', 'tool'],
+    searchableFields: ['chat', 'thread', 'status', 'tool'],
     defaultSort: { field: 'updatedAt', direction: 'desc' },
 });

package/dist/sidecar/sidecar-events.d.ts

@@ -151,9 +151,9 @@ export declare const SessionStateEventV1Schema: z.ZodObject<{
     tokenUsage: number;
     type: "session.state";
     tool: "claude-code" | "cursor" | "windsurf";
-    chatId: string;
     sessionId: string;
     timestamp: string;
+    chatId: string;
     previousStatus: string;
     policy?: string | undefined;
     policyVersion?: string | undefined;
@@ -163,9 +163,9 @@ export declare const SessionStateEventV1Schema: z.ZodObject<{
     tokenUsage: number;
     type: "session.state";
     tool: "claude-code" | "cursor" | "windsurf";
-    chatId: string;
     sessionId: string;
     timestamp: string;
+    chatId: string;
     previousStatus: string;
     policy?: string | undefined;
     policyVersion?: string | undefined;
@@ -188,9 +188,9 @@ export declare const SessionStateEventSchema: z.ZodObject<{
     tokenUsage: number;
     type: "session.state";
     tool: "claude-code" | "cursor" | "windsurf";
-    chatId: string;
     sessionId: string;
     timestamp: string;
+    chatId: string;
     previousStatus: string;
     policy?: string | undefined;
     policyVersion?: string | undefined;
@@ -200,9 +200,9 @@ export declare const SessionStateEventSchema: z.ZodObject<{
     tokenUsage: number;
     type: "session.state";
     tool: "claude-code" | "cursor" | "windsurf";
-    chatId: string;
     sessionId: string;
     timestamp: string;
+    chatId: string;
     previousStatus: string;
     policy?: string | undefined;
     policyVersion?: string | undefined;
@@ -504,9 +504,9 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     tokenUsage: number;
     type: "session.state";
     tool: "claude-code" | "cursor" | "windsurf";
-    chatId: string;
     sessionId: string;
     timestamp: string;
+    chatId: string;
     previousStatus: string;
     policy?: string | undefined;
     policyVersion?: string | undefined;
@@ -516,9 +516,9 @@ export declare const SidecarEventSchema: z.ZodUnion<[z.ZodObject<{
     tokenUsage: number;
     type: "session.state";
     tool: "claude-code" | "cursor" | "windsurf";
-    chatId: string;
     sessionId: string;
     timestamp: string;
+    chatId: string;
     previousStatus: string;
     policy?: string | undefined;
     policyVersion?: string | undefined;

package/dist/thread.schema.d.ts

@@ -1,13 +1,18 @@
 /**
- * Thread schema.
+ * Thread resource.
  *
- * CP0 baseline:
- * - Chat is a pure channel/place.
- * - Thread carries execution context needed for collaboration/audit.
+ * Product semantics:
+ * - Thread is the concrete conversation timeline/place under a Chat.
+ * - AI product runtime sessions map to Thread when they represent a concrete
+ *   conversation timeline/place/run.
+ * - Thread carries workspace/runtime/place metadata. Chat only identifies the
+ *   counterpart/conversation object.
+ * - Product/runtime-specific ids should stay in metadata as `runtimeSessionId`,
+ *   `runtime`, `surface`, etc. Do not name the generic thread id `piSessionId`.
  *
  * Storage structure (aligned with xpod):
  * - Thread stored as fragment in Chat's index.ttl
- * - Location: /.data/chat/{chat}/index.ttl#{id}
+ * - Location: /.data/chat/{chat|id}/index.ttl#{id}
  *
  * NOTE:
  * - `thread.workspace` is a storage-layer reference (URI) to a container/resource in CSS/Pod.
@@ -15,6 +20,16 @@
  * - Runtime path/copy is an execution-time interface shape; persistence should keep the
  *   container URI here and store portable metadata with that container/resource.
  */
+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>;
+    chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
+    title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
+    starred: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"boolean", null, false, true>;
+    workspace: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
+    metadata: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"object", null, false, false>;
+    createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
+    updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
+}>>;
 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>;
     chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
@@ -25,6 +40,6 @@ export declare const threadTable: import("@undefineds.co/drizzle-solid/dist/core
     createdAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
     updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
 }>>;
-export type ThreadRow = typeof threadTable.$inferSelect;
-export type ThreadInsert = typeof threadTable.$inferInsert;
-export type ThreadUpdate = typeof threadTable.$inferUpdate;
+export type ThreadRow = typeof threadResource.$inferSelect;
+export type ThreadInsert = typeof threadResource.$inferInsert;
+export type ThreadUpdate = typeof threadResource.$inferUpdate;

package/dist/thread.schema.js

@@ -1,15 +1,21 @@
 import { uri, boolean, object, podTable, string, timestamp, id } from '@undefineds.co/drizzle-solid';
 import { UDFS, DCTerms, SIOC, LINX_CHAT } from './namespaces.js';
+import { chatResource } from './chat.schema.js';
 /**
- * Thread schema.
+ * Thread resource.
  *
- * CP0 baseline:
- * - Chat is a pure channel/place.
- * - Thread carries execution context needed for collaboration/audit.
+ * Product semantics:
+ * - Thread is the concrete conversation timeline/place under a Chat.
+ * - AI product runtime sessions map to Thread when they represent a concrete
+ *   conversation timeline/place/run.
+ * - Thread carries workspace/runtime/place metadata. Chat only identifies the
+ *   counterpart/conversation object.
+ * - Product/runtime-specific ids should stay in metadata as `runtimeSessionId`,
+ *   `runtime`, `surface`, etc. Do not name the generic thread id `piSessionId`.
  *
  * Storage structure (aligned with xpod):
  * - Thread stored as fragment in Chat's index.ttl
- * - Location: /.data/chat/{chat}/index.ttl#{id}
+ * - Location: /.data/chat/{chat|id}/index.ttl#{id}
  *
  * NOTE:
  * - `thread.workspace` is a storage-layer reference (URI) to a container/resource in CSS/Pod.
@@ -17,10 +23,10 @@ import { UDFS, DCTerms, SIOC, LINX_CHAT } from './namespaces.js';
  * - Runtime path/copy is an execution-time interface shape; persistence should keep the
  *   container URI here and store portable metadata with that container/resource.
  */
-export const threadTable = podTable('thread', {
+export const threadResource = podTable('thread', {
     id: id('id'),
-    // Belongs to chat. Stored as an RDF URI; short ids are resolved via chatTable's URI template by the ORM.
-    chat: uri('chat').predicate(SIOC.has_parent).notNull().link('chats'),
+    // Belongs to chat/counterpart. Stored as an RDF URI; short ids are resolved via chatResource's URI template by the ORM.
+    chat: uri('chat').predicate(SIOC.has_parent).notNull().link(chatResource),
     // Display / state
     title: string('title').predicate(DCTerms.title),
     starred: boolean('starred').predicate(UDFS.favorite).default(false),
@@ -35,5 +41,7 @@ export const threadTable = podTable('thread', {
     sparqlEndpoint: '/.data/chat/-/sparql',
     type: SIOC.Thread,
     namespace: UDFS,
-    subjectTemplate: '{chat}/index.ttl#{id}',
+    subjectTemplate: '{chat|id}/index.ttl#{id}',
 });
+// Compatibility alias. New model code should prefer `threadResource`.
+export const threadTable = threadResource;

package/dist/vocab/chat.vocab.js

@@ -14,7 +14,7 @@ export const ChatBaseVocab = {
     unreadCount: UDFS.unreadCount,
     // Activity
     lastActiveAt: UDFS.lastActiveAt,
-    lastMessageId: WF.message,
+    lastMessageId: UDFS.lastMessage,
     lastMessagePreview: SCHEMA.text,
     // Timestamps
     createdAt: DCTerms.created,

package/package.json

@@ -1,10 +1,8 @@
 {
   "name": "@undefineds.co/models",
-  "version": "0.2.2",
+  "version": "0.2.11",
   "private": false,
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -53,7 +51,9 @@
   },
   "dependencies": {
     "@comunica/query-sparql-solid": "^4.0.2",
-    "@undefineds.co/drizzle-solid": "^0.3.5",
+    "@inrupt/vocab-common-rdf": "^1.0.5",
+    "@undefineds.co/drizzle-solid": "^0.3.8",
+    "n3": "^1.26.0",
     "zod": "^3.22.4"
   },
   "devDependencies": {
@@ -61,16 +61,13 @@
     "typescript": "^5.4.0",
     "vitest": "^1.6.0"
   },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "files": [
     "dist",
     "README.md",
     "package.json"
   ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/undefinedsco/LinX.git",
-    "directory": "packages/models"
-  },
   "publishConfig": {
     "access": "public"
   }