@jskit-ai/agent-docs 0.1.312 → 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 +13 -5
  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
@@ -1398,8 +1398,12 @@ picker, screenshot producer or project file browser remains an application tool.
1398
1398
 
1399
1399
  Set `questions` on `AssistantConversationClientElement`, or pass
1400
1400
  `questions: true` to `useAssistantConversation`, to enable ordinary chat answer
1401
- fields. The retained conversation selects the latest authorized completed reply,
1402
- 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
1403
1407
  answers, choice, dismissal and submitted-form state; no application selector or
1404
1408
  reset watcher is needed.
1405
1409
 
@@ -1437,9 +1441,13 @@ For custom presentation, the same prop accepts an explicit question owner or the
1437
1441
  existing question adapter. `useAssistantQuestions` from
1438
1442
  `/client/conversation-questions` supplies the extracted answer state to a custom
1439
1443
  composer. Supply its authorized completed message and optional `extraChoice`;
1440
- `latestAssistantMessageAwaitingUserReply` from `/shared/conversation` implements
1441
- the standard message selection. A custom owner remains responsible for its
1442
- 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.
1443
1451
 
1444
1452
  `AssistantQuestionInputs` renders numbered question fields and suggested-answer
1445
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.312",
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.64",
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.64",
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.312`
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.312`
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.54`
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.312`
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.312`
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.312`
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.54`
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.312`
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.64",
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.64",
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",