@aigne/aos 0.2.0-beta

package/dist/index.d.mts

@@ -0,0 +1,68 @@
+import { AgentDslCompileError, AgentDslCompileResult, AgentManifest, AgentTool, compileAgentDsl, formatAgentDsl } from "./agent-dsl.mjs";
+import { ArcCompatibilityResult, ArcVersionRequirement, checkArcVersionCompatibility, compareSemver, normalizeArcVersionRequirement } from "./arc-compat.mjs";
+import { AutoSurfaceBindingMap, AutoSurfaceCompileResult, AutoSurfaceDefinitionOwner, AutoSurfaceDiagnostic, AutoSurfaceFragment, AutoSurfaceLayer, AutoSurfaceLoadedRegistry, AutoSurfaceOption, AutoSurfacePolicy, AutoSurfacePresentations, AutoSurfaceProjectedField, AutoSurfaceProjectedGroup, AutoSurfaceProjectedPage, AutoSurfaceProjectedSection, AutoSurfaceProjection, AutoSurfaceProjectorName, AutoSurfaceRegistry, AutoSurfaceRegistryEntry, AutoSurfaceResolvedRegistry, AutoSurfaceResolvedResource, AutoSurfaceResolvedScenario, AutoSurfaceResourceDefinition, AutoSurfaceSettingsShellPresentation, AutoSurfaceSettingsShellProjection, AutoSurfaceValidationRule, AutoSurfaceValueLayers, AutoSurfaceValueSource, AutoSurfaceValueType, normalizeAutoSurfaceScopes } from "./auto-surface/types.mjs";
+import { compileAutoSurfaceRegistry } from "./auto-surface/compiler.mjs";
+import { AutoSurfaceDefinitionDslCompileError, AutoSurfaceDefinitionDslCompileResult, AutoSurfaceDefinitionDslField, AutoSurfaceDefinitionDslGroup, AutoSurfaceDefinitionDslPage, AutoSurfaceDefinitionDslSection, compileAutoSurfaceDefinitionDsl, formatAutoSurfaceDefinitionDsl } from "./auto-surface/definition-dsl.mjs";
+import { AutoSurfaceFragmentReader, DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT, DEFAULT_AUTO_SURFACE_VALUES_ROOT, LoadAutoSurfaceFragmentOptions, LoadAutoSurfaceValueLayerOptions, loadAutoSurfaceFragment, loadAutoSurfaceValueLayer } from "./auto-surface/fragments.mjs";
+import { resolveAutoSurfaceValues } from "./auto-surface/layering.mjs";
+import { ProjectAutoSurfaceOptions, projectAutoSurface } from "./auto-surface/projection.mjs";
+import { ProjectSettingsShellOptions, projectSettingsShell } from "./auto-surface/projectors/settings-shell.mjs";
+import { AutoSurfaceDefinitionSource, AutoSurfaceValueLayerSource, LoadAutoSurfaceRegistryOptions, LoadAutoSurfaceValueLayersOptions, ResolveAutoSurfaceScenarioOptions, loadAutoSurfaceRegistry, loadAutoSurfaceValueLayers, resolveAutoSurfaceScenario } from "./auto-surface/scenario.mjs";
+import { AutoSurfaceValueDslCompileError, AutoSurfaceValueDslCompileResult, AutoSurfaceValueDslEntry, compileAutoSurfaceValueDsl, formatAutoSurfaceValueDsl } from "./auto-surface/value-dsl.mjs";
+import "./auto-surface/index.mjs";
+import { ActivatedBlocklet, ActivationHooks, BlockletCredentialStore, BlockletInfo, BlockletLoader, TriggerSpec } from "./blocklet/types.mjs";
+import { ActivateBlockletOptions, activateBlocklet, deactivateBlocklet } from "./blocklet/activation.mjs";
+import { AfsBlockletRegistryOptions, BlockletAfsReader, BlockletPattern, BlockletPatternCache, BlockletPatternKind, BlockletReader, BlockletRegistry, TERMINAL_INDEX_FILES, createAfsBlockletReader, createAfsBlockletRegistry, createMapBlockletReader, createPatternCache, createStaticBlockletRegistry, detectBlockletPattern, normalizeRel } from "./blocklet/registry.mjs";
+import { BLOCKLET_BUNDLE_PATH, BlockletResolveSource, DidSpaceBlockletRegistryDeps, createCompositeBlockletRegistry, createDidSpaceBlockletRegistry } from "./blocklet/did-space-registry.mjs";
+import { blockletDetailHandler, blockletListHandler } from "./blocklet/handlers.mjs";
+import { BlockletManifest, parseBlockletManifest } from "./blocklet/manifest.mjs";
+import { StaticRenderResult, guessContentType, isConventionalAssetPath, renderStaticBlocklet, serveBlockletAsset } from "./blocklet/static-render.mjs";
+import "./blocklet/index.mjs";
+import { MountConfig, MountEntry, ParseMountConfigResult, parseMountConfig } from "./mount-config.mjs";
+import { BUILTIN_CHAIN_NETWORKS, CHAIN_DEVICE_PREFIX, ChainNetworkConfig, chainNetworkToMountEntry, validateChainNetworks } from "./devices/chain.mjs";
+import { DslDeclaration, DslDeclarationSchema, DslField, DslToken, parseDeclaration, parseDslDeclaration, parseDslStringToken } from "./dsl-shared.mjs";
+import { BlockletScope, ResolveScopedAFSInput, ResolveScopedAFSResult, ScopeActivator } from "./scope/types.mjs";
+import { ResolveCallerFn, isControlPlaneAuthorized, mergeCallerContext } from "./http/auth-context.mjs";
+import { AfsRequestContext, AfsRequestContextOptions, ScopedRequest, createAfsRequestContext } from "./http/request-context.mjs";
+import { AfsMcpHandler, AfsMcpHandlerOptions, createAfsMcpHandler } from "./http/afs-mcp.mjs";
+import { AfsRawHandlerOptions, RAW_MAX_BYTES_DEFAULT, createAfsRawHandler } from "./http/afs-raw.mjs";
+import { AFSRestOptions, createAFSRestHandler } from "./http/afs-rest.mjs";
+import { BATCH_LIMITS_CF, BATCH_LIMITS_NODE, BatchDeleteWireEntry, BatchLimits, BatchReadWireEntry, BatchWriteWireEntry, RpcWriteBody, WIRE_ERROR_CODES, WireEncoding, WireValidation, decodeContentBase64, encodeContentBase64, parseBearerToken, readWriteIfMatch, validateAndDecodeWrite, validateBatchBody } from "./http/afs-rpc-wire.mjs";
+import { AfsRpcHandler, AfsRpcHandlerOptions, createAfsRpcHandler } from "./http/afs-rpc.mjs";
+import { AfsUploadHandler, AfsUploadHandlerOptions, UploadItem, createAfsUploadHandler } from "./http/afs-upload.mjs";
+import { MINIMAL_AUP_HTML, createAupClientResponder } from "./http/aup-client.mjs";
+import { AupEventHandler, AupEventHandlerOptions, createAupEventHandler } from "./http/aup-event.mjs";
+import { normalizeOrigin } from "./http/csrf.mjs";
+import { HealthConfig, InfoConfig, RouteDescriptor, apiHandler, healthHandler, infoHandler } from "./http/handlers.mjs";
+import "./http/index.mjs";
+import { BlockletPackageIdentity, CreateSettingsSchemaHandleOptions, SettingsSchemaHandle, SettingsSchemaStoreLike, createSettingsSchemaHandle } from "./session/settings-schema-store.mjs";
+import { SESSION_OVERLAY_PREFIXES, SessionUserAFS, assertOverlayOrder, createSessionView, isSessionPrivatePath } from "./session/session-user-afs.mjs";
+import { IssueRawUrlParams, RawUrlCryptoOptions, VerifyRawUrlResult, issueRawUrl, verifyRawUrl } from "./http/raw-url.mjs";
+import { ResolvedScaffoldApp, ResolvedScaffoldDefinition, ResolvedScaffoldFooterLink, ResolvedScaffoldHeaderAction, ResolvedScaffoldMenuGroup, ResolvedScaffoldMenuItem, ResolvedScaffoldModule, ResolvedScaffoldShell, ResolvedScaffoldSurface, ResolvedScaffoldSurfaces, ResolvedScaffoldTarget, ResolvedScaffoldWorkspaceDefinition, ResolvedScaffoldWorkspaceSection, ScaffoldAgentModuleBinding, ScaffoldAupModuleBinding, ScaffoldBlockletModuleBinding, ScaffoldCompositionDiagnostic, ScaffoldDefinition, ScaffoldDiagnostic, ScaffoldFooterDefinition, ScaffoldFooterLink, ScaffoldHeaderDefinition, ScaffoldManifest, ScaffoldMenuDefinition, ScaffoldMenuGroup, ScaffoldMenuItem, ScaffoldMenuPlacement, ScaffoldModuleBinding, ScaffoldModuleDefinition, ScaffoldModuleKind, ScaffoldProviderKind, ScaffoldShellAction, ScaffoldShellDefinition, ScaffoldSurfaceDefinition, ScaffoldSurfaceRuntimeDiagnostic, ScaffoldTargetKind, ScaffoldTargetRef, ScaffoldWebModuleBinding, ScaffoldWorkspaceAgentDefinition, ScaffoldWorkspaceDefinition, ScaffoldWorkspaceRailItem, ScaffoldWorkspaceRoot, ScaffoldWorkspaceSection } from "./scaffold/types.mjs";
+import { DEFAULT_SCAFFOLD_ROOT, LoadScaffoldDefinitionOptions, ScaffoldAfsReader, loadScaffoldDefinition } from "./scaffold/afs.mjs";
+import { ComposeScaffoldAppOptions, composeScaffoldApp } from "./scaffold/composition.mjs";
+import { ScaffoldDslCompileError, scaffoldDslParseError } from "./scaffold/dsl-error.mjs";
+import { compileManifestDsl, formatManifestDsl } from "./scaffold/manifest-dsl.mjs";
+import { compileModuleDsl, formatModuleDsl } from "./scaffold/module-dsl.mjs";
+import { resolveScaffoldDefinition } from "./scaffold/resolver.mjs";
+import { ResolveScaffoldAutoSurfaceOptions, ResolveScaffoldSurfacesOptions, resolveScaffoldSurface, resolveScaffoldSurfaces } from "./scaffold/surfaces.mjs";
+import { ResolveScaffoldAppOptions, ResolvedScaffoldRuntime, resolveScaffoldApp } from "./scaffold/runtime.mjs";
+import { compileShellDsl, formatShellDsl } from "./scaffold/shell-dsl.mjs";
+import { compileSurfaceDsl, formatSurfaceDsl } from "./scaffold/surface-dsl.mjs";
+import { WorkspaceManifest, WorkspaceManifestAgent, WorkspaceManifestRoot, compileWorkspaceDsl, formatWorkspaceDsl, validateWorkspaceManifest, workspaceManifestFromDefinition } from "./scaffold/workspace-dsl.mjs";
+import "./scaffold/index.mjs";
+import { readBlockletScope } from "./scope/read-blocklet-scope.mjs";
+import { resolveScopedAFS } from "./scope/resolve-scoped-afs.mjs";
+import "./scope/index.mjs";
+import { createSessionTmpBackend, createUserDataBackend, createUserSpaceRootBackend } from "./session/backends.mjs";
+import { SettingsResolver, SettingsResolverOptions, SettingsScope } from "./session/settings-resolver.mjs";
+import { ReplicationResolver, ReplicationResolverOptions } from "./session/replication-resolver.mjs";
+import { compareRole, roleLevel } from "./session/role-level.mjs";
+import { createBlockletStateProvider, createSessionMessagesProvider, createSessionMetaProvider, createSessionStateProvider } from "./session/session-dir-providers.mjs";
+import { isValidSessionId } from "./session/session-id.mjs";
+import { EffectiveField, InstanceOverrideOnly, PackageFieldSchema, SettingsCascadeScope, UserOverrideOnly, cascade } from "./session/settings-cascade.mjs";
+import { LlmTerminalOptions, LlmTerminalResult, LlmTerminalSession, createLlmTerminalSession } from "./terminal-llm.mjs";
+import { AfsReplOptions, AfsReplResult, AfsReplSession, BannerOptions, createAfsReplSession, renderArcBanner } from "./terminal-repl.mjs";
+import { IDLE_CLOSE_CODE, IDLE_CLOSE_REASON, IdleCloseTarget, IdleTimer, IdleTimerOptions, attachIdleClose, createIdleTimer, resolveIdleTimeoutMs } from "./transport/idle-timer.mjs";
+import { WebComponentDslCompileError, WebComponentDslCompileResult, WebComponentManifest, WebComponentPropManifest, compileWebComponentDsl, formatWebComponentDsl } from "./web-component-dsl.mjs";
+export { type AFSRestOptions, type ActivateBlockletOptions, type ActivatedBlocklet, type ActivationHooks, type AfsBlockletRegistryOptions, type AfsMcpHandler, type AfsMcpHandlerOptions, type AfsRawHandlerOptions, type AfsReplOptions, type AfsReplResult, type AfsReplSession, type AfsRequestContext, type AfsRequestContextOptions, type AfsRpcHandler, type AfsRpcHandlerOptions, type AfsUploadHandler, type AfsUploadHandlerOptions, AgentDslCompileError, type AgentDslCompileResult, type AgentManifest, type AgentTool, type ArcCompatibilityResult, type ArcVersionRequirement, type AupEventHandler, type AupEventHandlerOptions, type AutoSurfaceBindingMap, type AutoSurfaceCompileResult, AutoSurfaceDefinitionDslCompileError, type AutoSurfaceDefinitionDslCompileResult, type AutoSurfaceDefinitionDslField, type AutoSurfaceDefinitionDslGroup, type AutoSurfaceDefinitionDslPage, type AutoSurfaceDefinitionDslSection, type AutoSurfaceDefinitionOwner, type AutoSurfaceDefinitionSource, type AutoSurfaceDiagnostic, type AutoSurfaceFragment, type AutoSurfaceFragmentReader, type AutoSurfaceLayer, type AutoSurfaceLoadedRegistry, type AutoSurfaceOption, type AutoSurfacePolicy, type AutoSurfacePresentations, type AutoSurfaceProjectedField, type AutoSurfaceProjectedGroup, type AutoSurfaceProjectedPage, type AutoSurfaceProjectedSection, type AutoSurfaceProjection, type AutoSurfaceProjectorName, type AutoSurfaceRegistry, type AutoSurfaceRegistryEntry, type AutoSurfaceResolvedRegistry, type AutoSurfaceResolvedResource, type AutoSurfaceResolvedScenario, type AutoSurfaceResourceDefinition, type AutoSurfaceSettingsShellPresentation, type AutoSurfaceSettingsShellProjection, type AutoSurfaceValidationRule, AutoSurfaceValueDslCompileError, type AutoSurfaceValueDslCompileResult, type AutoSurfaceValueDslEntry, type AutoSurfaceValueLayerSource, type AutoSurfaceValueLayers, type AutoSurfaceValueSource, type AutoSurfaceValueType, BATCH_LIMITS_CF, BATCH_LIMITS_NODE, BLOCKLET_BUNDLE_PATH, BUILTIN_CHAIN_NETWORKS, type BannerOptions, type BatchDeleteWireEntry, type BatchLimits, type BatchReadWireEntry, type BatchWriteWireEntry, type BlockletAfsReader, type BlockletCredentialStore, type BlockletInfo, type BlockletLoader, type BlockletManifest, type BlockletPackageIdentity, type BlockletPattern, type BlockletPatternCache, type BlockletPatternKind, type BlockletReader, type BlockletRegistry, type BlockletResolveSource, type BlockletScope, CHAIN_DEVICE_PREFIX, type ChainNetworkConfig, type ComposeScaffoldAppOptions, type CreateSettingsSchemaHandleOptions, DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT, DEFAULT_AUTO_SURFACE_VALUES_ROOT, DEFAULT_SCAFFOLD_ROOT, type DidSpaceBlockletRegistryDeps, type DslDeclaration, type DslDeclarationSchema, type DslField, type DslToken, type EffectiveField, type HealthConfig, IDLE_CLOSE_CODE, IDLE_CLOSE_REASON, type IdleCloseTarget, type IdleTimer, type IdleTimerOptions, type InfoConfig, type InstanceOverrideOnly, type IssueRawUrlParams, type LlmTerminalOptions, type LlmTerminalResult, type LlmTerminalSession, type LoadAutoSurfaceFragmentOptions, type LoadAutoSurfaceRegistryOptions, type LoadAutoSurfaceValueLayerOptions, type LoadAutoSurfaceValueLayersOptions, type LoadScaffoldDefinitionOptions, MINIMAL_AUP_HTML, type MountConfig, type MountEntry, type PackageFieldSchema, type ParseMountConfigResult, type ProjectAutoSurfaceOptions, type ProjectSettingsShellOptions, RAW_MAX_BYTES_DEFAULT, type RawUrlCryptoOptions, ReplicationResolver, type ReplicationResolverOptions, type ResolveAutoSurfaceScenarioOptions, type ResolveCallerFn, type ResolveScaffoldAppOptions, type ResolveScaffoldAutoSurfaceOptions, type ResolveScaffoldSurfacesOptions, type ResolveScopedAFSInput, type ResolveScopedAFSResult, type ResolvedScaffoldApp, type ResolvedScaffoldDefinition, type ResolvedScaffoldFooterLink, type ResolvedScaffoldHeaderAction, type ResolvedScaffoldMenuGroup, type ResolvedScaffoldMenuItem, type ResolvedScaffoldModule, type ResolvedScaffoldRuntime, type ResolvedScaffoldShell, type ResolvedScaffoldSurface, type ResolvedScaffoldSurfaces, type ResolvedScaffoldTarget, type ResolvedScaffoldWorkspaceDefinition, type ResolvedScaffoldWorkspaceSection, type RouteDescriptor, type RpcWriteBody, SESSION_OVERLAY_PREFIXES, type ScaffoldAfsReader, type ScaffoldAgentModuleBinding, type ScaffoldAupModuleBinding, type ScaffoldBlockletModuleBinding, type ScaffoldCompositionDiagnostic, type ScaffoldDefinition, type ScaffoldDiagnostic, ScaffoldDslCompileError, type ScaffoldFooterDefinition, type ScaffoldFooterLink, type ScaffoldHeaderDefinition, type ScaffoldManifest, type ScaffoldMenuDefinition, type ScaffoldMenuGroup, type ScaffoldMenuItem, type ScaffoldMenuPlacement, type ScaffoldModuleBinding, type ScaffoldModuleDefinition, type ScaffoldModuleKind, type ScaffoldProviderKind, type ScaffoldShellAction, type ScaffoldShellDefinition, type ScaffoldSurfaceDefinition, type ScaffoldSurfaceRuntimeDiagnostic, type ScaffoldTargetKind, type ScaffoldTargetRef, type ScaffoldWebModuleBinding, type ScaffoldWorkspaceAgentDefinition, type ScaffoldWorkspaceDefinition, type ScaffoldWorkspaceRailItem, type ScaffoldWorkspaceRoot, type ScaffoldWorkspaceSection, type ScopeActivator, type ScopedRequest, SessionUserAFS, type SettingsCascadeScope, SettingsResolver, type SettingsResolverOptions, type SettingsSchemaHandle, type SettingsSchemaStoreLike, type SettingsScope, type StaticRenderResult, TERMINAL_INDEX_FILES, type TriggerSpec, type UploadItem, type UserOverrideOnly, type VerifyRawUrlResult, WIRE_ERROR_CODES, WebComponentDslCompileError, type WebComponentDslCompileResult, type WebComponentManifest, type WebComponentPropManifest, type WireEncoding, type WireValidation, type WorkspaceManifest, type WorkspaceManifestAgent, type WorkspaceManifestRoot, activateBlocklet, apiHandler, assertOverlayOrder, attachIdleClose, blockletDetailHandler, blockletListHandler, cascade, chainNetworkToMountEntry, checkArcVersionCompatibility, compareRole, compareSemver, compileAgentDsl, compileAutoSurfaceDefinitionDsl, compileAutoSurfaceRegistry, compileAutoSurfaceValueDsl, compileManifestDsl, compileModuleDsl, compileShellDsl, compileSurfaceDsl, compileWebComponentDsl, compileWorkspaceDsl, composeScaffoldApp, createAFSRestHandler, createAfsBlockletReader, createAfsBlockletRegistry, createAfsMcpHandler, createAfsRawHandler, createAfsReplSession, createAfsRequestContext, createAfsRpcHandler, createAfsUploadHandler, createAupClientResponder, createAupEventHandler, createBlockletStateProvider, createCompositeBlockletRegistry, createDidSpaceBlockletRegistry, createIdleTimer, createLlmTerminalSession, createMapBlockletReader, createPatternCache, createSessionMessagesProvider, createSessionMetaProvider, createSessionStateProvider, createSessionTmpBackend, createSessionView, createSettingsSchemaHandle, createStaticBlockletRegistry, createUserDataBackend, createUserSpaceRootBackend, deactivateBlocklet, decodeContentBase64, detectBlockletPattern, encodeContentBase64, formatAgentDsl, formatAutoSurfaceDefinitionDsl, formatAutoSurfaceValueDsl, formatManifestDsl, formatModuleDsl, formatShellDsl, formatSurfaceDsl, formatWebComponentDsl, formatWorkspaceDsl, guessContentType, healthHandler, infoHandler, isControlPlaneAuthorized, isConventionalAssetPath, isSessionPrivatePath, isValidSessionId, issueRawUrl, loadAutoSurfaceFragment, loadAutoSurfaceRegistry, loadAutoSurfaceValueLayer, loadAutoSurfaceValueLayers, loadScaffoldDefinition, mergeCallerContext, normalizeArcVersionRequirement, normalizeAutoSurfaceScopes, normalizeOrigin, normalizeRel, parseBearerToken, parseBlockletManifest, parseDeclaration, parseDslDeclaration, parseDslStringToken, parseMountConfig, projectAutoSurface, projectSettingsShell, readBlockletScope, readWriteIfMatch, renderArcBanner, renderStaticBlocklet, resolveAutoSurfaceScenario, resolveAutoSurfaceValues, resolveIdleTimeoutMs, resolveScaffoldApp, resolveScaffoldDefinition, resolveScaffoldSurface, resolveScaffoldSurfaces, resolveScopedAFS, roleLevel, scaffoldDslParseError, serveBlockletAsset, validateAndDecodeWrite, validateBatchBody, validateChainNetworks, validateWorkspaceManifest, verifyRawUrl, workspaceManifestFromDefinition };

