@nodetool-ai/websocket 0.7.0-rc.22 → 0.8.1

package/dist/trpc/routers/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../../src/trpc/routers/scripts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuDxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkGxB,CAAC"}

package/dist/trpc/routers/scripts.js

@@ -0,0 +1,131 @@
+/**
+ * Scripts router — tRPC.
+ *
+ * A script is a first-class resource whose text owns its derived audio takes.
+ * Mirrors the storyboards router shape.
+ *
+ * Procedures:
+ *   list    (query)    — ScriptListItem[]
+ *   get     (query)    — ScriptResponse
+ *   create  (mutation) — ScriptResponse
+ *   update  (mutation) — ScriptResponse (CAS via baseUpdatedAt)
+ *   delete  (mutation) — { ok: true }
+ */
+import { z } from "zod";
+import { Project, Script, countScriptLines, emptyScriptDocument } from "@nodetool-ai/models";
+import { createScriptInput, patchScriptInput, scriptListItem, scriptResponse } from "@nodetool-ai/protocol/api-schemas/scripts.js";
+import { ApiErrorCode } from "../../error-codes.js";
+import { router } from "../index.js";
+import { protectedProcedure } from "../middleware.js";
+import { throwApiError } from "../error-formatter.js";
+const listInput = z.object({
+    projectId: z.string().optional()
+});
+const idInput = z.object({ id: z.string() });
+const updateInput = patchScriptInput.and(z.object({
+    id: z.string(),
+    baseUpdatedAt: z.string().optional()
+}));
+const okOutput = z.object({ ok: z.literal(true) });
+function toListItem(script) {
+    return {
+        id: script.id,
+        projectId: script.project_id,
+        name: script.name,
+        lineCount: countScriptLines(script.toDocument()),
+        updatedAt: script.updated_at
+    };
+}
+async function loadOwned(ctxUserId, id) {
+    if (!ctxUserId)
+        throwApiError(ApiErrorCode.UNAUTHORIZED, "Unauthorized");
+    const script = await Script.findById(id);
+    if (!script || script.user_id !== ctxUserId) {
+        throwApiError(ApiErrorCode.NOT_FOUND, "Script not found");
+    }
+    return script;
+}
+export const scriptsRouter = router({
+    list: protectedProcedure
+        .input(listInput)
+        .output(z.array(scriptListItem))
+        .query(async ({ ctx, input }) => {
+        const items = input.projectId
+            ? await Script.listByProject(input.projectId, ctx.userId)
+            : await Script.listByUser(ctx.userId);
+        return items.map(toListItem);
+    }),
+    get: protectedProcedure
+        .input(idInput)
+        .output(scriptResponse)
+        .query(async ({ ctx, input }) => {
+        const script = await loadOwned(ctx.userId, input.id);
+        return scriptResponse.parse(script.toResponse());
+    }),
+    create: protectedProcedure
+        .input(createScriptInput)
+        .output(scriptResponse)
+        .mutation(async ({ ctx, input }) => {
+        const personal = await Project.migrateToPersonal(ctx.userId);
+        const projectId = !input.projectId || input.projectId === "default"
+            ? personal.project.id
+            : input.projectId;
+        if (projectId !== personal.project.id) {
+            const project = await Project.findOwned(ctx.userId, projectId);
+            if (!project)
+                throwApiError(ApiErrorCode.NOT_FOUND, "Project not found");
+        }
+        if (input.id) {
+            const existing = await Script.findById(input.id);
+            if (existing) {
+                if (existing.user_id !== ctx.userId) {
+                    throwApiError(ApiErrorCode.NOT_FOUND, "Script not found");
+                }
+                return scriptResponse.parse(existing.toResponse());
+            }
+        }
+        const script = new Script({
+            id: input.id,
+            user_id: ctx.userId,
+            project_id: projectId,
+            name: input.name,
+            document: JSON.stringify(input.document ?? emptyScriptDocument())
+        });
+        await script.save();
+        return scriptResponse.parse(script.toResponse());
+    }),
+    update: protectedProcedure
+        .input(updateInput)
+        .output(scriptResponse)
+        .mutation(async ({ ctx, input }) => {
+        const script = await loadOwned(ctx.userId, input.id);
+        // CAS on updated_at so the conflict check and the write are atomic.
+        const expectedUpdatedAt = input.baseUpdatedAt ?? script.updated_at;
+        if (input.baseUpdatedAt && script.updated_at !== input.baseUpdatedAt) {
+            throwApiError(ApiErrorCode.ALREADY_EXISTS, "Script was modified since last read (optimistic concurrency conflict)");
+        }
+        const fields = {};
+        if (input.name !== undefined)
+            fields.name = input.name;
+        if (input.document !== undefined)
+            fields.document = JSON.stringify(input.document);
+        if (input.timelineId !== undefined)
+            fields.timeline_id = input.timelineId;
+        if (input.storyboardId !== undefined)
+            fields.storyboard_id = input.storyboardId;
+        const updated = await Script.updateFieldsIfUnchanged(input.id, expectedUpdatedAt, fields);
+        if (!updated) {
+            throwApiError(ApiErrorCode.ALREADY_EXISTS, "Script was modified since last read (optimistic concurrency conflict)");
+        }
+        return scriptResponse.parse(updated.toResponse());
+    }),
+    delete: protectedProcedure
+        .input(idInput)
+        .output(okOutput)
+        .mutation(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        await Script.deleteOwned(ctx.userId, input.id);
+        return { ok: true };
+    })
+});
+//# sourceMappingURL=scripts.js.map

