@slatesvideo/shared 0.6.10 → 0.7.0

package/dist/operations/surface.d.ts

@@ -37,6 +37,7 @@ export declare const OPERATION_GROUPS: Record<OperationGroup, readonly string[]>
 export declare function groupFor(id: string): OperationGroup | undefined;
 /** `extended` iff the op names a group. Absent from every group ⇒ `core`, so a
  *  new op is visible until someone deliberately defers it. */
+export declare const STARTUP_TOOL_IDS: Set<string>;
 export declare function tierFor(id: string): OperationTier;
 /** One-line summary of each group, for `slates_load_tools`' own description. */
 export declare const GROUP_SUMMARY: Record<OperationGroup, string>;
@@ -60,10 +61,11 @@ export declare function toolDefinition(op: SurfaceOp): ToolDefinition;
  * Render a tool surface.
  *
  * `desktop` sends `core` plus whatever groups have been loaded this run; `mcp`
- * sends everything, because a stdio server has no run to append to.
+ * renders all definitions; the MCP server filters its connection listing from that set.
  */
 export declare function toolDefinitions(ops: readonly SurfaceOp[], opts: {
     surface: 'desktop' | 'mcp';
     groups?: readonly OperationGroup[];
+    names?: readonly string[];
 }): ToolDefinition[];
 //# sourceMappingURL=surface.d.ts.map

package/dist/operations/surface.js

@@ -11,10 +11,9 @@
 //
 //   2. TIERS. 90 ops is 112 KB of descriptions and JSON schemas on EVERY
 //      desktop Studio Agent turn. `core` is what a session needs to work;
-//      `extended` is deferred behind `slates_load_tools` and appended to the
-//      run's tool list once a group loads. The MCP server still registers
-//      everything — a stdio server has no run to append to, and Claude Code
-//      already defers stdio tool schemas through its own tool search.
+//      `extended` is selected through `slates_load_tools`. Both surfaces replace
+//      the optional selection on a named/group load. MCP keeps every direct
+//      operation callable for compatibility and notifies when its listing changes.
 //
 //   3. ONE SCHEMA RENDERER. The desktop rendered `$refStrategy: 'none'` and
 //      the MCP server rendered `target: 'openApi3'`, so "the two surfaces
@@ -54,12 +53,15 @@ const DESTRUCTIVE_IDS = new Set([
     'slates_delete_character',
     'slates_delete_environment',
     'slates_delete_style',
+    'slates_delete_library_item',
     'slates_delete_storyboard',
     'slates_delete_scene',
     'slates_delete_frame',
     'slates_move_assets_to_folder',
     'slates_move_assets_to_project',
     'slates_move_entity_to_project',
+    'slates_relocate_project',
+    'slates_undo_relocate_project',
     'slates_merge_shots',
     'slates_split_shot',
 ]);
