@jskit-ai/agent-docs 0.1.130 → 0.1.132

package/reference/autogen/packages/agent-docs.md

@@ -12,6 +12,265 @@ Use this on demand; do not load the full index at startup.
 
 ## Sections
 
+### patterns
+
+### `patterns/feature-package/example/booking-engine/src/server/actions.js`
+Exports
+- `ACTION_GET_STATUS`
+- `createActions({ bookingEngine } = {})`
+
+### `patterns/feature-package/example/booking-engine/src/server/BookingEngineProvider.js`
+Exports
+- `BookingEngineProvider`
+
+### `patterns/feature-package/example/booking-engine/src/server/inputSchemas.js`
+Exports
+- `statusQueryInputValidator`
+
+### `patterns/feature-package/example/variations/AvailabilityEngineProvider.js`
+Exports
+- `AvailabilityEngineProvider`
+
+### `patterns/feature-package/example/variations/customKnexRepository.js`
+Exports
+- `createRepository({ knex } = {})`
+
+### `patterns/feature-package/example/variations/InvoiceRollupProvider.js`
+Exports
+- `InvoiceRollupProvider`
+
+### `patterns/feature-package/example/variations/orchestratorService.js`
+Exports
+- `createService()`
+
+### `patterns/minimal-foundation/example/bin/develop.js`
+Exports
+- None
+Local functions
+- `requiredPort(value, fallback = 3000)`
+- `waitForChild(child)`
+- `requestShutdown(signal)`
+
+### `patterns/minimal-foundation/example/bin/server.js`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/config/public.js`
+Exports
+- `config`
+
+### `patterns/minimal-foundation/example/config/server.js`
+Exports
+- `config`
+
+### `patterns/minimal-foundation/example/config/surfaceAccessPolicies.js`
+Exports
+- `surfaceAccessPolicies`
+
+### `patterns/minimal-foundation/example/eslint.config.mjs`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/packages/main/src/shared/index.js`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/packages/main/src/shared/schemas/index.js`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/playwright.config.mjs`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/server.js`
+Exports
+- `createServer({ runtimeEnv = resolveRuntimeEnv() } = {})`
+- `startServer(options = {})`
+Local functions
+- `toRequestPathname(urlValue)`
+- `isApiPath(pathname)`
+- `hasFileExtension(pathname)`
+- `resolveGlobalUiPaths(runtimeGlobalUiPaths = [])`
+- `resolveStaticFilePath(pathname)`
+- `canServeStaticFile(distRoot, relativePath)`
+
+### `patterns/minimal-foundation/example/server/lib/runtimeEnv.js`
+Exports
+- `resolveRuntimeEnv()`
+Local functions
+- `toPort(value, fallback = 3000)`
+- `ensureRuntimeEnvLoaded()`
+
+### `patterns/minimal-foundation/example/server/lib/surfaceRuntime.js`
+Exports
+- `surfaceRuntime`
+
+### `patterns/minimal-foundation/example/src/App.vue`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/src/main.js`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/src/pages/home.vue`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/src/pages/home/index.vue`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/src/views/NotFound.vue`
+Exports
+- None
+
+### `patterns/minimal-foundation/example/vite.config.mjs`
+Exports
+- None
+Local functions
+- `clientEntry(()`
+
+### `patterns/shell-foundation/example/bin/develop.js`
+Exports
+- None
+Local functions
+- `requiredPort(value, fallback = 3000)`
+- `waitForChild(child)`
+- `requestShutdown(signal)`
+
+### `patterns/shell-foundation/example/bin/server.js`
+Exports
+- None
+
+### `patterns/shell-foundation/example/config/public.js`
+Exports
+- `config`
+
+### `patterns/shell-foundation/example/config/server.js`
+Exports
+- `config`
+
+### `patterns/shell-foundation/example/config/surfaceAccessPolicies.js`
+Exports
+- `surfaceAccessPolicies`
+
+### `patterns/shell-foundation/example/eslint.config.mjs`
+Exports
+- None
+
+### `patterns/shell-foundation/example/packages/main/src/client/index.js`
+Exports
+- `MainClientProvider`
+
+### `patterns/shell-foundation/example/packages/main/src/client/providers/MainClientProvider.js`
+Exports
+- `MainClientProvider`
+
+### `patterns/shell-foundation/example/packages/main/src/shared/index.js`
+Exports
+- None
+
+### `patterns/shell-foundation/example/packages/main/src/shared/schemas/index.js`
+Exports
+- None
+
+### `patterns/shell-foundation/example/playwright.config.mjs`
+Exports
+- None
+
+### `patterns/shell-foundation/example/server.js`
+Exports
+- `createServer({ runtimeEnv = resolveRuntimeEnv() } = {})`
+- `startServer(options = {})`
+Local functions
+- `toRequestPathname(urlValue)`
+- `isApiPath(pathname)`
+- `hasFileExtension(pathname)`
+- `resolveGlobalUiPaths(runtimeGlobalUiPaths = [])`
+- `resolveStaticFilePath(pathname)`
+- `canServeStaticFile(distRoot, relativePath)`
+
+### `patterns/shell-foundation/example/server/lib/runtimeEnv.js`
+Exports
+- `resolveRuntimeEnv()`
+Local functions
+- `toPort(value, fallback = 3000)`
+- `ensureRuntimeEnvLoaded()`
+
+### `patterns/shell-foundation/example/server/lib/surfaceRuntime.js`
+Exports
+- `surfaceRuntime`
+
+### `patterns/shell-foundation/example/src/App.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/components/menus/MenuLinkItem.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/components/menus/SurfaceAwareMenuLinkItem.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/components/menus/TabLinkItem.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/components/ShellLayout.vue`
+Exports
+- `default`
+
+### `patterns/shell-foundation/example/src/error.js`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/main.js`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/pages/home.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/pages/home/index.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/pages/home/settings.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/pages/home/settings/general/index.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/pages/home/settings/index.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/src/placement.js`
+Exports
+- `addPlacement`
+- `getPlacements()`
+
+### `patterns/shell-foundation/example/src/placementTopology.js`
+Exports
+- `addPlacementTopology(value = {})`
+- `default`
+
+### `patterns/shell-foundation/example/src/views/NotFound.vue`
+Exports
+- None
+
+### `patterns/shell-foundation/example/vite.config.mjs`
+Exports
+- None
+Local functions
+- `clientEntry(()`
+
 ### site
 
 ### `site/.vitepress/config.mjs`

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

