mockpit 1.3.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
@@ -157,6 +177,7 @@ const handlers = {
             html,
             parts: readPartFiles(args.parts),
             fills: readPartFiles(args.fills),
+            poster: await posterId(args.poster, session),
             session,
             agent: AGENT,
             project: resolveProject(args.project),
@@ -195,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

@@ -10,6 +10,7 @@ export declare const fullSurfaceView: (surface: Surface, index: number) => {
     kind: "html";
     html: string;
     kits?: string[];
+    poster?: string;
     id?: string;
 } | {
     index: number;
@@ -61,6 +62,7 @@ export declare const hydratedSurfaceView: (surface: Surface, index: number) => {
     kind: "html";
     html: string;
     kits?: string[];
+    poster?: string;
     id?: string;
 } | {
     index: number;
@@ -108,6 +110,16 @@ export declare const hydratedSurfaceView: (surface: Surface, index: 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;
@@ -130,6 +142,16 @@ export interface EmbedView {
 }
 export declare const variantView: (post: Post, opts?: VariantViewOptions) => {
     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;
@@ -139,6 +161,17 @@ export declare const variantView: (post: Post, opts?: VariantViewOptions) => {
         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;
@@ -153,6 +186,7 @@ export declare const variantView: (post: Post, opts?: VariantViewOptions) => {
         kind: "html";
         html: string;
         kits?: string[];
+        poster?: string;
         id?: string;
     } | {
         index: number;
@@ -199,7 +233,7 @@ export declare const variantView: (post: Post, opts?: VariantViewOptions) => {
         lineStart?: number;
         id?: string;
     } | Record<string, unknown>)[];
-    acceptedVersion?: number | undefined;
+    inUseVersion?: number | undefined;
     starred?: boolean | undefined;
     forkedFrom?: import("./types.ts").ForkRef | undefined;
     publishedWith?: Embed[] | undefined;
@@ -209,7 +243,7 @@ export declare const variantView: (post: Post, opts?: VariantViewOptions) => {
     })[] | undefined;
     embedsKey?: string | undefined;
     note?: string | undefined;
-    slots?: import("./fills.ts").SlotInfo[] | undefined;
+    fills?: import("./fills.ts").SlotInfo[] | undefined;
     knobs?: {
         [x: string]: import("./types.ts").KnobConfig;
     } | undefined;
@@ -219,7 +253,7 @@ export declare const variantView: (post: Post, opts?: VariantViewOptions) => {
     postId: string;
     state: string | null;
     variant: string;
-    status: import("./types.ts").PostStatus;
+    status: import("./types.ts").VariantStatus;
     version: number;
     title: string;
     sessionId: string;
@@ -236,46 +270,227 @@ export interface StateParts {
     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;
-    resolvedAt: 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 & {
     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;
-    resolvedAt: 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;
@@ -285,6 +500,17 @@ export declare const mockDetailView: (mock: Mock, posts: Post[], opts?: VariantV
             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;
@@ -299,6 +525,7 @@ export declare const mockDetailView: (mock: Mock, posts: Post[], opts?: VariantV
             kind: "html";
             html: string;
             kits?: string[];
+            poster?: string;
             id?: string;
         } | {
             index: number;
@@ -345,7 +572,7 @@ export declare const mockDetailView: (mock: Mock, posts: Post[], opts?: VariantV
             lineStart?: number;
             id?: string;
         } | Record<string, unknown>)[];
-        acceptedVersion?: number | undefined;
+        inUseVersion?: number | undefined;
         starred?: boolean | undefined;
         forkedFrom?: import("./types.ts").ForkRef | undefined;
         publishedWith?: Embed[] | undefined;
@@ -355,7 +582,7 @@ export declare const mockDetailView: (mock: Mock, posts: Post[], opts?: VariantV
         })[] | undefined;
         embedsKey?: string | undefined;
         note?: string | undefined;
-        slots?: import("./fills.ts").SlotInfo[] | undefined;
+        fills?: import("./fills.ts").SlotInfo[] | undefined;
         knobs?: {
             [x: string]: import("./types.ts").KnobConfig;
         } | undefined;
@@ -365,7 +592,7 @@ export declare const mockDetailView: (mock: Mock, posts: Post[], opts?: VariantV
         postId: string;
         state: string | null;
         variant: string;
-        status: import("./types.ts").PostStatus;
+        status: import("./types.ts").VariantStatus;
         version: number;
         title: string;
         sessionId: string;
@@ -379,6 +606,15 @@ export declare const mockDetailView: (mock: Mock, posts: Post[], opts?: VariantV
     }[];
     parts: StateParts[];
     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;
@@ -395,39 +631,88 @@ export declare const sessionRowView: (session: Session, postCount: number) => {
 };
 export declare const treeNodeView: (mock: Mock, posts: Post[], extra: {
     settled: Record<string, KnobValue>;
-    uses: string[];
-    embeds: Map<string, EmbedView>;
+    embeds: string[];
+    embedViews: Map<string, EmbedView>;
 }) => {
-    id: string;
-    slug: string;
-    title: string;
-    kind: import("./types.ts").MockKind;
     open: number;
     states: string[] | null[];
     widths: number[];
     createdAt: string;
     updatedAt: string;
-    resolvedAt: string | null;
+    closedAt: string | null;
     settled: Record<string, KnobValue>;
-    uses: string[];
-    usedIn: string[];
+    embeds: string[];
+    embeddedIn: string[];
     inUse: {
         state: string | null;
         variant: string;
         version: number;
     }[];
-    variants: {
+    variants: ({
         embedsKey?: string | undefined;
-        acceptedVersion?: number | 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").PostStatus;
+        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;
 };