@lapis-notes/api 0.2.8 → 0.3.1

package/dist/generated/plugin-host-modules.schema.generated.js

@@ -194,7 +194,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/agent-skills": {
         "entry": "@lapis-notes/api/agent-skills",
@@ -207,7 +207,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/agent-skills",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/agent-tools": {
         "entry": "@lapis-notes/api/agent-tools",
@@ -220,7 +220,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/agent-tools",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/app-database": {
         "entry": "@lapis-notes/api/app-database",
@@ -233,7 +233,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/app-database",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/build/vite": {
         "entry": "@lapis-notes/api/build/vite",
@@ -243,7 +243,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/build/vite",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/cache": {
         "entry": "@lapis-notes/api/cache",
@@ -256,7 +256,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/cache",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/copy-button": {
         "entry": "@lapis-notes/api/copy-button",
@@ -269,7 +269,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/copy-button",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/desktop-native": {
         "entry": "@lapis-notes/api/desktop-native",
@@ -282,7 +282,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/desktop-native",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/editor": {
         "defaultExport": true,
@@ -296,7 +296,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/editor",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/editor/core": {
         "entry": "@lapis-notes/api/editor/core",
@@ -309,7 +309,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/editor/core",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/editor/extensions/autocomplete": {
         "entry": "@lapis-notes/api/editor/extensions/autocomplete",
@@ -322,7 +322,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/editor/extensions/autocomplete",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/editor/extensions/class-highlighter": {
         "entry": "@lapis-notes/api/editor/extensions/class-highlighter",
@@ -335,7 +335,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/editor/extensions/class-highlighter",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/editor/extensions/fold-gutter": {
         "entry": "@lapis-notes/api/editor/extensions/fold-gutter",
@@ -348,7 +348,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/editor/extensions/fold-gutter",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/editor/extensions/gutter-line-style-sync": {
         "entry": "@lapis-notes/api/editor/extensions/gutter-line-style-sync",
@@ -361,7 +361,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/editor/extensions/gutter-line-style-sync",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/editor/extensions/lint": {
         "entry": "@lapis-notes/api/editor/extensions/lint",
@@ -374,7 +374,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/editor/extensions/lint",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/editor/extensions/search": {
         "entry": "@lapis-notes/api/editor/extensions/search",
@@ -387,7 +387,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/editor/extensions/search",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/editor/language-service": {
         "entry": "@lapis-notes/api/editor/language-service",
@@ -400,7 +400,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/editor/language-service",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/empty-view": {
         "entry": "@lapis-notes/api/empty-view",
@@ -413,7 +413,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/empty-view",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/icon": {
         "entry": "@lapis-notes/api/icon",
@@ -426,7 +426,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/icon",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/language-service": {
         "entry": "@lapis-notes/api/language-service",
@@ -439,7 +439,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/language-service",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/language-service/worker": {
         "entry": "@lapis-notes/api/language-service/worker",
@@ -452,7 +452,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/language-service/worker",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/menu": {
         "defaultExport": true,
@@ -466,7 +466,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/menu",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/metadata-store": {
         "entry": "@lapis-notes/api/metadata-store",
@@ -476,7 +476,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/metadata-store",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/metadata-value": {
         "entry": "@lapis-notes/api/metadata-value",
@@ -489,7 +489,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/metadata-value",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/native-editing-intents": {
         "entry": "@lapis-notes/api/native-editing-intents",
@@ -502,7 +502,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/native-editing-intents",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/native-history-index": {
         "entry": "@lapis-notes/api/native-history-index",
@@ -515,7 +515,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/native-history-index",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/native-tasks": {
         "entry": "@lapis-notes/api/native-tasks",
@@ -528,7 +528,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/native-tasks",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/native-turns": {
         "entry": "@lapis-notes/api/native-turns",
@@ -541,7 +541,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/native-turns",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/path": {
         "entry": "@lapis-notes/api/path",
@@ -554,7 +554,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/path",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/plugin-assets": {
         "entry": "@lapis-notes/api/plugin-assets",
@@ -567,7 +567,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/plugin-assets",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/plugin-distribution-host": {
         "entry": "@lapis-notes/api/plugin-distribution-host",
@@ -580,7 +580,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/plugin-distribution-host",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/plugin-host-modules": {
         "entry": "@lapis-notes/api/plugin-host-modules",
@@ -593,7 +593,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/plugin-host-modules",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/registry/schema": {
         "entry": "@lapis-notes/api/registry/schema",
@@ -606,7 +606,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/registry/schema",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/runtime": {
         "entry": "@lapis-notes/api/runtime",
@@ -619,7 +619,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/runtime",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/search-embedding-worker": {
         "entry": "@lapis-notes/api/search-embedding-worker",
@@ -632,7 +632,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/search-embedding-worker",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/select": {
         "entry": "@lapis-notes/api/select",
@@ -645,7 +645,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/select",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/server-host": {
         "entry": "@lapis-notes/api/server-host",
@@ -658,7 +658,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/server-host",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/sync-repository": {
         "entry": "@lapis-notes/api/sync-repository",
@@ -671,7 +671,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/sync-repository",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/sync-security-host": {
         "entry": "@lapis-notes/api/sync-security-host",
@@ -681,7 +681,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/sync-security-host",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/telemetry": {
         "entry": "@lapis-notes/api/telemetry",
@@ -694,7 +694,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/telemetry",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/vault": {
         "entry": "@lapis-notes/api/vault",
@@ -707,7 +707,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/vault",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/api/workspace-host": {
         "entry": "@lapis-notes/api/workspace-host",
@@ -720,7 +720,7 @@ export const pluginHostModuleRegistry = {
         "public": true,
         "source": "package-json-export",
         "specifier": "@lapis-notes/api/workspace-host",
-        "version": "0.2.8"
+        "version": "0.3.1"
     },
     "@lapis-notes/markdown": {
         "entry": "@lapis-notes/markdown",

package/dist/native-editing-intents.d.ts

@@ -5,4 +5,12 @@ export interface NativeEditingIntents {
     call(command: EditingIntentCommand): Promise<EditingIntentValue>;
     /** Expected absence is null; unavailable or unreadable files reject. */
     read(path: string): Promise<TextSnapshot | null>;
+    /**
+     * Subscribe to metadata invalidation, returning an idempotent disposer.
+     * Notify after registration and every reconnect or missed notification so the
+     * caller can list authoritative claims. Report observation failures without
+     * mutating or recovering claims. Disposing must stop delivery and reconnects.
+     * Older hosts may omit this port and retain compatible recovery polling.
+     */
+    observe?(invalidate: () => void, error: (error: unknown) => void): () => void;
 }

package/dist/native-editing-recovery.d.ts

@@ -13,7 +13,7 @@ export declare class NativeEditingRecovery {
     constructor(port: NativeEditingIntents, track: Track);
     snapshot(): NativeEditingRecoverySnapshot;
     subscribe(listener: Listener): () => void;
-    /** Shell-owned read-only observation; multiple shells share one poll. */
+    /** Shell-owned passive observation; old hosts retain one shared poll. */
     observe(): () => void;
     refresh(): Promise<void>;
     /** Hosts call this before destructive App/registry teardown. */

package/dist/native-editing-recovery.js

@@ -20,6 +20,10 @@ export class NativeEditingRecovery {
     #mutation = 0;
     #timer;
     #pending;
+    #stopObservation;
+    #observationError;
+    #invalidation = 0;
+    #loaded;
     constructor(port, track) {
         this.port = port;
         this.track = track;
@@ -34,10 +38,36 @@ export class NativeEditingRecovery {
             this.#listeners.delete(listener);
         };
     }
-    /** Shell-owned read-only observation; multiple shells share one poll. */
+    /** Shell-owned passive observation; old hosts retain one shared poll. */
     observe() {
-        if (this.#observers++ === 0)
-            void this.#poll(++this.#epoch);
+        if (this.#observers++ === 0) {
+            const epoch = ++this.#epoch;
+            this.#observationError = undefined;
+            if (this.port.observe) {
+                const current = () => this.#observers > 0 && epoch === this.#epoch;
+                const failed = (error) => {
+                    if (!current())
+                        return;
+                    this.#observationError = error;
+                    this.#publish(this.#snapshot.claims, error);
+                };
+                try {
+                    this.#stopObservation = this.port.observe(() => {
+                        if (!current())
+                            return;
+                        this.#invalidation++;
+                        this.#observationError = undefined;
+                        void this.#load(epoch).catch(() => { });
+                    }, failed);
+                }
+                catch (error) {
+                    failed(error);
+                }
+                void this.#load(epoch).catch(() => { });
+            }
+            else
+                void this.#poll(epoch);
+        }
         let held = true;
         return () => {
             if (!held)
@@ -47,6 +77,9 @@ export class NativeEditingRecovery {
                 this.#epoch++;
                 clearTimeout(this.#timer);
                 this.#timer = undefined;
+                const stop = this.#stopObservation;
+                this.#stopObservation = undefined;
+                stop?.();
             }
         };
     }
@@ -67,6 +100,7 @@ export class NativeEditingRecovery {
         if (this.#pending?.epoch === epoch)
             return this.#pending.promise;
         const mutation = this.#mutation;
+        const invalidation = this.#invalidation;
         const promise = (async () => {
             try {
                 const value = await this.port.call({ kind: "list" });
@@ -78,7 +112,8 @@ export class NativeEditingRecovery {
                 for (const id of this.#adopted)
                     if (!retained.has(id))
                         this.#adopted.delete(id);
-                this.#publish(value.states.filter((state) => state.detached || this.#adopted.has(state.editor_id)));
+                this.#publish(value.states.filter((state) => state.detached || this.#adopted.has(state.editor_id)), this.#observationError);
+                this.#loaded = { epoch, mutation, invalidation };
             }
             catch (error) {
                 if (epoch === this.#epoch && mutation === this.#mutation)
@@ -92,6 +127,11 @@ export class NativeEditingRecovery {
             .finally(() => {
             if (this.#pending === pending)
                 this.#pending = undefined;
+            if (this.port.observe &&
+                this.#observers &&
+                epoch === this.#epoch &&
+                (invalidation !== this.#invalidation || mutation !== this.#mutation))
+                void this.#load(epoch).catch(() => { });
         })
             .catch(() => { });
         return promise;
@@ -99,6 +139,10 @@ export class NativeEditingRecovery {
     /** Hosts call this before destructive App/registry teardown. */
     async assertClear() {
         await this.refresh();
+        if (this.#loaded?.epoch !== this.#epoch ||
+            this.#loaded.mutation !== this.#mutation ||
+            this.#loaded.invalidation !== this.#invalidation)
+            throw new Error("Editing claims changed; refresh Problems");
         if (this.#snapshot.claims.length)
             throw new Error("Unresolved editing claims require review in Problems");
     }
@@ -168,11 +212,12 @@ export class NativeEditingRecovery {
                 throw error;
             }
             finally {
+                this.#mutation++;
                 this.#acting.delete(current.editor_id);
             }
         });
     }
-    #publish(claims, error) {
+    #publish(claims, error = this.#observationError) {
         const message = error
             ? error instanceof Error
                 ? error.message