@jskit-ai/agent-docs 0.1.249 → 0.1.251

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

@@ -139,8 +139,10 @@ Local functions
 - `messageScrollKey(message = null)`
 - `clearUserScrollIntent()`
 - `resumePendingTailFollow()`
-- `markUserScrollIntent()`
+- `markUserScrollIntent({ upward = false } = {})`
 - `markKeyboardScrollIntent(event = {})`
+- `rememberTouch(event = {})`
+- `markTouchScrollIntent(event = {})`
 - `scrollToLatestMessageAfterLayout({ behavior = "auto", force = false } = {})`
 - `queueInitialBottomScroll()`
 - `queueLiveBottomScroll({ force = false } = {})`
@@ -355,10 +357,14 @@ Exports
 - `bindClaudeConversationAccount(entry, { identity, providerId, allowAccountChange = false, stop, save })`
 - `claudePlanUsage(value)`
 - `claudeCatalogueModels(initialization)`
-- `createClaudeAccountQueries({ createProcess, accountIdentity, processes = () => [], isClosing = () => false })`
+- `createClaudeAccountQueries({ createProcess, accountIdentity, configRoot, processes = () => [], isClosing = () => false })`
 - `createClaudeCodeProcess({ command = "claude", execution = createLocalConversationExecution(), env = process.env, workdir, onEvent, onControlRequest, onFailure, onStarted, executionLimits, signal, commandWrapper, initializationTimeoutMs = 30_000, onInitializationProgress, ...options } = {})`
 Local functions
+- `fileRevision(file)`
 - `readNativeClaudeCodeAuthStatus({ env, credentialHome, command, commandRunner, signal })`
+- `claudeCodeAuthStatus(result)`
+- `claudePlanUsageVerified(value)`
+- `presentPlanUsage(reading)`
 
 ### `src/server/conversation/claudeTools.js`
 Exports
@@ -377,6 +383,8 @@ Local functions
 - `failure(message, code = "assistant_claude_turn_failed")`
 - `now()`
 - `hasPendingClaudeStartup(entry)`
+- `nativeWorkSettled(entry)`
+- `runsNativeWork(entry)`
 
 ### `src/server/conversation/codexAuthPreflight.js`
 Exports
@@ -404,7 +412,7 @@ Exports
 - `codexAppServerTurnSettings({ effectiveSettings, cwd = "", effort = "", model = "", approvalPolicy, reasoningSummary, sandboxPolicy, externalSandbox = false } = {})`
 - `codexInteractiveArguments({ command, threadId = "", remoteEndpoint = "", model, effort, disableStartupUpdates = false, bypassApprovalsAndSandbox = false, bypassHookTrust = false } = {})`
 - `codexAppServerProjectHookTrustConfig(provider, cwd = "", { persist = false } = {})`
-- `prepareCodexModelCatalog({ command, runtimeDir, bundled = false, signal, additionalModels = [] })`
+- `prepareCodexModelCatalog({ command, runtimeDir, bundled = false, signal, additionalModels = [], codexHome = process.env.CODEX_HOME || path.join(os.homedir(), ".codex") })`
 - `readCodexModelContextWindow({ runtimeDir, model } = {})`
 - `codexAppServerTextHasControlCharacters(value = "")`
 - `createCodexAppServerIsolation({ clientName = "jskit", minimumVersion = "0.151.0", disabledFeatures = DISABLED_FEATURES, limits: { userAgentMaxLength = 512, mcpServerMaxCount = 128, mcpServerNameMaxLength = 256, configResponseMaxBytes = 256 * 1024, hookMaxCount = 256, hookErrorMaxCount = 256, hookFieldMaxLength = 2048, hookFingerprintMaxLength = 256 * 1024, hookResponseMaxBytes = 512 * 1024 } = {}, createError = codexAppServerIsolationPolicyError } = {})`
@@ -424,6 +432,7 @@ Exports
 - `codexAuthOutputRequiresReconnect(output = "")`
 - `CODEX_APP_SERVER_ACCOUNT_ID_MAX_LENGTH`
 Local functions
+- `codexModelCatalogRevision({ command, codexHome, bundled, additionalModels })`
 - `isPlainRecord(value)`
 - `deepFreezeCodexAppServerHelperConfig(value)`
 - `codexAppServerIsolationPolicyError(message = "", details = {})`
