@jskit-ai/agent-docs 0.1.216 → 0.1.218

package/guide/agent/app-extras/assistant-conversation.md

@@ -2045,6 +2045,17 @@ receipt inspection and native preservation. Presentation pagination filters befo
 selecting the page, so its counts and cursors describe the visible product turns.
 Caller data or JSON-looking text cannot mark a turn as internal.
 
+For browser history, the server can also select `pageUnit: "messages"` when
+calling `readConversationLogPage` or a bound conversation's `read`. The limit
+then counts user, assistant and system messages separately; reasoning and
+commentary remain visible without consuming it. The default still counts whole
+stored turns for internal consumers. Follow the returned `nextBeforeTurnId`
+verbatim: it can identify a boundary between a request and answer in one turn.
+The supplied browser binding merges those partial turns and keeps the same
+boundary through live updates and refreshes. This projection never rewrites
+stored messages. The shared browser page-size default is ten; the application
+host selects the paging unit and its initial limit.
+
 Native continuity uses those same product rows for history versions and API
 briefings while retaining raw canonical envelopes in storage. An application
 coordinator can pass trusted top-level `completedEnvelope: true` and

package/guide/agent/app-setup/upgrading-jskit.md

@@ -119,6 +119,24 @@ composed application manifest and let resolution identify its actual consumers.
 The installed-graph check does not replace application-owned non-JSKIT version
 validation or the original root lockfile checks.
 
+### Explicit development sources
+
+Hosts composing selected source checkouts can pass `sourcePackages`, an explicit
+package-name-to-directory map, to both `checkProject` and `checkInstalledGraph`.
+The former exempts only these replaced names from published declaration and
+root lock/installed-version comparisons. Pass the corresponding **materialized**
+directories to the latter: it validates package identity and required dependencies,
+rejects resolution outside each selected real path, and still rejects duplicate
+singleton runtimes, including identical-version copies. Selected source versions
+and their consumer ranges need not match the published catalog.
+
+Always run both stages. Source preflight alone does not prove a usable graph.
+The host still validates external dependency compatibility and prepared exports.
+Unselected packages retain ordinary checks. This programmatic development option
+does not modify manifests or locks, change release pins, or relax CLI/update/CI
+defaults. A missing selected checkout must fail; it is not permission to choose a
+published package instead.
+
 ## Enforce the graph in CI
 
 Run this after `npm ci`, and include it in the application's normal verifier:

package/package.json

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

package/patterns/minimal-foundation/example/package.json

@@ -48,7 +48,7 @@
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.241",
-    "@jskit-ai/jskit-catalog": "0.1.269",
+    "@jskit-ai/jskit-catalog": "0.1.271",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/patterns/shell-foundation/example/package.json

@@ -50,7 +50,7 @@
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.241",
-    "@jskit-ai/jskit-catalog": "0.1.269",
+    "@jskit-ai/jskit-catalog": "0.1.271",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/reference/autogen/PATTERN_INDEX.md

@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
 
 - Id: `app/minimal-foundation`
 - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.216`
+- Owner: `@jskit-ai/agent-docs@0.1.218`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
 
 - Id: `app/shell-foundation`
 - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.216`