package/dist/trpc/routers/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../../src/trpc/routers/scripts.ts"],"names":[],"mappings":"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"}

package/dist/trpc/routers/segmentation.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Segmentation router — tRPC.
+ *
+ * One direct call to `BaseProvider.segmentImage`. The sketch editor's Segment
+ * tool needs one image in and a mask list out, so it goes straight at the
+ * provider method instead of authoring a one-node graph and waiting on a job:
+ * no workflow row, no runner, no message stream to decode.
+ *
+ * Procedures:
+ *   segment (mutation) — SegmentImageResponse
+ */
+/** Test seam: the cap is process-wide state that survives between cases. */
+export declare function resetSegmentationInFlight(): void;
+export declare const segmentationRouter: import("@trpc/server").TRPCBuiltRouter<{
+    ctx: import("../context.js").Context;
+    meta: object;
+    errorShape: import("../error-formatter.js").ApiErrorShape;
+    transformer: false;
+}, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+    segment: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            image: string;
+            imageMimeType?: string | undefined;
+            provider: string;
+            model: string;
+            prompt?: string | null | undefined;
+            points?: {
+                x: number;
+                y: number;
+                include: boolean;
+            }[] | null | undefined;
+            box?: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            } | null | undefined;
+            maxMasks?: number | null | undefined;
+            minConfidence?: number | null | undefined;
+        };
+        output: {
+            masks: {
+                data: string;
+                mimeType: string;
+                width: number | null;
+                height: number | null;
+                label: string | null;
+                confidence: number | null;
+                box: {
+                    x: number;
+                    y: number;
+                    width: number;
+                    height: number;
+                } | null;
+            }[];
+            provider: string;
+            model: string;
+        };
+        meta: object;
+    }>;
+}>>;
+//# sourceMappingURL=segmentation.d.ts.map

package/dist/trpc/routers/segmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmentation.d.ts","sourceRoot":"","sources":["../../../src/trpc/routers/segmentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA6CH,4EAA4E;AAC5E,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyG7B,CAAC"}

package/dist/trpc/routers/segmentation.js

