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
|
@@ -73,6 +73,41 @@ export type CapacitorContactsModule = {
|
|
|
73
73
|
}>;
|
|
74
74
|
};
|
|
75
75
|
};
|
|
76
|
+
export type CapacitorSpeechRecognitionModule = {
|
|
77
|
+
SpeechRecognition: {
|
|
78
|
+
available: () => Promise<{
|
|
79
|
+
available: boolean;
|
|
80
|
+
}>;
|
|
81
|
+
checkPermissions: () => Promise<{
|
|
82
|
+
speechRecognition: CapacitorPermissionState;
|
|
83
|
+
}>;
|
|
84
|
+
requestPermissions: () => Promise<{
|
|
85
|
+
speechRecognition: CapacitorPermissionState;
|
|
86
|
+
}>;
|
|
87
|
+
start: (options: Record<string, unknown>) => Promise<{
|
|
88
|
+
matches?: string[];
|
|
89
|
+
}>;
|
|
90
|
+
stop: () => Promise<void>;
|
|
91
|
+
removeAllListeners: () => Promise<void> | void;
|
|
92
|
+
addListener: (eventName: string, listenerFunc: (data: {
|
|
93
|
+
matches?: string[];
|
|
94
|
+
}) => void) => Promise<{
|
|
95
|
+
remove: () => Promise<void> | void;
|
|
96
|
+
}> | {
|
|
97
|
+
remove: () => Promise<void> | void;
|
|
98
|
+
};
|
|
99
|
+
};
|
|
100
|
+
};
|
|
101
|
+
export type CapacitorTextToSpeechModule = {
|
|
102
|
+
TextToSpeech: {
|
|
103
|
+
speak: (options: {
|
|
104
|
+
text: string;
|
|
105
|
+
lang?: string;
|
|
106
|
+
rate?: number;
|
|
107
|
+
}) => Promise<void>;
|
|
108
|
+
stop: () => Promise<void>;
|
|
109
|
+
};
|
|
110
|
+
};
|
|
76
111
|
export type CapacitorCoreModule = {
|
|
77
112
|
CapacitorCookies: {
|
|
78
113
|
setCookie: (options: {
|
|
@@ -226,6 +261,8 @@ type CapacitorModuleMap = {
|
|
|
226
261
|
preferences: CapacitorPreferencesModule;
|
|
227
262
|
pushNotifications: CapacitorPushNotificationsModule;
|
|
228
263
|
safeArea: CapacitorSafeAreaModule;
|
|
264
|
+
speechRecognition: CapacitorSpeechRecognitionModule;
|
|
265
|
+
textToSpeech: CapacitorTextToSpeechModule;
|
|
229
266
|
updater: CapacitorUpdaterModule;
|
|
230
267
|
};
|
|
231
268
|
type CapacitorImportCache = Partial<{
|
|
@@ -247,5 +284,7 @@ export declare const loadCapacitorKeyboard: () => Promise<CapacitorKeyboardModul
|
|
|
247
284
|
export declare const loadCapacitorPreferences: () => Promise<CapacitorPreferencesModule>;
|
|
248
285
|
export declare const loadCapacitorPushNotifications: () => Promise<CapacitorPushNotificationsModule>;
|
|
249
286
|
export declare const loadCapacitorSafeArea: () => Promise<CapacitorSafeAreaModule>;
|
|
287
|
+
export declare const loadCapacitorSpeechRecognition: () => Promise<CapacitorSpeechRecognitionModule>;
|
|
288
|
+
export declare const loadCapacitorTextToSpeech: () => Promise<CapacitorTextToSpeechModule>;
|
|
250
289
|
export declare const loadCapacitorUpdater: () => Promise<CapacitorUpdaterModule>;
|
|
251
290
|
export {};
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { SliceMeta } from "akanjs/fetch";
|
|
2
|
+
import type { SerializedArg } from "akanjs/signal";
|
|
2
3
|
import type { ReactNode } from "react";
|
|
3
4
|
import type { TransMessageOption } from "./makePageProto.d.ts";
|
|
4
5
|
type RuntimeTranslate = ((key: string, param?: Record<string, string | number>) => string) & {
|
|
@@ -39,6 +40,12 @@ type RuntimeFetch = typeof globalThis.fetch & {
|
|
|
39
40
|
serializedSignal: Record<string, unknown>;
|
|
40
41
|
setJwt: (jwt: string | null) => void;
|
|
41
42
|
slice: Record<string, SliceMeta>;
|
|
43
|
+
/** Sort keys per model refName, registered from each serialized signal's filter. */
|
|
44
|
+
sortKeyMap?: Map<string, string[]>;
|
|
45
|
+
/** Filter queries per model refName, with the args each one takes — what the root slice picks from. */
|
|
46
|
+
filterQueryMap?: Map<string, {
|
|
47
|
+
[queryKey: string]: SerializedArg[];
|
|
48
|
+
}>;
|
|
42
49
|
ws: RuntimeWs;
|
|
43
50
|
[key: string]: unknown;
|
|
44
51
|
};
|
package/types/client/index.d.ts
CHANGED
|
@@ -11,6 +11,7 @@ export * from "./locale.d.ts";
|
|
|
11
11
|
export * from "./makePageProto.d.ts";
|
|
12
12
|
export * from "./router.d.ts";
|
|
13
13
|
export * from "./rscNavigation.d.ts";
|
|
14
|
+
export * from "./sharedContext.d.ts";
|
|
14
15
|
export * from "./storage.d.ts";
|
|
15
16
|
export * from "./translator.d.ts";
|
|
16
17
|
export * from "./types.d.ts";
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { type Context } from "react";
|
|
2
|
+
/**
|
|
3
|
+
* A React context interned on `globalThis`, which is how every context this framework owns must be made.
|
|
4
|
+
*
|
|
5
|
+
* An akan build does not give an app one copy of `akanjs`: it inlines each reachable module into every client
|
|
6
|
+
* chunk that reaches it — four copies of the agent runtime in this repo's own docs app. A context is identified
|
|
7
|
+
* by object identity, so a Provider mounted from one copy is invisible to a consumer holding another, and the
|
|
8
|
+
* consumer silently reads the context's default instead.
|
|
9
|
+
*
|
|
10
|
+
* Silently is the whole problem. `UiOverrideContext` was a plain `createContext`, so a route's `_overrides.tsx`
|
|
11
|
+
* bound its slots in the chunk holding the generated provider and every overridable component in another chunk
|
|
12
|
+
* kept rendering the framework default — no throw, no warning, and only *some* slots affected, which reads like
|
|
13
|
+
* a bug in the app's own component. The same shape cost a zone every tool it declared.
|
|
14
|
+
*
|
|
15
|
+
* The rule is therefore mechanical rather than case-by-case: a context whose Provider and consumers can be
|
|
16
|
+
* bundled apart is every context worth having, so all of them go through here. A test fails if one does not.
|
|
17
|
+
*
|
|
18
|
+
* `use-agentic` carries its own twin under a `useAgentic.` prefix, deliberately — it ships as a standalone
|
|
19
|
+
* package and cannot import this one. The prefixes keep the two namespaces from ever meeting.
|
|
20
|
+
*/
|
|
21
|
+
export declare const sharedContext: <T>(name: string, initial: T) => Context<T>;
|
package/types/client/types.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { BaseInsight } from "akanjs/constant";
|
|
2
|
-
import type { FetchInitForm, SliceMeta } from "akanjs/fetch";
|
|
2
|
+
import type { FetchInitForm, QuerySetting, SliceMeta } from "akanjs/fetch";
|
|
3
3
|
import type { ReactElement, ReactNode } from "react";
|
|
4
4
|
export type ReactFontStyle = "normal" | "italic" | "oblique";
|
|
5
5
|
export type ReactFontDisplay = "auto" | "block" | "swap" | "fallback" | "optional";
|
|
@@ -37,7 +37,7 @@ export interface ModelsProps<M extends {
|
|
|
37
37
|
}> {
|
|
38
38
|
className?: string;
|
|
39
39
|
slice?: SliceMeta;
|
|
40
|
-
query?:
|
|
40
|
+
query?: QuerySetting;
|
|
41
41
|
init?: FetchInitForm<any, any>;
|
|
42
42
|
onClickItem?: (model: M) => unknown;
|
|
43
43
|
}
|
|
@@ -57,7 +57,9 @@ export type ModelProps<T extends string, L extends {
|
|
|
57
57
|
export interface ModelDashboardProps<Summary> {
|
|
58
58
|
className?: string;
|
|
59
59
|
summary: Summary;
|
|
60
|
-
queryMap?:
|
|
60
|
+
queryMap?: {
|
|
61
|
+
[column: string]: QuerySetting;
|
|
62
|
+
};
|
|
61
63
|
columns?: (keyof Summary)[];
|
|
62
64
|
hidePresents?: boolean;
|
|
63
65
|
slice?: SliceMeta;
|
package/types/common/Logger.d.ts
CHANGED
|
@@ -1,29 +1,110 @@
|
|
|
1
|
-
declare const logLevels: readonly ["trace", "verbose", "debug", "
|
|
1
|
+
export declare const logLevels: readonly ["trace", "verbose", "debug", "info", "warn", "error"];
|
|
2
2
|
export type LogLevel = (typeof logLevels)[number];
|
|
3
|
+
export type LogLevelInput = LogLevel | "log";
|
|
4
|
+
export declare const logSeverity: {
|
|
5
|
+
readonly trace: 1;
|
|
6
|
+
readonly verbose: 3;
|
|
7
|
+
readonly debug: 5;
|
|
8
|
+
readonly info: 9;
|
|
9
|
+
readonly warn: 13;
|
|
10
|
+
readonly error: 17;
|
|
11
|
+
};
|
|
12
|
+
/** `text` is the human console line; the `ndjson` pair make the container's stdout one JSON record per line. */
|
|
13
|
+
export declare const logFormats: readonly ["text", "ndjson", "ndjson-only"];
|
|
14
|
+
export type LogFormat = (typeof logFormats)[number];
|
|
15
|
+
export type LogAttrValue = string | number | boolean | null;
|
|
16
|
+
export interface LogAttrs {
|
|
17
|
+
[key: string]: LogAttrValue;
|
|
18
|
+
}
|
|
19
|
+
export interface LogRecord {
|
|
20
|
+
at: number;
|
|
21
|
+
/** Milliseconds since the producing process started — what the `+Nms` in the rendered line shows. */
|
|
22
|
+
elapsedMs: number;
|
|
23
|
+
level: LogLevel | null;
|
|
24
|
+
sev: number;
|
|
25
|
+
name: string;
|
|
26
|
+
context: string;
|
|
27
|
+
message: string;
|
|
28
|
+
stream: "stdout" | "stderr";
|
|
29
|
+
pid: number | null;
|
|
30
|
+
replicaIdx: number | null;
|
|
31
|
+
role: string | null;
|
|
32
|
+
origin: string | null;
|
|
33
|
+
traceId: string | null;
|
|
34
|
+
endpoint: string | null;
|
|
35
|
+
attrs?: LogAttrs;
|
|
36
|
+
}
|
|
3
37
|
export interface LoggerSinkEntry {
|
|
4
38
|
stream: "stdout" | "stderr";
|
|
5
39
|
level?: LogLevel;
|
|
6
40
|
message: string;
|
|
7
41
|
plainMessage: string;
|
|
42
|
+
record: LogRecord;
|
|
8
43
|
}
|
|
9
44
|
export type LoggerSink = (entry: LoggerSinkEntry) => void | Promise<void>;
|
|
45
|
+
export interface LoggerSinkOptions {
|
|
46
|
+
minLevel?: LogLevelInput;
|
|
47
|
+
}
|
|
48
|
+
export interface LoggerEmitInput {
|
|
49
|
+
level: LogLevel;
|
|
50
|
+
name: string;
|
|
51
|
+
message: string;
|
|
52
|
+
context?: string;
|
|
53
|
+
attrs?: LogAttrs;
|
|
54
|
+
}
|
|
10
55
|
/** Log-level aware logger used by Akan runtime, CLI, and application services. */
|
|
11
56
|
export declare class Logger {
|
|
12
57
|
#private;
|
|
58
|
+
/** `AKAN_LOG_STDOUT_LEVEL` names what the container's stdout carries; without it the console level is that. */
|
|
13
59
|
static level: LogLevel;
|
|
14
60
|
static fileLevel: LogLevel;
|
|
15
|
-
static
|
|
16
|
-
|
|
61
|
+
static format: LogFormat;
|
|
62
|
+
/** Which process this is (`gateway`, `all`, `batch`, `rsc-worker`); the owner sets it at boot. */
|
|
63
|
+
static role: string | null;
|
|
64
|
+
/**
|
|
65
|
+
* Whether this process writes its own lines to the terminal. Off in every server process of an ndjson
|
|
66
|
+
* deployment: the hub owner writes the one JSON stream, and a text line from anyone would corrupt it.
|
|
67
|
+
*/
|
|
68
|
+
static consoleOutput: boolean;
|
|
69
|
+
/** Set by the trace layer when a flight recorder or a per-request debug floor can be active. */
|
|
70
|
+
static contextGate: boolean;
|
|
71
|
+
static readonly startAt: number;
|
|
72
|
+
static setLevel(level: LogLevelInput): void;
|
|
73
|
+
static setFileLevel(level: LogLevelInput): void;
|
|
74
|
+
static addSink(sink: LoggerSink, { minLevel }?: LoggerSinkOptions): () => void;
|
|
17
75
|
static removeSink(sink: LoggerSink): void;
|
|
18
|
-
static setFileLevel(level: LogLevel): void;
|
|
19
76
|
static isVerbose(): boolean;
|
|
77
|
+
static get isNdjson(): boolean;
|
|
20
78
|
/** For hot-path callers that would otherwise build a message the level is about to discard. */
|
|
21
|
-
static shouldLog(logLevel:
|
|
79
|
+
static shouldLog(logLevel: LogLevelInput): boolean;
|
|
80
|
+
static normalizeLevel(level: LogLevelInput): LogLevel;
|
|
81
|
+
/** The lowest named level whose severity is at least `sev`. */
|
|
82
|
+
static levelAtOrAbove(sev: number): LogLevel;
|
|
83
|
+
static render(record: LogRecord): string;
|
|
84
|
+
/** `key=value` pairs; a string with whitespace is quoted so the line stays splittable. */
|
|
85
|
+
static formatAttrs(attrs: LogAttrs): string;
|
|
86
|
+
/**
|
|
87
|
+
* A record somebody asked for below the level — a failed call's flight recorder, a request carrying
|
|
88
|
+
* `x-akan-debug` — passes every floor between here and the reader; the floors exist to drop what nobody asked for.
|
|
89
|
+
*/
|
|
90
|
+
static isPromoted(record: LogRecord): boolean;
|
|
91
|
+
static redactAttrs(attrs: LogAttrs): LogAttrs;
|
|
92
|
+
/** A structured record from a caller that has more than a sentence to say — the canonical request line. */
|
|
93
|
+
static emit({ level, name, message, context, attrs }: LoggerEmitInput): void;
|
|
94
|
+
/**
|
|
95
|
+
* Writes records that were captured below the gate and are now promoted — a failed request's flight
|
|
96
|
+
* recorder. They bypass the console level, since not showing them is what the recorder was for, and reach
|
|
97
|
+
* sinks under their own floors; each is marked `flight` so a reader knows why a trace line appears at info.
|
|
98
|
+
*/
|
|
99
|
+
static replay(records: LogRecord[], { evicted }?: {
|
|
100
|
+
evicted?: number;
|
|
101
|
+
}): void;
|
|
22
102
|
name?: string;
|
|
23
103
|
constructor(name?: string);
|
|
24
104
|
trace(msg: string, context?: string, name?: string): void;
|
|
25
105
|
verbose(msg: string, context?: string, name?: string): void;
|
|
26
106
|
debug(msg: string, context?: string, name?: string): void;
|
|
107
|
+
/** @deprecated Emits at `info`; call `info()`. */
|
|
27
108
|
log(msg: string, context?: string, name?: string): void;
|
|
28
109
|
info(msg: string, context?: string, name?: string): void;
|
|
29
110
|
warn(msg: string, context?: string, name?: string): void;
|
|
@@ -33,11 +114,12 @@ export declare class Logger {
|
|
|
33
114
|
static trace(msg: string, context?: string, name?: string): void;
|
|
34
115
|
static verbose(msg: string, context?: string, name?: string): void;
|
|
35
116
|
static debug(msg: string, context?: string, name?: string): void;
|
|
117
|
+
/** @deprecated Emits at `info`; call `info()`. */
|
|
36
118
|
static log(msg: string, context?: string, name?: string): void;
|
|
37
119
|
static info(msg: string, context?: string, name?: string): void;
|
|
38
120
|
static warn(msg: string, context?: string, name?: string): void;
|
|
39
121
|
static error(msg: string, context?: string, name?: string): void;
|
|
122
|
+
static stripAnsi(msg: string): string;
|
|
40
123
|
static rawLog(msg?: string, method?: "console" | "process", outputStream?: "log" | "error"): void;
|
|
41
124
|
static raw(msg?: string, method?: "console" | "process", outputStream?: "log" | "error"): void;
|
|
42
125
|
}
|
|
43
|
-
export {};
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/** Headers a proxy hop writes so the next hop can still name the original caller. */
|
|
2
|
+
export declare const forwardedHeaders: readonly ["x-real-ip", "x-forwarded-for", "x-forwarded-port", "x-forwarded-host", "x-forwarded-proto"];
|
|
3
|
+
/**
|
|
4
|
+
* An IPv4 client reaching a dual-stack listener is reported as `::ffff:203.0.113.10`. That form is not a
|
|
5
|
+
* valid destination for a `udp4` socket and does not compare equal to the same address written plainly, so
|
|
6
|
+
* it is unwrapped at every boundary rather than at each call site that happens to remember.
|
|
7
|
+
*/
|
|
8
|
+
export declare const normalizeIpAddress: (address: string) => string;
|
|
9
|
+
/**
|
|
10
|
+
* The caller's address as the nearest proxy recorded it. `x-real-ip` is one hop's word for who the client is
|
|
11
|
+
* and wins; `x-forwarded-for` is a chain appended left to right, so its *first* entry is the original client
|
|
12
|
+
* and everything after it is a proxy.
|
|
13
|
+
*
|
|
14
|
+
* Returns `null` rather than a placeholder. A socket peer behind a proxy is the proxy, so `127.0.0.1` here
|
|
15
|
+
* would be indistinguishable from a genuinely local caller — and that is the failure this exists to prevent.
|
|
16
|
+
*/
|
|
17
|
+
export declare const clientAddressFromHeaders: (headers: Headers) => string | null;
|
|
18
|
+
/** The client port the nearest proxy recorded, for correlating a connection with a peer's own logs. */
|
|
19
|
+
export declare const clientPortFromHeaders: (headers: Headers) => number | null;
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
|
|
1
|
+
interface DeepObjectifyOption {
|
|
2
2
|
serializable?: boolean;
|
|
3
3
|
convertDate?: "string" | "number";
|
|
4
|
-
}
|
|
4
|
+
}
|
|
5
|
+
export declare const deepObjectify: <T = unknown>(obj: T | null | undefined, option?: DeepObjectifyOption) => T;
|
|
6
|
+
export {};
|
package/types/common/index.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
export { applyMixins } from "./applyMixins.d.ts";
|
|
2
2
|
export { capitalize } from "./capitalize.d.ts";
|
|
3
|
+
export { clientAddressFromHeaders, clientPortFromHeaders, forwardedHeaders, normalizeIpAddress, } from "./clientAddress.d.ts";
|
|
3
4
|
export { deepObjectify } from "./deepObjectify.d.ts";
|
|
4
5
|
export { type FileUploadCapability, fileUploadContract, resolveFileUploadCapability, } from "./fileUpload.d.ts";
|
|
5
6
|
export { formatNumber } from "./formatNumber.d.ts";
|
|
@@ -14,18 +15,23 @@ export { isQueryEqual } from "./isQueryEqual.d.ts";
|
|
|
14
15
|
export { isThenable } from "./isThenable.d.ts";
|
|
15
16
|
export { isValidDate } from "./isValidDate.d.ts";
|
|
16
17
|
export { decodeJwtPayload } from "./jwtDecode.d.ts";
|
|
17
|
-
export { Logger, type LoggerSink, type LoggerSinkEntry, type LogLevel } from "./Logger.d.ts";
|
|
18
|
+
export { type LogAttrs, type LogAttrValue, type LogFormat, Logger, type LoggerEmitInput, type LoggerSink, type LoggerSinkEntry, type LoggerSinkOptions, type LogLevel, type LogLevelInput, type LogRecord, logFormats, logLevels, logSeverity, } from "./Logger.d.ts";
|
|
18
19
|
export { type AkanI18nConfig, type AkanI18nConfigInput, DEFAULT_AKAN_I18N, parseAkanI18nEnv, resolveAkanI18nConfig, } from "./localeConfig.d.ts";
|
|
20
|
+
export { type LogContextReader, type LogContextSnapshot, type LogFlightRecorder, readLogContext, registerLogContextReader, } from "./logContext.d.ts";
|
|
19
21
|
export { lowerlize } from "./lowerlize.d.ts";
|
|
22
|
+
export { isMcpDescribableArg, type McpExposureEndpoint, type McpExposureOption, mcpBaseVerbOf, mcpHintsOf, mcpPromptRefusalOf, mcpRefusalOf, } from "./mcpExposure.d.ts";
|
|
20
23
|
export { mergeVersion } from "./mergeVersion.d.ts";
|
|
21
24
|
export { objectify } from "./objectify.d.ts";
|
|
22
25
|
export { pathGet } from "./pathGet.d.ts";
|
|
26
|
+
export { pathGetLoose } from "./pathGetLoose.d.ts";
|
|
23
27
|
export { pathSet } from "./pathSet.d.ts";
|
|
28
|
+
export { plainFieldsOf } from "./plainFieldsOf.d.ts";
|
|
24
29
|
export { randomPick } from "./randomPick.d.ts";
|
|
25
30
|
export { randomPicks } from "./randomPicks.d.ts";
|
|
26
|
-
export { assertUniqueRoutePatterns, compareRouteSpecificity, getRouteExports, isRouteSourceFile, isSpecialRouteLeaf, LAYOUT_ROUTE_EXPORTS, matchRoutePattern, normalizeRoutePattern, PAGE_ROUTE_EXPORTS, type ParsedRouteModuleKey, parseRouteModuleKey, RESERVED_ROUTE_CONFIG_EXPORTS, ROOT_LAYOUT_ROUTE_EXPORTS, type RouteModuleKind, routeSegmentToPatternPart, routeSegmentToTreePath, tryParseRouteModuleKey, type ValidatePageSourceFileOptions, type ValidateSubRoutePageKeyOptions, validatePageSourceFile, validateSubRoutePageKey, } from "./routeConvention.d.ts";
|
|
31
|
+
export { assertUniqueRoutePatterns, compareRouteSpecificity, getPageSourceFileViolation, getRouteExports, isRouteSourceFile, isSpecialRouteLeaf, LAYOUT_ROUTE_EXPORTS, matchRoutePattern, normalizeRoutePattern, PAGE_ROUTE_EXPORTS, type ParsedRouteModuleKey, parseRouteModuleKey, RESERVED_ROUTE_CONFIG_EXPORTS, ROOT_LAYOUT_ROUTE_EXPORTS, type RouteModuleKind, routeSegmentToPatternPart, routeSegmentToTreePath, tryParseRouteModuleKey, type ValidatePageSourceFileOptions, type ValidateSubRoutePageKeyOptions, validatePageSourceFile, validateSubRoutePageKey, } from "./routeConvention.d.ts";
|
|
27
32
|
export { sleep } from "./sleep.d.ts";
|
|
28
33
|
export { splitVersion } from "./splitVersion.d.ts";
|
|
29
34
|
export { getBasePathFromPathname, parseBasePaths, parseSubRouteHosts, resolveSubRouteHosts } from "./subRoute.d.ts";
|
|
30
35
|
export type * from "./types.d.ts";
|
|
31
36
|
export { type WebsocketAuthAckData, type WebsocketAuthRequest, websocketAuthContract, } from "./websocketAuth.d.ts";
|
|
37
|
+
export { type WebsocketBinaryFrame, websocketBinaryFrameContract } from "./websocketBinaryFrame.d.ts";
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { LogRecord } from "./Logger.d.ts";
|
|
2
|
+
/** A per-request ring the Logger hands every record to; the trace decides at its end whether any of it is shown. */
|
|
3
|
+
export interface LogFlightRecorder {
|
|
4
|
+
minSev: number;
|
|
5
|
+
capture(record: LogRecord, written: boolean): void;
|
|
6
|
+
}
|
|
7
|
+
export interface LogContextSnapshot {
|
|
8
|
+
traceId: string | null;
|
|
9
|
+
endpoint: string | null;
|
|
10
|
+
origin: string | null;
|
|
11
|
+
flight?: LogFlightRecorder | null;
|
|
12
|
+
/** A per-request floor below the process level (`x-akan-debug`); `null` when the request asked for nothing. */
|
|
13
|
+
debugSev?: number | null;
|
|
14
|
+
}
|
|
15
|
+
export type LogContextReader = () => LogContextSnapshot | undefined;
|
|
16
|
+
export declare const registerLogContextReader: (reader: LogContextReader | null) => void;
|
|
17
|
+
export declare const readLogContext: () => LogContextSnapshot | undefined;
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What MCP says about one endpoint: whether it is published, why it is not, and the hints it carries.
|
|
3
|
+
*
|
|
4
|
+
* Structurally typed like the rest of `common/` so the same rules answer on both sides — the server builds its
|
|
5
|
+
* catalogue from them and the browser API explorer badges an endpoint from them. A second implementation would
|
|
6
|
+
* eventually disagree, and an audit surface that disagrees with the catalogue is worse than none.
|
|
7
|
+
*
|
|
8
|
+
* Every rejection returns the sentence an author reads, at boot in the server log and in the explorer. Fail-closed
|
|
9
|
+
* with no reason leaves an author whose endpoint is missing from the catalogue nowhere to look but the source.
|
|
10
|
+
*/
|
|
11
|
+
export interface McpExposureEndpoint {
|
|
12
|
+
type: string;
|
|
13
|
+
returns: {
|
|
14
|
+
refName: string;
|
|
15
|
+
};
|
|
16
|
+
args: {
|
|
17
|
+
name: string;
|
|
18
|
+
refName: string;
|
|
19
|
+
type: string;
|
|
20
|
+
arrDepth?: number;
|
|
21
|
+
nullable?: boolean;
|
|
22
|
+
}[];
|
|
23
|
+
guards?: string[];
|
|
24
|
+
fileUpload?: boolean;
|
|
25
|
+
mcp?: boolean;
|
|
26
|
+
}
|
|
27
|
+
export interface McpExposureOption {
|
|
28
|
+
/** The model the endpoint belongs to and the name it is published under: one rule reads the key, not the shape. */
|
|
29
|
+
refName: string;
|
|
30
|
+
key: string;
|
|
31
|
+
/**
|
|
32
|
+
* The read-only deployment valve, which is server configuration. The browser explorer cannot know it and so
|
|
33
|
+
* badges what the code decided; the boot log is where a read-only deployment says what it dropped.
|
|
34
|
+
*/
|
|
35
|
+
readOnly?: boolean;
|
|
36
|
+
}
|
|
37
|
+
/** `Any` publishes as the empty schema, which tells a model nothing — so it is left out rather than described. */
|
|
38
|
+
export declare const isMcpDescribableArg: (arg: {
|
|
39
|
+
refName: string;
|
|
40
|
+
}) => boolean;
|
|
41
|
+
/** Which CRUD verb a generated endpoint key is, or `null` when the key is not one of the five. */
|
|
42
|
+
export declare const mcpBaseVerbOf: (refName: string, key: string) => "get" | "create" | "update" | "remove" | null;
|
|
43
|
+
/**
|
|
44
|
+
* The hints a client renders beside a tool. Hints only — clients are told to distrust them, so they inform a UI
|
|
45
|
+
* and never stand in for a guard. `openWorldHint` is always false: every endpoint reaches this app's own
|
|
46
|
+
* database, not the wider internet.
|
|
47
|
+
*/
|
|
48
|
+
export declare const mcpHintsOf: (key: string, endpoint: {
|
|
49
|
+
type: string;
|
|
50
|
+
}) => {
|
|
51
|
+
readOnlyHint: boolean;
|
|
52
|
+
destructiveHint: boolean;
|
|
53
|
+
idempotentHint: boolean;
|
|
54
|
+
openWorldHint: boolean;
|
|
55
|
+
};
|
|
56
|
+
/** The sentence explaining why this endpoint is not in the catalogue, or `null` when it is. */
|
|
57
|
+
export declare const mcpRefusalOf: (endpoint: McpExposureEndpoint, { refName, key, readOnly }: McpExposureOption) => string | null;
|
|
58
|
+
/**
|
|
59
|
+
* A prompt is a read exposed on the same terms as a query, so every rejection here is one thing: an argument
|
|
60
|
+
* `prompts/get` cannot carry. Its `arguments` is a flat string map — one string per name, and no schema beside it
|
|
61
|
+
* — which rules out the argument *kinds* the builder already refuses and, just as surely, two argument *types* it
|
|
62
|
+
* accepts. A tool escapes both because it publishes a real JSON Schema.
|
|
63
|
+
*/
|
|
64
|
+
export declare const mcpPromptRefusalOf: (endpoint: McpExposureEndpoint) => string | null;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Reads a dotted path whose segments may themselves contain the separator.
|
|
3
|
+
*
|
|
4
|
+
* Dictionary keys are built as `<refName>.<value>` and an enum value is a real-world identifier — `gpt-5.6-terra`,
|
|
5
|
+
* `v1.2` — so the key is not a clean dotted path and `pathGet` splits it into segments that were never nodes.
|
|
6
|
+
* The tree stores such a key literally, so resolution has to try joined prefixes too.
|
|
7
|
+
*/
|
|
8
|
+
export declare const pathGetLoose: (path: string | readonly string[], obj: unknown, separator?: string, fallback?: unknown) => unknown;
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Own and inherited enumerable data of an object as a plain record. An Akan model keeps its Date fields as
|
|
3
|
+
* enumerable prototype accessors, which `Object.keys` and a spread never reach; methods are non-enumerable and stay
|
|
4
|
+
* out either way.
|
|
5
|
+
*/
|
|
6
|
+
export declare const plainFieldsOf: (source: object) => Record<string, unknown>;
|
|
@@ -27,6 +27,12 @@ export interface ValidatePageSourceFileOptions {
|
|
|
27
27
|
filePath?: string;
|
|
28
28
|
}
|
|
29
29
|
export declare function isRouteSourceFile(filePath: string): boolean;
|
|
30
|
+
/**
|
|
31
|
+
* Why a `page/` file breaks the route convention, or null when it is fine. Null also covers a non-source
|
|
32
|
+
* asset, which `page/` tolerates. `akan sync <lib>` reports these alongside its other layout violations,
|
|
33
|
+
* so the rule stays in one place instead of being restated where it cannot afford to throw.
|
|
34
|
+
*/
|
|
35
|
+
export declare function getPageSourceFileViolation(filePath: string): string | null;
|
|
30
36
|
export declare function validatePageSourceFile(filePath: string, options?: ValidatePageSourceFileOptions): boolean;
|
|
31
37
|
export declare function validateSubRoutePageKey(key: string, basePaths: Iterable<string>, options?: ValidateSubRoutePageKeyOptions): void;
|
|
32
38
|
export declare function parseRouteModuleKey(key: string): ParsedRouteModuleKey;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export interface WebsocketBinaryFrame {
|
|
2
|
+
roomId: string;
|
|
3
|
+
payload: Uint8Array;
|
|
4
|
+
}
|
|
5
|
+
/**
|
|
6
|
+
* Framework-owned binary pubsub frame, shared by the publisher and the client dispatcher. A room whose whole
|
|
7
|
+
* return is `Binary` sends its bytes in a websocket binary frame instead of the JSON `{ type: "pub" }` envelope,
|
|
8
|
+
* because `Buffer.toJSON()` turns bytes into `{ type: "Buffer", data: number[] }` — 3.6x the wire and ~300x the
|
|
9
|
+
* encode cost on a 64 KB payload, and a shape `JSON.parse` never restores.
|
|
10
|
+
*
|
|
11
|
+
* Text and binary frames coexist on one socket, so this is additive: every JSON endpoint is untouched, and a
|
|
12
|
+
* federation gateway relays a binary frame unchanged with no code of its own.
|
|
13
|
+
*/
|
|
14
|
+
export declare const websocketBinaryFrameContract: {
|
|
15
|
+
readonly encode: ({ roomId, payload }: WebsocketBinaryFrame) => Uint8Array;
|
|
16
|
+
readonly decode: (data: ArrayBuffer | Uint8Array) => WebsocketBinaryFrame | null;
|
|
17
|
+
};
|
|
@@ -3,16 +3,8 @@ import { type ConstantCls, type ConstantModelRef, type FieldObject, type Purifie
|
|
|
3
3
|
import type { ConstantType, DefaultOf, DocumentModel, QueryOf } from "./types.d.ts";
|
|
4
4
|
/** Runtime registry for Akan constant model metadata, refs, enums, and generated model contracts. */
|
|
5
5
|
export declare class ConstantRegistry {
|
|
6
|
-
static database: Map<string, ConstantModel<string, any, any, any, any, any, FieldObject, Capitalize<string>, GetStateObject<
|
|
7
|
-
|
|
8
|
-
}>, GetStateObject<{
|
|
9
|
-
[x: string]: any;
|
|
10
|
-
}>, GetStateObject<any>, GetStateObject<any>, GetStateObject<{
|
|
11
|
-
[x: string]: any;
|
|
12
|
-
}>, any, any, any, any, GetStateObject<any>, GetStateObject<any>>>;
|
|
13
|
-
static scalar: Map<string, ScalarConstantModel<string, any, GetStateObject<{
|
|
14
|
-
[x: string]: any;
|
|
15
|
-
}>, any, any>>;
|
|
6
|
+
static database: Map<string, ConstantModel<string, any, any, any, any, any, FieldObject, Capitalize<string>, DefaultOf<any>, DefaultOf<any>, GetStateObject<any>, GetStateObject<any>, DefaultOf<any>, any, any, any, any, GetStateObject<any>, GetStateObject<any>>>;
|
|
7
|
+
static scalar: Map<string, ScalarConstantModel<string, any, DefaultOf<any>, any, any>>;
|
|
16
8
|
static enum: Map<string, EnumInstance>;
|
|
17
9
|
static value: Map<string, unknown>;
|
|
18
10
|
static modelRefNameMap: Map<new (...args: never[]) => unknown, string>;
|
|
@@ -1,4 +1,9 @@
|
|
|
1
1
|
import { type GetStateObject } from "akanjs/base";
|
|
2
2
|
import type { FieldProps } from ".";
|
|
3
3
|
export type CrystalizeFunc<Model> = (self: GetStateObject<Model>, isChild?: boolean) => Model;
|
|
4
|
+
export type Converter = (value: unknown) => unknown;
|
|
5
|
+
/** Runs one hydration pass, sharing a relation instance across every value in it that names the same id. */
|
|
6
|
+
export declare const withSharedInstances: <T>(hydrate: () => T) => T;
|
|
7
|
+
/** The converter for one field, compiled once per `FieldProps` — which `getProps()` freezes and shares per field. */
|
|
8
|
+
export declare const converterOf: (props: FieldProps) => Converter;
|
|
4
9
|
export declare const crystalize: (field: FieldProps, value: unknown) => unknown;
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export declare const dateSlotOf: (key: string) => symbol;
|
|
2
|
+
/** A caller's own `Date` is copied: the slot must not alias an object the caller can still mutate. */
|
|
3
|
+
export declare const toDateValue: (value: unknown) => Date | null | undefined;
|
|
4
|
+
/**
|
|
5
|
+
* Enumerable so `for...in` — `plainFieldsOf`, `immerify`, `deepObjectify` — still sees the field. immer calls a
|
|
6
|
+
* prototype setter with the draft as `this`, so a write through the accessor stays copy-on-write, and the getter
|
|
7
|
+
* writes nothing, so a read never marks a draft modified.
|
|
8
|
+
*/
|
|
9
|
+
export declare const dateAccessorOf: (key: string) => PropertyDescriptor;
|
|
10
|
+
export declare const isDateSlotField: (props: {
|
|
11
|
+
modelRef: unknown;
|
|
12
|
+
isArray: boolean;
|
|
13
|
+
isMap: boolean;
|
|
14
|
+
}) => boolean;
|
|
@@ -47,6 +47,13 @@ export interface ConstantFieldProps<FieldType extends ConstantFieldKind = Consta
|
|
|
47
47
|
validate?: (value: FieldValue, model: any) => boolean;
|
|
48
48
|
text?: TextFieldRole;
|
|
49
49
|
cascade?: CascadeAction;
|
|
50
|
+
/**
|
|
51
|
+
* Renders on the page, never reaches an agent. Stripped wherever a value is masked for an AI caller — the
|
|
52
|
+
* in-page agent's reads and every MCP result — and left untouched everywhere else, so a `File`'s blur
|
|
53
|
+
* placeholder still ships to `<Image>`. Unlike `hidden`/`secret` this is about cost, not secrecy: a field
|
|
54
|
+
* nothing can answer a question with is pure spend on every turn it rides.
|
|
55
|
+
*/
|
|
56
|
+
visual?: boolean;
|
|
50
57
|
meta?: Metadata;
|
|
51
58
|
}
|
|
52
59
|
export declare const fieldPresets: readonly ["email", "password", "url"];
|
|
@@ -94,6 +101,7 @@ interface ConstantFieldBuildProps<FieldType extends ConstantFieldKind = any, Fie
|
|
|
94
101
|
validate?: (value: FieldValue, model: any) => boolean;
|
|
95
102
|
text?: TextFieldRole;
|
|
96
103
|
cascade?: CascadeAction;
|
|
104
|
+
visual: boolean;
|
|
97
105
|
modelRef: ConstantModelRef;
|
|
98
106
|
arrDepth: number;
|
|
99
107
|
optArrDepth: number;
|
|
@@ -139,6 +147,7 @@ export declare class ConstantField<FieldType extends ConstantFieldKind = Constan
|
|
|
139
147
|
readonly validate?: (value: FieldValue, model: any) => boolean;
|
|
140
148
|
readonly text?: TextFieldRole;
|
|
141
149
|
readonly cascade?: CascadeAction;
|
|
150
|
+
readonly visual: boolean;
|
|
142
151
|
readonly modelRef: ConstantModelRef;
|
|
143
152
|
readonly arrDepth: number;
|
|
144
153
|
readonly optArrDepth: number;
|
|
@@ -163,6 +172,13 @@ export declare class ConstantField<FieldType extends ConstantFieldKind = Constan
|
|
|
163
172
|
export interface FieldObject {
|
|
164
173
|
[key: string]: ConstantField;
|
|
165
174
|
}
|
|
175
|
+
/**
|
|
176
|
+
* `text` names a column in the plaintext search mirror, so a masked field carrying one would publish what it
|
|
177
|
+
* masks through search — the class build refuses it (`TextFieldPaths`). Removing the key from the option type
|
|
178
|
+
* moves that refusal to the call site, where the fix is obvious. Distributive because `FieldOption` is a union:
|
|
179
|
+
* a plain `Omit` over it would collapse to the keys the members share.
|
|
180
|
+
*/
|
|
181
|
+
type WithoutTextRole<Option> = Option extends unknown ? Omit<Option, "text"> : never;
|
|
166
182
|
type FieldOption<Value extends ConstantFieldTypeInput, MapValue = Value extends MapConstructor ? typeof PrimitiveScalar : never, Metadata extends {
|
|
167
183
|
[key: string]: any;
|
|
168
184
|
} = {
|
|
@@ -172,11 +188,12 @@ export type PlainTypeToFieldType<PlainType> = PlainType extends [infer First, ..
|
|
|
172
188
|
/** Builds a stored property field with optional validation, default, ref, text, and metadata options. */
|
|
173
189
|
export declare const field: {
|
|
174
190
|
<ExplicitType, Value extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, MapValue = Value extends MapConstructor ? typeof PrimitiveScalar : never>(value: Value, option?: FieldOption<Value, MapValue>): FieldInfo<"property", Value, ExplicitType, MapValue, FieldKindSource<Value>, UnCls<FieldKindSource<Value>> extends BaseObject ? true : false, FieldKindSource<Value> extends infer T ? T extends FieldKindSource<Value> ? T extends EnumInstance<string, any> ? true : false : never : never, FieldKindSource<Value> extends infer T_1 ? T_1 extends FieldKindSource<Value> ? T_1 extends typeof PrimitiveScalar ? true : false : never : never, FieldKindSource<Value> extends infer T_2 ? T_2 extends FieldKindSource<Value> ? T_2 extends MapConstructor ? true : false : never : never, (UnCls<FieldKindSource<Value>> extends BaseObject ? true : false) extends infer T_3 ? T_3 extends (UnCls<FieldKindSource<Value>> extends BaseObject ? true : false) ? T_3 extends true ? false : (FieldKindSource<Value> extends infer T_4 ? T_4 extends FieldKindSource<Value> ? T_4 extends EnumInstance<string, any> ? true : false : never : never) extends infer T_5 ? T_5 extends (FieldKindSource<Value> extends infer T_12 ? T_12 extends FieldKindSource<Value> ? T_12 extends EnumInstance<string, any> ? true : false : never : never) ? T_5 extends true ? false : (FieldKindSource<Value> extends infer T_6 ? T_6 extends FieldKindSource<Value> ? T_6 extends typeof PrimitiveScalar ? true : false : never : never) extends infer T_7 ? T_7 extends (FieldKindSource<Value> extends infer T_11 ? T_11 extends FieldKindSource<Value> ? T_11 extends typeof PrimitiveScalar ? true : false : never : never) ? T_7 extends true ? false : (FieldKindSource<Value> extends infer T_8 ? T_8 extends FieldKindSource<Value> ? T_8 extends MapConstructor ? true : false : never : never) extends infer T_9 ? T_9 extends (FieldKindSource<Value> extends infer T_10 ? T_10 extends FieldKindSource<Value> ? T_10 extends MapConstructor ? true : false : never : never) ? T_9 extends true ? false : true : never : never : never : never : never : never : never : never, false, false>;
|
|
175
|
-
|
|
176
|
-
|
|
191
|
+
visual<ExplicitType, Value extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, MapValue = Value extends MapConstructor ? typeof PrimitiveScalar : never>(value: Value, option?: FieldOption<Value, MapValue>): FieldInfo<"property", Value, ExplicitType, MapValue, FieldKindSource<Value>, UnCls<FieldKindSource<Value>> extends BaseObject ? true : false, FieldKindSource<Value> extends infer T ? T extends FieldKindSource<Value> ? T extends EnumInstance<string, any> ? true : false : never : never, FieldKindSource<Value> extends infer T_1 ? T_1 extends FieldKindSource<Value> ? T_1 extends typeof PrimitiveScalar ? true : false : never : never, FieldKindSource<Value> extends infer T_2 ? T_2 extends FieldKindSource<Value> ? T_2 extends MapConstructor ? true : false : never : never, (UnCls<FieldKindSource<Value>> extends BaseObject ? true : false) extends infer T_3 ? T_3 extends (UnCls<FieldKindSource<Value>> extends BaseObject ? true : false) ? T_3 extends true ? false : (FieldKindSource<Value> extends infer T_4 ? T_4 extends FieldKindSource<Value> ? T_4 extends EnumInstance<string, any> ? true : false : never : never) extends infer T_5 ? T_5 extends (FieldKindSource<Value> extends infer T_12 ? T_12 extends FieldKindSource<Value> ? T_12 extends EnumInstance<string, any> ? true : false : never : never) ? T_5 extends true ? false : (FieldKindSource<Value> extends infer T_6 ? T_6 extends FieldKindSource<Value> ? T_6 extends typeof PrimitiveScalar ? true : false : never : never) extends infer T_7 ? T_7 extends (FieldKindSource<Value> extends infer T_11 ? T_11 extends FieldKindSource<Value> ? T_11 extends typeof PrimitiveScalar ? true : false : never : never) ? T_7 extends true ? false : (FieldKindSource<Value> extends infer T_8 ? T_8 extends FieldKindSource<Value> ? T_8 extends MapConstructor ? true : false : never : never) extends infer T_9 ? T_9 extends (FieldKindSource<Value> extends infer T_10 ? T_10 extends FieldKindSource<Value> ? T_10 extends MapConstructor ? true : false : never : never) ? T_9 extends true ? false : true : never : never : never : never : never : never : never : never, false, false>;
|
|
192
|
+
hidden<ExplicitType, Value extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, MapValue = Value extends MapConstructor ? typeof PrimitiveScalar : never>(value: Value, option?: WithoutTextRole<FieldOption<Value, MapValue>>): FieldInfo<"hidden", Value, ExplicitType, MapValue, FieldKindSource<Value>, UnCls<FieldKindSource<Value>> extends BaseObject ? true : false, FieldKindSource<Value> extends infer T ? T extends FieldKindSource<Value> ? T extends EnumInstance<string, any> ? true : false : never : never, FieldKindSource<Value> extends infer T_1 ? T_1 extends FieldKindSource<Value> ? T_1 extends typeof PrimitiveScalar ? true : false : never : never, FieldKindSource<Value> extends infer T_2 ? T_2 extends FieldKindSource<Value> ? T_2 extends MapConstructor ? true : false : never : never, (UnCls<FieldKindSource<Value>> extends BaseObject ? true : false) extends infer T_3 ? T_3 extends (UnCls<FieldKindSource<Value>> extends BaseObject ? true : false) ? T_3 extends true ? false : (FieldKindSource<Value> extends infer T_4 ? T_4 extends FieldKindSource<Value> ? T_4 extends EnumInstance<string, any> ? true : false : never : never) extends infer T_5 ? T_5 extends (FieldKindSource<Value> extends infer T_12 ? T_12 extends FieldKindSource<Value> ? T_12 extends EnumInstance<string, any> ? true : false : never : never) ? T_5 extends true ? false : (FieldKindSource<Value> extends infer T_6 ? T_6 extends FieldKindSource<Value> ? T_6 extends typeof PrimitiveScalar ? true : false : never : never) extends infer T_7 ? T_7 extends (FieldKindSource<Value> extends infer T_11 ? T_11 extends FieldKindSource<Value> ? T_11 extends typeof PrimitiveScalar ? true : false : never : never) ? T_7 extends true ? false : (FieldKindSource<Value> extends infer T_8 ? T_8 extends FieldKindSource<Value> ? T_8 extends MapConstructor ? true : false : never : never) extends infer T_9 ? T_9 extends (FieldKindSource<Value> extends infer T_10 ? T_10 extends FieldKindSource<Value> ? T_10 extends MapConstructor ? true : false : never : never) ? T_9 extends true ? false : true : never : never : never : never : never : never : never : never, true, false>;
|
|
193
|
+
secret<ExplicitType, Value extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, MapValue = Value extends MapConstructor ? typeof PrimitiveScalar : never>(value: Value, option?: WithoutTextRole<FieldOption<Value, MapValue>>): FieldInfo<"secret", Value | null, ExplicitType | null, MapValue, SingleValue<Value> & {}, UnCls<SingleValue<Value> & {}> extends BaseObject ? true : false, SingleValue<Value> & {} extends infer T ? T extends SingleValue<Value> & {} ? T extends EnumInstance<string, any> ? true : false : never : never, SingleValue<Value> & {} extends infer T_1 ? T_1 extends SingleValue<Value> & {} ? T_1 extends typeof PrimitiveScalar ? true : false : never : never, SingleValue<Value> & {} extends infer T_2 ? T_2 extends SingleValue<Value> & {} ? T_2 extends MapConstructor ? true : false : never : never, (UnCls<SingleValue<Value> & {}> extends BaseObject ? true : false) extends infer T_3 ? T_3 extends (UnCls<SingleValue<Value> & {}> extends BaseObject ? true : false) ? T_3 extends true ? false : (SingleValue<Value> & {} extends infer T_4 ? T_4 extends SingleValue<Value> & {} ? T_4 extends EnumInstance<string, any> ? true : false : never : never) extends infer T_5 ? T_5 extends (SingleValue<Value> & {} extends infer T_12 ? T_12 extends SingleValue<Value> & {} ? T_12 extends EnumInstance<string, any> ? true : false : never : never) ? T_5 extends true ? false : (SingleValue<Value> & {} extends infer T_6 ? T_6 extends SingleValue<Value> & {} ? T_6 extends typeof PrimitiveScalar ? true : false : never : never) extends infer T_7 ? T_7 extends (SingleValue<Value> & {} extends infer T_11 ? T_11 extends SingleValue<Value> & {} ? T_11 extends typeof PrimitiveScalar ? true : false : never : never) ? T_7 extends true ? false : (SingleValue<Value> & {} extends infer T_8 ? T_8 extends SingleValue<Value> & {} ? T_8 extends MapConstructor ? true : false : never : never) extends infer T_9 ? T_9 extends (SingleValue<Value> & {} extends infer T_10 ? T_10 extends SingleValue<Value> & {} ? T_10 extends MapConstructor ? true : false : never : never) ? T_9 extends true ? false : true : never : never : never : never : never : never : never : never, false, true>;
|
|
177
194
|
};
|
|
178
195
|
/** Builds a resolved field that is derived rather than treated as a stored property. */
|
|
179
|
-
export declare const resolve: <ExplicitType, Value extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, MapValue = Value extends MapConstructor ? typeof PrimitiveScalar : never>(value: Value, option?: FieldOption<Value, MapValue
|
|
196
|
+
export declare const resolve: <ExplicitType, Value extends ConstantFieldTypeInput = PlainTypeToFieldType<ExplicitType>, MapValue = Value extends MapConstructor ? typeof PrimitiveScalar : never>(value: Value, option?: WithoutTextRole<FieldOption<Value, MapValue>>) => FieldInfo<"resolve", Value, ExplicitType, MapValue, FieldKindSource<Value>, UnCls<FieldKindSource<Value>> extends BaseObject ? true : false, FieldKindSource<Value> extends infer T ? T extends FieldKindSource<Value> ? T extends EnumInstance<string, any> ? true : false : never : never, FieldKindSource<Value> extends infer T_1 ? T_1 extends FieldKindSource<Value> ? T_1 extends typeof PrimitiveScalar ? true : false : never : never, FieldKindSource<Value> extends infer T_2 ? T_2 extends FieldKindSource<Value> ? T_2 extends MapConstructor ? true : false : never : never, (UnCls<FieldKindSource<Value>> extends BaseObject ? true : false) extends infer T_3 ? T_3 extends (UnCls<FieldKindSource<Value>> extends BaseObject ? true : false) ? T_3 extends true ? false : (FieldKindSource<Value> extends infer T_4 ? T_4 extends FieldKindSource<Value> ? T_4 extends EnumInstance<string, any> ? true : false : never : never) extends infer T_5 ? T_5 extends (FieldKindSource<Value> extends infer T_12 ? T_12 extends FieldKindSource<Value> ? T_12 extends EnumInstance<string, any> ? true : false : never : never) ? T_5 extends true ? false : (FieldKindSource<Value> extends infer T_6 ? T_6 extends FieldKindSource<Value> ? T_6 extends typeof PrimitiveScalar ? true : false : never : never) extends infer T_7 ? T_7 extends (FieldKindSource<Value> extends infer T_11 ? T_11 extends FieldKindSource<Value> ? T_11 extends typeof PrimitiveScalar ? true : false : never : never) ? T_7 extends true ? false : (FieldKindSource<Value> extends infer T_8 ? T_8 extends FieldKindSource<Value> ? T_8 extends MapConstructor ? true : false : never : never) extends infer T_9 ? T_9 extends (FieldKindSource<Value> extends infer T_10 ? T_10 extends FieldKindSource<Value> ? T_10 extends MapConstructor ? true : false : never : never) ? T_9 extends true ? false : true : never : never : never : never : never : never : never : never, false, false>;
|
|
180
197
|
export type FieldBuilder = typeof field;
|
|
181
198
|
export type FieldResolver = typeof resolve;
|
|
182
199
|
export {};
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The query a field's value stands for, declared on the field itself with `.meta(...)`. A summary counter is the
|
|
3
|
+
* case this exists for: `hau` is however many rows one filter returns, so the tile showing it can open that exact
|
|
4
|
+
* listing without the page restating the filter beside it.
|
|
5
|
+
*
|
|
6
|
+
* The shape is read structurally rather than by class, so an app declares it with whatever builder it already has.
|
|
7
|
+
*/
|
|
8
|
+
export interface FieldQueryMeta {
|
|
9
|
+
/** The model the query runs against. */
|
|
10
|
+
refName: string;
|
|
11
|
+
/** One of that model's declared filter keys. */
|
|
12
|
+
queryKey: string | null;
|
|
13
|
+
/** Read when the query is applied, so an arg relative to now — `() => [dayjs().subtract(1, "hour")]` — is current. */
|
|
14
|
+
queryArgs?: unknown[] | (() => unknown[]);
|
|
15
|
+
}
|
|
16
|
+
/** The query one field of `refName` names, or nothing when the model, the field, or the declaration is absent. */
|
|
17
|
+
export declare const fieldQueryMetaOf: (refName: string, field: string) => FieldQueryMeta | undefined;
|