@alisaitteke/photoshop-mcp 1.7.21 → 1.7.23

package/dist/ui/intent/router.js

@@ -0,0 +1,146 @@
+import { BLEND_MODES, INSTANT_INTENTS, OTHER_DESCRIPTION, OTHER_INTENT, findIntent, humanBlendMode, } from './catalog.js';
+export const THRESHOLDS = {
+    /** Intent confidence needed to skip the LLM. Docs suggest ~0.85 for acting directly. */
+    instant: 0.85,
+    /** A slot value (number, blend mode) must be at least this sure. */
+    slot: 0.7,
+    /** P(multi-step) must stay below this for instant. */
+    multiStepMax: 0.3,
+    /** Below this P(actionable) we ask a question first. */
+    clarifyBelow: 0.35,
+    /** Above this P(needs visual) the agent loop with previews is used. */
+    visualMin: 0.6,
+    /** Above this P(multi-step) the Action Plan is used. */
+    planMin: 0.5,
+};
+const NONE = 'none';
+/** Candidate numbers for the pre-parsed value pattern: Jev picks one, code parses it. */
+export function extractNumbers(prompt) {
+    const found = prompt.match(/\d{1,4}(?:[.,]\d+)?/g) ?? [];
+    return [...new Set(found.map((n) => n.replace(',', '.')))].slice(0, 12);
+}
+export function buildQuestions(prompt) {
+    const intents = {};
+    for (const intent of INSTANT_INTENTS)
+        intents[intent.id] = intent.describe;
+    intents[OTHER_INTENT] = OTHER_DESCRIPTION;
+    const blendModes = {};
+    for (const mode of BLEND_MODES)
+        blendModes[mode] = humanBlendMode(mode);
+    blendModes[NONE] = 'No blend mode is named.';
+    const questions = {
+        intent: {
+            type: 'choice',
+            instructions: 'The `request` is what a user typed to control Adobe Photoshop. Which single command is it? Pick `other` if it asks for more than one change or for anything not listed.',
+            criteria: intents,
+        },
+        multi_step: {
+            type: 'noul',
+            instructions: 'Does the `request` ask for more than one separate edit or operation?',
+        },
+        needs_visual: {
+            type: 'noul',
+            instructions: 'To carry out the `request`, would someone have to look at the image first to decide what to change (for example "make it look better" or "fix what looks off")?',
+        },
+        actionable: {
+            type: 'noul',
+            instructions: 'Is the `request` specific enough to carry out without asking the user a follow-up question?',
+        },
+        blend_mode: {
+            type: 'choice',
+            instructions: 'Which layer blend mode does the `request` name, if any?',
+            criteria: blendModes,
+        },
+    };
+    const numbers = extractNumbers(prompt);
+    if (numbers.length > 0) {
+        const criteria = (instructions) => {
+            const options = {};
+            for (const n of numbers)
+                options[n] = null;
+            options[NONE] = 'None of these numbers is that value.';
+            return { type: 'choice', instructions, criteria: options };
+        };
+        questions.opacity_value = criteria('Which of these numbers is the layer opacity the `request` asks for?');
+        questions.count_value = criteria('Which of these numbers is how many steps the `request` wants to undo or redo?');
+    }
+    return questions;
+}
+function choiceOf(answers, key) {
+    const a = answers[key];
+    return a && typeof a.choice === 'string' && typeof a.confidence === 'number'
+        ? { choice: a.choice, confidence: a.confidence }
+        : null;
+}
+function noulOf(answers, key, fallback) {
+    const a = answers[key];
+    return a && typeof a.noul === 'number' ? a.noul : fallback;
+}
+function resolveSlots(answers) {
+    const slots = {};
+    const blend = choiceOf(answers, 'blend_mode');
+    if (blend && blend.choice !== NONE && blend.confidence >= THRESHOLDS.slot)
+        slots.blendMode = blend.choice;
+    const opacity = choiceOf(answers, 'opacity_value');
+    if (opacity && opacity.choice !== NONE && opacity.confidence >= THRESHOLDS.slot) {
+        const n = Number(opacity.choice);
+        if (Number.isFinite(n) && n >= 0 && n <= 100)
+            slots.opacity = Math.round(n);
+    }
+    const count = choiceOf(answers, 'count_value');
+    if (count && count.choice !== NONE && count.confidence >= THRESHOLDS.slot) {
+        const n = Number(count.choice);
+        if (Number.isInteger(n) && n >= 1 && n <= 50)
+            slots.count = n;
+    }
+    return slots;
+}
+/** Pure decision logic: Jev answers in, route out. */
+export function decide(answers, meta) {
+    const intentAnswer = choiceOf(answers, 'intent') ?? { choice: OTHER_INTENT, confidence: 0 };
+    const signals = {
+        multiStep: noulOf(answers, 'multi_step', 0.5),
+        needsVisual: noulOf(answers, 'needs_visual', 0),
+        actionable: noulOf(answers, 'actionable', 1),
+    };
+    const base = { intent: intentAnswer.choice, confidence: intentAnswer.confidence, signals, ...meta };
+    const intent = findIntent(intentAnswer.choice);
+    if (intent && !intent.risky && intentAnswer.confidence >= THRESHOLDS.instant && signals.multiStep < THRESHOLDS.multiStepMax) {
+        const slots = resolveSlots(answers);
+        const missing = (intent.requires ?? []).filter((slot) => slots[slot] === undefined);
+        if (missing.length === 0) {
+            const label = intent.describeCall?.(slots) ?? intent.label;
+            return {
+                ...base,
+                route: 'instant',
+                label,
+                call: { tool: intent.tool, args: intent.args(slots), preview: Boolean(intent.preview), label },
+                reason: 'One known command; runs directly without a language model call.',
+            };
+        }
+    }
+    if (signals.actionable < THRESHOLDS.clarifyBelow) {
+        return { ...base, route: 'clarify', label: 'Ask first', reason: 'Too vague to act on safely; the model asks one question first.' };
+    }
+    if (signals.needsVisual >= THRESHOLDS.visualMin) {
+        return { ...base, route: 'agent', label: 'Look & iterate', reason: 'Needs to look at the image; the model gets previews as it works.' };
+    }
+    if (intent?.risky) {
+        return { ...base, route: 'plan', label: 'Plan', reason: `${intent.label} is hard to undo, so it goes through a plan.` };
+    }
+    return {
+        ...base,
+        route: 'plan',
+        label: 'Plan',
+        reason: signals.multiStep >= THRESHOLDS.planMin
+            ? 'Several operations; one planning call, then the steps run directly.'
+            : 'Not a single known command; the model plans it.',
+    };
+}
+export async function classifyIntent(prompt, client, options = {}) {
+    const now = options.now ?? Date.now;
+    const started = now();
+    const result = await client.systemOne({ state: { request: prompt.slice(0, 2000) }, questions: buildQuestions(prompt) }, { signal: options.signal, timeout: options.timeoutMs });
+    return decide(result.answers, { latencyMs: Math.max(0, now() - started), model: result.model });
+}
+//# sourceMappingURL=router.js.map

