mockpit 1.2.0 → 2.0.0

package/dist/mcp/server.js

@@ -144,6 +144,26 @@ async function ensureSession(title) {
     sessionId = session.id;
     return sessionId;
 }
+// A poster may name an image file: it travels as an upload, never as bytes in
+// the model's context. Anything else goes through as the asset id it is.
+async function posterId(value, session) {
+    if (typeof value !== "string")
+        return value;
+    try {
+        if (!statSync(value).isFile())
+            return value;
+    }
+    catch {
+        return value;
+    }
+    const asset = await post("/api/assets", {
+        data: readFileSync(value, "base64"),
+        contentType: contentTypeForPath(value),
+        filename: value.split(/[\\/]/).pop(),
+        session,
+    });
+    return asset.id;
+}
 // Every tool is a pass-through to the REST route the CLI uses, mapped the way
 // server/mcpHttp.ts maps HTTP MCP: same request, same response, so the tiers
 // cannot drift. Only the session (one per conversation), the project (this
@@ -156,6 +176,8 @@ const handlers = {
             ...args,
             html,
             parts: readPartFiles(args.parts),
+            fills: readPartFiles(args.fills),
+            poster: await posterId(args.poster, session),
             session,
             agent: AGENT,
             project: resolveProject(args.project),
@@ -169,13 +191,15 @@ const handlers = {
             project: resolveProject(args.project),
         });
     },
-    read: (args) => json(args.mock === undefined
-        ? `/api/mocks${query({ project: resolveProject(args.project) })}`
-        : `/api/mocks/${enc(args.mock)}${query({
-            project: resolveProject(args.project),
-            body: args.body,
-            history: args.history,
-        })}`),
+    read: (args) => json(args.mock === undefined && args.tree === true
+        ? `/api/projects/${enc(resolveProject(args.project))}/tree`
+        : args.mock === undefined
+            ? `/api/mocks${query({ project: resolveProject(args.project) })}`
+            : `/api/mocks/${enc(args.mock)}${query({
+                project: resolveProject(args.project),
+                body: args.body,
+                history: args.history,
+            })}`),
     // Never waits: the server reads from the session's cursor, shared with
     // piggyback and `mockpit watch`, so each Send is delivered exactly once.
     async feedback(args) {
@@ -192,6 +216,20 @@ const handlers = {
             message: args.message,
         });
     },
