@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 +8 -4
- package/example/package.json +3 -3
- package/package.json +1 -1
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.
|
|
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
|
|
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
|
|
package/example/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nesso-how/plugin-example",
|
|
3
|
-
"version": "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.
|
|
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.
|
|
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",
|