@@ -431,7 +440,7 @@ Local functions
 
 ### `src/server/conversation/codexConversations.js`
 Exports
-- `createCodexConversationCommands({ checkpoint, codexAppServerConversationMessageId, codexAppServerStreamMessage, conversationPreparation, ensureCodexAppServerProviderForActiveTurn, errorPrefix, helperLifecycle, helperOwnershipError, interruptFailedCode, namespace, providerSessions, sessionConnection, ensureSessionProvider, steerFailedCode, turnOutcomes })`
+- `createCodexConversationCommands({ checkpoint, codexAppServerConversationMessageId, codexAppServerStreamMessage, conversationPreparation, ensureCodexAppServerProviderForActiveTurn, errorPrefix, helperLifecycle, helperOwnershipError, interruptFailedCode, namespace, providerSessions, ensureSessionProvider, borrowSessionProvider, steerFailedCode, turnOutcomes })`
 
 ### `src/server/conversation/codexConversationStore.js`
 Exports
@@ -485,6 +494,7 @@ Exports
 - `codexAppServerUserMessageText(item = {})`
 Local functions
 - `nonNegativeInteger(value)`
+- `codexAppServerSignedOutText(text = "")`
 - `codexAppServerTextInputText(input = {})`
 - `codexAppServerHookPromptText(item = {})`
 - `codexAppServerFinalEventText(notification = {}, event = null, payload = {})`
@@ -535,6 +545,13 @@ Local functions
 - `restoreCompactedHistory(body, { destination, historyPath, codexHome, signal, maxRequestBytes })`
 - `forwardedHeaders(input)`
 
+### `src/server/conversation/codexHomeStorage.js`
+Exports
+- `codexDisabledProcessFeatureArguments()`
+- `codexHomeDisposablePaths(codexHome, { retired = false } = {})`
+Local functions
+- `directoryNames(directory)`
+
 ### `src/server/conversation/codexMessageCommands.js`
 Exports
 - `createCodexMessageCommands({ output, journal, recovery, threadStatus, selection, observer, delivery, promptDeliveries: codexAppServerPromptDeliveries, createRuntime, debugError, debugLog, errorPrefix, messageIdPrefix, messageMetadata, namespace, providerSessions, recoverAdmission, steerFailedCode, turnAlreadyRunningError, turnState })`
@@ -590,6 +607,7 @@ Exports
 - `codexAppServerHelperHomeDir(runtimeDir = "")`
 - `codexAppServerHelperWorkspaceDir(runtimeDir = "")`
 - `codexAppServerProcessCwd({ executionRoot = "", runtimeDir = "", workdir = "" } = {})`
+- `removeCodexAppServerRuntimeDir(runtimeDir = "")`
 - `codexAppServerRuntimeIdentity(runtime = {})`
 - `normalizeCodexAppServerTerminalEnv(terminalEnv = {})`
 - `codexAppServerCommandBaseEnv({ env = process.env, terminalEnv = {} } = {})`
@@ -617,7 +635,6 @@ Local functions
 - `codexAppServerUnixEndpoint(socketPath = "")`
 - `codexAppServerProjectTrustOverride(workdir = "")`
 - `codexAppServerRuntimeDirIsManaged(runtimeDir = "")`
-- `removeCodexAppServerRuntimeDir(runtimeDir = "")`
 - `removeCodexAppServerMetadataTemps(runtimeDir = "")`
 - `codexAppServerRuntimeCleanupCanSkip(error)`
 - `codexHistoryAdapterUrlIsValid(baseUrl, token)`
@@ -667,7 +684,7 @@ Local functions
 - `codexAppServerThreadRequestParams(params = {}, threadEnv = {})`
 - `codexControlProbeCommand(keys, marker)`
 - `codexAppServerThreadInventoryError(errorCode, label, detail)`
-- `listBoundedCodexAppServerThreadIds({ ancestorThreadId = "", archived = false, client, cwd = "", errorCode = "", label = "", requestLabel = "", runRequest, signal = null, sourceKinds = ["appServer"], state, verifyCwd = false } = {})`
+- `listBoundedCodexAppServerThreadIds({ ancestorThreadId = "", archived = false, client, cwd = "", errorCode = "", findThreadId = "", label = "", requestLabel = "", runRequest, signal = null, sourceKinds = ["appServer"], state, verifyCwd = false } = {})`
 - `codexPlanUsage(limits = {})`
 - `normalizeAgentThread(value = {})`
 - `normalizeAgentTurn(value = {})`
