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

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

@@ -0,0 +1 @@
+{"version":3,"file":"applications.d.ts","sourceRoot":"","sources":["../../../src/trpc/routers/applications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAwDH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiE7B;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4DH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;IAuBH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCH,CAAC"}

package/dist/trpc/routers/applications.js

@@ -0,0 +1,218 @@
+/**
+ * Applications router — tRPC.
+ *
+ * An application is a mini app's own record: a UI document plus typed bindings
+ * to workflow operations, resources, and variables. Legacy apps live on
+ * `workflow.app_doc`; `create({ fromWorkflowId })` imports one, binding the
+ * host workflow as the app's first operation.
+ *
+ * Procedures:
+ *   list     (query)    — ApplicationListItem[]
+ *   get      (query)    — ApplicationResponse
+ *   create   (mutation) — ApplicationResponse
+ *   update   (mutation) — ApplicationResponse (CAS via baseUpdatedAt)
+ *   delete   (mutation) — { ok: true }
+ *   publish  (mutation) — ApplicationVersionResponse
+ *   versions (query)    — ApplicationVersionResponse[]
+ *   release  (mutation) — ApplicationVersionResponse (publish or rollback)
+ *   released (query)    — ApplicationVersionResponse | null
+ *   releasedDocument (query) — ApplicationReleaseResponse | null
+ *                              (the snapshot plus the graphs it is pinned to)
+ *
+ * Public deployment, for an app shared by URL rather than by account:
+ *   deployment/deploy/undeploy — the hidden link the release is served from
+ *
+ * Spend governance, for apps published to people other than their author:
+ *   budget/setBudget       — the app-scoped ceiling
+ *   usage                  — spend in the budget's current window
+ *   beginInvocation        — check the budget, then record the run
+ *   settleInvocation       — close the run out at its actual cost
+ *   invocations            — the release telemetry ledger
+ */
+import { z } from "zod";
+import { ApplicationDeployment, applicationUsage, getApplicationBudget, listApplicationVersions, listInvocations, publishApplication, reserveInvocation, applicationReleaseVersion, releaseApplicationVersion, releasedApplicationVersion, setApplicationBudget, settleInvocation } from "@nodetool-ai/models";
+import { applicationBudget, applicationDeployment, applicationListItem, applicationReleaseResponse, applicationResponse, applicationUsage as applicationUsageSchema, applicationVersionResponse, beginInvocationInput, createApplicationInput, invocationRecord, setApplicationBudgetInput, settleInvocationInput } from "@nodetool-ai/protocol/api-schemas/applications.js";
+import { ApiErrorCode } from "../../error-codes.js";
+import { router } from "../index.js";
+import { protectedProcedure } from "../middleware.js";
+import { throwApiError } from "../error-formatter.js";
+import { applicationIdInput as idInput, createApplication, deleteApplication, getApplication, listApplications, listApplicationsInput as listInput, loadOwnedApplication as loadOwned, releasedApplicationDocument, updateApplication, updateApplicationInput as updateInput } from "../../lib/applications-service.js";
+import { deployApplication, getApplicationDeployment, publicReleasePreflight, undeployApplication } from "../../lib/app-deployment-service.js";
+const okOutput = z.object({ ok: z.literal(true) });
+export const applicationsRouter = router({
+    list: protectedProcedure
+        .input(listInput)
+        .output(z.array(applicationListItem))
+        .query(({ ctx, input }) => listApplications(ctx.userId, input.projectId)),
+    get: protectedProcedure
+        .input(idInput)
+        .output(applicationResponse)
+        .query(({ ctx, input }) => getApplication(ctx.userId, input.id)),
+    create: protectedProcedure
+        .input(createApplicationInput)
+        .output(applicationResponse)
+        .mutation(({ ctx, input }) => createApplication(ctx.userId, input)),
+    update: protectedProcedure
+        .input(updateInput)
+        .output(applicationResponse)
+        .mutation(({ ctx, input }) => updateApplication(ctx.userId, input)),
+    delete: protectedProcedure
+        .input(idInput)
+        .output(okOutput)
+        .mutation(({ ctx, input }) => deleteApplication(ctx.userId, input.id)),
+    publish: protectedProcedure
+        .input(idInput)
+        .output(applicationVersionResponse)
+        .mutation(async ({ ctx, input }) => {
+        const app = await loadOwned(ctx.userId, input.id);
+        // A live public link follows the current release. Validate the exact
+        // draft before promotion so a publish cannot replace a working link
+        // with a release the public session cannot execute.
+        if (await ApplicationDeployment.findLive(app.id)) {
+            const blocked = await publicReleasePreflight(app.id, {
+                document: app.toDocument()
+            });
+            if (blocked)
+                throwApiError(ApiErrorCode.INVALID_INPUT, blocked);
+        }
+        return applicationVersionResponse.parse(await publishApplication(app));
+    }),
+    versions: protectedProcedure
+        .input(idInput)
+        .output(z.array(applicationVersionResponse))
+        .query(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        const versions = await listApplicationVersions(input.id, undefined, ctx.userId);
+        return versions.map((v) => applicationVersionResponse.parse(v));
+    }),
+    released: protectedProcedure
+        .input(idInput)
+        .output(applicationVersionResponse.nullable())
+        .query(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        const version = await releasedApplicationVersion(input.id, ctx.userId);
+        return version ? applicationVersionResponse.parse(version) : null;
+    }),
+    /**
+     * What a published app should run: the released snapshot's document, its
+     * version number and capabilities, plus the graph each operation is pinned
+     * to. A client that runs these graphs runs the release; a client that runs
+     * the app's `document` runs the draft.
+     */
+    releasedDocument: protectedProcedure
+        .input(idInput)
+        .output(applicationReleaseResponse.nullable())
+        .query(({ ctx, input }) => releasedApplicationDocument(ctx.userId, input.id)),
+    /**
+     * The app's hidden-URL deployment, or null when it has none. Only the owner
+     * ever sees the token; the visitor presents it, and gets back the release.
+     * Production-only, so a local editor asking this gets a refusal rather than
+     * a link that stops working when it matters.
+     */
+    deployment: protectedProcedure
+        .input(idInput)
+        .output(applicationDeployment.nullable())
+        .query(({ ctx, input }) => getApplicationDeployment(ctx.userId, input.id)),
+    deploy: protectedProcedure
+        .input(idInput)
+        .output(applicationDeployment)
+        .mutation(({ ctx, input }) => deployApplication(ctx.userId, input.id)),
+    undeploy: protectedProcedure
+        .input(idInput)
+        .output(okOutput)
+        .mutation(({ ctx, input }) => undeployApplication(ctx.userId, input.id)),
+    budget: protectedProcedure
+        .input(idInput)
+        .output(applicationBudget.nullable())
+        .query(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        const budget = await getApplicationBudget(input.id);
+        return budget ? applicationBudget.parse(budget) : null;
+    }),
+    setBudget: protectedProcedure
+        .input(setApplicationBudgetInput)
+        .output(applicationBudget)
+        .mutation(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        const saved = await setApplicationBudget(input.id, {
+            period: input.period,
+            maxUsd: input.maxUsd,
+            maxInvocations: input.maxInvocations
+        });
+        return applicationBudget.parse(saved);
+    }),
+    usage: protectedProcedure
+        .input(idInput)
+        .output(applicationUsageSchema)
+        .query(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        const budget = await getApplicationBudget(input.id);
+        return applicationUsageSchema.parse(await applicationUsage(input.id, budget?.period ?? "total"));
+    }),
+    invocations: protectedProcedure
+        .input(idInput)
+        .output(z.array(invocationRecord))
+        .query(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        const records = await listInvocations(input.id, undefined, ctx.userId);
+        return records.map((r) => invocationRecord.parse(r));
+    }),
+    /**
+     * Reserve budget for a run. Call this before creating the job: an
+     * over-budget run must fail with a typed error rather than reach a provider.
+     */
+    beginInvocation: protectedProcedure
+        .input(beginInvocationInput)
+        .output(invocationRecord)
+        .mutation(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        const release = await releasedApplicationVersion(input.id, ctx.userId);
+        // One transaction checks the budget and claims the run against it;
+        // checking and then recording lets concurrent callers all read a total
+        // that excludes each other and all be admitted.
+        const decision = await reserveInvocation({
+            applicationId: input.id,
+            version: release?.version ?? null,
+            invocationId: input.invocationId,
+            operationId: input.operationId,
+            estimatedUsd: input.estimatedUsd
+        });
+        if (!decision.allowed) {
+            throwApiError(ApiErrorCode.BUDGET_EXCEEDED, decision.reason);
+        }
+        return invocationRecord.parse(decision.record);
+    }),
+    /**
+     * Close a run out with what it actually cost. `loadOwned` authorizes the
+     * application, and the settle itself is scoped to that application, so an
+     * invocation id belonging to someone else's app settles nothing.
+     */
+    settleInvocation: protectedProcedure
+        .input(settleInvocationInput)
+        .output(invocationRecord.nullable())
+        .mutation(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        const settled = await settleInvocation(input.id, input.invocationId, input.actualUsd, input.status);
+        return settled ? invocationRecord.parse(settled) : null;
+    }),
+    release: protectedProcedure
+        .input(z.object({ id: z.string(), version: z.number() }))
+        .output(applicationVersionResponse)
+        .mutation(async ({ ctx, input }) => {
+        await loadOwned(ctx.userId, input.id);
+        if (await ApplicationDeployment.findLive(input.id)) {
+            const candidate = await applicationReleaseVersion(input.id, input.version, ctx.userId);
+            if (candidate) {
+                const blocked = await publicReleasePreflight(input.id, candidate);
+                if (blocked)
+                    throwApiError(ApiErrorCode.INVALID_INPUT, blocked);
+            }
+        }
+        const released = await releaseApplicationVersion(input.id, input.version, ctx.userId);
+        if (!released) {
+            throwApiError(ApiErrorCode.NOT_FOUND, "Application version not found");
+        }
+        return applicationVersionResponse.parse(released);
+    })
+});
+//# sourceMappingURL=applications.js.map

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

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

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