package/dist/ui/intent/router.js.map

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

package/dist/ui/intent/service.d.ts

@@ -0,0 +1,55 @@
+import { type IntentRouterConfig } from '../config.js';
+import { type IntentDecision, type IntentRoute } from './router.js';
+type Env = Record<string, string | undefined>;
+export type KeySource = 'settings' | 'env' | null;
+export interface IntentRouterStatus {
+    /** Routing will run for the next message. */
+    active: boolean;
+    enabled: boolean;
+    instant: boolean;
+    hasApiKey: boolean;
+    apiKeyMasked: string | null;
+    source: KeySource;
+    /** PSMCP_INTENT_ROUTER=off forces routing off regardless of settings. */
+    disabledByEnv: boolean;
+}
+export declare function resolveApiKey(cfg: IntentRouterConfig, env: Env): {
+    key?: string;
+    source: KeySource;
+};
+export declare function computeStatus(cfg: IntentRouterConfig, env: Env): IntentRouterStatus;
+export declare function getIntentRouterStatus(): IntentRouterStatus;
+export declare function isIntentRouterEnabled(): boolean;
+/** With instant commands switched off, a would-be instant route goes through a plan. */
+export declare function applyInstantSetting(decision: IntentDecision, instantAllowed: boolean): IntentDecision;
+/** Drop the cached client and decisions, e.g. after the key or settings change. */
+export declare function resetIntentRouter(): void;
+/**
+ * Classify a prompt. Results are cached briefly so the decision shown while
+ * typing is reused when the message is sent. Returns null when routing is off.
+ */
+export declare function routeIntent(prompt: string, signal?: AbortSignal): Promise<{
+    decision: IntentDecision;
+    cached: boolean;
+} | null>;
+export interface KeyCheckResult {
+    ok: boolean;
+    latencyMs?: number;
+    model?: string;
+    error?: string;
+}
+/** One tiny request (a single yes/no question) to prove the key works and measure latency. */
+export declare function checkTypeSafeKey(apiKey?: string): Promise<KeyCheckResult>;
+/** What the browser sees: no tool arguments, just the decision. */
+export interface RouteView {
+    route: IntentRoute;
+    label: string;
+    intent: string;
+    confidence: number;
+    latencyMs: number;
+    model: string;
+    reason: string;
+}
+export declare function toRouteView(decision: IntentDecision): RouteView;
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/ui/intent/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/ui/intent/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAwB,MAAM,aAAa,CAAC;AAiB1G,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,IAAI,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,yEAAyE;IACzE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,GAAG,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAMpG;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,GAAG,GAAG,kBAAkB,CAcnF;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,GAAG,cAAc,CAUrG;AAkBD,mFAAmF;AACnF,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAMD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAoB/D;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,8FAA8F;AAC9F,wBAAsB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAc/E;AAED,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAU/D"}

