@jskit-ai/assistant 0.1.38 → 0.1.39

package/templates/src/local-package/client/index.js

@@ -1,4 +0,0 @@
-export { default as AssistantSurfaceClientElement } from "./components/AssistantSurfaceClientElement.vue";
-export { default as AssistantSettingsClientElement } from "./components/AssistantSettingsClientElement.vue";
-export { AssistantClientProvider } from "./providers/AssistantClientProvider.js";
-export { useAssistantRuntime } from "./composables/useAssistantRuntime.js";

package/templates/src/local-package/client/providers/AssistantClientProvider.js

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

package/templates/src/local-package/package.descriptor.mjs

@@ -1,85 +0,0 @@
-export default Object.freeze({
-  packageVersion: 1,
-  packageId: "@local/assistant",
-  version: "0.1.0",
-  kind: "runtime",
-  description: "App-local generated assistant runtime.",
-  dependsOn: [
-    "@jskit-ai/assistant-core",
-    "@jskit-ai/database-runtime",
-    "@jskit-ai/http-runtime",
-    "@jskit-ai/shell-web",
-    "@jskit-ai/users-core",
-    "@jskit-ai/users-web"
-  ],
-  capabilities: {
-    provides: ["assistant.runtime"],
-    requires: [
-      "runtime.actions",
-      "runtime.database",
-      "auth.policy",
-      "runtime.http-client",
-      "users.core",
-      "users.web"
-    ]
-  },
-  runtime: {
-    server: {
-      providers: [
-        {
-          entrypoint: "src/server/AssistantProvider.js",
-          export: "AssistantProvider"
-        }
-      ]
-    },
-    client: {
-      providers: [
-        {
-          entrypoint: "src/client/providers/AssistantClientProvider.js",
-          export: "AssistantClientProvider"
-        }
-      ]
-    }
-  },
-  metadata: {
-    apiSummary: {
-      surfaces: [
-        {
-          subpath: "./server/actionIds",
-          summary: "Generated assistant action identifiers."
-        },
-        {
-          subpath: "./client",
-          summary: "Generated assistant client wrappers."
-        },
-        {
-          subpath: "./shared",
-          summary: "Generated assistant runtime configuration."
-        }
-      ],
-      containerTokens: {
-        server: [
-          "assistant.config.repository",
-          "assistant.conversation.repository",
-          "assistant.message.repository",
-          "assistant.ai.client",
-          "assistant.service.tool-catalog"
-        ],
-        client: [
-          "assistant.web.settings.element"
-        ]
-      }
-    }
-  },
-  mutations: {
-    dependencies: {
-      runtime: {},
-      dev: {}
-    },
-    packageJson: {
-      scripts: {}
-    },
-    procfile: {},
-    files: []
-  }
-});

package/templates/src/local-package/package.json

@@ -1,11 +0,0 @@
-{
-  "name": "@local/assistant",
-  "version": "0.1.0",
-  "private": true,
-  "type": "module",
-  "exports": {
-    "./client": "./src/client/index.js",
-    "./shared": "./src/shared/index.js",
-    "./server/actionIds": "./src/server/actionIds.js"
-  }
-}

package/templates/src/local-package/server/AssistantProvider.js

