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
package/signal/slice.ts
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import { Any, type Assign, type
|
|
1
|
+
import { Any, type Assign, type MergeAllKeyOfObjects, SLICE_DICT_SHAPE, SLICE_META } from "akanjs/base";
|
|
2
2
|
import { applyMixins } from "akanjs/common";
|
|
3
|
-
import type
|
|
4
|
-
import type { FilterInstance } from "akanjs/document";
|
|
3
|
+
import { type FilterInstance, FilterQueryError, resolveFilterQuery } from "akanjs/document";
|
|
5
4
|
import { type Adaptor, type AdaptorCls, dangerouslyAdapt, type ServiceModel } from "akanjs/service";
|
|
6
|
-
import
|
|
5
|
+
import { Exception } from "./exception";
|
|
6
|
+
import type { GuardCls } from "./guard";
|
|
7
7
|
import {
|
|
8
8
|
buildSlice,
|
|
9
9
|
type SliceBuilder,
|
|
@@ -38,21 +38,42 @@ export type SliceCls<
|
|
|
38
38
|
createGuards: GuardCls[];
|
|
39
39
|
updateGuards: GuardCls[];
|
|
40
40
|
removeGuards: GuardCls[];
|
|
41
|
+
mcp: ResolvedSliceMcp;
|
|
41
42
|
};
|
|
42
43
|
|
|
44
|
+
/** The generated verbs, resolved to a plain answer each. `root` is not here: it rides on the root slice itself. */
|
|
45
|
+
export interface ResolvedSliceMcp {
|
|
46
|
+
get: boolean;
|
|
47
|
+
create: boolean;
|
|
48
|
+
update: boolean;
|
|
49
|
+
remove: boolean;
|
|
50
|
+
}
|
|
51
|
+
|
|
43
52
|
interface RootSliceOption {
|
|
44
53
|
guards?: {
|
|
45
|
-
root?:
|
|
46
|
-
get?:
|
|
47
|
-
cru?:
|
|
48
|
-
create?:
|
|
49
|
-
update?:
|
|
50
|
-
remove?:
|
|
54
|
+
root?: GuardCls | GuardCls[];
|
|
55
|
+
get?: GuardCls | GuardCls[];
|
|
56
|
+
cru?: GuardCls | GuardCls[];
|
|
57
|
+
create?: GuardCls | GuardCls[];
|
|
58
|
+
update?: GuardCls | GuardCls[];
|
|
59
|
+
remove?: GuardCls | GuardCls[];
|
|
51
60
|
};
|
|
61
|
+
/**
|
|
62
|
+
* Which of the entries this call generates belong on an agent's shelf. Keyed exactly like `guards` above and
|
|
63
|
+
* scoped to exactly what `guards` governs — the root slice and the generated CRUD — so `false` here narrows the
|
|
64
|
+
* catalogue and nothing else. `create`/`update`/`remove` fall back to `cru` the same way their guards do, and
|
|
65
|
+
* the bare `false` is every key at once.
|
|
66
|
+
*
|
|
67
|
+
* A named slice and a custom endpoint declare their own `mcp` in their own signal option, exactly as they
|
|
68
|
+
* declare their own guards. This is curation, not authorization: HTTP is unchanged.
|
|
69
|
+
*/
|
|
70
|
+
mcp?:
|
|
71
|
+
| boolean
|
|
72
|
+
| { root?: boolean; get?: boolean; cru?: boolean; create?: boolean; update?: boolean; remove?: boolean };
|
|
52
73
|
prefix?: string;
|
|
53
74
|
}
|
|
54
75
|
|
|
55
|
-
type
|
|
76
|
+
type RootSliceQueryKey<Filter extends FilterInstance> = Extract<keyof Filter["query"], string>;
|
|
56
77
|
|
|
57
78
|
type ExtendSliceInfoObj<
|
|
58
79
|
SrvModule extends ServiceModel,
|
|
@@ -91,7 +112,7 @@ export function slice<
|
|
|
91
112
|
_Light = CnstLight<SrvModule>,
|
|
92
113
|
_Insight = CnstInsight<SrvModule>,
|
|
93
114
|
_Filter extends FilterInstance = DbFilter<SrvModule>,
|
|
94
|
-
|
|
115
|
+
_QueryKey extends string = RootSliceQueryKey<_Filter>,
|
|
95
116
|
>(
|
|
96
117
|
srv: SrvModule,
|
|
97
118
|
option: RootSliceOption,
|
|
@@ -111,25 +132,19 @@ export function slice<
|
|
|
111
132
|
_Insight,
|
|
112
133
|
_Filter,
|
|
113
134
|
SrvMap<SrvModule>,
|
|
114
|
-
["
|
|
115
|
-
[
|
|
135
|
+
["queryKey", "args"],
|
|
136
|
+
[queryKey?: _QueryKey | null, args?: unknown[] | null],
|
|
116
137
|
[],
|
|
117
|
-
[
|
|
138
|
+
[_QueryKey | undefined, unknown[] | undefined]
|
|
118
139
|
>;
|
|
119
140
|
}
|
|
120
141
|
: ExtendSliceInfoObj<SrvModule, LibSlices>
|
|
121
142
|
>
|
|
122
143
|
> {
|
|
123
144
|
if (!srv.cnst || !srv.db) throw new Error("cnst and db are required");
|
|
124
|
-
const
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
srv.cnst.full,
|
|
128
|
-
srv.cnst.light,
|
|
129
|
-
srv.cnst.insight,
|
|
130
|
-
srv.db.filter,
|
|
131
|
-
);
|
|
132
|
-
const toGuards = (guard?: Cls<Guard> | Cls<Guard>[]) => (guard ? (Array.isArray(guard) ? guard : [guard]) : []);
|
|
145
|
+
const filterRef = srv.db.filter;
|
|
146
|
+
const init = buildSlice(srv.srv.refName, srv.cnst.input, srv.cnst.full, srv.cnst.light, srv.cnst.insight, filterRef);
|
|
147
|
+
const toGuards = (guard?: GuardCls | GuardCls[]) => (guard ? (Array.isArray(guard) ? guard : [guard]) : []);
|
|
133
148
|
const rootGuards = toGuards(option.guards?.root);
|
|
134
149
|
const getGuards = toGuards(option.guards?.get);
|
|
135
150
|
const cruGuards = toGuards(option.guards?.cru);
|
|
@@ -137,6 +152,15 @@ export function slice<
|
|
|
137
152
|
const createGuards = option.guards?.create ? toGuards(option.guards.create) : cruGuards;
|
|
138
153
|
const updateGuards = option.guards?.update ? toGuards(option.guards.update) : cruGuards;
|
|
139
154
|
const removeGuards = option.guards?.remove ? toGuards(option.guards.remove) : cruGuards;
|
|
155
|
+
const mcpOption =
|
|
156
|
+
typeof option.mcp === "boolean" ? { root: option.mcp, get: option.mcp, cru: option.mcp } : option.mcp;
|
|
157
|
+
const cruMcp = mcpOption?.cru !== false;
|
|
158
|
+
const mcp: ResolvedSliceMcp = {
|
|
159
|
+
get: mcpOption?.get !== false,
|
|
160
|
+
create: mcpOption?.create ?? cruMcp,
|
|
161
|
+
update: mcpOption?.update ?? cruMcp,
|
|
162
|
+
remove: mcpOption?.remove ?? cruMcp,
|
|
163
|
+
};
|
|
140
164
|
const srvKeys = [
|
|
141
165
|
...new Set([...Object.keys(srv.srvMap), ...libSlices.flatMap((libSlice) => Object.keys(libSlice.srv.srvMap))]),
|
|
142
166
|
];
|
|
@@ -150,11 +174,22 @@ export function slice<
|
|
|
150
174
|
static createGuards = createGuards;
|
|
151
175
|
static updateGuards = updateGuards;
|
|
152
176
|
static removeGuards = removeGuards;
|
|
177
|
+
static mcp = mcp;
|
|
153
178
|
static [SLICE_META] = Object.assign(
|
|
154
179
|
{
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
.
|
|
180
|
+
|
|
181
|
+
[""]: init({ guards: rootGuards, ...(mcpOption?.root === false ? { mcp: false } : {}) })
|
|
182
|
+
.search<"queryKey", string>("queryKey", String)
|
|
183
|
+
.search<"args", unknown[]>("args", Any)
|
|
184
|
+
.exec((queryKey, args) => {
|
|
185
|
+
try {
|
|
186
|
+
return resolveFilterQuery(filterRef, queryKey, args);
|
|
187
|
+
} catch (error) {
|
|
188
|
+
|
|
189
|
+
if (error instanceof FilterQueryError) throw new Exception.BadRequest(error.message);
|
|
190
|
+
throw error;
|
|
191
|
+
}
|
|
192
|
+
}),
|
|
158
193
|
},
|
|
159
194
|
sliceBuilder(init as Parameters<BuildSlice>[0]),
|
|
160
195
|
);
|
package/signal/trace.ts
CHANGED
|
@@ -1,17 +1,31 @@
|
|
|
1
1
|
import { AsyncLocalStorage } from "node:async_hooks";
|
|
2
|
+
import { timingSafeEqual } from "node:crypto";
|
|
3
|
+
import {
|
|
4
|
+
type LogAttrs,
|
|
5
|
+
type LogFlightRecorder,
|
|
6
|
+
Logger,
|
|
7
|
+
type LogRecord,
|
|
8
|
+
logSeverity,
|
|
9
|
+
registerLogContextReader,
|
|
10
|
+
} from "akanjs/common";
|
|
2
11
|
|
|
3
12
|
/**
|
|
4
|
-
*
|
|
13
|
+
* Request tracing for Akan signals, in two modes.
|
|
5
14
|
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
15
|
+
* `context` is on by default, production included: it carries only the identity a log record needs
|
|
16
|
+
* (`traceId`, endpoint, origin) and costs one `als.run` per call (~25ns measured). `AKAN_LOG_CONTEXT=0` is
|
|
17
|
+
* the emergency exit. `full` adds the per-stage spans, query counts and cache ratio the metrics endpoint
|
|
18
|
+
* aggregates, and stays behind `AKAN_TRACE=1` because those are for performance work, not for every request.
|
|
19
|
+
*
|
|
20
|
+
* Two opt-ins ride the same trace: the canonical request line (`AKAN_LOG_CANONICAL`) summarizes every call as
|
|
21
|
+
* one record at its end, and the flight recorder (`AKAN_LOG_FLIGHT`) keeps the call's own sub-level records
|
|
22
|
+
* and promotes them only when the call failed or ran long.
|
|
10
23
|
*/
|
|
11
24
|
|
|
12
25
|
let traceEnabledCache: boolean | null = null;
|
|
26
|
+
let logContextEnabledCache: boolean | null = null;
|
|
13
27
|
|
|
14
|
-
/** Whether request tracing is enabled. Cached after first read. */
|
|
28
|
+
/** Whether full request tracing (`AKAN_TRACE=1`) is enabled. Cached after first read. */
|
|
15
29
|
export const isTraceEnabled = (): boolean => {
|
|
16
30
|
if (traceEnabledCache === null) traceEnabledCache = process.env.AKAN_TRACE === "1";
|
|
17
31
|
return traceEnabledCache;
|
|
@@ -22,63 +36,277 @@ export const setTraceEnabled = (enabled: boolean): void => {
|
|
|
22
36
|
traceEnabledCache = enabled;
|
|
23
37
|
};
|
|
24
38
|
|
|
39
|
+
export const isLogContextEnabled = (): boolean => {
|
|
40
|
+
if (logContextEnabledCache === null)
|
|
41
|
+
logContextEnabledCache = !(process.env.AKAN_LOG_CONTEXT === "0" || process.env.AKAN_LOG_CONTEXT === "false");
|
|
42
|
+
return logContextEnabledCache;
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
export const setLogContextEnabled = (enabled: boolean): void => {
|
|
46
|
+
logContextEnabledCache = enabled;
|
|
47
|
+
};
|
|
48
|
+
|
|
49
|
+
export type CanonicalLineMode = "off" | "all" | "slow";
|
|
50
|
+
|
|
51
|
+
const isOn = (value: string | undefined) => value === "1" || value === "true";
|
|
52
|
+
|
|
53
|
+
let canonicalModeCache: CanonicalLineMode | null = null;
|
|
54
|
+
/** `AKAN_LOG_CANONICAL`: `1`/`all` writes one line per call, `slow` only for a failed or over-threshold call. */
|
|
55
|
+
export const getCanonicalLineMode = (): CanonicalLineMode => {
|
|
56
|
+
if (canonicalModeCache === null) {
|
|
57
|
+
const value = process.env.AKAN_LOG_CANONICAL;
|
|
58
|
+
canonicalModeCache = value === "slow" ? "slow" : isOn(value) || value === "all" ? "all" : "off";
|
|
59
|
+
}
|
|
60
|
+
return canonicalModeCache;
|
|
61
|
+
};
|
|
62
|
+
export const setCanonicalLineMode = (mode: CanonicalLineMode): void => {
|
|
63
|
+
canonicalModeCache = mode;
|
|
64
|
+
};
|
|
65
|
+
|
|
66
|
+
let flightEnabledCache: boolean | null = null;
|
|
67
|
+
export const isFlightRecorderEnabled = (): boolean => {
|
|
68
|
+
if (flightEnabledCache === null) flightEnabledCache = isOn(process.env.AKAN_LOG_FLIGHT);
|
|
69
|
+
return flightEnabledCache;
|
|
70
|
+
};
|
|
71
|
+
export const setFlightRecorderEnabled = (enabled: boolean): void => {
|
|
72
|
+
flightEnabledCache = enabled;
|
|
73
|
+
refreshLoggerContextGate();
|
|
74
|
+
};
|
|
75
|
+
|
|
76
|
+
let flightThresholdCache: number | null = null;
|
|
77
|
+
/** `AKAN_LOG_FLIGHT_MS`: a call at least this long is "slow" for both the recorder and the `slow` canonical mode. */
|
|
78
|
+
export const getFlightThresholdMs = (): number => {
|
|
79
|
+
if (flightThresholdCache === null) {
|
|
80
|
+
const value = Number(process.env.AKAN_LOG_FLIGHT_MS);
|
|
81
|
+
flightThresholdCache = Number.isFinite(value) && value > 0 ? value : 1_000;
|
|
82
|
+
}
|
|
83
|
+
return flightThresholdCache;
|
|
84
|
+
};
|
|
85
|
+
export const setFlightThresholdMs = (ms: number): void => {
|
|
86
|
+
flightThresholdCache = ms;
|
|
87
|
+
};
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* `x-akan-debug` lowers one request's log floor to `trace`. Honoured in `local` unconditionally, and elsewhere only
|
|
91
|
+
* when the header carries the value of `AKAN_LOG_DEBUG_HEADER`: a client that can lower a server's log level is a
|
|
92
|
+
* log-volume vector, so outside development it has to prove it was told the secret.
|
|
93
|
+
*/
|
|
94
|
+
export const isDebugHeaderAllowed = (): boolean =>
|
|
95
|
+
process.env.AKAN_PUBLIC_ENV === "local" || !!process.env.AKAN_LOG_DEBUG_HEADER;
|
|
96
|
+
|
|
97
|
+
const refreshLoggerContextGate = () => {
|
|
98
|
+
Logger.contextGate = isFlightRecorderEnabled() || isDebugHeaderAllowed();
|
|
99
|
+
};
|
|
100
|
+
|
|
25
101
|
export interface SpanRecord {
|
|
26
102
|
name: string;
|
|
27
103
|
durationMs: number;
|
|
28
104
|
}
|
|
29
105
|
|
|
106
|
+
export type TraceMode = "context" | "full";
|
|
107
|
+
export type TraceOrigin = "http" | "websocket" | "mcp" | "internal" | "page";
|
|
108
|
+
export type TraceOutcome = "ok" | "error";
|
|
109
|
+
|
|
30
110
|
const MAX_SPANS_PER_TRACE = 64;
|
|
111
|
+
/** Per call; 64 lines is a whole request at `trace` for anything short of a loop that logs per row. */
|
|
112
|
+
const FLIGHT_RING_SIZE = 64;
|
|
113
|
+
const CANONICAL_ERROR_CHARS = 200;
|
|
114
|
+
|
|
115
|
+
interface FlightEntry {
|
|
116
|
+
record: LogRecord;
|
|
117
|
+
written: boolean;
|
|
118
|
+
}
|
|
31
119
|
|
|
32
120
|
/** Per-request trace context. Threaded via {@link AsyncLocalStorage}. */
|
|
33
121
|
export class SignalTrace {
|
|
122
|
+
/** Total captured records the process holds at once (`AKAN_LOG_FLIGHT_MAX`); a call past it runs unrecorded. */
|
|
123
|
+
static readonly defaultFlightMaxRecords = 65_536;
|
|
124
|
+
static #activeFlights = 0;
|
|
125
|
+
static #flightMaxTraces: number | null = null;
|
|
126
|
+
|
|
34
127
|
readonly traceId: string;
|
|
35
128
|
readonly endpointKey: string;
|
|
36
129
|
readonly endpointType: string;
|
|
130
|
+
readonly origin: TraceOrigin;
|
|
131
|
+
readonly mode: TraceMode;
|
|
37
132
|
readonly startedAt: number;
|
|
38
133
|
readonly spans: SpanRecord[] = [];
|
|
134
|
+
/** What the canonical line carries beyond timing — `userId` once the caller is known. */
|
|
135
|
+
readonly attrs: LogAttrs = {};
|
|
39
136
|
dbQueryCount = 0;
|
|
40
137
|
dbQueryMs = 0;
|
|
41
138
|
cacheHits = 0;
|
|
42
139
|
cacheMisses = 0;
|
|
43
140
|
dataLoaderBatchCount = 0;
|
|
44
141
|
dataLoaderKeyCount = 0;
|
|
142
|
+
outcome: TraceOutcome | null = null;
|
|
143
|
+
status: number | null = null;
|
|
144
|
+
error: unknown = null;
|
|
145
|
+
debugSev: number | null = null;
|
|
146
|
+
flight: LogFlightRecorder | null = null;
|
|
147
|
+
#flightRing: FlightEntry[] | null = null;
|
|
148
|
+
#flightEvicted = 0;
|
|
45
149
|
#finalized = false;
|
|
46
150
|
|
|
47
|
-
constructor(
|
|
151
|
+
constructor(
|
|
152
|
+
endpointKey: string,
|
|
153
|
+
endpointType: string,
|
|
154
|
+
{ mode = "full", origin = "http" }: { mode?: TraceMode; origin?: TraceOrigin } = {},
|
|
155
|
+
) {
|
|
48
156
|
this.endpointKey = endpointKey;
|
|
49
157
|
this.endpointType = endpointType;
|
|
158
|
+
this.mode = mode;
|
|
159
|
+
this.origin = origin;
|
|
50
160
|
this.startedAt = performance.now();
|
|
51
161
|
this.traceId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
|
|
52
162
|
}
|
|
53
163
|
|
|
164
|
+
/** The trace a call runs under given what is switched on, or `null` when both modes are off. */
|
|
165
|
+
static create(endpointKey: string, endpointType: string, origin: TraceOrigin): SignalTrace | null {
|
|
166
|
+
const trace = isTraceEnabled()
|
|
167
|
+
? new SignalTrace(endpointKey, endpointType, { mode: "full", origin })
|
|
168
|
+
: isLogContextEnabled()
|
|
169
|
+
? new SignalTrace(endpointKey, endpointType, { mode: "context", origin })
|
|
170
|
+
: null;
|
|
171
|
+
if (trace && isFlightRecorderEnabled()) trace.startFlightRecorder();
|
|
172
|
+
return trace;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
static get activeFlights() {
|
|
176
|
+
return SignalTrace.#activeFlights;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
static #flightMaxTracesFromEnv() {
|
|
180
|
+
if (SignalTrace.#flightMaxTraces === null) {
|
|
181
|
+
const value = Number(process.env.AKAN_LOG_FLIGHT_MAX);
|
|
182
|
+
const max = Number.isFinite(value) && value > 0 ? value : SignalTrace.defaultFlightMaxRecords;
|
|
183
|
+
SignalTrace.#flightMaxTraces = Math.max(1, Math.floor(max / FLIGHT_RING_SIZE));
|
|
184
|
+
}
|
|
185
|
+
return SignalTrace.#flightMaxTraces;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
get endpoint() {
|
|
189
|
+
return `${this.endpointType}:${this.endpointKey}`;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
/** Attaches the ring unless the process is already holding its cap; a trace past the cap simply is not recorded. */
|
|
193
|
+
startFlightRecorder(): boolean {
|
|
194
|
+
if (this.#flightRing || this.#finalized) return !!this.#flightRing;
|
|
195
|
+
if (SignalTrace.#activeFlights >= SignalTrace.#flightMaxTracesFromEnv()) return false;
|
|
196
|
+
SignalTrace.#activeFlights += 1;
|
|
197
|
+
this.#flightRing = [];
|
|
198
|
+
this.flight = { minSev: logSeverity.trace, capture: (record, written) => this.#capture(record, written) };
|
|
199
|
+
return true;
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/** Honours `x-akan-debug` for this call when the deployment allows it; anything else is ignored, not refused. */
|
|
203
|
+
applyDebugHeader(value: string | null | undefined): boolean {
|
|
204
|
+
if (!value) return false;
|
|
205
|
+
const secret = process.env.AKAN_LOG_DEBUG_HEADER;
|
|
206
|
+
const allowed =
|
|
207
|
+
process.env.AKAN_PUBLIC_ENV === "local" ||
|
|
208
|
+
(!!secret && value.length === secret.length && timingSafeEqual(Buffer.from(value), Buffer.from(secret)));
|
|
209
|
+
if (!allowed) return false;
|
|
210
|
+
this.debugSev = logSeverity.trace;
|
|
211
|
+
return true;
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
setAttr(key: string, value: LogAttrs[string]): void {
|
|
215
|
+
this.attrs[key] = value;
|
|
216
|
+
}
|
|
217
|
+
|
|
54
218
|
recordSpan(name: string, durationMs: number): void {
|
|
55
|
-
if (this.spans.length >= MAX_SPANS_PER_TRACE) return;
|
|
219
|
+
if (this.mode !== "full" || this.spans.length >= MAX_SPANS_PER_TRACE) return;
|
|
56
220
|
this.spans.push({ name, durationMs });
|
|
57
221
|
}
|
|
58
222
|
|
|
59
223
|
countDbQuery(durationMs: number): void {
|
|
224
|
+
if (this.mode !== "full") return;
|
|
60
225
|
this.dbQueryCount += 1;
|
|
61
226
|
this.dbQueryMs += durationMs;
|
|
62
227
|
}
|
|
63
228
|
|
|
64
229
|
countCache(hit: boolean): void {
|
|
230
|
+
if (this.mode !== "full") return;
|
|
65
231
|
if (hit) this.cacheHits += 1;
|
|
66
232
|
else this.cacheMisses += 1;
|
|
67
233
|
}
|
|
68
234
|
|
|
69
235
|
countDataLoaderBatch(keyCount: number): void {
|
|
236
|
+
if (this.mode !== "full") return;
|
|
70
237
|
this.dataLoaderBatchCount += 1;
|
|
71
238
|
this.dataLoaderKeyCount += keyCount;
|
|
72
239
|
}
|
|
73
240
|
|
|
241
|
+
fail(error: unknown): void {
|
|
242
|
+
this.outcome = "error";
|
|
243
|
+
this.error = error;
|
|
244
|
+
const statusCode = (error as { statusCode?: unknown } | null)?.statusCode;
|
|
245
|
+
this.status = typeof statusCode === "number" ? statusCode : 500;
|
|
246
|
+
}
|
|
247
|
+
|
|
74
248
|
finalize(): void {
|
|
75
249
|
if (this.#finalized) return;
|
|
76
250
|
this.#finalized = true;
|
|
251
|
+
this.outcome ??= "ok";
|
|
252
|
+
this.status ??= 200;
|
|
77
253
|
const totalMs = performance.now() - this.startedAt;
|
|
254
|
+
|
|
255
|
+
this.#flushFlight(totalMs);
|
|
256
|
+
this.#emitCanonicalLine(totalMs);
|
|
257
|
+
if (this.mode !== "full") return;
|
|
78
258
|
this.recordSpan("total", totalMs);
|
|
79
259
|
traceAggregator.ingest(this);
|
|
80
260
|
maybeFlushTraceFile();
|
|
81
261
|
}
|
|
262
|
+
|
|
263
|
+
#capture(record: LogRecord, written: boolean) {
|
|
264
|
+
const ring = this.#flightRing;
|
|
265
|
+
if (!ring || this.#finalized) return;
|
|
266
|
+
if (ring.length >= FLIGHT_RING_SIZE) {
|
|
267
|
+
ring.shift();
|
|
268
|
+
this.#flightEvicted += 1;
|
|
269
|
+
}
|
|
270
|
+
ring.push({ record, written });
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
#flushFlight(totalMs: number) {
|
|
274
|
+
const ring = this.#flightRing;
|
|
275
|
+
if (!ring) return;
|
|
276
|
+
this.#flightRing = null;
|
|
277
|
+
this.flight = null;
|
|
278
|
+
SignalTrace.#activeFlights -= 1;
|
|
279
|
+
if (this.outcome !== "error" && totalMs < getFlightThresholdMs()) return;
|
|
280
|
+
const pending = ring.filter((entry) => !entry.written).map((entry) => entry.record);
|
|
281
|
+
if (pending.length) Logger.replay(pending, { evicted: this.#flightEvicted });
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
#emitCanonicalLine(totalMs: number) {
|
|
285
|
+
const mode = getCanonicalLineMode();
|
|
286
|
+
if (mode === "off") return;
|
|
287
|
+
const failed = this.outcome === "error";
|
|
288
|
+
if (mode === "slow" && !failed && totalMs < getFlightThresholdMs()) return;
|
|
289
|
+
const attrs: LogAttrs = { ms: Math.round(totalMs * 10) / 10, status: this.status ?? 200, ...this.attrs };
|
|
290
|
+
if (this.mode === "full") {
|
|
291
|
+
attrs.db = this.dbQueryCount;
|
|
292
|
+
attrs.dbMs = Math.round(this.dbQueryMs * 10) / 10;
|
|
293
|
+
const lookups = this.cacheHits + this.cacheMisses;
|
|
294
|
+
if (lookups) attrs.cacheHit = Math.round((this.cacheHits / lookups) * 100) / 100;
|
|
295
|
+
}
|
|
296
|
+
if (failed) attrs.err = SignalTrace.#describeError(this.error);
|
|
297
|
+
Logger.emit({
|
|
298
|
+
level: failed ? "warn" : "info",
|
|
299
|
+
name: "Signal",
|
|
300
|
+
message: `${this.outcome} ${this.endpoint}`,
|
|
301
|
+
attrs,
|
|
302
|
+
});
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
static #describeError(error: unknown): string {
|
|
306
|
+
const text = error instanceof Error ? error.message : String(error);
|
|
307
|
+
const line = text.split("\n")[0] ?? "";
|
|
308
|
+
return line.length > CANONICAL_ERROR_CHARS ? `${line.slice(0, CANONICAL_ERROR_CHARS)}…` : line;
|
|
309
|
+
}
|
|
82
310
|
}
|
|
83
311
|
|
|
84
312
|
const traceProcessStore = process as unknown as {
|
|
@@ -98,13 +326,44 @@ export const getCurrentTrace = (): SignalTrace | undefined => als.getStore();
|
|
|
98
326
|
/** Run `fn` with `trace` as the ambient request trace. */
|
|
99
327
|
export const runWithTrace = <T>(trace: SignalTrace, fn: () => T): T => als.run(trace, fn);
|
|
100
328
|
|
|
329
|
+
/**
|
|
330
|
+
* Run `fn` as the whole life of `trace`: a throw marks the outcome before it propagates, and the trace is
|
|
331
|
+
* finalized after the caller's own catch has run — which is what lets an error log carry the traceId.
|
|
332
|
+
*/
|
|
333
|
+
export const runTraced = async <T>(trace: SignalTrace | null, fn: () => Promise<T>): Promise<T> => {
|
|
334
|
+
if (!trace) return await fn();
|
|
335
|
+
return await als.run(trace, async () => {
|
|
336
|
+
try {
|
|
337
|
+
return await fn();
|
|
338
|
+
} catch (error) {
|
|
339
|
+
trace.fail(error);
|
|
340
|
+
throw error;
|
|
341
|
+
} finally {
|
|
342
|
+
trace.finalize();
|
|
343
|
+
}
|
|
344
|
+
});
|
|
345
|
+
};
|
|
346
|
+
|
|
347
|
+
registerLogContextReader(() => {
|
|
348
|
+
const trace = als.getStore();
|
|
349
|
+
if (!trace) return undefined;
|
|
350
|
+
return {
|
|
351
|
+
traceId: trace.traceId,
|
|
352
|
+
endpoint: trace.endpoint,
|
|
353
|
+
origin: trace.origin,
|
|
354
|
+
flight: trace.flight,
|
|
355
|
+
debugSev: trace.debugSev,
|
|
356
|
+
};
|
|
357
|
+
});
|
|
358
|
+
refreshLoggerContextGate();
|
|
359
|
+
|
|
101
360
|
/**
|
|
102
361
|
* Time an async stage under the current trace. When tracing is off (or no trace is
|
|
103
362
|
* active) this is a thin passthrough with no measurement overhead.
|
|
104
363
|
*/
|
|
105
364
|
export const traceSpan = async <T>(name: string, fn: () => Promise<T>): Promise<T> => {
|
|
106
365
|
const trace = getCurrentTrace();
|
|
107
|
-
if (
|
|
366
|
+
if (trace?.mode !== "full") return await fn();
|
|
108
367
|
const start = performance.now();
|
|
109
368
|
try {
|
|
110
369
|
return await fn();
|
package/signal/types.ts
CHANGED
|
@@ -12,9 +12,9 @@ export type SrvMap<S extends ServiceModel> = S["srvMap"];
|
|
|
12
12
|
|
|
13
13
|
export type CnstRefName<S extends ServiceModel> = CnstOf<S>["refName"];
|
|
14
14
|
export type CnstInput<S extends ServiceModel> = CnstOf<S>["_Input"];
|
|
15
|
-
export type CnstFull<S extends ServiceModel> =
|
|
16
|
-
export type CnstLight<S extends ServiceModel> =
|
|
17
|
-
export type CnstInsight<S extends ServiceModel> =
|
|
15
|
+
export type CnstFull<S extends ServiceModel> = CnstOf<S>["_Full"];
|
|
16
|
+
export type CnstLight<S extends ServiceModel> = CnstOf<S>["_Light"];
|
|
17
|
+
export type CnstInsight<S extends ServiceModel> = CnstOf<S>["_Insight"];
|
|
18
18
|
export type CnstDefault<S extends ServiceModel> = CnstOf<S>["_Default"];
|
|
19
19
|
export type CnstDefaultInput<S extends ServiceModel> = CnstOf<S>["_DefaultInput"];
|
|
20
20
|
export type CnstDefaultState<S extends ServiceModel> = CnstOf<S>["_DefaultState"];
|
|
@@ -61,6 +61,8 @@ interface TimerOption {
|
|
|
61
61
|
enabled?: boolean;
|
|
62
62
|
}
|
|
63
63
|
|
|
64
|
+
export type HttpMutationMethod = "POST" | "PATCH" | "PUT" | "DELETE";
|
|
65
|
+
|
|
64
66
|
export interface SignalOption<Response = any, Nullable extends boolean = false, _Key = keyof UnCls<Response>>
|
|
65
67
|
extends InitOption,
|
|
66
68
|
TimerOption {
|
|
@@ -76,8 +78,31 @@ export interface SignalOption<Response = any, Nullable extends boolean = false,
|
|
|
76
78
|
middlewares?: MiddlewareCls[];
|
|
77
79
|
prefix?: false | string;
|
|
78
80
|
globalPrefix?: false;
|
|
81
|
+
/**
|
|
82
|
+
* HTTP verb for a `mutation`, `POST` unless named. Only a foreign wire protocol needs the others — a client
|
|
83
|
+
* that cannot be changed and sends `PATCH /rest/v1/<table>`. Every other endpoint type ignores it.
|
|
84
|
+
*/
|
|
85
|
+
method?: HttpMutationMethod;
|
|
79
86
|
/** Marks this mutation as the framework file-upload endpoint (see resolveFileUploadCapability). */
|
|
80
87
|
fileUpload?: boolean;
|
|
88
|
+
/**
|
|
89
|
+
* Whether this endpoint belongs on an agent's shelf. `true` — the default — publishes it to MCP subject to the
|
|
90
|
+
* guard and shape rules; `false` keeps it out of the catalogue entirely.
|
|
91
|
+
*
|
|
92
|
+
* This is curation, not authorization: HTTP serves the endpoint exactly as before, and the guards are still the
|
|
93
|
+
* only thing deciding who may call it. Write it where an endpoint is perfectly guarded and still has no business
|
|
94
|
+
* on a shelf — a step of a UI-driven state machine (`requestPhoneCodeForSignin`), or a read a model would only
|
|
95
|
+
* ever call by mistake. Every catalogue entry carries the model schemas it mentions, so one endpoint dropped
|
|
96
|
+
* here is kilobytes off every `tools/list`.
|
|
97
|
+
*/
|
|
98
|
+
mcp?: boolean;
|
|
99
|
+
/**
|
|
100
|
+
* What a `pubsub(Binary)` does when a subscriber cannot keep up. `"coalesce"` (the default) keeps only the
|
|
101
|
+
* newest frame per room, which is what a telemetry or video stream wants — an old frame is worthless once a
|
|
102
|
+
* newer one exists. Name `"queue"` when the frames are a sequence a subscriber has to see in full, such as
|
|
103
|
+
* deltas against a base it already holds; the send buffer then grows with the slowest subscriber.
|
|
104
|
+
*/
|
|
105
|
+
backpressure?: "coalesce" | "queue";
|
|
81
106
|
|
|
82
107
|
scheduleType?: "init" | "destroy" | "cron" | "interval" | "timeout";
|
|
83
108
|
scheduleCron?: string;
|
|
@@ -92,7 +117,15 @@ interface SerializedSignalOption {
|
|
|
92
117
|
prefix?: false | string;
|
|
93
118
|
globalPrefix?: false;
|
|
94
119
|
guards?: string[];
|
|
120
|
+
method?: HttpMutationMethod;
|
|
95
121
|
fileUpload?: boolean;
|
|
122
|
+
/**
|
|
123
|
+
* Only ever `false`, and only when something declared it: `true` is the default, so serializing it would ship a
|
|
124
|
+
* field per endpoint that says nothing. Resolved here rather than left to the reader because the browser API
|
|
125
|
+
* explorer has guard *names* and no classes, and a second implementation of the rule would eventually disagree
|
|
126
|
+
* with the catalogue.
|
|
127
|
+
*/
|
|
128
|
+
mcp?: false;
|
|
96
129
|
}
|
|
97
130
|
export interface SerializedSlice extends SerializedSignalOption {}
|
|
98
131
|
|
|
@@ -112,12 +145,17 @@ export interface SerializedArg {
|
|
|
112
145
|
nullable?: boolean;
|
|
113
146
|
example?: string | number | boolean | Date;
|
|
114
147
|
enum?: string;
|
|
148
|
+
/** The values this arg accepts, when they are a fixed list the caller has to pick from. */
|
|
149
|
+
oneOf?: (string | number)[];
|
|
150
|
+
/** For an id a filter declared against a model: the model it points at, so a UI can offer a picker. */
|
|
151
|
+
ref?: string;
|
|
115
152
|
}
|
|
116
153
|
export interface SerializedEndpoint extends SerializedSignalOption {
|
|
117
|
-
type: "query" | "mutation" | "pubsub" | "message";
|
|
154
|
+
type: "query" | "mutation" | "pubsub" | "message" | "prompt";
|
|
118
155
|
returns: SerializedReturns;
|
|
119
156
|
}
|
|
120
157
|
export interface SerializedFilter {
|
|
158
|
+
/** Every filter query the model declares, by key, with the args each one takes. */
|
|
121
159
|
filter: { [key: string]: SerializedArg[] };
|
|
122
160
|
sortKeys: string[];
|
|
123
161
|
}
|
|
@@ -132,6 +170,19 @@ export interface SerializedSignal {
|
|
|
132
170
|
createGuards?: string[];
|
|
133
171
|
updateGuards?: string[];
|
|
134
172
|
removeGuards?: string[];
|
|
173
|
+
/**
|
|
174
|
+
* Which generated CRUD verbs this model keeps off the agent shelf. Carried on the signal because the endpoints
|
|
175
|
+
* it names do not exist until `FetchClient.getBaseEndpoint` synthesizes them. Only the `false` keys travel.
|
|
176
|
+
*/
|
|
177
|
+
mcp?: SerializedSignalMcp;
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/** Keyed by generated verb, mirroring the `guards` map `slice()` takes. The root slice's own flag rides on `slice[""]`. */
|
|
181
|
+
export interface SerializedSignalMcp {
|
|
182
|
+
get?: false;
|
|
183
|
+
create?: false;
|
|
184
|
+
update?: false;
|
|
185
|
+
remove?: false;
|
|
135
186
|
}
|
|
136
187
|
|
|
137
188
|
export type SignalType = "restapi" | "websocket";
|