@vellumai/assistant 0.4.19 → 0.4.21

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 (15) hide show
  1. package/package.json +1 -1
  2. package/src/__tests__/system-prompt.test.ts +2 -7
  3. package/src/__tests__/tool-execution-abort-cleanup.test.ts +0 -1
  4. package/src/agent/loop.ts +324 -163
  5. package/src/config/bundled-skills/app-builder/SKILL.md +7 -5
  6. package/src/config/bundled-skills/app-builder/TOOLS.json +2 -2
  7. package/src/config/system-prompt.ts +563 -539
  8. package/src/daemon/session-surfaces.ts +28 -0
  9. package/src/daemon/session.ts +255 -191
  10. package/src/daemon/tool-side-effects.ts +3 -13
  11. package/src/security/secure-keys.ts +27 -3
  12. package/src/tools/apps/definitions.ts +5 -0
  13. package/src/tools/apps/executors.ts +18 -22
  14. package/src/__tests__/response-tier.test.ts +0 -195
  15. package/src/daemon/response-tier.ts +0 -250
package/src/config/bundled-skills/app-builder/SKILL.md CHANGED
@@ -1323,14 +1323,16 @@ Call `app_create` with:
1323
1323
  - `description`: One-sentence summary
1324
1324
  - `schema_json`: JSON schema as string
1325
1325
  - `html`: Complete HTML document as string
1326
- - `auto_open`: (optional, defaults to `true`) Opens the app immediately
1327
- - `preview`: (optional) Inline preview card — see below
1326
+ - `auto_open`: (optional, defaults to `true`) Shows an inline preview card in chat after creation
1327
+ - `preview`: Always include this — see below
1328
1328
 
1329
- Since `auto_open` defaults to `true`, you don't need to call `app_open` separately after `app_create`.
1329
+ Since `auto_open` defaults to `true`, an inline preview card is shown in chat after creation. The app is NOT opened in a workspace panel automatically — users open it explicitly if desired by clicking 'Open App' on the inline card. The app appears in Things (sidebar) immediately after creation via the `app_files_changed` broadcast.
1330
1330
 
1331
1331
  #### Preview metadata
1332
1332
 
1333
- Both `ui_show` and `app_create` support a `preview` object for an inline chat preview card. Always include it so the user sees a compact summary without opening the app.
1333
+ Always include preview metadata in `app_create` calls. The app shows as an inline card in chat first — no workspace opens automatically. Users can click 'Open App' on the inline card to open the workspace.
1334
+
1335
+ Both `ui_show` and `app_create` support a `preview` object for an inline chat preview card. Always include it so the user sees a compact summary of what was built.
1334
1336
 
1335
1337
  **With `ui_show`:**
1336
1338
  ```json
@@ -1387,7 +1389,7 @@ Both `ui_show` and `app_create` support a `preview` object for an inline chat pr
1387
1389
  }
1388
1390
  ```
1389
1391
 
1390
- Preview fields: `title` (required), `subtitle`, `description`, `icon`, `metrics` (up to 3 key-value pills). The `icon` field accepts an emoji or an image URL. **Prefer an image URL whenever you have a relevant one** — logos, favicons, product images, headshots, flags, album art, or any image you encountered during research. The preview card renders image URLs as a thumbnail automatically. Fall back to emoji only when there is no natural image. When `app_create` is called with `auto_open: true` (the default), the preview is forwarded through `app_open` automatically.
1392
+ Preview fields: `title` (required), `subtitle`, `description`, `icon`, `metrics` (up to 3 key-value pills). The `icon` field accepts an emoji or an image URL. **Prefer an image URL whenever you have a relevant one** — logos, favicons, product images, headshots, flags, album art, or any image you encountered during research. The preview card renders image URLs as a thumbnail automatically. Fall back to emoji only when there is no natural image. When `app_create` is called with `auto_open: true` (the default), the inline preview card is shown in chat — the app is NOT automatically opened in a workspace panel.
1391
1393
 
1392
1394
  ### 6. Handle Iteration
1393
1395
 
package/src/config/bundled-skills/app-builder/TOOLS.json CHANGED
@@ -37,7 +37,7 @@
37
37
  },
38
38
  "auto_open": {
39
39
  "type": "boolean",
40
- "description": "Automatically open the app after creation. Defaults to true. When true, the app is immediately displayed in a dynamic_page surface without needing a separate app_open call."
40
+ "description": "When true (default), an inline preview card is shown in chat after creation. The app is NOT automatically opened in a workspace panel — users can open it explicitly via the 'Open App' button on the inline card."
41
41
  },
42
42
  "set_as_home_base": {
43
43
  "type": "boolean",
@@ -45,7 +45,7 @@
45
45
  },
46
46
  "preview": {
47
47
  "type": "object",
48
- "description": "Optional inline preview card shown in chat. Provides a compact summary so the user sees what was built without opening the app.",
48
+ "description": "Inline preview card shown in chat after creation. Always include this so users see a compact summary of what was built. Required fields: title.",
49
49
  "properties": {
50
50
  "title": { "type": "string", "description": "Preview card title" },
51
51
  "subtitle": { "type": "string", "description": "Optional subtitle" },