@jskit-ai/assistant 0.1.11 → 0.1.13

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/assistant",
-  version: "0.1.11",
+  version: "0.1.13",
   description: "Unified assistant module with streaming chat, transcript persistence, service-aware tool execution, and workspace UI.",
   options: {
     "ai-provider": {
@@ -110,14 +110,14 @@ export default Object.freeze({
   mutations: {
     dependencies: {
       runtime: {
-        "@jskit-ai/assistant": "0.1.11",
+        "@jskit-ai/assistant": "0.1.13",
         "@jskit-ai/auth-core": "0.1.8",
         "@jskit-ai/database-runtime": "0.1.8",
         "@jskit-ai/http-runtime": "0.1.8",
         "@jskit-ai/kernel": "0.1.8",
         "@jskit-ai/realtime": "0.1.8",
-        "@jskit-ai/users-core": "0.1.11",
-        "@jskit-ai/users-web": "0.1.11",
+        "@jskit-ai/users-core": "0.1.10",
+        "@jskit-ai/users-web": "0.1.13",
         "@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.11",
+  "version": "0.1.13",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -19,8 +19,8 @@
     "@jskit-ai/kernel": "0.1.8",
     "@jskit-ai/realtime": "0.1.8",
     "@jskit-ai/shell-web": "0.1.8",
-    "@jskit-ai/users-core": "0.1.11",
-    "@jskit-ai/users-web": "0.1.11",
+    "@jskit-ai/users-core": "0.1.10",
+    "@jskit-ai/users-web": "0.1.13",
     "@tanstack/vue-query": "^5.90.5",
     "dompurify": "^3.3.3",
     "marked": "^17.0.4",

package/src/client/components/AssistantClientElement.vue

@@ -248,8 +248,10 @@ import { computed, nextTick, onActivated, onBeforeUnmount, onMounted, ref, shall
 import { createComponentInteractionEmitter } from "@jskit-ai/kernel/client";
 import {
   normalizeObject,
+  normalizeText,
   normalizeOneOf
 } from "@jskit-ai/kernel/shared/support/normalize";
+import { normalizeConversationStatus as normalizeAssistantConversationStatus } from "../../shared/support/conversationStatus.js";
 import { renderMarkdownToSafeHtml } from "../lib/markdownRenderer.js";
 
 const DEFAULT_COPY = Object.freeze({
@@ -413,10 +415,6 @@ const rootClasses = computed(() => {
   return classes;
 });
 
-function normalizeText(value) {
-  return String(value || "").trim();
-}
-
 function formatConversationStartedAt(value) {
   const formatter = meta?.formatConversationStartedAt;
   if (typeof formatter === "function") {
@@ -430,7 +428,9 @@ function normalizeConversationStatus(value) {
   if (typeof normalizer === "function") {
     return normalizer(value);
   }
-  return normalizeText(value).toLowerCase() || "unknown";
+  return normalizeAssistantConversationStatus(value, {
+    fallback: "unknown"
+  });
 }
 
 const viewer = computed(() => {

package/src/client/composables/useAssistantWorkspaceRuntime.js

@@ -15,6 +15,8 @@ import {
   assistantConversationsListQueryKey,
   assistantWorkspaceScopeQueryKey,
   normalizeAssistantStreamEventType,
+  normalizeConversationStatus as normalizeAssistantConversationStatus,
+  parseJsonObject,
   toPositiveInteger
 } from "../../shared/index.js";
 import { assistantHttpClient } from "../lib/assistantHttpClient.js";
@@ -98,8 +100,9 @@ function normalizeToolName(value) {
 }
 
 function normalizeConversationStatus(value) {
-  const status = normalizeText(value).toLowerCase();
-  return status || "unknown";
+  return normalizeAssistantConversationStatus(value, {
+    fallback: "unknown"
+  });
 }
 
 function formatConversationStartedAt(value) {
@@ -117,20 +120,7 @@ function formatConversationStartedAt(value) {
 }
 
 function parseToolResultPayload(value) {
-  if (!value) {
-    return {};
-  }
-
-  try {
-    const parsed = typeof value === "string" ? JSON.parse(value) : value;
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return {};
-    }
-
-    return parsed;
-  } catch {
-    return {};
-  }
+  return parseJsonObject(value);
 }
 
 function buildHistory(messages) {

package/src/server/lib/providers/common.js

@@ -1,5 +1,9 @@
 import { AppError } from "@jskit-ai/kernel/server/runtime/errors";
-import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
+import {
+  normalizeArray,
+  normalizeObject,
+  normalizeText
+} from "@jskit-ai/kernel/shared/support/normalize";
 
 const SUPPORTED_AI_PROVIDERS = Object.freeze(["openai", "deepseek", "anthropic"]);
 const SUPPORTED_AI_PROVIDER_SET = new Set(SUPPORTED_AI_PROVIDERS);
@@ -82,18 +86,6 @@ function createProviderRequestError({ status = 500, code = "assistant_provider_f
   });
 }
 
-function normalizeObject(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return {};
-  }
-
-  return value;
-}
-
-function normalizeArray(value) {
-  return Array.isArray(value) ? value : [];
-}
-
 function normalizeContentText(content) {
   if (typeof content === "string") {
     return content;

package/src/server/repositories/conversationsRepository.js

@@ -1,5 +1,6 @@
 import { parsePositiveInteger } from "@jskit-ai/kernel/server/runtime";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
+import { runInTransaction } from "@jskit-ai/database-runtime/shared/repositoryOptions";
 import {
   parseJsonObject,
   stringifyJsonObject,
@@ -223,11 +224,7 @@ function createConversationsRepository(knex) {
   }
 
   async function transaction(callback) {
-    if (typeof knex.transaction !== "function") {
-      return callback(knex);
-    }
-
-    return knex.transaction(callback);
+    return runInTransaction(knex, callback);
   }
 
   return Object.freeze({

package/src/server/repositories/messagesRepository.js

@@ -1,5 +1,6 @@
 import { parsePositiveInteger } from "@jskit-ai/kernel/server/runtime";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
+import { runInTransaction } from "@jskit-ai/database-runtime/shared/repositoryOptions";
 import {
   parseJsonObject,
   stringifyJsonObject,
@@ -135,11 +136,7 @@ function createMessagesRepository(knex) {
   }
 
   async function transaction(callback) {
-    if (typeof knex.transaction !== "function") {
-      return callback(knex);
-    }
-
-    return knex.transaction(callback);
+    return runInTransaction(knex, callback);
   }
 
   return Object.freeze({

package/src/server/repositories/repositoryPersistenceUtils.js

@@ -1,19 +1,4 @@
-function parseJsonObject(value) {
-  if (value == null) {
-    return {};
-  }
-
-  try {
-    const parsed = typeof value === "string" ? JSON.parse(value) : value;
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return {};
-    }
-
-    return parsed;
-  } catch {
-    return {};
-  }
-}
+import { parseJsonObject } from "../../shared/support/jsonObject.js";
 
 function stringifyJsonObject(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {

package/src/server/services/transcriptService.js

@@ -1,6 +1,7 @@
 import { AppError, parsePositiveInteger } from "@jskit-ai/kernel/server/runtime";
 import { normalizeObject, normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
 import { ASSISTANT_TRANSCRIPT_CHANGED_EVENT } from "../../shared/streamEvents.js";
+import { normalizeConversationStatus } from "../../shared/support/conversationStatus.js";
 
 const DEFAULT_PAGE_SIZE = 20;
 const MAX_PAGE_SIZE = 200;
@@ -98,15 +99,6 @@ function normalizeCursorPagination(query = {}, { defaultLimit = DEFAULT_PAGE_SIZ
   };
 }
 
-function normalizeConversationStatus(value, fallback = "active") {
-  const normalized = normalizeText(value).toLowerCase();
-  if (normalized === "active" || normalized === "completed" || normalized === "failed" || normalized === "aborted") {
-    return normalized;
-  }
-
-  return fallback;
-}
-
 function deriveConversationTitleFromMessage(contentText) {
   const normalized = String(contentText == null ? "" : contentText).replace(/\s+/g, " ").trim();
   if (!normalized) {
@@ -233,7 +225,9 @@ function createTranscriptService({ conversationsRepository, messagesRepository }
     }
 
     return conversationsRepository.updateById(numericConversationId, {
-      status: normalizeConversationStatus(source.status, "completed"),
+      status: normalizeConversationStatus(source.status, {
+        fallback: "completed"
+      }),
       endedAt: source.endedAt || new Date(),
       metadata: {
         ...normalizeObject(existing.metadata),
@@ -252,7 +246,9 @@ function createTranscriptService({ conversationsRepository, messagesRepository }
       maxLimit: MAX_PAGE_SIZE
     });
 
-    const status = normalizeConversationStatus(query.status, "");
+    const status = normalizeConversationStatus(query.status, {
+      fallback: ""
+    });
     const filters = {
       ...(status ? { status } : {})
     };

package/src/shared/assistantResource.js

@@ -4,6 +4,7 @@ import {
   createCursorListValidator
 } from "@jskit-ai/kernel/shared/validators";
 import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
+import { normalizeConversationStatus } from "./support/conversationStatus.js";
 import { toPositiveInteger } from "./support/positiveInteger.js";
 
 const MAX_INPUT_CHARS = 8000;
@@ -16,15 +17,6 @@ function normalizePaginationValue(value, fallback, max) {
   return Math.max(1, Math.min(max, parsed));
 }
 
-function normalizeConversationStatus(value) {
-  const normalized = normalizeText(value).toLowerCase();
-  if (normalized === "active" || normalized === "completed" || normalized === "failed" || normalized === "aborted") {
-    return normalized;
-  }
-
-  return "";
-}
-
 function normalizeChatStreamBody(payload = {}) {
   const source = normalizeObjectInput(payload);
   const normalized = {
@@ -72,7 +64,9 @@ function normalizeChatStreamBody(payload = {}) {
 
 function normalizeConversationsListQuery(payload = {}) {
   const source = normalizeObjectInput(payload);
-  const status = normalizeConversationStatus(source.status);
+  const status = normalizeConversationStatus(source.status, {
+    fallback: ""
+  });
   const normalized = {};
 
   if (Object.hasOwn(source, "cursor")) {

package/src/shared/assistantSettingsResource.js

@@ -1,5 +1,9 @@
 import { Type } from "typebox";
-import { normalizeObjectInput } from "@jskit-ai/kernel/shared/validators";
+import {
+  normalizeObjectInput,
+  normalizeSettingsFieldInput,
+  normalizeSettingsFieldOutput
+} from "@jskit-ai/kernel/shared/validators";
 import { normalizeText } from "@jskit-ai/kernel/shared/actions/textNormalization";
 
 const MAX_SYSTEM_PROMPT_CHARS = 12_000;
@@ -42,35 +46,14 @@ function createPromptSettingsResource({
   );
 
   function normalizeInput(payload = {}) {
-    const source = normalizeObjectInput(payload);
-    const normalized = {};
-    for (const field of fields) {
-      if (!Object.hasOwn(source, field.key)) {
-        continue;
-      }
-      normalized[field.key] = field.normalizeInput(source[field.key], {
-        payload: source
-      });
-    }
-    return normalized;
+    return normalizeSettingsFieldInput(payload, fields);
   }
 
   function normalizeOutput(payload = {}) {
     const source = normalizeObjectInput(payload);
     const settingsSource = normalizeObjectInput(source.settings);
-    const settings = {};
-    for (const field of fields) {
-      const rawValue = Object.hasOwn(settingsSource, field.key)
-        ? settingsSource[field.key]
-        : field.resolveDefault({
-            settings: settingsSource
-          });
-      settings[field.key] = field.normalizeOutput(rawValue, {
-        settings: settingsSource
-      });
-    }
     return {
-      settings
+      settings: normalizeSettingsFieldOutput(settingsSource, fields)
     };
   }
 

package/src/shared/index.js

@@ -36,4 +36,10 @@ export {
   ASSISTANT_WORKSPACE_SETTINGS_CHANGED_EVENT
 } from "./settingsEvents.js";
 
+export {
+  ASSISTANT_CONVERSATION_STATUSES,
+  normalizeConversationStatus
+} from "./support/conversationStatus.js";
+
+export { parseJsonObject } from "./support/jsonObject.js";
 export { toPositiveInteger } from "./support/positiveInteger.js";

package/src/shared/support/conversationStatus.js

@@ -0,0 +1,18 @@
+import { normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
+
+const ASSISTANT_CONVERSATION_STATUSES = Object.freeze(["active", "completed", "failed", "aborted"]);
+const ASSISTANT_CONVERSATION_STATUS_SET = new Set(ASSISTANT_CONVERSATION_STATUSES);
+
+function normalizeConversationStatus(value, { fallback = "" } = {}) {
+  const normalized = normalizeText(value).toLowerCase();
+  if (ASSISTANT_CONVERSATION_STATUS_SET.has(normalized)) {
+    return normalized;
+  }
+
+  return normalizeText(fallback).toLowerCase();
+}
+
+export {
+  ASSISTANT_CONVERSATION_STATUSES,
+  normalizeConversationStatus
+};

package/src/shared/support/jsonObject.js

@@ -0,0 +1,18 @@
+function parseJsonObject(value) {
+  if (value == null) {
+    return {};
+  }
+
+  try {
+    const parsed = typeof value === "string" ? JSON.parse(value) : value;
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return {};
+    }
+
+    return parsed;
+  } catch {
+    return {};
+  }
+}
+
+export { parseJsonObject };