package/dist/index.mjs

@@ -0,0 +1,61 @@
+import { parseDeclaration, parseDslDeclaration, parseDslStringToken } from "./dsl-shared.mjs";
+import { AgentDslCompileError, compileAgentDsl, formatAgentDsl } from "./agent-dsl.mjs";
+import { checkArcVersionCompatibility, compareSemver, normalizeArcVersionRequirement } from "./arc-compat.mjs";
+import { normalizeAutoSurfaceScopes } from "./auto-surface/types.mjs";
+import { compileAutoSurfaceRegistry } from "./auto-surface/compiler.mjs";
+import { AutoSurfaceDefinitionDslCompileError, compileAutoSurfaceDefinitionDsl, formatAutoSurfaceDefinitionDsl } from "./auto-surface/definition-dsl.mjs";
+import { DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT, DEFAULT_AUTO_SURFACE_VALUES_ROOT, loadAutoSurfaceFragment, loadAutoSurfaceValueLayer } from "./auto-surface/fragments.mjs";
+import { resolveAutoSurfaceValues } from "./auto-surface/layering.mjs";
+import { projectSettingsShell } from "./auto-surface/projectors/settings-shell.mjs";
+import { projectAutoSurface } from "./auto-surface/projection.mjs";
+import { loadAutoSurfaceRegistry, loadAutoSurfaceValueLayers, resolveAutoSurfaceScenario } from "./auto-surface/scenario.mjs";
+import { AutoSurfaceValueDslCompileError, compileAutoSurfaceValueDsl, formatAutoSurfaceValueDsl } from "./auto-surface/value-dsl.mjs";
+import { activateBlocklet, deactivateBlocklet } from "./blocklet/activation.mjs";
+import { TERMINAL_INDEX_FILES, createAfsBlockletReader, createAfsBlockletRegistry, createMapBlockletReader, createPatternCache, createStaticBlockletRegistry, detectBlockletPattern, normalizeRel } from "./blocklet/registry.mjs";
+import { BLOCKLET_BUNDLE_PATH, createCompositeBlockletRegistry, createDidSpaceBlockletRegistry } from "./blocklet/did-space-registry.mjs";
+import { blockletDetailHandler, blockletListHandler } from "./blocklet/handlers.mjs";
+import { parseBlockletManifest } from "./blocklet/manifest.mjs";
+import { guessContentType, isConventionalAssetPath, renderStaticBlocklet, serveBlockletAsset } from "./blocklet/static-render.mjs";
+import { BUILTIN_CHAIN_NETWORKS, CHAIN_DEVICE_PREFIX, chainNetworkToMountEntry, validateChainNetworks } from "./devices/chain.mjs";
+import { compareRole, roleLevel } from "./session/role-level.mjs";
+import { isControlPlaneAuthorized, mergeCallerContext } from "./http/auth-context.mjs";
+import { readBlockletScope } from "./scope/read-blocklet-scope.mjs";
+import { createAfsRequestContext } from "./http/request-context.mjs";
+import { createAfsMcpHandler } from "./http/afs-mcp.mjs";
+import { BATCH_LIMITS_CF, BATCH_LIMITS_NODE, WIRE_ERROR_CODES, decodeContentBase64, encodeContentBase64, parseBearerToken, readWriteIfMatch, validateAndDecodeWrite, validateBatchBody } from "./http/afs-rpc-wire.mjs";
+import { normalizeOrigin } from "./http/csrf.mjs";
+import { createAfsRpcHandler } from "./http/afs-rpc.mjs";
+import { ReplicationResolver } from "./session/replication-resolver.mjs";
+import { cascade } from "./session/settings-cascade.mjs";
+import { SettingsResolver } from "./session/settings-resolver.mjs";
+import { SESSION_OVERLAY_PREFIXES, SessionUserAFS, assertOverlayOrder, createSessionView, isSessionPrivatePath } from "./session/session-user-afs.mjs";
+import { issueRawUrl, verifyRawUrl } from "./http/raw-url.mjs";
+import { RAW_MAX_BYTES_DEFAULT, createAfsRawHandler } from "./http/afs-raw.mjs";
+import { createAFSRestHandler } from "./http/afs-rest.mjs";
+import { createAfsUploadHandler } from "./http/afs-upload.mjs";
+import { MINIMAL_AUP_HTML, createAupClientResponder } from "./http/aup-client.mjs";
+import { createAupEventHandler } from "./http/aup-event.mjs";
+import { apiHandler, healthHandler, infoHandler } from "./http/handlers.mjs";
+import { parseMountConfig } from "./mount-config.mjs";
+import { ScaffoldDslCompileError, scaffoldDslParseError } from "./scaffold/dsl-error.mjs";
+import { compileManifestDsl, formatManifestDsl } from "./scaffold/manifest-dsl.mjs";
+import { compileModuleDsl, formatModuleDsl } from "./scaffold/module-dsl.mjs";
+import { compileShellDsl, formatShellDsl } from "./scaffold/shell-dsl.mjs";
+import { compileSurfaceDsl, formatSurfaceDsl } from "./scaffold/surface-dsl.mjs";
+import { compileWorkspaceDsl, formatWorkspaceDsl, validateWorkspaceManifest, workspaceManifestFromDefinition } from "./scaffold/workspace-dsl.mjs";
+import { DEFAULT_SCAFFOLD_ROOT, loadScaffoldDefinition } from "./scaffold/afs.mjs";
+import { composeScaffoldApp } from "./scaffold/composition.mjs";
+import { resolveScaffoldDefinition } from "./scaffold/resolver.mjs";
+import { resolveScaffoldSurface, resolveScaffoldSurfaces } from "./scaffold/surfaces.mjs";
+import { resolveScaffoldApp } from "./scaffold/runtime.mjs";
+import { resolveScopedAFS } from "./scope/resolve-scoped-afs.mjs";
+import { isValidSessionId } from "./session/session-id.mjs";
+import { createSessionTmpBackend, createUserDataBackend, createUserSpaceRootBackend } from "./session/backends.mjs";
+import { createBlockletStateProvider, createSessionMessagesProvider, createSessionMetaProvider, createSessionStateProvider } from "./session/session-dir-providers.mjs";
+import { createSettingsSchemaHandle } from "./session/settings-schema-store.mjs";
+import { createLlmTerminalSession } from "./terminal-llm.mjs";
+import { createAfsReplSession, renderArcBanner } from "./terminal-repl.mjs";
+import { IDLE_CLOSE_CODE, IDLE_CLOSE_REASON, attachIdleClose, createIdleTimer, resolveIdleTimeoutMs } from "./transport/idle-timer.mjs";
+import { WebComponentDslCompileError, compileWebComponentDsl, formatWebComponentDsl } from "./web-component-dsl.mjs";
+
+export { AgentDslCompileError, AutoSurfaceDefinitionDslCompileError, AutoSurfaceValueDslCompileError, BATCH_LIMITS_CF, BATCH_LIMITS_NODE, BLOCKLET_BUNDLE_PATH, BUILTIN_CHAIN_NETWORKS, CHAIN_DEVICE_PREFIX, DEFAULT_AUTO_SURFACE_DEFINITIONS_ROOT, DEFAULT_AUTO_SURFACE_VALUES_ROOT, DEFAULT_SCAFFOLD_ROOT, IDLE_CLOSE_CODE, IDLE_CLOSE_REASON, MINIMAL_AUP_HTML, RAW_MAX_BYTES_DEFAULT, ReplicationResolver, SESSION_OVERLAY_PREFIXES, ScaffoldDslCompileError, SessionUserAFS, SettingsResolver, TERMINAL_INDEX_FILES, WIRE_ERROR_CODES, WebComponentDslCompileError, activateBlocklet, apiHandler, assertOverlayOrder, attachIdleClose, blockletDetailHandler, blockletListHandler, cascade, chainNetworkToMountEntry, checkArcVersionCompatibility, compareRole, compareSemver, compileAgentDsl, compileAutoSurfaceDefinitionDsl, compileAutoSurfaceRegistry, compileAutoSurfaceValueDsl, compileManifestDsl, compileModuleDsl, compileShellDsl, compileSurfaceDsl, compileWebComponentDsl, compileWorkspaceDsl, composeScaffoldApp, createAFSRestHandler, createAfsBlockletReader, createAfsBlockletRegistry, createAfsMcpHandler, createAfsRawHandler, createAfsReplSession, createAfsRequestContext, createAfsRpcHandler, createAfsUploadHandler, createAupClientResponder, createAupEventHandler, createBlockletStateProvider, createCompositeBlockletRegistry, createDidSpaceBlockletRegistry, createIdleTimer, createLlmTerminalSession, createMapBlockletReader, createPatternCache, createSessionMessagesProvider, createSessionMetaProvider, createSessionStateProvider, createSessionTmpBackend, createSessionView, createSettingsSchemaHandle, createStaticBlockletRegistry, createUserDataBackend, createUserSpaceRootBackend, deactivateBlocklet, decodeContentBase64, detectBlockletPattern, encodeContentBase64, formatAgentDsl, formatAutoSurfaceDefinitionDsl, formatAutoSurfaceValueDsl, formatManifestDsl, formatModuleDsl, formatShellDsl, formatSurfaceDsl, formatWebComponentDsl, formatWorkspaceDsl, guessContentType, healthHandler, infoHandler, isControlPlaneAuthorized, isConventionalAssetPath, isSessionPrivatePath, isValidSessionId, issueRawUrl, loadAutoSurfaceFragment, loadAutoSurfaceRegistry, loadAutoSurfaceValueLayer, loadAutoSurfaceValueLayers, loadScaffoldDefinition, mergeCallerContext, normalizeArcVersionRequirement, normalizeAutoSurfaceScopes, normalizeOrigin, normalizeRel, parseBearerToken, parseBlockletManifest, parseDeclaration, parseDslDeclaration, parseDslStringToken, parseMountConfig, projectAutoSurface, projectSettingsShell, readBlockletScope, readWriteIfMatch, renderArcBanner, renderStaticBlocklet, resolveAutoSurfaceScenario, resolveAutoSurfaceValues, resolveIdleTimeoutMs, resolveScaffoldApp, resolveScaffoldDefinition, resolveScaffoldSurface, resolveScaffoldSurfaces, resolveScopedAFS, roleLevel, scaffoldDslParseError, serveBlockletAsset, validateAndDecodeWrite, validateBatchBody, validateChainNetworks, validateWorkspaceManifest, verifyRawUrl, workspaceManifestFromDefinition };

