@jskit-ai/assistant 0.1.30 → 0.1.31

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/assistant",
-  version: "0.1.30",
+  version: "0.1.31",
   kind: "runtime",
   description: "Unified assistant module with streaming chat, transcript persistence, service-aware tool execution, and workspace UI.",
   options: {
@@ -110,14 +110,14 @@ export default Object.freeze({
   mutations: {
     dependencies: {
       runtime: {
-        "@jskit-ai/assistant": "0.1.30",
-        "@jskit-ai/auth-core": "0.1.21",
-        "@jskit-ai/database-runtime": "0.1.22",
-        "@jskit-ai/http-runtime": "0.1.21",
-        "@jskit-ai/kernel": "0.1.22",
-        "@jskit-ai/realtime": "0.1.21",
-        "@jskit-ai/users-core": "0.1.31",
-        "@jskit-ai/users-web": "0.1.36",
+        "@jskit-ai/assistant": "0.1.31",
+        "@jskit-ai/auth-core": "0.1.22",
+        "@jskit-ai/database-runtime": "0.1.23",
+        "@jskit-ai/http-runtime": "0.1.22",
+        "@jskit-ai/kernel": "0.1.23",
+        "@jskit-ai/realtime": "0.1.22",
+        "@jskit-ai/users-core": "0.1.32",
+        "@jskit-ai/users-web": "0.1.37",
         "@tanstack/vue-query": "^5.90.5",
         "dompurify": "^3.3.3",
         "marked": "^17.0.4",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/assistant",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -12,14 +12,14 @@
     "./shared": "./src/shared/index.js"
   },
   "dependencies": {
-    "@jskit-ai/auth-core": "0.1.21",
-    "@jskit-ai/database-runtime": "0.1.22",
-    "@jskit-ai/http-runtime": "0.1.21",
-    "@jskit-ai/kernel": "0.1.22",
-    "@jskit-ai/realtime": "0.1.21",
-    "@jskit-ai/shell-web": "0.1.21",
-    "@jskit-ai/users-core": "0.1.31",
-    "@jskit-ai/users-web": "0.1.36",
+    "@jskit-ai/auth-core": "0.1.22",
+    "@jskit-ai/database-runtime": "0.1.23",
+    "@jskit-ai/http-runtime": "0.1.22",
+    "@jskit-ai/kernel": "0.1.23",
+    "@jskit-ai/realtime": "0.1.22",
+    "@jskit-ai/shell-web": "0.1.22",
+    "@jskit-ai/users-core": "0.1.32",
+    "@jskit-ai/users-web": "0.1.37",
     "@tanstack/vue-query": "^5.90.5",
     "dompurify": "^3.3.3",
     "marked": "^17.0.4",

package/src/server/repositories/conversationsRepository.js

@@ -21,7 +21,7 @@ function mapConversationRow(row = {}) {
     status: String(row.status || "active"),
     provider: String(row.provider || ""),
     model: String(row.model || ""),
-    surfaceId: String(row.surface_id || ""),
+    surfaceSid: String(row.surface_sid || ""),
     startedAt: toIso(row.started_at),
     endedAt: row.ended_at ? toIso(row.ended_at) : null,
     messageCount: Number(row.message_count || 0),
@@ -101,7 +101,7 @@ function createConversationsRepository(knex) {
       status: normalizeText(payload.status).toLowerCase() || "active",
       provider: normalizeText(payload.provider),
       model: normalizeText(payload.model),
-      surface_id: normalizeText(payload.surfaceId).toLowerCase() || "admin",
+      surface_sid: normalizeText(payload.surfaceSid).toLowerCase() || "admin",
       message_count: parsePositiveInteger(payload.messageCount) || 0,
       metadata_json: stringifyJsonObject(payload.metadata),
       started_at: payload.startedAt ? new Date(payload.startedAt) : now,
@@ -140,8 +140,8 @@ function createConversationsRepository(knex) {
     if (Object.hasOwn(patch, "model")) {
       updatePatch.model = normalizeText(patch.model);
     }
-    if (Object.hasOwn(patch, "surfaceId")) {
-      updatePatch.surface_id = normalizeText(patch.surfaceId).toLowerCase() || "admin";
+    if (Object.hasOwn(patch, "surfaceSid")) {
+      updatePatch.surface_sid = normalizeText(patch.surfaceSid).toLowerCase() || "admin";
     }
     if (Object.hasOwn(patch, "messageCount")) {
       updatePatch.message_count = Math.max(0, Number(patch.messageCount || 0));

package/src/server/repositories/messagesRepository.js

@@ -16,7 +16,7 @@ function mapMessageRow(row = {}) {
     seq: Number(row.seq),
     role: String(row.role || ""),
     kind: String(row.kind || "chat"),
-    clientMessageId: String(row.client_message_id || ""),
+    clientMessageSid: String(row.client_message_sid || ""),
     actorUserId: row.actor_user_id == null ? null : Number(row.actor_user_id),
     contentText: row.content_text == null ? null : String(row.content_text),
     metadata: parseJsonObject(row.metadata_json),
@@ -75,7 +75,7 @@ function createMessagesRepository(knex) {
       seq,
       role: normalizeText(payload.role).toLowerCase(),
       kind: normalizeText(payload.kind).toLowerCase() || "chat",
-      client_message_id: normalizeText(payload.clientMessageId),
+      client_message_sid: normalizeText(payload.clientMessageSid),
       actor_user_id: parsePositiveInteger(payload.actorUserId) || null,
       content_text: payload.contentText == null ? null : String(payload.contentText),
       metadata_json: stringifyJsonObject(payload.metadata),

package/src/server/services/chatService.js

@@ -561,7 +561,7 @@ function createChatService({ aiClient, transcriptService, serviceToolCatalog, as
         conversationId: source.conversationId,
         provider: aiClient.provider,
         model: aiClient.defaultModel,
-        surfaceId: context.surface,
+        surfaceSid: context.surface,
         messageId: source.messageId
       },
       {
@@ -580,10 +580,10 @@ function createChatService({ aiClient, transcriptService, serviceToolCatalog, as
       {
         role: "user",
         kind: "chat",
-        clientMessageId: source.messageId,
+        clientMessageSid: source.messageId,
         contentText: source.input,
         metadata: {
-          surfaceId: normalizeText(context.surface)
+          surfaceSid: normalizeText(context.surface)
         }
       },
       {

package/src/server/services/transcriptService.js

@@ -155,7 +155,7 @@ function createTranscriptService({ conversationsRepository, messagesRepository }
       status: "active",
       provider: normalizeText(source.provider),
       model: normalizeText(source.model),
-      surfaceId: normalizeText(source.surfaceId).toLowerCase() || "admin",
+      surfaceSid: normalizeText(source.surfaceSid).toLowerCase() || "admin",
       metadata: {
         firstMessageId: normalizeText(source.messageId)
       }
@@ -186,7 +186,7 @@ function createTranscriptService({ conversationsRepository, messagesRepository }
       workspaceId: conversation.workspaceId,
       role: normalizeText(source.role).toLowerCase(),
       kind: normalizeText(source.kind).toLowerCase() || "chat",
-      clientMessageId: normalizeText(source.clientMessageId),
+      clientMessageSid: normalizeText(source.clientMessageSid),
       actorUserId,
       contentText: source.contentText == null ? null : String(source.contentText),
       metadata: normalizeObject(source.metadata)

package/src/shared/assistantResource.js

@@ -126,7 +126,7 @@ function normalizeConversationRecord(payload = {}) {
     status: normalizeText(source.status),
     provider: normalizeText(source.provider),
     model: normalizeText(source.model),
-    surfaceId: normalizeText(source.surfaceId),
+    surfaceSid: normalizeText(source.surfaceSid),
     startedAt: normalizeText(source.startedAt),
     endedAt: normalizeText(source.endedAt) || null,
     messageCount: Math.max(0, Number(source.messageCount || 0)),
@@ -146,7 +146,7 @@ function normalizeConversationMessageRecord(payload = {}) {
     seq: toPositiveInteger(source.seq, 0),
     role: normalizeText(source.role),
     kind: normalizeText(source.kind),
-    clientMessageId: normalizeText(source.clientMessageId),
+    clientMessageSid: normalizeText(source.clientMessageSid),
     actorUserId: toPositiveInteger(source.actorUserId, 0) || null,
     contentText: source.contentText == null ? null : String(source.contentText),
     metadata: normalizeObjectInput(source.metadata),
@@ -196,7 +196,7 @@ const conversationRecordSchema = Type.Object(
     status: Type.String(),
     provider: Type.String(),
     model: Type.String(),
-    surfaceId: Type.String(),
+    surfaceSid: Type.String(),
     startedAt: Type.String({ minLength: 1 }),
     endedAt: Type.Union([Type.String({ minLength: 1 }), Type.Null()]),
     messageCount: Type.Integer({ minimum: 0 }),
@@ -220,7 +220,7 @@ const messageRecordSchema = Type.Object(
     seq: Type.Integer({ minimum: 1 }),
     role: Type.String({ minLength: 1 }),
     kind: Type.String({ minLength: 1 }),
-    clientMessageId: Type.String(),
+    clientMessageSid: Type.String(),
     actorUserId: Type.Union([Type.Integer({ minimum: 1 }), Type.Null()]),
     contentText: Type.Union([Type.String(), Type.Null()]),
     metadata: Type.Record(Type.String(), Type.Unknown()),

package/templates/migrations/assistant_transcripts_initial.cjs

@@ -3,13 +3,13 @@ exports.up = async function up(knex) {
   if (!hasConversationsTable) {
     await knex.schema.createTable("ai_conversations", (table) => {
       table.increments("id").unsigned().primary();
-      table.integer("workspace_id").unsigned().notNullable().index();
-      table.integer("created_by_user_id").unsigned().nullable().index();
+      table.integer("workspace_id").unsigned().notNullable().references("id").inTable("workspaces").onDelete("CASCADE").index();
+      table.integer("created_by_user_id").unsigned().nullable().references("id").inTable("users").onDelete("SET NULL").index();
       table.string("title", 160).notNullable().defaultTo("New conversation");
       table.string("status", 32).notNullable().defaultTo("active");
       table.string("provider", 64).notNullable().defaultTo("");
       table.string("model", 128).notNullable().defaultTo("");
-      table.string("surface_id", 32).notNullable().defaultTo("admin");
+      table.string("surface_sid", 32).notNullable().defaultTo("admin");
       table.integer("message_count").unsigned().notNullable().defaultTo(0);
       table.text("metadata_json").nullable();
       table.timestamp("started_at").notNullable().defaultTo(knex.fn.now());
@@ -27,12 +27,12 @@ exports.up = async function up(knex) {
     await knex.schema.createTable("ai_messages", (table) => {
       table.increments("id").unsigned().primary();
       table.integer("conversation_id").unsigned().notNullable().references("id").inTable("ai_conversations").onDelete("CASCADE");
-      table.integer("workspace_id").unsigned().notNullable().index();
+      table.integer("workspace_id").unsigned().notNullable().references("id").inTable("workspaces").onDelete("CASCADE").index();
       table.integer("seq").unsigned().notNullable();
       table.string("role", 32).notNullable();
       table.string("kind", 32).notNullable().defaultTo("chat");
-      table.string("client_message_id", 128).notNullable().defaultTo("");
-      table.integer("actor_user_id").unsigned().nullable().index();
+      table.string("client_message_sid", 128).notNullable().defaultTo("");
+      table.integer("actor_user_id").unsigned().nullable().references("id").inTable("users").onDelete("SET NULL").index();
       table.text("content_text").nullable();
       table.text("metadata_json").nullable();
       table.timestamp("created_at").notNullable().defaultTo(knex.fn.now());

package/test/assistantResource.test.js

@@ -25,7 +25,7 @@ test("assistant output schemas accept normalized paginated payloads", () => {
       status: "active",
       provider: "openai",
       model: "gpt-4.1",
-      surfaceId: "admin",
+      surfaceSid: "admin",
       startedAt: "2026-03-16T10:00:00.000Z",
       endedAt: null,
       messageCount: 2,

package/test/transcriptService.test.js

@@ -40,7 +40,7 @@ function createInMemoryTranscriptRepos({
         status: String(payload.status || "active"),
         provider: String(payload.provider || ""),
         model: String(payload.model || ""),
-        surfaceId: String(payload.surfaceId || "admin"),
+        surfaceSid: String(payload.surfaceSid || "admin"),
         messageCount: Number(payload.messageCount || 0),
         metadata: payload.metadata || {}
       };