allyhub 0.4.0 → 0.6.0

package/dist/node_modules/@allyhub-next/protocol/dist/editor.d.ts

@@ -0,0 +1,412 @@
+import { z } from "zod";
+import { type ClientOf } from "./jsonrpc.js";
+import type { NoteSurface } from "./notes.js";
+export declare const ThemeSchema: z.ZodEnum<{
+    light: "light";
+    dark: "dark";
+}>;
+export declare const HostContextSchema: z.ZodObject<{
+    locale: z.ZodString;
+    theme: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>;
+    agent: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strict>>;
+    project: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strict>;
+    notes: z.ZodOptional<z.ZodBoolean>;
+    item: z.ZodObject<{
+        kind: z.ZodEnum<{
+            video: "video";
+            slides: "slides";
+            doc: "doc";
+            sheet: "sheet";
+            scenery: "scenery";
+            model: "model";
+            website: "website";
+        }>;
+        dir: z.ZodString;
+        entry: z.ZodString;
+    }, z.core.$strict>;
+    editor: z.ZodEnum<{
+        video: "video";
+        slides: "slides";
+        doc: "doc";
+        sheet: "sheet";
+        scenery: "scenery";
+        website: "website";
+    }>;
+}, z.core.$strict>;
+export type HostContext = z.infer<typeof HostContextSchema>;
+/** What `items/open` shows: a file of the project, or a browser page (as Codex's `open_in_codex` names it). */
+export declare const OpenTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    path: z.ZodString;
+    line: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"browser">;
+    url: z.ZodOptional<z.ZodURL>;
+    tabId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "type">;
+export type OpenTarget = z.infer<typeof OpenTargetSchema>;
+export declare const EDITOR_STATES: readonly ["saved", "saving", "unsaved", "error"];
+export declare const HOST_METHODS: {
+    readonly "host/context": import("./jsonrpc.js").MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        locale: z.ZodString;
+        theme: z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>;
+        agent: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strict>>;
+        project: z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strict>;
+        notes: z.ZodOptional<z.ZodBoolean>;
+        item: z.ZodObject<{
+            kind: z.ZodEnum<{
+                video: "video";
+                slides: "slides";
+                doc: "doc";
+                sheet: "sheet";
+                scenery: "scenery";
+                model: "model";
+                website: "website";
+            }>;
+            dir: z.ZodString;
+            entry: z.ZodString;
+        }, z.core.$strict>;
+        editor: z.ZodEnum<{
+            video: "video";
+            slides: "slides";
+            doc: "doc";
+            sheet: "sheet";
+            scenery: "scenery";
+            website: "website";
+        }>;
+    }, z.core.$strict>>;
+    readonly "items/open": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            path: z.ZodString;
+            line: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"browser">;
+            url: z.ZodOptional<z.ZodURL>;
+            tabId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "storage/get": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        value: z.ZodUnknown;
+    }, z.core.$strict>>;
+    readonly "storage/set": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodUnknown;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "editor/state": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        state: z.ZodEnum<{
+            error: "error";
+            saved: "saved";
+            saving: "saving";
+            unsaved: "unsaved";
+        }>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "agent/ask": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        delivered: z.ZodBoolean;
+    }, z.core.$strict>>;
+    readonly "note/begin": import("./jsonrpc.js").MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        begun: z.ZodBoolean;
+    }, z.core.$strict>>;
+    readonly "tools/call": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        name: z.ZodString;
+        arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodObject<{
+        result: z.ZodUnknown;
+    }, z.core.$strict>>;
+};
+export declare const HOST_NOTIFICATIONS: {
+    readonly "project/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        revision: z.ZodInt;
+    }, z.core.$strict>>;
+    readonly "check/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        status: z.ZodEnum<{
+            off: "off";
+            waiting: "waiting";
+            running: "running";
+            done: "done";
+            failed: "failed";
+        }>;
+        revision: z.ZodInt;
+        problems: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            level: z.ZodEnum<{
+                error: "error";
+                warn: "warn";
+            }>;
+            message: z.ZodString;
+            piece: z.ZodOptional<z.ZodString>;
+            part: z.ZodOptional<z.ZodString>;
+            t: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$loose>>;
+        facts: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            data: z.ZodUnknown;
+        }, z.core.$loose>>;
+        versions: z.ZodOptional<z.ZodObject<{
+            total: z.ZodInt;
+            loaded: z.ZodInt;
+            reused: z.ZodInt;
+        }, z.core.$strict>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly "export/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        job: z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+            versions: z.ZodArray<z.ZodString>;
+            types: z.ZodArray<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
+            state: z.ZodEnum<{
+                running: "running";
+                done: "done";
+                failed: "failed";
+                queued: "queued";
+                cancelled: "cancelled";
+            }>;
+            progress: z.ZodNumber;
+            files: z.ZodArray<z.ZodString>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    readonly "index/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        jobs: z.ZodArray<z.ZodObject<{
+            file: z.ZodString;
+            status: z.ZodEnum<{
+                running: "running";
+                done: "done";
+                failed: "failed";
+            }>;
+            message: z.ZodString;
+            share: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "files/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        watch: z.ZodString;
+        changes: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            version: z.ZodNullable<z.ZodString>;
+            by: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    person: "person";
+                    agent: "agent";
+                    tool: "tool";
+                }>;
+                name: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "host/context-changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        locale: z.ZodString;
+        theme: z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>;
+        agent: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strict>>;
+        project: z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strict>;
+        notes: z.ZodOptional<z.ZodBoolean>;
+        item: z.ZodObject<{
+            kind: z.ZodEnum<{
+                video: "video";
+                slides: "slides";
+                doc: "doc";
+                sheet: "sheet";
+                scenery: "scenery";
+                model: "model";
+                website: "website";
+            }>;
+            dir: z.ZodString;
+            entry: z.ZodString;
+        }, z.core.$strict>;
+        editor: z.ZodEnum<{
+            video: "video";
+            slides: "slides";
+            doc: "doc";
+            sheet: "sheet";
+            scenery: "scenery";
+            website: "website";
+        }>;
+    }, z.core.$strict>>;
+    readonly "editor/command": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
+        command: z.ZodEnum<{
+            export: "export";
+        }>;
+    }, z.core.$strict>>;
+};
+/** Every method an editor may call on its host. */
+export declare const EDITOR_HOST_METHODS: {
+    readonly "host/context": import("./jsonrpc.js").MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        locale: z.ZodString;
+        theme: z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>;
+        agent: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strict>>;
+        project: z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strict>;
+        notes: z.ZodOptional<z.ZodBoolean>;
+        item: z.ZodObject<{
+            kind: z.ZodEnum<{
+                video: "video";
+                slides: "slides";
+                doc: "doc";
+                sheet: "sheet";
+                scenery: "scenery";
+                model: "model";
+                website: "website";
+            }>;
+            dir: z.ZodString;
+            entry: z.ZodString;
+        }, z.core.$strict>;
+        editor: z.ZodEnum<{
+            video: "video";
+            slides: "slides";
+            doc: "doc";
+            sheet: "sheet";
+            scenery: "scenery";
+            website: "website";
+        }>;
+    }, z.core.$strict>>;
+    readonly "items/open": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            path: z.ZodString;
+            line: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"browser">;
+            url: z.ZodOptional<z.ZodURL>;
+            tabId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "storage/get": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        key: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        value: z.ZodUnknown;
+    }, z.core.$strict>>;
+    readonly "storage/set": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodUnknown;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "editor/state": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        state: z.ZodEnum<{
+            error: "error";
+            saved: "saved";
+            saving: "saving";
+            unsaved: "unsaved";
+        }>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "agent/ask": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        delivered: z.ZodBoolean;
+    }, z.core.$strict>>;
+    readonly "note/begin": import("./jsonrpc.js").MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        begun: z.ZodBoolean;
+    }, z.core.$strict>>;
+    readonly "tools/call": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        name: z.ZodString;
+        arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodObject<{
+        result: z.ZodUnknown;
+    }, z.core.$strict>>;
+    readonly "files/read": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        text: z.ZodString;
+        version: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly "files/write": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        path: z.ZodString;
+        text: z.ZodString;
+        over: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly "files/upload": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        dir: z.ZodString;
+        name: z.ZodString;
+        data: z.ZodBase64;
+    }, z.core.$strict>, z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strict>>;
+    readonly "files/url": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        url: z.ZodString;
+    }, z.core.$strict>>;
+    readonly "files/list": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        dir: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            size: z.ZodInt;
+            modified: z.ZodNumber;
+        }, z.core.$strict>>;
+        dirs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly "files/move": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        rewritten: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly "files/remove": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        trash: z.ZodString;
+    }, z.core.$strict>>;
+    readonly "files/trash": import("./jsonrpc.js").MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        entries: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            path: z.ZodString;
+            removed: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "files/restore": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strict>>;
+    readonly "files/watch": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        paths: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        watch: z.ZodString;
+    }, z.core.$strict>>;
+    readonly "files/unwatch": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        watch: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+};
+/** What an editor holds: its host, as typed calls. */
+export type EditorHost = ClientOf<typeof EDITOR_HOST_METHODS> & {
+    /** Tells `files/changed`, `host/context-changed` and the tools' notifications; answers how to stop. */
+    on<N extends keyof typeof HOST_NOTIFICATIONS>(name: N, listener: (params: z.output<(typeof HOST_NOTIFICATIONS)[N]["params"]>) => void): () => void;
+    /** Gives the host what it asks of the editor for a person's notes; answers how to stop. Absent where nobody takes notes. */
+    notes?(surface: NoteSurface): () => void;
+};
+//# sourceMappingURL=editor.d.ts.map