package/dist/mcp/index.cjs

@@ -0,0 +1,9 @@
+const require_prompts = require('./prompts.cjs');
+const require_resources = require('./resources.cjs');
+const require_tools = require('./tools.cjs');
+const require_server = require('./server.cjs');
+
+exports.createArcMcpServer = require_server.createArcMcpServer;
+exports.registerAfsPrompts = require_prompts.registerAfsPrompts;
+exports.registerAfsResources = require_resources.registerAfsResources;
+exports.registerAfsTools = require_tools.registerAfsTools;

package/dist/mcp/index.d.cts

@@ -0,0 +1,5 @@
+import { registerAfsPrompts } from "./prompts.cjs";
+import { registerAfsResources } from "./resources.cjs";
+import { CreateArcMcpServerOptions, createArcMcpServer } from "./server.cjs";
+import { registerAfsTools } from "./tools.cjs";
+export { type CreateArcMcpServerOptions, createArcMcpServer, registerAfsPrompts, registerAfsResources, registerAfsTools };

package/dist/mcp/index.d.mts

@@ -0,0 +1,5 @@
+import { registerAfsPrompts } from "./prompts.mjs";
+import { registerAfsResources } from "./resources.mjs";
+import { CreateArcMcpServerOptions, createArcMcpServer } from "./server.mjs";
+import { registerAfsTools } from "./tools.mjs";
+export { type CreateArcMcpServerOptions, createArcMcpServer, registerAfsPrompts, registerAfsResources, registerAfsTools };