@@ -675,11 +692,14 @@ Local functions
 ### `src/server/conversation/codexProviderOwner.js`
 Exports
 - `codexAppServerOwnedRuntimeKey(providerKey = "", providerOptions = {})`
+- `releaseSupersededCodexRuntime(runtimeDir = "")`
 - `codexAppServerRuntimeStopWasVerified(result = {})`
 - `directoryExists(filePath = "")`
-- `createCodexAppServerProviderOwner({ runtimeRoot = "", assertOpen: assertApplicationOpen = () => {}, onRecoveryEvent = () => {}, debugLog = () => {}, debugError = error => error, providerFactory = null, prepareNativeHost = () => ({}), runtimeBusyCode = "codex_app_server_runtime_busy", exitUnverifiedCode = "codex_runtime_exit_unverified", requiredStopCode = "codex_runtime_exit_unverified", runtimeCloseError = "Codex app-server runtime close failed." } = {})`
+- `createCodexAppServerProviderOwner({ runtimeRoot = "", assertOpen: assertApplicationOpen = () => {}, onRecoveryEvent = () => {}, debugLog = () => {}, debugError = error => error, providerFactory = null, prepareNativeHost = () => ({}), runtimeBusyCode = "codex_app_server_runtime_busy", exitUnverifiedCode = "codex_runtime_exit_unverified", requiredStopCode = "codex_runtime_exit_unverified", runtimeCloseError = "Codex app-server runtime close failed.", transientIdleMs = 60_000 } = {})`
 Local functions
 - `withRuntimeLifecycle(runtimeKey, operation)`
+- `nativeRequest(client, method, params)`
+- `runningNativeThreads(peers)`
 
 ### `src/server/conversation/codexProviderSelection.js`
 Exports
@@ -716,7 +736,7 @@ Exports
 
 ### `src/server/conversation/codexRuntimeLifecycle.js`
 Exports
-- `createCodexRuntimeLifecycle({ pendingWork, observer, checkManagedConnection, providerSessions, helperLifecycle, captureContext, runInContext, debugLog, debugError, closingError = null })`
+- `createCodexRuntimeLifecycle({ pendingWork, observer, checkManagedConnection, providerSessions, helperLifecycle, captureContext, runInContext, continueGoalAfterAccountChange = null, debugLog, debugError, closingError = null })`
 
 ### `src/server/conversation/codexSessionCleanup.js`
 Exports
@@ -736,7 +756,7 @@ Exports
 
 ### `src/server/conversation/codexTurn.js`
 Exports
