@jskit-ai/agent-docs 0.1.194 → 0.1.196

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

@@ -14,6 +14,10 @@ Use this on demand; do not load the full index at startup.
 
 ### src
 
+### `src/client/components/AssistantConversationClientElement.vue`
+Exports
+- None
+
 ### `src/client/components/AssistantSettingsClientElement.vue`
 Exports
 - None
@@ -31,6 +35,20 @@ Local functions
 - `selectConversation(entry)`
 - `startNewConversation()`
 
+### `src/client/composables/useAssistantConversation.js`
+Exports
+- `configureAssistantConversations(app, { actorKey, api = null, request, clearDraftOn = "dispatch" } = {})`
+- `useAssistantConversation(options)`
+- `useAssistantConversationFactory(options = {})`
+Local functions
+- `text(value)`
+- `isQuestionConfiguration(value)`
+- `draftAfterAcceptedSubmission(currentDraft = "", submittedDraft = "")`
+- `createConversation(identity, { api, socket, actorKey, placement, readers, queueWhileSending, draftStorage, application, goalReadEnabled })`
+- `useBoundedTask({ command, endpoint, scope, input, result, onResult }, { active, data, presentation })`
+- `conversationBindingSetup({ socket, boundedTask = null } = {})`
+- `createConversationBinding({ conversationId, endpoint = "", surfaceId = "", hostSurfaceId = "", workspaceSlug, actorKey: suppliedActorKey, api: suppliedApi = null, socket: suppliedSocket = null, active = true, onEvent, clearDraftOn: suppliedClearDraftOn, queueWhileSending, draftWhileLoading = false, draftStorage = null, application = null, boundedTask = null, data, attachments = null, suggestions = null, models = null, questions = null, goal = null, presentation = {} } = {}, setup)`
+
 ### `src/client/composables/useAssistantRuntime.js`
 Exports
 - `useAssistantRuntime({ api = null, surfaceId = "", integrationId = "" } = {})`
@@ -47,9 +65,13 @@ Local functions
 ### `src/client/index.js`
 Exports
 - `AssistantSurfaceClientElement`
+- `AssistantConversationClientElement`
 - `AssistantSettingsClientElement`
 - `AssistantClientProvider`
 - `useAssistantRuntime`
+- `configureAssistantConversations`
+- `useAssistantConversation`
+- `useAssistantConversationFactory`
 
 ### `src/client/providers/AssistantClientProvider.js`
 Exports
@@ -72,6 +94,10 @@ Local functions
 - `normalizeBoundedPositiveInteger(value, fallback, maximum)`
 - `normalizeTotalPages(value)`
 
+### `src/client/support/subscribeAssistantConversation.js`
+Exports
+- `subscribeAssistantConversation({ socket, conversationId, targetSurfaceId, hostSurfaceId, workspaceSlug, read, onState, onEvent = () => {}, onError = () => {} } = {})`
+
 ### `src/client/support/workspaceScopeSupport.js`
 Exports
 - `EMPTY_WORKSPACE_WEB_SCOPE_SUPPORT`
@@ -85,37 +111,75 @@ Exports
 
 ### `src/server/actions.js`
 Exports
-- `createAssistantActions({ assistantConfigService, chatService, config = {} } = {})`
+- `createAssistantActions({ assistantConfigService, chatService, conversationRuntime = null, conversationAccess = null, conversationDataSchema = null, conversationConfigurationSchema = null, conversationSelectionSchema = null, conversationReplacementSchema = null, workspaceScopeSupport = null, config = {} } = {})`
 Local functions
 - `configuredAssistantSurfaces(config = {})`
+- `createConversationActions({ conversationRuntime, conversationDataSchema, conversationConfigurationSchema, conversationSelectionSchema, conversationReplacementSchema, config, runtimeSurfaces, workspaceScopeSupport })`
 
 ### `src/server/AssistantProvider.js`
 Exports
 - `AssistantFeature`