package/dist/mcp/index.mjs

@@ -0,0 +1,6 @@
+import { registerAfsPrompts } from "./prompts.mjs";
+import { registerAfsResources } from "./resources.mjs";
+import { registerAfsTools } from "./tools.mjs";
+import { createArcMcpServer } from "./server.mjs";
+
+export { createArcMcpServer, registerAfsPrompts, registerAfsResources, registerAfsTools };

package/dist/mcp/prompts.cjs

@@ -0,0 +1,17 @@
+
+//#region src/mcp/prompts.ts
+function registerAfsPrompts(server, afs) {
+	server.prompt("explore", "Explore the AFS virtual filesystem", async () => {
+		const list = afs.getMounts().map((m) => `  - ${m.path} (${m.module.name}, ${m.module.accessMode ?? "readonly"})`);
+		return { messages: [{
+			role: "user",
+			content: {
+				type: "text",
+				text: `# AFS Explorer Guide\n\nAFS provides a unified interface to access various data sources.\n\n## Available Tools\n\n- **afs_list** — List directory contents\n- **afs_read** — Read content\n- **afs_stat** — Get metadata\n- **afs_search** — Search content\n- **afs_explain** — Get explanation\n- **afs_write** — Write content\n- **afs_delete** — Delete files\n- **afs_exec** — Execute actions\n\n${list.length > 0 ? `## Current Mounts\n\n${list.join("\n")}` : "## Current Mounts\n\nNo providers currently mounted."}`
+			}
+		}] };
+	});
+}
+
+//#endregion
+exports.registerAfsPrompts = registerAfsPrompts;

