@jskit-ai/agent-docs 0.1.1

package/reference/autogen/packages/assistant-core.md

@@ -0,0 +1,310 @@
+# packages/assistant-core
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `packages/assistant-core`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `packages/assistant-core/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`
+
+## Sections
+
+### src
+
+### `src/client/components/AssistantClientElement.vue`
+Exports
+- None
+Local functions
+- `formatConversationStartedAt(value)`
+- `normalizeConversationStatus(value)`
+- `messageAuthorLabel(message)`
+- `showAssistantTypingIndicator(message)`
+- `isAssistantChatMessage(message)`
+- `keepMessagesPanelPinnedToBottom({ behavior = "auto" } = {})`
+- `renderAssistantMarkdownSnapshot()`
+- `scheduleAssistantMarkdownRender({ immediate = false } = {})`
+- `assistantMessageHtml(message)`
+- `resolveConversationActorLabel(conversation)`
+- `conversationSubtitle(conversation)`
+- `conversationDisplayTitle(conversation)`
+- `isActiveConversation(conversation)`
+- `onSelectConversation(conversation)`
+- `selectConversationFromPicker(conversation)`
+- `onStartNewConversation()`
+- `startNewConversationFromPicker()`
+- `onLoadMoreConversations()`
+- `onSendMessage()`
+- `onConversationPickerOpen()`
+- `onHandleInputKeydown(event)`
+- `resolveComposerTextarea()`
+- `focusComposer(selectText = false)`
+- `focusComposerWithRetry(selectText = false)`
+- `requestComposerFocus({ selectText = false } = {})`
+- `onRootFocus(event)`
+- `onRootPointerDown()`
+- `normalizeScrollValue(value)`
+- `distanceFromBottom(element)`
+- `isScrolledToBottom(element)`
+- `scrollMessagesToBottom({ behavior = "auto" } = {})`
+- `handleMessagesPanelScroll()`
+- `syncViewportHeight()`
+
+### `src/client/components/AssistantSettingsFormCard.vue`
+Exports
+- None
+
+### `src/client/index.js`
+Exports
+- `AssistantClientElement`
+- `AssistantSettingsFormCard`
+- `assistantHttpClient`
+- `createAssistantApi`
+- `buildStreamEventError`
+- `renderMarkdownToSafeHtml`
+
+### `src/client/lib/assistantApi.js`
+Exports
+- `createAssistantApi({ request, requestStream, resolveBasePath, resolveSurfaceId = null } = {})`
+- `buildStreamEventError(event)`
+Local functions
+- `appendQueryParam(params, key, value)`
+- `normalizeSurfaceHeaderValue(value)`
+- `resolveAssistantRequestHeaders(resolveSurfaceId)`
+- `resolveRequiredBasePath(resolveBasePath)`
+
+### `src/client/lib/assistantHttpClient.js`
+Exports
+- `assistantHttpClient`
+
+### `src/client/lib/markdownRenderer.js`
+Exports
+- `renderMarkdownToSafeHtml(value = "")`
+Local functions
+- `normalizeMarkdownText(value)`
+
+### `src/server/index.js`
+Exports
+- `createAiClient`
+- `SUPPORTED_AI_PROVIDERS`
+- `DEFAULT_AI_PROVIDER`
+- `DEFAULT_AI_TIMEOUT_MS`
+- `normalizeOptionalHttpUrl`
+- `normalizeTimeoutMs`
+- `NDJSON_CONTENT_TYPE`
+- `endNdjson`
+- `mapStreamError`
+- `setNdjsonHeaders`
+- `writeNdjson`
+- `resolveWorkspaceSlug`
+- `createServiceToolCatalog`
+- `parseJsonObject`
+- `resolveInsertedId`
+- `stringifyJsonObject`
+- `toIso`
+
+### `src/server/lib/aiClient.js`
+Exports
+- `createAiClient(options = {})`
+- `SUPPORTED_AI_PROVIDERS`
+- `DEFAULT_AI_PROVIDER`
+
+### `src/server/lib/ndjson.js`
+Exports
+- `NDJSON_CONTENT_TYPE`
+- `setNdjsonHeaders(reply)`
+- `writeNdjson(reply, payload = {})`
+- `endNdjson(reply)`
+- `mapStreamError(error)`
+
+### `src/server/lib/providers/anthropicClient.js`
+Exports
+- `createAnthropicClient({ enabled = true, apiKey = "", baseUrl = "", model = "", timeoutMs = 120_000 } = {})`
+- `DEFAULT_ANTHROPIC_MODEL`
+- `DEFAULT_ANTHROPIC_BASE_URL`
+Local functions
+- `normalizeTemperature(value, fallback = 0.2)`
+- `normalizeToolDescriptor(tool)`
+- `toAnthropicTools(tools = [])`
+- `toAnthropicSystemAndMessages(messages = [])`
+- `mapAnthropicContentToOpenAiDelta(content = [])`
+- `createSingleChunkStream(chunk)`
+- `fetchAnthropicMessage({ apiKey, baseUrl, model, timeoutMs, system = "", messages, tools, temperature = 0.2, signal } = {})`
+
+### `src/server/lib/providers/common.js`
+Exports
+- `SUPPORTED_AI_PROVIDERS`
+- `DEFAULT_AI_PROVIDER`
+- `DEFAULT_AI_TIMEOUT_MS`
+- `normalizeProvider(provider)`
+- `normalizeTimeoutMs(value, fallback = DEFAULT_AI_TIMEOUT_MS)`
+- `normalizeModel(value, fallback = "")`
+- `normalizeOptionalHttpUrl(value, { context = "assistant baseUrl" } = {})`
+- `createDisabledClient({ provider = DEFAULT_AI_PROVIDER, model = "" } = {})`
+- `createProviderRequestError({ status = 500, code = "assistant_provider_failed", message = "" } = {})`
+- `normalizeObject`
+- `normalizeArray`
+- `normalizeContentText(content)`
+- `parseJsonObjectOrDefault(value, fallback = {})`
+
+### `src/server/lib/providers/deepSeekClient.js`
+Exports
+- `createDeepSeekClient(options = {})`
+- `DEFAULT_DEEPSEEK_MODEL`
+- `DEFAULT_DEEPSEEK_BASE_URL`
+
+### `src/server/lib/providers/openAiClient.js`
+Exports
+- `createOpenAiClient(options = {})`
+- `DEFAULT_OPENAI_MODEL`
+
+### `src/server/lib/providers/openAiCompatibleClient.js`
+Exports
+- `createOpenAiCompatibleClient({ enabled = true, apiKey = "", baseUrl = "", model = "", defaultModel = "", provider = "openai", timeoutMs = 120_000 } = {})`
+
+### `src/server/lib/resolveWorkspaceSlug.js`
+Exports
+- `resolveWorkspaceSlug(context = {}, actionInput = null)`
+
+### `src/server/lib/serviceToolCatalog.js`
+Exports
+- `createServiceToolCatalog(scope, { barredActionIds = [], skipActionPrefixes = [] } = {})`
+Local functions
+- `normalizeAssistantExtension(value)`
+- `normalizeAssistantActionExtension(action = {})`
+- `normalizeBarredEntry(value)`
+- `normalizeBarredActionSet(value)`
+- `isActionBarred(barredRules, actionId)`
+- `sanitizeToolName(value)`
+- `resolveUniqueToolName(baseName, used)`
+- `parseToolPayload(argumentsText)`
+- `canInvokeMethod(permission, context)`
+- `normalizePermissionSpec(permission)`
+- `stripWorkspaceSlugFromSchema(schema, context = {})`
+- `hasAutomationChannel(action = {})`
+- `normalizeSurfaceList(value)`
+- `canUseToolOnSurface(entry = {}, context = {})`
+- `resolveActionBackedToolEntries(scope)`
+- `resolveActionToolEntries(scope, { barredActionIds = [], skipActionPrefixes = [] } = {})`
+
+### `src/server/repositories/repositoryPersistenceUtils.js`
+Exports
+- `parseJsonObject`
+- `stringifyJsonObject(value)`
+- `toIso(value)`
+- `resolveInsertedId(insertResult)`
+
+### `src/shared/assistantPaths.js`
+Exports
+- `ASSISTANT_API_RELATIVE_PATH`
+- `ASSISTANT_SETTINGS_API_RELATIVE_PATH`
+- `ASSISTANT_WORKSPACE_API_BASE_PATH_TEMPLATE`
+- `ASSISTANT_PUBLIC_API_BASE_PATH`
+- `ASSISTANT_WORKSPACE_SETTINGS_API_PATH_TEMPLATE`
+- `ASSISTANT_PUBLIC_SETTINGS_API_PATH`
+- `resolveAssistantApiBasePath({ requiresWorkspace = false } = {})`
+- `resolveAssistantSettingsApiPath({ requiresWorkspace = false } = {})`
+- `buildAssistantApiPath({ requiresWorkspace = false, workspaceSlug = "", suffix = "/" } = {})`
+- `buildAssistantSettingsApiPath({ requiresWorkspace = false, workspaceSlug = "", surfaceId = "", suffix = "/" } = {})`
+Local functions
+- `materializeAssistantPath(basePath = "", { workspaceSlug = "", surfaceId = "", suffix = "/" } = {})`
+
+### `src/shared/assistantResource.js`
+Exports
+- `MAX_INPUT_CHARS`
+- `MAX_HISTORY_MESSAGES`
+- `assistantResource`
+Local functions
+- `normalizePaginationValue(value, fallback, max)`
+- `normalizeChatStreamBody(payload = {})`
+- `normalizeConversationsListQuery(payload = {})`
+- `normalizeConversationMessagesQuery(payload = {})`
+- `normalizeConversationMessagesParams(payload = {})`
+- `createOptionalPositiveIntegerQuerySchema(max = null)`
+- `normalizeConversationRecord(payload = {})`
+- `normalizeConversationMessageRecord(payload = {})`
+
+### `src/shared/assistantSettingsResource.js`
+Exports
+- `MAX_SYSTEM_PROMPT_CHARS`
+- `assistantConfigResource`
+Local functions
+- `normalizeConfigPatch(payload = {})`
+- `normalizeConfigRecord(payload = {})`
+
+### `src/shared/index.js`
+Exports
+- `ASSISTANT_API_RELATIVE_PATH`
+- `ASSISTANT_SETTINGS_API_RELATIVE_PATH`
+- `ASSISTANT_WORKSPACE_API_BASE_PATH_TEMPLATE`
+- `ASSISTANT_PUBLIC_API_BASE_PATH`
+- `ASSISTANT_WORKSPACE_SETTINGS_API_PATH_TEMPLATE`
+- `ASSISTANT_PUBLIC_SETTINGS_API_PATH`
+- `resolveAssistantApiBasePath`
+- `resolveAssistantSettingsApiPath`
+- `buildAssistantApiPath`
+- `buildAssistantSettingsApiPath`
+- `ASSISTANT_QUERY_KEY_PREFIX`
+- `assistantRootQueryKey`
+- `assistantScopeQueryKey`
+- `assistantSettingsQueryKey`
+- `assistantConversationsListQueryKey`
+- `assistantConversationMessagesQueryKey`
+- `ASSISTANT_STREAM_EVENT_TYPES`
+- `normalizeAssistantStreamEventType`
+- `MAX_INPUT_CHARS`
+- `MAX_HISTORY_MESSAGES`
+- `assistantResource`
+- `MAX_SYSTEM_PROMPT_CHARS`
+- `assistantConfigResource`
+- `assistantSettingsEvents`
+- `ASSISTANT_CONVERSATION_STATUSES`
+- `normalizeConversationStatus`
+- `parseJsonObject`
+- `toPositiveInteger`
+
+### `src/shared/queryKeys.js`
+Exports
+- `ASSISTANT_QUERY_KEY_PREFIX`
+- `assistantRootQueryKey()`
+- `assistantScopeQueryKey(scope = {})`
+- `assistantSettingsQueryKey(scope = {})`
+- `assistantConversationsListQueryKey(scope = {}, { limit = 20, status = "" } = {})`
+- `assistantConversationMessagesQueryKey(scope = {}, conversationId, { page = 1, pageSize = 200 } = {})`
+Local functions
+- `normalizeSurfaceId(value)`
+- `normalizeWorkspaceSlug(value)`
+- `normalizePositiveInteger(value, fallback)`
+- `normalizeScopeKey({ targetSurfaceId = "", workspaceSlug = "", workspaceId = null } = {})`
+- `normalizeStatus(value)`
+- `normalizeConversationId(value)`
+
+### `src/shared/settingsEvents.js`
+Exports
+- `assistantSettingsEvents`
+
+### `src/shared/streamEvents.js`
+Exports
+- `ASSISTANT_STREAM_EVENT_TYPES`
+- `normalizeAssistantStreamEventType(value, fallback = "")`
+
+### `src/shared/support/conversationStatus.js`
+Exports
+- `ASSISTANT_CONVERSATION_STATUSES`
+- `normalizeConversationStatus(value, { fallback = "" } = {})`
+
+### `src/shared/support/jsonObject.js`
+Exports
+- `parseJsonObject(value)`
+
+### `src/shared/support/positiveInteger.js`
+Exports
+- `toPositiveInteger(value, fallback = 0)`
+
+### root
+
+### `package.descriptor.mjs`
+Exports
+- None

