@jskit-ai/assistant 0.1.32 → 0.1.34

package/src/client/components/AssistantConsoleSettingsClientElement.vue

@@ -1,70 +0,0 @@
-<template>
-  <AssistantSettingsFormCard
-    root-class="assistant-console-settings-client-element"
-    title="Assistant console settings"
-    subtitle="Configure the prompt used on workspace/admin assistant surfaces."
-    no-permission-message="You do not have permission to view assistant console settings."
-    save-label="Save assistant console settings"
-    :add-edit="addEdit"
-    :show-form-skeleton="showFormSkeleton"
-  >
-    <v-textarea
-      v-model="form.workspaceSurfacePrompt"
-      label="Workspace/Admin surface prompt"
-      variant="outlined"
-      density="comfortable"
-      rows="6"
-      auto-grow
-      :readonly="!addEdit.canSave || addEdit.isSaving || addEdit.isRefetching"
-      :error-messages="addEdit.fieldErrors.workspaceSurfacePrompt ? [addEdit.fieldErrors.workspaceSurfacePrompt] : []"
-    />
-  </AssistantSettingsFormCard>
-</template>
-
-<script setup>
-import { computed, reactive } from "vue";
-import { validateOperationSection } from "@jskit-ai/http-runtime/shared/validators/operationValidation";
-import { useAddEdit } from "@jskit-ai/users-web/client/composables/useAddEdit";
-import AssistantSettingsFormCard from "./AssistantSettingsFormCard.vue";
-import { assistantConsoleSettingsResource } from "../../shared/assistantSettingsResource.js";
-
-const form = reactive({
-  workspaceSurfacePrompt: ""
-});
-
-const addEdit = useAddEdit({
-  visibility: "public",
-  access: "never",
-  resource: assistantConsoleSettingsResource,
-  apiSuffix: "/console/settings/assistant",
-  queryKeyFactory: () => ["assistant", "settings", "console"],
-  viewPermissions: [],
-  savePermissions: [],
-  writeMethod: "PATCH",
-  placementSource: "assistant.console-settings-view",
-  fallbackLoadError: "Unable to load assistant console settings.",
-  fallbackSaveError: "Unable to update assistant console settings.",
-  fieldErrorKeys: ["workspaceSurfacePrompt"],
-  realtime: {
-    event: "assistant.console.settings.changed"
-  },
-  model: form,
-  parseInput: (rawPayload) =>
-    validateOperationSection({
-      operation: assistantConsoleSettingsResource.operations.patch,
-      section: "bodyValidator",
-      value: rawPayload
-    }),
-  mapLoadedToModel(model, payload = {}) {
-    const settings = payload?.settings && typeof payload.settings === "object" ? payload.settings : {};
-    model.workspaceSurfacePrompt = String(settings.workspaceSurfacePrompt || "");
-  },
-  buildRawPayload(model) {
-    return {
-      workspaceSurfacePrompt: model.workspaceSurfacePrompt
-    };
-  }
-});
-
-const showFormSkeleton = computed(() => Boolean(addEdit.isInitialLoading));
-</script>

package/src/client/components/AssistantSettingsFormCard.vue