package/dist/mcp/prompts.d.cts

@@ -0,0 +1,8 @@
+import { AFS } from "@aigne/afs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/mcp/prompts.d.ts
+declare function registerAfsPrompts(server: McpServer, afs: AFS): void;
+//#endregion
+export { registerAfsPrompts };
+//# sourceMappingURL=prompts.d.cts.map

package/dist/mcp/prompts.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.cts","names":[],"sources":["../../src/mcp/prompts.ts"],"mappings":";;;;iBAEgB,kBAAA,CAAmB,MAAA,EAAQ,SAAA,EAAW,GAAA,EAAK,GAAA"}

package/dist/mcp/prompts.d.mts

@@ -0,0 +1,8 @@
+import { AFS } from "@aigne/afs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/mcp/prompts.d.ts
+declare function registerAfsPrompts(server: McpServer, afs: AFS): void;
+//#endregion
+export { registerAfsPrompts };
+//# sourceMappingURL=prompts.d.mts.map

package/dist/mcp/prompts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.mts","names":[],"sources":["../../src/mcp/prompts.ts"],"mappings":";;;;iBAEgB,kBAAA,CAAmB,MAAA,EAAQ,SAAA,EAAW,GAAA,EAAK,GAAA"}

package/dist/mcp/prompts.mjs

