akanjs 3.0.0-alpha.7 → 3.0.0-alpha.71
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +103 -0
- package/README.ko.md +1 -1
- package/README.md +1 -1
- package/base/baseEnv.ts +7 -4
- package/base/primitiveRegistry.ts +59 -12
- package/base/symbols.ts +4 -0
- package/client/capacitor.ts +34 -0
- package/client/clientRuntime.ts +5 -0
- package/client/csrTypes.ts +4 -3
- package/client/index.ts +1 -0
- package/client/locale.ts +2 -2
- package/client/router.ts +7 -7
- package/client/sharedContext.ts +31 -0
- package/client/translator.ts +2 -2
- package/client/types.ts +3 -3
- package/common/Logger.ts +280 -67
- package/common/clientAddress.ts +40 -0
- package/common/deepObjectify.ts +24 -9
- package/common/index.ts +42 -1
- package/common/logContext.ts +27 -0
- package/common/mcpExposure.ts +114 -0
- package/common/pathGetLoose.ts +31 -0
- package/common/pathSet.ts +17 -5
- package/common/plainFieldsOf.ts +13 -0
- package/common/routeConvention.ts +22 -12
- package/common/websocketBinaryFrame.ts +46 -0
- package/constant/crystalize.ts +94 -28
- package/constant/dateSlot.ts +62 -0
- package/constant/deserialize.ts +3 -2
- package/constant/fieldInfo.ts +43 -3
- package/constant/fieldQueryMeta.ts +35 -0
- package/constant/getDefault.ts +16 -11
- package/constant/hydrationPlan.ts +72 -0
- package/constant/immerify.ts +4 -6
- package/constant/index.ts +5 -0
- package/constant/labelOf.ts +26 -0
- package/constant/mask.ts +67 -0
- package/constant/purify.ts +17 -11
- package/constant/textFieldPaths.ts +13 -7
- package/constant/types.ts +19 -13
- package/constant/via.ts +24 -17
- package/dictionary/DictionaryLookup.ts +30 -0
- package/dictionary/agent.dictionary.ts +31 -0
- package/dictionary/agentTurn.dictionary.ts +29 -0
- package/dictionary/base.dictionary.ts +81 -0
- package/dictionary/dictInfo.ts +11 -2
- package/dictionary/dictionary.ts +9 -3
- package/dictionary/index.ts +1 -0
- package/dictionary/trans.ts +2 -2
- package/document/documentQuery.ts +1 -0
- package/document/filterMeta.ts +77 -12
- package/document/index.ts +1 -0
- package/document/noDocumentError.ts +12 -0
- package/document/types.ts +0 -1
- package/fetch/agentTurn.ts +19 -0
- package/fetch/client/fetchClient.ts +137 -37
- package/fetch/client/httpClient.ts +95 -20
- package/fetch/client/wsClient.ts +27 -12
- package/fetch/fetchType/appliedReturn.type.ts +65 -44
- package/fetch/fetchType/endpointFetch.type.ts +17 -8
- package/fetch/fetchType/sliceFetch.type.ts +27 -50
- package/fetch/index.ts +1 -0
- package/index.ts +80 -6
- package/local/apps/akan/akan-local.db +0 -0
- package/local/apps/akan/akan-local.db-shm +0 -0
- package/local/apps/akan/akan-local.db-wal +0 -0
- package/local/apps/akan/akan-local_solid.db +0 -0
- package/local/apps/akan/akan-local_solid.db-shm +0 -0
- package/local/apps/akan/akan-local_solid.db-wal +0 -0
- package/local/apps/serverLifecycle/serverLifecycle-local.db +0 -0
- package/local/apps/serverLifecycle/serverLifecycle-local.db-shm +0 -0
- package/local/apps/serverLifecycle/serverLifecycle-local.db-wal +0 -0
- package/local/apps/serverLifecycle/serverLifecycle-local_solid.db +0 -0
- package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm +0 -0
- package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-wal +0 -0
- package/package.json +27 -18
- package/server/akanApp.ts +278 -138
- package/server/akanAppHeaders.ts +16 -2
- package/server/akanOption.ts +63 -8
- package/server/akanServer.ts +387 -32
- package/server/animatedImage.ts +83 -0
- package/server/assetEncoding.ts +4 -24
- package/server/binaryPubsub.ts +55 -0
- package/server/console.ts +110 -101
- package/server/consoleEvaluator.ts +51 -0
- package/server/consolePasteFilter.ts +91 -0
- package/server/consoleSession.ts +242 -0
- package/server/contentEncoding.ts +83 -0
- package/server/devtools/signalSerializer.ts +2 -2
- package/server/devtools/types.ts +4 -4
- package/server/di/diLifecycle.ts +123 -13
- package/server/di/predefinedAdaptor.ts +6 -0
- package/server/di/utils.ts +40 -0
- package/server/imageOptimizer.ts +154 -57
- package/server/lifecycle/runtimeDir.ts +14 -0
- package/server/lifecycle/shutdownManager.ts +1 -1
- package/server/logging/childOutputReader.ts +137 -0
- package/server/logging/hubFileSink.ts +39 -0
- package/server/logging/logControlSocket.ts +173 -0
- package/server/logging/logForwarder.ts +131 -0
- package/server/logging/logHub.ts +0 -0
- package/server/logging/logQuery.ts +130 -0
- package/server/logging/logStdoutWriter.ts +39 -0
- package/server/logging/logStreamRoute.ts +87 -0
- package/server/logging/logTailClient.ts +161 -0
- package/server/mcp/McpAuth.ts +177 -0
- package/server/mcp/McpDispatcher.ts +289 -0
- package/server/mcp/McpEventStream.ts +24 -0
- package/server/mcp/McpExecutionContext.ts +105 -0
- package/server/mcp/McpRouter.ts +621 -0
- package/server/mcp/index.ts +5 -0
- package/server/processMetricsCollector.ts +1 -1
- package/server/resolver/database.resolver.ts +5 -4
- package/server/resolver/signal.resolver.ts +208 -86
- package/server/routeTreeBuilder.ts +10 -8
- package/server/routing/apiRouter.ts +44 -14
- package/server/routing/appWsData.ts +24 -2
- package/server/routing/eventStream.ts +93 -0
- package/server/routing/soloAppRoutes.ts +50 -0
- package/server/rscWorker.tsx +36 -22
- package/server/rscWorkerHost.ts +59 -8
- package/server/semaphore.ts +22 -0
- package/server/subRouteIndexDocument.tsx +61 -0
- package/server/systemPageDocument.tsx +3 -3
- package/server/systemPages.tsx +49 -16
- package/server/types.tsx +28 -0
- package/server/vendor/akanjs-fetch.ts +1 -0
- package/server/webRouter.ts +96 -39
- package/service/adapt.ts +4 -4
- package/service/agent.service.ts +81 -0
- package/service/base.service.ts +2 -1
- package/service/index.ts +1 -0
- package/service/injectInfo.ts +8 -3
- package/service/ipcTypes.ts +6 -0
- package/service/predefinedAdaptor/compress.adaptor.ts +5 -1
- package/service/predefinedAdaptor/database.adaptor.ts +68 -37
- package/service/predefinedAdaptor/deepseekLlm.ts +271 -0
- package/service/predefinedAdaptor/index.ts +3 -0
- package/service/predefinedAdaptor/insightQuery.ts +183 -0
- package/service/predefinedAdaptor/llm.adaptor.ts +115 -0
- package/service/predefinedAdaptor/logging.adaptor.ts +1 -1
- package/service/predefinedAdaptor/queue.adaptor.ts +5 -2
- package/service/predefinedAdaptor/role.adaptor.ts +2 -0
- package/service/predefinedAdaptor/schedule.adaptor.ts +12 -5
- package/service/predefinedAdaptor/solidPubsub.adaptor.ts +10 -6
- package/service/predefinedAdaptor/solidQueue.adaptor.ts +6 -2
- package/service/predefinedAdaptor/solidSqlite.ts +11 -9
- package/service/predefinedAdaptor/websocket.adaptor.ts +6 -1
- package/service/serve.ts +16 -9
- package/service/toolNames.ts +119 -0
- package/signal/agent/AgentCatalogue.ts +165 -0
- package/signal/agent/index.ts +1 -0
- package/signal/agent.signal.ts +38 -0
- package/signal/agentTurn.ts +8 -0
- package/signal/agentTurnStream.ts +60 -0
- package/signal/base.signal.ts +2 -1
- package/signal/endpointInfo.ts +38 -2
- package/signal/guard.ts +28 -1
- package/signal/guards.ts +49 -1
- package/signal/index.ts +6 -0
- package/signal/intercept.ts +4 -4
- package/signal/internalArg.ts +21 -4
- package/signal/mcp/McpDocument.ts +326 -0
- package/signal/mcp/McpProgress.ts +106 -0
- package/signal/mcp/McpUriTemplate.ts +80 -0
- package/signal/mcp/Msg.ts +368 -0
- package/signal/mcp/index.ts +5 -0
- package/signal/mcp/mcpProtocol.ts +120 -0
- package/signal/middleware.ts +3 -3
- package/signal/openapi/openapi.ts +36 -173
- package/signal/schema/JsonSchemaBuilder.ts +221 -0
- package/signal/schema/index.ts +1 -0
- package/signal/serializer/fetch.serializer.ts +51 -0
- package/signal/signalContext.ts +324 -76
- package/signal/slice.ts +62 -27
- package/signal/trace.ts +268 -9
- package/signal/types.ts +55 -4
- package/store/action.ts +34 -41
- package/store/actionTag.ts +33 -0
- package/store/agent/AgentBridge.ts +87 -0
- package/store/agent/AgentContext.ts +71 -0
- package/store/agent/AgentPrompts.ts +111 -0
- package/store/agent/ScreenReader.ts +349 -0
- package/store/agent/ScreenSettle.ts +45 -0
- package/store/agent/ScreenTarget.ts +135 -0
- package/store/agent/StoreCatalogue.ts +116 -0
- package/store/agent/StoreSurfaceSource.ts +225 -0
- package/store/agent/index.ts +13 -0
- package/store/agent/storeSurface.ts +28 -0
- package/store/agent/types.ts +16 -0
- package/store/agentic/AgentValue.ts +119 -0
- package/store/agentic/StExposeBuilder.ts +47 -0
- package/store/agentic/StExposeDraft.ts +24 -0
- package/store/agentic/StStateBuilder.ts +85 -0
- package/store/agentic/StStateDraft.ts +23 -0
- package/store/agentic/StToolBuilder.ts +279 -0
- package/store/agentic/StToolDraft.ts +22 -0
- package/store/agentic/attachAgentic.ts +33 -0
- package/store/agentic/formFields.ts +194 -0
- package/store/agentic/index.ts +12 -0
- package/store/agentic/useFieldTool.ts +183 -0
- package/store/agentic/useFormTools.ts +77 -0
- package/store/agentic/useRelationFieldTool.ts +113 -0
- package/store/baseSt.ts +1 -1
- package/store/databaseStateNames.ts +31 -0
- package/store/formSetterNames.ts +35 -0
- package/store/index.ts +8 -0
- package/store/rootStore.ts +3 -1
- package/store/sliceRole.ts +36 -0
- package/store/state.ts +2 -12
- package/store/store.ts +9 -0
- package/store/storeInstance.ts +185 -20
- package/store/storeRegistry.ts +39 -1
- package/store/types.ts +5 -0
- package/store/withSelector.ts +5 -4
- package/test/index.ts +1 -1
- package/test/registerDom.ts +4 -0
- package/test/sampleOf.ts +2 -0
- package/test/signalTestRuntime.ts +5 -5
- package/test/testServer.ts +14 -11
- package/types/base/baseEnv.d.ts +1 -1
- package/types/base/primitiveRegistry.d.ts +20 -8
- package/types/base/symbols.d.ts +4 -0
- package/types/client/capacitor.d.ts +39 -0
- package/types/client/clientRuntime.d.ts +7 -0
- package/types/client/index.d.ts +1 -0
- package/types/client/sharedContext.d.ts +21 -0
- package/types/client/types.d.ts +5 -3
- package/types/common/Logger.d.ts +88 -6
- package/types/common/clientAddress.d.ts +19 -0
- package/types/common/deepObjectify.d.ts +4 -2
- package/types/common/index.d.ts +8 -2
- package/types/common/logContext.d.ts +17 -0
- package/types/common/mcpExposure.d.ts +64 -0
- package/types/common/pathGetLoose.d.ts +8 -0
- package/types/common/plainFieldsOf.d.ts +6 -0
- package/types/common/routeConvention.d.ts +6 -0
- package/types/common/websocketBinaryFrame.d.ts +17 -0
- package/types/constant/constantRegistry.d.ts +2 -10
- package/types/constant/crystalize.d.ts +5 -0
- package/types/constant/dateSlot.d.ts +14 -0
- package/types/constant/fieldInfo.d.ts +20 -3
- package/types/constant/fieldQueryMeta.d.ts +17 -0
- package/types/constant/getDefault.d.ts +8 -0
- package/types/constant/hydrationPlan.d.ts +24 -0
- package/types/constant/index.d.ts +5 -0
- package/types/constant/labelOf.d.ts +7 -0
- package/types/constant/mask.d.ts +41 -0
- package/types/constant/purify.d.ts +2 -2
- package/types/constant/types.d.ts +5 -5
- package/types/dictionary/DictionaryLookup.d.ts +14 -0
- package/types/dictionary/agent.dictionary.d.ts +1 -0
- package/types/dictionary/agentTurn.dictionary.d.ts +1 -0
- package/types/dictionary/base.dictionary.d.ts +1 -1
- package/types/dictionary/dictInfo.d.ts +7 -1
- package/types/dictionary/dictionary.d.ts +11 -9
- package/types/dictionary/index.d.ts +1 -0
- package/types/document/filterMeta.d.ts +24 -4
- package/types/document/index.d.ts +1 -0
- package/types/document/noDocumentError.d.ts +12 -0
- package/types/document/types.d.ts +0 -1
- package/types/fetch/agentTurn.d.ts +475 -0
- package/types/fetch/client/fetchClient.d.ts +12 -0
- package/types/fetch/client/httpClient.d.ts +2 -1
- package/types/fetch/fetchType/appliedReturn.type.d.ts +37 -18
- package/types/fetch/fetchType/endpointFetch.type.d.ts +8 -5
- package/types/fetch/fetchType/sliceFetch.type.d.ts +11 -15
- package/types/fetch/index.d.ts +1 -0
- package/types/index.d.ts +74 -10
- package/types/server/akanApp.d.ts +12 -0
- package/types/server/akanAppHeaders.d.ts +7 -1
- package/types/server/akanOption.d.ts +36 -6
- package/types/server/akanServer.d.ts +67 -9
- package/types/server/animatedImage.d.ts +7 -0
- package/types/server/assetEncoding.d.ts +1 -1
- package/types/server/binaryPubsub.d.ts +18 -0
- package/types/server/console.d.ts +11 -1
- package/types/server/consoleEvaluator.d.ts +2 -0
- package/types/server/consolePasteFilter.d.ts +11 -0
- package/types/server/consoleSession.d.ts +22 -0
- package/types/server/contentEncoding.d.ts +28 -0
- package/types/server/devtools/types.d.ts +4 -4
- package/types/server/di/diLifecycle.d.ts +10 -2
- package/types/server/di/predefinedAdaptor.d.ts +4 -1
- package/types/server/di/utils.d.ts +16 -0
- package/types/server/lifecycle/runtimeDir.d.ts +5 -0
- package/types/server/logging/childOutputReader.d.ts +40 -0
- package/types/server/logging/hubFileSink.d.ts +18 -0
- package/types/server/logging/logControlSocket.d.ts +60 -0
- package/types/server/logging/logForwarder.d.ts +37 -0
- package/types/server/logging/logHub.d.ts +70 -0
- package/types/server/logging/logQuery.d.ts +31 -0
- package/types/server/logging/logStdoutWriter.d.ts +35 -0
- package/types/server/logging/logStreamRoute.d.ts +20 -0
- package/types/server/logging/logTailClient.d.ts +42 -0
- package/types/server/mcp/McpAuth.d.ts +62 -0
- package/types/server/mcp/McpDispatcher.d.ts +61 -0
- package/types/server/mcp/McpEventStream.d.ts +17 -0
- package/types/server/mcp/McpExecutionContext.d.ts +44 -0
- package/types/server/mcp/McpRouter.d.ts +65 -0
- package/types/server/mcp/index.d.ts +5 -0
- package/types/server/mcp.d.ts +1 -0
- package/types/server/resolver/signal.resolver.d.ts +7 -4
- package/types/server/routing/apiRouter.d.ts +2 -1
- package/types/server/routing/appWsData.d.ts +13 -1
- package/types/server/routing/eventStream.d.ts +23 -0
- package/types/server/routing/soloAppRoutes.d.ts +17 -0
- package/types/server/rscWorkerHost.d.ts +4 -1
- package/types/server/semaphore.d.ts +5 -0
- package/types/server/subRouteIndexDocument.d.ts +8 -0
- package/types/server/systemPageDocument.d.ts +1 -0
- package/types/server/systemPages.d.ts +5 -0
- package/types/server/types.d.ts +16 -0
- package/types/server/vendor/akanjs-fetch.d.ts +1 -0
- package/types/server/webRouter.d.ts +15 -4
- package/types/service/adapt.d.ts +2 -2
- package/types/service/agent.service.d.ts +32 -0
- package/types/service/base.service.d.ts +4 -0
- package/types/service/index.d.ts +1 -0
- package/types/service/injectInfo.d.ts +2 -2
- package/types/service/ipcTypes.d.ts +12 -0
- package/types/service/predefinedAdaptor/compress.adaptor.d.ts +1 -1
- package/types/service/predefinedAdaptor/database.adaptor.d.ts +9 -3
- package/types/service/predefinedAdaptor/deepseekLlm.d.ts +76 -0
- package/types/service/predefinedAdaptor/index.d.ts +3 -0
- package/types/service/predefinedAdaptor/insightQuery.d.ts +50 -0
- package/types/service/predefinedAdaptor/llm.adaptor.d.ts +105 -0
- package/types/service/predefinedAdaptor/queue.adaptor.d.ts +3 -2
- package/types/service/predefinedAdaptor/role.adaptor.d.ts +2 -0
- package/types/service/predefinedAdaptor/schedule.adaptor.d.ts +10 -6
- package/types/service/predefinedAdaptor/solidQueue.adaptor.d.ts +6 -2
- package/types/service/predefinedAdaptor/solidSqlite.d.ts +2 -2
- package/types/service/serve.d.ts +3 -3
- package/types/service/toolNames.d.ts +35 -0
- package/types/signal/agent/AgentCatalogue.d.ts +100 -0
- package/types/signal/agent/index.d.ts +1 -0
- package/types/signal/agent.d.ts +1 -0
- package/types/signal/agent.signal.d.ts +24 -0
- package/types/signal/agentTurn.d.ts +9 -0
- package/types/signal/agentTurnStream.d.ts +24 -0
- package/types/signal/base.signal.d.ts +1 -1
- package/types/signal/endpointInfo.d.ts +21 -3
- package/types/signal/guard.d.ts +12 -0
- package/types/signal/guards.d.ts +23 -1
- package/types/signal/index.d.ts +6 -0
- package/types/signal/intercept.d.ts +2 -2
- package/types/signal/internalArg.d.ts +22 -6
- package/types/signal/mcp/McpDocument.d.ts +84 -0
- package/types/signal/mcp/McpProgress.d.ts +40 -0
- package/types/signal/mcp/McpUriTemplate.d.ts +25 -0
- package/types/signal/mcp/Msg.d.ts +143 -0
- package/types/signal/mcp/index.d.ts +5 -0
- package/types/signal/mcp/mcpProtocol.d.ts +107 -0
- package/types/signal/mcp.d.ts +1 -0
- package/types/signal/middleware.d.ts +7 -7
- package/types/signal/openapi/openapi.d.ts +3 -3
- package/types/signal/schema/JsonSchemaBuilder.d.ts +51 -0
- package/types/signal/schema/index.d.ts +1 -0
- package/types/signal/schema.d.ts +1 -0
- package/types/signal/signalContext.d.ts +67 -8
- package/types/signal/slice.d.ts +42 -15
- package/types/signal/trace.d.ts +52 -2
- package/types/signal/types.d.ts +53 -4
- package/types/store/action.d.ts +7 -5
- package/types/store/actionTag.d.ts +21 -0
- package/types/store/agent/AgentBridge.d.ts +37 -0
- package/types/store/agent/AgentContext.d.ts +16 -0
- package/types/store/agent/AgentPrompts.d.ts +31 -0
- package/types/store/agent/ScreenReader.d.ts +29 -0
- package/types/store/agent/ScreenSettle.d.ts +22 -0
- package/types/store/agent/ScreenTarget.d.ts +34 -0
- package/types/store/agent/StoreCatalogue.d.ts +26 -0
- package/types/store/agent/StoreSurfaceSource.d.ts +30 -0
- package/types/store/agent/index.d.ts +11 -0
- package/types/store/agent/storeSurface.d.ts +14 -0
- package/types/store/agent/types.d.ts +15 -0
- package/types/store/agent.d.ts +1 -0
- package/types/store/agentic/AgentValue.d.ts +43 -0
- package/types/store/agentic/StExposeBuilder.d.ts +21 -0
- package/types/store/agentic/StExposeDraft.d.ts +13 -0
- package/types/store/agentic/StStateBuilder.d.ts +21 -0
- package/types/store/agentic/StStateDraft.d.ts +12 -0
- package/types/store/agentic/StToolBuilder.d.ts +56 -0
- package/types/store/agentic/StToolDraft.d.ts +13 -0
- package/types/store/agentic/attachAgentic.d.ts +25 -0
- package/types/store/agentic/formFields.d.ts +53 -0
- package/types/store/agentic/index.d.ts +12 -0
- package/types/store/agentic/useFieldTool.d.ts +22 -0
- package/types/store/agentic/useFormTools.d.ts +19 -0
- package/types/store/agentic/useRelationFieldTool.d.ts +27 -0
- package/types/store/agentic.d.ts +1 -0
- package/types/store/baseSt.d.ts +35 -39
- package/types/store/databaseStateNames.d.ts +25 -0
- package/types/store/formSetterNames.d.ts +30 -0
- package/types/store/index.d.ts +7 -0
- package/types/store/rootStore.d.ts +5 -1
- package/types/store/sliceRole.d.ts +25 -0
- package/types/store/store.d.ts +5 -1
- package/types/store/storeInstance.d.ts +33 -1
- package/types/store/storeRegistry.d.ts +5 -0
- package/types/store/types.d.ts +4 -0
- package/types/store/withSelector.d.ts +5 -4
- package/types/test/index.d.ts +1 -1
- package/types/test/registerDom.d.ts +1 -0
- package/types/test/signalTestRuntime.d.ts +2 -3
- package/types/test/testServer.d.ts +6 -4
- package/types/ui/Agent/Approval.d.ts +8 -0
- package/types/ui/Agent/Attach.d.ts +16 -0
- package/types/ui/Agent/Bubble.d.ts +26 -0
- package/types/ui/Agent/Chat.d.ts +91 -0
- package/types/ui/Agent/ChatCommands.d.ts +34 -0
- package/types/ui/Agent/Composer.d.ts +23 -0
- package/types/ui/Agent/Context.d.ts +13 -0
- package/types/ui/Agent/Dock.d.ts +17 -0
- package/types/ui/Agent/Guide.d.ts +9 -0
- package/types/ui/Agent/History.d.ts +26 -0
- package/types/ui/Agent/Launcher.d.ts +16 -0
- package/types/ui/Agent/Markdown.d.ts +19 -0
- package/types/ui/Agent/Menu.d.ts +18 -0
- package/types/ui/Agent/Mic.d.ts +8 -0
- package/types/ui/Agent/Question.d.ts +14 -0
- package/types/ui/Agent/Section.d.ts +10 -0
- package/types/ui/Agent/Skip.d.ts +22 -0
- package/types/ui/Agent/StateKey.d.ts +16 -0
- package/types/ui/Agent/Tool.d.ts +15 -0
- package/types/ui/Agent/Transcript.d.ts +13 -0
- package/types/ui/Agent/Zone.d.ts +48 -0
- package/types/ui/Agent/agentSessionOf.d.ts +27 -0
- package/types/ui/Agent/attachment.d.ts +34 -0
- package/types/ui/Agent/fetchRunner.d.ts +12 -0
- package/types/ui/Agent/index.d.ts +19 -0
- package/types/ui/Agent/index_.d.ts +1 -0
- package/types/ui/Agent/markdownBlocks.d.ts +35 -0
- package/types/ui/Agent/markdownSpans.d.ts +2 -0
- package/types/ui/Agent/markdownTable.d.ts +16 -0
- package/types/ui/Agent/sessionHistory.d.ts +14 -0
- package/types/ui/Agent/sessionView.d.ts +15 -0
- package/types/ui/Agent/tokenCount.d.ts +6 -0
- package/types/ui/Agent/useChatAttachments.d.ts +24 -0
- package/types/ui/Agent/useChatVoice.d.ts +30 -0
- package/types/ui/Agent/useDraftRecall.d.ts +14 -0
- package/types/ui/Agent/useKeyboardInset.d.ts +8 -0
- package/types/ui/Agent/useSlashMenu.d.ts +24 -0
- package/types/ui/Agent/voice.d.ts +71 -0
- package/types/ui/Agent.d.ts +1 -0
- package/types/ui/Badge.d.ts +1 -1
- package/types/ui/Button.d.ts +1 -1
- package/types/ui/Constant/Graph.d.ts +10 -0
- package/types/ui/Constant/index.d.ts +2 -1
- package/types/ui/Constant/schemaGraph.d.ts +39 -0
- package/types/ui/Data/Dashboard.d.ts +16 -3
- package/types/ui/Data/Insight.d.ts +1 -1
- package/types/ui/Data/ListContainer.d.ts +15 -7
- package/types/ui/Data/QueryMaker.d.ts +45 -3
- package/types/ui/Data/RefPicker.d.ts +16 -0
- package/types/ui/Data/dataExport.d.ts +5 -0
- package/types/ui/Data/dataText.d.ts +6 -0
- package/types/ui/Data/index.d.ts +2 -0
- package/types/ui/Data/index_.d.ts +1 -0
- package/types/ui/DatePicker.d.ts +15 -11
- package/types/ui/Dialog/LegacyModal.d.ts +13 -0
- package/types/ui/Dialog/Provider.d.ts +3 -1
- package/types/ui/Dialog/context.d.ts +9 -1
- package/types/ui/Dialog/index.d.ts +1 -0
- package/types/ui/DraggableList.d.ts +1 -1
- package/types/ui/Dropdown.d.ts +5 -1
- package/types/ui/Field.d.ts +13 -12
- package/types/ui/Layout/BottomTab.d.ts +3 -2
- package/types/ui/LegacyModal.d.ts +24 -0
- package/types/ui/Loading/ProgressBar.d.ts +4 -0
- package/types/ui/Loading/Spin.d.ts +2 -1
- package/types/ui/Model/AdminPanel.d.ts +15 -3
- package/types/ui/Model/EditModal.d.ts +1 -1
- package/types/ui/Model/New.d.ts +3 -1
- package/types/ui/Model/NewWrapper.d.ts +2 -0
- package/types/ui/Model/NewWrapper_Client.d.ts +2 -1
- package/types/ui/Pagination.d.ts +2 -2
- package/types/ui/Radio.d.ts +1 -1
- package/types/ui/RecentTime.d.ts +18 -1
- package/types/ui/Reference/Collapse.d.ts +11 -0
- package/types/ui/Reference/Panel.d.ts +29 -0
- package/types/ui/Reference/Segmented.d.ts +17 -0
- package/types/ui/Reference/Summary.d.ts +13 -0
- package/types/ui/Reference/Toolbar.d.ts +21 -0
- package/types/ui/Reference/dictText.d.ts +6 -0
- package/types/ui/Reference/index.d.ts +7 -0
- package/types/ui/Reference/style.d.ts +20 -0
- package/types/ui/Reference.d.ts +1 -0
- package/types/ui/ScreenNavigator.d.ts +3 -1
- package/types/ui/Signal/Arg.d.ts +7 -3
- package/types/ui/Signal/Doc.d.ts +4 -6
- package/types/ui/Signal/Object.d.ts +2 -1
- package/types/ui/Signal/RestApi.d.ts +2 -1
- package/types/ui/Signal/WebSocket.d.ts +2 -1
- package/types/ui/Signal/endpointEntries.d.ts +20 -0
- package/types/ui/Signal/style.d.ts +9 -8
- package/types/ui/System/Client.d.ts +1 -2
- package/types/ui/System/Common.d.ts +3 -4
- package/types/ui/System/Messages.d.ts +1 -1
- package/types/ui/Tab/Provider.d.ts +3 -1
- package/types/ui/Tab/context.d.ts +4 -2
- package/types/ui/ToggleSelect.d.ts +1 -0
- package/types/ui/UiOverride/context.d.ts +18 -1
- package/types/ui/agentAttrs.d.ts +14 -0
- package/types/ui/index.d.ts +22 -1
- package/types/ui/overlayLayer.d.ts +13 -0
- package/types/ui/overlayPosition.d.ts +28 -0
- package/types/ui/recipe/badgeRecipe.d.ts +2 -2
- package/types/ui/recipe/buttonRecipe.d.ts +2 -2
- package/types/vendor/use-agentic/AgentAbort.d.ts +17 -0
- package/types/vendor/use-agentic/AgentProgress.d.ts +27 -0
- package/types/vendor/use-agentic/AgentProvider.d.ts +17 -0
- package/types/vendor/use-agentic/AgentScope.d.ts +9 -0
- package/types/vendor/use-agentic/AgentSession.d.ts +163 -0
- package/types/vendor/use-agentic/Agentic.d.ts +21 -0
- package/types/vendor/use-agentic/AgenticSurface.d.ts +58 -0
- package/types/vendor/use-agentic/Compaction.d.ts +48 -0
- package/types/vendor/use-agentic/ToolOutput.d.ts +21 -0
- package/types/vendor/use-agentic/Transcript.d.ts +18 -0
- package/types/vendor/use-agentic/httpRunner.d.ts +15 -0
- package/types/vendor/use-agentic/index.d.ts +19 -0
- package/types/vendor/use-agentic/sharedContext.d.ts +15 -0
- package/types/vendor/use-agentic/surfaceContext.d.ts +5 -0
- package/types/vendor/use-agentic/types.d.ts +182 -0
- package/types/vendor/use-agentic/useAgent.d.ts +4 -0
- package/types/vendor/use-agentic/useAgentGuide.d.ts +6 -0
- package/types/vendor/use-agentic/useAgentResource.d.ts +12 -0
- package/types/vendor/use-agentic/useAgentState.d.ts +16 -0
- package/types/vendor/use-agentic/useAgentTool.d.ts +16 -0
- package/types/vendor/use-agentic.d.ts +1 -0
- package/types/webkit/index.d.ts +4 -0
- package/types/webkit/useBodyScrollLock.d.ts +2 -0
- package/types/webkit/usePageTool.d.ts +19 -0
- package/types/webkit/useScreenScope.d.ts +25 -0
- package/ui/Agent/Approval.tsx +32 -0
- package/ui/Agent/Attach.tsx +77 -0
- package/ui/Agent/Bubble.tsx +192 -0
- package/ui/Agent/Chat.tsx +525 -0
- package/ui/Agent/ChatCommands.ts +141 -0
- package/ui/Agent/Composer.tsx +94 -0
- package/ui/Agent/Context.tsx +49 -0
- package/ui/Agent/Dock.tsx +77 -0
- package/ui/Agent/Guide.tsx +16 -0
- package/ui/Agent/History.tsx +49 -0
- package/ui/Agent/Launcher.tsx +60 -0
- package/ui/Agent/Markdown.tsx +142 -0
- package/ui/Agent/Menu.tsx +55 -0
- package/ui/Agent/Mic.tsx +27 -0
- package/ui/Agent/Question.tsx +63 -0
- package/ui/Agent/Section.tsx +24 -0
- package/ui/Agent/Skip.tsx +30 -0
- package/ui/Agent/StateKey.tsx +46 -0
- package/ui/Agent/Tool.tsx +59 -0
- package/ui/Agent/Transcript.tsx +33 -0
- package/ui/Agent/Zone.tsx +116 -0
- package/ui/Agent/agentSessionOf.ts +60 -0
- package/ui/Agent/attachment.ts +73 -0
- package/ui/Agent/fetchRunner.ts +44 -0
- package/ui/Agent/index.ts +27 -0
- package/ui/Agent/index_.tsx +4 -0
- package/ui/Agent/markdownBlocks.ts +137 -0
- package/ui/Agent/markdownSpans.tsx +49 -0
- package/ui/Agent/markdownTable.ts +54 -0
- package/ui/Agent/sessionHistory.ts +62 -0
- package/ui/Agent/sessionView.ts +38 -0
- package/ui/Agent/tokenCount.ts +10 -0
- package/ui/Agent/useChatAttachments.ts +84 -0
- package/ui/Agent/useChatVoice.ts +129 -0
- package/ui/Agent/useDraftRecall.ts +42 -0
- package/ui/Agent/useKeyboardInset.ts +26 -0
- package/ui/Agent/useSlashMenu.ts +58 -0
- package/ui/Agent/voice.ts +177 -0
- package/ui/Badge.tsx +1 -1
- package/ui/BottomSheet.tsx +32 -36
- package/ui/Button.tsx +3 -1
- package/ui/Clipboard.tsx +3 -6
- package/ui/Constant/Doc.tsx +265 -254
- package/ui/Constant/Graph.tsx +151 -0
- package/ui/Constant/index.ts +3 -2
- package/ui/Constant/schemaGraph.ts +232 -0
- package/ui/Data/CardList.tsx +14 -3
- package/ui/Data/Dashboard.tsx +70 -52
- package/ui/Data/Insight.tsx +18 -12
- package/ui/Data/Item.tsx +42 -56
- package/ui/Data/ListContainer.tsx +246 -132
- package/ui/Data/Pagination.tsx +10 -3
- package/ui/Data/QueryMaker.tsx +160 -11
- package/ui/Data/RefPicker.tsx +202 -0
- package/ui/Data/TableList.tsx +22 -13
- package/ui/Data/dataExport.ts +54 -0
- package/ui/Data/dataText.ts +22 -0
- package/ui/Data/index.ts +13 -1
- package/ui/Data/index_.tsx +1 -0
- package/ui/DatePicker.tsx +110 -128
- package/ui/Dialog/Close.tsx +3 -7
- package/ui/Dialog/LegacyModal.tsx +241 -0
- package/ui/Dialog/Modal.tsx +62 -195
- package/ui/Dialog/Provider.tsx +47 -3
- package/ui/Dialog/Trigger.tsx +3 -7
- package/ui/Dialog/context.ts +14 -2
- package/ui/Dialog/index.tsx +2 -0
- package/ui/DragAction.tsx +3 -2
- package/ui/DraggableList.tsx +9 -4
- package/ui/Dropdown.tsx +89 -27
- package/ui/Empty.tsx +6 -4
- package/ui/Field.tsx +128 -58
- package/ui/Input.tsx +27 -5
- package/ui/KeyboardAvoiding.tsx +2 -2
- package/ui/Layout/BottomTab.tsx +32 -37
- package/ui/Layout/Sider.tsx +37 -14
- package/ui/LegacyModal.tsx +53 -0
- package/ui/Link/CsrLink.tsx +1 -1
- package/ui/Load/Pagination.tsx +15 -8
- package/ui/Load/Units.tsx +30 -7
- package/ui/Load/View.tsx +10 -3
- package/ui/Loading/Area.tsx +7 -6
- package/ui/Loading/Button.tsx +7 -9
- package/ui/Loading/Input.tsx +7 -9
- package/ui/Loading/ProgressBar.tsx +16 -7
- package/ui/Loading/Skeleton.tsx +8 -13
- package/ui/Loading/Spin.tsx +20 -14
- package/ui/Menu.tsx +1 -1
- package/ui/Model/AdminPanel.tsx +52 -12
- package/ui/Model/EditModal.tsx +28 -6
- package/ui/Model/EditWrapper.tsx +16 -4
- package/ui/Model/New.tsx +4 -0
- package/ui/Model/NewWrapper.tsx +2 -0
- package/ui/Model/NewWrapper_Client.tsx +20 -6
- package/ui/Model/Remove.tsx +18 -6
- package/ui/Model/RemoveWrapper.tsx +12 -2
- package/ui/Model/SureToRemove.tsx +18 -6
- package/ui/Model/ViewEditModal.tsx +64 -15
- package/ui/Model/ViewModal.tsx +25 -11
- package/ui/Model/ViewWrapper.tsx +15 -4
- package/ui/Model/index_.tsx +1 -1
- package/ui/Pagination.tsx +51 -66
- package/ui/Popconfirm.tsx +88 -78
- package/ui/Radio.tsx +53 -24
- package/ui/RecentTime.tsx +83 -35
- package/ui/Reference/Collapse.tsx +26 -0
- package/ui/Reference/Panel.tsx +79 -0
- package/ui/Reference/Segmented.tsx +41 -0
- package/ui/Reference/Summary.tsx +25 -0
- package/ui/Reference/Toolbar.tsx +44 -0
- package/ui/Reference/dictText.ts +9 -0
- package/ui/Reference/index.ts +7 -0
- package/ui/Reference/style.ts +45 -0
- package/ui/ScreenNavigator.tsx +17 -2
- package/ui/Select.tsx +96 -57
- package/ui/Signal/Arg.tsx +83 -68
- package/ui/Signal/Doc.tsx +163 -129
- package/ui/Signal/Listener.tsx +40 -29
- package/ui/Signal/Message.tsx +87 -135
- package/ui/Signal/Object.tsx +79 -57
- package/ui/Signal/PubSub.tsx +72 -113
- package/ui/Signal/Request.tsx +2 -22
- package/ui/Signal/Response.tsx +19 -45
- package/ui/Signal/RestApi.tsx +170 -200
- package/ui/Signal/WebSocket.tsx +29 -26
- package/ui/Signal/endpointEntries.ts +59 -0
- package/ui/Signal/makeExample.ts +10 -3
- package/ui/Signal/style.ts +34 -29
- package/ui/Switch.tsx +4 -0
- package/ui/System/CSR.tsx +1 -1
- package/ui/System/Client.tsx +31 -15
- package/ui/System/Common.tsx +3 -4
- package/ui/System/DevModeToggle.tsx +1 -1
- package/ui/System/Gtag.tsx +2 -2
- package/ui/System/Messages.tsx +52 -31
- package/ui/System/Reconnect.tsx +22 -56
- package/ui/System/SelectLanguage.tsx +24 -15
- package/ui/System/ThemeToggle.tsx +25 -13
- package/ui/Tab/Menu.tsx +24 -12
- package/ui/Tab/Menus.tsx +6 -3
- package/ui/Tab/Provider.tsx +30 -3
- package/ui/Tab/context.ts +8 -4
- package/ui/Table.tsx +66 -60
- package/ui/ToggleSelect.tsx +8 -7
- package/ui/Tooltip.tsx +15 -1
- package/ui/UiOverride/context.ts +21 -2
- package/ui/Unauthorized.tsx +6 -4
- package/ui/agentAttrs.ts +19 -0
- package/ui/index.ts +49 -1
- package/ui/overlayLayer.ts +12 -2
- package/ui/overlayPosition.ts +104 -0
- package/ui/recipe/buttonRecipe.ts +2 -2
- package/ui/styles.css +31 -0
- package/vendor/use-agentic/AgentAbort.ts +29 -0
- package/vendor/use-agentic/AgentProgress.ts +40 -0
- package/vendor/use-agentic/AgentProvider.tsx +39 -0
- package/vendor/use-agentic/AgentScope.tsx +20 -0
- package/vendor/use-agentic/AgentSession.ts +750 -0
- package/vendor/use-agentic/Agentic.tsx +44 -0
- package/vendor/use-agentic/AgenticSurface.ts +333 -0
- package/vendor/use-agentic/Compaction.ts +120 -0
- package/vendor/use-agentic/ToolOutput.ts +60 -0
- package/vendor/use-agentic/Transcript.ts +50 -0
- package/vendor/use-agentic/WIRE.md +86 -0
- package/vendor/use-agentic/httpRunner.ts +131 -0
- package/vendor/use-agentic/index.ts +20 -0
- package/vendor/use-agentic/sharedContext.ts +25 -0
- package/vendor/use-agentic/surfaceContext.ts +10 -0
- package/vendor/use-agentic/types.ts +192 -0
- package/vendor/use-agentic/useAgent.ts +18 -0
- package/vendor/use-agentic/useAgentGuide.ts +16 -0
- package/vendor/use-agentic/useAgentResource.ts +36 -0
- package/vendor/use-agentic/useAgentState.ts +64 -0
- package/vendor/use-agentic/useAgentTool.ts +55 -0
- package/webkit/bootCsr.tsx +10 -8
- package/webkit/index.ts +4 -0
- package/webkit/lazy.tsx +5 -1
- package/webkit/useBodyScrollLock.tsx +29 -0
- package/webkit/useFrameRuntime.ts +1 -1
- package/webkit/usePageTool.tsx +37 -0
- package/webkit/useScreenScope.tsx +60 -0
- package/types/ui/Constant/Mermaid.d.ts +0 -8
- package/types/ui/Signal/Collapse.d.ts +0 -12
- package/ui/Constant/Mermaid.tsx +0 -149
- package/ui/Signal/Collapse.tsx +0 -29
|
@@ -0,0 +1,525 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { cn, fetch, usePage } from "akanjs/client";
|
|
3
|
+
import type { PromptResult } from "akanjs/signal";
|
|
4
|
+
import { type AgentPrompt, AgentPrompts } from "akanjs/store";
|
|
5
|
+
import {
|
|
6
|
+
type KeyboardEvent as ReactKeyboardEvent,
|
|
7
|
+
type ReactNode,
|
|
8
|
+
useContext,
|
|
9
|
+
useEffect,
|
|
10
|
+
useMemo,
|
|
11
|
+
useRef,
|
|
12
|
+
useState,
|
|
13
|
+
useSyncExternalStore,
|
|
14
|
+
} from "react";
|
|
15
|
+
import { createPortal } from "react-dom";
|
|
16
|
+
import { AiOutlineClear, AiOutlineClose } from "react-icons/ai";
|
|
17
|
+
import {
|
|
18
|
+
type AgentRunner,
|
|
19
|
+
type AgentSession,
|
|
20
|
+
type AgentSessionOptions,
|
|
21
|
+
type CompactOptions,
|
|
22
|
+
SessionContext,
|
|
23
|
+
type SessionHistory,
|
|
24
|
+
} from "../../vendor/use-agentic";
|
|
25
|
+
import { createOverridable } from "../UiOverride";
|
|
26
|
+
import Approval from "./Approval";
|
|
27
|
+
import { agentSessionOf } from "./agentSessionOf";
|
|
28
|
+
import type { AttachReader } from "./attachment";
|
|
29
|
+
import Bubble from "./Bubble";
|
|
30
|
+
import { type ChatCommand, ChatCommands } from "./ChatCommands";
|
|
31
|
+
import { Composer } from "./Composer";
|
|
32
|
+
import { Launcher } from "./Launcher";
|
|
33
|
+
import Menu from "./Menu";
|
|
34
|
+
import Question from "./Question";
|
|
35
|
+
import type { PersistOption } from "./sessionHistory";
|
|
36
|
+
import type { BuiltinOption } from "./sessionView";
|
|
37
|
+
import { tokenCount } from "./tokenCount";
|
|
38
|
+
import { useChatAttachments } from "./useChatAttachments";
|
|
39
|
+
import { useChatVoice } from "./useChatVoice";
|
|
40
|
+
import { useDraftRecall } from "./useDraftRecall";
|
|
41
|
+
import { useKeyboardInset } from "./useKeyboardInset";
|
|
42
|
+
import { useSlashMenu } from "./useSlashMenu";
|
|
43
|
+
import type { VoiceEngine } from "./voice";
|
|
44
|
+
|
|
45
|
+
export interface ChatProps {
|
|
46
|
+
/** Reaches whichever surface is showing — the launcher while closed, the panel while open. */
|
|
47
|
+
className?: string;
|
|
48
|
+
title?: string;
|
|
49
|
+
/** App-global framing. Route-scoped guidance layers on it through mounted `Agent.Guide`s. */
|
|
50
|
+
instructions?: string;
|
|
51
|
+
/** Swap the transport; the default drives the app's `runAgentTurn` endpoint. */
|
|
52
|
+
runner?: AgentRunner;
|
|
53
|
+
maxTurns?: number;
|
|
54
|
+
/**
|
|
55
|
+
* When the conversation summarizes itself to stay inside the model's window — `at` estimated tokens, `keep`
|
|
56
|
+
* messages left verbatim below the summary. Tune it per provider; `{ at: 0 }` turns it off.
|
|
57
|
+
*/
|
|
58
|
+
compact?: CompactOptions;
|
|
59
|
+
/**
|
|
60
|
+
* Which of the runtime's own tools this chat's agent gets — all of them by default, `false` none, an array
|
|
61
|
+
* exactly the ones it names. A chat that must not leave the screen it is on drops `navigate` and `goBack`.
|
|
62
|
+
*/
|
|
63
|
+
builtins?: BuiltinOption;
|
|
64
|
+
/** Called after a compaction replaced messages with one summary — where a host syncs its own watermark. */
|
|
65
|
+
onCompact?: AgentSessionOptions["onCompact"];
|
|
66
|
+
defaultOpen?: boolean;
|
|
67
|
+
/**
|
|
68
|
+
* Controlled open state. Pass it with `onOpenChange` to drive the panel from the app's own control — a header
|
|
69
|
+
* button, a menu item — instead of the built-in launcher. Left off, the panel owns the state as before.
|
|
70
|
+
*/
|
|
71
|
+
open?: boolean;
|
|
72
|
+
/**
|
|
73
|
+
* Left off while `open` is controlled, the panel cannot close itself — so it draws **no close button** rather
|
|
74
|
+
* than an inert one. That is the shape of a fixed panel with nowhere to close to, and it is also what keeps a
|
|
75
|
+
* controlled chat assemblable by a server component, since this is the only prop here that is a function.
|
|
76
|
+
*/
|
|
77
|
+
onOpenChange?: (open: boolean) => void;
|
|
78
|
+
/** `false` draws no launcher, for an app that opens the panel from a control of its own. */
|
|
79
|
+
launcher?: boolean;
|
|
80
|
+
/**
|
|
81
|
+
* Keeps the transcript across reloads — sessionStorage by default, `{ storage: "local" }` to outlive the tab, or
|
|
82
|
+
* a `SessionHistory` of the app's own to keep it anywhere else, a server included.
|
|
83
|
+
*
|
|
84
|
+
* Ignored, like every session option above it, when an enclosing `Agent.Zone` or `AgentProvider` already holds a
|
|
85
|
+
* session: this chat then binds to that one, and the options belong to whoever built it.
|
|
86
|
+
*/
|
|
87
|
+
persist?: PersistOption | SessionHistory;
|
|
88
|
+
/** Renders in the page flow instead of floating above it — a zone chat that lives inside its own section. */
|
|
89
|
+
inline?: boolean;
|
|
90
|
+
/** `false` gives the browser its own Cmd/Ctrl+L back, for an app whose shell already spends that chord. */
|
|
91
|
+
shortcut?: boolean;
|
|
92
|
+
/** One surface each, where `className` reaches both. */
|
|
93
|
+
launcherClassName?: string;
|
|
94
|
+
panelClassName?: string;
|
|
95
|
+
/** Shown in place of the intro line while the transcript is empty — where starter questions go. */
|
|
96
|
+
intro?: ReactNode;
|
|
97
|
+
/** Extra header controls, left of the built-in clear and close buttons. */
|
|
98
|
+
header?: ReactNode;
|
|
99
|
+
/**
|
|
100
|
+
* `false` draws no header bar at all — for an `inline` chat inside a panel the app already titles. The extra
|
|
101
|
+
* `header` controls go with it, and the clear action stays reachable as the `/new` command.
|
|
102
|
+
*/
|
|
103
|
+
chrome?: boolean;
|
|
104
|
+
/** The composer's opening text, read once at mount — where a `?prompt=` lands without sending it. */
|
|
105
|
+
defaultDraft?: string;
|
|
106
|
+
/**
|
|
107
|
+
* Reads a file the user attached into an attachment, or answers `null` to leave it to the built-in reader
|
|
108
|
+
* (images as bytes, text as text). This is where an app puts what needs a parser — a PDF's text, a spreadsheet's
|
|
109
|
+
* cells — since the framework carries attachments but depends on nothing that can extract one. It runs before
|
|
110
|
+
* the built-in, so it can also replace how an image is prepared.
|
|
111
|
+
*/
|
|
112
|
+
attach?: AttachReader;
|
|
113
|
+
/**
|
|
114
|
+
* Speech in and out. The engine listens and speaks; this component decides when — a press-to-talk microphone
|
|
115
|
+
* whose transcript lands in the composer for the user to correct, and a reply read aloud **only when the ask
|
|
116
|
+
* itself came in by voice**, so a typed question never turns the speakers on.
|
|
117
|
+
*/
|
|
118
|
+
voice?: VoiceEngine;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
const isApplePlatform = () => {
|
|
122
|
+
const data = (navigator as Navigator & { userAgentData?: { platform?: string } }).userAgentData;
|
|
123
|
+
return /Mac|iPhone|iPad|iPod/i.test(data?.platform || navigator.platform || navigator.userAgent);
|
|
124
|
+
};
|
|
125
|
+
|
|
126
|
+
const launcherLayer = "fixed right-4 bottom-4 z-[150]";
|
|
127
|
+
|
|
128
|
+
const panelLayer = "fixed inset-0 z-[150] sm:inset-auto sm:right-4 sm:bottom-4";
|
|
129
|
+
const panelSize =
|
|
130
|
+
"h-dvh w-screen rounded-none sm:h-[min(600px,calc(100dvh-2rem))] sm:w-[min(24rem,calc(100vw-2rem))] sm:rounded-box";
|
|
131
|
+
|
|
132
|
+
/** Distance from the bottom within which the transcript keeps following new messages. */
|
|
133
|
+
const stickyEdge = 80;
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* The user-facing half of the in-page agent: one floating chat wired to the same surface the dock inspects.
|
|
137
|
+
* The conversation loop runs in this browser session — every tool call executes here, gated by the approval
|
|
138
|
+
* card — and the session lives in a ref, so it survives reopening the panel and dies with the page unless
|
|
139
|
+
* `persist` keeps it. An enclosing AgentProvider's session wins, which is how an app isolates a surface or swaps
|
|
140
|
+
* the loop while keeping this UI.
|
|
141
|
+
*/
|
|
142
|
+
export const DefaultChat = ({
|
|
143
|
+
className,
|
|
144
|
+
title,
|
|
145
|
+
instructions,
|
|
146
|
+
runner,
|
|
147
|
+
maxTurns,
|
|
148
|
+
compact,
|
|
149
|
+
builtins,
|
|
150
|
+
onCompact,
|
|
151
|
+
defaultOpen = false,
|
|
152
|
+
open: openProp,
|
|
153
|
+
onOpenChange,
|
|
154
|
+
launcher = true,
|
|
155
|
+
persist,
|
|
156
|
+
inline = false,
|
|
157
|
+
shortcut = true,
|
|
158
|
+
launcherClassName,
|
|
159
|
+
panelClassName,
|
|
160
|
+
intro,
|
|
161
|
+
header,
|
|
162
|
+
chrome = true,
|
|
163
|
+
defaultDraft,
|
|
164
|
+
attach,
|
|
165
|
+
voice,
|
|
166
|
+
}: ChatProps) => {
|
|
167
|
+
const { l } = usePage();
|
|
168
|
+
const provided = useContext(SessionContext);
|
|
169
|
+
|
|
170
|
+
const translate = useRef(l);
|
|
171
|
+
translate.current = l;
|
|
172
|
+
const held = useRef<AgentSession | null>(null);
|
|
173
|
+
held.current ??=
|
|
174
|
+
provided ??
|
|
175
|
+
agentSessionOf({
|
|
176
|
+
l: (key) => translate.current(key),
|
|
177
|
+
runner,
|
|
178
|
+
instructions,
|
|
179
|
+
maxTurns,
|
|
180
|
+
compact,
|
|
181
|
+
builtins,
|
|
182
|
+
persist,
|
|
183
|
+
onCompact,
|
|
184
|
+
});
|
|
185
|
+
const session = held.current;
|
|
186
|
+
const prompts = useRef<AgentPrompts | null>(null);
|
|
187
|
+
prompts.current ??= AgentPrompts.of();
|
|
188
|
+
const version = useSyncExternalStore(
|
|
189
|
+
session.subscribe,
|
|
190
|
+
() => session.version,
|
|
191
|
+
() => session.version,
|
|
192
|
+
);
|
|
193
|
+
const [ownOpen, setOwnOpen] = useState(defaultOpen);
|
|
194
|
+
|
|
195
|
+
const open = openProp ?? ownOpen;
|
|
196
|
+
const setOpen = (next: boolean) => {
|
|
197
|
+
if (openProp === undefined) setOwnOpen(next);
|
|
198
|
+
onOpenChange?.(next);
|
|
199
|
+
};
|
|
200
|
+
const [draft, setDraft] = useState(defaultDraft ?? "");
|
|
201
|
+
const files = useChatAttachments({ session, attach, l });
|
|
202
|
+
const speech = useChatVoice({
|
|
203
|
+
session,
|
|
204
|
+
engine: voice,
|
|
205
|
+
version,
|
|
206
|
+
onTranscript: setDraft,
|
|
207
|
+
onFailed: () => session.note(l("base.agentVoiceFailed")),
|
|
208
|
+
});
|
|
209
|
+
const recall = useDraftRecall(session.messages);
|
|
210
|
+
const [hotkey, setHotkey] = useState<{ label: string; keys: string } | null>(null);
|
|
211
|
+
const listRef = useRef<HTMLDivElement>(null);
|
|
212
|
+
const inputRef = useRef<HTMLTextAreaElement>(null);
|
|
213
|
+
const launcherRef = useRef<HTMLButtonElement>(null);
|
|
214
|
+
|
|
215
|
+
const sticky = useRef(true);
|
|
216
|
+
const returning = useRef(false);
|
|
217
|
+
const read = useRef(session.messages.length);
|
|
218
|
+
const keyboardInset = useKeyboardInset();
|
|
219
|
+
const [overlay, setOverlay] = useState<HTMLElement | null>(null);
|
|
220
|
+
useEffect(() => {
|
|
221
|
+
setOverlay(document.body);
|
|
222
|
+
}, []);
|
|
223
|
+
useEffect(() => {
|
|
224
|
+
if (open) read.current = session.messages.length;
|
|
225
|
+
if (sticky.current) listRef.current?.scrollTo({ top: listRef.current.scrollHeight });
|
|
226
|
+
}, [version, open]);
|
|
227
|
+
useEffect(() => {
|
|
228
|
+
if (!shortcut) return;
|
|
229
|
+
const apple = isApplePlatform();
|
|
230
|
+
setHotkey(apple ? { label: "⌘ L", keys: "Meta+L" } : { label: "Ctrl+L", keys: "Control+L" });
|
|
231
|
+
const onKeyDown = (event: KeyboardEvent) => {
|
|
232
|
+
if (event.repeat || event.key.toLowerCase() !== "l" || event.shiftKey || event.altKey) return;
|
|
233
|
+
const chord = apple ? event.metaKey && !event.ctrlKey : event.ctrlKey && !event.metaKey;
|
|
234
|
+
if (!chord) return;
|
|
235
|
+
event.preventDefault();
|
|
236
|
+
sticky.current = true;
|
|
237
|
+
setOpen(true);
|
|
238
|
+
inputRef.current?.focus();
|
|
239
|
+
};
|
|
240
|
+
|
|
241
|
+
window.addEventListener("keydown", onKeyDown, true);
|
|
242
|
+
return () => window.removeEventListener("keydown", onKeyDown, true);
|
|
243
|
+
}, [shortcut]);
|
|
244
|
+
useEffect(() => {
|
|
245
|
+
if (!open) {
|
|
246
|
+
|
|
247
|
+
if (returning.current) launcherRef.current?.focus();
|
|
248
|
+
returning.current = false;
|
|
249
|
+
return;
|
|
250
|
+
}
|
|
251
|
+
inputRef.current?.focus();
|
|
252
|
+
}, [open, session.pendingQuestion?.callId]);
|
|
253
|
+
useEffect(
|
|
254
|
+
() => () => {
|
|
255
|
+
|
|
256
|
+
if (!provided) session.abort();
|
|
257
|
+
},
|
|
258
|
+
[],
|
|
259
|
+
);
|
|
260
|
+
const runPrompt = async (prompt: AgentPrompt, args: string[]) => {
|
|
261
|
+
const usage = `/${prompt.name} ${prompt.args.map((arg) => `<${arg.name}>`).join(" ")}`.trim();
|
|
262
|
+
if (args.length < prompt.args.filter((arg) => arg.required).length) {
|
|
263
|
+
session.report(`Usage: ${usage}`);
|
|
264
|
+
return;
|
|
265
|
+
}
|
|
266
|
+
const handler = (fetch as unknown as Record<string, (...callArgs: unknown[]) => Promise<PromptResult>>)[
|
|
267
|
+
prompt.name
|
|
268
|
+
];
|
|
269
|
+
if (typeof handler !== "function") {
|
|
270
|
+
session.report(`/${prompt.name} is not mounted on this app.`);
|
|
271
|
+
return;
|
|
272
|
+
}
|
|
273
|
+
try {
|
|
274
|
+
const result = await handler(...args);
|
|
275
|
+
await session.send(AgentPrompts.messagesOf(result));
|
|
276
|
+
} catch (error) {
|
|
277
|
+
session.report(`/${prompt.name} failed: ${error instanceof Error ? error.message : String(error)}`);
|
|
278
|
+
}
|
|
279
|
+
};
|
|
280
|
+
const write = (text: string) => {
|
|
281
|
+
setDraft(text);
|
|
282
|
+
menu.reopen();
|
|
283
|
+
};
|
|
284
|
+
|
|
285
|
+
const closable = openProp === undefined || !!onOpenChange;
|
|
286
|
+
const dismiss = () => {
|
|
287
|
+
returning.current = true;
|
|
288
|
+
setOpen(false);
|
|
289
|
+
};
|
|
290
|
+
const runCommand = (command: ChatCommand) => {
|
|
291
|
+
write("");
|
|
292
|
+
recall.remember(`/${command.name}`);
|
|
293
|
+
|
|
294
|
+
if (command.name === "new") files.clear();
|
|
295
|
+
void ChatCommands.run(command, { session, l });
|
|
296
|
+
};
|
|
297
|
+
const pick = (prompt: AgentPrompt) => {
|
|
298
|
+
if (prompt.args.some((arg) => arg.required)) {
|
|
299
|
+
write(`/${prompt.name} `);
|
|
300
|
+
return;
|
|
301
|
+
}
|
|
302
|
+
if (session.isRunning) {
|
|
303
|
+
session.note(l("base.agentBusy"));
|
|
304
|
+
return;
|
|
305
|
+
}
|
|
306
|
+
write("");
|
|
307
|
+
recall.remember(`/${prompt.name}`);
|
|
308
|
+
void runPrompt(prompt, []);
|
|
309
|
+
};
|
|
310
|
+
const menu = useSlashMenu({ draft, prompts: prompts.current, l, onCommand: runCommand, onPrompt: pick });
|
|
311
|
+
const send = () => {
|
|
312
|
+
const text = draft.trim();
|
|
313
|
+
if (!text && !files.attached.length) return;
|
|
314
|
+
const command = AgentPrompts.parseCommand(text);
|
|
315
|
+
const builtin = command ? ChatCommands.find(command.name, l) : null;
|
|
316
|
+
|
|
317
|
+
if (builtin) {
|
|
318
|
+
runCommand(builtin);
|
|
319
|
+
return;
|
|
320
|
+
}
|
|
321
|
+
|
|
322
|
+
const question = session.pendingQuestion;
|
|
323
|
+
if (question) {
|
|
324
|
+
if (!text) {
|
|
325
|
+
session.note(l("base.agentAnswerNeeded"));
|
|
326
|
+
return;
|
|
327
|
+
}
|
|
328
|
+
write("");
|
|
329
|
+
speech.drop();
|
|
330
|
+
question.answer(question.multiple ? [text] : text);
|
|
331
|
+
return;
|
|
332
|
+
}
|
|
333
|
+
if (session.isRunning) return;
|
|
334
|
+
const prompt = command ? prompts.current?.find(command.name) : null;
|
|
335
|
+
write("");
|
|
336
|
+
if (text) recall.remember(text);
|
|
337
|
+
sticky.current = true;
|
|
338
|
+
speech.take();
|
|
339
|
+
if (command && prompt) {
|
|
340
|
+
void runPrompt(prompt, command.args);
|
|
341
|
+
return;
|
|
342
|
+
}
|
|
343
|
+
if (!files.attached.length) {
|
|
344
|
+
void session.send(text);
|
|
345
|
+
return;
|
|
346
|
+
}
|
|
347
|
+
const attachments = files.attached;
|
|
348
|
+
files.clear();
|
|
349
|
+
void session.send([{ role: "user", ...(text ? { text } : {}), attachments }]);
|
|
350
|
+
};
|
|
351
|
+
const onKeyDown = (event: ReactKeyboardEvent<HTMLTextAreaElement>) => {
|
|
352
|
+
const area = event.currentTarget;
|
|
353
|
+
|
|
354
|
+
const onEdgeLine = (up: boolean) =>
|
|
355
|
+
area.selectionStart === area.selectionEnd &&
|
|
356
|
+
!(up ? area.value.slice(0, area.selectionStart) : area.value.slice(area.selectionEnd)).includes("\n");
|
|
357
|
+
const row = menu.at();
|
|
358
|
+
if (row) {
|
|
359
|
+
|
|
360
|
+
if (event.key === "ArrowDown" || event.key === "ArrowUp") {
|
|
361
|
+
event.preventDefault();
|
|
362
|
+
menu.move(event.key === "ArrowDown" ? 1 : -1);
|
|
363
|
+
return;
|
|
364
|
+
}
|
|
365
|
+
if (event.key === "Tab") {
|
|
366
|
+
event.preventDefault();
|
|
367
|
+
write(`/${row.name} `);
|
|
368
|
+
return;
|
|
369
|
+
}
|
|
370
|
+
if (event.key === "Escape") {
|
|
371
|
+
event.preventDefault();
|
|
372
|
+
menu.hide();
|
|
373
|
+
return;
|
|
374
|
+
}
|
|
375
|
+
if (event.key === "Enter" && !event.shiftKey && !event.nativeEvent.isComposing) {
|
|
376
|
+
event.preventDefault();
|
|
377
|
+
row.pick();
|
|
378
|
+
return;
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
if (event.key === "Escape") {
|
|
382
|
+
event.preventDefault();
|
|
383
|
+
dismiss();
|
|
384
|
+
return;
|
|
385
|
+
}
|
|
386
|
+
const up = event.key === "ArrowUp";
|
|
387
|
+
if ((up || event.key === "ArrowDown") && recall.has && onEdgeLine(up)) {
|
|
388
|
+
event.preventDefault();
|
|
389
|
+
const walked = recall.step(up ? 1 : -1, draft);
|
|
390
|
+
if (walked !== null) setDraft(walked);
|
|
391
|
+
return;
|
|
392
|
+
}
|
|
393
|
+
if (event.key !== "Enter" || event.shiftKey || event.nativeEvent.isComposing) return;
|
|
394
|
+
event.preventDefault();
|
|
395
|
+
send();
|
|
396
|
+
};
|
|
397
|
+
|
|
398
|
+
const bubbles = useMemo(() => {
|
|
399
|
+
const resultOf = new Map(session.messages.flatMap((message) => message.toolResults ?? []).map((r) => [r.id, r]));
|
|
400
|
+
const claimed = new Set(session.messages.flatMap((message) => message.toolCalls?.map((call) => call.id) ?? []));
|
|
401
|
+
return session.messages.flatMap((message, idx) => {
|
|
402
|
+
if (message.role !== "tool")
|
|
403
|
+
return [<Bubble key={idx} message={message} progress={session.progress} results={resultOf} />];
|
|
404
|
+
const orphans = (message.toolResults ?? []).filter((result) => !claimed.has(result.id));
|
|
405
|
+
return orphans.length ? [<Bubble key={idx} message={{ ...message, toolResults: orphans }} />] : [];
|
|
406
|
+
});
|
|
407
|
+
}, [version]);
|
|
408
|
+
|
|
409
|
+
const tokens = useMemo(() => session.tokens, [version]);
|
|
410
|
+
const unread = open ? 0 : Math.max(0, session.messages.length - read.current);
|
|
411
|
+
const layer = (surface: ReactNode) => (inline ? surface : overlay ? createPortal(surface, overlay) : null);
|
|
412
|
+
if (!open)
|
|
413
|
+
return launcher
|
|
414
|
+
? layer(
|
|
415
|
+
<Launcher
|
|
416
|
+
className={cn(!inline && launcherLayer, className, launcherClassName)}
|
|
417
|
+
hotkey={hotkey}
|
|
418
|
+
label={l("base.agent")}
|
|
419
|
+
buttonRef={launcherRef}
|
|
420
|
+
onOpen={() => setOpen(true)}
|
|
421
|
+
unread={unread}
|
|
422
|
+
/>,
|
|
423
|
+
)
|
|
424
|
+
: null;
|
|
425
|
+
|
|
426
|
+
return layer(
|
|
427
|
+
<aside
|
|
428
|
+
aria-label={title ?? l("base.agent")}
|
|
429
|
+
data-agent-ui=""
|
|
430
|
+
className={cn(
|
|
431
|
+
"flex flex-col overflow-hidden border border-border bg-background",
|
|
432
|
+
inline ? "h-full w-full rounded-box" : [panelLayer, panelSize, "shadow-xl"],
|
|
433
|
+
files.dragging && "border-primary ring-2 ring-primary/40",
|
|
434
|
+
className,
|
|
435
|
+
panelClassName,
|
|
436
|
+
)}
|
|
437
|
+
role="dialog"
|
|
438
|
+
|
|
439
|
+
style={inline ? undefined : { paddingBottom: keyboardInset || undefined }}
|
|
440
|
+
{...files.dropProps}
|
|
441
|
+
>
|
|
442
|
+
{chrome ? (
|
|
443
|
+
<header className="flex items-center gap-2 border-foreground/5 border-b px-4 py-3">
|
|
444
|
+
<span className="font-semibold text-sm">{title ?? l("base.agent")}</span>
|
|
445
|
+
{session.isRunning ? <span className="size-2 animate-pulse rounded-full bg-primary" /> : null}
|
|
446
|
+
{tokens ? (
|
|
447
|
+
<span className="shrink-0 whitespace-nowrap text-[10px] text-foreground/40">
|
|
448
|
+
{l("base.agentTokens", { count: tokenCount(tokens) })}
|
|
449
|
+
</span>
|
|
450
|
+
) : null}
|
|
451
|
+
<span className="ml-auto flex items-center gap-2">
|
|
452
|
+
{header}
|
|
453
|
+
{session.messages.length ? (
|
|
454
|
+
<button
|
|
455
|
+
aria-label={l("base.agentClear")}
|
|
456
|
+
className="text-foreground/50 hover:text-foreground"
|
|
457
|
+
onClick={() => {
|
|
458
|
+
files.clear();
|
|
459
|
+
void session.reset();
|
|
460
|
+
}}
|
|
461
|
+
type="button"
|
|
462
|
+
>
|
|
463
|
+
<AiOutlineClear />
|
|
464
|
+
</button>
|
|
465
|
+
) : null}
|
|
466
|
+
{closable ? (
|
|
467
|
+
<button
|
|
468
|
+
aria-label={l("base.cancel")}
|
|
469
|
+
className="text-foreground/50 hover:text-foreground"
|
|
470
|
+
onClick={dismiss}
|
|
471
|
+
type="button"
|
|
472
|
+
>
|
|
473
|
+
<AiOutlineClose />
|
|
474
|
+
</button>
|
|
475
|
+
) : null}
|
|
476
|
+
</span>
|
|
477
|
+
</header>
|
|
478
|
+
) : null}
|
|
479
|
+
<div
|
|
480
|
+
aria-busy={session.isRunning}
|
|
481
|
+
aria-live="polite"
|
|
482
|
+
className="scrollbar-thin flex flex-1 flex-col gap-2 overflow-y-auto px-4 py-3"
|
|
483
|
+
onScroll={() => {
|
|
484
|
+
const list = listRef.current;
|
|
485
|
+
if (list) sticky.current = list.scrollHeight - list.scrollTop - list.clientHeight < stickyEdge;
|
|
486
|
+
}}
|
|
487
|
+
ref={listRef}
|
|
488
|
+
role="log"
|
|
489
|
+
>
|
|
490
|
+
{bubbles.length
|
|
491
|
+
? bubbles
|
|
492
|
+
: (intro ?? <p className="py-6 text-center text-foreground/40 text-sm">{l("base.agentIntro")}</p>)}
|
|
493
|
+
{session.isCompacting ? (
|
|
494
|
+
<p className="flex items-center gap-2 text-foreground/50 text-xs">
|
|
495
|
+
<span className="size-1.5 shrink-0 animate-pulse rounded-full bg-primary" />
|
|
496
|
+
{l("base.agentSummarizing")}
|
|
497
|
+
</p>
|
|
498
|
+
) : null}
|
|
499
|
+
</div>
|
|
500
|
+
{session.pendingApproval ? <Approval approval={session.pendingApproval} /> : null}
|
|
501
|
+
{session.pendingQuestion ? (
|
|
502
|
+
<Question key={session.pendingQuestion.callId} question={session.pendingQuestion} />
|
|
503
|
+
) : null}
|
|
504
|
+
<Menu onPick={(row) => row.pick()} rows={menu.rows} selected={menu.selected} />
|
|
505
|
+
<Composer
|
|
506
|
+
attached={files.attached}
|
|
507
|
+
draft={draft}
|
|
508
|
+
inputRef={inputRef}
|
|
509
|
+
{...(speech.canListen ? { mic: { listening: speech.listening, onToggle: speech.toggle } } : {})}
|
|
510
|
+
onDraft={write}
|
|
511
|
+
onFiles={(picked) => void files.add(picked)}
|
|
512
|
+
onKeyDown={onKeyDown}
|
|
513
|
+
onRemoveFile={files.remove}
|
|
514
|
+
onSend={send}
|
|
515
|
+
onStop={() => {
|
|
516
|
+
speech.silence();
|
|
517
|
+
session.abort();
|
|
518
|
+
}}
|
|
519
|
+
session={session}
|
|
520
|
+
/>
|
|
521
|
+
</aside>,
|
|
522
|
+
);
|
|
523
|
+
};
|
|
524
|
+
|
|
525
|
+
export default createOverridable("AgentChat", DefaultChat);
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
import { AgentSession, type ChatMessage } from "../../vendor/use-agentic";
|
|
2
|
+
|
|
3
|
+
export interface ChatCommandContext {
|
|
4
|
+
session: AgentSession;
|
|
5
|
+
l: (key: string) => string;
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
export interface ChatCommand {
|
|
9
|
+
name: string;
|
|
10
|
+
/** Accepted but not listed: one row per command, so the menu names each thing once. */
|
|
11
|
+
aliases?: string[];
|
|
12
|
+
description: string;
|
|
13
|
+
run: (context: ChatCommandContext) => void | Promise<void>;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* The chat's own slash commands, the client-side peer of `AgentPrompts`. They join the same `/` menu a prompt
|
|
18
|
+
* endpoint appears in and are dispatched ahead of one: a built-in wins a name collision because the user typed it,
|
|
19
|
+
* and no library's prompt may take `/new` away from them — the mirror image of the tool rule, where a component's
|
|
20
|
+
* own `st.tool` shadows a built-in it means to replace.
|
|
21
|
+
*
|
|
22
|
+
* Output goes through `session.note`, never `send`: a command is answered by this browser, so its text belongs in
|
|
23
|
+
* the transcript the user reads and nowhere in the history the model reads.
|
|
24
|
+
*/
|
|
25
|
+
export class ChatCommands {
|
|
26
|
+
static list(l: (key: string) => string): ChatCommand[] {
|
|
27
|
+
return [
|
|
28
|
+
{
|
|
29
|
+
name: "new",
|
|
30
|
+
aliases: ["clear"],
|
|
31
|
+
description: l("base.agentCmdNew"),
|
|
32
|
+
run: async ({ session }) => {
|
|
33
|
+
await session.reset();
|
|
34
|
+
},
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
name: "retry",
|
|
38
|
+
description: l("base.agentCmdRetry"),
|
|
39
|
+
run: async ({ session, l: t }) => {
|
|
40
|
+
|
|
41
|
+
if (session.isRunning) session.note(t("base.agentBusy"));
|
|
42
|
+
else if (!(await session.retry())) session.note(t("base.agentNothingToRetry"));
|
|
43
|
+
},
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
name: "compact",
|
|
47
|
+
description: l("base.agentCmdCompact"),
|
|
48
|
+
run: async ({ session, l: t }) => {
|
|
49
|
+
if (session.isRunning) session.note(t("base.agentBusy"));
|
|
50
|
+
else if (await session.compact()) session.note(t("base.agentCompacted"));
|
|
51
|
+
else session.note(t("base.agentNothingToCompact"));
|
|
52
|
+
},
|
|
53
|
+
},
|
|
54
|
+
{ name: "copy", description: l("base.agentCmdCopy"), run: (context) => ChatCommands.#copy(context) },
|
|
55
|
+
{ name: "help", description: l("base.agentCmdHelp"), run: (context) => ChatCommands.#help(context) },
|
|
56
|
+
{ name: "tools", description: l("base.agentCmdTools"), run: (context) => ChatCommands.#tools(context) },
|
|
57
|
+
];
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
static find(name: string, l: (key: string) => string): ChatCommand | null {
|
|
61
|
+
return ChatCommands.list(l).find((command) => command.name === name || command.aliases?.includes(name)) ?? null;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/** A command is user-typed, so a failure inside one lands in the transcript instead of at the page. */
|
|
65
|
+
static async run(command: ChatCommand, context: ChatCommandContext) {
|
|
66
|
+
try {
|
|
67
|
+
await command.run(context);
|
|
68
|
+
} catch (error) {
|
|
69
|
+
context.session.report(error instanceof Error ? error.message : String(error));
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* The conversation as markdown. The relay is stateless and the transcript lives only in this browser, so an
|
|
75
|
+
* export is the only way a wrong answer can reach whoever could fix it — which is why the header carries where
|
|
76
|
+
* and when it happened. Local notes are left out: they are this chat talking to itself.
|
|
77
|
+
*/
|
|
78
|
+
static transcriptOf(messages: readonly ChatMessage[], where = ""): string {
|
|
79
|
+
const lines = [`# Agent conversation`, [where, new Date().toISOString()].filter(Boolean).join(" · "), ""];
|
|
80
|
+
for (const message of messages) {
|
|
81
|
+
if (message.local) continue;
|
|
82
|
+
|
|
83
|
+
lines.push(`**${message.summary ? "summary" : message.role}**`);
|
|
84
|
+
if (message.text) lines.push(message.text);
|
|
85
|
+
for (const attachment of message.attachments ?? [])
|
|
86
|
+
lines.push(`- attached \`${attachment.name}\` (${attachment.mimeType})`);
|
|
87
|
+
for (const call of message.toolCalls ?? []) lines.push(`- call \`${call.name}\` ${JSON.stringify(call.args)}`);
|
|
88
|
+
for (const result of message.toolResults ?? [])
|
|
89
|
+
lines.push(
|
|
90
|
+
`- ${result.error ? "error" : "result"} \`${result.name}\` ${result.error ?? JSON.stringify(result.result ?? null)}`,
|
|
91
|
+
);
|
|
92
|
+
if (message.error) lines.push(`- failed: ${message.error}`);
|
|
93
|
+
lines.push("");
|
|
94
|
+
}
|
|
95
|
+
return lines.join("\n").trim();
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
static async #copy({ session, l }: ChatCommandContext) {
|
|
99
|
+
const where = typeof location === "undefined" ? "" : location.href;
|
|
100
|
+
try {
|
|
101
|
+
await navigator.clipboard.writeText(ChatCommands.transcriptOf(session.messages, where));
|
|
102
|
+
session.note(l("base.agentCopied"));
|
|
103
|
+
} catch {
|
|
104
|
+
|
|
105
|
+
session.note(l("base.agentCopyFailed"));
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
static #help({ session, l }: ChatCommandContext) {
|
|
110
|
+
const rows = ChatCommands.list(l).map((command) => `- \`/${command.name}\` — ${command.description}`);
|
|
111
|
+
session.note([l("base.agentHelpIntro"), ...rows, "", l("base.agentHelpNote")].join("\n"));
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* What this screen published, read off the session's own surface — a zone chat therefore lists its zone's view.
|
|
116
|
+
* `askUser` is the session's rather than the surface's, so it is added here the same way the turn adds it.
|
|
117
|
+
*/
|
|
118
|
+
static #tools({ session, l }: ChatCommandContext) {
|
|
119
|
+
const { tools, resources } = session.surface.snapshot();
|
|
120
|
+
const published = tools.some((tool) => tool.name === AgentSession.askUserTool.name)
|
|
121
|
+
? [...tools]
|
|
122
|
+
: [...tools, AgentSession.askUserTool];
|
|
123
|
+
const rows = published
|
|
124
|
+
.sort((a, b) => (a.name < b.name ? -1 : 1))
|
|
125
|
+
.map((tool) => `- \`${tool.name}\`${tool.description ? ` — ${ChatCommands.#sentence(tool.description)}` : ""}`);
|
|
126
|
+
const keys = resources.map((resource) => `\`${resource.name}\``).sort((a, b) => (a < b ? -1 : 1));
|
|
127
|
+
session.note(
|
|
128
|
+
[
|
|
129
|
+
l("base.agentToolsHead"),
|
|
130
|
+
...rows,
|
|
131
|
+
...(keys.length ? ["", l("base.agentToolsState"), keys.join(", ")] : []),
|
|
132
|
+
].join("\n"),
|
|
133
|
+
);
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/** A tool description is written for a model and runs long; the menu row wants its first sentence. */
|
|
137
|
+
static #sentence(text: string) {
|
|
138
|
+
const first = text.split(/(?<=[.!?])\s/)[0].trim();
|
|
139
|
+
return first.length > 120 ? `${first.slice(0, 117)}...` : first;
|
|
140
|
+
}
|
|
141
|
+
}
|