+
+### `src/server/createAssistantRuntime.js`
+Exports
 - `createAssistantAiClientFactory(config = {})`
-- `createAssistantRuntime({ actionCatalogue, config, consoleRuntime, database, env, aiConnections, attachments, workspaces } = {})`
+- `createAssistantRuntime({ actionCatalogue, config, consoleRuntime, repositories = {}, env, aiConnections, attachments, workspaces } = {})`
+- `createAssistantConversationRuntime({ conversationsRepository, messagesRepository, aiClientFactory, toolCatalog, attachments })`
+
+### `src/server/createAssistantSettingsActions.js`
+Exports
+- `createAssistantSettingsActions({ assistantConfigService, settingsSurfaces })`
+
+### `src/server/index.js`
+Exports
+- `AssistantFeature`
+- `createAssistantActions`
+- `assistantConversationGoalBodyValidator`
+- `registerAssistantRoutes`
+- `registerConversationSubscriptions`
+- `registerFastifyConversations`
 
 ### `src/server/inputSchemas.js`
 Exports
+- `assistantConversationIdInputValidator`
+- `assistantConversationMessageIdInputValidator`
+- `assistantConversationReadQueryValidator`
+- `assistantConversationSendBodyValidator`
+- `conversationSendBodyValidator(conversationDataSchema = null)`
+- `conversationConfigureBodyValidator(configurationSchema)`
+- `conversationSelectBodyValidator(selectionSchema)`
+- `conversationReplaceBodyValidator(replacementSchema)`
+- `assistantConversationGoalBodyValidator`
 - `assistantSurfaceRouteParamsValidator`
 - `assistantTargetSurfaceInputValidator`
 
+### `src/server/registerConversationSubscriptions.js`
+Exports
+- `registerConversationSubscriptions({ realtime, events, actions, config = {}, workspaceScopeSupport = null, subscribeActionId = actionIds.conversationSubscribe, requestPolicy = "authenticated" } = {})`
+Local functions
+- `requireSubscriptionId(input)`
+- `subscriptionError(error)`
+
+### `src/server/registerFastifyConversations.js`
+Exports
+- `registerFastifyConversations(app, { runtime, config, authenticate, bootstrap, env = process.env } = {})`
+
 ### `src/server/registerRoutes.js`
 Exports
-- `registerRoutes(router, { config = {}, workspaceScopeSupport = null } = {})`
+- `registerRoutes(router, { config = {}, workspaceScopeSupport = null, conversationRuntime = null, conversationAccess = null, conversationDataSchema = null, conversationConfigurationSchema = null, conversationSelectionSchema = null, conversationReplacementSchema = null, assistantConfigService = null } = {})`
 Local functions
-- `requireWorkspaceAssistantRouteParams(workspaceScopeSupport = null)`
-- `readWorkspaceInput(request, requiresWorkspace, workspaceScopeSupport = null)`
-- `requireAssistantSurface(appConfig = {}, targetSurfaceId = "")`
-- `requireHostSurfaceId(request)`
 - `shouldExposeAppErrorDetails(errorCode = "")`
 - `sendPreStreamErrorResponse(reply, error)`
-- `resolveRouteRequestState(request, { resolveCurrentAppConfig = () => ({}), kind = "runtime", requiresWorkspace = false, workspaceScopeSupport = null } = {})`
 - `buildChatStreamActionInput(routeInput = {}, requestBody = {})`
-- `resolveAssistantSettingsRecordId(record = {})`
 - `resolveAssistantConversationMessagesRecordId(record = {})`
-- `registerSettingsRoutes(router, resolveCurrentAppConfig, { requiresWorkspace = false, workspaceScopeSupport = null } = {})`
 - `registerRuntimeRoutes(router, resolveCurrentAppConfig, { requiresWorkspace = false, workspaceScopeSupport = null } = {})`
