@nesso-how/plugin 0.8.0 → 1.0.0-beta.12

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.
package/README.md CHANGED
@@ -4,14 +4,18 @@ Build Nesso plugins with TypeScript: **actions** read and edit graphs, **vocabul
4
4
 
5
5
  ## Install
6
6
 
7
- Use Node.js 24. To add the SDK to an existing TypeScript project:
7
+ Use Node.js 24. During Nesso's beta, add the SDK to an existing TypeScript project with:
8
8
 
9
9
  ```sh
10
- npm install --save-dev @nesso-how/plugin
10
+ npm install --save-dev @nesso-how/plugin@beta
11
11
  ```
12
12
 
13
13
  For a new project, start with the [standalone example](example/), which includes TypeScript, Vite, and React configuration. Plugins can be installed locally through MCP without publishing to npm.
14
14
 
15
+ The app, UI package, SDK, and official example share a release version and npm channel. Plugin compatibility is identified separately by `nesso.apiVersion`; matching the app's exact version is not required. Stable releases use npm's default `latest` channel instead of `beta`.
16
+
17
+ The desktop plugin catalog uses `latest` in stable apps. Beta apps also check `beta` and offer the newest compatible stable or beta version. Other prerelease channels are not included.
18
+
15
19
  ## Create a plugin
16
20
 
17
21
  ### With an agent
@@ -190,7 +194,7 @@ Nesso supplies React, the `@nesso-how/ui` component stylesheet, and theme CSS va
190
194
 
191
195
  Nesso provides the panel title, close control, and loading/error screens. Opening a panel or changing the active view starts a new React instance and invalidates the previous context. Closing it, changing documents, replacing/removing the plugin, or a runtime failure ends the session.
192
196
 
193
- Keep mutable state inside the component and clean up subscriptions in React effects. Save progress through `storage` as it changes; cleanup may not finish. Panels have no action execution timeout, but initialization and API requests have deadlines. Handle expected errors in the UI; uncaught errors or rejected promises fail the session.
197
+ Keep mutable state inside the component and clean up subscriptions in React effects. Module-scope state is not guaranteed between sessions: Nesso may reuse or discard the runtime, so keep state in the instance or `storage`. Save progress through `storage` as it changes; cleanup may not finish. Panels have no action execution timeout, but initialization and API requests have deadlines. Handle expected errors in the UI; uncaught errors or rejected promises fail the session.
194
198
 
195
199
  ### Action badges
196
200
 
@@ -266,7 +270,7 @@ The invoked view is **not a write sandbox**: permitted writes can affect the who
266
270
 
267
271
  File saves accept exactly one of UTF-8 `text` or canonical `base64` (without a data URL prefix), with a 16 MiB decoded byte limit. File opening remains UTF-8 text only. Host-managed dialogs or browser downloads grant no unrestricted filesystem access. Plugins have no Node, host DOM, direct filesystem, clipboard, or network access.
268
272
 
269
- `images.renderView` captures the invoked view with the current theme and fonts, without selection or canvas controls. Scale defaults to `2`, or accepts `4`. Empty or oversized images fail rather than silently downscaling (8192 pixels per side, 16,777,216 pixels total, 16 MiB PNG). Save the result separately with `files.save({ name: 'view.png', ...image })`; this also requires `files`.
273
+ `images.renderView` captures the invoked view with the current theme and fonts, without selection or canvas controls. Scale defaults to `2`, or accepts `4`, and is a maximum: views too large for it render at the highest of `4`, `2`, or `1` within 8192 pixels per side and 16,777,216 pixels total. Empty views, views over that budget at scale `1`, and PNGs over 16 MiB fail. Save the result separately with `files.save({ name: 'view.png', ...image })`; this also requires `files`.
270
274
 
271
275
  Failures throw `PluginError` with `code` and `{ path, message }[]` issues. Let them propagate instead of reporting success. Files and notifications cannot be rolled back with graph edits.
272
276
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nesso-how/plugin-example",
3
- "version": "0.8.0",
3
+ "version": "1.0.0-beta.12",
4
4
  "description": "Official example showing how to build Nesso plugins with the SDK and plugin APIs",
5
5
  "keywords": [
6
6
  "nesso-plugin"
@@ -28,12 +28,12 @@
28
28
  "prepack": "npm run build"
29
29
  },
30
30
  "dependencies": {
31
- "@nesso-how/ui": "1.0.0-beta.8",
31
+ "@nesso-how/ui": "1.0.0-beta.12",
32
32
  "react": "^19.2.8",
33
33
  "react-dom": "^19.2.8"
34
34
  },
35
35
  "devDependencies": {
36
- "@nesso-how/plugin": "0.8.0",
36
+ "@nesso-how/plugin": "1.0.0-beta.12",
37
37
  "@types/react": "^19.2.18",
38
38
  "@types/react-dom": "^19.2.7",
39
39
  "typescript": "~7.0.2",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nesso-how/plugin",
3
- "version": "0.8.0",
3
+ "version": "1.0.0-beta.12",
4
4
  "description": "Types, validation, and asynchronous clients for isolated Nesso plugins",
5
5
  "license": "MIT",
6
6
  "repository": {