@jskit-ai/agent-docs 0.1.57 → 0.1.59

package/guide/agent/app-setup/initial-scaffolding.md

@@ -159,6 +159,9 @@ The most important parts look like this:
 
 ```json
 {
+  "engines": {
+    "node": "^20.19.0 || ^22.12.0"
+  },
   "scripts": {
     "server": "node ./bin/server.js",
     "server:all": "node ./bin/server.js",
@@ -181,26 +184,26 @@ The most important parts look like this:
   },
   "dependencies": {
     "@local/main": "file:packages/main",
-    "@fastify/static": "^9.1.1",
+    "@fastify/static": "^9.1.3",
     "@jskit-ai/kernel": "0.x",
-    "@tanstack/vue-query": "^5.90.5",
+    "@tanstack/vue-query": "^5.101.0",
     "@jskit-ai/http-runtime": "0.x",
-    "fastify": "^5.7.4",
-    "json-rest-schema": "^1.0.13",
+    "fastify": "^5.8.5",
+    "json-rest-schema": "^1.0.16",
     "pinia": "^3.0.4",
-    "vue": "^3.5.13",
-    "vue-router": "^5.0.4",
-    "vuetify": "^4.0.0"
+    "vue": "^3.5.38",
+    "vue-router": "^5.1.0",
+    "vuetify": "^4.1.2"
   },
   "devDependencies": {
     "@jskit-ai/agent-docs": "0.x",
     "@jskit-ai/config-eslint": "0.x",
     "@jskit-ai/jskit-cli": "0.x",
-    "@playwright/test": "^1.57.0",
-    "@vitejs/plugin-vue": "^5.2.1",
-    "eslint": "^9.39.1",
-    "vite": "^6.1.0",
-    "vitest": "^4.0.18"
+    "@playwright/test": "^1.61.0",
+    "@vitejs/plugin-vue": "^6.0.7",
+    "eslint": "^9.39.4",
+    "vite": "^8.0.16",
+    "vitest": "^4.1.9"
   }
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/agent-docs",
-  "version": "0.1.57",
+  "version": "0.1.59",
   "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
   "type": "module",
   "files": [

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

@@ -36,6 +36,7 @@ Local functions
 Exports
 - `safeRequestCookies(request)`
 - `cookieOptions(isProduction, maxAge)`
+- `cookieClearOptions(isProduction)`
 
 ### `src/server/lib/authenticatedProfile.js`
 Exports

package/reference/autogen/packages/kernel.md

@@ -678,7 +678,7 @@ Exports
 Exports
 - `normalizeDescriptorUiRoutes(value)`
 - `normalizeDescriptorClientProviders(value)`
-- `normalizeDescriptorClientOptimizeIncludeSpecifiers(value)`
+- `normalizeDescriptorClientOptimizeSpecifiers(value)`
 - `normalizeClientDescriptorSections(descriptorValue)`
 
 ### `client/index.js`
@@ -782,7 +782,7 @@ Exports
 - `CLIENT_BOOTSTRAP_VIRTUAL_ID`
 - `CLIENT_BOOTSTRAP_RESOLVED_ID`
 - `createVirtualModuleSource(clientModules = [])`
-- `resolveClientOptimizeIncludeSpecifiers(clientModules = [])`
+- `resolveClientOptimizeIncludeSpecifiers(clientModules = [], excludeSpecifiers = [])`
 - `resolveClientOptimizeExcludeSpecifiers(clientModules = [])`
 - `resolveLocalScopeOptimizeExcludeSpecifiers(localScopePackageIds = [])`
 - `resolveInstalledClientPackageIds(options)`

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

@@ -198,6 +198,26 @@ Local functions
 Exports
 - `resolveActionUser(context, input)`
 
+### `src/server/previewUserProvisioning.js`
+Exports
+- `DEFAULT_AUTH_PROVIDER`
+- `DEFAULT_DISPLAY_NAME`
+- `DEFAULT_EMAIL`
+- `ensurePreviewUser(db, profileInput = {})`
+- `normalizePreviewUserProfile(profile = {})`
+- `profileFromUserRow(user = {}, fallback = {})`
+Local functions
+- `normalizeText(value = "")`
+- `normalizeLowerText(value = "")`
+- `normalizeUsername(value = "")`
+- `usernameBaseFromEmail(email = "")`
+- `buildUsernameCandidate(baseUsername = "", suffix = 0)`
+- `isDuplicateError(error)`
+- `resolveUniqueUsername(db, baseUsername = "", { excludeUserId = "" } = {})`
+- `findPreviewUser(db, profile = {})`
+- `ensurePreviewUserRow(db, profile = {})`
+- `ensureUserSettings(db, user = {})`
+
 ### `src/server/profileSyncLifecycleContributorRegistry.js`
 Exports
 - `PROFILE_SYNC_LIFECYCLE_CONTRIBUTOR_TAG`

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

@@ -114,6 +114,25 @@ Exports
 - `routeParamsValidator`
 - `workspaceSlugParamsValidator`
 
+### `src/server/previewWorkspaceProvisioning.js`
+Exports
+- `buildWorkspaceBaseSlug(profile = {})`
+- `buildWorkspaceName(profile = {})`
+- `ensurePreviewWorkspace(db, user = {}, profile = {}, { appConfig = {}, tenancyMode = "" } = {})`
+- `normalizeWorkspaceResult(workspace = null)`
+Local functions
+- `normalizeText(value = "")`
+- `normalizeLowerText(value = "")`
+- `workspaceSlugPart(value = "")`
+- `usernameBaseFromEmail(email = "")`
+- `buildWorkspaceSlugCandidate(baseSlug = "", suffix = 0)`
+- `isDuplicateError(error)`
+- `resolveUniqueWorkspaceSlug(db, baseSlug = "", { excludeWorkspaceId = "" } = {})`
+- `hasWorkspaceTables(db)`
+- `findPreviewWorkspace(db, user = {}, { isPersonal = true } = {})`
+- `ensureWorkspaceSettings(db, workspace = {})`
+- `ensureOwnerMembership(db, workspace = {}, user = {})`
+
 ### `src/server/registerWorkspaceBootstrap.js`
 Exports
 - `registerWorkspaceBootstrap(app)`

package/reference/autogen/tooling/jskit-cli.md

@@ -400,6 +400,23 @@ Local functions
 - `replaceWithSymlink(targetPath = "", sourceDir = "", { packageName = "" } = {})`
 - `maybeLinkCompanionPackages({ appRoot = "", repoRoot = "", stdout, createCliError })`
 
+### `src/server/commandHandlers/appCommands/preparePreviewUser.js`
+Exports
+- `runAppPreparePreviewUserCommand(_ctx = {}, { appRoot = "", options = {}, stdout = process.stdout })`
+Local functions
+- `normalizeText(value = "")`
+- `normalizeLowerText(value = "")`
+- `profileFromOptions(options = {})`
+- `fileExists(filePath = "")`
+- `createAppRequire(appRoot = "")`
+- `importFreshModule(filePath = "")`
+- `loadKnexConfig(appRoot = "")`
+- `importAppPackageExport(appRoot = "", specifier = "", { required = true } = {})`
+- `writeProfile(profileFile = "", authProfile = {})`
+- `isTrueOption(value)`
+- `normalizeTenancyMode(value = "")`
+- `hasWorkspaceTables(db)`
+
 ### `src/server/commandHandlers/appCommands/release.js`
 Exports
 - `runAppReleaseCommand(ctx = {}, { appRoot = "", options = {}, stdout, stderr })`