+- `registerConversationRoutes(router, resolveCurrentAppConfig, { requiresWorkspace = false, workspaceScopeSupport = null, conversationDataSchema = null, conversationConfigurationSchema = null, conversationSelectionSchema = null, conversationReplacementSchema = null } = {})`
+
+### `src/server/registerSettingsRoutes.js`
+Exports
+- `registerSettingsRoutes(router, resolveCurrentAppConfig, { requiresWorkspace = false, workspaceScopeSupport = null } = {})`
+Local functions
+- `resolveAssistantSettingsRecordId(record = {})`
 
 ### `src/server/repositories/assistantConfigRepository.js`
 Exports
@@ -170,42 +234,50 @@ Exports
 
 ### `src/server/services/chatService.js`
 Exports
-- `createChatService({ aiClientFactory, turnRequests, attachments, transcriptService, serviceToolCatalog, assistantConfigService, appConfig = {}, resolveAppConfig = null, workspaceScopeSupport = null } = {})`
+- `createChatService({ conversationRuntime, aiClientFactory, turnRequests, attachments, transcriptService, serviceToolCatalog, assistantConfigService, appConfig = {}, resolveAppConfig = null, workspaceScopeSupport = null } = {})`
 Local functions
 - `normalizeConversationId(value)`
 - `normalizeHistory(history = [])`
 - `normalizeStreamInput(payload = {})`
 - `hasStreamWriter(streamWriter)`
 - `isAbortError(error)`
-- `requiresCurrentTime(value = "")`
-- `resolvePreflightTools(toolDescriptors = [], input = "")`
-- `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(toolCalls = [])`
-- `parseDsmlToolCallsFromText(value = "")`
-- `consumeCompletionStream(stream, onText = () => {})`
 - `requireAssistantSurface(appConfig = {}, targetSurfaceId = "")`
 - `buildAssistantActionContext(context = {}, assistantSurface = {})`
 
 ### `src/server/services/transcriptService.js`
 Exports
 - `createTranscriptService({ conversationsRepository, messagesRepository } = {})`