@@ -166,7 +166,7 @@ Exports
 
 ### `src/server/lib/serviceToolCatalog.js`
 Exports
-- `createServiceToolCatalog(scope, { barredActionIds = [], skipActionPrefixes = [] } = {})`
+- `createServiceToolCatalog(actions, { barredActionIds = [], skipActionPrefixes = [] } = {})`
 Local functions
 - `normalizeAssistantExtension(value)`
 - `normalizeAssistantActionExtension(action = {})`
@@ -182,8 +182,8 @@ Local functions
 - `hasAutomationChannel(action = {})`
 - `normalizeSurfaceList(value)`
 - `canUseToolOnSurface(entry = {}, context = {})`
-- `resolveActionBackedToolEntries(scope)`
-- `resolveActionToolEntries(scope, { barredActionIds = [], skipActionPrefixes = [] } = {})`
+- `resolveActionBackedToolEntries(actions)`
+- `resolveActionToolEntries(actions, { barredActionIds = [], skipActionPrefixes = [] } = {})`
 
 ### `src/shared/assistantPaths.js`
 Exports

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

@@ -74,14 +74,15 @@ Exports
 
 ### `src/server/actions.js`
 Exports
-- `assistantActions`
+- `createAssistantActions({ assistantConfigService, chatService, config = {} } = {})`
+Local functions
+- `configuredAssistantSurfaces(config = {})`
 
 ### `src/server/AssistantProvider.js`
 Exports
-- `AssistantProvider`
-Local functions
-- `resolveGlobalAssistantConfig(scope)`
+- `AssistantFeature`
 - `createAssistantAiClientFactory(config = {})`
+- `createAssistantRuntime({ actionCatalogue, config, consoleRuntime, database, env, workspaces } = {})`
 
 ### `src/server/inputSchemas.js`
 Exports
@@ -90,7 +91,7 @@ Exports
 
 ### `src/server/registerRoutes.js`
 Exports
-- `registerRoutes(app)`
+- `registerRoutes(router, { config = {}, workspaceScopeSupport = null } = {})`
 Local functions
 - `requireWorkspaceAssistantRouteParams(workspaceScopeSupport = null)`
 - `readWorkspaceInput(request, requiresWorkspace, workspaceScopeSupport = null)`
@@ -200,19 +201,11 @@ Local functions
 
 ### `src/server/support/createSurfaceAwareToolCatalog.js`
 Exports
-- `createSurfaceAwareToolCatalog(scope, { appConfig = {}, resolveAppConfig = null, createCatalog = createServiceToolCatalog } = {})`
+- `createSurfaceAwareToolCatalog(actions, { appConfig = {}, resolveAppConfig = null, createCatalog = createServiceToolCatalog } = {})`
 Local functions
 - `buildCatalogOptions(appConfig = {}, surfaceId = "")`
 - `requireContextSurfaceId(context = {})`
 
