@jskit-ai/agent-docs 0.1.267 → 0.1.268

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/guide/agent/app-extras/assistant-conversation.md +16 -4
  2. package/package.json +1 -1
  3. package/patterns/minimal-foundation/example/package.json +1 -1
  4. package/patterns/shell-foundation/example/package.json +1 -1
  5. package/reference/autogen/PATTERN_INDEX.md +4 -4
  6. package/reference/autogen/tooling/jskit-release.md +4 -3
  7. package/skills/jskit/references/pattern-index.md +4 -4
  8. package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json +1 -1
  9. package/skills/jskit/references/patterns/app/shell-foundation/example/package.json +1 -1
package/guide/agent/app-extras/assistant-conversation.md CHANGED
@@ -3434,10 +3434,22 @@ be stopped. Claude stops its sessions together, leaves an idle chat untouched
3434
3434
  in `failed` while the others still stop. A turn still running when its process
3435
3435
  stops is not ended at shutdown: its saved record keeps the execution and the
3436
3436
  active turn, as after a crash, so the next server's recovery proves that exit,
3437
- interrupts the turn and runs the host's interrupted checkpoint. A slow host
3438
- checkpoint, such as a Git snapshot, never holds up shutdown. Claude stops its
3439
- sessions even when its account-query cleanup fails; that failure is still the
3440
- call's result. Once
3437
+ interrupts the turn and runs the host's interrupted checkpoint. OpenCode
3438
+ likewise interrupts a running turn's native work and proves its shared process
3439
+ exits, and marks that turn as stopped by shutdown. A main conversation's saved
3440
+ run stays active with the mark (`stoppedByShutdown`), and the next server
3441
+ records the turn interrupted, with the host's checkpoint, when the chat is next
3442
+ prepared or a goal's recovery reconciles it. A temporary conversation's turn
3443
+ ends interrupted, and `afterClose` receives `stoppedByShutdown: true` so the
3444
+ host leaves its checkpoint to the next server: when the host's later read
3445
+ passes the stopped run as `stoppedByShutdown: { runId, ended }`, that read
3446
+ reports the run interrupted, not failed, and calls `ended` so the host makes
3447
+ the checkpoint. A native abort without the mark (a timeout, or a crash's
3448
+ leftover) still reads as that turn's failure. Either way a slow host
3449
+ checkpoint, such as a Git snapshot, never holds up shutdown, and a Stop or
3450
+ session close outside shutdown still ends its turn through that checkpoint.
3451
+ Claude stops its sessions even when its
3452
+ account-query cleanup fails; that failure is still the call's result. Once
3441
3453
  shutdown has invalidated the owner, a later session close only releases retained
3442
3454
  work. Failed cleanup can be retried after runtime closure. This is not a browser
3443
3455
  operation or a way to submit a caller-selected native owner.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/agent-docs",
3
- "version": "0.1.267",
3
+ "version": "0.1.268",
4
4
  "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
5
5
  "type": "module",
6
6
  "files": [
package/patterns/minimal-foundation/example/package.json CHANGED
@@ -49,7 +49,7 @@
49
49
  },
50
50
  "devDependencies": {
51
51
  "@jskit-ai/config-eslint": "0.1.245",
52
- "@jskit-ai/jskit-catalog": "0.2.19",
52
+ "@jskit-ai/jskit-catalog": "0.2.20",
53
53
  "@playwright/test": "1.61.1",
54
54
  "@vitejs/plugin-vue": "^6.0.7",
55
55
  "eslint": "^10.8.0",
package/patterns/shell-foundation/example/package.json CHANGED
@@ -51,7 +51,7 @@
51
51
  },
52
52
  "devDependencies": {
53
53
  "@jskit-ai/config-eslint": "0.1.245",
54
- "@jskit-ai/jskit-catalog": "0.2.19",
54
+ "@jskit-ai/jskit-catalog": "0.2.20",
55
55
  "@playwright/test": "1.61.1",
56
56
  "@vitejs/plugin-vue": "^6.0.7",
57
57
  "eslint": "^10.8.0",
package/reference/autogen/PATTERN_INDEX.md CHANGED
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.267`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.268`
19
19
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](../../skills/jskit/references/patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.267`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.268`
30
30
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](../../skills/jskit/references/patterns/app/shell-foundation/example/)
32
32
  - 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
37
37
 
38
38
  - Id: `assistant/assistant-surface`
39
39
  - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