+- `deriveConversationTitleFromMessage(contentText)`
+- `isDefaultConversationTitle(value)`
 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/sqlConversationStorage.js`
+Exports
+- `createSqlConversationStorage({ conversationsRepository, messagesRepository })`
+- `inspectSqlConversationRows(conversation, rows)`
+Local functions
+- `authored(row)`
+- `rowLink(row)`
+- `messageFromRow(row)`
+- `requireUnambiguous(projection)`
+
+### `src/server/support/assistantRouteContext.js`
+Exports
+- `requireWorkspaceAssistantRouteParams(workspaceScopeSupport = null)`
+- `resolveRouteRequestState(request, { resolveCurrentAppConfig = () => ({}), kind = "runtime", requiresWorkspace = false, workspaceScopeSupport = null } = {})`
+Local functions
+- `readWorkspaceInput(request, requiresWorkspace, workspaceScopeSupport = null)`
+- `requireAssistantSurface(appConfig = {}, targetSurfaceId = "")`
+- `requireHostSurfaceId(request)`
+
 ### `src/server/support/assistantServerConfig.js`
 Exports
 - `resolveAssistantServerConfigMap(appConfig = {})`
@@ -221,24 +293,28 @@ Local functions
 - `buildCatalogOptions(appConfig = {}, surfaceId = "")`
 - `requireContextSurfaceId(context = {})`
 
-### `src/shared/assistantResponseText.js`
-Exports
-- `isAssistantProgressOnlyText(value)`
-
 ### `src/shared/assistantRuntimeConfig.js`
 Exports
 - `assistantRuntimeConfig`
 
 ### `src/shared/assistantSurfaces.js`
 Exports
+- `defineAssistantSurface(surfaceId, { pagesRoot = "", requiresWorkspace = false, configScope = requiresWorkspace ? "workspace" : "global", ...definition } = {})`
 - `normalizeAssistantConfigScope(value = "")`
 - `resolveAssistantSurfaceConfig(appConfig = {}, targetSurfaceId = "")`
 - `resolveAssistantSurfacesConfig(appConfig = {})`
 - `resolveSurfaceDefinitions(appConfig = {})`
 
+### `src/shared/conversationRealtime.js`
+Exports
+- `ASSISTANT_CONVERSATION_SUBSCRIBE`
+- `ASSISTANT_CONVERSATION_UNSUBSCRIBE`
+- `ASSISTANT_CONVERSATION_EVENT`
+
 ### `src/shared/index.js`
 Exports
 - `assistantRuntimeConfig`
+- `defineAssistantSurface`
 - `normalizeAssistantConfigScope`
 - `resolveAssistantSurfaceConfig`
 - `resolveAssistantSurfacesConfig`
@@ -246,6 +322,28 @@ Exports
 
 ### fixtures
 
+### `fixtures/canonical-conversation/App.vue`
+Exports
+- None
+Local functions
+- `recordDispatch(messageId)`
+
+### `fixtures/canonical-conversation/DraftConversation.vue`
+Exports
+- None
+
+### `fixtures/canonical-conversation/main.js`
+Exports
+- None
+
+### `fixtures/canonical-conversation/socket.js`
+Exports
+- `createFixtureSocket()`
+
+### `fixtures/canonical-conversation/vite.config.mjs`
+Exports
+- None
+
 ### `fixtures/conversation/App.vue`
 Exports
 - None

package/reference/autogen/packages/assistant-voice-sherpa.md

@@ -0,0 +1,82 @@
+# packages/assistant-voice-sherpa
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `packages/assistant-voice-sherpa`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `packages/assistant-voice-sherpa/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
+
+## Sections
+
+### src
+
+### `src/cli.js`
+Exports
+- `argumentMap(values = [])`
+- `runVoiceCli(argv = process.argv.slice(2), { createDaemon = createVoiceDaemon, recognitionVocabulary = {} } = {})`
+Local functions
+- `requiredOption(options, key, environmentKey = "")`
+- `accessKeyFromFile(filePath)`
+- `positiveInteger(value, fallback)`
+- `usage()`
+
+### `src/index.js`
+Exports
+- `createSherpaSpeechEngine`
+- `verifyVoiceModelContract`
+- `readVoiceModelContract`
+
+### `src/sherpaSpeechEngine.js`
+Exports
+- `createSherpaSpeechEngine({ modelsRoot = "", configuration = {}, recognizerActivePaths = 16, recognizerThreads = 1, sherpa = null, createSynthesizer = createSynthesisProcess, synthesizerThreads = 1 } = {})`
+- `positiveActivePathCount(value, fallback = 16)`
+- `positiveThreadCount(value, fallback = 1)`
+- `runtimeValue(runtime, key)`
+
+### `src/synthesisProcess.js`
+Exports
+- `createSynthesisProcess(configuration, { outputSampleRate, workerUrl = new URL("./synthesisWorker.js", import.meta.url) } = {})`
+
+### `src/synthesisWorker.js`
+Exports
+- None
+Local functions
+- `sendAudio(samples)`
+
+### `src/voiceModelContract.js`
+Exports
+- `VOICE_MODEL_CONTRACT_SCHEMA`
+- `modelFilePath(modelsRoot = "", relativePath = "")`
+- `readVoiceModelContract({ contractPath = "", modelsRoot = "" } = {})`
+- `sha256File(filePath = "")`
+- `verifyVoiceModelContract({ contractPath = "", modelsRoot = "" } = {})`
+Local functions
+- `modelContractError(code, message)`
+
+### bin
+
+### `bin/jskit-assistant-voice.js`
+Exports
+- None
+
+### tooling
+
+### `tooling/build-voice-model-contract.mjs`
+Exports
+- None
+Local functions
+- `collectFiles(root, relativeRoot = "")`
+
+### `tooling/stage-voice-models.mjs`
+Exports
+- None
+Local functions
+- `contained(root, relative)`
+
+### `tooling/verify-voice-models.mjs`
+Exports
+- None

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