@@ -1,76 +0,0 @@
-<template>
-  <section :class="props.rootClass">
-    <v-card rounded="lg" elevation="1" border>
-      <v-card-item>
-        <v-card-title class="text-h6">{{ props.title }}</v-card-title>
-        <v-card-subtitle>{{ props.subtitle }}</v-card-subtitle>
-      </v-card-item>
-      <v-divider />
-      <v-card-text class="pt-4">
-        <template v-if="props.showFormSkeleton">
-          <v-skeleton-loader type="text@2, list-item-two-line@4, button" />
-        </template>
-
-        <p v-else-if="props.addEdit.loadError" class="text-body-2 text-medium-emphasis mb-4">
-          {{ props.addEdit.loadError }}
-        </p>
-
-        <p v-else-if="!props.addEdit.canView" class="text-body-2 text-medium-emphasis mb-4">
-          {{ props.noPermissionMessage }}
-        </p>
-
-        <template v-else>
-          <v-form @submit.prevent="props.addEdit.submit" novalidate>
-            <v-progress-linear v-if="props.addEdit.isRefetching" indeterminate class="mb-4" />
-            <slot />
-            <div class="d-flex align-center justify-end ga-3 mt-2">
-              <v-btn
-                v-if="props.addEdit.canSave"
-                type="submit"
-                color="primary"
-                :loading="props.addEdit.isSaving"
-                :disabled="props.addEdit.isInitialLoading || props.addEdit.isRefetching"
-              >
-                {{ props.saveLabel }}
-              </v-btn>
-              <v-chip v-else color="secondary" label>Read-only</v-chip>
-            </div>
-          </v-form>
-        </template>
-      </v-card-text>
-    </v-card>
-  </section>
-</template>
-
-<script setup>
-const props = defineProps({
-  rootClass: {
-    type: String,
-    required: true
-  },
-  title: {
-    type: String,
-    required: true
-  },
-  subtitle: {
-    type: String,
-    required: true
-  },
-  noPermissionMessage: {
-    type: String,
-    required: true
-  },
-  saveLabel: {
-    type: String,
-    required: true
-  },
-  addEdit: {
-    type: Object,
-    required: true
-  },
-  showFormSkeleton: {
-    type: Boolean,
-    default: false
-  }
-});
-</script>

package/src/client/components/AssistantWorkspaceClientElement.vue

@@ -1,15 +0,0 @@
-<template>
-  <AssistantClientElement
-    :meta="runtime.meta"
-    :state="runtime.state"
-    :actions="runtime.actions"
-    :viewer="runtime.viewer.value"
-  />
-</template>
-
-<script setup>
-import AssistantClientElement from "./AssistantClientElement.vue";
-import { useAssistantWorkspaceRuntime } from "../composables/useAssistantWorkspaceRuntime.js";
-
-const runtime = useAssistantWorkspaceRuntime();
-</script>

package/src/client/components/AssistantWorkspaceSettingsClientElement.vue

@@ -1,72 +0,0 @@
-<template>
-  <AssistantSettingsFormCard
-    root-class="assistant-workspace-settings-client-element"
-    title="Assistant workspace settings"
-    subtitle="Configure the prompt used on the app surface for this workspace."
-    no-permission-message="You do not have permission to view assistant workspace settings."
-    save-label="Save assistant workspace settings"
-    :add-edit="addEdit"
-    :show-form-skeleton="showFormSkeleton"
-  >
-    <v-textarea
-      v-model="form.appSurfacePrompt"
-      label="App surface prompt"
-      variant="outlined"
-      density="comfortable"
-      rows="6"
-      auto-grow
-      :readonly="!addEdit.canSave || addEdit.isSaving || addEdit.isRefetching"
-      :error-messages="addEdit.fieldErrors.appSurfacePrompt ? [addEdit.fieldErrors.appSurfacePrompt] : []"
-    />
-  </AssistantSettingsFormCard>
-</template>
-
-<script setup>
-import { computed, reactive } from "vue";
-import { validateOperationSection } from "@jskit-ai/http-runtime/shared/validators/operationValidation";
-import { useAddEdit } from "@jskit-ai/users-web/client/composables/useAddEdit";
-import { matchesCurrentWorkspaceEvent } from "@jskit-ai/users-web/client/support/realtimeWorkspace";
-import AssistantSettingsFormCard from "./AssistantSettingsFormCard.vue";
-import { assistantWorkspaceSettingsResource } from "../../shared/assistantSettingsResource.js";
-
-const form = reactive({
-  appSurfacePrompt: ""
-});
-
-const addEdit = useAddEdit({
-  visibility: "workspace",
-  resource: assistantWorkspaceSettingsResource,
-  apiSuffix: "/settings/assistant",
-  queryKeyFactory: (surfaceId = "", workspaceSlug = "") => ["assistant", "settings", "workspace", surfaceId, workspaceSlug],
-  viewPermissions: ["workspace.settings.view", "workspace.settings.update"],
-  savePermissions: ["workspace.settings.update"],
-  writeMethod: "PATCH",
-  placementSource: "assistant.workspace-settings-view",
-  fallbackLoadError: "Unable to load assistant workspace settings.",
-  fallbackSaveError: "Unable to update assistant workspace settings.",
-  fieldErrorKeys: ["appSurfacePrompt"],
-  realtime: {
-    event: "assistant.workspace.settings.changed",
-    matches: ({ payload = {}, routeContext = {} } = {}) =>
-      matchesCurrentWorkspaceEvent(payload, routeContext?.workspaceSlugFromRoute?.value)
-  },
-  model: form,
-  parseInput: (rawPayload) =>
-    validateOperationSection({
-      operation: assistantWorkspaceSettingsResource.operations.patch,
-      section: "bodyValidator",
-      value: rawPayload
-    }),
-  mapLoadedToModel(model, payload = {}) {
-    const settings = payload?.settings && typeof payload.settings === "object" ? payload.settings : {};
-    model.appSurfacePrompt = String(settings.appSurfacePrompt || "");
-  },
-  buildRawPayload(model) {
-    return {
-      appSurfacePrompt: model.appSurfacePrompt
-    };
-  }
-});
-
-const showFormSkeleton = computed(() => Boolean(addEdit.isInitialLoading));
-</script>