+- Owner: `@jskit-ai/agent-docs@0.1.218`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
 
 - Id: `assistant/assistant-surface`
 - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/assistant-runtime@0.1.215`
+- Owner: `@jskit-ai/assistant-runtime@0.1.217`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/assistant/assistant-surface/example/)
 - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
 
 - Id: `server/feature-package`
 - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
-- Owner: `@jskit-ai/agent-docs@0.1.216`
+- Owner: `@jskit-ai/agent-docs@0.1.218`
 - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
 - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
 - Requires: `@jskit-ai/kernel`

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

@@ -306,7 +306,7 @@ Exports
 - `deleteClaudeConversationHistory({ configRoot, workdir, conversationId })`
 - `retireClaudeConversationHistory({ configRoot, binding, beforeDelete, requireIdle, signal })`
 - `claudeHistoryPath({ configRoot, workdir, conversationId })`
-- `claudeMessageBlocks(frame, { includeNested = false } = {})`
+- `claudeMessageBlocks(frame, { includeNested = false, commentary = false } = {})`
 - `readClaudeHistory(options)`
 - `requireClaudeSessionId(id)`
 - `archivedClaudeProjectDirectory(workdir)`
@@ -1036,6 +1036,7 @@ Local functions
 ### `src/server/conversation/providers/scoped.js`
 Exports
 - `runScopedConversationTurn({ operations, scope = {}, input = {}, context: options = {}, executionProfile: profileSnapshot } = {})`
+- `projectStoredPersistentConversation(options)`
 - `readPersistentConversation(options)`
 - `startPersistentConversationTurn(options)`
 - `inspectPersistentConversationAdmission(options)`
@@ -1048,6 +1049,7 @@ Local functions
 - `qualifyTranscript(turns, record, response, receipts)`
 - `publishTranscript({ sessionId, store, receipts, publish }, context, record, turns, response = {})`
 - `streamMessage({ sessionId, store, projection, publish }, context, record, event)`
+- `projectPersistentConversation(options, context, record, response, turns)`
 
 ### `src/server/conversation/runtime.js`
 Exports
@@ -1551,6 +1553,8 @@ Local functions
 ### `src/shared/conversation/pagination.js`
 Exports
 - `CONVERSATION_LOG_PAGE_LIMIT`
+- `conversationLogPageStart(turns, limit, end = turns.length)`
+- `conversationLogPage(turns, { beforeTurnId = "", limit = 0 } = {})`
 - `normalizeConversationLogPagination(pagination = {})`
 - `normalizeConversationLogPage(payload = {})`
 - `mergeConversationLogPages(pages = [])`

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

@@ -63,8 +63,8 @@ Exports
 - `CHECK_SCRIPT`
 - `DEPENDENCY_FIELDS`
 - `UPDATE_SCRIPT`
-- `checkProject({ projectRoot = process.cwd(), catalog, additionalManifests = [], checkInstalled = false } = {})`
-- `checkInstalledGraph({ catalog, manifestPaths = [] } = {})`
+- `checkProject({ projectRoot = process.cwd(), catalog, additionalManifests = [], checkInstalled = false, sourcePackages = {} } = {})`
+- `checkInstalledGraph({ catalog, manifestPaths = [], sourcePackages = {} } = {})`
 - `resolveInstalledPackage(consumerDirectory, packageId)`
 - `collectLockInstallations(packageLock = {})`
 - `discoverProjectManifests(projectRoot, additionalManifests = [])`

package/skills/jskit/references/pattern-index.md

@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
 
 - Id: `app/minimal-foundation`
 - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.216`
+- Owner: `@jskit-ai/agent-docs@0.1.218`
 - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
 - Examples: [example/](patterns/app/minimal-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
 
 - Id: `app/shell-foundation`
 - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
-- Owner: `@jskit-ai/agent-docs@0.1.216`
+- Owner: `@jskit-ai/agent-docs@0.1.218`
 - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
 - Examples: [example/](patterns/app/shell-foundation/example/)
 - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`, `@jskit-ai/shell-web`
@@ -37,7 +37,7 @@ Configure an assistant runtime for one application surface and expose its chat a
 
 - Id: `assistant/assistant-surface`
 - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
-- Owner: `@jskit-ai/assistant-runtime@0.1.215`
+- Owner: `@jskit-ai/assistant-runtime@0.1.217`
 - Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
 - Examples: [example/](patterns/assistant/assistant-surface/example/)
 - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -323,7 +323,7 @@ Define a server feature through explicit capabilities and first-class actions, a
 
 - Id: `server/feature-package`
 - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
-- Owner: `@jskit-ai/agent-docs@0.1.216`
+- Owner: `@jskit-ai/agent-docs@0.1.218`
 - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
 - Examples: [example/](patterns/server/feature-package/example/)
 - Requires: `@jskit-ai/kernel`

package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json

@@ -48,7 +48,7 @@
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.241",
-    "@jskit-ai/jskit-catalog": "0.1.269",
+    "@jskit-ai/jskit-catalog": "0.1.271",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",

package/skills/jskit/references/patterns/app/shell-foundation/example/package.json

@@ -50,7 +50,7 @@
   },
   "devDependencies": {
     "@jskit-ai/config-eslint": "0.1.241",
-    "@jskit-ai/jskit-catalog": "0.1.269",
+    "@jskit-ai/jskit-catalog": "0.1.271",
     "@playwright/test": "1.61.1",
     "@vitejs/plugin-vue": "^6.0.7",
     "eslint": "^10.8.0",