@vivix-labs/studio-workbench 1.0.0-beta.2 → 1.0.0-beta.20

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 (38) hide show
  1. package/dist/assets/add-circle-RPMXNTWW.svg +4 -0
  2. package/dist/assets/copy-document-EF4PHM7F.svg +10 -0
  3. package/dist/assets/create-custom-view-WUWJL7YC.svg +5 -0
  4. package/dist/assets/crop-5JXWHIPN.svg +6 -0
  5. package/dist/assets/dashboard-overview-Y32BCZQC.svg +8 -0
  6. package/dist/assets/dashboard-views-GOG66UAH.svg +7 -0
  7. package/dist/assets/delete-4Y3OUMEL.svg +8 -0
  8. package/dist/assets/download-VTKCEAZG.svg +6 -0
  9. package/dist/assets/favorite-6GMNHJCN.svg +5 -0
  10. package/dist/assets/favorite-filled-FR74TEBM.svg +3 -0
  11. package/dist/assets/filter-JSDZZVGN.svg +5 -0
  12. package/dist/assets/fullscreen-exit-ADYOPBYH.svg +3 -0
  13. package/dist/assets/inria-serif-latin-400-italic-ZCFRMMVP.woff2 +0 -0
  14. package/dist/assets/inter-latin-900-normal-FKACR3DR.woff2 +0 -0
  15. package/dist/assets/refresh-WQ3CTB57.svg +3 -0
  16. package/dist/assets/replace-PJXDOQDX.svg +3 -0
  17. package/dist/assets/{search-JUOSGQRM.svg → search-FMYQZJWA.svg} +1 -1
  18. package/dist/assets/select-items-GJZIVO37.svg +6 -0
  19. package/dist/assets/trim-LQMHHN2M.svg +9 -0
  20. package/dist/assets/upload-U5RZT5QI.svg +5 -0
  21. package/dist/assets/welcome-add-HS6LIH63.svg +5 -0
  22. package/dist/assets/welcome-close-NOBXBZOT.svg +5 -0
  23. package/dist/assets/welcome-product-ad-YRPDJRAH.png +0 -0
  24. package/dist/assets/welcome-short-drama-YDTZHBGK.png +0 -0
  25. package/dist/client.bundle.js +2727 -1094
  26. package/dist/client.css +1838 -295
  27. package/dist/server.d.ts +1 -0
  28. package/dist/server.js +326 -36
  29. package/dist/shared.d.ts +27 -1
  30. package/dist/shared.js +2 -1
  31. package/package.json +25 -25
  32. package/presets/table.json +4 -4
  33. package/presets/user-base.json +13 -9
  34. package/skills/SKILL.md +20 -39
  35. package/skills/references/assets-and-views.md +6 -6
  36. package/skills/references/sql-custom-views.md +2 -0
  37. package/skills/scripts/initialize-home.mjs +350 -119
  38. package/dist/assets/player-cover-shade-LLH6KOCQ.png +0 -0