package/dist/node_modules/@allyhub-next/protocol/dist/editor.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as t}from"zod";import{EDITORS as s,KINDS as r}from"@allyhub-next/formats";import{FILE_METHODS as i,FILE_NOTIFICATIONS as a,PathSchema as o}from"./files.js";import{method as e,notification as n}from"./jsonrpc.js";import{TOOL_NOTIFICATIONS as c}from"./tools.js";export const ThemeSchema=t.enum(["light","dark"]),HostContextSchema=t.strictObject({locale:t.string().min(2),theme:ThemeSchema,agent:t.strictObject({name:t.string().min(1)}).optional(),project:t.strictObject({name:t.string().min(1)}),notes:t.boolean().optional(),item:t.strictObject({kind:t.enum(r),dir:o,entry:o}),editor:t.enum(s)}),OpenTargetSchema=t.discriminatedUnion("type",[t.strictObject({type:t.literal("file"),path:o,line:t.int().positive().optional()}),t.strictObject({type:t.literal("browser"),url:t.url({protocol:/^https?$/u}).optional(),tabId:t.string().min(1).optional()})]),EDITOR_STATES=["saved","saving","unsaved","error"],HOST_METHODS={"host/context":e(t.strictObject({}),HostContextSchema,"Where the editor runs."),"items/open":e(t.strictObject({target:OpenTargetSchema}),t.strictObject({}),"Shows another item, a file or a page, where the host shows things."),"storage/get":e(t.strictObject({key:t.string().min(1)}),t.strictObject({value:t.unknown()}),"What the editor kept for this person on this computer (a hand sort, what was last seen), or null."),"storage/set":e(t.strictObject({key:t.string().min(1),value:t.unknown()}),t.strictObject({}),"Keeps a value for this person on this computer; null removes it."),"editor/state":e(t.strictObject({state:t.enum(EDITOR_STATES),message:t.string().optional()}),t.strictObject({}),"Says whether what the person typed is saved."),"agent/ask":e(t.strictObject({text:t.string().min(1)}),t.strictObject({delivered:t.boolean()}),"Puts words before the person's agent, for them to go on and send; false where no agent takes them. Never sent by itself."),"note/begin":e(t.strictObject({}),t.strictObject({begun:t.boolean()}),"Starts the host's Note mode on what is on show, as its own Note button does, so a person can mark anything up for their agent from wherever they are; false where the host has none. Sends nothing."),"tools/call":e(t.strictObject({name:t.string().min(1),arguments:t.record(t.string(),t.unknown()).default({})}),t.strictObject({result:t.unknown()}),"Runs one of the project server's tools (tools.ts's PROJECT_TOOLS), for an editor that needs more than files (a video's preview, a still).")},HOST_NOTIFICATIONS={"host/context-changed":n(HostContextSchema,"The language, theme or agent changed."),"editor/command":n(t.strictObject({command:t.enum(["export"])}),"The host around the editor asked it to do what its own shortcut does."),...a,...c},EDITOR_HOST_METHODS={...i,...HOST_METHODS};