package/src/client/index.js

@@ -1,10 +0,0 @@
-export { default as AssistantClientElement } from "./components/AssistantClientElement.vue";
-export { default as AssistantWorkspaceClientElement } from "./components/AssistantWorkspaceClientElement.vue";
-export { default as AssistantConsoleSettingsClientElement } from "./components/AssistantConsoleSettingsClientElement.vue";
-export { default as AssistantWorkspaceSettingsClientElement } from "./components/AssistantWorkspaceSettingsClientElement.vue";
-export { useAssistantWorkspaceRuntime } from "./composables/useAssistantWorkspaceRuntime.js";
-export { assistantHttpClient } from "./lib/assistantHttpClient.js";
-export { createAssistantWorkspaceApi, buildStreamEventError } from "./lib/assistantApi.js";
-export {
-  AssistantWebClientProvider
-} from "./providers/AssistantWebClientProvider.js";

package/src/client/lib/assistantApi.js

@@ -1,137 +0,0 @@
-import {
-  ASSISTANT_STREAM_EVENT_TYPES,
-  buildAssistantWorkspaceApiPath,
-  normalizeAssistantStreamEventType
-} from "../../shared/index.js";
-import { appendQueryString } from "@jskit-ai/kernel/shared/support";
-
-function buildStreamEventError(event) {
-  const message = String(event?.message || "Assistant request failed.");
-  const error = new Error(message);
-  error.code = String(event?.code || "assistant_stream_error");
-  error.status = Number(event?.status || 500);
-  error.event = event && typeof event === "object" ? { ...event } : null;
-  return error;
-}
-
-function appendQueryParam(params, key, value) {
-  if (value == null) {
-    return;
-  }
-
-  const normalized = String(value).trim();
-  if (!normalized) {
-    return;
-  }
-
-  params.set(key, normalized);
-}
-
-function resolveWorkspaceBasePath(workspaceSlug = "") {
-  const path = buildAssistantWorkspaceApiPath(workspaceSlug, "/");
-  if (!path) {
-    throw new Error("Assistant workspace slug is required.");
-  }
-
-  return path;
-}
-
-function normalizeSurfaceHeaderValue(value) {
-  return String(value || "").trim().toLowerCase();
-}
-
-function resolveAssistantRequestHeaders(resolveSurfaceId) {
-  if (typeof resolveSurfaceId !== "function") {
-    return null;
-  }
-
-  const surfaceId = normalizeSurfaceHeaderValue(resolveSurfaceId());
-  if (!surfaceId) {
-    return null;
-  }
-
-  return {
-    "x-jskit-surface": surfaceId
-  };
-}
-
-function createAssistantWorkspaceApi({ request, requestStream, resolveSurfaceId = null }) {
-  if (typeof request !== "function" || typeof requestStream !== "function") {
-    throw new Error("createAssistantWorkspaceApi requires request() and requestStream().");
-  }
-
-  return Object.freeze({
-    async streamChat(workspaceSlug, payload, { signal, onEvent, onMalformedLine, rejectOnErrorEvent = true } = {}) {
-      const basePath = resolveWorkspaceBasePath(workspaceSlug);
-      let streamEventError = null;
-      const requestHeaders = resolveAssistantRequestHeaders(resolveSurfaceId);
-
-      const streamHandlers = {
-        onEvent(event) {
-          const eventType = normalizeAssistantStreamEventType(event?.type, "");
-          if (rejectOnErrorEvent && eventType === ASSISTANT_STREAM_EVENT_TYPES.ERROR && !streamEventError) {
-            streamEventError = buildStreamEventError(event);
-          }
-
-          if (typeof onEvent === "function") {
-            onEvent(event);
-          }
-        }
-      };
-
-      if (typeof onMalformedLine === "function") {
-        streamHandlers.onMalformedLine = (line, parseError) => {
-          onMalformedLine(line, parseError);
-        };
-      }
-
-      await requestStream(
-        `${basePath}/chat/stream`,
-        {
-          method: "POST",
-          ...(requestHeaders ? { headers: requestHeaders } : {}),
-          body: payload,
-          signal
-        },
-        streamHandlers
-      );
-
-      if (streamEventError) {
-        throw streamEventError;
-      }
-    },
-
-    listConversations(workspaceSlug, query = {}) {
-      const basePath = resolveWorkspaceBasePath(workspaceSlug);
-      const params = new URLSearchParams();
-      appendQueryParam(params, "cursor", query.cursor);
-      appendQueryParam(params, "limit", query.limit);
-      appendQueryParam(params, "status", query.status);
-      const requestHeaders = resolveAssistantRequestHeaders(resolveSurfaceId);
-
-      return request(
-        appendQueryString(`${basePath}/conversations`, params.toString()),
-        requestHeaders ? { headers: requestHeaders } : {}
-      );
-    },
-
-    getConversationMessages(workspaceSlug, conversationId, query = {}) {
-      const basePath = resolveWorkspaceBasePath(workspaceSlug);
-      const encodedConversationId = encodeURIComponent(String(conversationId || "").trim());
-      const params = new URLSearchParams();
-      appendQueryParam(params, "page", query.page);
-      appendQueryParam(params, "pageSize", query.pageSize);
-      const requestHeaders = resolveAssistantRequestHeaders(resolveSurfaceId);
-
-      return request(
-        appendQueryString(`${basePath}/conversations/${encodedConversationId}/messages`, params.toString()),
-        requestHeaders ? { headers: requestHeaders } : {}
-      );
-    }
-  });
-}
-
-export {
-  createAssistantWorkspaceApi,
-  buildStreamEventError
-};