@@ -0,0 +1,17 @@
+//#region src/mcp/prompts.ts
+function registerAfsPrompts(server, afs) {
+	server.prompt("explore", "Explore the AFS virtual filesystem", async () => {
+		const list = afs.getMounts().map((m) => `  - ${m.path} (${m.module.name}, ${m.module.accessMode ?? "readonly"})`);
+		return { messages: [{
+			role: "user",
+			content: {
+				type: "text",
+				text: `# AFS Explorer Guide\n\nAFS provides a unified interface to access various data sources.\n\n## Available Tools\n\n- **afs_list** — List directory contents\n- **afs_read** — Read content\n- **afs_stat** — Get metadata\n- **afs_search** — Search content\n- **afs_explain** — Get explanation\n- **afs_write** — Write content\n- **afs_delete** — Delete files\n- **afs_exec** — Execute actions\n\n${list.length > 0 ? `## Current Mounts\n\n${list.join("\n")}` : "## Current Mounts\n\nNo providers currently mounted."}`
+			}
+		}] };
+	});
+}
+
+//#endregion
+export { registerAfsPrompts };
+//# sourceMappingURL=prompts.mjs.map

package/dist/mcp/prompts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.mjs","names":[],"sources":["../../src/mcp/prompts.ts"],"sourcesContent":["import type { AFS } from \"@aigne/afs\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nexport function registerAfsPrompts(server: McpServer, afs: AFS): void {\n  server.prompt(\"explore\", \"Explore the AFS virtual filesystem\", async () => {\n    const mounts = afs.getMounts();\n    const list = mounts.map(\n      (m) => `  - ${m.path} (${m.module.name}, ${m.module.accessMode ?? \"readonly\"})`,\n    );\n    const section =\n      list.length > 0\n        ? `## Current Mounts\\n\\n${list.join(\"\\n\")}`\n        : \"## Current Mounts\\n\\nNo providers currently mounted.\";\n    const guide = `# AFS Explorer Guide\\n\\nAFS provides a unified interface to access various data sources.\\n\\n## Available Tools\\n\\n- **afs_list** — List directory contents\\n- **afs_read** — Read content\\n- **afs_stat** — Get metadata\\n- **afs_search** — Search content\\n- **afs_explain** — Get explanation\\n- **afs_write** — Write content\\n- **afs_delete** — Delete files\\n- **afs_exec** — Execute actions\\n\\n${section}`;\n    return {\n      messages: [{ role: \"user\" as const, content: { type: \"text\" as const, text: guide } }],\n    };\n  });\n}\n"],"mappings":";AAEA,SAAgB,mBAAmB,QAAmB,KAAgB;AACpE,QAAO,OAAO,WAAW,sCAAsC,YAAY;EAEzE,MAAM,OADS,IAAI,WAAW,CACV,KACjB,MAAM,OAAO,EAAE,KAAK,IAAI,EAAE,OAAO,KAAK,IAAI,EAAE,OAAO,cAAc,WAAW,GAC9E;AAMD,SAAO,EACL,UAAU,CAAC;GAAE,MAAM;GAAiB,SAAS;IAAE,MAAM;IAAiB,MAF1D,2YAHZ,KAAK,SAAS,IACV,wBAAwB,KAAK,KAAK,KAAK,KACvC;IAG+E;GAAE,CAAC,EACvF;GACD"}

package/dist/mcp/resources.cjs

@@ -0,0 +1,22 @@
+
+//#region src/mcp/resources.ts
+function registerAfsResources(server, afs) {
+	server.resource("mounts", "afs:///mounts", {
+		description: "List of all mounted AFS providers",
+		mimeType: "application/json"
+	}, async () => {
+		const mounts = afs.getMounts();
+		return { contents: [{
+			uri: "afs:///mounts",
+			mimeType: "application/json",
+			text: JSON.stringify(mounts.map((m) => ({
+				path: m.path,
+				name: m.module.name,
+				accessMode: m.module.accessMode ?? "readonly"
+			})), null, 2)
+		}] };
+	});
+}
+
+//#endregion
+exports.registerAfsResources = registerAfsResources;

package/dist/mcp/resources.d.cts

@@ -0,0 +1,8 @@
+import { AFS } from "@aigne/afs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/mcp/resources.d.ts
+declare function registerAfsResources(server: McpServer, afs: AFS): void;
+//#endregion
+export { registerAfsResources };
+//# sourceMappingURL=resources.d.cts.map

package/dist/mcp/resources.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.cts","names":[],"sources":["../../src/mcp/resources.ts"],"mappings":";;;;iBAEgB,oBAAA,CAAqB,MAAA,EAAQ,SAAA,EAAW,GAAA,EAAK,GAAA"}

package/dist/mcp/resources.d.mts

@@ -0,0 +1,8 @@
+import { AFS } from "@aigne/afs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/mcp/resources.d.ts
+declare function registerAfsResources(server: McpServer, afs: AFS): void;
+//#endregion
+export { registerAfsResources };
+//# sourceMappingURL=resources.d.mts.map

package/dist/mcp/resources.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.mts","names":[],"sources":["../../src/mcp/resources.ts"],"mappings":";;;;iBAEgB,oBAAA,CAAqB,MAAA,EAAQ,SAAA,EAAW,GAAA,EAAK,GAAA"}

package/dist/mcp/resources.mjs

@@ -0,0 +1,22 @@
+//#region src/mcp/resources.ts
+function registerAfsResources(server, afs) {
+	server.resource("mounts", "afs:///mounts", {
+		description: "List of all mounted AFS providers",
+		mimeType: "application/json"
+	}, async () => {
+		const mounts = afs.getMounts();
+		return { contents: [{
+			uri: "afs:///mounts",
+			mimeType: "application/json",
+			text: JSON.stringify(mounts.map((m) => ({
+				path: m.path,
+				name: m.module.name,
+				accessMode: m.module.accessMode ?? "readonly"
+			})), null, 2)
+		}] };
+	});
+}
+
+//#endregion
+export { registerAfsResources };
+//# sourceMappingURL=resources.mjs.map