-### `src/server/support/workspaceScopeSupport.js`
-Exports
-- `WORKSPACES_SERVER_SCOPE_SUPPORT_TOKEN`
-- `isWorkspaceServerScopeSupport(value)`
-- `resolveWorkspaceServerScopeSupport(scope = null, { required = false, caller = "assistant-runtime" } = {})`
-Local functions
-- `hasWorkspaceRouteParamsDefinition(value)`
-
 ### `src/shared/assistantRuntimeConfig.js`
 Exports
 - `assistantRuntimeConfig`
@@ -232,12 +225,34 @@ Exports
 - `resolveAssistantSurfacesConfig`
 - `resolveSurfaceDefinitions`
 
-### templates
+### migrations
+
+### `migrations/assistant_config_initial.cjs`
+Exports
+- None
+
+### `migrations/assistant_transcripts_initial.cjs`
+Exports
+- None
+
+### patterns
+
+### `patterns/assistant-surface/example/config/public.js`
+Exports
+- None
+
+### `patterns/assistant-surface/example/config/server.js`
+Exports
+- None
 
-### `templates/migrations/assistant_config_initial.cjs`
+### `patterns/assistant-surface/example/src/pages/admin/assistant/index.vue`
 Exports
 - None
 
-### `templates/migrations/assistant_transcripts_initial.cjs`
+### `patterns/assistant-surface/example/src/pages/admin/settings/assistant/index.vue`
 Exports
 - None
+
+### `patterns/assistant-surface/example/src/placement.js`
+Exports
+- `getPlacements()`

package/reference/autogen/packages/auth-core.md

@@ -21,24 +21,19 @@ Exports
 ### `src/client/index.js`
 Exports
 - `AccessCoreClientProvider`
-- `FastifyAuthPolicyClientProvider`
 
 ### `src/client/providers/AccessCoreClientProvider.js`
 Exports
 - `AccessCoreClientProvider`
 
-### `src/client/providers/FastifyAuthPolicyClientProvider.js`
-Exports
-- `FastifyAuthPolicyClientProvider`
-
 ### `src/client/signOutFlow.js`
 Exports
 - `runAuthSignOutFlow`
 
 ### `src/server/actions/auth.contributor.js`
 Exports
-- `baseAuthActions`
-- `buildAuthActions()`
+- `authActionSpecifications`
+- `buildAuthActions({ authService } = {})`
 - `requireRequestContext(context, actionId)`
 
 ### `src/server/authActor.js`
@@ -50,30 +45,34 @@ Local functions
 - `normalizeDisplayName(value, email = "")`
 - `normalizeProviderUserId(value)`
 
-### `src/server/authPolicyContextResolverRegistry.js`
+### `src/server/authExtensions.js`
 Exports
-- `AUTH_POLICY_CONTEXT_RESOLVER_TAG`
-- `registerAuthPolicyContextResolver(app, token, factory)`
-- `resolveAuthPolicyContextResolvers(scope)`
-- `resolveComposedAuthPolicyContextResolver(scope)`
-- `mergeAuthPolicyContexts(contexts = [])`
-- `composeAuthPolicyContextResolvers(resolvers = [])`
+- `createAuthExtensions()`
+- `mergePolicyContexts(contexts = [])`
 Local functions
-- `normalizeAuthPolicyContextResolver(entry)`
+- `normalizeOrderedExtension(value, { idField, method, label } = {})`
+- `ordered(values)`
+
+### `src/server/authPolicyContextResolverRegistry.js`
+Exports
+- `registerAuthPolicyContextResolver(extensions, resolver)`
+- `resolveComposedAuthPolicyContextResolver(extensions)`
+- `mergePolicyContexts`
 
 ### `src/server/authServiceDecoratorRegistry.js`
 Exports
-- `AUTH_SERVICE_DECORATOR_TAG`
-- `applyAuthServiceDecorators(scope, authService)`
-- `registerAuthServiceDecorator(app, token, factory)`
-- `resolveAuthServiceDecorators(scope)`
-Local functions
-- `normalizeAuthServiceDecorator(entry)`
+- `applyAuthServiceDecorators(extensions, authService)`
+- `registerAuthServiceDecorator(extensions, decorator)`
 
 ### `src/server/booleanFlag.js`
 Exports
 - `parseBooleanFlag(value, fallback = false)`
 
+### `src/server/deferredAuthService.js`
+Exports
+- `attachDeferredAuthService(handle, service)`
+- `createDeferredAuthService()`
+
 ### `src/server/devAuth.js`
 Exports
 - `assertDevAuthPolicy(policy = {})`
@@ -169,26 +168,25 @@ Exports
 - `normalizePermissions(value)`
 - `createMembershipIndexes(memberships)`
 
-### `src/server/providers/AccessCoreServiceProvider.js`
+### `src/server/providers/AuthAccessProvider.js`
 Exports