package/reference/autogen/packages/assistant-runtime.md

@@ -0,0 +1,219 @@
+# packages/assistant-runtime
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `packages/assistant-runtime`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `packages/assistant-runtime/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`
+
+## Sections
+
+### src
+
+### `src/client/components/AssistantSettingsClientElement.vue`
+Exports
+- None
+Local functions
+- `clearFieldErrors()`
+- `reportAssistantSettingsError(message, dedupeKey)`
+- `submit()`
+
+### `src/client/components/AssistantSurfaceClientElement.vue`
+Exports
+- None
+
+### `src/client/composables/useAssistantRuntime.js`
+Exports
+- `useAssistantRuntime({ api = null, surfaceId = "" } = {})`
+Local functions
+- `toNonNegativeInteger(value, fallback = 0)`
+- `buildScopeStorageKey(scope = {})`
+- `readStoredActiveConversationId(scope = {})`
+- `writeStoredActiveConversationId(scope = {}, conversationId)`
+- `buildId(prefix = "id")`
+- `normalizeToolName(value)`
+- `normalizeConversationStatus(value)`
+- `formatConversationStartedAt(value)`
+- `parseToolResultPayload(value)`
+- `buildHistory(messages)`
+- `mapTranscriptEntriesToAssistantState(entries)`
+- `resolveRuntimePolicy()`
+- `createRuntimeApi({ overrideApi = null, resolveBasePath, resolveSurfaceId = null } = {})`
+
+### `src/client/index.js`
+Exports
+- `AssistantSurfaceClientElement`
+- `AssistantSettingsClientElement`
+- `AssistantClientProvider`
+- `useAssistantRuntime`
+
+### `src/client/providers/AssistantClientProvider.js`
+Exports
+- `AssistantClientProvider`
+
+### `src/server/actionIds.js`
+Exports
+- `actionIds`
+
+### `src/server/actions.js`
+Exports
+- `assistantActions`
+
+### `src/server/AssistantProvider.js`
+Exports
+- `AssistantProvider`
+Local functions
+- `resolveGlobalAssistantConfig(scope)`
+- `createAssistantAiClientFactory(config = {})`
+
+### `src/server/inputValidators.js`
+Exports
+- `assistantSurfaceRouteParamsValidator`
+- `assistantTargetSurfaceInputValidator`
+
+### `src/server/registerRoutes.js`
+Exports
+- `registerRoutes(app)`
+Local functions
+- `buildRouteParamsValidator(requiresWorkspace)`
+- `buildConversationMessagesRouteParamsValidator(requiresWorkspace)`
+- `readWorkspaceInput(request, requiresWorkspace)`
+- `requireAssistantSurface(appConfig = {}, targetSurfaceId = "")`
+- `requireHostSurfaceId(request)`
+- `shouldExposeAppErrorDetails(errorCode = "")`
+- `sendPreStreamErrorResponse(reply, error)`
+- `resolveRouteRequestState(request, { resolveCurrentAppConfig = () => ({}), kind = "runtime", requiresWorkspace = false } = {})`
+- `registerSettingsRoutes(router, resolveCurrentAppConfig, { requiresWorkspace = false } = {})`
+- `registerRuntimeRoutes(router, resolveCurrentAppConfig, { requiresWorkspace = false } = {})`
+
+### `src/server/repositories/assistantConfigRepository.js`
+Exports
+- `createRepository(knex)`
+Local functions
+- `normalizeTargetSurfaceId(value = "")`
+- `normalizeWorkspaceId(value)`
+- `normalizeWorkspaceDbId(value)`
+- `buildScopeKey(targetSurfaceId, workspaceId = null)`
+- `mapConfigRow(row = {})`
+- `createDefaultRecord({ targetSurfaceId = "", workspaceId = null } = {})`
+
+### `src/server/repositories/conversationsRepository.js`
+Exports
+- `createRepository(knex)`
+Local functions
+- `normalizeWorkspaceId(value)`
+- `normalizeDbWorkspaceId(value)`
+- `normalizeInputRecordId(value)`
+- `normalizeRequiredSurfaceId(value)`
+- `applyWorkspaceScope(query, columnName, workspaceId)`
+- `mapConversationRow(row = {})`
+- `normalizeCursorPagination(pagination = {}, { defaultLimit = 20, maxLimit = 200 } = {})`
+- `createConversationBaseQuery(client)`
+
+### `src/server/repositories/messagesRepository.js`
+Exports
+- `createRepository(knex)`
+Local functions
+- `normalizeWorkspaceId(value)`
+- `normalizeDbWorkspaceId(value)`
+- `normalizeInputRecordId(value)`
+- `applyWorkspaceScope(query, columnName, workspaceId)`
+- `mapMessageRow(row = {})`
+- `normalizePagination(pagination = {}, { defaultPage = 1, defaultPageSize = 200, maxPageSize = 500 } = {})`
+- `resolveNextSequence(client, conversationId)`
+
+### `src/server/services/assistantConfigService.js`
+Exports
+- `createService({ assistantConfigRepository, consoleService = null, appConfig = {}, resolveAppConfig = null } = {})`
+
+### `src/server/services/chatService.js`
+Exports
+- `createChatService({ aiClientFactory, transcriptService, serviceToolCatalog, assistantConfigService, appConfig = {}, resolveAppConfig = null } = {})`
+Local functions
+- `normalizeConversationId(value)`
+- `normalizeHistory(history = [])`
+- `normalizeStreamInput(payload = {})`
+- `hasStreamWriter(streamWriter)`
+- `isAbortError(error)`
+- `extractTextDelta(deltaContent)`
+- `toCompactJson(value, fallback = "{}")`
+- `buildToolContractLine(toolDescriptor = {})`
+- `buildSystemPrompt({ targetSurfaceId = "", toolDescriptors = [], workspaceSlug = "", customSystemPrompt = "" } = {})`
+- `buildRecoveryPrompt({ reason = "", toolFailures = [], toolSuccesses = [] } = {})`
+- `buildRecoveryFallbackAnswer({ reason = "", toolFailures = [], toolSuccesses = [] } = {})`
+- `toSafeToolResultText(value)`
+- `buildToolOutcomeFallbackAnswer({ toolFailures = [], toolSuccesses = [] } = {})`
+- `sanitizeAssistantMessageText(value)`
+- `buildAssistantToolCallMessage({ assistantText = "", toolCalls = [] } = {})`
+- `parseDsmlToolCallsFromText(value = "")`
+- `createDsmlDeltaSanitizer()`
+- `consumeCompletionStream({ stream, streamWriter, emitDeltas = true, deltaSanitizer = null } = {})`
+- `mergeAssistantMessageText(streamedText = "", completionText = "")`
+- `requireAssistantSurface(appConfig = {}, targetSurfaceId = "")`
+- `buildAssistantActionContext(context = {}, assistantSurface = {})`
+
+### `src/server/services/transcriptService.js`
+Exports
+- `createTranscriptService({ conversationsRepository, messagesRepository } = {})`
+Local functions
+- `resolveWorkspaceId(workspace, { required = false } = {})`
+- `resolveActorUserId(user, { required = false } = {})`
+- `normalizePagination(pagination = {}, { defaultPageSize = DEFAULT_PAGE_SIZE, maxPageSize = MAX_PAGE_SIZE } = {})`
+- `normalizeCursorPagination(query = {}, { defaultLimit = DEFAULT_PAGE_SIZE, maxLimit = MAX_PAGE_SIZE } = {})`
+- `deriveConversationTitleFromMessage(contentText)`
+- `isDefaultConversationTitle(value)`
+- `requireAssistantSurface(assistantSurface = {})`
+
+### `src/server/support/assistantServerConfig.js`
+Exports
+- `resolveAssistantServerConfigMap(appConfig = {})`
+- `resolveAssistantServerConfig(appConfig = {}, targetSurfaceId = "")`
+- `resolveAssistantAiConfig({ appConfig = {}, env = {} } = {}, targetSurfaceId = "")`
+Local functions
+- `readPrefixedEnvValue(env = {}, prefix = "", key = "")`
+
+### `src/server/support/createSurfaceAwareToolCatalog.js`
+Exports
+- `createSurfaceAwareToolCatalog(scope, { appConfig = {}, resolveAppConfig = null, createCatalog = createServiceToolCatalog } = {})`
+Local functions
+- `buildCatalogOptions(appConfig = {}, surfaceId = "")`
+- `requireContextSurfaceId(context = {})`
+
+### `src/shared/assistantRuntimeConfig.js`
+Exports
+- `assistantRuntimeConfig`
+
+### `src/shared/assistantSurfaces.js`
+Exports
+- `normalizeAssistantConfigScope(value = "")`
+- `resolveAssistantSurfaceConfig(appConfig = {}, targetSurfaceId = "")`
+- `resolveAssistantSurfacesConfig(appConfig = {})`
+- `resolveSurfaceDefinitions(appConfig = {})`
+
+### `src/shared/index.js`
+Exports
+- `assistantRuntimeConfig`
+- `normalizeAssistantConfigScope`
+- `resolveAssistantSurfaceConfig`
+- `resolveAssistantSurfacesConfig`
+- `resolveSurfaceDefinitions`
+
+### templates
+
+### `templates/migrations/assistant_config_initial.cjs`
+Exports
+- None
+
+### `templates/migrations/assistant_transcripts_initial.cjs`
+Exports
+- None
+
+### root
+
+### `package.descriptor.mjs`
+Exports
+- None