-- `createCodexAppServerRunOwner({ namespace = normalizeCodexRunText, normalizeRunState = normalizeCodexAppServerRunState, debugLog = () => {}, debugError = error => normalizeCodexRunText(error?.message || error), createRuntime, createStore, publish = async () => null, acquireProvider = async () => null, providerSessions = null, serverClosingError = null, helperThreads = null, modelCatalogCacheMs = 30_000, conversationPreparation = null, storeReadError = "The session store does not support agent-run reads.", sessionIdRequiredError = "A session ID is required.", turnClaimsUnsupportedError = "The session runtime does not support Codex turn claims.", turnAlreadyRunningError = "Codex is already working on this session.", messageIdPrefix = "codex:", idlePublishPayload = null, checkpoint = async () => null, messageMetadata = {}, persistCommentary = true, deliveryStateMetadataKey = "assistant_delivery", hasRuntime = () => true, recoverAdmission = null, admissionTaskFinished = () => false, outcomeNotice = async () => null, resultDeliveryFailureMessage = ({ error = "" } = {}) => { const detail = normalizeCodexRunText(error); if (!detail) return "Codex app-server finished this turn, but the assistant result text was not received."; const punctuation = [".", "!", "?"].some(character => detail.endsWith(character)) ? "" : "."; return "Codex completed, but its response could not be processed: " + detail + punctuation; }, orphanedPromptMessage = "The application restarted before Codex confirmed the message. Your message is safe; retry it.", onNotificationSignal = async () => null, captureContext = () => null, runInContext = (_context, operation) => operation(), notificationQueue = null, activeReconcileMs = 2000, finalizingGraceMs = 10000, finalizingGraceAfterHistoryRead = false, failureDetailGraceMs = 0, steerFailedCode = "codex_turn_steer_failed", interruptFailedCode = "codex_turn_interrupt_failed", errorPrefix = "" } = {})`
+- `createCodexAppServerRunOwner({ namespace = normalizeCodexRunText, normalizeRunState = normalizeCodexAppServerRunState, debugLog = () => {}, debugError = error => normalizeCodexRunText(error?.message || error), createRuntime, createStore, publish = async () => null, acquireProvider = async () => null, providerSessions = null, serverClosingError = null, helperThreads = null, modelCatalogCacheMs = 30_000, conversationPreparation = null, storeReadError = "The session store does not support agent-run reads.", sessionIdRequiredError = "A session ID is required.", turnClaimsUnsupportedError = "The session runtime does not support Codex turn claims.", turnAlreadyRunningError = "Codex is already working on this session.", messageIdPrefix = "codex:", idlePublishPayload = null, checkpoint = async () => null, messageMetadata = {}, persistCommentary = true, deliveryStateMetadataKey = "assistant_delivery", hasRuntime = () => true, recoverAdmission = null, admissionTaskFinished = () => false, outcomeNotice = async () => null, resultDeliveryFailureMessage = ({ error = "" } = {}) => { const detail = normalizeCodexRunText(error); if (!detail) return "Codex app-server finished this turn, but the assistant result text was not received."; const punctuation = [".", "!", "?"].some(character => detail.endsWith(character)) ? "" : "."; return "Codex completed, but its response could not be processed: " + detail + punctuation; }, orphanedPromptMessage = "The application restarted before Codex confirmed the message. Your message is safe; retry it.", onNotificationSignal = async () => null, captureContext = () => null, runInContext = (_context, operation) => operation(), // Resumes a goal an account change paused, once the previous account's // runtime has stopped: `(sessionId, { threadId })`. Without it the goal stays // paused for the person to resume. continueGoalAfterAccountChange = null, notificationQueue = null, activeReconcileMs = 2000, finalizingGraceMs = 10000, finalizingGraceAfterHistoryRead = false, failureDetailGraceMs = 0, steerFailedCode = "codex_turn_steer_failed", interruptFailedCode = "codex_turn_interrupt_failed", errorPrefix = "" } = {})`
 - `CODEX_APP_SERVER_RUN_STATE`
 - `normalizeCodexAppServerRunState`
 - `codexAppServerRunStateIsActive`
@@ -940,7 +960,7 @@ Exports
 - `retireOpenCodeConversationHistory(storageClient, controlClient, binding, options = {})`
 - `openCodeAssistantMessageText(message = {})`
 - `OPENCODE_RESPONSE_LIMIT_BYTES`
-- `createOpenCodeServerClient({ allowAttachmentDirectories = false, baseUrl = "", directory = "", fetchImpl = globalThis.fetch, password = "", username = "opencode" } = {})`
+- `createOpenCodeServerClient({ allowAttachmentDirectories = false, baseUrl = "", defaultDirectory = "", directory = "", fetchImpl = globalThis.fetch, instances = { addressed: new Map(), sequence: 0 }, password = "", username = "opencode" } = {})`
 - `readBoundedResponse(response, limitBytes = OPENCODE_RESPONSE_LIMIT_BYTES)`
 Local functions
 - `record(value)`
@@ -993,6 +1013,7 @@ Exports
 - `createOpenCodeConversationPlugin`
 Local functions
 - `availableLoopbackPort()`
+- `openCodeExitReason(logs)`
 - `waitForOpenCodeReady({ client, expectedVersion = OPENCODE_EXPECTED_VERSION, processHandle, timeoutMs = OPENCODE_READY_TIMEOUT_MS, signal } = {})`
 - `actionPermission(action)`
 - `agentPermission(ask, nativeTools, tools)`