+    async edit(args) {
+        const session = await ensureSession();
+        const project = resolveProject(args.project);
+        if (args.rename !== undefined || args.areaOrder !== undefined) {
+            if (args.mock !== undefined) {
+                throw new Error('"rename" and "areaOrder" edit the project; edit the mock without them');
+            }
+            return post(`/api/projects/${enc(project)}`, { name: args.rename, areaOrder: args.areaOrder, session }, "PATCH");
+        }
+        if (typeof args.mock !== "string" || !args.mock) {
+            throw new Error('provide "mock", or "rename" / "areaOrder" to edit the project');
+        }
+        return post(`/api/mocks/${enc(args.mock)}`, { ...args, project, session }, "PATCH");
+    },
     export: (args) => json(`/api/mocks/${enc(args.mock)}/export${query({
         project: resolveProject(args.project),
         state: args.state,

package/dist/server/apiViews.d.ts

@@ -1,5 +1,5 @@
 import { type PartInfo } from "./parts.ts";
-import { type Mock, type Post, type PostVersion, type Session, type Surface } from "./types.ts";
+import { type Embed, type KnobValue, type Mock, type Post, type PostVersion, type Session, type Surface } from "./types.ts";
 export declare const surfaceRef: (surface: Pick<Surface, "id" | "kind">, index: number) => {
     id: string | undefined;
     kind: "html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code";
@@ -10,6 +10,7 @@ export declare const fullSurfaceView: (surface: Surface, index: number) => {
     kind: "html";
     html: string;
     kits?: string[];
+    poster?: string;
     id?: string;
 } | {
     index: number;
@@ -56,11 +57,12 @@ export declare const fullSurfaceView: (surface: Surface, index: number) => {
     lineStart?: number;
     id?: string;
 };
-export declare const hydratedSurfaceView: (surface: Surface, index: number) => Record<string, unknown> | {
+export declare const hydratedSurfaceView: (surface: Surface, index: number) => {
     index: number;
     kind: "html";
     html: string;
     kits?: string[];
+    poster?: string;
     id?: string;
 } | {
     index: number;
@@ -106,8 +108,18 @@ export declare const hydratedSurfaceView: (surface: Surface, index: number) => R
     title?: string;
     lineStart?: number;
     id?: string;
-};
+} | Record<string, unknown>;
 export declare const historyMetaView: (version: PostVersion) => {
+    poster: string;
+    surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+    author?: string | undefined;
+    prompt?: string | undefined;
+    from?: number | undefined;
+    version: number;
+    title: string;
+    at: string;
+} | {
+    poster?: undefined;
     surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
     author?: string | undefined;
     prompt?: string | undefined;
@@ -119,9 +131,18 @@ export declare const historyMetaView: (version: PostVersion) => {
 export interface VariantViewOptions {
     body?: boolean;
     history?: boolean;
+    embeds?: Map<string, EmbedView>;
+}
+export interface EmbedView {
+    key: string;
+    list: (Embed & {
+        latest: number;
+        versions: number[];
+    })[];
 }
 export declare const variantView: (post: Post, opts?: VariantViewOptions) => {
-    history?: {
+    history?: ({
+        poster: string;
         surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
         author?: string | undefined;
         prompt?: string | undefined;
@@ -129,13 +150,43 @@ export declare const variantView: (post: Post, opts?: VariantViewOptions) => {
         version: number;
         title: string;
         at: string;
-    }[] | undefined;
+    } | {
+        poster?: undefined;
+        surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+        author?: string | undefined;
+        prompt?: string | undefined;
+        from?: number | undefined;
+        version: number;
+        title: string;
+        at: string;
+    } | {
+        hidden: true;
+        poster: string;
+        surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+        author?: string | undefined;
+        prompt?: string | undefined;
+        from?: number | undefined;
+        version: number;
+        title: string;
+        at: string;
+    } | {
+        hidden: true;
+        poster?: undefined;
+        surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+        author?: string | undefined;
+        prompt?: string | undefined;
+        from?: number | undefined;
+        version: number;
+        title: string;
+        at: string;
+    })[] | undefined;
     parts: string[];
-    surfaces: (Record<string, unknown> | {
+    surfaces: ({
         index: number;
         kind: "html";
         html: string;
         kits?: string[];
+        poster?: string;
         id?: string;
     } | {
         index: number;
@@ -181,64 +232,285 @@ export declare const variantView: (post: Post, opts?: VariantViewOptions) => {
         title?: string;
         lineStart?: number;
         id?: string;
-    })[];
-    slots?: import("./types.ts").Slot[] | undefined;
-    knobs?: import("./types.ts").Knobs | undefined;
+    } | Record<string, unknown>)[];
+    inUseVersion?: number | undefined;
+    starred?: boolean | undefined;
+    forkedFrom?: import("./types.ts").ForkRef | undefined;
+    publishedWith?: Embed[] | undefined;
+    embeds?: (Embed & {
+        latest: number;
+        versions: number[];
+    })[] | undefined;
+    embedsKey?: string | undefined;
+    note?: string | undefined;
+    fills?: import("./fills.ts").SlotInfo[] | undefined;
+    knobs?: {
+        [x: string]: import("./types.ts").KnobConfig;
+    } | undefined;
     author?: string | undefined;
     prompt?: string | undefined;
     from?: number | undefined;
     postId: string;
     state: string | null;
     variant: string;
-    status: import("./types.ts").PostStatus;
+    status: import("./types.ts").VariantStatus;
     version: number;
     title: string;
     sessionId: string;
     createdAt: string;
     updatedAt: string;
 };
+export declare const inUseByState: (mock: Mock, posts: Post[]) => {
+    state: string | null;
+    variant: string;
+    version: number;
+}[];
 export interface StateParts {
     state: string | null;
     parts: PartInfo[];
 }
 export declare function partsByState(mock: Mock, posts: Post[]): StateParts[];
+export declare const placeOf: (mock: Pick<Mock, "area" | "source">) => {
+    area?: string;
+    source?: string;
+};
 export declare const mockSummaryView: (mock: Mock, posts: Post[]) => {
     sessionId: string | null;
+    closedAt: string | null;
     createdAt: string;
     updatedAt: string;
     thumbnail: {
+        poster?: string | undefined;
         postId: string;
         surface: number;
         version: number;
     } | null;
     drafted?: number | undefined;
+    stateCount: number;
+    variants: number;
+    open: number;
+    situations: Record<string, string[]>;
+    states: string[];
+    area?: string;
+    source?: string;
     id: string;
     project: string;
     slug: string;
     title: string;
     kind: import("./types.ts").MockKind;
-    states: string[];
+} | {
+    sessionId: string | null;
+    closedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    thumbnail: {
+        poster?: string | undefined;
+        postId: string;
+        surface: number;
+        version: number;
+    } | null;
+    drafted?: number | undefined;
     stateCount: number;
     variants: number;
     open: number;
+    situations?: undefined;
+    states: string[];
+    area?: string;
+    source?: string;
+    id: string;
+    project: string;
+    slug: string;
+    title: string;
+    kind: import("./types.ts").MockKind;
 };
 export declare const mockDetailView: (mock: Mock, posts: Post[], opts?: VariantViewOptions & {
-    tuned?: Record<string, unknown>;
+    settled?: Record<string, KnobValue>;
 }) => {
+    asks: import("./types.ts").Ask[];
+    open: number;
+    knobs: import("./types.ts").Knobs;
+    widths: number[];
+    sessionId: string | null;
+    closedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    variants: {
+        history?: ({
+            poster: string;
+            surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+            author?: string | undefined;
+            prompt?: string | undefined;
+            from?: number | undefined;
+            version: number;
+            title: string;
+            at: string;
+        } | {
+            poster?: undefined;
+            surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+            author?: string | undefined;
+            prompt?: string | undefined;
+            from?: number | undefined;
+            version: number;
+            title: string;
+            at: string;
+        } | {
+            hidden: true;
+            poster: string;
+            surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+            author?: string | undefined;
+            prompt?: string | undefined;
+            from?: number | undefined;
+            version: number;
+            title: string;
+            at: string;
+        } | {
+            hidden: true;
+            poster?: undefined;
+            surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+            author?: string | undefined;
+            prompt?: string | undefined;
+            from?: number | undefined;
+            version: number;
+            title: string;
+            at: string;
+        })[] | undefined;
+        parts: string[];
+        surfaces: ({
+            index: number;
+            kind: "html";
+            html: string;
+            kits?: string[];
+            poster?: string;
+            id?: string;
+        } | {
+            index: number;
+            kind: "diff";
+            patch?: string;
+            files?: import("./types.ts").DiffFile[];
+            layout?: "unified" | "split";
+            id?: string;
+        } | {
+            index: number;
+            kind: "image";
+            assetId: string;
+            alt?: string;
+            caption?: string;
+            id?: string;
+        } | {
+            index: number;
+            kind: "markdown";
+            markdown: string;
+            id?: string;
+        } | {
+            index: number;
+            kind: "terminal";
+            text: string;
+            cols?: number;
+            title?: string;
+            id?: string;
+        } | {
+            index: number;
+            kind: "mermaid";
+            mermaid: string;
+            id?: string;
+        } | {
+            index: number;
+            kind: "json";
+            data: unknown;
+            id?: string;
+        } | {
+            index: number;
+            kind: "code";
+            code: string;
+            language?: string;
+            title?: string;
+            lineStart?: number;
+            id?: string;
+        } | Record<string, unknown>)[];
+        inUseVersion?: number | undefined;
+        starred?: boolean | undefined;
+        forkedFrom?: import("./types.ts").ForkRef | undefined;
+        publishedWith?: Embed[] | undefined;
+        embeds?: (Embed & {
+            latest: number;
+            versions: number[];
+        })[] | undefined;
+        embedsKey?: string | undefined;
+        note?: string | undefined;
+        fills?: import("./fills.ts").SlotInfo[] | undefined;
+        knobs?: {
+            [x: string]: import("./types.ts").KnobConfig;
+        } | undefined;
+        author?: string | undefined;
+        prompt?: string | undefined;
+        from?: number | undefined;
+        postId: string;
+        state: string | null;
+        variant: string;
+        status: import("./types.ts").VariantStatus;
+        version: number;
+        title: string;
+        sessionId: string;
+        createdAt: string;
+        updatedAt: string;
+    }[];
+    inUse: {
+        state: string | null;
+        variant: string;
+        version: number;
+    }[];
+    parts: StateParts[];
+    settled: Record<string, KnobValue>;
+    situations: Record<string, string[]>;
+    states: string[];
+    area?: string;
+    source?: string;
     id: string;
     project: string;
     slug: string;
     title: string;
     kind: import("./types.ts").MockKind;
-    states: string[];
+} | {
     asks: import("./types.ts").Ask[];
     open: number;
     knobs: import("./types.ts").Knobs;
+    widths: number[];
     sessionId: string | null;
+    closedAt: string | null;
     createdAt: string;
     updatedAt: string;
     variants: {
-        history?: {
+        history?: ({
+            poster: string;
+            surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+            author?: string | undefined;
+            prompt?: string | undefined;
+            from?: number | undefined;
+            version: number;
+            title: string;
+            at: string;
+        } | {
+            poster?: undefined;
+            surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+            author?: string | undefined;
+            prompt?: string | undefined;
+            from?: number | undefined;
+            version: number;
+            title: string;
+            at: string;
+        } | {
+            hidden: true;
+            poster: string;
+            surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
+            author?: string | undefined;
+            prompt?: string | undefined;
+            from?: number | undefined;
+            version: number;
+            title: string;
+            at: string;
+        } | {
+            hidden: true;
+            poster?: undefined;
             surfaceKinds: ("html" | "diff" | "image" | "markdown" | "terminal" | "mermaid" | "json" | "code")[];
             author?: string | undefined;
             prompt?: string | undefined;
@@ -246,13 +518,14 @@ export declare const mockDetailView: (mock: Mock, posts: Post[], opts?: VariantV
             version: number;
             title: string;
             at: string;
-        }[] | undefined;
+        })[] | undefined;
         parts: string[];
-        surfaces: (Record<string, unknown> | {
+        surfaces: ({
             index: number;
             kind: "html";
             html: string;
             kits?: string[];
+            poster?: string;
             id?: string;
         } | {
             index: number;
@@ -298,24 +571,50 @@ export declare const mockDetailView: (mock: Mock, posts: Post[], opts?: VariantV
             title?: string;
             lineStart?: number;
             id?: string;
-        })[];
-        slots?: import("./types.ts").Slot[] | undefined;
-        knobs?: import("./types.ts").Knobs | undefined;
+        } | Record<string, unknown>)[];
+        inUseVersion?: number | undefined;
+        starred?: boolean | undefined;
+        forkedFrom?: import("./types.ts").ForkRef | undefined;
+        publishedWith?: Embed[] | undefined;
+        embeds?: (Embed & {
+            latest: number;
+            versions: number[];
+        })[] | undefined;
+        embedsKey?: string | undefined;
+        note?: string | undefined;
+        fills?: import("./fills.ts").SlotInfo[] | undefined;
+        knobs?: {
+            [x: string]: import("./types.ts").KnobConfig;
+        } | undefined;
         author?: string | undefined;
         prompt?: string | undefined;
         from?: number | undefined;
         postId: string;
         state: string | null;
         variant: string;
-        status: import("./types.ts").PostStatus;
+        status: import("./types.ts").VariantStatus;
         version: number;
         title: string;
         sessionId: string;
         createdAt: string;
         updatedAt: string;
     }[];
+    inUse: {
+        state: string | null;
+        variant: string;
+        version: number;
+    }[];
     parts: StateParts[];
-    tuned: Record<string, unknown>;
+    settled: Record<string, KnobValue>;
+    situations?: undefined;
+    states: string[];
+    area?: string;
+    source?: string;
+    id: string;
+    project: string;
+    slug: string;
+    title: string;
+    kind: import("./types.ts").MockKind;
 };
 export declare const sessionRowView: (session: Session, postCount: number) => {
     postCount: number;
@@ -330,3 +629,90 @@ export declare const sessionRowView: (session: Session, postCount: number) => {
     agentActiveAt: string | null;
     keyed: boolean;
 };
+export declare const treeNodeView: (mock: Mock, posts: Post[], extra: {
+    settled: Record<string, KnobValue>;
+    embeds: string[];
+    embedViews: Map<string, EmbedView>;
+}) => {
+    open: number;
+    states: string[] | null[];
+    widths: number[];
+    createdAt: string;
+    updatedAt: string;
+    closedAt: string | null;
+    settled: Record<string, KnobValue>;
+    embeds: string[];
+    embeddedIn: string[];
+    inUse: {
+        state: string | null;
+        variant: string;
+        version: number;
+    }[];
+    variants: ({
+        embedsKey?: string | undefined;
+        inUseVersion?: number | undefined;
+        starred?: boolean | undefined;
+        forkedFrom?: import("./types.ts").ForkRef | undefined;
+        note?: string | undefined;
+        inUsePoster?: undefined;
+        poster: string;
+        postId: string;
+        state: string | null;
+        variant: string;
+        status: import("./types.ts").VariantStatus;
+        version: number;
+        updatedAt: string;
+        surface: number;
+    } | {
+        embedsKey?: string | undefined;
+        inUseVersion?: number | undefined;
+        starred?: boolean | undefined;
+        forkedFrom?: import("./types.ts").ForkRef | undefined;
+        note?: string | undefined;
+        inUsePoster: string;
+        poster: string;
+        postId: string;
+        state: string | null;
+        variant: string;
+        status: import("./types.ts").VariantStatus;
+        version: number;
+        updatedAt: string;
+        surface: number;
+    } | {
+        embedsKey?: string | undefined;
+        inUseVersion?: number | undefined;
+        starred?: boolean | undefined;
+        forkedFrom?: import("./types.ts").ForkRef | undefined;
+        note?: string | undefined;
+        inUsePoster?: undefined;
+        poster?: undefined;
+        postId: string;
+        state: string | null;
+        variant: string;
+        status: import("./types.ts").VariantStatus;
+        version: number;
+        updatedAt: string;
+        surface: number;
+    } | {
+        embedsKey?: string | undefined;
+        inUseVersion?: number | undefined;
+        starred?: boolean | undefined;
+        forkedFrom?: import("./types.ts").ForkRef | undefined;
+        note?: string | undefined;
+        inUsePoster: string;
+        poster?: undefined;
+        postId: string;
+        state: string | null;
+        variant: string;
+        status: import("./types.ts").VariantStatus;
+        version: number;
+        updatedAt: string;
+        surface: number;
+    })[];
+    area?: string;
+    source?: string;
+    id: string;
+    slug: string;
+    title: string;
+    kind: import("./types.ts").MockKind;
+};