@@ -12,15 +12,17 @@ export declare const assetsRouter: 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: {
             parent_id?: string | undefined;
+            project_id?: string | undefined;
             content_type?: string | undefined;
             workflow_id?: string | undefined;
             node_id?: string | undefined;
             job_id?: string | undefined;
+            timeline_id?: string | undefined;
             page_size?: number | undefined;
         };
         output: {
@@ -33,12 +35,18 @@ export declare const assetsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 content_type: string;
                 size: number | null;
                 metadata: Record<string, unknown> | null;
+                sketch_document_id: string | null;
                 created_at: string;
                 get_url: string | null;
                 thumb_url: string | null;
                 duration: number | null;
                 node_id: string | null;
                 job_id: string | null;
+                timeline_id?: string | null | undefined;
+                project_id?: string | undefined;
+                offline?: boolean | undefined;
+                proxy_status?: "failed" | "none" | "queued" | "ready" | "running" | undefined;
+                proxy_url?: string | null | undefined;
             }[];
             next: string | null;
         };
@@ -47,6 +55,7 @@ export declare const assetsRouter: import("@trpc/server").TRPCBuiltRouter<{
     get: import("@trpc/server").TRPCQueryProcedure<{
         input: {
             id: string;
+            project_id?: string | undefined;
         };
         output: {
             id: string;
@@ -57,25 +66,64 @@ export declare const assetsRouter: import("@trpc/server").TRPCBuiltRouter<{
             content_type: string;
             size: number | null;
             metadata: Record<string, unknown> | null;
+            sketch_document_id: string | null;
             created_at: string;
             get_url: string | null;
             thumb_url: string | null;
             duration: number | null;
             node_id: string | null;
             job_id: string | null;
+            timeline_id?: string | null | undefined;
+            project_id?: string | undefined;
+            offline?: boolean | undefined;
+            proxy_status?: "failed" | "none" | "queued" | "ready" | "running" | undefined;
+            proxy_url?: string | null | undefined;
         };
         meta: object;
     }>;
-    create: import("@trpc/server").TRPCMutationProcedure<{
+    /**
+     * Step 1 of a client-direct upload: create the row, pick the key, and mint
+     * a short-lived target scoped to that key. The client never chooses where
+     * it writes, so a stolen or replayed target can only overwrite the one
+     * pending object it was issued for — inside its own owner's prefix.
+     *
+     * `upload` comes back null on backends with no direct-upload concept (the
+     * local file store); the client then falls back to `POST /api/assets`.
+     */
+    createUpload: import("@trpc/server").TRPCMutationProcedure<{
         input: {
             name: string;
             content_type: string;
-            parent_id: string;
+            parent_id?: string | undefined;
+            size: number;
             workflow_id?: string | null | undefined;
             node_id?: string | null | undefined;
             job_id?: string | null | undefined;
+            timeline_id?: string | null | undefined;
             metadata?: Record<string, unknown> | null | undefined;
-            size?: number | null | undefined;
+            project_id?: string | undefined;
+        };
+        output: {
+            asset_id: string;
+            key: string;
+            upload: {
+                url: string;
+                method: "POST" | "PUT";
+                headers: Record<string, string>;
+                expires_at: number;
+            } | null;
+        };
+        meta: object;
+    }>;
+    /**
+     * Step 2: confirm what actually landed. The signed target bounds *where* a
+     * client can write but not *what* — so the size is read back off the object
+     * rather than trusted from the client, and an over-cap or absent upload is
+     * rejected and the pending row removed.
+     */
+    finalizeUpload: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            asset_id: string;
         };
         output: {
             id: string;
@@ -86,25 +134,47 @@ export declare const assetsRouter: import("@trpc/server").TRPCBuiltRouter<{
             content_type: string;
             size: number | null;
             metadata: Record<string, unknown> | null;
+            sketch_document_id: string | null;
             created_at: string;
             get_url: string | null;
             thumb_url: string | null;
             duration: number | null;
             node_id: string | null;
             job_id: string | null;
+            timeline_id?: string | null | undefined;
+            project_id?: string | undefined;
+            offline?: boolean | undefined;
+            proxy_status?: "failed" | "none" | "queued" | "ready" | "running" | undefined;
+            proxy_url?: string | null | undefined;
         };
         meta: object;
     }>;
-    update: import("@trpc/server").TRPCMutationProcedure<{
+    /**
+     * Whether the desktop app should reference large files in place, and from
+     * what size. Plain browsers have no disk path and always upload.
+     */
+    externalImportConfig: import("@trpc/server").TRPCQueryProcedure<{
+        input: void;
+        output: {
+            enabled: boolean;
+            threshold_bytes: number;
+        };
+        meta: object;
+    }>;
+    /**
+     * Create an asset that references a local file in place. No bytes are
+     * copied: reads resolve the key to `external_path` (see
+     * `lib/external-asset-lookup.ts`), and deleting the asset leaves the file.
+     * The path is validated once, here, against the local file roots.
+     */
+    createExternal: import("@trpc/server").TRPCMutationProcedure<{
         input: {
-            id: string;
+            path: string;
             name?: string | undefined;
             content_type?: string | undefined;
             parent_id?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            size?: number | undefined;
-            data?: string | null | undefined;
-            data_encoding?: "utf-8" | "base64" | null | undefined;
+            project_id?: string | undefined;
+            workflow_id?: string | null | undefined;
         };
         output: {
             id: string;
@@ -115,42 +185,123 @@ export declare const assetsRouter: import("@trpc/server").TRPCBuiltRouter<{
             content_type: string;
             size: number | null;
             metadata: Record<string, unknown> | null;
+            sketch_document_id: string | null;
             created_at: string;
             get_url: string | null;
             thumb_url: string | null;
             duration: number | null;
             node_id: string | null;
             job_id: string | null;
+            timeline_id?: string | null | undefined;
+            project_id?: string | undefined;
+            offline?: boolean | undefined;
+            proxy_status?: "failed" | "none" | "queued" | "ready" | "running" | undefined;
+            proxy_url?: string | null | undefined;
         };
         meta: object;
     }>;
-    delete: import("@trpc/server").TRPCMutationProcedure<{
+    /**
+     * Point an in-place asset at another file: a moved, renamed, or remounted
+     * original, or the same path after the file changed. The id and `get_url`
+     * stay the same (D5). The path is validated again (R5), and the new size,
+     * mtime, and duration are recorded before the thumbnail is regenerated.
+     */
+    relinkExternal: import("@trpc/server").TRPCMutationProcedure<{
         input: {
             id: string;
+            path: string;
         };
         output: {
-            deleted_asset_ids: string[];
+            id: string;
+            user_id: string;
+            workflow_id: string | null;
+            parent_id: string | null;
+            name: string;
+            content_type: string;
+            size: number | null;
+            metadata: Record<string, unknown> | null;
+            sketch_document_id: string | null;
+            created_at: string;
+            get_url: string | null;
+            thumb_url: string | null;
+            duration: number | null;
+            node_id: string | null;
+            job_id: string | null;
+            timeline_id?: string | null | undefined;
+            project_id?: string | undefined;
+            offline?: boolean | undefined;
+            proxy_status?: "failed" | "none" | "queued" | "ready" | "running" | undefined;
+            proxy_url?: string | null | undefined;
         };
         meta: object;
     }>;
-    children: import("@trpc/server").TRPCQueryProcedure<{
+    /**
+     * Queue an all-intra preview proxy for a video asset, at any size, and
+     * answer its state. The timeline preview plays the proxy once the asset
+     * response says it is ready. A failed proxy is tried again. Refused off
+     * the local file store.
+     */
+    ensureProxy: import("@trpc/server").TRPCMutationProcedure<{
         input: {
             id: string;
-            limit?: number | undefined;
         };
         output: {
-            assets: {
-                id: string;
-                name: string;
-                content_type: string;
-            }[];
-            next: string | null;
+            status: "failed" | "none" | "queued" | "ready" | "running";
+            proxy_url: string | null;
+        };
+        meta: object;
+    }>;
+    update: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            id: string;
+            name?: string | undefined;
+            content_type?: string | undefined;
+            parent_id?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            expected_metadata?: Record<string, unknown> | null | undefined;
+            sketch_document_id?: string | null | undefined;
+            timeline_id?: string | null | undefined;
+            size?: number | undefined;
+            data?: string | null | undefined;
+            data_encoding?: "base64" | "utf-8" | null | undefined;
+        };
+        output: {
+            id: string;
+            user_id: string;
+            workflow_id: string | null;
+            parent_id: string | null;
+            name: string;
+            content_type: string;
+            size: number | null;
+            metadata: Record<string, unknown> | null;
+            sketch_document_id: string | null;
+            created_at: string;
+            get_url: string | null;
+            thumb_url: string | null;
+            duration: number | null;
+            node_id: string | null;
+            job_id: string | null;
+            timeline_id?: string | null | undefined;
+            project_id?: string | undefined;
+            offline?: boolean | undefined;
+            proxy_status?: "failed" | "none" | "queued" | "ready" | "running" | undefined;
+            proxy_url?: string | null | undefined;
+        };
+        meta: object;
+    }>;
+    delete: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            id: string;
+        };
+        output: {
+            deleted_asset_ids: string[];
         };
         meta: object;
     }>;
     recursive: import("@trpc/server").TRPCQueryProcedure<{
         input: {
             id: string;
+            project_id?: string | undefined;
         };
         output: {
             assets: {
@@ -162,12 +313,18 @@ export declare const assetsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 content_type: string;
                 size: number | null;
                 metadata: Record<string, unknown> | null;
+                sketch_document_id: string | null;
                 created_at: string;
                 get_url: string | null;
                 thumb_url: string | null;
                 duration: number | null;
                 node_id: string | null;
                 job_id: string | null;
+                timeline_id?: string | null | undefined;
+                project_id?: string | undefined;
+                offline?: boolean | undefined;
+                proxy_status?: "failed" | "none" | "queued" | "ready" | "running" | undefined;
+                proxy_url?: string | null | undefined;
             }[];
         };
         meta: object;
@@ -175,6 +332,7 @@ export declare const assetsRouter: import("@trpc/server").TRPCBuiltRouter<{
     search: import("@trpc/server").TRPCQueryProcedure<{
         input: {
             query: string;
+            project_id?: string | undefined;
             content_type?: string | undefined;
             page_size?: number | undefined;
             cursor?: string | undefined;
@@ -190,12 +348,18 @@ export declare const assetsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 content_type: string;
                 size: number | null;
                 metadata: Record<string, unknown> | null;
+                sketch_document_id: string | null;
                 created_at: string;
                 get_url: string | null;
                 thumb_url: string | null;
                 duration: number | null;
                 node_id: string | null;
                 job_id: string | null;
+                timeline_id?: string | null | undefined;
+                project_id?: string | undefined;
+                offline?: boolean | undefined;
+                proxy_status?: "failed" | "none" | "queued" | "ready" | "running" | undefined;
+                proxy_url?: string | null | undefined;
             }[];
             next_cursor: string | null;
             total_count: number;
@@ -203,27 +367,5 @@ export declare const assetsRouter: import("@trpc/server").TRPCBuiltRouter<{
         };
         meta: object;
     }>;
-    byFilename: import("@trpc/server").TRPCQueryProcedure<{
-        input: {
-            filename: string;
-        };
-        output: {
-            id: string;
-            user_id: string;
-            workflow_id: string | null;
-            parent_id: string | null;
-            name: string;
-            content_type: string;
-            size: number | null;
-            metadata: Record<string, unknown> | null;
-            created_at: string;
-            get_url: string | null;
-            thumb_url: string | null;
-            duration: number | null;
-            node_id: string | null;
-            job_id: string | null;
-        };
-        meta: object;
-    }>;
 }>>;
 //# sourceMappingURL=assets.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/trpc/routers/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+GH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6LvB,CAAC"}
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/trpc/routers/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoRH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8EvB;;;;;;;;OAQG;;;;;;;;;;;;;;;;;;;;;;;;;;IAkEH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+CH;;;OAGG;;;;;;;;;IAQH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0EH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyEH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqMH,CAAC"}