@slatesvideo/shared 0.4.5 → 0.4.6

package/dist/operations/index.d.ts

@@ -25,7 +25,9 @@ export declare const getWorkspaceState: Operation<{
 }>;
 export declare const getMe: Operation<Record<string, never>>;
 export declare const getCreditBalance: Operation<Record<string, never>>;
-export declare const listAvailableModels: Operation<Record<string, never>>;
+export declare const listAvailableModels: Operation<{
+    filter?: string;
+}>;
 export declare const estimateGenerationCost: Operation<{
     model: string;
     quantity?: number;
@@ -39,6 +41,9 @@ export declare const getProject: Operation<{
 }>;
 export declare const listAssets: Operation<{
     projectId: string;
+    type?: 'image' | 'video' | 'audio';
+    search?: string;
+    limit?: number;
 }>;
 export declare const getAssetImage: Operation<{
     id: string;
@@ -216,6 +221,7 @@ export declare const generateMotionTransfer: Operation<{
 }>;
 export declare const getGenerationStatus: Operation<{
     generationId: string;
+    waitSeconds?: number;
 }>;
 export declare const listGenerations: Operation<{
     projectId?: string;

package/dist/operations/index.js

@@ -22,7 +22,9 @@ export function defaultContext() {
 // ── Helpers ─────────────────────────────────────────────────────
 function ok(data, text) {
     return {
-        text: text ?? JSON.stringify(data, null, 2),
+        // Compact JSON — pretty-printing (indent 2) cost ~10-15% extra tokens
+        // on every tool result the calling LLM reads.
+        text: text ?? JSON.stringify(data),
         data,
     };
 }
@@ -77,11 +79,25 @@ export const getCreditBalance = {
 };
 export const listAvailableModels = {
     id: 'slates_list_available_models',
-    description: 'Full registry of generation models with their per-call credit cost. Use this for cost estimation.',
-    input: z.object({}).strict(),
-    async run(_input, ctx) {
+    description: 'Registry of generation model cost keys with per-call credit cost in cents, as a compact "key cents" table. Optional `filter` substring (e.g. "kling" or "nano-banana") keeps the result small — prefer it. For a single known model, slates_estimate_generation_cost is cheaper still.',
+    input: z.object({
+        filter: z.string().optional().describe('Substring match on the model key, e.g. "kling-v3" or "seedance"'),
+    }),
+    async run(input, ctx) {
         const r = await ctx.cloud().get('/api/agent/models');
-        return ok(r);
+        let models = r.models;
+        if (input.filter) {
+            const q = input.filter.toLowerCase();
+            models = models.filter((m) => m.model.toLowerCase().includes(q));
+        }
+        // Compact text table — "key cents" lines are ~5x denser than the raw
+        // JSON registry (the full pretty-printed dump was an ~8k-token leak).
+        const table = models.map((m) => `${m.model} ${m.cost_cents}`).join('\n');
+        return {
+            text: `${models.length} model cost keys (cents per generation)${input.filter ? ` matching "${input.filter}"` : ''}:\n` +
+                table,
+            data: { count: models.length, credit_markup: r.credit_markup },
+        };
     },
 };
 export const estimateGenerationCost = {
@@ -138,15 +154,56 @@ export const getProject = {
     },
 };
 // ── Assets ──────────────────────────────────────────────────────
+/** Compact projection of a raw asset row — the full row (prompt, settings,
+ * paths, thumbnails) is 20-50x heavier and was the single biggest context
+ * leak in early agent sessions (494 assets ≈ 130KB ≈ 33k tokens in ONE
+ * tool result). Every op that embeds asset lists uses this. */
+function compactAsset(a) {
+    const r = a;
+    const prompt = typeof r.prompt === 'string' ? r.prompt : '';
+    return {
+        id: r.id,
+        code: r.code ?? null,
+        label: r.label ?? (prompt ? prompt.slice(0, 40) : null),
+        type: r.type,
+        created_at: r.createdAt ?? r.created_at ?? undefined,
+    };
+}
 export const listAssets = {
     id: 'slates_list_assets',
-    description: 'List all assets (images + videos) in a Slates project. Each asset carries its short code (IMG-A12 / VID-V3 / AUD-S1 — the badge the user sees on the gallery card) and label. When the user names an asset by code ("use IMG-A36 as the reference"), call this and match on the code field to resolve the assetId. Always speak about assets by code + label, never by UUID.',
-    input: z.object({ projectId: z.string().uuid() }),
+    description: 'List assets in a Slates project as COMPACT rows (id, code, label, type) — newest first, default limit 50. Each asset carries its short code (IMG-A12 / VID-V3 / AUD-S1 — the badge the user sees on the gallery card) and label. When the user names an asset by code ("use IMG-A36 as the reference"), pass it as `search` to resolve the assetId. Always speak about assets by code + label, never by UUID. NOTE: generate_* results already return the new asset ids — do NOT call this to find an asset you just created.',
+    input: z.object({
+        projectId: z.string().uuid(),
+        type: z.enum(['image', 'video', 'audio']).optional().describe('Only this asset type'),
+        search: z.string().optional().describe('Case-insensitive match on code or label (e.g. "IMG-A36" or "sunset")'),
+        limit: z.number().int().min(1).max(500).optional().describe('Max rows (default 50, newest first)'),
+    }),
     async run(input, ctx) {
         const r = await ctx.desktop().get('/agent/assets', {
             projectId: input.projectId,
         });
-        return ok(r);
+        const all = (r.assets ?? []).map(compactAsset);
+        let rows = all;
+        if (input.type)
+            rows = rows.filter((a) => a.type === input.type);
+        if (input.search) {
+            const q = input.search.toLowerCase();
+            rows = rows.filter((a) => String(a.code ?? '').toLowerCase().includes(q) ||
+                String(a.label ?? '').toLowerCase().includes(q));
+        }
+        // Newest first, then cap. (created_at is ISO — lexicographic sort works.)
+        rows = rows
+            .slice()
+            .sort((a, b) => String(b.created_at ?? '').localeCompare(String(a.created_at ?? '')));
+        const limit = input.limit ?? 50;
+        const truncated = rows.length > limit;
+        rows = rows.slice(0, limit);
+        return ok({
+            total_matching: truncated ? undefined : rows.length,
+            total_in_project: all.length,
+            truncated,
+            assets: rows.map(({ created_at: _drop, ...rest }) => rest),
+        });
     },
 };
 export const getAssetImage = {
@@ -760,7 +817,10 @@ export const generateImage = {
                     resolution,
                     cost_cents: totalCents,
                     cost_dollars: (totalCents / 100).toFixed(2),
-                    assets: assetList,
+                    // Compact refs only — the full rows (prompt/settings/paths) were a
+                    // multi-KB leak per generation and everything needed downstream is
+                    // the id/code/label.
+                    assets: assetList.map(compactAsset),
                     generationIds: result.generationIds ?? (result.generationId ? [result.generationId] : []),
                     ...(partialFailure
                         ? { partial: true, error: result.error ?? 'unknown error', requested_count: requestedCount }
@@ -1455,12 +1515,31 @@ export const generateMotionTransfer = {
 // ── Generation status (background mode) ─────────────────────────
 export const getGenerationStatus = {
     id: 'slates_get_generation_status',
-    description: 'Poll one generation by id. Returns status (pending/processing/completed/failed/cancelled), the error message on failure, and the finished asset record (with id, code, filePath) on completion. Use after submitting any generate_* op with background=true; poll every 5-15s — video generations commonly take 1-5 minutes. Generations survive app restarts (the desktop resumes in-flight provider jobs on boot).',
-    input: z.object({ generationId: z.string().uuid() }),
+    description: 'Poll one generation by id. Returns status (pending/processing/completed/failed/cancelled), the error message on failure, and the finished asset record (with id, code, filePath) on completion. Use after submitting any generate_* op with background=true. ALWAYS pass waitSeconds (use 45) — the call long-polls internally and returns early the moment the generation reaches a terminal state, so ONE call replaces a dozen rapid polls (each poll turn re-reads your whole context; rapid polling is the #1 orchestration-cost leak). Video generations commonly take 1-5 minutes: expect 1-4 long-poll calls, never a tight loop. Generations survive app restarts (the desktop resumes in-flight provider jobs on boot).',
+    input: z.object({
+        generationId: z.string().uuid(),
+        waitSeconds: z
+            .number()
+            .int()
+            .min(0)
+            .max(50)
+            .optional()
+            .describe('Long-poll: block up to N seconds, returning early on completion/failure. Use 45.'),
+    }),
     async run(input, ctx) {
         const desktop = ctx.desktop();
         await desktop.requireCapability('background-generation', 'background generation');
-        return ok(await desktop.get('/agent/generation/status', { id: input.generationId }));
+        const deadline = Date.now() + Math.min(Math.max(input.waitSeconds ?? 0, 0), 50) * 1000;
+        for (;;) {
+            const r = await desktop.get('/agent/generation/status', {
+                id: input.generationId,
+            });
+            const status = r.status;
+            const terminal = status === 'completed' || status === 'failed' || status === 'cancelled';
+            if (terminal || Date.now() >= deadline)
+                return ok(r);
+            await new Promise((resolve) => setTimeout(resolve, Math.min(3000, deadline - Date.now())));
+        }
     },
 };
 export const listGenerations = {
@@ -1477,7 +1556,8 @@ export const listGenerations = {
         return ok(await desktop.get('/agent/generation/list', {
             projectId: input.projectId,
             status: input.status,
-            limit: input.limit,
+            // Default cap — an unbounded history dump is a context leak.
+            limit: input.limit ?? 20,
         }));
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slatesvideo/shared",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Shared operations layer for the Slates MCP server and CLI: auth, cloud/desktop clients, and the single tool surface both consume. Most users want @slatesvideo/mcp-server or @slatesvideo/cli instead.",
   "license": "MIT",
   "type": "module",