@@ -0,0 +1,146 @@
+/**
+ * Segmentation router — tRPC.
+ *
+ * One direct call to `BaseProvider.segmentImage`. The sketch editor's Segment
+ * tool needs one image in and a mask list out, so it goes straight at the
+ * provider method instead of authoring a one-node graph and waiting on a job:
+ * no workflow row, no runner, no message stream to decode.
+ *
+ * Procedures:
+ *   segment (mutation) — SegmentImageResponse
+ */
+import { randomUUID } from "node:crypto";
+import { attachRunCostLedger } from "@nodetool-ai/execution";
+import { ProcessingContext } from "@nodetool-ai/runtime";
+import { createLogger } from "@nodetool-ai/config";
+import { TRPCError } from "@trpc/server";
+import { getProvider, isProviderConfigured } from "@nodetool-ai/runtime";
+import { getSecret as getStoredSecret } from "@nodetool-ai/models";
+import { segmentImageRequest, segmentImageResponse } from "@nodetool-ai/protocol/api-schemas/segmentation.js";
+import { router } from "../index.js";
+import { protectedProcedure } from "../middleware.js";
+const log = createLogger("nodetool.websocket.trpc.segmentation");
+/**
+ * Concurrent segmentations per user. Each holds a provider connection for the
+ * length of one inference, so a click-happy canvas cannot occupy the provider.
+ */
+const MAX_IN_FLIGHT_PER_USER = 3;
+const inFlightByUser = new Map();
+function acquireSlot(userId) {
+    const running = inFlightByUser.get(userId) ?? 0;
+    if (running >= MAX_IN_FLIGHT_PER_USER)
+        return false;
+    inFlightByUser.set(userId, running + 1);
+    return true;
+}
+function releaseSlot(userId) {
+    const running = inFlightByUser.get(userId) ?? 0;
+    if (running <= 1)
+        inFlightByUser.delete(userId);
+    else
+        inFlightByUser.set(userId, running - 1);
+}
+/** Test seam: the cap is process-wide state that survives between cases. */
+export function resetSegmentationInFlight() {
+    inFlightByUser.clear();
+}
+export const segmentationRouter = router({
+    segment: protectedProcedure
+        .input(segmentImageRequest)
+        .output(segmentImageResponse)
+        .mutation(async ({ ctx, input, signal }) => {
+        if (!acquireSlot(ctx.userId)) {
+            throw new TRPCError({
+                code: "TOO_MANY_REQUESTS",
+                message: `Another segmentation is already running (limit ${MAX_IN_FLIGHT_PER_USER}). Wait for it to finish.`
+            });
+        }
+        const startedAt = Date.now();
+        const getSecret = (key) => getStoredSecret(key, ctx.userId).then((value) => value ?? undefined);
+        try {
+            if (!(await isProviderConfigured(input.provider, getSecret))) {
+                throw new TRPCError({
+                    code: "PRECONDITION_FAILED",
+                    message: `Provider "${input.provider}" is not configured. Add its API key in Settings.`
+                });
+            }
+            const provider = await getProvider(input.provider, getSecret);
+            // Through the generation seam: a segmentation is a billed call, so
+            // it is a ledger row like any other generation
+            // (docs/media-generation-tracking-design.md § 8).
+            const generationContext = new ProcessingContext({
+                jobId: randomUUID(),
+                userId: ctx.userId
+            });
+            generationContext.registerProvider(input.provider, provider);
+            const ledger = attachRunCostLedger(generationContext, {
+                userId: ctx.userId,
+                workflowId: null
+            });
+            const image = Buffer.from(input.image, "base64");
+            const { output: masks } = await generationContext.runGenerationWith({
+                provider: input.provider,
+                capability: "segment_image",
+                model: input.model,
+                params: {
+                    image,
+                    prompt: input.prompt ?? null,
+                    points: input.points ?? null,
+                    box: input.box ?? null,
+                    max_masks: input.maxMasks ?? null,
+                    min_confidence: input.minConfidence ?? null
+                },
+                origin: { surface: "rpc" },
+                signal: signal ?? undefined
+            }, (_provider, abort) => provider.segmentImage(image, {
+                model: {
+                    id: input.model,
+                    name: input.model,
+                    provider: input.provider
+                },
+                prompt: input.prompt ?? null,
+                points: input.points ?? null,
+                box: input.box ?? null,
+                maxMasks: input.maxMasks ?? null,
+                minConfidence: input.minConfidence ?? null,
+                signal: abort
+            }));
+            await ledger.settled();
+            log.info("segmentation finished", {
+                provider: input.provider,
+                model: input.model,
+                maskCount: masks.length,
+                durationMs: Date.now() - startedAt
+            });
+            return {
+                provider: input.provider,
+                model: input.model,
+                masks: masks.map((mask) => ({
+                    data: Buffer.from(mask.mask).toString("base64"),
+                    mimeType: mask.mimeType,
+                    width: mask.width ?? null,
+                    height: mask.height ?? null,
+                    label: mask.label ?? null,
+                    confidence: mask.confidence ?? null,
+                    box: mask.box ?? null
+                }))
+            };
+        }
+        catch (error) {
+            if (error instanceof TRPCError)
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            log.warn("segmentation failed", {
+                provider: input.provider,
+                model: input.model,
+                durationMs: Date.now() - startedAt,
+                message
+            });
+            throw new TRPCError({ code: "BAD_REQUEST", message });
+        }
+        finally {
+            releaseSlot(ctx.userId);
+        }
+    })
+});
+//# sourceMappingURL=segmentation.js.map