package/dist/ui/intent/service.js

@@ -0,0 +1,150 @@
+import { getIntentRouterConfig, maskApiKey } from '../config.js';
+import { classifyIntent } from './router.js';
+/**
+ * Jev routing is opt-in. The key is set in Settings → Routing (stored with the
+ * other provider keys in ~/.photoshop-mcp/data.db); TYPESAFE_API_KEY is only a
+ * fallback for headless setups. With no key, the UI behaves exactly as before.
+ * When routing is on, prompts are also sent to api.typesafe.ai.
+ */
+const REQUEST_TIMEOUT_MS = 2500;
+const VALIDATE_TIMEOUT_MS = 6000;
+const CACHE_TTL_MS = 5 * 60_000;
+const CACHE_MAX = 100;
+const cache = new Map();
+let client = null;
+export function resolveApiKey(cfg, env) {
+    const fromSettings = cfg.apiKey?.trim();
+    if (fromSettings)
+        return { key: fromSettings, source: 'settings' };
+    const fromEnv = env.TYPESAFE_API_KEY?.trim();
+    if (fromEnv)
+        return { key: fromEnv, source: 'env' };
+    return { source: null };
+}
+export function computeStatus(cfg, env) {
+    const { key, source } = resolveApiKey(cfg, env);
+    const flag = env.PSMCP_INTENT_ROUTER?.trim().toLowerCase();
+    const disabledByEnv = flag === 'off' || flag === '0' || flag === 'false';
+    const enabled = cfg.enabled !== false;
+    return {
+        active: Boolean(key) && enabled && !disabledByEnv,
+        enabled,
+        instant: cfg.instant !== false,
+        hasApiKey: Boolean(key),
+        apiKeyMasked: maskApiKey(key),
+        source,
+        disabledByEnv,
+    };
+}
+export function getIntentRouterStatus() {
+    return computeStatus(getIntentRouterConfig(), process.env);
+}
+export function isIntentRouterEnabled() {
+    return getIntentRouterStatus().active;
+}
+/** With instant commands switched off, a would-be instant route goes through a plan. */
+export function applyInstantSetting(decision, instantAllowed) {
+    if (instantAllowed || decision.route !== 'instant')
+        return decision;
+    const rest = { ...decision };
+    delete rest.call;
+    return {
+        ...rest,
+        route: 'plan',
+        label: 'Plan',
+        reason: 'Instant commands are off in Settings, so the model plans it.',
+    };
+}
+async function createClient(apiKey, timeout, maxRetries) {
+    const { TypeSafeClient } = await import('@typesafe-ai/sdk');
+    return new TypeSafeClient({ apiKey, timeout, retry: { maxRetries }, logLevel: 'off' });
+}
+function getClient(apiKey) {
+    if (!client || client.key !== apiKey) {
+        const promise = createClient(apiKey, REQUEST_TIMEOUT_MS, 1);
+        promise.catch(() => {
+            if (client?.promise === promise)
+                client = null;
+        });
+        client = { key: apiKey, promise };
+    }
+    return client.promise;
+}
+/** Drop the cached client and decisions, e.g. after the key or settings change. */
+export function resetIntentRouter() {
+    client = null;
+    cache.clear();
+}
+function cacheKey(prompt) {
+    return prompt.trim().replace(/\s+/g, ' ').toLowerCase();
+}
+/**
+ * Classify a prompt. Results are cached briefly so the decision shown while
+ * typing is reused when the message is sent. Returns null when routing is off.
+ */
+export async function routeIntent(prompt, signal) {
+    const cfg = getIntentRouterConfig();
+    const status = computeStatus(cfg, process.env);
+    if (!status.active)
+        return null;
+    const { key } = resolveApiKey(cfg, process.env);
+    const normalized = cacheKey(prompt);
+    if (!key || !normalized)
+        return null;
+    const hit = cache.get(normalized);
+    if (hit && Date.now() - hit.at < CACHE_TTL_MS) {
+        return { decision: applyInstantSetting(hit.decision, status.instant), cached: true };
+    }
+    const decision = await classifyIntent(prompt, await getClient(key), { signal, timeoutMs: REQUEST_TIMEOUT_MS });
+    cache.set(normalized, { at: Date.now(), decision });
+    if (cache.size > CACHE_MAX) {
+        const oldest = cache.keys().next().value;
+        if (oldest !== undefined)
+            cache.delete(oldest);
+    }
+    return { decision: applyInstantSetting(decision, status.instant), cached: false };
+}
+function describeKeyError(err) {
+    const e = err;
+    if (e?.name === 'AuthenticationError' || e?.status === 401)
+        return 'The key was rejected. Check it in console.typesafe.ai.';
+    if (e?.name === 'PermissionDeniedError' || e?.status === 403)
+        return 'This key has no access to Jev yet (early access).';
+    if (e?.name === 'RateLimitError' || e?.status === 429)
+        return 'Rate limited by TypeSafe. Try again in a moment.';
+    if (e?.name === 'APITimeoutError')
+        return 'TypeSafe did not answer in time.';
+    if (e?.name === 'APIConnectionError')
+        return 'Could not reach api.typesafe.ai.';
+    return e?.message || 'Could not verify the key.';
+}
+/** One tiny request (a single yes/no question) to prove the key works and measure latency. */
+export async function checkTypeSafeKey(apiKey) {
+    const key = apiKey?.trim() || resolveApiKey(getIntentRouterConfig(), process.env).key;
+    if (!key)
+        return { ok: false, error: 'No key to check.' };
+    try {
+        const probe = await createClient(key, VALIDATE_TIMEOUT_MS, 0);
+        const started = Date.now();
+        const result = await probe.systemOne({
+            state: { request: 'undo' },
+            questions: { ping: { type: 'noul', instructions: 'Is the `request` about Photoshop?' } },
+        });
+        return { ok: true, latencyMs: Date.now() - started, model: result.model };
+    }
+    catch (err) {
+        return { ok: false, error: describeKeyError(err) };
+    }
+}
+export function toRouteView(decision) {
+    return {
+        route: decision.route,
+        label: decision.label,
+        intent: decision.intent,
+        confidence: decision.confidence,
+        latencyMs: decision.latencyMs,
+        model: decision.model,
+        reason: decision.reason,
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/ui/intent/service.js.map

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

package/dist/ui/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ui/server.ts"],"names":[],"mappings":"AAmFA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAglB5E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ui/server.ts"],"names":[],"mappings":"AA8FA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwpB5E"}

package/dist/ui/server.js

@@ -7,8 +7,10 @@ import { fileURLToPath } from 'node:url';
 import { capture, captureBetaChatTurn, ensureAnalyticsIdentity, getAnalyticsRuntimeConfig, identifyUiModelSelection, resetAnalyticsProvider, setBetaTelemetryChoice, shutdownAnalytics, } from '../analytics/index.js';
 import { setAnalyticsOptOut } from '../analytics/identity.js';
 import { Logger } from '../utils/logger.js';
+import { deletePreviewImages, readPreviewImage } from './store/previews.js';
+import { checkTypeSafeKey, getIntentRouterStatus, isIntentRouterEnabled, resetIntentRouter, routeIntent, toRouteView, } from './intent/service.js';
 import { buildHistory, runChat, } from './agent.js';
-import { deleteCustomProvider, getAuthMethod, getCustomProvider, getProviderConfig, isProviderConfigAuthenticated, loadConfig, maskApiKey, saveConfig, saveCustomProvider, setProviderConfig, } from './config.js';
+import { deleteCustomProvider, getAuthMethod, getCustomProvider, getProviderConfig, isProviderConfigAuthenticated, loadConfig, maskApiKey, saveConfig, saveCustomProvider, setIntentRouterConfig, setProviderConfig, } from './config.js';
 import { getProvider, listProviders } from './providers/registry.js';
 import { createSessionToken, extractRequestToken, matchesSessionToken, removeSessionFile, SESSION_TOKEN_HEADER, writeSessionFile, } from './security/session-token.js';
 import { appendMessage, createChat, deleteChat, getChat, getMessages, listChats, renameChat, updateChatModel, } from './store/chats.js';
@@ -118,8 +120,59 @@ export async function startUIServer(opts) {
             apiKeyMasked: maskApiKey(active?.apiKey),
             accountLabel: active?.cliAccountLabel ?? null,
             actionPlanBeta: Boolean(config.actionPlanBeta),
+            intentRouter: { enabled: isIntentRouterEnabled() },
         });
     });