package/dist/node_modules/@allyhub-next/protocol/dist/notes.d.ts

@@ -0,0 +1,167 @@
+import { z } from "zod";
+import { pointsOf, mapShape, touches, type NoteShape } from "@allyhub-next/formats";
+export declare const NoteRectSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>;
+export type NoteRect = z.infer<typeof NoteRectSchema>;
+/** A mark as the host tells it, px of the surface: its shape, and nothing of what is under it. */
+export declare const NoteShapeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"box">;
+    rect: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"round">;
+    rect: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"arrow">;
+    from: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>;
+    to: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"line">;
+    points: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "kind">;
+export { mapShape, pointsOf, touches };
+export type { NoteShape };
+/** Where to change something: a project's file, and its line. */
+export declare const NoteSourceSchema: z.ZodObject<{
+    path: z.ZodString;
+    line: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>;
+export type NoteSource = z.infer<typeof NoteSourceSchema>;
+export declare const FrozenSchema: z.ZodObject<{
+    key: z.ZodString;
+    what: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        line: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type Frozen = z.infer<typeof FrozenSchema>;
+export declare const NotePictureSchema: z.ZodObject<{
+    rect: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>;
+    mime: z.ZodString;
+    data: z.ZodString;
+}, z.core.$strict>;
+export type NotePicture = z.infer<typeof NotePictureSchema>;
+export declare const NoteElementSchema: z.ZodObject<{
+    name: z.ZodString;
+    source: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        line: z.ZodOptional<z.ZodInt>;
+    }, z.core.$strict>>;
+    text: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type NoteElement = z.infer<typeof NoteElementSchema>;
+/**
+ * What a framed page tells the window that holds it: it answers `NOTE_METHODS`
+ * from now on, or no longer. The window asks only a page that has said so.
+ */
+export declare const NOTE_READY = "note/ready";
+/** What a framed page tells the window: words for the agent's composer. */
+export declare const AGENT_ASK = "agent/ask";
+/** What a framed page tells the window: the person asked for Note mode. */
+export declare const NOTE_BEGIN = "note/begin";
+export declare const NOTE_GONE = "note/gone";
+export declare const NOTE_METHODS: {
+    readonly "note/freeze": import("./jsonrpc.js").MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        key: z.ZodString;
+        what: z.ZodString;
+        source: z.ZodOptional<z.ZodObject<{
+            path: z.ZodString;
+            line: z.ZodOptional<z.ZodInt>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "note/pictures": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        page: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        pictures: z.ZodArray<z.ZodObject<{
+            rect: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+            mime: z.ZodString;
+            data: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "note/locate": import("./jsonrpc.js").MethodSpec<z.ZodObject<{
+        mark: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"box">;
+            rect: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"round">;
+            rect: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"arrow">;
+            from: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>;
+            to: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"line">;
+            points: z.ZodArray<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>, z.ZodObject<{
+        elements: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            source: z.ZodOptional<z.ZodObject<{
+                path: z.ZodString;
+                line: z.ZodOptional<z.ZodInt>;
+            }, z.core.$strict>>;
+            text: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "note/thaw": import("./jsonrpc.js").MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+};
+/** What an editor gives its host for notes on it, for as long as it is on show. */
+export interface NoteSurface {
+    freeze(): Promise<Frozen>;
+    pictures?(): Promise<NotePicture[]>;
+    locate?(mark: NoteShape): Promise<NoteElement[]>;
+    thaw?(): void;
+}
+//# sourceMappingURL=notes.d.ts.map

package/dist/node_modules/@allyhub-next/protocol/dist/notes.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as t}from"zod";import{pointsOf as n,mapShape as r,touches as s}from"@allyhub-next/formats";import{PathSchema as i}from"./files.js";import{method as e}from"./jsonrpc.js";export const NoteRectSchema=t.strictObject({x:t.number(),y:t.number(),width:t.number().nonnegative(),height:t.number().nonnegative()});const o=t.strictObject({x:t.number(),y:t.number()});export const NoteShapeSchema=t.discriminatedUnion("kind",[t.strictObject({kind:t.literal("box"),rect:NoteRectSchema}),t.strictObject({kind:t.literal("round"),rect:NoteRectSchema}),t.strictObject({kind:t.literal("arrow"),from:o,to:o}),t.strictObject({kind:t.literal("line"),points:t.array(o).min(1)})]);export{r as mapShape,n as pointsOf,s as touches};export const NoteSourceSchema=t.strictObject({path:i,line:t.int().positive().optional()}),FrozenSchema=t.strictObject({key:t.string().min(1),what:t.string(),source:NoteSourceSchema.optional()}),NotePictureSchema=t.strictObject({rect:NoteRectSchema.optional(),mime:t.string().min(1),data:t.string().min(1)}),NoteElementSchema=t.strictObject({name:t.string().min(1),source:NoteSourceSchema.optional(),text:t.string().optional()}),NOTE_READY="note/ready",AGENT_ASK="agent/ask",NOTE_BEGIN="note/begin",NOTE_GONE="note/gone",NOTE_METHODS={"note/freeze":e(t.strictObject({}),FrozenSchema,"Stops what moves and says what is on show. Answered once it is drawn, so a page still loading is not captured empty."),"note/pictures":e(t.strictObject({page:t.boolean()}),t.strictObject({pictures:t.array(NotePictureSchema)}),"What is on show drawn better than a screenshot can, or what a screenshot cannot reach: a render's frame, a frame of its own. Laid in order over the host's screenshot."),"note/locate":e(t.strictObject({mark:NoteShapeSchema}),t.strictObject({elements:t.array(NoteElementSchema)}),"What a mark is on, while frozen: the surface alone knows what it shows, and says it in its own terms, with its file and line where it knows them. Empty is an answer: the mark's place still goes."),"note/thaw":e(t.strictObject({}),t.strictObject({}),"The person is done. Nothing starts by itself: a video that was paused stays paused.")};