package/dist/trpc/routers/segmentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmentation.js","sourceRoot":"","sources":["../../../src/trpc/routers/segmentation.ts"],"names":[],"mappings":"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"}

package/dist/trpc/routers/settings.d.ts

@@ -4,14 +4,14 @@
  * - `settings.list` / `settings.update` replace GET/PUT /api/settings.
  * - `settings.secrets.list|get|upsert|delete` replace /api/settings/secrets[/:key].
  *
- * Relies on the registry in `../../settings-registry.ts` (side-effect import
- * populates the registry at module load time).
+ * The setting definitions come from `settingCatalog()` in `@nodetool-ai/config`,
+ * which its own module load populates; values come from the database.
  */
 export declare const settingsRouter: import("@trpc/server").TRPCBuiltRouter<{
     ctx: import("../context.js").Context;
     meta: object;
     errorShape: import("../error-formatter.js").ApiErrorShape;
-    transformer: true;
+    transformer: false;
 }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
     list: import("@trpc/server").TRPCQueryProcedure<{
         input: void;
@@ -42,19 +42,19 @@ export declare const settingsRouter: import("@trpc/server").TRPCBuiltRouter<{
         ctx: import("../context.js").Context;
         meta: object;
         errorShape: import("../error-formatter.js").ApiErrorShape;
-        transformer: true;
+        transformer: false;
     }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
         list: import("@trpc/server").TRPCQueryProcedure<{
             input: void;
             output: {
                 secrets: {
-                    key: string;
-                    is_configured: boolean;
                     id?: string | undefined;
                     user_id?: string | undefined;
+                    key: string;
                     description?: string | undefined;
                     created_at?: string | undefined;
                     updated_at?: string | undefined;
+                    is_configured: boolean;
                     is_unreadable?: boolean | undefined;
                     value?: string | undefined;
                 }[];
@@ -68,13 +68,13 @@ export declare const settingsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 decrypt?: boolean | undefined;
             };
             output: {
-                key: string;
-                is_configured: boolean;
                 id?: string | undefined;
                 user_id?: string | undefined;
+                key: string;
                 description?: string | undefined;
                 created_at?: string | undefined;
                 updated_at?: string | undefined;
+                is_configured: boolean;
                 is_unreadable?: boolean | undefined;
                 value?: string | undefined;
             };
@@ -87,13 +87,13 @@ export declare const settingsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 description?: string | undefined;
             };
             output: {
-                key: string;
-                is_configured: boolean;
                 id?: string | undefined;
                 user_id?: string | undefined;
+                key: string;
                 description?: string | undefined;
                 created_at?: string | undefined;
                 updated_at?: string | undefined;
+                is_configured: boolean;
                 is_unreadable?: boolean | undefined;
                 value?: string | undefined;
             };
@@ -108,6 +108,173 @@ export declare const settingsRouter: import("@trpc/server").TRPCBuiltRouter<{
             };
             meta: object;
         }>;
