@allyhub/sdk 0.1.0-alpha.8 → 0.2.0-next.1

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

@@ -0,0 +1,53 @@
+import { z } from "zod";
+export declare const REGISTRY_TYPES: readonly ["allyhub:component", "allyhub:template", "allyhub:scenery", "allyhub:model"];
+export declare const RegistryFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    target: z.ZodString;
+    sha256: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const RegistryItemSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        "allyhub:component": "allyhub:component";
+        "allyhub:template": "allyhub:template";
+        "allyhub:scenery": "allyhub:scenery";
+        "allyhub:model": "allyhub:model";
+    }>;
+    title: z.ZodString;
+    description: z.ZodString;
+    author: z.ZodOptional<z.ZodString>;
+    license: z.ZodString;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    registryDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        target: z.ZodString;
+        sha256: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    categories: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    preview: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type RegistryItem = z.infer<typeof RegistryItemSchema>;
+export declare const RegistryIndexSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    homepage: z.ZodOptional<z.ZodURL>;
+    items: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            "allyhub:component": "allyhub:component";
+            "allyhub:template": "allyhub:template";
+            "allyhub:scenery": "allyhub:scenery";
+            "allyhub:model": "allyhub:model";
+        }>;
+        name: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodString;
+        preview: z.ZodOptional<z.ZodString>;
+        categories: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type RegistryIndex = z.infer<typeof RegistryIndexSchema>;
+//# sourceMappingURL=registry.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/registry.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";export const REGISTRY_TYPES=["allyhub:component","allyhub:template","allyhub:scenery","allyhub:model"];const e=t.string().regex(/^[a-z0-9][a-z0-9-]*$/u);export const RegistryFileSchema=t.strictObject({path:t.string().min(1),target:t.string().min(1),sha256:t.string().regex(/^[0-9a-f]{64}$/u),content:t.string().optional()}),RegistryItemSchema=t.strictObject({$schema:t.string().optional(),name:e,type:t.enum(REGISTRY_TYPES),title:t.string().min(1),description:t.string().min(1),author:t.string().optional(),license:t.string().min(1),dependencies:t.array(t.string()).default([]),registryDependencies:t.array(e).default([]),files:t.array(RegistryFileSchema).min(1),categories:t.array(t.string()).default([]),preview:t.string().optional()}),RegistryIndexSchema=t.strictObject({$schema:t.string().optional(),name:t.string().min(1),homepage:t.url().optional(),items:t.array(RegistryItemSchema.pick({name:!0,type:!0,title:!0,description:!0,categories:!0,preview:!0}))});

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