package/reference/autogen/packages/assistant.md

@@ -0,0 +1,73 @@
+# packages/assistant
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `packages/assistant`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `packages/assistant/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`
+
+## Sections
+
+### src
+
+### `src/server/buildTemplateContext.js`
+Exports
+- `buildTemplateContext({ appRoot, options } = {})`
+
+### `src/server/pageSupport.js`
+Exports
+- `readAssistantPageTemplateSource(kind = "page")`
+- `renderAssistantPageSource(templateSource = "", surfaceId = "")`
+- `resolveAssistantPageGenerationContext({ appRoot, targetFile = "", options = {}, context = "assistant page" } = {})`
+- `renderAssistantPageLinkPlacementBlock({ marker = "", pageTarget = {}, generationContext = {} } = {})`
+- `renderAssistantPageSummary(pageTarget = {}, { pageAlreadyExisted = false, pageOverwritten = false } = {})`
+Local functions
+- `resolveLinkToPropLine(linkTo = "")`
+- `resolveTemplateFilePath(relativePath = "")`
+
+### `src/server/subcommands/page.js`
+Exports
+- `runGeneratorSubcommand({ appRoot, subcommand = "", args = [], options = {}, dryRun = false } = {})`
+
+### `src/server/subcommands/settingsPage.js`
+Exports
+- `runGeneratorSubcommand({ appRoot, subcommand = "", args = [], options = {}, dryRun = false } = {})`
+
+### `src/server/subcommands/support.js`
+Exports
+- `PLACEMENT_FILE`
+- `requireSinglePositionalTargetFile(args = [], { context = "assistant" } = {})`
+- `rejectUnexpectedOptions(options = {}, allowedOptionNames = [], { context = "assistant" } = {})`
+- `resolvePathWithinApp(appRoot, targetPath, { context = "assistant" } = {})`
+- `appendBlockIfMarkerMissing(source = "", marker = "", block = "")`
+- `requireEmptyPageSource(existingSource = "", targetRelativePath = "", { context = "assistant", forceOverwrite = false } = {})`
+Local functions
+- `ensureTrailingNewline(value = "")`
+
+### `src/server/support.js`
+Exports
+- `normalizeConfigScope(value = "")`
+- `loadAppConfig(appRoot = "")`
+- `resolveSurfaceDefinition(appConfig = {}, surfaceId = "", optionName = "surface")`
+- `assertAssistantSurfaceIsAvailable(appConfig = {}, surfaceId = "")`
+- `resolveAiConfigPrefix(surfaceId = "", explicitPrefix = "")`
+
+### templates
+
+### `templates/src/pages/assistant/index.vue`
+Exports
+- None
+
+### `templates/src/pages/settings/assistant/index.vue`
+Exports
+- None
+
+### root
+
+### `package.descriptor.mjs`
+Exports
+- None