@@ -7,7 +7,7 @@
7
7
  {
8
8
  "id": "data",
9
9
  "package": "@vivix-labs/creative-data",
10
- "version": "1.0.0-beta.2",
10
+ "version": "1.0.0-beta.17",
11
11
  "enabled": true,
12
12
  "config": {},
13
13
  "requiredAccess": ["project.content.read"]
@@ -15,7 +15,7 @@
15
15
  {
16
16
  "id": "library",
17
17
  "package": "@vivix-labs/material-library",
18
- "version": "1.0.0-beta.2",
18
+ "version": "1.0.0-beta.17",
19
19
  "enabled": true,
20
20
  "config": {
21
21
  "role": "service",
@@ -26,7 +26,7 @@
26
26
  {
27
27
  "id": "api",
28
28
  "package": "@vivix-labs/vivix-api",
29
- "version": "1.0.0-beta.2",
29
+ "version": "1.0.0-beta.17",
30
30
  "enabled": true,
31
31
  "config": {},
32
32
  "requiredAccess": ["official.request"]
@@ -34,7 +34,7 @@
34
34
  {
35
35
  "id": "coordinator",
36
36
  "package": "@vivix-labs/project-studio",
37
- "version": "1.0.0-beta.2",
37
+ "version": "1.0.0-beta.17",
38
38
  "enabled": true,
39
39
  "config": {
40
40
  "role": "coordinator",
@@ -47,14 +47,14 @@
47
47
  {
48
48
  "id": "magic-edit",
49
49
  "package": "@vivix-labs/magic-edit",
50
- "version": "1.0.0-beta.2",
50
+ "version": "1.0.0-beta.17",
51
51
  "enabled": true,
52
52
  "config": {}
53
53
  },
54
54
  {
55
55
  "id": "dashboard-projects",
56
56
  "package": "@vivix-labs/dashboard-projects",
57
- "version": "1.0.0-beta.2",
57
+ "version": "1.0.0-beta.17",
58
58
  "enabled": true,
59
59
  "config": {
60
60
  "studioInstance": "coordinator"
@@ -63,7 +63,7 @@
63
63
  {
64
64
  "id": "dashboard-assets",
65
65
  "package": "@vivix-labs/dashboard-assets",
66
- "version": "1.0.0-beta.2",
66
+ "version": "1.0.0-beta.17",
67
67
  "enabled": true,
68
68
  "config": {
69
69
  "studioInstance": "coordinator"
@@ -72,14 +72,14 @@
72
72
  {
73
73
  "id": "asset-list",
74
74
  "package": "@vivix-labs/studio-asset-list",
75
- "version": "1.0.0-beta.2",
75
+ "version": "1.0.0-beta.20",
76
76
  "enabled": true,
77
77
  "config": {}
78
78
  },
79
79
  {
80
80
  "id": "workbench",
81
81
  "package": "@vivix-labs/studio-workbench",
82
- "version": "1.0.0-beta.2",
82
+ "version": "1.0.0-beta.20",
83
83
  "enabled": true,
84
84
  "config": {
85
85
  "studioInstance": "coordinator",
@@ -99,6 +99,10 @@
99
99
  }
100
100
  ],
101
101
  "views": {
102
+ "projectCreator": {
103
+ "plugin": "dashboard-projects",
104
+ "id": "create-project"
105
+ },
102
106
  "assetList": {
103
107
  "plugin": "asset-list",
104
108
  "id": "asset-list"
package/skills/SKILL.md CHANGED
@@ -9,6 +9,8 @@ Use `agent guide --json` to locate the installed workspace Skill for project
9
9
  selection, page opening, and host-adapted result presentation. Discover actual
10
10
  instances, operations, and enabled plugin Skills before unfamiliar work.
11
11
 
12
+ For frontend UI and composition, start with the [Studio plugin view guide](../../ui-system/skills/vivix-studio-ui/references/default-project-views.md). From an installation, `vivix-studio agent guide --json` returns `uiGuidePath`, which leads to the same offline guide in the plugin-development Skill.
13
+
12
14
  Read [assets and views](references/assets-and-views.md) for project assets,
13
15
  immutable versions, fixed favorites, saved SQL views, import/reference semantics,
14
16
  and task recovery. Advertising projects use the separately installed advertising
@@ -34,6 +36,17 @@ revision and set `changes.coverRef` to a saved image's exact VersionRef from tha
34
36
  project, or to `null` to remove it. Verify the saved reference and refresh Manage
35
37
  Projects to see it on both the project card and sidebar.
36
38
 
39
+ With no explicit cover, Home, Projects and the sidebar use the first available storyboard frame in shot order. Clearing the explicit cover restores that automatic choice.
40
+
41
+ ## Remove or restore a project in the workbench
42
+
43
+ Remove project hides the project from the sidebar, Home project cards, and
44
+ Manage Projects. The local directory, registration, and saved content remain
45
+ available. For a request to restore a project by name, match its registered
46
+ ID and discover `workspace.hiddenProjects` and `workspace.setProjectHidden`
47
+ on the user-scope workbench instance. Read the hidden IDs, set
48
+ `hidden: false` for the matching ID, and verify it is no longer hidden.
49
+
37
50
  ## Refresh the affected workbench
38
51
 
39
52
  After an operation succeeds and changes data shown in an open workbench, check that the
@@ -56,45 +69,13 @@ asset and version. Usage count is distinct active target assets, not relation ro
56
69
  Use each actual scope's describe output to discover configured instance IDs;
57
70
  custom projects need not use the default studio/api IDs or enable the library.
58
71
 
59
- For image.edit only, when the raw model is image, explicitly sets
60
- requires_explicit_source_roles=false and has source_roles=[], the installed
61
- workbench derives a local implicit-image descriptor (one required fixed image,
62
- no weight). This is a local mapping, not a Provider-declared role; upload sends
63
- the real image as source_assets without a remote role. image.generate needs no
64
- reference. Explicit roles keep their declared validation.
72
+ For implicit image edits, use the `implicit-image` role in Studio and read
73
+ the reference count from `source_limits["image.edit"]` in `capabilities.list`
74
+ or `capabilities.get`. A catalog without that field uses the legacy single-image
75
+ limit for implicit edits. Supply a fixed version for each image and omit weights.
76
+ Studio uploads each image and sends its URL in `source_assets` with the remote
77
+ role omitted. For declared provider roles, use `source_roles`.
65
78
 
66
79
  ## Set up Studio Home
67
80
 
68
- After installing the matching official archives, run this package's
69
- `skills/scripts/initialize-home.mjs` with Node in the intended Studio profile.
70
- It applies the user preset and creates two editable example projects. Use
71
- `--no-open` to print their IDs and the Home bookmark. Rerun it to resume an
72
- incomplete setup.
73
-
74
- Home composes user-scope components from the workbench instance's
75
- `config.dashboard` array of `{ "plugin": "instance-id", "id": "ui-id" }`
76
- references. The official user preset supplies the separate `dashboard-projects`
77
- and `dashboard-assets` instances, with the component IDs `projects` and `assets`.
78
- To add a card, create or reuse a user-scope component, enable its provider, and
79
- append its reference, for example `{ "plugin": "usage", "id": "summary" }`.
80
- The card can read operations of its declared dependencies. Render it with Studio UI
81
- System controls and inherit the workbench's semantic colors.
82
-
83
- Each official Preset entry identifies its own installable plugin and registered
84
- component or contributed page. A plugin can still register several views. Read the
85
- view prompt for the scope, package, component ID and route.
86
-
87
- Each `config.savedViews` item is one shortcut. A `{ "plugin": "instance-id",
88
- "id": "ui-id" }` shortcut renders the selected user-scope component inside Home.
89
- A `{ "projectId": "...", "viewId": "...", "title": "..." }` shortcut opens the
90
- existing project and its declared navigation ID. To save Social Preview, use
91
- the actual project ID and the contributed route `social:preview`. Two UI IDs
92
- from the same enabled plugin can have their own shortcuts. Views saved through
93
- the Assets table editor appear as table tabs on that page.
94
-
95
- Enable local component providers in the same user scope before adding
96
- references. Update the full composition with `project configure --scope user
97
- --file <file>` and preserve unrelated instance settings. Remove references
98
- before disabling a provider. If the Host returns `USER_SCOPE_IN_USE`, let the
99
- active projects finish and restart the Host before applying the user change. An incompatible or disabled dependency can stop
100
- Home from activating. Restore the prior composition if needed.
81
+ Read [Studio Home setup](../../ui-system/skills/vivix-studio-ui/references/default-project-views.md#set-up-studio-home) in the Studio plugin view guide for initialization, dashboard cards, Preset prompts, Saved Views and user-scope composition changes.
@@ -22,9 +22,9 @@ asset and version. Usage count is distinct active target assets, not relation ro
22
22
  Use each actual scope's describe output to discover configured instance IDs;
23
23
  custom projects need not use the default studio/api IDs or enable the library.
24
24
 
25
- For image.edit only, when the raw model is image, explicitly sets
26
- requires_explicit_source_roles=false and has source_roles=[], the installed
27
- workbench derives a local implicit-image descriptor (one required fixed image,
28
- no weight). This is a local mapping, not a Provider-declared role; upload sends
29
- the real image as source_assets without a remote role. image.generate needs no
30
- reference. Explicit roles keep their declared validation.
25
+ For implicit image edits, use the `implicit-image` role in Studio and read
26
+ the reference count from `source_limits["image.edit"]` in `capabilities.list`
27
+ or `capabilities.get`. A catalog without that field uses the legacy single-image
28
+ limit for implicit edits. Supply a fixed version for each image and omit weights.
29
+ Studio uploads each image and sends its URL in `source_assets` with the remote
30
+ role omitted. For declared provider roles, use `source_roles`.
@@ -6,3 +6,5 @@ Use this reference only when the installed `plugin describe` output exposes the
6
6
  10. Discover the workbench's `views.list` and `views.save` operations. Persist SQL, scalar params, column configuration and identity mapping in user data. A column `path` is the exact projected result name, including aliases and dots. `format: categories` applies only to the multivalue metadata projection selected by the Agent; do not hardcode a business classification key or mark every string array as a category. Purpose may be hidden. Aggregate projections without business identity are display-only. Use the saved view's revision for edits.
7
7
  11. Favorites are independent persisted records pinned to the selected VersionRef. The default asset projection shows the latest saved version. Query `studio_asset_versions WHERE favorite = 1` to retain older favorited versions after a new version is saved. Download uses the selected fixed references through `exports.prepare` and the Plugin's native POST attachment stream; never buffer the full archive into a browser Blob.
8
8
  12. Import only text, image, video and audio through a real project's existing import operation. Generic files are rejected. Global Asset aggregates project assets and does not create unowned personal assets. Generation Queue displays persisted task names; recovery operations remain available to agents but are hidden from the redesigned UI.
9
+
10
+ For mounting user-scope components in Studio Home (`config.dashboard` and `config.savedViews`), follow [SKILL.md](../SKILL.md#set-up-studio-home). Custom UI plugins register components with `component` (receiving `CardProps` from `@vivix-labs/studio-workbench/shared`, see `dist/shared.d.ts`) and can pass `CardProps.projects` (or `await client.projects.list()`) as `catalog` when calling `global.query` once `ready` is `true` (paginating via `nextOffset`).