package/dist/mcp/resources.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.mjs","names":[],"sources":["../../src/mcp/resources.ts"],"sourcesContent":["import type { AFS } from \"@aigne/afs\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nexport function registerAfsResources(server: McpServer, afs: AFS): void {\n  server.resource(\n    \"mounts\",\n    \"afs:///mounts\",\n    { description: \"List of all mounted AFS providers\", mimeType: \"application/json\" },\n    async () => {\n      const mounts = afs.getMounts();\n      return {\n        contents: [\n          {\n            uri: \"afs:///mounts\",\n            mimeType: \"application/json\",\n            text: JSON.stringify(\n              mounts.map((m) => ({\n                path: m.path,\n                name: m.module.name,\n                accessMode: m.module.accessMode ?? \"readonly\",\n              })),\n              null,\n              2,\n            ),\n          },\n        ],\n      };\n    },\n  );\n}\n"],"mappings":";AAEA,SAAgB,qBAAqB,QAAmB,KAAgB;AACtE,QAAO,SACL,UACA,iBACA;EAAE,aAAa;EAAqC,UAAU;EAAoB,EAClF,YAAY;EACV,MAAM,SAAS,IAAI,WAAW;AAC9B,SAAO,EACL,UAAU,CACR;GACE,KAAK;GACL,UAAU;GACV,MAAM,KAAK,UACT,OAAO,KAAK,OAAO;IACjB,MAAM,EAAE;IACR,MAAM,EAAE,OAAO;IACf,YAAY,EAAE,OAAO,cAAc;IACpC,EAAE,EACH,MACA,EACD;GACF,CACF,EACF;GAEJ"}

package/dist/mcp/server.cjs

@@ -0,0 +1,51 @@
+const require_prompts = require('./prompts.cjs');
+const require_resources = require('./resources.cjs');
+const require_tools = require('./tools.cjs');
+let _modelcontextprotocol_sdk_server_mcp_js = require("@modelcontextprotocol/sdk/server/mcp.js");
+
+//#region src/mcp/server.ts
+function createArcMcpServer(afs, options) {
+	const server = new _modelcontextprotocol_sdk_server_mcp_js.McpServer({
+		name: options?.name ?? "arc",
+		version: options?.version ?? "0.0.0"
+	}, { capabilities: {
+		tools: {},
+		resources: {},
+		prompts: {},
+		logging: {}
+	} });
+	const lines = [
+		"AFS (Agentic File System) is a virtual filesystem that gives AI agents a unified, path-based interface to any data source.",
+		"All data sources — databases, APIs, smart home devices, cloud services — are accessed through a consistent path-based API: read, list, stat, explain, search, write, delete, exec.",
+		"",
+		"## Mounted Providers",
+		""
+	];
+	const mounts = afs.getMounts(null);
+	if (mounts.length === 0) lines.push("No providers currently mounted.");
+	else for (const m of mounts) {
+		lines.push(`### ${m.module.name} (${m.path})`);
+		if (m.module.description) for (const l of m.module.description.split("\n")) lines.push(l);
+		lines.push("");
+	}
+	lines.push("## Usage");
+	lines.push("");
+	lines.push("- Use `afs_list` to browse directories and discover content");
+	lines.push("- Use `afs_read` to read file/node content");
+	lines.push("- Use `afs_stat` to get metadata without content");
+	lines.push("- Use `afs_explain` to get documentation for any path");
+	lines.push("- Use `afs_search` to find content by pattern");
+	lines.push("- Use `afs_write` to create or update content");
+	lines.push("- Use `afs_delete` to remove files or nodes");
+	lines.push("- Use `afs_exec` to execute actions (e.g., `/.actions/mount`)");
+	lines.push("");
+	lines.push("Start with `afs_list /` to see all mounted providers, or `afs_explain /` for a complete overview.");
+	server.server._instructions = lines.join("\n");
+	require_tools.registerAfsTools(server, afs, options?.context);
+	require_resources.registerAfsResources(server, afs);
+	require_prompts.registerAfsPrompts(server, afs);
+	return server;
+}
+
+//#endregion
+exports.createArcMcpServer = createArcMcpServer;

package/dist/mcp/server.d.cts

@@ -0,0 +1,20 @@
+import { AFS, AFSContext } from "@aigne/afs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/mcp/server.d.ts
+interface CreateArcMcpServerOptions {
+  name?: string;
+  version?: string;
+  /**
+   * Per-request op context threaded into every AFS tool call (read/list/write/
+   * exec/…). Carries the verified `caller` + host-stamped `callerOrigin:"network"`
+   * + `instanceDid`, so the exec-effect gate and SessionUserAFS base-write gate
+   * engage for MCP callers exactly as they do for afs-rpc. Omitted → ops run
+   * without a network marker (trusted-internal / local-open mode).
+   */
+  context?: AFSContext;
+}
+declare function createArcMcpServer(afs: AFS, options?: CreateArcMcpServerOptions): McpServer;
+//#endregion
+export { CreateArcMcpServerOptions, createArcMcpServer };
+//# sourceMappingURL=server.d.cts.map

package/dist/mcp/server.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.cts","names":[],"sources":["../../src/mcp/server.ts"],"mappings":";;;;UAMiB,yBAAA;EACf,IAAA;EACA,OAAA;EAFwC;;;;;;;EAUxC,OAAA,GAAU,UAAA;AAAA;AAAA,iBAGI,kBAAA,CAAmB,GAAA,EAAK,GAAA,EAAK,OAAA,GAAU,yBAAA,GAA4B,SAAA"}

package/dist/mcp/server.d.mts

@@ -0,0 +1,20 @@
+import { AFS, AFSContext } from "@aigne/afs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/mcp/server.d.ts
+interface CreateArcMcpServerOptions {
+  name?: string;
+  version?: string;
+  /**
+   * Per-request op context threaded into every AFS tool call (read/list/write/
+   * exec/…). Carries the verified `caller` + host-stamped `callerOrigin:"network"`
+   * + `instanceDid`, so the exec-effect gate and SessionUserAFS base-write gate
+   * engage for MCP callers exactly as they do for afs-rpc. Omitted → ops run
+   * without a network marker (trusted-internal / local-open mode).
+   */
+  context?: AFSContext;
+}
+declare function createArcMcpServer(afs: AFS, options?: CreateArcMcpServerOptions): McpServer;
+//#endregion
+export { CreateArcMcpServerOptions, createArcMcpServer };
+//# sourceMappingURL=server.d.mts.map

package/dist/mcp/server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.mts","names":[],"sources":["../../src/mcp/server.ts"],"mappings":";;;;UAMiB,yBAAA;EACf,IAAA;EACA,OAAA;EAFwC;;;;;;;EAUxC,OAAA,GAAU,UAAA;AAAA;AAAA,iBAGI,kBAAA,CAAmB,GAAA,EAAK,GAAA,EAAK,OAAA,GAAU,yBAAA,GAA4B,SAAA"}

package/dist/mcp/server.mjs