@@ -1,143 +0,0 @@
-import { withActionDefaults } from "@jskit-ai/kernel/shared/actions";
-import { normalizeObject, normalizeText } from "@jskit-ai/kernel/shared/support/normalize";
-import {
-  DEFAULT_AI_TIMEOUT_MS,
-  createAiClient,
-  createServiceToolCatalog,
-  normalizeOptionalHttpUrl,
-  normalizeTimeoutMs
-} from "@jskit-ai/assistant-core/server";
-import { assistantRuntimeConfig } from "../shared/assistantRuntimeConfig.js";
-import { assistantActions } from "./actions.js";
-import { registerRoutes } from "./registerRoutes.js";
-import { createRepository as createAssistantConfigRepository } from "./repositories/assistantConfigRepository.js";
-import { createRepository as createConversationsRepository } from "./repositories/conversationsRepository.js";
-import { createRepository as createMessagesRepository } from "./repositories/messagesRepository.js";
-import { createService as createAssistantConfigService } from "./services/assistantConfigService.js";
-import { createChatService } from "./services/chatService.js";
-import { createTranscriptService } from "./services/transcriptService.js";
-
-function normalizeStringArray(value) {
-  const source = Array.isArray(value) ? value : [value];
-  return source.map((entry) => normalizeText(entry)).filter(Boolean);
-}
-
-function resolveAssistantConfig(scope) {
-  const appConfig = scope.has("appConfig") ? normalizeObject(scope.make("appConfig")) : {};
-  const env = scope.has("jskit.env") ? normalizeObject(scope.make("jskit.env")) : {};
-  const assistantConfig = normalizeObject(appConfig.assistant);
-
-  const provider = normalizeText(env.AI_PROVIDER || assistantConfig.provider).toLowerCase() || "openai";
-  const apiKey = normalizeText(env.AI_API_KEY || assistantConfig.apiKey);
-  const baseUrl = normalizeOptionalHttpUrl(env.AI_BASE_URL || assistantConfig.baseUrl, {
-    context: "assistant AI_BASE_URL"
-  });
-  const model = normalizeText(assistantConfig.model);
-  const timeoutMs = normalizeTimeoutMs(
-    env.AI_TIMEOUT_MS || assistantConfig.timeoutMs,
-    DEFAULT_AI_TIMEOUT_MS
-  );
-
-  return Object.freeze({
-    ai: Object.freeze({
-      enabled: Boolean(apiKey),
-      provider,
-      apiKey,
-      baseUrl,
-      model,
-      timeoutMs
-    }),
-    barredActionIds: normalizeStringArray(assistantConfig.barredActionIds),
-    toolSkipActionPrefixes: normalizeStringArray(assistantConfig.toolSkipActionPrefixes)
-  });
-}
-
-class AssistantProvider {
-  static id = "assistant.chat.service";
-
-  static dependsOn = ["runtime.actions", "runtime.database", "auth.policy.fastify", "users.core"];
-
-  register(app) {
-    if (
-      !app ||
-      typeof app.singleton !== "function" ||
-      typeof app.service !== "function" ||
-      typeof app.actions !== "function"
-    ) {
-      throw new Error("AssistantProvider requires application singleton()/service()/actions().");
-    }
-
-    const config = resolveAssistantConfig(app);
-
-    app.singleton("assistant.config.repository", (scope) => {
-      const knex = scope.make("jskit.database.knex");
-      return createAssistantConfigRepository(knex);
-    });
-
-    app.singleton("assistant.conversation.repository", (scope) => {
-      const knex = scope.make("jskit.database.knex");
-      return createConversationsRepository(knex);
-    });
-
-    app.singleton("assistant.message.repository", (scope) => {
-      const knex = scope.make("jskit.database.knex");
-      return createMessagesRepository(knex);
-    });
-
-    app.singleton("assistant.ai.client", () => {
-      return createAiClient(config.ai);
-    });
-
-    app.singleton("assistant.service.tool-catalog", (scope) => {
-      return createServiceToolCatalog(scope, {
-        barredActionIds: config.barredActionIds,
-        skipActionPrefixes: ["assistant.", ...config.toolSkipActionPrefixes]
-      });
-    });
-
-    app.service(
-      "assistant.config.service",
-      (scope) =>
-        createAssistantConfigService({
-          assistantConfigRepository: scope.make("assistant.config.repository"),
-          consoleService: scope.has("consoleService") ? scope.make("consoleService") : null
-        })
-    );
-
-    app.service(
-      "assistant.transcript.service",
-      (scope) =>
-        createTranscriptService({
-          conversationsRepository: scope.make("assistant.conversation.repository"),
-          messagesRepository: scope.make("assistant.message.repository")
-        })
-    );
-
-    app.service(
-      "assistant.chat.service",
-      (scope) =>
-        createChatService({
-          aiClient: scope.make("assistant.ai.client"),
-          transcriptService: scope.make("assistant.transcript.service"),
-          serviceToolCatalog: scope.make("assistant.service.tool-catalog"),
-          assistantConfigService: scope.make("assistant.config.service")
-        })
-    );
-
-    app.actions(
-      withActionDefaults(assistantActions, {
-        domain: "assistant",
-        dependencies: {
-          chatService: "assistant.chat.service",
-          assistantConfigService: "assistant.config.service"
-        }
-      })
-    );
-  }
-
-  boot(app) {
-    registerRoutes(app);
-  }
-}
-
-export { AssistantProvider };

package/templates/src/local-package/server/actionIds.js

@@ -1,9 +0,0 @@
-const actionIds = Object.freeze({
-  chatStream: "assistant.chat.stream",
-  conversationsList: "assistant.conversations.list",
-  conversationMessagesList: "assistant.conversation.messages.list",
-  settingsRead: "assistant.settings.read",
-  settingsUpdate: "assistant.settings.update"
-});
-
-export { actionIds };

package/templates/src/local-package/server/actions.js