@@ -1009,7 +1030,7 @@ Exports
 - `openCodeModel(selection = {}, executionProfile = null)`
 - `sameOpenCodeSelection(left = {}, right = {})`
 - `ensureOpenCodeSession(target, { selection, model, workdir = target.workdir, identity = {}, signal, invalidIdentity = () => new Error("OpenCode did not return a native conversation ID.") })`
-- `createOpenCodeSharedRuntime({ onStop = () => {}, scope } = {})`
+- `createOpenCodeSharedRuntime({ onStop = () => {}, scope, storageIdleMs = 60_000 } = {})`
 Local functions
 - `openCodeTurnSnapshot(turn = null, threadId = "")`
 - `openCodeCredentialFailure(value = "")`
@@ -1231,6 +1252,8 @@ Exports
 - `createCodexAccountReader`
 - `createCodexAppServerIsolation`
 - `readCodexToolFreeConfiguration`
+- `codexDisabledProcessFeatureArguments`
+- `codexHomeDisposablePaths`
 
 ### `src/server/hosts/codexEvents.js`
 Exports
@@ -1839,6 +1862,7 @@ Local functions
 Exports
 - None
 Local functions
+- `cancelMessage(id)`
 - `accept()`
 
 ### `fixtures/responsive-assistant/main.js`

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

@@ -45,7 +45,7 @@ Local functions
 
 ### `src/server/defineCrudJsonApiFeature.js`
 Exports
-- `defineCrudJsonApiFeature({ resource, id = "", capability = "", surface, ownershipFilter = "", relativePath = "", internal = false, routes = true, listFilterQueryValidator = null, searchSchema = null, permissions = null, scope = {}, requires = {}, decorateRepository = null, decorateService = null, operationLifecycle = {}, operationInputs = {}, actions = {}, operations = undefined } = {})`
+- `defineCrudJsonApiFeature({ resource, id = "", capability = "", surface, ownershipFilter = "", relativePath = "", internal = false, routes = true, listFilterQueryValidator = null, searchSchema = null, permissions = null, scope = {}, requires = {}, decorateRepository = null, decorateService = null, operationLifecycle = {}, operationInputs = {}, actions = {}, operations = undefined, realtimeAudience = "event_scope" } = {})`
 Local functions
 - `normalizeAccess(resource = {})`
 - `normalizeScope(scope = {})`
@@ -74,7 +74,7 @@ Local functions
 ### `src/server/jsonApiModule/actions.js`
 Exports
 - `assertCrudOperationName(operation = "")`
-- `createCrudJsonApiActions({ namespace, resource, repository = null, service, surface, permissionForOperation, permissionForAction = permissionForOperation, operations = CRUD_OPERATION_NAMES, scopeInputValidator = null, scopeInputKeys = [], listFilterQueryValidator = null, operationLifecycle = {}, operationInputs = {}, actions: additionalActionDefinitions = {}, dependencies = {} } = {})`
+- `createCrudJsonApiActions({ namespace, resource, repository = null, service, surface, permissionForOperation, permissionForAction = permissionForOperation, operations = CRUD_OPERATION_NAMES, scopeInputValidator = null, scopeInputKeys = [], listFilterQueryValidator = null, operationLifecycle = {}, operationInputs = {}, actions: additionalActionDefinitions = {}, dependencies = {}, realtimeAudience = "event_scope" } = {})`
 - `normalizeCrudOperationLifecycle(value = {})`
 Local functions
 - `isRecord(value)`

package/reference/autogen/packages/http-web.md

@@ -96,6 +96,14 @@ Local functions
 Exports
 - None
 
+### `src/client/components/SelectField.vue`
+Exports
+- None
+Local functions
+- `titleOf(item)`
+- `valueOf(item)`
+- `update(value)`
+
 ### `src/client/composables/crud/crudBindingSupport.js`
 Exports
 - `CRUD_BINDING_MODE_ROUTE`
@@ -598,6 +606,15 @@ Exports
 - `formatDateOnlyDisplay(value = "", { locale = undefined } = {})`
 - `formatCrudListDateFilterChipLabel(filter = {}, rawValue, { locale = undefined } = {})`
 
+### `src/client/support/selectFieldSupport.js`
+Exports
+- `optionTitle(item, itemTitle)`
+- `optionValue(item, itemTitle, itemValue)`
+- `selectionFieldState(field, seen)`
+Local functions
+- `readOption(item, key, fallback)`
+- `selectedValues(modelValue, multiple)`
+
 ### fixtures
 
 ### `fixtures/crud-list-date-filters/App.vue`
