allyhub 0.6.0 → 0.7.1

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

@@ -0,0 +1,396 @@
+import { z } from "zod";
+import { type Place } from "./editor.js";
+/** The manifest's format; a reader that does not know it asks for the machine. */
+export declare const SNAPSHOT_FORMAT = 1;
+export declare const ConversationEntrySchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    agent: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    transcript: z.ZodString;
+}, z.core.$strip>;
+export type ConversationEntry = z.infer<typeof ConversationEntrySchema>;
+/**
+ * A conversation as the window replays it: the messages Studio's Host
+ * relayed to its clients (ACP's `session/update` and Studio's own
+ * notifications), in order.
+ */
+export declare const TranscriptSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        method: z.ZodString;
+        params: z.ZodUnknown;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Transcript = z.infer<typeof TranscriptSchema>;
+/**
+ * What a snapshot is of: a project, or the Host's own home (its settings,
+ * schedules, skills, plugins and the agents' stores of their
+ * conversations; files only, no tree), one per person's Studio.
+ */
+export declare const SNAPSHOT_KINDS: readonly ["project", "home"];
+export type SnapshotKind = (typeof SNAPSHOT_KINDS)[number];
+/**
+ * What showing one item read only reaches (a share's view of it): the
+ * tree's paths its editor and its stage load, the project's files its
+ * editor reads, and the tree's files its view serves in place of the
+ * project's at the same path (the item list and the check's results,
+ * reduced to it). A path the manifest does not have is not served.
+ */
+export declare const ItemReachSchema: z.ZodObject<{
+    tree: z.ZodArray<z.ZodString>;
+    files: z.ZodArray<z.ZodString>;
+    own: z.ZodRecord<z.ZodString, z.ZodObject<{
+        sha256: z.ZodString;
+        size: z.ZodInt;
+        type: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ItemReach = z.infer<typeof ItemReachSchema>;
+/** What each item a share can show reaches, worked out as the snapshot is recorded. */
+export declare const SnapshotReachSchema: z.ZodObject<{
+    shared: z.ZodArray<z.ZodString>;
+    items: z.ZodRecord<z.ZodString, z.ZodObject<{
+        tree: z.ZodArray<z.ZodString>;
+        files: z.ZodArray<z.ZodString>;
+        own: z.ZodRecord<z.ZodString, z.ZodObject<{
+            sha256: z.ZodString;
+            size: z.ZodInt;
+            type: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SnapshotReach = z.infer<typeof SnapshotReachSchema>;
+export declare const SnapshotManifestSchema: z.ZodObject<{
+    format: z.ZodLiteral<1>;
+    kind: z.ZodEnum<{
+        home: "home";
+        project: "project";
+    }>;
+    project: z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>;
+    host: z.ZodObject<{
+        version: z.ZodString;
+    }, z.core.$strip>;
+    madeAt: z.ZodISODateTime;
+    files: z.ZodRecord<z.ZodString, z.ZodObject<{
+        sha256: z.ZodString;
+        size: z.ZodInt;
+    }, z.core.$strip>>;
+    tree: z.ZodRecord<z.ZodString, z.ZodObject<{
+        sha256: z.ZodString;
+        size: z.ZodInt;
+        type: z.ZodString;
+    }, z.core.$strip>>;
+    conversations: z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        agent: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        transcript: z.ZodString;
+    }, z.core.$strip>>;
+    reach: z.ZodOptional<z.ZodObject<{
+        shared: z.ZodArray<z.ZodString>;
+        items: z.ZodRecord<z.ZodString, z.ZodObject<{
+            tree: z.ZodArray<z.ZodString>;
+            files: z.ZodArray<z.ZodString>;
+            own: z.ZodRecord<z.ZodString, z.ZodObject<{
+                sha256: z.ZodString;
+                size: z.ZodInt;
+                type: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SnapshotManifest = z.infer<typeof SnapshotManifestSchema>;
+/**
+ * A manifest as a share's view of one item shows it: its files and tree
+ * only what the item reaches (its own files in place of the project's),
+ * no conversations; undefined when the snapshot did not record the
+ * item's reach. A view serves nothing its manifest does not name, so
+ * this is the whole of a view's scope.
+ */
+export declare function scopedManifest(m: SnapshotManifest, item: string): SnapshotManifest | undefined;
+/**
+ * What a project's backup leaves out, as folders anywhere in it: what is
+ * made again from the rest (dependencies, caches, exports).
+ */
+export declare const SNAPSHOT_SKIPPED: readonly ["node_modules", ".allyhub/cache", ".allyhub/out"];
+/**
+ * The tree a read view serves, by its top folders. Every address inside
+ * it is relative, so it is the same tree a live dev server serves under
+ * its stage's base.
+ */
+export declare const SNAPSHOT_TREE: {
+    /** The editors' page (editor-web's build). */
+    readonly editor: "editor/";
+    /** The stage's runtime, its pages and its fonts. */
+    readonly runtime: "runtime/";
+    /** The pieces' bundles. */
+    readonly build: "build/";
+    /** The project's media the builds found, by their project path. */
+    readonly media: "media/";
+    /** Derived media: a person's matte, by the media's project path. */
+    readonly matte: "matte/";
+    /** The sceneries' bundles, bakes and decoders. */
+    readonly scenery: "scenery/";
+    readonly bakes: "bakes/";
+    /** A deck's component pictures, by what they show (`stillPath`), and a snapshot's lists of them (`stillsIndexPath`). */
+    readonly stills: "stills/";
+    /** The answers the editors ask for, recorded (snapshotAnswerPath). */
+    readonly answers: "answers/";
+    /** Each item's gallery preview, by its folder (snapshotPreviewPath). */
+    readonly previews: "previews/";
+};
+/**
+ * Where a project tool's recorded answer is in the tree: by the tool's
+ * name and its params, so the reader finds the answer to the call it makes.
+ */
+export declare const snapshotAnswerPath: (tool: string, params: unknown) => string;
+/** A deck's component picture in the tree, by its key (`slides/component-stills`'): a transparent WebP that never changes. */
+export declare const stillPath: (key: string) => string;
+/**
+ * Where a deck version's component pictures are listed in a snapshot's
+ * tree: every component its slides show as they are edited, drawn when
+ * the snapshot was made, so a read view answers `slides/component-stills`
+ * for any of them.
+ */
+export declare const stillsIndexPath: (item: string, version: string) => string;
+/** A deck version's component pictures: each picture's key (`stillPath`), by its component (`stillsIndexKey`). */
+export declare const StillsIndexSchema: z.ZodObject<{
+    stills: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export type StillsIndex = z.infer<typeof StillsIndexSchema>;
+/** A component as `slides/component-stills` takes it (its name, props, size and moment), as one string: its keys sorted. */
+export declare const stillsIndexKey: (component: unknown) => string;
+/** An item's gallery preview in the tree: its `Preview` (a picture, words or rows), as JSON. */
+export declare const snapshotPreviewPath: (itemDir: string) => string;
+/**
+ * The tree's fixed pages: each reads what to show from its own address.
+ * - the stage: `?piece=<id>&combo=<key>` and where it starts (`t`,
+ *   `part`, `offset`, `dur`), `play=1`, `chrome=0`, `mode=code|component`;
+ *   it loads the piece's source (`pieceSourcePath`); without `piece` it is
+ *   the bare stage a host drives (`window.allyhub`);
+ * - a scenery's viewer: `?file=<the scenery's or model's file>` and
+ *   `camera=<JSON>`; it loads its source (`scenerySourcePath`);
+ * - the probe, which says by postMessage that a sandboxed frame loads.
+ */
+export declare const TREE_PAGES: {
+    readonly stage: "runtime/stage.html";
+    readonly viewer: "runtime/viewer.html";
+    readonly probe: "runtime/probe.html";
+};
+/** Where a piece's `BuildSource` is in the tree: its addresses are relative to the tree's root. */
+export declare const pieceSourcePath: (piece: string) => string;
+/**
+ * What a scenery's viewer loads: its bundle, three.js's decoders and
+ * manifold's wasm, each a path from the tree's root, and the bakes on
+ * disk by name (`<digest>.<renderer>`, served at `bakes/<name>.bin`).
+ */
+export interface ScenerySource {
+    module: string;
+    decoders: string;
+    manifoldWasm: string;
+    bakes: string[];
+}
+/** Where a scenery's (or a 3D model's) `ScenerySource` is in the tree. */
+export declare const scenerySourcePath: (file: string) => string;
+/**
+ * A path of the tree as an address relative to its root: each segment
+ * percent-encoded, so a server that decodes the address once finds the
+ * path (an answer's or a source's name holds encoded characters itself).
+ */
+export declare const treeHref: (path: string) => string;
+/**
+ * Where a live server makes a sound as the export decodes it (a take
+ * denoised or sped, a stem filtered), on demand. Not recorded: a
+ * snapshot's stage plays the recording instead.
+ */
+export declare const SOUND_FOLDER = "sound/";
+/**
+ * The stage's and the viewer's CSP, wherever the tree is served (`tree`:
+ * its root's absolute address, ending in "/"): the runtime, the builds and
+ * the media, nothing else; framed only by `ancestors` (origins). A 3D
+ * scenery needs three things more, all its own: three.js's decoders run in
+ * workers made from blob: addresses, with WebAssembly; a glTF's embedded
+ * pictures, which its loader fetches from blob: addresses; and
+ * 'unsafe-eval', because the Basis transcoder's bindings make functions
+ * from strings as it starts. The stage runs the project's own code
+ * already, so evaluating strings gives it nothing it lacks; what the
+ * policy keeps is where the page can reach, which none of these widens
+ * beyond the tree.
+ */
+export declare function stageCsp(tree: string, ancestors: readonly string[]): string;
+/**
+ * The editors' page of a read view showing one item, read only, as the
+ * window frames it: `<origin>/editor/?item=<dir>&embed=studio&snapshot=1`
+ * and the window's theme. For a share's viewer (`viewer`, `&viewer=1`):
+ * the item alone, nothing offered that changes it or needs the machine
+ * (HostContext's `viewer`). Opened at a place (`place`): where the person
+ * was in the item (`t=`, `slide=`).
+ */
+export declare function snapshotEditorUrl(origin: string, item: string, o?: {
+    theme?: "light" | "dark";
+    viewer?: boolean;
+    place?: Place | undefined;
+}): string;
+export declare const EXECUTOR_KINDS: readonly ["cloud", "computer"];
+export type ExecutorKind = (typeof EXECUTOR_KINDS)[number];
+/** The header a computer's Host sends with its sign-in: the id it made for itself. */
+export declare const COMPUTER_HEADER = "x-allyhub-computer";
+/** A computer's id: what it made once, kept with its Host. */
+export declare const ComputerIdSchema: z.ZodString;
+/** The error code a snapshot or a move answers with when another executor works on the project (409). */
+export declare const WORKED_ELSEWHERE = "worked_elsewhere";
+/** Which executor works on a project, and whether it is the one asking. */
+export declare const ExecutorSchema: z.ZodObject<{
+    kind: z.ZodUnion<readonly [z.ZodEnum<{
+        cloud: "cloud";
+        computer: "computer";
+    }>, z.core.$ZodBranded<z.ZodString, "Unknown", "out">]>;
+    here: z.ZodBoolean;
+}, z.core.$strip>;
+export type Executor = z.infer<typeof ExecutorSchema>;
+/**
+ * `POST { blobs }`: which of these the organization lacks; answers a
+ * signed PUT for each (its sha256 signed in), none for what it holds.
+ */
+export declare const SNAPSHOT_BLOBS_PATH = "/api/snapshots/blobs";
+/**
+ * `POST { project, manifest }`: a snapshot recorded, its manifest a blob
+ * put already, by the project's executor. `project.id` absent: a project
+ * the server has not seen, made now, worked on by the executor that
+ * recorded it. Answers 409 with the blobs storage does not hold, or 409
+ * WORKED_ELSEWHERE when another executor works on the project.
+ */
+export declare const SNAPSHOTS_PATH = "/api/snapshots";
+export declare const SnapshotCreateSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            home: "home";
+            project: "project";
+        }>;
+        name: z.ZodString;
+    }, z.core.$strict>;
+    manifest: z.ZodString;
+}, z.core.$strict>;
+export type SnapshotCreate = z.infer<typeof SnapshotCreateSchema>;
+export declare const SnapshotCreatedSchema: z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodString;
+}, z.core.$strip>;
+export type SnapshotCreated = z.infer<typeof SnapshotCreatedSchema>;
+export declare const SnapshotMissingSchema: z.ZodObject<{
+    missing: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/** `GET`: the person's projects in the organization and their Studio's home, each with its latest snapshot. */
+export declare const PROJECTS_PATH = "/api/projects";
+export declare const SnapshotInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    madeAt: z.ZodISODateTime;
+    hostVersion: z.ZodString;
+}, z.core.$strip>;
+export type SnapshotInfo = z.infer<typeof SnapshotInfoSchema>;
+export declare const ProjectInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        home: "home";
+        project: "project";
+    }>;
+    name: z.ZodString;
+    latest: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        madeAt: z.ZodISODateTime;
+        hostVersion: z.ZodString;
+    }, z.core.$strip>>;
+    executor: z.ZodObject<{
+        kind: z.ZodUnion<readonly [z.ZodEnum<{
+            cloud: "cloud";
+            computer: "computer";
+        }>, z.core.$ZodBranded<z.ZodString, "Unknown", "out">]>;
+        here: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ProjectInfo = z.infer<typeof ProjectInfoSchema>;
+export declare const ProjectsResponseSchema: z.ZodObject<{
+    projects: z.ZodPipe<z.ZodArray<z.ZodUnknown>, z.ZodTransform<{
+        id: string;
+        kind: "home" | "project";
+        name: string;
+        latest: {
+            id: string;
+            madeAt: string;
+            hostVersion: string;
+        } | null;
+        executor: {
+            kind: (string & z.core.$brand<"Unknown">) | "cloud" | "computer";
+            here: boolean;
+        };
+    }[], unknown[]>>;
+}, z.core.$strip>;
+/** `DELETE`: a project forgotten with its snapshots. */
+export declare const projectPath: (id: string) => string;
+/**
+ * `PUT { kind }`: the project moved to another executor, answered as its
+ * `ProjectInfo`: to the person's cloud Studio from anywhere they are
+ * signed in, to a computer only by that computer (COMPUTER_HEADER). The
+ * executor it leaves is refused from then on (WORKED_ELSEWHERE). A home
+ * stays where it is.
+ */
+export declare const projectExecutorPath: (id: string) => string;
+export declare const ExecutorMoveSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        cloud: "cloud";
+        computer: "computer";
+    }>;
+}, z.core.$strict>;
+export type ExecutorMove = z.infer<typeof ExecutorMoveSchema>;
+/**
+ * `POST`: a read view of a snapshot, answered `{ origin, expiresAt }`: a
+ * host of its own on the Studio domain, serving the manifest at
+ * `manifest.json`, the tree at its paths, the project's files under
+ * `files/` and the transcripts under `conversations/<sessionId>.json`,
+ * until it expires. Its name is the capability.
+ */
+export declare const snapshotViewPath: (id: string) => string;
+export declare const SnapshotViewSchema: z.ZodObject<{
+    origin: z.ZodURL;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type SnapshotView = z.infer<typeof SnapshotViewSchema>;
+/** A read view's paths besides the tree's. */
+export declare const SNAPSHOT_VIEW: {
+    readonly manifest: "manifest.json";
+    readonly files: "files/";
+    readonly conversations: "conversations/";
+};
+/**
+ * The JSON-RPC error a read-only host answers for what needs the machine
+ * (a change, an export, a check run, the agent): the window offers to wake
+ * it.
+ */
+export declare const NEEDS_MACHINE = -32010;
+/**
+ * The JSON-RPC error a Host answers for a change to a project another
+ * executor works on (an editor's save, an agent's turn, an upload): one
+ * place works on a project at a time, every other reads it; the window
+ * offers the move.
+ */
+export declare const ELSEWHERE = -32011;
+/**
+ * The JSON-RPC error a move answers when the folder it would replace has
+ * changes made here since its base (the snapshot it last recorded or was
+ * made from) that the latest snapshot lacks: nothing moved; the data names
+ * them (MoveChangesSchema), and the move asked again with `replace`
+ * replaces them.
+ */
+export declare const CHANGED_HERE = -32012;
+export declare const MoveChangesSchema: z.ZodObject<{
+    changed: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type MoveChanges = z.infer<typeof MoveChangesSchema>;
+//# sourceMappingURL=snapshots.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as e}from"zod";import{BlobSchema as f,Sha256Schema as h,TreeFileSchema as l,TreePathSchema as p}from"./blobs.js";import{placeParams as x}from"./editor.js";import{openEnum as S,readable as b}from"./open.js";export const SNAPSHOT_FORMAT=1,ConversationEntrySchema=e.object({sessionId:e.string().min(1),agent:e.string().min(1),title:e.string().optional(),createdAt:e.iso.datetime(),updatedAt:e.iso.datetime(),transcript:h}),TranscriptSchema=e.object({sessionId:e.string().min(1),messages:e.array(e.object({method:e.string().min(1),params:e.unknown()}))}),SNAPSHOT_KINDS=["project","home"];const $=e.string().refine(t=>t.endsWith("/")&&p.safeParse(t.slice(0,-1)).success,"a folder of the tree, ending in /");export const ItemReachSchema=e.object({tree:e.array(p),files:e.array(p),own:e.record(p,l)}),SnapshotReachSchema=e.object({shared:e.array($),items:e.record(e.string(),ItemReachSchema)}),SnapshotManifestSchema=e.object({format:e.literal(SNAPSHOT_FORMAT),kind:e.enum(SNAPSHOT_KINDS),project:e.object({name:e.string().min(1).max(255)}),host:e.object({version:e.string().min(1)}),madeAt:e.iso.datetime(),files:e.record(p,f),tree:e.record(p,l),conversations:e.array(ConversationEntrySchema),reach:SnapshotReachSchema.optional()});export function scopedManifest(t,s){const o=t.reach,c=o!==void 0&&Object.hasOwn(o.items,s)?o.items[s]:void 0;if(o===void 0||c===void 0)return;const r={};for(const[n,i]of Object.entries(t.tree))o.shared.some(m=>n.startsWith(m))&&(r[n]=i);for(const n of c.tree){const i=Object.hasOwn(t.tree,n)?t.tree[n]:void 0;i!==void 0&&(r[n]=i)}Object.assign(r,c.own);const a={};for(const n of c.files){const i=Object.hasOwn(t.files,n)?t.files[n]:void 0;i!==void 0&&(a[n]=i)}return{format:t.format,kind:t.kind,project:t.project,host:t.host,madeAt:t.madeAt,files:a,tree:r,conversations:[]}}export const SNAPSHOT_SKIPPED=["node_modules",".allyhub/cache",".allyhub/out"],SNAPSHOT_TREE={editor:"editor/",runtime:"runtime/",build:"build/",media:"media/",matte:"matte/",scenery:"scenery/",bakes:"bakes/",stills:"stills/",answers:"answers/",previews:"previews/"};function d(t){return Array.isArray(t)?t.map(d):t!==null&&typeof t=="object"?Object.fromEntries(Object.keys(t).sort().map(s=>[s,d(t[s])])):t}export const snapshotAnswerPath=(t,s)=>`${SNAPSHOT_TREE.answers}${t}/${encodeURIComponent(JSON.stringify(d(s??{})))}.json`,stillPath=t=>`${SNAPSHOT_TREE.stills}${t}.webp`,stillsIndexPath=(t,s)=>`${SNAPSHOT_TREE.stills}index/${encodeURIComponent(t)}/${encodeURIComponent(s)}.json`,StillsIndexSchema=e.object({stills:e.record(e.string(),e.string().regex(/^[0-9a-f]{64}$/u))}),stillsIndexKey=t=>JSON.stringify(d(t)),snapshotPreviewPath=t=>`${SNAPSHOT_TREE.previews}${encodeURIComponent(t===""?".":t)}.json`,TREE_PAGES={stage:`${SNAPSHOT_TREE.runtime}stage.html`,viewer:`${SNAPSHOT_TREE.runtime}viewer.html`,probe:`${SNAPSHOT_TREE.runtime}probe.html`},pieceSourcePath=t=>`${SNAPSHOT_TREE.build}sources/${encodeURIComponent(t)}.json`,scenerySourcePath=t=>`${SNAPSHOT_TREE.scenery}sources/${encodeURIComponent(t)}.json`,treeHref=t=>t.split("/").map(encodeURIComponent).join("/"),SOUND_FOLDER="sound/";export function stageCsp(t,s){const o=u=>`${t}${u}`,c=o(SNAPSHOT_TREE.runtime),r=o(SNAPSHOT_TREE.build),a=o(SNAPSHOT_TREE.scenery),n=o(SNAPSHOT_TREE.media),i=o(SNAPSHOT_TREE.matte),m=o(SOUND_FOLDER);return["default-src 'none'",`script-src 'unsafe-eval' 'wasm-unsafe-eval' ${c} ${r} ${a}`,"worker-src blob:",`style-src 'unsafe-inline' ${c} ${r} ${a}`,`font-src ${c} ${r} ${n} data:`,`img-src ${n} ${r} ${a} data: blob:`,`media-src ${n} ${i} ${m} blob:`,`connect-src ${n} ${i} ${m} ${r} ${a} ${o(SNAPSHOT_TREE.bakes)} ${c} blob: data:`,`frame-ancestors ${s.length>0?s.join(" "):"'none'"}`].join("; ")}export function snapshotEditorUrl(t,s,o={}){const c=Object.entries({item:s,embed:"studio",snapshot:"1",...o.viewer===!0?{viewer:"1"}:{},...o.theme===void 0?{}:{theme:o.theme},...x(o.place)}).map(([r,a])=>`${r}=${encodeURIComponent(a)}`);return`${t.replace(/\/$/u,"")}/${SNAPSHOT_TREE.editor}?${c.join("&")}`}export const EXECUTOR_KINDS=["cloud","computer"],COMPUTER_HEADER="x-allyhub-computer",ComputerIdSchema=e.string().regex(/^[A-Za-z0-9_-]{16,64}$/u),WORKED_ELSEWHERE="worked_elsewhere",ExecutorSchema=e.object({kind:S(EXECUTOR_KINDS),here:e.boolean()}),SNAPSHOT_BLOBS_PATH="/api/snapshots/blobs",SNAPSHOTS_PATH="/api/snapshots",SnapshotCreateSchema=e.strictObject({project:e.strictObject({id:e.string().min(1).optional(),kind:e.enum(SNAPSHOT_KINDS),name:e.string().min(1).max(255)}),manifest:h}),SnapshotCreatedSchema=e.object({id:e.string().min(1),projectId:e.string().min(1)}),SnapshotMissingSchema=e.object({missing:e.array(h)}),PROJECTS_PATH="/api/projects",SnapshotInfoSchema=e.object({id:e.string().min(1),madeAt:e.iso.datetime(),hostVersion:e.string()}),ProjectInfoSchema=e.object({id:e.string().min(1),kind:e.enum(SNAPSHOT_KINDS),name:e.string(),latest:SnapshotInfoSchema.nullable(),executor:ExecutorSchema}),ProjectsResponseSchema=e.object({projects:b(ProjectInfoSchema)}),projectPath=t=>`${PROJECTS_PATH}/${encodeURIComponent(t)}`,projectExecutorPath=t=>`${projectPath(t)}/executor`,ExecutorMoveSchema=e.strictObject({kind:e.enum(EXECUTOR_KINDS)}),snapshotViewPath=t=>`${SNAPSHOTS_PATH}/${encodeURIComponent(t)}/view`,SnapshotViewSchema=e.object({origin:e.url(),expiresAt:e.iso.datetime()}),SNAPSHOT_VIEW={manifest:"manifest.json",files:"files/",conversations:"conversations/"},NEEDS_MACHINE=-32010,ELSEWHERE=-32011,CHANGED_HERE=-32012,MoveChangesSchema=e.object({changed:e.array(e.string())});

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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-/** `GET`: the organizations the person is in, the one a request acts in unless it names another first. */
+/** `GET`: the organizations the person is in, the one a request acts in unless it names another first; `POST { name }`: a new team. */
 export declare const ORGANIZATIONS_PATH = "/api/organizations";
 export declare const OrganizationsSchema: z.ZodObject<{
     organizations: z.ZodArray<z.ZodObject<{
@@ -24,30 +24,48 @@ export declare const MembersSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Members = z.infer<typeof MembersSchema>;
-/** `PUT { monthly }`, an owner's or an admin's: a member's limit in credits a month, null for none. */
-export declare const memberLimitPath: (userId: string) => string;
+/** A member's limit in credits a month, null for none (`members/limit`, account.ts). */
 export declare const MemberLimitSchema: z.ZodObject<{
     monthly: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strict>;
-/** `DELETE`, its owner's: the team the request acts in dissolved. */
+/** `DELETE`, its owner's: the team the request acts in dissolved; `PUT { name }`, an owner's or an admin's: renamed. */
 export declare const ORGANIZATION_PATH = "/api/organization";
-/** `POST`, its owner's: a dissolved team restored, within 30 days. */
-export declare const restorePath: (id: string) => string;
 /** `GET`: the person's cloud Studio, if any, and what an hour of it costs; `DELETE`: it gone. */
 export declare const STUDIO_PATH = "/api/studio";
+/** Whether a cloud Studio is running or asleep. */
+export declare const STUDIO_STATES: readonly ["running", "paused"];
 export declare const StudioSchema: z.ZodObject<{
     studio: z.ZodNullable<z.ZodObject<{
-        state: z.ZodEnum<{
+        state: z.ZodUnion<readonly [z.ZodEnum<{
             running: "running";
             paused: "paused";
-        }>;
+        }>, z.core.$ZodBranded<z.ZodString, "Unknown", "out">]>;
         organizationId: z.ZodString;
     }, z.core.$strip>>;
     creditsPerHour: z.ZodNumber;
 }, z.core.$strip>;
 export type StudioInfo = z.infer<typeof StudioSchema>;
-/** `POST`, a browser's: the Studio made or woken, answered `{ url }`, its page with a ticket. */
+/**
+ * `POST`, a browser's: the Studio made or woken, answered with its Host's
+ * origin on the gateway and a ticket. The window connects to
+ * `<origin as ws(s)>/studio?ticket=<ticket>`; the gateway takes a ticket
+ * once.
+ */
 export declare const STUDIO_OPEN_PATH = "/api/studio/open";
+export declare const StudioOpenedSchema: z.ZodObject<{
+    origin: z.ZodURL;
+    ticket: z.ZodString;
+}, z.core.$strip>;
+export type StudioOpened = z.infer<typeof StudioOpenedSchema>;
+/**
+ * `POST`, a browser's: a ticket for the person's running Studio (to
+ * connect again, or for one upload: `POST <origin>/upload?…&ticket=`);
+ * 409 when it is not running.
+ */
+export declare const STUDIO_TICKET_PATH = "/api/studio/ticket";
+export declare const StudioTicketSchema: z.ZodObject<{
+    ticket: z.ZodString;
+}, z.core.$strip>;
 /**
  * `PUT { at }`, a cloud Studio's own Host's (its API key): when its next
  * scheduled task is due, null for none. A paused Studio is woken then, its

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

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as t}from"zod";export const ORGANIZATIONS_PATH="/api/organizations",OrganizationsSchema=t.object({organizations:t.array(t.object({id:t.string(),name:t.string(),slug:t.string(),role:t.string(),dissolvedAt:t.iso.datetime().nullable()}))}),MEMBERS_PATH="/api/organization/members",MembersSchema=t.object({members:t.array(t.object({userId:t.string(),email:t.string(),name:t.string(),role:t.string(),limit:t.number().nullable(),used:t.number()}))}),memberLimitPath=e=>`${MEMBERS_PATH}/${encodeURIComponent(e)}/limit`,MemberLimitSchema=t.strictObject({monthly:t.number().nonnegative().nullable()}),ORGANIZATION_PATH="/api/organization",restorePath=e=>`${ORGANIZATIONS_PATH}/${encodeURIComponent(e)}/restore`,STUDIO_PATH="/api/studio",StudioSchema=t.object({studio:t.object({state:t.enum(["running","paused"]),organizationId:t.string()}).nullable(),creditsPerHour:t.number()}),STUDIO_OPEN_PATH="/api/studio/open",STUDIO_WAKE_PATH="/api/studio/wake",StudioWakeSchema=t.strictObject({at:t.iso.datetime().nullable()});
+import{z as t}from"zod";import{openEnum as e}from"./open.js";export const ORGANIZATIONS_PATH="/api/organizations",OrganizationsSchema=t.object({organizations:t.array(t.object({id:t.string(),name:t.string(),slug:t.string(),role:t.string(),dissolvedAt:t.iso.datetime().nullable()}))}),MEMBERS_PATH="/api/organization/members",MembersSchema=t.object({members:t.array(t.object({userId:t.string(),email:t.string(),name:t.string(),role:t.string(),limit:t.number().nullable(),used:t.number()}))}),MemberLimitSchema=t.strictObject({monthly:t.number().nonnegative().nullable()}),ORGANIZATION_PATH="/api/organization",STUDIO_PATH="/api/studio",STUDIO_STATES=["running","paused"],StudioSchema=t.object({studio:t.object({state:e(STUDIO_STATES),organizationId:t.string()}).nullable(),creditsPerHour:t.number()}),STUDIO_OPEN_PATH="/api/studio/open",StudioOpenedSchema=t.object({origin:t.url(),ticket:t.string().min(1)}),STUDIO_TICKET_PATH="/api/studio/ticket",StudioTicketSchema=t.object({ticket:t.string().min(1)}),STUDIO_WAKE_PATH="/api/studio/wake",StudioWakeSchema=t.strictObject({at:t.iso.datetime().nullable()});

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

@@ -35,11 +35,11 @@ export declare const CHECK_STATES: readonly ["off", "waiting", "running", "done"
 /** The check the server runs after edits, as it stands. */
 export declare const CheckStateSchema: z.ZodObject<{
     status: z.ZodEnum<{
+        failed: "failed";
+        running: "running";
         off: "off";
         waiting: "waiting";
-        running: "running";
         done: "done";
-        failed: "failed";
     }>;
     revision: z.ZodInt;
     problems: z.ZodArray<z.ZodObject<{
@@ -77,9 +77,9 @@ export declare const ExportJobSchema: z.ZodObject<{
     types: z.ZodArray<z.ZodString>;
     options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
     state: z.ZodEnum<{
+        failed: "failed";
         running: "running";
         done: "done";
-        failed: "failed";
         queued: "queued";
         cancelled: "cancelled";
     }>;
@@ -92,14 +92,16 @@ export type ExportJob = z.infer<typeof ExportJobSchema>;
 export declare const IndexJobSchema: z.ZodObject<{
     file: z.ZodString;
     status: z.ZodEnum<{
+        failed: "failed";
         running: "running";
         done: "done";
-        failed: "failed";
     }>;
     message: z.ZodString;
     share: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export type IndexJob = z.infer<typeof IndexJobSchema>;
+/** Most components `slides/component-stills` draws in one call. */
+export declare const COMPONENT_STILLS_MAX = 64;
 export declare const PROJECT_TOOLS: {
     readonly "project/items": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
         items: z.ZodArray<z.ZodObject<{
@@ -116,8 +118,8 @@ export declare const PROJECT_TOOLS: {
             entry: z.ZodString;
             title: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
-        folder: z.ZodString;
         name: z.ZodString;
+        scope: z.ZodString;
         revision: z.ZodInt;
     }, z.core.$strict>>;
     readonly "sheet/generated": MethodSpec<z.ZodObject<{
@@ -152,6 +154,12 @@ export declare const PROJECT_TOOLS: {
         components: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         generators: z.ZodArray<z.ZodString>;
         scripts: z.ZodRecord<z.ZodString, z.ZodString>;
+        code: z.ZodUnknown;
+        theme: z.ZodObject<{
+            name: z.ZodString;
+            colors: z.ZodRecord<z.ZodString, z.ZodString>;
+            fonts: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>;
     }, z.core.$strict>>;
     readonly "video/stage": MethodSpec<z.ZodObject<{
         start: z.ZodOptional<z.ZodObject<{
@@ -162,7 +170,10 @@ export declare const PROJECT_TOOLS: {
         }, z.core.$strict>>;
         play: z.ZodOptional<z.ZodBoolean>;
         chrome: z.ZodOptional<z.ZodBoolean>;
-        edit: z.ZodOptional<z.ZodBoolean>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            code: "code";
+            component: "component";
+        }>>;
         item: z.ZodString;
         version: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>, z.ZodObject<{
@@ -209,13 +220,41 @@ export declare const PROJECT_TOOLS: {
             }, z.core.$strict>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
+    readonly "slides/fonts": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        faces: z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            url: z.ZodURL;
+            weight: z.ZodOptional<z.ZodString>;
+            style: z.ZodOptional<z.ZodString>;
+            stretch: z.ZodOptional<z.ZodString>;
+            unicodeRange: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "slides/component-stills": MethodSpec<z.ZodObject<{
+        components: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            t: z.ZodNumber;
+        }, z.core.$strict>>;
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        stills: z.ZodArray<z.ZodNullable<z.ZodObject<{
+            key: z.ZodString;
+            url: z.ZodURL;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
     readonly "check/results": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
         status: z.ZodEnum<{
+            failed: "failed";
+            running: "running";
             off: "off";
             waiting: "waiting";
-            running: "running";
             done: "done";
-            failed: "failed";
         }>;
         revision: z.ZodInt;
         problems: z.ZodArray<z.ZodObject<{
@@ -254,9 +293,9 @@ export declare const PROJECT_TOOLS: {
             types: z.ZodArray<z.ZodString>;
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
             state: z.ZodEnum<{
+                failed: "failed";
                 running: "running";
                 done: "done";
-                failed: "failed";
                 queued: "queued";
                 cancelled: "cancelled";
             }>;
@@ -276,9 +315,9 @@ export declare const PROJECT_TOOLS: {
             types: z.ZodArray<z.ZodString>;
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
             state: z.ZodEnum<{
+                failed: "failed";
                 running: "running";
                 done: "done";
-                failed: "failed";
                 queued: "queued";
                 cancelled: "cancelled";
             }>;
@@ -325,11 +364,11 @@ export declare const TOOL_NOTIFICATIONS: {
     }, z.core.$strict>>;
     readonly "check/changed": import("./jsonrpc.js").NotificationSpec<z.ZodObject<{
         status: z.ZodEnum<{
+            failed: "failed";
+            running: "running";
             off: "off";
             waiting: "waiting";
-            running: "running";
             done: "done";
-            failed: "failed";
         }>;
         revision: z.ZodInt;
         problems: z.ZodArray<z.ZodObject<{
@@ -362,9 +401,9 @@ export declare const TOOL_NOTIFICATIONS: {
             types: z.ZodArray<z.ZodString>;
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>>;
             state: z.ZodEnum<{
+                failed: "failed";
                 running: "running";
                 done: "done";
-                failed: "failed";
                 queued: "queued";
                 cancelled: "cancelled";
             }>;
@@ -377,9 +416,9 @@ export declare const TOOL_NOTIFICATIONS: {
         jobs: z.ZodArray<z.ZodObject<{
             file: z.ZodString;
             status: z.ZodEnum<{
+                failed: "failed";
                 running: "running";
                 done: "done";
-                failed: "failed";
             }>;
             message: z.ZodString;
             share: z.ZodOptional<z.ZodNumber>;