@@ -0,0 +1,52 @@
+import { registerAfsPrompts } from "./prompts.mjs";
+import { registerAfsResources } from "./resources.mjs";
+import { registerAfsTools } from "./tools.mjs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/mcp/server.ts
+function createArcMcpServer(afs, options) {
+	const server = new McpServer({
+		name: options?.name ?? "arc",
+		version: options?.version ?? "0.0.0"
+	}, { capabilities: {
+		tools: {},
+		resources: {},
+		prompts: {},
+		logging: {}
+	} });
+	const lines = [
+		"AFS (Agentic File System) is a virtual filesystem that gives AI agents a unified, path-based interface to any data source.",
+		"All data sources — databases, APIs, smart home devices, cloud services — are accessed through a consistent path-based API: read, list, stat, explain, search, write, delete, exec.",
+		"",
+		"## Mounted Providers",
+		""
+	];
+	const mounts = afs.getMounts(null);
+	if (mounts.length === 0) lines.push("No providers currently mounted.");
+	else for (const m of mounts) {
+		lines.push(`### ${m.module.name} (${m.path})`);
+		if (m.module.description) for (const l of m.module.description.split("\n")) lines.push(l);
+		lines.push("");
+	}
+	lines.push("## Usage");
+	lines.push("");
+	lines.push("- Use `afs_list` to browse directories and discover content");
+	lines.push("- Use `afs_read` to read file/node content");
+	lines.push("- Use `afs_stat` to get metadata without content");
+	lines.push("- Use `afs_explain` to get documentation for any path");
+	lines.push("- Use `afs_search` to find content by pattern");
+	lines.push("- Use `afs_write` to create or update content");
+	lines.push("- Use `afs_delete` to remove files or nodes");
+	lines.push("- Use `afs_exec` to execute actions (e.g., `/.actions/mount`)");
+	lines.push("");
+	lines.push("Start with `afs_list /` to see all mounted providers, or `afs_explain /` for a complete overview.");
+	server.server._instructions = lines.join("\n");
+	registerAfsTools(server, afs, options?.context);
+	registerAfsResources(server, afs);
+	registerAfsPrompts(server, afs);
+	return server;
+}
+
+//#endregion
+export { createArcMcpServer };
+//# sourceMappingURL=server.mjs.map

package/dist/mcp/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":[],"sources":["../../src/mcp/server.ts"],"sourcesContent":["import type { AFS, AFSContext } from \"@aigne/afs\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { registerAfsPrompts } from \"./prompts.js\";\nimport { registerAfsResources } from \"./resources.js\";\nimport { registerAfsTools } from \"./tools.js\";\n\nexport interface CreateArcMcpServerOptions {\n  name?: string;\n  version?: string;\n  /**\n   * Per-request op context threaded into every AFS tool call (read/list/write/\n   * exec/…). Carries the verified `caller` + host-stamped `callerOrigin:\"network\"`\n   * + `instanceDid`, so the exec-effect gate and SessionUserAFS base-write gate\n   * engage for MCP callers exactly as they do for afs-rpc. Omitted → ops run\n   * without a network marker (trusted-internal / local-open mode).\n   */\n  context?: AFSContext;\n}\n\nexport function createArcMcpServer(afs: AFS, options?: CreateArcMcpServerOptions): McpServer {\n  const name = options?.name ?? \"arc\";\n  const version = options?.version ?? \"0.0.0\";\n  const server = new McpServer(\n    { name, version },\n    { capabilities: { tools: {}, resources: {}, prompts: {}, logging: {} } },\n  );\n  const lines: string[] = [\n    \"AFS (Agentic File System) is a virtual filesystem that gives AI agents a unified, path-based interface to any data source.\",\n    \"All data sources — databases, APIs, smart home devices, cloud services — are accessed through a consistent path-based API: read, list, stat, explain, search, write, delete, exec.\",\n    \"\",\n    \"## Mounted Providers\",\n    \"\",\n  ];\n  const mounts = afs.getMounts(null);\n  if (mounts.length === 0) lines.push(\"No providers currently mounted.\");\n  else\n    for (const m of mounts) {\n      lines.push(`### ${m.module.name} (${m.path})`);\n      if (m.module.description) for (const l of m.module.description.split(\"\\n\")) lines.push(l);\n      lines.push(\"\");\n    }\n  lines.push(\"## Usage\");\n  lines.push(\"\");\n  lines.push(\"- Use `afs_list` to browse directories and discover content\");\n  lines.push(\"- Use `afs_read` to read file/node content\");\n  lines.push(\"- Use `afs_stat` to get metadata without content\");\n  lines.push(\"- Use `afs_explain` to get documentation for any path\");\n  lines.push(\"- Use `afs_search` to find content by pattern\");\n  lines.push(\"- Use `afs_write` to create or update content\");\n  lines.push(\"- Use `afs_delete` to remove files or nodes\");\n  lines.push(\"- Use `afs_exec` to execute actions (e.g., `/.actions/mount`)\");\n  lines.push(\"\");\n  lines.push(\n    \"Start with `afs_list /` to see all mounted providers, or `afs_explain /` for a complete overview.\",\n  );\n  (server.server as unknown as Record<string, unknown>)._instructions = lines.join(\"\\n\");\n  registerAfsTools(server, afs, options?.context);\n  registerAfsResources(server, afs);\n  registerAfsPrompts(server, afs);\n  return server;\n}\n"],"mappings":";;;;;;AAmBA,SAAgB,mBAAmB,KAAU,SAAgD;CAG3F,MAAM,SAAS,IAAI,UACjB;EAAE,MAHS,SAAS,QAAQ;EAGpB,SAFM,SAAS,WAAW;EAEjB,EACjB,EAAE,cAAc;EAAE,OAAO,EAAE;EAAE,WAAW,EAAE;EAAE,SAAS,EAAE;EAAE,SAAS,EAAE;EAAE,EAAE,CACzE;CACD,MAAM,QAAkB;EACtB;EACA;EACA;EACA;EACA;EACD;CACD,MAAM,SAAS,IAAI,UAAU,KAAK;AAClC,KAAI,OAAO,WAAW,EAAG,OAAM,KAAK,kCAAkC;KAEpE,MAAK,MAAM,KAAK,QAAQ;AACtB,QAAM,KAAK,OAAO,EAAE,OAAO,KAAK,IAAI,EAAE,KAAK,GAAG;AAC9C,MAAI,EAAE,OAAO,YAAa,MAAK,MAAM,KAAK,EAAE,OAAO,YAAY,MAAM,KAAK,CAAE,OAAM,KAAK,EAAE;AACzF,QAAM,KAAK,GAAG;;AAElB,OAAM,KAAK,WAAW;AACtB,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,8DAA8D;AACzE,OAAM,KAAK,6CAA6C;AACxD,OAAM,KAAK,mDAAmD;AAC9D,OAAM,KAAK,wDAAwD;AACnE,OAAM,KAAK,gDAAgD;AAC3D,OAAM,KAAK,gDAAgD;AAC3D,OAAM,KAAK,8CAA8C;AACzD,OAAM,KAAK,gEAAgE;AAC3E,OAAM,KAAK,GAAG;AACd,OAAM,KACJ,oGACD;AACD,CAAC,OAAO,OAA8C,gBAAgB,MAAM,KAAK,KAAK;AACtF,kBAAiB,QAAQ,KAAK,SAAS,QAAQ;AAC/C,sBAAqB,QAAQ,IAAI;AACjC,oBAAmB,QAAQ,IAAI;AAC/B,QAAO"}