@jskit-ai/agent-docs 0.1.311 → 0.1.313

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 +17 -7
  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/packages/assistant-core.md +2 -0
  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
@@ -348,8 +348,10 @@ no longer restores the message as unconfirmed and a later send may dispatch it.
348
348
  The client marks only that exact uncertain message failed, preserving its
349
349
  payload, the draft and other uncertain messages. Inspection never submits or
350
350
  accepts it. Missing markers, a live process, incomplete cleanup and API-model
351
- requests remain conservative; Codex and OpenCode still report only accepted or
352
- unknown. A retired native request cannot be retried against its successor
351
+ requests remain conservative. An OpenCode conversation bound to its host reports
352
+ the proof when the host's prepared-message inspection answers
353
+ `admission: "not-admitted"`; a standalone OpenCode conversation and Codex still
354
+ report only accepted or unknown. A retired native request cannot be retried against its successor
353
355
  with the old ID; edit its words into a new authored message instead.
354
356
 
355
357
  Incoming saved-state updates refresh the history already loaded with **Load older
@@ -1396,8 +1398,12 @@ picker, screenshot producer or project file browser remains an application tool.
1396
1398
 
1397
1399
  Set `questions` on `AssistantConversationClientElement`, or pass
1398
1400
  `questions: true` to `useAssistantConversation`, to enable ordinary chat answer
1399
- fields. The retained conversation selects the latest authorized completed reply,
1400
- ignores an in-progress reply and stops at a subsequent user message. It owns the
1401
+ fields. The retained conversation offers the newest questions the AI asked since
1402
+ the person's last message: it starts at the latest authorized completed reply,
1403
+ offers nothing while that reply is in progress, reads back over that reply and
1404
+ the AI's earlier replies and commentary, at most ten of them, and stops at a
1405
+ subsequent user message. A short message the AI adds after its questions, such
1406
+ as "I'll start once you've answered", therefore keeps the form. It owns the
1401
1407
  answers, choice, dismissal and submitted-form state; no application selector or
1402
1408
  reset watcher is needed.
1403
1409
 
@@ -1435,9 +1441,13 @@ For custom presentation, the same prop accepts an explicit question owner or the
1435
1441
  existing question adapter. `useAssistantQuestions` from
1436
1442
  `/client/conversation-questions` supplies the extracted answer state to a custom
1437
1443
  composer. Supply its authorized completed message and optional `extraChoice`;
1438
- `latestAssistantMessageAwaitingUserReply` from `/shared/conversation` implements
1439
- the standard message selection. A custom owner remains responsible for its
1440
- message source and scope resets.
1444
+ `latestAssistantQuestionsAwaitingUserReply(conversationLog, { lookback })` from
1445
+ `/shared/conversation` implements the standard message selection, with
1446
+ `lookback` (the most AI messages it reads) defaulting to 10. A server that must
1447
+ know whether the AI is waiting for an answer can read the same message from its
1448
+ saved turns. `latestAssistantMessageAwaitingUserReply` returns the latest
1449
+ completed reply itself, questions or not. A custom owner remains responsible for
1450
+ its message source and scope resets.
1441
1451
 
1442
1452
  `AssistantQuestionInputs` renders numbered question fields and suggested-answer
1443
1453
  chips. Pass `questions`, optional `selectItems` keyed by question name, `choices`,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jskit-ai/agent-docs",
3
- "version": "0.1.311",
3
+ "version": "0.1.313",
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
@@ -50,7 +50,7 @@
50
50
  },
51
51
  "devDependencies": {
52
52
  "@jskit-ai/config-eslint": "0.1.251",
53
- "@jskit-ai/jskit-catalog": "0.2.63",
53
+ "@jskit-ai/jskit-catalog": "0.2.65",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "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.251",
54
- "@jskit-ai/jskit-catalog": "0.2.63",
54
+ "@jskit-ai/jskit-catalog": "0.2.65",
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.311`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.313`
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.311`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.313`
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.53`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.2.55`
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`
@@ -356,7 +356,7 @@ Define a server feature through explicit capabilities and first-class actions, a
356
356
 
357
357
  - Id: `server/feature-package`
358
358
  - Keywords: `actions`, `aggregate`, `feature`, `handle`, `orchestration`, `owns`, `package`, `provider`, `repository`, `routes`, `server`, `table resource`
359
- - Owner: `@jskit-ai/agent-docs@0.1.311`
359
+ - Owner: `@jskit-ai/agent-docs@0.1.313`
360
360
  - Read: [PATTERN.md](../../skills/jskit/references/patterns/server/feature-package/PATTERN.md)
361
361
  - Examples: [example/](../../skills/jskit/references/patterns/server/feature-package/example/)
362
362
  - Requires: `@jskit-ai/kernel`
package/reference/autogen/packages/assistant-core.md CHANGED
@@ -2225,9 +2225,11 @@ Local functions
2225
2225
  ### `src/shared/conversation/questions.js`
2226
2226
  Exports
2227
2227
  - `latestAssistantMessageAwaitingUserReply(conversationLog = {})`
2228
+ - `latestAssistantQuestionsAwaitingUserReply(conversationLog = {}, { lookback = ASSISTANT_QUESTION_LOOKBACK } = {})`
2228
2229
  Local functions
2229
2230
  - `messageText(value = "")`
2230
2231
  - `conversationTurns(conversationLog = {})`
2232
+ - `asksPerson(text)`
2231
2233
 
2232
2234
  ### `src/shared/conversation/scrollFollowState.js`
2233
2235
  Exports
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.311`
18
+ - Owner: `@jskit-ai/agent-docs@0.1.313`
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.311`
29
+ - Owner: `@jskit-ai/agent-docs@0.1.313`
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.53`
40
+ - Owner: `@jskit-ai/assistant-runtime@0.2.55`
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`
@@ -356,7 +356,7 @@ Define a server feature through explicit capabilities and first-class actions, a
356
356
 
357
357
  - Id: `server/feature-package`
358
358
  - Keywords: `actions`, `aggregate`, `feature`, `handle`, `orchestration`, `owns`, `package`, `provider`, `repository`, `routes`, `server`, `table resource`
359
- - Owner: `@jskit-ai/agent-docs@0.1.311`
359
+ - Owner: `@jskit-ai/agent-docs@0.1.313`
360
360
  - Read: [PATTERN.md](patterns/server/feature-package/PATTERN.md)
361
361
  - Examples: [example/](patterns/server/feature-package/example/)
362
362
  - Requires: `@jskit-ai/kernel`
package/skills/jskit/references/patterns/app/minimal-foundation/example/package.json CHANGED
@@ -50,7 +50,7 @@
50
50
  },
51
51
  "devDependencies": {
52
52
  "@jskit-ai/config-eslint": "0.1.251",
53
- "@jskit-ai/jskit-catalog": "0.2.63",
53
+ "@jskit-ai/jskit-catalog": "0.2.65",
54
54
  "@playwright/test": "1.61.1",
55
55
  "@vitejs/plugin-vue": "^6.0.7",
56
56
  "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.251",
54
- "@jskit-ai/jskit-catalog": "0.2.63",
54
+ "@jskit-ai/jskit-catalog": "0.2.65",
55
55
  "@playwright/test": "1.61.1",
56
56
  "@vitejs/plugin-vue": "^6.0.7",
57
57
  "eslint": "^10.8.0",