@@ -1,183 +0,0 @@
-import {
-  EMPTY_INPUT_VALIDATOR
-} from "@jskit-ai/kernel/shared/actions/actionContributorHelpers";
-import { workspaceSlugParamsValidator } from "@jskit-ai/users-core/server/validators/routeParamsValidator";
-import {
-  assistantConfigResource,
-  assistantResource
-} from "@jskit-ai/assistant-core/shared";
-import { assistantRuntimeConfig } from "../shared/assistantRuntimeConfig.js";
-import { actionIds } from "./actionIds.js";
-
-const runtimeSurfaces = Object.freeze([assistantRuntimeConfig.runtimeSurfaceId]);
-const settingsSurfaces = Object.freeze([assistantRuntimeConfig.settingsSurfaceId]);
-
-const runtimeQueryInputValidator = assistantRuntimeConfig.runtimeSurfaceRequiresWorkspace
-  ? [workspaceSlugParamsValidator, { query: assistantResource.operations.conversationsList.queryValidator }]
-  : { query: assistantResource.operations.conversationsList.queryValidator };
-
-const runtimeMessagesInputValidator = assistantRuntimeConfig.runtimeSurfaceRequiresWorkspace
-  ? [
-      workspaceSlugParamsValidator,
-      assistantResource.operations.conversationMessagesList.paramsValidator,
-      {
-        query: assistantResource.operations.conversationMessagesList.queryValidator
-      }
-    ]
-  : [
-      assistantResource.operations.conversationMessagesList.paramsValidator,
-      {
-        query: assistantResource.operations.conversationMessagesList.queryValidator
-      }
-    ];
-
-const runtimeChatInputValidator = assistantRuntimeConfig.runtimeSurfaceRequiresWorkspace
-  ? [workspaceSlugParamsValidator, assistantResource.operations.chatStream.bodyValidator]
-  : assistantResource.operations.chatStream.bodyValidator;
-
-const settingsReadInputValidator = assistantRuntimeConfig.settingsSurfaceRequiresWorkspace
-  ? workspaceSlugParamsValidator
-  : EMPTY_INPUT_VALIDATOR;
-
-const settingsUpdateInputValidator = assistantRuntimeConfig.settingsSurfaceRequiresWorkspace
-  ? [
-      workspaceSlugParamsValidator,
-      {
-        patch: assistantConfigResource.operations.patch.bodyValidator
-      }
-    ]
-  : {
-      patch: assistantConfigResource.operations.patch.bodyValidator
-    };
-
-const settingsReadPermission = assistantRuntimeConfig.settingsSurfaceRequiresWorkspace
-  ? {
-      require: "any",
-      permissions: ["workspace.settings.view", "workspace.settings.update"]
-    }
-  : {
-      require: "authenticated"
-    };
-
-const settingsUpdatePermission = assistantRuntimeConfig.settingsSurfaceRequiresWorkspace
-  ? {
-      require: "all",
-      permissions: ["workspace.settings.update"]
-    }
-  : {
-      require: "authenticated"
-    };
-
-const assistantActions = Object.freeze([
-  {
-    id: actionIds.chatStream,
-    version: 1,
-    kind: "stream",
-    channels: ["api", "internal"],
-    surfaces: runtimeSurfaces,
-    permission: {
-      require: "authenticated"
-    },
-    inputValidator: runtimeChatInputValidator,
-    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"],
-    surfaces: runtimeSurfaces,
-    permission: {
-      require: "authenticated"
-    },
-    inputValidator: runtimeQueryInputValidator,
-    outputValidator: assistantResource.operations.conversationsList.outputValidator,
-    idempotency: "none",
-    audit: {
-      actionName: actionIds.conversationsList
-    },
-    observability: {},
-    async execute(input, context, deps) {
-      return deps.chatService.listConversations(input.query, {
-        context,
-        input
-      });
-    }
-  },
-  {
-    id: actionIds.conversationMessagesList,
-    version: 1,
-    kind: "query",
-    channels: ["api", "internal"],
-    surfaces: runtimeSurfaces,
-    permission: {
-      require: "authenticated"
-    },
-    inputValidator: runtimeMessagesInputValidator,
-    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,
-        input
-      });
-    }
-  },
-  {
-    id: actionIds.settingsRead,
-    version: 1,
-    kind: "query",
-    channels: ["api", "automation", "internal"],
-    surfaces: settingsSurfaces,
-    permission: settingsReadPermission,
-    inputValidator: settingsReadInputValidator,
-    outputValidator: assistantConfigResource.operations.view.outputValidator,
-    idempotency: "none",
-    audit: {
-      actionName: actionIds.settingsRead
-    },
-    observability: {},
-    async execute(input, context, deps) {
-      return deps.assistantConfigService.getSettings(input, {
-        context
-      });
-    }
-  },
-  {
-    id: actionIds.settingsUpdate,
-    version: 1,
-    kind: "command",
-    channels: ["api", "automation", "internal"],
-    surfaces: settingsSurfaces,
-    permission: settingsUpdatePermission,
-    inputValidator: settingsUpdateInputValidator,
-    outputValidator: assistantConfigResource.operations.patch.outputValidator,
-    idempotency: "optional",
-    audit: {
-      actionName: actionIds.settingsUpdate
-    },
-    observability: {},
-    async execute(input, context, deps) {
-      return deps.assistantConfigService.updateSettings(input, input.patch, {
-        context
-      });
-    }
-  }
-]);
-
-export { assistantActions };