@@ -115,6 +117,11 @@ export const OPERATION_GROUPS = {
         'slates_delete_folder',
         'slates_set_folder_cover',
         'slates_move_assets_to_folder',
+        'slates_set_asset_favorite',
+        'slates_export_assets',
+        'slates_list_pins',
+        'slates_pin_references',
+        'slates_unpin_reference',
         'slates_move_assets_to_project',
         'slates_copy_assets_to_project',
         'slates_move_entity_to_project',
@@ -122,15 +129,29 @@ export const OPERATION_GROUPS = {
         'slates_create_style',
         'slates_update_style',
         'slates_delete_style',
+        'slates_list_library',
+        'slates_create_library_item',
+        'slates_update_library_item',
+        'slates_delete_library_item',
+        'slates_manage_library_category',
+        'slates_copy_library_item_to_project',
+        'slates_get_template',
+        'slates_export_template',
+        'slates_import_template',
         'slates_get_project_directory',
+        'slates_relocate_project',
+        'slates_undo_relocate_project',
         'slates_reveal_file',
     ],
     // The cut and the export. A generation session never touches these.
+    script: ['slates_get_script_document', 'slates_update_script_document', 'slates_get_script_sections', 'slates_update_script_section', 'slates_get_script_suggestions', 'slates_update_script_suggestions', 'slates_get_script_uses', 'slates_preview_script_variation', 'slates_create_script_variation', 'slates_get_shot_inputs', 'slates_reuse_shot_take'],
     timeline: [
+        'slates_list_timelines', 'slates_save_timeline', 'slates_export_cuts',
         'slates_get_timeline',
         'slates_add_clip_to_timeline',
         'slates_reorder_clips',
         'slates_remove_clip',
+        'slates_manage_timeline_marker',
         'slates_add_timeline_track',
         'slates_update_timeline_track',
         'slates_remove_timeline_track',
@@ -179,14 +200,20 @@ export function groupFor(id) {
 }
 /** `extended` iff the op names a group. Absent from every group ⇒ `core`, so a
  *  new op is visible until someone deliberately defers it. */
+export const STARTUP_TOOL_IDS = new Set([
+    'slates_load_tools', 'slates_get_prompting_guide', 'slates_get_workspace_state',
+    'slates_list_projects', 'slates_create_project', 'slates_list_assets',
+    'slates_get_asset_image', 'slates_get_generation_status', 'slates_estimate_generation_cost',
+]);
 export function tierFor(id) {
-    return GROUP_BY_OP.has(id) ? 'extended' : 'core';
+    return STARTUP_TOOL_IDS.has(id) ? 'core' : 'extended';
 }
 /** One-line summary of each group, for `slates_load_tools`' own description. */
 export const GROUP_SUMMARY = {
-    library: 'folders, styles, moving and copying assets between projects, revealing files on disk',
-    timeline: 'the timeline (tracks, clips, settings), video export and NLE XML export, clip trimming',
-    admin: 'rename / delete / reorder for projects, characters, environments, storyboards, scenes and frames; shot duplicate, split and merge',
+    library: 'folders, the Library (user-named categories of saved references: characters, locations, products, looks), moving and copying assets and Library items between projects, moving a project into the current projects folder, revealing files on disk',
+    script: 'rich script documents, anchored sections and their saved versions, reusable passages, variations and take input history',
+    timeline: 'named cuts and selected exports; the timeline (tracks, clips, markers, settings), video export and export for DaVinci, Premiere or Final Cut (XML), clip trimming',
+    admin: 'rename / delete / reorder for projects, characters, locations, looks, boards, scenes and frames; shot duplicate, split and merge',
     blender: 'the Blender previs bridge — scene inspection, bpy execution, API docs, grey-box render',
 };
 /**
@@ -211,7 +238,7 @@ export function toolDefinition(op) {
  * Render a tool surface.
  *
  * `desktop` sends `core` plus whatever groups have been loaded this run; `mcp`
- * sends everything, because a stdio server has no run to append to.
+ * renders all definitions; the MCP server filters its connection listing from that set.
  */
 export function toolDefinitions(ops, opts) {
     const loaded = new Set(opts.groups ?? []);
@@ -220,7 +247,7 @@ export function toolDefinitions(ops, opts) {
         if (opts.surface === 'mcp')
             return true;
         const group = groupFor(op.id);
-        return group === undefined || loaded.has(group);
+        return STARTUP_TOOL_IDS.has(op.id) || !!opts.names?.includes(op.id) || (group !== undefined && loaded.has(group));
     })
         .map(toolDefinition);
 }

package/dist/prompts/ad-presets.d.ts

@@ -0,0 +1,77 @@
+/** Original free starter examples. Model choices and costs resolve at use time.
+ * Evidence and source coverage: second-brain/business/projects/slates/research/script-craft/.
+ * Preview readiness is explicit; importing a draft never claims a tested output. */
+export declare const AD_PRESETS: readonly [{
+    readonly id: "catch-the-small-problem";
+    readonly revision: 1;
+    readonly name: "Catch the small problem";
+    readonly tags: readonly ["product demonstration", "spoken", "everyday"];
+    readonly techniques: readonly ["sc-event", "sc-proof", "sc-bridge"];
+    readonly description: "A small everyday frustration becomes a visible product demonstration. An original fictional keys-tray example.";
+    readonly adaptation: "Replace the object, familiar frustration and observable demonstration. Supply real product facts and the destination for the invitation. Compare the opening and its bridge together; keep the demonstration fixed.";
+    readonly sections: readonly [{
+        readonly label: "Opening";
+        readonly alternatives: readonly [{
+            readonly label: "Question";
+            readonly text: "Where do your keys go when you get home?\nMine used to land wherever my hand stopped.";
+            readonly action: "A hand drops a key ring onto a cluttered entrance table. The keys stop near the edge. An ordinary moment, filmed close enough to see the key ring.";
+        }, {
+            readonly label: "Search";
+            readonly text: "I checked my coat, my bag, and the table.\nThey were under the receipt.";
+            readonly action: "The same hand checks a coat pocket, opens a bag, then lifts a receipt to reveal the keys. Let the last action answer the search.";
+        }, {
+            readonly label: "Objection";
+            readonly text: "A tray just for keys?\nThat was my question too.";
+            readonly action: "A small tray sits beside a scattered key ring. A hand turns the tray once, then puts it down by the door.";
+        }];
+    }, {
+        readonly label: "Demonstration";
+        readonly alternatives: readonly [{
+            readonly label: "A place to land";
+            readonly text: "Now I leave this by the door.\nKeys go in when I arrive. I pick them up when I leave.";
+            readonly action: "The hand places the keys inside the shallow tray. Match the next departure gesture to the same framing: the hand finds the keys in that tray. Show only the behavior described.";
+        }];
+    }, {
+        readonly label: "Invitation";
+        readonly alternatives: readonly [{
+            readonly label: "See the product";
+            readonly text: "Give the small things a place to land.";
+            readonly action: "Hold a clear view of the tray with the keys inside. Keep the product unobstructed. The destination and offer are supplied by the creator; no price or claim appears in the image.";
+        }];
+    }];
+}, {
+    readonly id: "silent-small-demonstration";
+    readonly revision: 1;
+    readonly name: "Let the object explain";
+    readonly tags: readonly ["silent", "product demonstration", "modular"];
+    readonly techniques: readonly ["sc-event", "sc-proof", "sc-modular"];
+    readonly description: "An original silent tray demonstration. The opening event changes while the product action stays fixed.";
+    readonly adaptation: "Choose a real product action that reads without speech. Replace the sample object and place. Keep the physical setup legible; a different opening must still lead naturally into the same demonstration. Add sound only when wanted.";
+    readonly sections: readonly [{
+        readonly label: "Opening event";
+        readonly alternatives: readonly [{
+            readonly label: "Almost lost";
+            readonly text: "";
+            readonly action: "Silent overhead view of an entrance table. A key ring slides toward the edge and stops. A hand enters with a shallow tray. No dialogue or on-screen text.";
+        }, {
+            readonly label: "Found it";
+            readonly text: "";
+            readonly action: "Silent overhead view of an entrance table. A hand lifts a small stack of receipts, revealing a key ring underneath. The hand brings an empty shallow tray into the same space. No dialogue or on-screen text.";
+        }];
+    }, {
+        readonly label: "Demonstration";
+        readonly alternatives: readonly [{
+            readonly label: "In reach";
+            readonly text: "";
+            readonly action: "Silent overhead view of the same table and tray. A hand puts the keys inside the tray, leaves the frame, then returns and picks them up directly. Keep the object and gesture visible. No dialogue or on-screen text.";
+        }];
+    }, {
+        readonly label: "Closing view";
+        readonly alternatives: readonly [{
+            readonly label: "The result";
+            readonly text: "";
+            readonly action: "Silent close view of the same tray holding the key ring on the table. Hold the still composition so the result is easy to read. No dialogue or on-screen text.";
+        }];
+    }];
+}];
+//# sourceMappingURL=ad-presets.d.ts.map

package/dist/prompts/ad-presets.js

@@ -0,0 +1,43 @@
+/** Original free starter examples. Model choices and costs resolve at use time.
+ * Evidence and source coverage: second-brain/business/projects/slates/research/script-craft/.
+ * Preview readiness is explicit; importing a draft never claims a tested output. */
+export const AD_PRESETS = [
+    {
+        id: 'catch-the-small-problem', revision: 1, name: 'Catch the small problem',
+        tags: ['product demonstration', 'spoken', 'everyday'], techniques: ['sc-event', 'sc-proof', 'sc-bridge'],
+        description: 'A small everyday frustration becomes a visible product demonstration. An original fictional keys-tray example.',
+        adaptation: 'Replace the object, familiar frustration and observable demonstration. Supply real product facts and the destination for the invitation. Compare the opening and its bridge together; keep the demonstration fixed.',
+        sections: [
+            { label: 'Opening', alternatives: [
+                    { label: 'Question', text: 'Where do your keys go when you get home?\nMine used to land wherever my hand stopped.', action: 'A hand drops a key ring onto a cluttered entrance table. The keys stop near the edge. An ordinary moment, filmed close enough to see the key ring.' },
+                    { label: 'Search', text: 'I checked my coat, my bag, and the table.\nThey were under the receipt.', action: 'The same hand checks a coat pocket, opens a bag, then lifts a receipt to reveal the keys. Let the last action answer the search.' },
+                    { label: 'Objection', text: 'A tray just for keys?\nThat was my question too.', action: 'A small tray sits beside a scattered key ring. A hand turns the tray once, then puts it down by the door.' },
+                ] },
+            { label: 'Demonstration', alternatives: [
+                    { label: 'A place to land', text: 'Now I leave this by the door.\nKeys go in when I arrive. I pick them up when I leave.', action: 'The hand places the keys inside the shallow tray. Match the next departure gesture to the same framing: the hand finds the keys in that tray. Show only the behavior described.' },
+                ] },
+            { label: 'Invitation', alternatives: [
+                    { label: 'See the product', text: 'Give the small things a place to land.', action: 'Hold a clear view of the tray with the keys inside. Keep the product unobstructed. The destination and offer are supplied by the creator; no price or claim appears in the image.' },
+                ] },
+        ],
+    },
+    {
+        id: 'silent-small-demonstration', revision: 1, name: 'Let the object explain',
+        tags: ['silent', 'product demonstration', 'modular'], techniques: ['sc-event', 'sc-proof', 'sc-modular'],
+        description: 'An original silent tray demonstration. The opening event changes while the product action stays fixed.',
+        adaptation: 'Choose a real product action that reads without speech. Replace the sample object and place. Keep the physical setup legible; a different opening must still lead naturally into the same demonstration. Add sound only when wanted.',
+        sections: [
+            { label: 'Opening event', alternatives: [
+                    { label: 'Almost lost', text: '', action: 'Silent overhead view of an entrance table. A key ring slides toward the edge and stops. A hand enters with a shallow tray. No dialogue or on-screen text.' },
+                    { label: 'Found it', text: '', action: 'Silent overhead view of an entrance table. A hand lifts a small stack of receipts, revealing a key ring underneath. The hand brings an empty shallow tray into the same space. No dialogue or on-screen text.' },
+                ] },
+            { label: 'Demonstration', alternatives: [
+                    { label: 'In reach', text: '', action: 'Silent overhead view of the same table and tray. A hand puts the keys inside the tray, leaves the frame, then returns and picks them up directly. Keep the object and gesture visible. No dialogue or on-screen text.' },
+                ] },
+            { label: 'Closing view', alternatives: [
+                    { label: 'The result', text: '', action: 'Silent close view of the same tray holding the key ring on the table. Hold the still composition so the result is easy to read. No dialogue or on-screen text.' },
+                ] },
+        ],
+    },
+];
+//# sourceMappingURL=ad-presets.js.map

package/dist/prompts/agent-doctrine.js

@@ -82,7 +82,7 @@ export const WORKING_METHOD = [
     both(`For HOW/WHERE questions, load slates_get_prompting_guide with topic "app-manual" and relevant query keywords. Teach the documented buttons and tabs, preserving model-specific conditions; do not invent UI paths or mutate the project when the user only asks for instructions. Slates is a sandbox of optional tools, not a required pipeline.`),
     both(`1. UNDERSTAND the outcome the user wants. If intent is clear, act with sane defaults — don't interrogate. If genuinely ambiguous, batch every question into ONE message.`),
     both(`2. ORIENT: call slates_get_workspace_state once at the start of a workflow. Work in the user's CURRENT project — this chat lives inside it. NEVER create a new project unless explicitly asked; if there's no current project, ask which to use.`),
-    both(`3. LOAD KNOWLEDGE ON DEMAND: before prompting any model or running a multi-step workflow, load the matching guide with slates_get_prompting_guide (index below). Only the guides the task needs, when it needs them.`),
+    both(`3. LOAD KNOWLEDGE ON DEMAND: slates_get_prompting_guide returns a short card by default; query a section or technique when needed. Use slates_load_tools with query to find a capability, then names to load its exact schema. A load replaces the previous optional selection. Before quoting a model, load its tool schema or routing guide. Use workspace generationDefaults when the user has no preference. Read the model card delivered by the estimate; fetch a section or full guide for an unfamiliar mode or missing detail. Reuse guidance already in context; retrieve it again when omitted or stale.`),
     // FORKED: `present_plan` is a loop-level DESKTOP tool, deliberately not in
     // ALL_OPERATIONS, so MCP never sees it and has no plan gate at all. Its
     // substitute is the per-op `requires_confirm` threshold plus the host
@@ -102,7 +102,8 @@ export const HARD_RULES = [
     fork(`- COST DISCIPLINE (slates-cost-discipline): never fire a billable generation outside an approved plan. Estimate before you promise. Batch related generations into one plan.`, `- COST DISCIPLINE (slates-cost-discipline): never fire a billable generation the user has not agreed to. Estimate before you promise. Batch related generations into one quote so the user approves a total, not a drip.`),
     both(`- CONTENT POLICY: before writing prompts involving real people/celebrities, minors, brands/logos, weapons, or gore, load slates-content-policy and build the scene safe from the first word. If a provider rejects (e.g. real-face detection), explain in plain language — refunds for provider rejections are automatic.`),
     both(`- PROMPT IS LAW (reference doctrine): references are cited inline by name and image number ("Marcus (images 1 and 2)"); the prompt text leads. Never write role-essays about what each reference is "for".`),
-    both(`- NAMES AND DESCRIPTIONS ARE THE USER'S UI, NOT YOUR NOTEPAD. A project, storyboard or shot name is rendered at the top of the user's screen at all times. Name it after the piece ("Kaiju selfie"), never after your process, and NEVER append your own status or housekeeping — no "shot list", no "v2", no "Written from IMG-A172 and IMG-A182", no "Delete freely", no "scratch". Leave the description empty unless the user gave you one worth keeping: a note-to-self at the top of the screen reads as part of the product, and the user has to look at it every day. Say that kind of thing in your reply to them instead.`),
+    both(`- NAMES AND DESCRIPTIONS ARE THE USER'S UI, NOT YOUR NOTEPAD. A project, board or shot name is rendered at the top of the user's screen at all times. Name it after the piece ("Kaiju selfie"), never after your process, and NEVER append your own status or housekeeping — no "shot list", no "v2", no "Written from IMG-A172 and IMG-A182", no "Delete freely", no "scratch". Leave the description empty unless the user gave you one worth keeping: a note-to-self at the top of the screen reads as part of the product, and the user has to look at it every day. Say that kind of thing in your reply to them instead.`),
+    both(`- SAY THE APP'S WORDS. Tool and parameter names keep older nouns; the screen does not, and the user only ever sees the screen. Say board (not storyboard), location (not environment) and look (not style) for Library items, timeline (a saved version of it is a cut), version (a saved rewrite of a script section; not alternative), Words or Words + shots (the Script page's switch), the Generate panel (not the quote), and tab (Media, Script and Board; not lens). Describe what you did in plain words ("Checked your project", "Priced 6 clips"), never a tool or parameter name.`),
     both(`- RESOLUTION DEFAULT IS UNIFORM: 1080p on the best available video model. Do not crank resolution the user didn't ask for.`),
     // ⛔ THE MODEL ROUTING BLOCK IS GONE FROM HERE, DELIBERATELY (2026-08-30).
     //
@@ -120,7 +121,7 @@ export const HARD_RULES = [
     // exported "in case": an export nothing calls is an export nothing keeps
     // honest. `describeRouting()` in model-facts.ts is the renderer now.
     both(`- MODEL KINDS: image, video and audio models are disjoint — no image model makes a video, no video model makes a standalone image, no image or video model makes audio. Which SEAT to pick inside a kind is on each generate op's own \`model\` description, and the full table is the slates-model-selection skill.`),
-    both(`- ASSET CODES + STALENESS: every asset carries a badge code (IMG-A12 / VID-V3 / AUD-S1, top-left of its gallery card); speak about assets by code + label. Asset lists go STALE — the user creates assets in the Slates UI mid-conversation. When the user names a code you have NOT seen in a tool result this session, resolve it with slates_list_assets (use the search filter) BEFORE using it. NEVER guess an asset id or reuse a nearby UUID — pass the exact id a tool returned for that exact code. A wrong start frame burns real credits.`),
+    both(`- ASSET CODES + STALENESS: every asset carries a badge code (IMG-A12 / VID-V3 / AUD-S1, top-left of its gallery card); speak about assets by code + label. When the user says "these" or "this one", call slates_get_selection rather than asking which. Asset lists go STALE — the user creates assets in the Slates UI mid-conversation. When the user names a code you have NOT seen in a tool result this session, resolve it with slates_list_assets (use the search filter) BEFORE using it. NEVER guess an asset id or reuse a nearby UUID — pass the exact id a tool returned for that exact code. A wrong start frame burns real credits.`),
     both(`- CREDITS ONLY: every generation you drive bills Slates credits (your tool calls enforce this). Never suggest BYOK keys for agent work.`),
     both(`- Do not invent tools, asset ids, or credit prices. If a tool errors, read the error and fix that exact issue; don't repeat the same call unchanged and never switch models to route around a parameter mistake.`),
     // FORKED: only the desktop loop auto-polls generation status
@@ -138,7 +139,7 @@ export const HARD_RULES = [
     // compliance 0/8 → 30/32, while the same guidance behind a guide fetch sat at
     // 13% before and after. This sentence exists only to say the numbers are
     // there and must be looked at; the craft is the skill.
-    both(`- READ THE VARIETY COUNTS BEFORE FIRING A SET: slates_list_shots and slates_get_storyboard_with_frames return the distribution (shot sizes, camera moves, runs of three or more) with the rows. If one bucket is the plurality, fix the board before you spend — slates-shot-variety is the craft.`),
+    both(`- READ THE VARIETY COUNTS BEFORE FIRING A SET: slates_list_shots and slates_get_storyboard_with_frames return authored framing and movement distributions. Review unintended sameness while preserving deliberate repetition and the user's format; counts do not require a rewrite. slates-shot-variety is the craft.`),
     both(`- AUDIO LENGTH IS PROMPT-DRIVEN ON SEED AUDIO: it has no duration parameter, so the durationSeconds you pass is written into the prompt AND is what the user is charged, whatever comes back. Choose it deliberately and load slates-prompting-seed-audio before the first call.`),
 ];
 // ── Surface-only footers ───────────────────────────────────────────

package/dist/prompts/banned-tokens.d.ts

@@ -1,40 +1,15 @@
-/** Which generate op a list applies to. */
 export type BannedTokenScope = 'image' | 'video';
 export interface BannedToken {
-    /** The literal phrase, verbatim from the skill. */
     token: string;
-    /** Skill file it was read from — cited in every warning. */
     skill: string;
     scope: BannedTokenScope;
 }
-/** Every banned token, in skill-document order. Integrity asserted at load. */
+/** Compatibility exports: there is no cross-model blacklist. */
 export declare const BANNED_PROMPT_TOKENS: readonly BannedToken[];
-export declare function bannedTokensFor(scope: BannedTokenScope): readonly BannedToken[];
-/** The never-use list a single skill declares. Empty for a skill with no block. */
+export declare function bannedTokensFor(_scope: BannedTokenScope): readonly BannedToken[];
+export declare function describeBannedTokens(_scope: BannedTokenScope): string;
 export declare function bannedTokensForSkill(skill: string): readonly BannedToken[];
-/**
- * A single model's never-use list, for the estimate RESULT.
- *
- * Deliberately NOT the cross-model list — that one already rides the op
- * description on every call. This is the half that could not: the quirk that is
- * true of Veo and false of Kling.
- */
+export declare function findBannedTokens(prompt: string, _scope: BannedTokenScope, skill?: string): BannedToken[];
 export declare function describeBannedTokensForSkill(skill: string): string;
-/** The tokens a submitted prompt actually contains. `skill` adds that model's
- *  own list to the modality-wide one — the two overlap for nano-banana-2 and
- *  seedance, so hits are deduplicated by token. */
-export declare function findBannedTokens(prompt: string, scope: BannedTokenScope, skill?: string): BannedToken[];
-/**
- * The list as it appears INSIDE an op description — always in context, on both
- * surfaces, with no call required to see it. Generated, never hand-typed.
- */
-export declare function describeBannedTokens(scope: BannedTokenScope): string;
-/**
- * Non-blocking warning for a submitted prompt. Empty string when clean.
- *
- * Returned in the op RESULT — the one place the agent cannot avoid reading —
- * rather than raised as an error. The generation proceeds either way: the
- * sandbox doctrine says make state visible, never block.
- */
 export declare function bannedTokenWarning(prompt: string, scope: BannedTokenScope, skill?: string): string;
 //# sourceMappingURL=banned-tokens.d.ts.map

package/dist/prompts/banned-tokens.js

@@ -1,219 +1,44 @@
-// ============================================================
-// BANNED PROMPT TOKENS — the "load the guide" rule, made structural.
-//
-// THE PROBLEM: "before prompting any model, load the matching guide" is a
-// sentence in a system prompt with nothing checking it. Measured 2026-08-30 in
-// a real Studio Agent session: slates_get_prompting_guide was called ZERO
-// times, and the prompt that shipped tripped the skill's own never-use list
-// twice (`photorealistic`, `cinematic`). A rule with no check is a suggestion,
-// and an LLM is the least reliable enforcer you could pick.
-//
-// THE FIX, in two halves, neither of which the model can skip:
-//   (a) the never-use list is INLINED into the generate ops' descriptions.
-//       Op descriptions are always in context on BOTH surfaces — there is no
-//       call to omit and no discretion to exercise.
-//   (b) the submitted prompt is MATCHED against the list and a warning comes
-//       back in the op result. Non-blocking: the generation proceeds
-//       (PRODUCT_PHILOSOPHY.md → make state visible, never block).
-//
-// 🚨 THE LIST IS NEVER HAND-TYPED HERE. It is extracted from the skill files
-// themselves, between `<!-- @banned:start -->` / `<!-- @banned:end -->`
-// markers. That is this workspace's LLM-docs doctrine — never hand-type a fact
-// an LLM will read — and it is the only way the op description and the skill
-// cannot drift apart. Change the skill; the description follows on the next
-// build. scripts/agent-surface-lockstep-check.mjs fails the build if a token
-// in a description no longer appears in its source skill.
-//
-// Deterministic by construction (document order, no sorting, no dedupe
-// reshuffle) because these strings land in the desktop's prompt-cached tool
-// prefix, whose byte-stability IS the cache mechanism.
-// ============================================================
-import { SKILLS } from '../skills/content.js';
-/**
- * Where each scope's CROSS-MODEL list lives.
- *
- * One skill per scope on purpose: these are the two lists that are GENERIC to
- * their modality (Stable-Diffusion-era tag soup for images, quality
- * incantations for video), not model-specific quirks. A per-model list cannot
- * ride the op DESCRIPTION — a description is one static string for every call,
- * so it cannot change with the `model` argument. That is what
- * `bannedTokensForSkill` below is for: the per-model list rides the estimate
- * RESULT, where the model has just been named.
- */
-const BANNED_TOKEN_SOURCES = [
-    { skill: 'slates-prompting-nano-banana-2', scope: 'image' },
-    { skill: 'slates-prompting-seedance', scope: 'video' },
-];
-/**
- * 🚨 THE ENFORCEMENT THAT WORKED COVERED TWO SKILLS OF FIFTEEN.
- *
- * `describeBannedTokens('image')` was Nano Banana's list and `('video')` was
- * Seedance's, so a Veo, Kling, LTX, MiniMax, FLUX, Seedream, GPT-Image or audio
- * generation was matched against another model's never-use list and its own was
- * enforced by nothing — while four skills (content-policy, lip-sync,
- * minimax-h3, motion-transfer) carried never-use prose with no markers at all,
- * which is a rule an LLM has to notice.
- *
- * Every skill that carries an `@banned` block now contributes to a per-skill
- * list, delivered on the estimate result beside the craft card. The two above
- * stay ALSO on the op descriptions, because a modality-wide list is true of
- * every call that op can make.
- */
-function extractPerSkill() {
-    const out = new Map();
-    for (const [skill, content] of Object.entries(SKILLS)) {
-        // Cheap pre-test: only pay the regex for files that carry the marker.
-        if (!content.includes('@banned:start'))
-            continue;
-        const scope = inferScope(skill);
-        out.set(skill, extractFromSkill(skill).map((token) => ({ token, skill, scope })));
-    }
-    return out;
-}
-/** Image-lane skills prompt for pixels; everything else is a time-based lane.
- *  Only used to tag a token for the warning text — the per-skill list is
- *  matched by SKILL, never by scope, so a wrong guess here cannot mis-enforce. */
-function inferScope(skill) {
-    return /nano-banana|gpt-image|flux|seedream/.test(skill) ? 'image' : 'video';
-}
-const FENCE_RE = /<!--\s*@banned:start\s*-->([\s\S]*?)<!--\s*@banned:end\s*-->/g;
-const HTML_COMMENT_RE = /<!--[\s\S]*?-->/g;
-const BACKTICKED_RE = /`([^`\n]+)`/g;
-/**
- * Pull every backticked phrase out of a skill's fenced block(s).
- *
- * HTML comments are stripped FIRST: the fence carries a "MACHINE-READ" note to
- * whoever edits the skill next, and that note itself contains backticks.
+/** Model-specific prompt advice, extracted from each skill's @banned blocks.
+ * Warnings never rewrite or block a prompt. No model's list is universal.
  */
-function extractFromSkill(skill) {
-    const content = SKILLS[skill];
-    if (content === undefined) {
-        throw new Error(`[banned-tokens] no such skill: ${skill}. BANNED_TOKEN_SOURCES must name files in packages/shared/skills/.`);
-    }
-    const out = [];
-    let fence;
-    FENCE_RE.lastIndex = 0;
-    let fences = 0;
-    while ((fence = FENCE_RE.exec(content)) !== null) {
-        fences += 1;
-        const body = fence[1].replace(HTML_COMMENT_RE, '');
-        let m;
-        BACKTICKED_RE.lastIndex = 0;
-        while ((m = BACKTICKED_RE.exec(body)) !== null) {
-            const token = m[1].trim();
-            if (token && !out.includes(token))
-                out.push(token);
-        }
-    }
-    if (fences === 0) {
-        throw new Error(`[banned-tokens] ${skill}.md has no <!-- @banned:start --> / <!-- @banned:end --> block. ` +
-            `The op description and the prompt warnings are GENERATED from it — restore the markers, ` +
-            `or drop the skill from BANNED_TOKEN_SOURCES.`);
-    }
-    if (out.length === 0) {
-        throw new Error(`[banned-tokens] ${skill}.md has a @banned block with no backticked tokens in it. ` +
-            `An empty list would silently disable the check instead of failing it.`);
-    }
-    return out;
-}
-/** Every banned token, in skill-document order. Integrity asserted at load. */
-export const BANNED_PROMPT_TOKENS = BANNED_TOKEN_SOURCES.flatMap(({ skill, scope }) => extractFromSkill(skill).map((token) => ({ token, skill, scope })));
-const byScope = new Map();
-for (const entry of BANNED_PROMPT_TOKENS) {
-    const list = byScope.get(entry.scope) ?? [];
-    list.push(entry);
-    byScope.set(entry.scope, list);
-}
-export function bannedTokensFor(scope) {
-    return byScope.get(scope) ?? [];
-}
-/** Regex cache — one word-boundary matcher per token, built once. */
+import { SKILLS } from '../skills/content.js';
+const bySkill = new Map();
+for (const [skill, content] of Object.entries(SKILLS)) {
+    const fences = [...content.matchAll(/<!--\s*@banned:start\s*-->([\s\S]*?)<!--\s*@banned:end\s*-->/g)];
+    if (!fences.length)
+        continue;
+    const tokens = [...new Set(fences.flatMap((f) => [...f[1].replace(/<!--[\s\S]*?-->/g, '').matchAll(/`([^`\n]+)`/g)].map((m) => m[1].trim())))];
+    if (!tokens.length)
+        throw new Error(`${skill}: @banned block contains no tokens`);
+    const scope = /nano-banana|gpt-image|flux|seedream/.test(skill) ? 'image' : 'video';
+    bySkill.set(skill, tokens.map((token) => ({ token, skill, scope })));
+}
+/** Compatibility exports: there is no cross-model blacklist. */
+export const BANNED_PROMPT_TOKENS = Object.freeze([]);
+export function bannedTokensFor(_scope) { return BANNED_PROMPT_TOKENS; }
+export function describeBannedTokens(_scope) { return ''; }
+export function bannedTokensForSkill(skill) { return bySkill.get(skill) ?? []; }
 const matchers = new Map();
 function matcherFor(token) {
-    let re = matchers.get(token);
-    if (!re) {
+    let matcher = matchers.get(token);
+    if (!matcher) {
         const escaped = token.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        // \b at both ends so `4k` does not fire inside "84king" and `flawless`
-        // does not fire inside "flawlessly". Every token starts and ends with a
-        // word character today; if one ever starts with punctuation, \b would
-        // anchor wrong — the load-time check below is what would catch it.
-        re = new RegExp(`\\b${escaped}\\b`, 'i');
-        matchers.set(token, re);
-    }
-    return re;
-}
-for (const { token, skill } of BANNED_PROMPT_TOKENS) {
-    if (!/^\w/.test(token) || !/\w$/.test(token)) {
-        throw new Error(`[banned-tokens] ${skill}: token ${JSON.stringify(token)} does not start and end with a word ` +
-            `character, so the \\b word-boundary match would never fire. Rewrite the entry or teach ` +
-            `matcherFor() the new shape.`);
+        matcher = new RegExp(`(?<!\\w)${escaped}(?!\\w)`, 'i');
+        matchers.set(token, matcher);
     }
+    return matcher;
 }
-/** Every per-skill list, keyed by skill name. */
-const bySkill = extractPerSkill();
-/** The never-use list a single skill declares. Empty for a skill with no block. */
-export function bannedTokensForSkill(skill) {
-    return bySkill.get(skill) ?? [];
+export function findBannedTokens(prompt, _scope, skill) {
+    return skill ? bannedTokensForSkill(skill).filter((b) => matcherFor(b.token).test(prompt)) : [];
 }
-/**
- * A single model's never-use list, for the estimate RESULT.
- *
- * Deliberately NOT the cross-model list — that one already rides the op
- * description on every call. This is the half that could not: the quirk that is
- * true of Veo and false of Kling.
- */
 export function describeBannedTokensForSkill(skill) {
     const list = bannedTokensForSkill(skill);
-    if (list.length === 0)
-        return '';
-    return (`NEVER put these in a ${skill.replace('slates-prompting-', '')} prompt: ` +
-        list.map((b) => `"${b.token}"`).join(', ') +
-        `. Describe specifically instead (${skill}).`);
+    return list.length ? `Avoid these phrases for ${skill}: ${list.map((b) => `"${b.token}"`).join(', ')}. Describe the intended result specifically.` : '';
 }
-/** The tokens a submitted prompt actually contains. `skill` adds that model's
- *  own list to the modality-wide one — the two overlap for nano-banana-2 and
- *  seedance, so hits are deduplicated by token. */
-export function findBannedTokens(prompt, scope, skill) {
-    const candidates = [...bannedTokensFor(scope), ...(skill ? bannedTokensForSkill(skill) : [])];
-    const seen = new Set();
-    const hits = [];
-    for (const b of candidates) {
-        if (seen.has(b.token))
-            continue;
-        seen.add(b.token);
-        if (matcherFor(b.token).test(prompt))
-            hits.push(b);
-    }
-    return hits;
-}
-/**
- * The list as it appears INSIDE an op description — always in context, on both
- * surfaces, with no call required to see it. Generated, never hand-typed.
- */
-export function describeBannedTokens(scope) {
-    const list = bannedTokensFor(scope);
-    if (list.length === 0)
-        return '';
-    const skills = [...new Set(list.map((b) => b.skill))].join(' / ');
-    return (`NEVER put these in a prompt (they measurably degrade output — full rationale in ${skills}): ` +
-        list.map((b) => `"${b.token}"`).join(', ') +
-        `. Describe specifically instead.`);
-}
-/**
- * Non-blocking warning for a submitted prompt. Empty string when clean.
- *
- * Returned in the op RESULT — the one place the agent cannot avoid reading —
- * rather than raised as an error. The generation proceeds either way: the
- * sandbox doctrine says make state visible, never block.
- */
 export function bannedTokenWarning(prompt, scope, skill) {
     const hits = findBannedTokens(prompt, scope, skill);
-    if (hits.length === 0)
+    if (!hits.length)
         return '';
-    const skills = [...new Set(hits.map((b) => b.skill))].join(', ');
-    return (`⚠️ PROMPT WARNING: your prompt contains ${hits.map((b) => `"${b.token}"`).join(', ')} — ` +
-        `on the never-use list in ${skills}. Not blocked, and this generation ran as submitted. ` +
-        `Load that guide with slates_get_prompting_guide and rewrite with specific description ` +
-        `(named lens, light direction, stock, composition) before the next generation.`);
+    return `⚠️ PROMPT WARNING: ${hits.map((b) => `"${b.token}"`).join(', ')} appear in ${skill}'s avoid list. This warning does not change or block your prompt. Describe the intended result specifically; query that guide for details.`;
 }
 //# sourceMappingURL=banned-tokens.js.map

package/dist/prompts/craft-cards.js

@@ -57,7 +57,7 @@ function extractCard(skill, content) {
     if (body.length > CRAFT_CARD_CEILING) {
         throw new Error(`[craft-cards] ${skill}.md's @card block is ${body.length} chars, over the ` +
             `${CRAFT_CARD_CEILING} ceiling. A card rides EVERY estimate result for that model — ` +
-            `move the overflow into the body of the skill, which slates_get_prompting_guide returns whole.`);
+            `move the overflow into the body of the skill, retrieved with slates_get_prompting_guide depth: full.`);
     }
     return body;
 }
@@ -77,6 +77,6 @@ export function describeCraftCard(skill) {
     const card = craftCard(skill);
     if (!card)
         return '';
-    return `${card}\n\nFull guide (examples, failure modes, sources): slates_get_prompting_guide("${skill}").`;
+    return `${card}\n\nFull guide (examples, failure modes, sources): slates_get_prompting_guide({topic: "${skill}", depth: "full"}); use query for one section.`;
 }
 //# sourceMappingURL=craft-cards.js.map