package/src/client/lib/assistantHttpClient.js

@@ -1,10 +0,0 @@
-import { createHttpClient } from "@jskit-ai/http-runtime/client";
-
-const assistantHttpClient = createHttpClient({
-  credentials: "include",
-  csrf: {
-    sessionPath: "/api/session"
-  }
-});
-
-export { assistantHttpClient };

package/src/client/lib/markdownRenderer.js

@@ -1,31 +0,0 @@
-import DOMPurify from "dompurify";
-import { marked } from "marked";
-
-marked.setOptions(
-  Object.freeze({
-    gfm: true,
-    breaks: true
-  })
-);
-
-function normalizeMarkdownText(value) {
-  return typeof value === "string" ? value : String(value || "");
-}
-
-function renderMarkdownToSafeHtml(value = "") {
-  const markdownText = normalizeMarkdownText(value);
-  if (!markdownText) {
-    return "";
-  }
-
-  const unsafeHtml = String(marked.parse(markdownText) || "");
-  return String(
-    DOMPurify.sanitize(unsafeHtml, {
-      USE_PROFILES: {
-        html: true
-      }
-    }) || ""
-  );
-}
-
-export { renderMarkdownToSafeHtml };

package/src/client/providers/AssistantWebClientProvider.js

@@ -1,20 +0,0 @@
-import AssistantConsoleSettingsClientElement from "../components/AssistantConsoleSettingsClientElement.vue";
-import AssistantWorkspaceSettingsClientElement from "../components/AssistantWorkspaceSettingsClientElement.vue";
-
-class AssistantWebClientProvider {
-  static id = "assistant.web.client";
-  static dependsOn = ["users.web.client"];
-
-  register(app) {
-    if (!app || typeof app.singleton !== "function") {
-      throw new Error("AssistantWebClientProvider requires application singleton().");
-    }
-
-    app.singleton("assistant.web.console-settings.element", () => AssistantConsoleSettingsClientElement);
-    app.singleton("assistant.web.workspace-settings.element", () => AssistantWorkspaceSettingsClientElement);
-  }
-}
-
-export {
-  AssistantWebClientProvider
-};