+    // ---- Jev intent routing settings (Settings → Routing) --------------------
+    app.get('/api/intent-router', (c) => c.json(getIntentRouterStatus()));
+    app.post('/api/intent-router/validate', async (c) => {
+        const body = (await c.req.json().catch(() => ({})));
+        return c.json(await checkTypeSafeKey(typeof body.apiKey === 'string' ? body.apiKey : undefined));
+    });
+    app.post('/api/intent-router/key', async (c) => {
+        const body = (await c.req.json().catch(() => ({})));
+        const apiKey = typeof body.apiKey === 'string' ? body.apiKey.trim() : '';
+        if (!apiKey)
+            return c.json({ error: 'missing_api_key' }, 400);
+        // Saving a key means "use it": switch Auto route back on.
+        setIntentRouterConfig({ apiKey, enabled: true });
+        resetIntentRouter();
+        return c.json(getIntentRouterStatus());
+    });
+    app.delete('/api/intent-router/key', (c) => {
+        setIntentRouterConfig({ apiKey: null });
+        resetIntentRouter();
+        return c.json(getIntentRouterStatus());
+    });
+    app.post('/api/intent-router/settings', async (c) => {
+        const body = (await c.req.json().catch(() => ({})));
+        setIntentRouterConfig({
+            ...(typeof body.enabled === 'boolean' ? { enabled: body.enabled } : {}),
+            ...(typeof body.instant === 'boolean' ? { instant: body.instant } : {}),
+        });
+        resetIntentRouter();
+        return c.json(getIntentRouterStatus());
+    });
+    // Jev intent preview while the user types. Off unless a TypeSafe key is set.
+    app.post('/api/intent', async (c) => {
+        if (!isIntentRouterEnabled())
+            return c.json({ enabled: false });
+        const body = (await c.req.json().catch(() => ({})));
+        const prompt = typeof body.prompt === 'string' ? body.prompt.trim() : '';
+        if (prompt.length < 3)
+            return c.json({ enabled: true, decision: null });
+        try {
+            const routed = await routeIntent(prompt, c.req.raw.signal);
+            return c.json({
+                enabled: true,
+                decision: routed ? toRouteView(routed.decision) : null,
+                cached: routed?.cached ?? false,
+            });
+        }
+        catch (err) {
+            return c.json({ enabled: true, decision: null, error: err.message });
+        }
+    });
     app.post('/api/config/action-plan', async (c) => {
         const body = await c.req.json().catch(() => ({}));
         const next = saveConfig({ actionPlanBeta: Boolean(body.enabled) });
@@ -365,9 +418,24 @@ export async function startUIServer(opts) {
         return c.json({ ok: true });
     });
     app.delete('/api/chats/:id', (c) => {
-        deleteChat(c.req.param('id'));
+        const id = c.req.param('id');
+        deleteChat(id);
+        deletePreviewImages(id);
         return c.json({ ok: true });
     });
+    // Tool images (photoshop_get_preview) are stored per chat on disk; the browser
+    // fetches them with the session token and shows them as object URLs.
+    app.get('/api/chats/:id/previews/:file', (c) => {
+        const image = readPreviewImage(c.req.param('id'), c.req.param('file'));
+        if (!image)
+            return c.json({ error: 'not_found' }, 404);
+        return new Response(new Uint8Array(image.bytes), {
+            headers: {
+                'content-type': image.mimeType,
+                'cache-control': 'private, max-age=31536000, immutable',
+            },
+        });
+    });
     // ---- Chat streaming -----------------------------------------------------
     app.post('/api/chat', async (c) => {
         const body = await c.req.json().catch(() => ({}));
@@ -418,6 +486,7 @@ export async function startUIServer(opts) {
             let buffer = { text: '', toolCalls: [] };
             let lastFinish = null;
             let assistantPersisted = false;
+            let route;
             const persistAssistant = () => {
                 if (assistantPersisted)
                     return;
@@ -437,6 +506,7 @@ export async function startUIServer(opts) {
                         model: chat.model,
                         ...(buffer.reasoning ? { reasoning: buffer.reasoning } : {}),
                         ...(buffer.plan ? { plan: buffer.plan } : {}),
+                        ...(route ? { route } : {}),
                         ...(lastFinish?.usage ? { usage: lastFinish.usage } : {}),
                         ...(lastFinish?.cost ? { cost: lastFinish.cost } : {}),
                     },
@@ -478,6 +548,8 @@ export async function startUIServer(opts) {
                 for await (const ev of iterator) {
                     if (controller.signal.aborted)
                         break;
+                    if (ev.type === 'route')
+                        route = ev.payload;
                     await stream.writeSSE({ event: ev.type, data: JSON.stringify(ev.payload) });
                 }
                 persistAssistant();