+        /**
+         * Spend one small request against the provider to find out whether a
+         * credential works. With no `value`, the stored key (or the process env
+         * fallback the runtime would use) is checked instead — that's the "Test
+         * connection" case. Never throws on a bad key: an unusable credential is a
+         * result, not a server error.
+         */
+        validate: import("@trpc/server").TRPCMutationProcedure<{
+            input: {
+                key: string;
+                value?: string | undefined;
+            };
+            output: {
+                status: "invalid" | "unverifiable" | "valid";
+                valid: boolean;
+                message: string;
+            };
+            meta: object;
+        }>;
+    }>>;
+    history: import("@trpc/server").TRPCBuiltRouter<{
+        ctx: import("../context.js").Context;
+        meta: object;
+        errorShape: import("../error-formatter.js").ApiErrorShape;
+        transformer: false;
+    }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+        get: import("@trpc/server").TRPCQueryProcedure<{
+            input: void;
+            output: {
+                policy: {
+                    maxAutosavesPerWorkflow: number;
+                    autosaveRetentionDays: number;
+                    manualVersionRetentionDays: number;
+                    terminalJobRetentionDays: number;
+                    runEventRetentionDays?: number | undefined;
+                    predictionRetentionDays?: number | undefined;
+                    automaticCleanup: boolean;
+                };
+                status: {
+                    dialect: "postgres" | "sqlite";
+                    databaseBytes: number | null;
+                    unusedBytes: number | null;
+                    workflowVersions: number;
+                    autosaves: number;
+                    manualVersions: number;
+                    jobs: number;
+                    terminalJobs: number;
+                    runEvents: number;
+                    predictionsWithPayload: number;
+                    cleanup: {
+                        autosaves: number;
+                        manualVersions: number;
+                        terminalJobs: number;
+                        runEvents: number;
+                        redactedPredictions: number;
+                        total: number;
+                    };
+                };
+                lastCleanupAt: string | null;
+            };
+            meta: object;
+        }>;
+        update: import("@trpc/server").TRPCMutationProcedure<{
+            input: {
+                maxAutosavesPerWorkflow: number;
+                autosaveRetentionDays: number;
+                manualVersionRetentionDays: number;
+                terminalJobRetentionDays: number;
+                runEventRetentionDays?: number | undefined;
+                predictionRetentionDays?: number | undefined;
+                automaticCleanup: boolean;
+            };
+            output: {
+                policy: {
+                    maxAutosavesPerWorkflow: number;
+                    autosaveRetentionDays: number;
+                    manualVersionRetentionDays: number;
+                    terminalJobRetentionDays: number;
+                    runEventRetentionDays?: number | undefined;
+                    predictionRetentionDays?: number | undefined;
+                    automaticCleanup: boolean;
+                };
+                status: {
+                    dialect: "postgres" | "sqlite";
+                    databaseBytes: number | null;
+                    unusedBytes: number | null;
+                    workflowVersions: number;
+                    autosaves: number;
+                    manualVersions: number;
+                    jobs: number;
+                    terminalJobs: number;
+                    runEvents: number;
+                    predictionsWithPayload: number;
+                    cleanup: {
+                        autosaves: number;
+                        manualVersions: number;
+                        terminalJobs: number;
+                        runEvents: number;
+                        redactedPredictions: number;
+                        total: number;
+                    };
+                };
+                lastCleanupAt: string | null;
+            };
+            meta: object;
+        }>;
+        cleanup: import("@trpc/server").TRPCMutationProcedure<{
+            input: void;
+            output: {
+                deleted: {
+                    autosaves: number;
+                    manualVersions: number;
+                    terminalJobs: number;
+                    runEvents: number;
+                    redactedPredictions: number;
+                    total: number;
+                    completedAt: string;
+                };
+                status: {
+                    dialect: "postgres" | "sqlite";
+                    databaseBytes: number | null;
+                    unusedBytes: number | null;
+                    workflowVersions: number;
+                    autosaves: number;
+                    manualVersions: number;
+                    jobs: number;
+                    terminalJobs: number;
+                    runEvents: number;
+                    predictionsWithPayload: number;
+                    cleanup: {
+                        autosaves: number;
+                        manualVersions: number;
+                        terminalJobs: number;
+                        runEvents: number;
+                        redactedPredictions: number;
+                        total: number;
+                    };
+                };
+            };
+            meta: object;
+        }>;
+        compact: import("@trpc/server").TRPCMutationProcedure<{
+            input: void;
+            output: {
+                status: {
+                    dialect: "postgres" | "sqlite";
+                    databaseBytes: number | null;
+                    unusedBytes: number | null;
+                    workflowVersions: number;
+                    autosaves: number;
+                    manualVersions: number;
+                    jobs: number;
+                    terminalJobs: number;
+                    runEvents: number;
+                    predictionsWithPayload: number;
+                    cleanup: {
+                        autosaves: number;
+                        manualVersions: number;
+                        terminalJobs: number;
+                        runEvents: number;
+                        redactedPredictions: number;
+                        total: number;
+                    };
+                };
+            };
+            meta: object;
+        }>;
     }>>;
 }>>;
 //# sourceMappingURL=settings.d.ts.map

package/dist/trpc/routers/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/trpc/routers/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwIH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FzB,CAAC"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../../src/trpc/routers/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4PH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA/FzB;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+KH,CAAC"}