package/src/server/actionIds.js

@@ -1,11 +0,0 @@
-const actionIds = Object.freeze({
-  chatStream: "assistant.chat.stream",
-  conversationsList: "assistant.conversations.list",
-  conversationMessagesList: "assistant.conversation.messages.list",
-  consoleSettingsRead: "assistant.console.settings.read",
-  consoleSettingsUpdate: "assistant.console.settings.update",
-  workspaceSettingsRead: "assistant.workspace.settings.read",
-  workspaceSettingsUpdate: "assistant.workspace.settings.update"
-});
-
-export { actionIds };

package/src/server/actions.js

@@ -1,191 +0,0 @@
-import { workspaceSlugParamsValidator } from "@jskit-ai/users-core/server/validators/routeParamsValidator";
-import { resolveWorkspace } from "@jskit-ai/users-core/server/support/resolveWorkspace";
-import {
-  EMPTY_INPUT_VALIDATOR
-} from "@jskit-ai/kernel/shared/actions/actionContributorHelpers";
-import { assistantResource } from "../shared/assistantResource.js";
-import {
-  assistantConsoleSettingsResource,
-  assistantWorkspaceSettingsResource
-} from "../shared/assistantSettingsResource.js";
-import { actionIds } from "./actionIds.js";
-
-const assistantActions = Object.freeze([
-  {
-    id: actionIds.chatStream,
-    version: 1,
-    kind: "stream",
-    channels: ["api", "internal"],
-    surfacesFrom: "workspace",
-    permission: {
-      require: "authenticated"
-    },
-    inputValidator: [workspaceSlugParamsValidator, assistantResource.operations.chatStream.bodyValidator],
-    idempotency: "optional",
-    audit: {
-      actionName: actionIds.chatStream
-    },
-    observability: {},
-    async execute(input, context, deps) {
-      return deps.chatService.streamChat(input, {
-        context,
-        streamWriter: deps.streamWriter,
-        abortSignal: deps.abortSignal
-      });
-    }
-  },
-  {
-    id: actionIds.conversationsList,
-    version: 1,
-    kind: "query",
-    channels: ["api", "internal"],
-    surfacesFrom: "workspace",
-    permission: {
-      require: "authenticated"
-    },
-    inputValidator: [
-      workspaceSlugParamsValidator,
-      {
-        query: assistantResource.operations.conversationsList.queryValidator
-      }
-    ],
-    outputValidator: assistantResource.operations.conversationsList.outputValidator,
-    idempotency: "none",
-    audit: {
-      actionName: actionIds.conversationsList
-    },
-    observability: {},
-    async execute(input, context, deps) {
-      return deps.chatService.listConversations(input.query, {
-        context
-      });
-    }
-  },
-  {
-    id: actionIds.conversationMessagesList,
-    version: 1,
-    kind: "query",
-    channels: ["api", "internal"],
-    surfacesFrom: "workspace",
-    permission: {
-      require: "authenticated"
-    },
-    inputValidator: [
-      workspaceSlugParamsValidator,
-      assistantResource.operations.conversationMessagesList.paramsValidator,
-      {
-        query: assistantResource.operations.conversationMessagesList.queryValidator
-      }
-    ],
-    outputValidator: assistantResource.operations.conversationMessagesList.outputValidator,
-    idempotency: "none",
-    audit: {
-      actionName: actionIds.conversationMessagesList
-    },
-    observability: {},
-    async execute(input, context, deps) {
-      return deps.chatService.getConversationMessages(input.conversationId, input.query, {
-        context
-      });
-    }
-  },
-  {
-    id: actionIds.consoleSettingsRead,
-    version: 1,
-    kind: "query",
-    channels: ["api", "automation", "internal"],
-    surfacesFrom: "console",
-    permission: {
-      require: "authenticated"
-    },
-    inputValidator: EMPTY_INPUT_VALIDATOR,
-    outputValidator: assistantConsoleSettingsResource.operations.view.outputValidator,
-    idempotency: "none",
-    audit: {
-      actionName: actionIds.consoleSettingsRead
-    },
-    observability: {},
-    async execute(_input, context, deps) {
-      return deps.assistantSettingsService.getConsoleSettings({
-        context
-      });
-    }
-  },
-  {
-    id: actionIds.consoleSettingsUpdate,
-    version: 1,
-    kind: "command",
-    channels: ["api", "automation", "internal"],
-    surfacesFrom: "console",
-    permission: {
-      require: "authenticated"
-    },
-    inputValidator: {
-      payload: assistantConsoleSettingsResource.operations.patch.bodyValidator
-    },
-    outputValidator: assistantConsoleSettingsResource.operations.patch.outputValidator,
-    idempotency: "optional",
-    audit: {
-      actionName: actionIds.consoleSettingsUpdate
-    },
-    observability: {},
-    async execute(input, context, deps) {
-      return deps.assistantSettingsService.updateConsoleSettings(input.payload, {
-        context
-      });
-    }
-  },
-  {
-    id: actionIds.workspaceSettingsRead,
-    version: 1,
-    kind: "query",
-    channels: ["api", "automation", "internal"],
-    surfacesFrom: "workspace",
-    permission: {
-      require: "any",
-      permissions: ["workspace.settings.view", "workspace.settings.update"]
-    },
-    inputValidator: workspaceSlugParamsValidator,
-    outputValidator: assistantWorkspaceSettingsResource.operations.view.outputValidator,
-    idempotency: "none",
-    audit: {
-      actionName: actionIds.workspaceSettingsRead
-    },
-    observability: {},
-    async execute(input, context, deps) {
-      return deps.assistantSettingsService.getWorkspaceSettings(resolveWorkspace(context, input), {
-        context
-      });
-    }
-  },
-  {
-    id: actionIds.workspaceSettingsUpdate,
-    version: 1,
-    kind: "command",
-    channels: ["api", "automation", "internal"],
-    surfacesFrom: "workspace",
-    permission: {
-      require: "all",
-      permissions: ["workspace.settings.update"]
-    },
-    inputValidator: [
-      workspaceSlugParamsValidator,
-      {
-        patch: assistantWorkspaceSettingsResource.operations.patch.bodyValidator
-      }
-    ],
-    outputValidator: assistantWorkspaceSettingsResource.operations.patch.outputValidator,
-    idempotency: "optional",
-    audit: {
-      actionName: actionIds.workspaceSettingsUpdate
-    },
-    observability: {},
-    async execute(input, context, deps) {
-      return deps.assistantSettingsService.updateWorkspaceSettings(resolveWorkspace(context, input), input.patch, {
-        context
-      });
-    }
-  }
-]);
-
-export { assistantActions };