@@ -0,0 +1,227 @@
+# packages/assistant-voice
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `packages/assistant-voice`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `packages/assistant-voice/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `.vitepress/cache/`, `.vitepress/dist/`
+
+## Sections
+
+### src
+
+### `src/client/audioCapture.js`
+Exports
+- `createMicrophoneCapture({ onLevel, onPcm, targetSampleRate = 16_000 } = {})`
+- `float32ToPcm16ArrayBuffer(samples)`
+
+### `src/client/ConversationDialog.vue`
+Exports
+- None
+Local functions
+- `outsideClick(event)`
+- `updateOpen(value)`
+
+### `src/client/conversationNarration.js`
+Exports
+- `createConversationNarrationTracker()`
+- `latestConversationFinalNarrationEntry(turns = [])`
+
+### `src/client/conversationVoiceState.js`
+Exports
+- `projectConversationVoiceState({ turns = [], status = "ready", interimReply = null } = {})`
+
+### `src/client/index.js`
+Exports
+- `projectConversationVoiceState`
+- `createVoiceConversationController`
+- `VoiceConversationHost`
+- `ConversationDialog`
+- `VoiceConversation`
+- `useVoiceLauncher`
+- `useVoiceAvatar`
+- `VoiceAvatar`
+
+### `src/client/voiceAvatar.js`
+Exports
+- `useVoiceAvatar(props)`
+
+### `src/client/VoiceAvatar.vue`
+Exports
+- None
+
+### `src/client/voiceController.js`
+Exports
+- `createVoiceConversationController({ connectSpeech, createSession = useVoiceConversation } = {})`
+
+### `src/client/voiceConversation.js`
+Exports
+- `useVoiceConversation(binding, { socketUrl, createTransport = useVoiceTransport } = {})`
+
+### `src/client/VoiceConversation.vue`
+Exports
+- None
+Local functions
+- `isAtBottom(element)`
+
+### `src/client/VoiceConversationHost.vue`
+Exports
+- None
+Local functions
+- `invoke(operation)`
+- `openText()`
+
+### `src/client/voiceLauncher.js`
+Exports
+- `useVoiceLauncher({ open, enabled = true, onTap = null, onError = () => {} })`
+
+### `src/client/voicePlayback.js`
+Exports
+- `MOUTH_POSES`
+- `normalizeSpeechSegment(message = {}, sampleRate = 22_050)`
+- `pcm16ArrayBufferToFloat32(buffer)`
+- `visemeCueAtTime(segments = [], currentTime = 0)`
+
+### `src/client/voiceTransport.js`
+Exports
+- `useVoiceTransport({ socketUrl, speechEnabled = true, interruptSpeechOnListen = false, autoReconnect = false, voiceId = "" } = {})`
+- `voiceTurnId(prefix = "turn")`
+Local functions
+- `resolveWebSocketUrl(value)`
+
+### `src/server/index.js`
+Exports
+- `createVoiceDaemon`
+- `registerVoiceProxyRoute`
+- `readVoiceCatalogue`
+- `resolveVoiceProxyConfig`
+- `readVoiceAccessToken`
+- `voiceEndpoint`
+- `createVoiceAccessToken`
+- `verifyVoiceAccessToken`
+- `bearerVoiceAccessToken`
+- `normalizeVoiceCloseMetadata`
+
+### `src/server/voiceAccessToken.js`
+Exports
+- `VOICE_ACCESS_TOKEN_VERSION`
+- `bearerVoiceAccessToken(headers = {})`
+- `createVoiceAccessToken({ key, tenant } = {})`
+- `verifyVoiceAccessToken(token = "", { key } = {})`
+- `voiceAccessKey(value = "")`
+- `voiceTenant(value = "")`
+Local functions
+- `voiceAccessSignature(key, tenant)`
+
+### `src/server/voiceDaemon.js`
+Exports
+- `createBoundedSerialQueue({ maximumQueued = 4 } = {})`
+- `createVoiceDaemon({ accessKey, authorize = token => verifyVoiceAccessToken(token, { key: accessKey }), handleRequest = null, engine, host = "127.0.0.1", idleTimeoutMs = 90_000, logger = console, maximumConnections = 8, maximumConnectionsPerTenant = 2, maximumQueuedSpeech = 4, port = 3092 } = {})`
+- `sendJson(socket, type, fields = {})`
+- `voiceDaemonError(error, fallback = "Voice operation failed.")`
+Local functions
+- `sendPcm(socket, audio = Buffer.alloc(0))`
+- `requestPathname(request = {})`
+- `writeJsonResponse(response, statusCode, payload)`
+
+### `src/server/voiceProxy.js`
+Exports
+- `closeSocket(socket, code, reason)`
+- `readVoiceCatalogue(config, { fetchImpl = fetch } = {})`
+- `registerVoiceProxyRoute(fastify, { proxyConfig, route, authorize = null, WebSocketCtor = WebSocket } = {})`
+Local functions
+- `sendSocketError(socket, code, message)`
+
+### `src/server/voiceProxyConfig.js`
+Exports
+- `readVoiceAccessToken(filePath = "")`
+- `resolveVoiceProxyConfig({ endpoint: value = "", accessTokenFile = "" } = {})`
+- `voiceEndpoint(value = "")`
+
+### `src/server/voiceSocketClose.js`
+Exports
+- `normalizeVoiceCloseMetadata(code, reason)`
+Local functions
+- `proxyCloseCode(code)`
+- `proxyCloseReason(reason)`
+
+### `src/shared/protocol.js`
+Exports
+- `VOICE_DAEMON_WEBSOCKET_PATH`
+- `VOICE_INPUT_SAMPLE_RATE`
+- `VOICE_MAX_AUDIO_FRAME_BYTES`
+- `VOICE_MAX_CONTROL_BYTES`
+- `VOICE_MAX_SPEECH_CHUNK_CHARACTERS`
+- `VOICE_MAX_SPEECH_TEXT_CHARACTERS`
+- `VOICE_MAX_UTTERANCE_SECONDS`
+- `VOICE_OUTPUT_SAMPLE_RATE`
+- `VOICE_PROTOCOL_VERSION`
+- `assertVoiceAudioFrame(frame = null)`
+- `float32ToPcm16Le(samples = new Float32Array())`
+- `normalizeRecognizedText(value = "", vocabulary = {})`
+- `parseVoiceClientControl(raw = "")`
+- `pcm16LeToFloat32(frame = Buffer.alloc(0))`
+- `speechPauseDurationMs(value = "")`
+- `speechPhrases(value = "")`
+- `speechTextFromAssistant(value = "", maximumCharacters = VOICE_MAX_SPEECH_TEXT_CHARACTERS)`
+- `splitSpeechText(value = "", maximumCharacters = VOICE_MAX_SPEECH_CHUNK_CHARACTERS)`
+- `takeStreamingSpeech(text = "", final = false, maximumCharacters = 140)`
+- `voiceProtocolError(code, message)`
+- `voiceServerMessage(type = "", fields = {})`
+- `voiceTurnId(value = "")`
+
+### `src/shared/visemes.js`
+Exports
+- `MAX_VISEME_CUES`
+- `characterViseme(character = "")`
+- `visemeCuesFromText(value = "", durationMs = 0)`
+- `visemeUnitsFromText(value = "")`
+Local functions
+- `appendUnit(units, pose, level, weight)`
+
+### examples
+
+### `examples/conversation/App.vue`
+Exports
+- None
+Local functions
+- `openText(id)`
+- `voiceBinding(runtime, label)`
+- `openVoice(runtime, label)`
+
+### `examples/conversation/config.js`
+Exports
+- `conversations`
+- `appConfig`
+
+### `examples/conversation/Conversation.vue`
+Exports
+- None
+
+### `examples/conversation/main.js`
+Exports
+- None
+
+### `examples/conversation/server.js`
+Exports
+- `createExampleServer({ env = process.env } = {})`
+
+### `examples/conversation/src/error.js`
+Exports
+- `default`
+
+### `examples/conversation/src/placement.js`
+Exports
+- None
+
+### `examples/conversation/src/placementTopology.js`
+Exports
+- None
+
+### `examples/conversation/vite.config.js`
+Exports
+- None

package/reference/autogen/packages/kernel.md

@@ -713,6 +713,7 @@ Exports
 Exports
 - `createCapabilityHttpRuntime`
 - `HttpProvider`
+- `attachDirectRequestActionExecutor`
 - `createCachedResponseSerializerFactory`
 
 ### `server/http/lib/controller.js`
@@ -1049,6 +1050,14 @@ Local functions
 Exports
 - `defaultMissingHandler(_request, reply)`
 
+### `server/support/fileLock.js`
+Exports
+- `FILE_LOCK_ERROR_CODE`
+- `tryAcquireExclusiveFileLock(lockPath = "", { cwd = "", errorCode = FILE_LOCK_ERROR_CODE } = {})`
+Local functions
+- `fileLockError(message = "", code = FILE_LOCK_ERROR_CODE)`
+- `normalizedAbsolutePath(value = "", label = "path", errorCode = FILE_LOCK_ERROR_CODE)`
+
 ### `server/support/importFreshModuleFromAbsolutePath.js`
 Exports
 - `importFreshModuleFromAbsolutePath(absolutePath)`
@@ -1086,6 +1095,7 @@ Exports
 - `discoverShellOutletTargetsFromApp`
 - `resolveSemanticPlacementTargetFromApp`
 - `resolveShellOutletPlacementTargetFromApp`
+- `tryAcquireExclusiveFileLock`
 
 ### `server/support/pageTargets.js`
 Exports

package/reference/autogen/packages/realtime.md

@@ -48,8 +48,9 @@ Exports
 
 ### `src/server/realtimeAudience.js`
 Exports
+- `createSocketRequest(socket)`
 - `realtimeAuthenticationRequired(authService = null)`
-- `revalidateSocket({ socket, authService, workspaces = null })`
+- `revalidateSocket({ socket, authService, workspaces = null, request })`
 - `registerSocketAudienceBootstrap({ io, logger, authService = null, workspaces = null })`
 - `resolveAudienceTargets(audience, event, { database = null, logger })`
 Local functions
@@ -64,7 +65,7 @@ Local functions
 - `addAudienceRooms(selection, state)`
 - `collectUserIds(rows)`
 - `parseCookieHeader(value = "")`
-- `resolveSocketActor(authService, socket)`
+- `resolveSocketActor(authService, socket, request = createSocketRequest(socket))`
 - `authenticationRequiredError()`
 - `rememberSocketActorId(socket, actorId)`
 - `registerRequiredSocketAuthentication({ io, logger, authService })`
@@ -94,6 +95,8 @@ Exports
 - `configureSocketIoRedisAdapter(io, { redisUrl = "", redisNamespace = "", logger = console, createRedisAdapter = createSocketIoRedisAdapter, createRedisConnection = createRedisClient } = {})`
 - `closeSocketIoRedisConnections({ pubClient = null, subClient = null } = {})`
 Local functions
+- `toRequestPathname(urlValue)`
+- `registerSocketIoUpgradeHandoff(fastify)`
 - `resolveHttpServer({ httpServer = null, fastify = null } = {})`
 - `buildSocketIoRedisAdapterKey(redisNamespace = "")`