40
- - Owner: `@jskit-ai/assistant-runtime@0.2.17`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.2.18`
41
41
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](../../skills/jskit/references/patterns/assistant/assistant-surface/example/)
43
43
  - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Define a server feature through explicit capabilities and first-class actions, a
345
345
 
346
346
  - Id: `server/feature-package`
347
347
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
348
- - Owner: `@jskit-ai/agent-docs@0.1.267`
348
+ - Owner: `@jskit-ai/agent-docs@0.1.268`
349
349
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
350
350
  - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
351
351
  - Requires: `@jskit-ai/kernel`
package/reference/autogen/tooling/jskit-release.md CHANGED
@@ -54,12 +54,12 @@ Local functions
54
54
 
55
55
  ### `src/release.mjs`
56
56
  Exports
57
- - `assertMainReleaseCheckout(repoRoot, { allowAhead = false } = {})`
57
+ - `assertReleaseCheckout(repoRoot, { allowAhead = false, branch = "main" } = {})`
58
58
  - `bumpPatch`
59
59
  - `collectPublishDependencies`
60
60
  - `collectPatternPackageJsonPaths`
61
61
  - `collectVersionMismatches`
62
- - `commitAndPush(repoRoot, message)`
62
+ - `commitAndPush(repoRoot, message, branch = "main")`
63
63
  - `discoverManifests`
64
64
  - `discoverReleasePackages`
65
65
  - `main(argv = process.argv.slice(2))`
@@ -79,12 +79,13 @@ Local functions
79
79
  - `prepareRelease({ cwd: repoRoot, dryRun, registry, report = false })`
80
80
  - `createNpmUserConfig(registry, directory, records = [])`
81
81
  - `git(repoRoot, args)`
82
+ - `commitAll(repoRoot, message)`
82
83
  - `releaseCommitMessage(entries)`
83
84
  - `publishRelease(records, { cwd: repoRoot, registry })`
84
85
  - `publishCommand(options)`
85
86
  - `forgetPinnedLockEntries(repoRoot, names)`
86
87
  - `installReleasedPins(repoRoot, { attempts = 20, delayMs = Number(process.env.JSKIT_RELEASE_RETRY_DELAY_MS || 30_000) } = {})`
87
- - `pinCommand({ cwd: repoRoot, from, dryRun, noCommit })`
88
+ - `pinCommand({ cwd: repoRoot, from, dryRun, noCommit, noPush, branch })`
88
89
 
89
90
  ### bin
90
91
 
package/skills/jskit/references/pattern-index.md CHANGED
@@ -15,7 +15,7 @@ A concrete Fastify, Vue, and JSKIT application foundation for products that do n
15
15
 
16
16
  - Id: `app/minimal-foundation`
17
17
  - Keywords: `app`, `fastify`, `foundation`, `minimal`, `server`, `vite`, `vue`
18
- - Owner: `@jskit-ai/agent-docs@0.1.267`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.268`
19
19
  - Read: [PATTERN.md](patterns/app/minimal-foundation/PATTERN.md)
20
20
  - Examples: [example/](patterns/app/minimal-foundation/example/)
21
21
  - Requires: `@jskit-ai/http-runtime`, `@jskit-ai/kernel`
@@ -26,7 +26,7 @@ A concrete JSKIT web application foundation with responsive shell navigation, se
26
26
 
27
27
  - Id: `app/shell-foundation`
28
28
  - Keywords: `app`, `foundation`, `material`, `navigation`, `placements`, `shell`, `vite`, `vue`
29
- - Owner: `@jskit-ai/agent-docs@0.1.267`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.268`
30
30
  - Read: [PATTERN.md](patterns/app/shell-foundation/PATTERN.md)
31
31
  - Examples: [example/](patterns/app/shell-foundation/example/)
32
32
  - 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
37
37
 
38
38
  - Id: `assistant/assistant-surface`
39
39
  - Keywords: `ai`, `assistant`, `chat`, `config`, `environment`, `page`, `placement`, `settings`, `surface`
40
- - Owner: `@jskit-ai/assistant-runtime@0.2.17`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.2.18`
41
41
  - Read: [PATTERN.md](patterns/assistant/assistant-surface/PATTERN.md)
42
42
  - Examples: [example/](patterns/assistant/assistant-surface/example/)
43
43
  - Requires: `@jskit-ai/assistant-runtime`, `@jskit-ai/connectors-catalog`, `@jskit-ai/connectors-core`, `@jskit-ai/shell-web`
@@ -345,7 +345,7 @@ Define a server feature through explicit capabilities and first-class actions, a
345
345
 
346
346
  - Id: `server/feature-package`
347
347
  - Keywords: `actions`, `feature`, `json-rest`, `knex`, `orchestration`, `package`, `provider`, `repository`, `routes`, `server`
348
- - Owner: `@jskit-ai/agent-docs@0.1.267`
348
+ - Owner: `@jskit-ai/agent-docs@0.1.268`
349
349
  - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
350
350
  - Examples: [example/](patterns/server/feature-package/example/)
351
351
  - Requires: `@jskit-ai/kernel`
package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json CHANGED
@@ -49,7 +49,7 @@
49
49
  },
50
50
  "devDependencies": {
51
51
  "@jskit-ai/config-eslint": "0.1.245",
52
- "@jskit-ai/jskit-catalog": "0.2.19",
52
+ "@jskit-ai/jskit-catalog": "0.2.20",
53
53
  "@playwright/test": "1.61.1",
54
54
  "@vitejs/plugin-vue": "^6.0.7",
55
55
  "eslint": "^10.8.0",
package/skills/jskit/references/patterns/app/shell-foundation/example/package.json CHANGED
@@ -51,7 +51,7 @@
51
51
  },
52
52
  "devDependencies": {
53
53
  "@jskit-ai/config-eslint": "0.1.245",
54
- "@jskit-ai/jskit-catalog": "0.2.19",
54
+ "@jskit-ai/jskit-catalog": "0.2.20",
55
55
  "@playwright/test": "1.61.1",
56
56
  "@vitejs/plugin-vue": "^6.0.7",
57
57
  "eslint": "^10.8.0",