-- `AccessCoreServiceProvider`
+- `AuthAccessProvider`
 
-### `src/server/providers/AuthActionsServiceProvider.js`
+### `src/server/providers/AuthExtensionsProvider.js`
 Exports
-- `AuthActionsServiceProvider`
+- `AuthExtensionsProvider`
 
-### `src/server/providers/FastifyAuthPolicyServiceProvider.js`
+### `src/server/providers/AuthFeature.js`
 Exports
-- `FastifyAuthPolicyServiceProvider`
-Local functions
-- `parseList(value)`
-- `defaultHasPermission({ permission, permissions = [] } = {})`
+- `AuthFeature`
 
-### `src/server/services/authSessionEventsService.js`
+### `src/server/providers/AuthPolicyProvider.js`
 Exports
-- `createAuthSessionEventsService()`
+- `AuthPolicyProvider`
 Local functions
-- `resolveActorId(context = {})`
+- `parseList(value)`
+- `defaultHasPermission({ permission, permissions = [] } = {})`
+- `createPolicy({ authService, extensions, env })`
 
 ### `src/server/unsupportedOperation.js`
 Exports

package/reference/autogen/packages/auth-provider-local-core.md

@@ -114,20 +114,12 @@ Local functions
 - `base64urlJson(value)`
 - `parseBase64urlJson(value)`
 
-### `src/server/providers/AuthLocalServiceProvider.js`
+### `src/server/providers/AuthLocalProvider.js`
 Exports
-- `AuthLocalServiceProvider`
-- `resolveLocalBackendMode(scope)`
+- `AuthLocalProvider`
+- `resolveConfig({ appRoot, backend, env, logger })`
 Local functions
-- `resolveRuntimeEnv(scope)`
-- `assertSelectedAuthProvider(env)`
-- `resolveStoreDir(env)`
+- `resolveStoreDir(env, appRoot)`
 - `resolveSessionSecret(env, { storeDir, isProduction })`
 - `resolveSmtpConfig(env)`
 - `resolveAppPublicUrl(env, { smtpConfigured })`
-- `resolveConfig(scope)`
-- `createLazyProfileProjector(scope)`
-
-### `src/server/providers/AuthProviderServiceProvider.js`
-Exports
-- `AuthProviderServiceProvider`

package/reference/autogen/packages/auth-provider-local-db-core.md

@@ -39,12 +39,12 @@ Exports
 - `createLocalDbBackend`
 - `LOCAL_AUTH_DB_TABLES`
 
-### `src/server/providers/AuthLocalDbBackendServiceProvider.js`
+### `src/server/providers/AuthLocalDatabaseBackendProvider.js`
 Exports
-- `AuthLocalDbBackendServiceProvider`
+- `AuthLocalDatabaseBackendProvider`
 
-### templates
+### migrations
 
-### `templates/migrations/auth_local_db_initial.cjs`
+### `migrations/auth_local_db_initial.cjs`
 Exports
 - None

package/reference/autogen/packages/auth-provider-supabase-core.md

@@ -206,24 +206,20 @@ Exports
 - `findLinkedIdentityByProvider`
 - `buildSecurityStatusFromAuthMethodsStatus`
 
-### `src/server/providers/AuthProviderServiceProvider.js`
+### `src/server/providers/AuthSupabaseProvider.js`
 Exports
-- `AuthProviderServiceProvider`
-
-### `src/server/providers/AuthSupabaseServiceProvider.js`
-Exports
-- `AuthSupabaseServiceProvider`
+- `AuthSupabaseProvider`
 Local functions
-- `splitCsv(value)`
 - `normalizeRecord(value)`
-- `normalizeOAuthProviderConfigList(value)`
-- `resolveOAuthConfigFromAppConfig(appConfig)`
-- `resolveAllowedReturnToOrigins({ appConfig = {}, appPublicUrl = "" } = {})`
-- `resolveAuthProviderConfig(env, appConfig = {})`
-- `resolveAuthProfileMode(appConfig = {})`
-- `createProviderIdentityProfileSyncService({ authProviderId = "supabase" } = {})`
-- `resolveCommonDependencies(scope)`
-- `resolveRuntimeEnv(scope)`
-- `assertSelectedAuthProvider(env)`
-- `resolveOptionalRepositories(scope)`
-- `isDeferredJsonRestBootGap(app, error)`
+- `splitCsv(value)`
+- `oauthConfig(config)`
+- `providerConfig(env, config)`
+- `profileMode(config)`
+- `createProviderProfileProjector()`
+- `assertSelectedProvider(env)`
+
+### patterns
+
+### `patterns/supabase-auth/example/config/server.js`
+Exports
+- None