@@ -612,6 +629,18 @@ Exports
 Exports
 - None
 
+### `fixtures/select-field/App.vue`
+Exports
+- None
+
+### `fixtures/select-field/main.js`
+Exports
+- None
+
+### `fixtures/select-field/vite.config.mjs`
+Exports
+- None
+
 ### patterns
 
 ### `patterns/crud-screen-set/example/books/BookEditPage.vue`

package/reference/autogen/packages/kernel.md

@@ -60,6 +60,12 @@ Exports
 - `resolveLinkPath`
 - `normalizePathname`
 
+### `shared/support/clientBuild.js`
+Exports
+- `CLIENT_BUILD_META_NAME`
+- `clientBuildIdFromHtml(html = "")`
+- `pageClientBuildId(documentObject = globalThis.document)`
+
 ### `shared/support/deepFreeze.js`
 Exports
 - `deepFreeze(value, seen = new WeakSet())`
@@ -926,6 +932,10 @@ Local functions
 - `normalizeConfigObject(value)`
 - `loadConfigModuleAtPath(absolutePath)`
 
+### `server/support/clientBuild.js`
+Exports
+- `readServedClientBuildId({ appRoot } = {})`
+
 ### `server/support/defaultMissingHandler.js`
 Exports
 - `defaultMissingHandler(_request, reply)`
@@ -960,6 +970,7 @@ Exports
 - `resolveRequiredAppRoot`
 - `toPosixPath`
 - `tryAcquireExclusiveFileLock`
+- `readServedClientBuildId`
 
 ### `server/support/path.js`
 Exports

package/reference/autogen/packages/realtime.md

@@ -44,6 +44,7 @@ Exports
 - `resolveRealtimeClientConfig({ env = {}, mobile = null } = {})`
 Local functions
 - `createRealtimeClient({ config, loggerInput } = {})`
+- `trackServedClientBuild(socket, logger)`
 
 ### `src/client/runtime.js`
 Exports
@@ -108,6 +109,14 @@ Local functions
 - `resolveHttpServer({ httpServer = null, fastify = null } = {})`
 - `buildSocketIoRedisAdapterKey(redisNamespace = "")`
 
+### `src/server/servedClientBuild.js`
+Exports
+- `announceServedClientBuild({ io, appRoot, logger })`
+
+### `src/shared/servedClientBuild.js`
+Exports
+- `SERVED_CLIENT_BUILD_EVENT`
+
 ### patterns
 
 ### `patterns/realtime-application/example/src/placement.js`

package/reference/autogen/packages/shell-web.md

@@ -52,6 +52,12 @@ Exports
 - `normalizeBootstrapPayloadHandler`
 - `resolveBootstrapErrorStatusCode`
 
+### `src/client/clientUpdate/runtime.js`
+Exports
+- `createShellClientUpdateRuntime({ errorRuntime, reload, pageBuildId = pageClientBuildId(), appName = loadedAppName() } = {})`
+Local functions
+- `loadedAppName(documentObject = globalThis.document)`
+
 ### `src/client/components/ShellErrorHost.vue`
 Exports
 - None

package/skills/jskit/references/existing-application-migration.md

@@ -62,7 +62,13 @@ or operation boundary. A Feature declares stable named `requires`, optional
 inputs, and `provides`; `setup()` receives those values directly and returns
 only the promised outputs. Named actions capture the exact feature APIs they
 need. Register structural catalogue entries during `setup()` and reserve
-`boot()` for long-lived work that starts after composition.
+`boot()` for long-lived work that starts after composition. `shutdown()` stops
+that work. The runtime shuts Features down in reverse order and keeps going
+after one fails; it then rejects with an `AggregateError` holding one error per
+failed Feature, each naming its `providerId`. While shutdown runs,
+`diagnostics().providerShutdowns` lists every shutdown with its status
+(`stopping`, `stopped` or `failed`) and duration, so a host can log which one is
+slow.
 
 Capability ids, action ids, routes, events, resources, and placements are
 stable identities. They are not permission to fetch arbitrary dependencies by