@@ -0,0 +1,93 @@
+import { z } from "zod";
+/** `${process.platform}-${process.arch}`. */
+export declare const PLATFORMS: readonly ["darwin-arm64", "darwin-x64", "linux-x64", "linux-arm64", "win32-x64"];
+export type Platform = (typeof PLATFORMS)[number];
+export declare const RuntimeFileSchema: z.ZodObject<{
+    url: z.ZodURL;
+    sha256: z.ZodString;
+    size: z.ZodInt;
+    unpack: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        zip: "zip";
+        tgz: "tgz";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+    check: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strict>>>;
+    executable: z.ZodDefault<z.ZodBoolean>;
+    bins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export type RuntimeFile = z.infer<typeof RuntimeFileSchema>;
+export declare const RuntimeSchema: z.ZodObject<{
+    about: z.ZodString;
+    version: z.ZodString;
+    license: z.ZodString;
+    homepage: z.ZodOptional<z.ZodURL>;
+    platforms: z.ZodRecord<z.ZodUnion<readonly [z.ZodEnum<{
+        "darwin-arm64": "darwin-arm64";
+        "darwin-x64": "darwin-x64";
+        "linux-x64": "linux-x64";
+        "linux-arm64": "linux-arm64";
+        "win32-x64": "win32-x64";
+    }>, z.ZodLiteral<"any">]> & z.core.$partial, z.ZodArray<z.ZodObject<{
+        url: z.ZodURL;
+        sha256: z.ZodString;
+        size: z.ZodInt;
+        unpack: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            zip: "zip";
+            tgz: "tgz";
+        }>>;
+        name: z.ZodOptional<z.ZodString>;
+        check: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>>>;
+        executable: z.ZodDefault<z.ZodBoolean>;
+        bins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type Runtime = z.infer<typeof RuntimeSchema>;
+export declare const RuntimeManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodLiteral<1>;
+    runtimes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        about: z.ZodString;
+        version: z.ZodString;
+        license: z.ZodString;
+        homepage: z.ZodOptional<z.ZodURL>;
+        platforms: z.ZodRecord<z.ZodUnion<readonly [z.ZodEnum<{
+            "darwin-arm64": "darwin-arm64";
+            "darwin-x64": "darwin-x64";
+            "linux-x64": "linux-x64";
+            "linux-arm64": "linux-arm64";
+            "win32-x64": "win32-x64";
+        }>, z.ZodLiteral<"any">]> & z.core.$partial, z.ZodArray<z.ZodObject<{
+            url: z.ZodURL;
+            sha256: z.ZodString;
+            size: z.ZodInt;
+            unpack: z.ZodDefault<z.ZodEnum<{
+                none: "none";
+                zip: "zip";
+                tgz: "tgz";
+            }>>;
+            name: z.ZodOptional<z.ZodString>;
+            check: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                sha256: z.ZodString;
+            }, z.core.$strict>>>;
+            executable: z.ZodDefault<z.ZodBoolean>;
+            bins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type RuntimeManifest = z.infer<typeof RuntimeManifestSchema>;
+/** The platform this process runs on, if AllyHub has runtimes for it. */
+export declare function platformOf(platform: string, arch: string): Platform | undefined;
+/** The programs a runtime's files hold, by name. */
+export declare function binsOf(files: readonly RuntimeFile[]): Record<string, string>;
+/** A runtime's files on a platform: its own, else every platform's. */
+export declare function filesFor(runtime: Runtime, platform: Platform): RuntimeFile[] | undefined;
+//# sourceMappingURL=runtimes.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/runtimes.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";export const PLATFORMS=["darwin-arm64","darwin-x64","linux-x64","linux-arm64","win32-x64"];const s=t.string().regex(/^[0-9a-f]{64}$/u),i=t.string().min(1).refine(e=>!e.startsWith("/")&&!e.split(/[\\/]/u).includes(".."),{message:"A path stays inside the runtime's folder."});export const RuntimeFileSchema=t.strictObject({url:t.url({protocol:/^https$/u}),sha256:s,size:t.int().positive(),unpack:t.enum(["none","zip","tgz"]).default("none"),name:i.optional(),check:t.array(t.strictObject({path:i,sha256:s})).default([]),executable:t.boolean().default(!1),bins:t.record(t.string().regex(/^[a-z0-9][a-z0-9-]*$/u),i).default({})}),RuntimeSchema=t.strictObject({about:t.string().min(1),version:t.string().min(1),license:t.string().min(1),homepage:t.url().optional(),platforms:t.partialRecord(t.union([t.enum(PLATFORMS),t.literal("any")]),t.array(RuntimeFileSchema).min(1))}),RuntimeManifestSchema=t.strictObject({$schema:t.string().optional(),version:t.literal(1),runtimes:t.record(t.string().regex(/^[a-z0-9][a-z0-9-]*$/u),RuntimeSchema)});export function platformOf(e,n){const r=`${e}-${n}`;return PLATFORMS.includes(r)?r:void 0}export function binsOf(e){return Object.assign({},...e.map(n=>n.bins))}export function filesFor(e,n){return e.platforms[n]??e.platforms.any}

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

@@ -0,0 +1,67 @@
+import { z } from "zod";
+/** `GET`: the organizations the person is in, their own first. */
+export declare const ORGANIZATIONS_PATH = "/api/organizations";
+export declare const OrganizationsSchema: z.ZodObject<{
+    organizations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodString;
+        kind: z.ZodEnum<{
+            personal: "personal";
+            team: "team";
+        }>;
+        role: z.ZodString;
+        dissolvedAt: z.ZodNullable<z.ZodISODateTime>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Organizations = z.infer<typeof OrganizationsSchema>;
+/** `GET`: the members of the organization the request acts in; a member sees their own row alone. */
+export declare const MEMBERS_PATH = "/api/organization/members";
+export declare const MembersSchema: z.ZodObject<{
+    members: z.ZodArray<z.ZodObject<{
+        userId: z.ZodString;
+        email: z.ZodString;
+        name: z.ZodString;
+        role: z.ZodString;
+        limit: z.ZodNullable<z.ZodNumber>;
+        used: z.ZodNumber;
+    }, 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;
+export declare const MemberLimitSchema: z.ZodObject<{
+    monthly: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+/** `POST`: the person's own credits moved into the team the request acts in; answers `{ moved }`. */
+export declare const MOVE_CREDITS_PATH = "/api/organization/credits/move";
+/** `DELETE`, its owner's: the team the request acts in dissolved. */
+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";
+export declare const StudioSchema: z.ZodObject<{
+    studio: z.ZodNullable<z.ZodObject<{
+        state: z.ZodEnum<{
+            running: "running";
+            paused: "paused";
+        }>;
+        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. */
+export declare const STUDIO_OPEN_PATH = "/api/studio/open";
+/**
+ * `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
+ * Host runs the task as it would on a computer, and it pauses again once
+ * idle.
+ */
+export declare const STUDIO_WAKE_PATH = "/api/studio/wake";
+export declare const StudioWakeSchema: z.ZodObject<{
+    at: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+//# sourceMappingURL=teams.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/teams.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";export const ORGANIZATIONS_PATH="/api/organizations",OrganizationsSchema=t.object({organizations:t.array(t.object({id:t.string(),name:t.string(),slug:t.string(),kind:t.enum(["personal","team"]),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()}),MOVE_CREDITS_PATH="/api/organization/credits/move",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()});

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

@@ -0,0 +1,345 @@
+import { z } from "zod";
+import { type ClientOf, type MethodSpec } from "./jsonrpc.js";
+/** A picture: WebP unless said. */
+export declare const ImageSchema: z.ZodObject<{
+    mime: z.ZodString;
+    data: z.ZodBase64;
+}, z.core.$strict>;
+export type Image = z.infer<typeof ImageSchema>;
+/** A problem of the check (video-core's `Problem`): an objective error, by rule. */
+export declare const ProblemSchema: 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>;
+/** A fact of the check (video-core's `Fact`): a measurement for the agent to judge. */
+export declare const FactSchema: z.ZodObject<{
+    kind: z.ZodString;
+    data: z.ZodUnknown;
+}, z.core.$loose>;
+/** A version's film plan (video-core's `Timeline`). */
+export declare const TimelineSchema: z.ZodObject<{
+    fps: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    duration: z.ZodNumber;
+    parts: z.ZodArray<z.ZodUnknown>;
+}, z.core.$loose>;
+export declare const CHECK_STATES: readonly ["off", "waiting", "running", "done", "failed"];
+/** The check the server runs after edits, as it stands. */
+export declare const CheckStateSchema: 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>;
+export type CheckState = z.infer<typeof CheckStateSchema>;
+export declare const EXPORT_STATES: readonly ["queued", "running", "done", "failed", "cancelled"];
+/** An export the person asked for, one at a time. */
+export declare const ExportJobSchema: z.ZodObject<{
+    id: z.ZodString;
+    item: z.ZodString;
+    versions: z.ZodArray<z.ZodString>;
+    types: z.ZodArray<z.ZodString>;
+    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>;
+export type ExportJob = z.infer<typeof ExportJobSchema>;
+/** Where indexing a video the project uses is (a face track, a person matte). */
+export declare const IndexJobSchema: 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>;
+export type IndexJob = z.infer<typeof IndexJobSchema>;
+export declare const PROJECT_TOOLS: {
+    readonly "project/items": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                video: "video";
+                slides: "slides";
+                doc: "doc";
+                sheet: "sheet";
+                scenery: "scenery";
+                website: "website";
+            }>;
+            dir: z.ZodString;
+            entry: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        folder: z.ZodString;
+        name: z.ZodString;
+        revision: z.ZodInt;
+    }, z.core.$strict>>;
+    readonly "video/versions": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        piece: z.ZodString;
+        kind: z.ZodEnum<{
+            video: "video";
+            slides: "slides";
+        }>;
+        title: z.ZodOptional<z.ZodString>;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        versions: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            lang: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    readonly "video/stage": MethodSpec<z.ZodObject<{
+        start: z.ZodOptional<z.ZodObject<{
+            t: z.ZodOptional<z.ZodNumber>;
+            part: z.ZodOptional<z.ZodString>;
+            offset: z.ZodOptional<z.ZodNumber>;
+            dur: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        play: z.ZodOptional<z.ZodBoolean>;
+        chrome: z.ZodOptional<z.ZodBoolean>;
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        url: z.ZodString;
+        probe: z.ZodString;
+    }, z.core.$strict>>;
+    readonly "video/timeline": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeline: z.ZodObject<{
+            fps: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            duration: z.ZodNumber;
+            parts: z.ZodArray<z.ZodUnknown>;
+        }, z.core.$loose>;
+        text: z.ZodArray<z.ZodUnknown>;
+    }, z.core.$strict>>;
+    readonly "video/still": MethodSpec<z.ZodObject<{
+        t: z.ZodOptional<z.ZodNumber>;
+        item: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        t: z.ZodNumber;
+        image: z.ZodObject<{
+            mime: z.ZodString;
+            data: z.ZodBase64;
+        }, z.core.$strict>;
+        width: z.ZodInt;
+        height: z.ZodInt;
+        duration: z.ZodNumber;
+    }, z.core.$strict>>;
+    readonly "check/results": MethodSpec<z.ZodObject<{}, z.core.$strict>, 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 "check/run": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "export/start": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+        versions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>, z.ZodObject<{
+        job: z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+            versions: z.ZodArray<z.ZodString>;
+            types: z.ZodArray<z.ZodString>;
+            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 "export/cancel": MethodSpec<z.ZodObject<{
+        job: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{}, z.core.$strict>>;
+    readonly "export/list": MethodSpec<z.ZodObject<{}, z.core.$strict>, z.ZodObject<{
+        jobs: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            item: z.ZodString;
+            versions: z.ZodArray<z.ZodString>;
+            types: z.ZodArray<z.ZodString>;
+            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 "scenery/viewer": MethodSpec<z.ZodObject<{
+        item: z.ZodString;
+        camera: z.ZodOptional<z.ZodObject<{
+            position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+            target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        url: z.ZodString;
+        probe: z.ZodString;
+    }, z.core.$strict>>;
+};
+export type ProjectToolName = keyof typeof PROJECT_TOOLS;
+/**
+ * What a person can do in an editor, an agent can do too
+ * (docs/editors.md): for each tool, the CLI command that does the same
+ * through the same package function, or the files an agent reads or
+ * writes instead. Every tool has its line; the CLI's tests check that
+ * each command named is one.
+ */
+export declare const AGENT_DOES: Record<ProjectToolName, {
+    command: string;
+} | {
+    files: string;
+}>;
+/** The project's tools, as typed calls. */
+export type ToolsClient = ClientOf<typeof PROJECT_TOOLS>;
+/** A tool's spec, by name. */
+export declare function toolSpec(name: string): MethodSpec | undefined;
+export declare const TOOL_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>;
+            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>>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/node_modules/@allyhub-next/protocol/dist/tools.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{KINDS as c}from"@allyhub-next/formats";import{PathSchema as n}from"./files.js";import{method as t,notification as r}from"./jsonrpc.js";const i={item:n,version:e.string().optional()};export const ImageSchema=e.strictObject({mime:e.string().regex(/^image\//u),data:e.base64()}),ProblemSchema=e.looseObject({code:e.string(),level:e.enum(["error","warn"]),message:e.string(),piece:e.string().optional(),part:e.string().optional(),t:e.number().optional()}),FactSchema=e.looseObject({kind:e.string(),data:e.unknown()}),TimelineSchema=e.looseObject({fps:e.number(),width:e.number(),height:e.number(),duration:e.number(),parts:e.array(e.unknown())}),CHECK_STATES=["off","waiting","running","done","failed"],CheckStateSchema=e.strictObject({status:e.enum(CHECK_STATES),revision:e.int().nonnegative(),problems:e.array(ProblemSchema),facts:e.array(FactSchema),versions:e.strictObject({total:e.int(),loaded:e.int(),reused:e.int()}).optional(),error:e.string().optional()}),EXPORT_STATES=["queued","running","done","failed","cancelled"],ExportJobSchema=e.strictObject({id:e.string(),item:n,versions:e.array(e.string()),types:e.array(e.string()),state:e.enum(EXPORT_STATES),progress:e.number().min(0).max(1),files:e.array(n),error:e.string().optional()}),IndexJobSchema=e.strictObject({file:n,status:e.enum(["running","done","failed"]),message:e.string(),share:e.number().min(0).max(1).optional()});const s=e.tuple([e.number(),e.number(),e.number()]),a=e.strictObject({url:e.string(),probe:e.string()});export const PROJECT_TOOLS={"project/items":t(e.strictObject({}),e.strictObject({items:e.array(e.strictObject({kind:e.enum(c),dir:n,entry:n,title:e.string().optional()})),folder:e.string(),name:e.string(),revision:e.int().nonnegative()}),"The project's items, as the build finds them."),"video/versions":t(e.strictObject({item:n}),e.strictObject({piece:e.string(),kind:e.enum(["video","slides"]),title:e.string().optional(),width:e.number(),height:e.number(),versions:e.array(e.strictObject({key:e.string(),lang:e.string().optional()}))}),"A video's or a deck's versions, one per language: what its stage, its timeline and its exports are asked for."),"video/stage":t(e.strictObject({...i,start:e.strictObject({t:e.number().nonnegative().optional(),part:e.string().optional(),offset:e.number().nonnegative().optional(),dur:e.number().positive().optional()}).optional(),play:e.boolean().optional(),chrome:e.boolean().optional()}),a,"The address of a version's stage page, for a sandboxed frame: it plays the piece and talks to its parent by postMessage."),"video/timeline":t(e.strictObject(i),e.strictObject({timeline:TimelineSchema,text:e.array(e.unknown())}),"A version's timeline, drawn nowhere."),"video/still":t(e.strictObject({...i,t:e.number().nonnegative().optional()}),e.strictObject({t:e.number(),image:ImageSchema,width:e.int().positive(),height:e.int().positive(),duration:e.number().nonnegative()}),"A moment of a version as the render draws it, as a picture."),"check/results":t(e.strictObject({}),CheckStateSchema,"The check run after edits, as it stands."),"check/run":t(e.strictObject({}),e.strictObject({}),"Runs the check again now."),"export/start":t(e.strictObject({item:n,versions:e.array(e.string()).optional(),types:e.array(e.string().min(1)).max(10).optional()}),e.strictObject({job:ExportJobSchema}),"Exports an item (its versions, as file types) into .allyhub/out/; `export/changed` says how it goes."),"export/cancel":t(e.strictObject({job:e.string()}),e.strictObject({}),"Stops an export."),"export/list":t(e.strictObject({}),e.strictObject({jobs:e.array(ExportJobSchema)}),"The exports asked for since the server started."),"scenery/viewer":t(e.strictObject({item:n,camera:e.strictObject({position:s,target:s}).optional()}),a,"The address of a scenery's viewer page, for a sandboxed frame: it tells what the person does by postMessage.")},AGENT_DOES={"project/items":{files:"the project's folder"},"video/versions":{command:"inspect combos"},"video/stage":{command:"frames"},"video/timeline":{command:"inspect timeline"},"video/still":{command:"frames"},"check/results":{command:"inspect"},"check/run":{command:"check"},"export/start":{command:"render"},"export/cancel":{command:"render"},"export/list":{files:".allyhub/out/"},"scenery/viewer":{command:"scenery view"}};export function toolSpec(o){return Object.hasOwn(PROJECT_TOOLS,o)?PROJECT_TOOLS[o]:void 0}export const TOOL_NOTIFICATIONS={"project/changed":r(e.strictObject({revision:e.int().nonnegative()}),"The build saw a change: a stage or a timeline asked for now is the new one's."),"check/changed":r(CheckStateSchema,"The check started, ended or failed."),"export/changed":r(e.strictObject({job:ExportJobSchema}),"An export moved on."),"index/changed":r(e.strictObject({jobs:e.array(IndexJobSchema)}),"Making what the media index lacks moved on.")};

package/node_modules/@allyhub-next/protocol/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/protocol",
+  "version": "0.2.0-next.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}