@hyperdreamer/pi-webui 1.10.6 → 1.11.0-beta.1

package/dist/server/sessions/modelTierRegistry.js

@@ -0,0 +1,88 @@
+import { getSupportedThinkingLevels } from "@earendil-works/pi-ai";
+import { isKnownThinkingLevel } from "../../shared/thinkingLevels.js";
+import { MODEL_TIERS } from "../../shared/apiTypes.js";
+export { MODEL_TIERS } from "../../shared/apiTypes.js";
+export function isModelTier(value) {
+    return MODEL_TIERS.some((tier) => tier === value);
+}
+/** Default thinking-level lookup, delegating to Pi rather than a local table. */
+export function runtimeThinkingLevels(model) {
+    return model === undefined ? [] : getSupportedThinkingLevels(model);
+}
+/**
+ * Bind config intent to one currently available runtime model. This wrapper is
+ * deliberately synchronous: the session daemon's model runtime publishes a
+ * current catalog snapshot, and a request must fail closed against that
+ * snapshot rather than inventing a fallback while it refreshes.
+ */
+export function createModelTierRegistry(deps) {
+    return {
+        resolve(tier) {
+            const config = deps.loadConfig();
+            if (config.modelTiersError !== undefined) {
+                throw new Error(`model tier configuration is invalid: ${config.modelTiersError}`);
+            }
+            if (config.modelTiers === undefined) {
+                throw new Error("model tier configuration is missing");
+            }
+            const models = deps.models();
+            const resolved = resolveTier(tier, config.modelTiers, {
+                models,
+                supportedThinkingLevels: (model) => deps.supportedThinkingLevels(model),
+            });
+            const model = models.find((candidate) => candidate.provider === resolved.model.provider && candidate.id === resolved.model.id);
+            if (model === undefined) {
+                // This is defensive against a catalog changing between the resolution
+                // lookup and the runtime handoff. It is still a terminal resolution
+                // failure, never a neighbouring-tier substitution.
+                throw new Error(`tier ${tier} names unavailable model ${resolved.model.provider}/${resolved.model.id}`);
+            }
+            return { tier: resolved.tier, model, thinkingLevel: resolved.thinkingLevel };
+        },
+    };
+}
+function describeModel(model) {
+    return `${model.provider}/${model.id}`;
+}
+/**
+ * Resolve one tier, or throw explaining why not.
+ *
+ * Every failure is terminal by design. Substituting a neighbouring tier would
+ * silently run weaker or stronger work than the caller asked for, which is the
+ * exact failure the tier system exists to prevent.
+ */
+export function resolveTier(tier, ladder, deps) {
+    if (!isModelTier(tier))
+        throw new Error(`unknown tier: ${tier}`);
+    const entry = ladder[tier];
+    if (entry === undefined)
+        throw new Error(`tier ${tier} has no ladder entry`);
+    const available = deps.models.find((candidate) => candidate.provider === entry.model.provider && candidate.id === entry.model.id);
+    if (available === undefined) {
+        throw new Error(`tier ${tier} names unavailable model ${describeModel(entry.model)}`);
+    }
+    if (!isKnownThinkingLevel(entry.thinkingLevel)) {
+        throw new Error(`tier ${tier} names unknown thinking level ${entry.thinkingLevel}`);
+    }
+    const supported = deps.supportedThinkingLevels(available);
+    if (!supported.includes(entry.thinkingLevel)) {
+        throw new Error(`tier ${tier} names thinking level ${entry.thinkingLevel}, unsupported by ${describeModel(entry.model)}`);
+    }
+    return { tier, model: { ...entry.model }, thinkingLevel: entry.thinkingLevel };
+}
+/**
+ * Validate a complete ladder. Returns a reason rather than throwing, because a
+ * broken ladder is a reportable configuration state, not an exception path.
+ */
+export function validateLadder(ladder, deps) {
+    for (const tier of MODEL_TIERS) {
+        try {
+            resolveTier(tier, ladder, deps);
+        }
+        catch (error) {
+            return { valid: false, reason: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=modelTierRegistry.js.map

package/dist/server/sessions/modelTierRegistry.js.map

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

package/dist/server/sessions/modelTierSettingsRoutes.js

@@ -0,0 +1,36 @@
+import { parseModelTiersConfig } from "../../config.js";
+export function registerModelTierSettingsRoutes(app, service, prefix = "") {
+    app.get(`${prefix}/model-tiers`, async (_request, reply) => {
+        try {
+            return await service.inspect();
+        }
+        catch (error) {
+            return reply.code(400).send({ error: errorMessage(error) });
+        }
+    });
+    app.put(`${prefix}/model-tiers`, async (request, reply) => {
+        try {
+            return await service.replace(parseReplacement(request.body));
+        }
+        catch (error) {
+            return reply.code(400).send({ error: errorMessage(error) });
+        }
+    });
+}
+function parseReplacement(value) {
+    if (!isRecord(value))
+        throw new Error("Expected object body");
+    const unknownField = Object.keys(value).find((key) => key !== "ladder");
+    if (unknownField !== undefined)
+        throw new Error(`unknown field ${JSON.stringify(unknownField)}; expected exactly ladder`);
+    if (!Object.prototype.hasOwnProperty.call(value, "ladder"))
+        throw new Error("ladder is required");
+    return parseModelTiersConfig(value["ladder"], "request body ladder");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=modelTierSettingsRoutes.js.map

package/dist/server/sessions/modelTierSettingsRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelTierSettingsRoutes.js","sourceRoot":"","sources":["../../../src/server/sessions/modelTierSettingsRoutes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AASxD,MAAM,UAAU,+BAA+B,CAAC,GAAoB,EAAE,OAAsC,EAAE,MAAM,GAAG,EAAE;IACvH,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QACzD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAoB,GAAG,MAAM,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC3E,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;IACxE,IAAI,YAAY,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC;IAC1H,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAClG,OAAO,qBAAqB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/server/sessions/modelTierSettingsService.js

@@ -0,0 +1,100 @@
+import { MODEL_TIERS, } from "../../shared/apiTypes.js";
+import { resolveTier } from "./modelTierRegistry.js";
+/**
+ * Inspect and atomically replace the machine-global model-tier ladder against
+ * the daemon's latest authenticated model catalog.
+ *
+ * File access and runtime refresh remain dependency-injected so this boundary
+ * can be tested without starting the daemon or making network requests.
+ */
+export function createModelTierSettingsService(deps) {
+    const inspect = async () => {
+        const snapshot = await refreshedSnapshot();
+        return responseFor(deps.loadConfig(), snapshot);
+    };
+    return {
+        inspect,
+        replace: async (ladder) => {
+            const snapshot = await refreshedSnapshot();
+            const rows = validationRows(ladder, snapshot);
+            const invalidRows = MODEL_TIERS.filter((tier) => !rows[tier].valid);
+            if (invalidRows.length > 0) {
+                throw new Error(invalidRows.map((tier) => rows[tier].reason ?? `tier ${tier} is invalid`).join("; "));
+            }
+            await deps.saveConfig({ modelTiers: ladder });
+            return await inspect();
+        },
+    };
+    async function refreshedSnapshot() {
+        await deps.modelRuntime.refresh({ allowNetwork: false });
+        return deps.modelRuntime.getAvailableSnapshot();
+    }
+    function responseFor(config, models) {
+        const modelOptions = models.map((model) => modelOptionFor(model));
+        if (config.modelTiersError !== undefined) {
+            return {
+                contractVersion: 1,
+                configError: config.modelTiersError,
+                models: modelOptions,
+                rows: invalidRows(config.modelTiersError),
+                valid: false,
+            };
+        }
+        if (config.modelTiers === undefined) {
+            return {
+                contractVersion: 1,
+                models: modelOptions,
+                rows: invalidRows("model tier configuration is missing"),
+                valid: false,
+            };
+        }
+        const rows = validationRows(config.modelTiers, models);
+        return {
+            contractVersion: 1,
+            ladder: config.modelTiers,
+            models: modelOptions,
+            rows,
+            valid: MODEL_TIERS.every((tier) => rows[tier].valid),
+        };
+    }
+    function modelOptionFor(model) {
+        return {
+            model: { provider: model.provider, id: model.id },
+            ...(model.name === undefined ? {} : { name: model.name }),
+            thinkingLevels: [...deps.thinkingLevelsForModel(model)],
+        };
+    }
+    function validationRows(ladder, models) {
+        return {
+            economy: validationFor("economy", ladder, models),
+            fast: validationFor("fast", ladder, models),
+            standard: validationFor("standard", ladder, models),
+            advanced: validationFor("advanced", ladder, models),
+            capable: validationFor("capable", ladder, models),
+            frontier: validationFor("frontier", ladder, models),
+        };
+    }
+    function validationFor(tier, ladder, models) {
+        try {
+            resolveTier(tier, ladder, {
+                models,
+                supportedThinkingLevels: (model) => deps.thinkingLevelsForModel(model),
+            });
+            return { valid: true };
+        }
+        catch (error) {
+            return { valid: false, reason: error instanceof Error ? error.message : String(error) };
+        }
+    }
+    function invalidRows(reason) {
+        return {
+            economy: { valid: false, reason },
+            fast: { valid: false, reason },
+            standard: { valid: false, reason },
+            advanced: { valid: false, reason },
+            capable: { valid: false, reason },
+            frontier: { valid: false, reason },
+        };
+    }
+}
+//# sourceMappingURL=modelTierSettingsService.js.map

package/dist/server/sessions/modelTierSettingsService.js.map

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

package/dist/server/sessions/piSessionService.js

@@ -1,5 +1,6 @@
 import { statSync } from "node:fs";
 import { join } from "node:path";
+import { loadPiWebUiConfig } from "../../config.js";
 import { open, readFile, writeFile } from "node:fs/promises";
 import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createEditToolDefinition, defineTool, readStoredCredential, SessionManager, } from "@earendil-works/pi-coding-agent";
 import { projectBrowserMessage } from "../browserMessageProjection.js";
@@ -15,6 +16,7 @@ import { deterministicSessionName, fallbackSessionName, generateShortSessionName
 import { computeEditPreview } from "./editPreview.js";
 import { attachmentsToInlineImages, saveAttachmentsToWorkspace } from "./attachmentService.js";
 import { parsePromptAttachments } from "../../shared/promptAttachments.js";
+import { isKnownThinkingLevel } from "../../shared/thinkingLevels.js";
 import { SESSION_TREE_CUSTOM_INSTRUCTIONS_MAX_LENGTH, SESSION_UNREAD_LIMIT } from "../../shared/apiTypes.js";
 import { canonicalizeStoredCwd, cwdPathsEqual } from "../workingDirectory.js";
 import { createSpawnSessionToolDefinition } from "./spawnSessionTool.js";
@@ -24,6 +26,7 @@ import { planForceCleanup, planSessionCleanup, summarizeForceCleanupExecution, s
 import { SessionNotificationStore, } from "./sessionNotificationStore.js";
 import { plainTextTheme } from "./plainTextTheme.js";
 import { SessionUnreadStore } from "./sessionUnreadStore.js";
+import { createModelTierRegistry, isModelTier, runtimeThinkingLevels } from "./modelTierRegistry.js";
 const noopLogger = { info() { } };
 const DEFAULT_UNREAD_PUBLICATION_RETRY_MS = 1_000;
 const MAX_UNREAD_PUBLICATION_RETRY_MS = 30_000;
@@ -86,6 +89,15 @@ function requirePromptText(value) {
         throw new Error("Prompt text is required");
     return value;
 }
+function leadingTierDirective(prompt) {
+    const match = /^(?:\uFEFF)?\/tier-([^\s\r\n]+)(?:[ \t]*(?:\r?\n|$))/u.exec(prompt);
+    if (match === null)
+        return undefined;
+    const value = match[1];
+    if (value === undefined || !isModelTier(value))
+        throw new Error(`Unknown leading tier directive: /tier-${value ?? ""}`);
+    return value;
+}
 function parsePromptStreamingBehavior(value) {
     if (value === undefined)
         return undefined;
@@ -199,26 +211,30 @@ export function dismissSessionWarning(session, dismissId) {
 function defaultCreateAgentRuntime(createRuntime, options) {
     if (!(options.sessionManager instanceof SessionManager))
         throw new Error("Default runtime creation requires an SDK SessionManager");
-    const runtimeFactory = createRuntimeWithOneShotSessionOptions(createRuntime, options.initialModel, options.delegationToolsEnabled);
+    const runtimeFactory = createRuntimeWithOneShotSessionOptions(createRuntime, options.initialModel, options.initialThinkingLevel, options.delegationToolsEnabled);
     return createAgentSessionRuntime(runtimeFactory, {
         cwd: options.cwd,
         agentDir: options.agentDir,
         sessionManager: options.sessionManager,
     });
 }
-function createRuntimeWithOneShotSessionOptions(createRuntime, initialModel, delegationToolsEnabled) {
+function createRuntimeWithOneShotSessionOptions(createRuntime, initialModel, initialThinkingLevel, delegationToolsEnabled) {
     // These inputs belong only to the session being opened. A later runtime
     // replacement resolves its own model and delegation capability.
     let pendingInitialModel = initialModel;
+    let pendingInitialThinkingLevel = initialThinkingLevel;
     let pendingDelegationToolsEnabled = delegationToolsEnabled;
     return async (options) => {
         const model = pendingInitialModel;
+        const thinkingLevel = pendingInitialThinkingLevel;
         const toolsEnabled = pendingDelegationToolsEnabled;
         pendingInitialModel = undefined;
+        pendingInitialThinkingLevel = undefined;
         pendingDelegationToolsEnabled = undefined;
         return createRuntime({
             ...options,
             ...(model === undefined ? {} : { initialModel: model }),
+            ...(thinkingLevel === undefined ? {} : { initialThinkingLevel: thinkingLevel }),
             ...(toolsEnabled === undefined ? {} : { delegationToolsEnabled: toolsEnabled }),
         });
     };
@@ -231,7 +247,7 @@ export function createPiWebUiCustomToolDefinitions(cwd, delegationEnabled, spawn
     ];
 }
 function createDefaultRuntimeFactory(modelRuntime, sessionManagers, spawn, subsessions) {
-    return async ({ cwd, agentDir, sessionManager, sessionStartEvent, initialModel, delegationToolsEnabled }) => {
+    return async ({ cwd, agentDir, sessionManager, sessionStartEvent, initialModel, initialThinkingLevel, delegationToolsEnabled }) => {
         const services = await createAgentSessionServices({ cwd, agentDir, modelRuntime });
         const resolvedDelegationToolsEnabled = delegationToolsEnabled
             ?? await sessionAllowsDelegationTools(sessionManager, sessionManagers);
@@ -242,6 +258,7 @@ function createDefaultRuntimeFactory(modelRuntime, sessionManagers, spawn, subse
             customTools,
             ...(sessionStartEvent === undefined ? {} : { sessionStartEvent }),
             ...(initialModel === undefined ? {} : { model: initialModel }),
+            ...(initialThinkingLevel === undefined ? {} : { thinkingLevel: initialThinkingLevel }),
         });
         return { ...result, services, diagnostics: services.diagnostics };
     };
@@ -326,6 +343,17 @@ export class PiSessionService {
             read: (parentSessionId, sessionId, query, parentSessionFile) => this.readSubsession(parentSessionId, sessionId, query, parentSessionFile),
         });
         this.createAgentRuntime = deps.createAgentRuntime ?? defaultCreateAgentRuntime;
+        this.modelTierRegistry = deps.modelTierRegistry ?? createModelTierRegistry({
+            loadConfig: () => {
+                const loaded = loadPiWebUiConfig();
+                return {
+                    ...(loaded.config.modelTiers === undefined ? {} : { modelTiers: loaded.config.modelTiers }),
+                    ...(loaded.modelTiersError === undefined ? {} : { modelTiersError: loaded.modelTiersError }),
+                };
+            },
+            models: () => this.modelRuntime.getAvailableSnapshot(),
+            supportedThinkingLevels: runtimeThinkingLevels,
+        });
         this.workspaceActivity = deps.workspaceActivity;
         this.heartbeat = setInterval(() => { this.publishHeartbeats(); }, deps.heartbeatIntervalMs ?? 2000);
         this.commandService = new SessionCommandService((sessionId) => this.getActive(sessionId), (sessionId, text) => this.prompt(sessionId, text, undefined, undefined, { echoUserMessage: false }), events, {
@@ -522,6 +550,7 @@ export class PiSessionService {
     async startSession(cwd, options) {
         const active = await this.create(this.sessionManager.create(cwd, options.parentSession === undefined ? undefined : { parentSession: options.parentSession }), cwd, {
             ...(options.initialModel === undefined ? {} : { initialModel: options.initialModel }),
+            ...(options.initialThinkingLevel === undefined ? {} : { initialThinkingLevel: options.initialThinkingLevel }),
             ...(options.creationProvenance === undefined ? {} : { creationProvenance: options.creationProvenance }),
         });
         const { session } = active.runtime;
@@ -571,9 +600,24 @@ export class PiSessionService {
         const decision = await this.spawnTargets.resolveSpawnTarget(input.spawningCwd, input.cwd);
         if (!decision.allowed)
             throw spawnTargetError(decision);
+        let initialModel = input.model;
+        let initialThinkingLevel;
+        if (input.tier !== undefined) {
+            const echoedTier = leadingTierDirective(input.prompt);
+            if (echoedTier !== undefined && echoedTier !== input.tier) {
+                throw new Error(`Leading tier directive /tier-${echoedTier} disagrees with typed tier ${input.tier}`);
+            }
+            const resolved = this.modelTierRegistry.resolve(input.tier);
+            if (!isKnownThinkingLevel(resolved.thinkingLevel)) {
+                throw new Error(`tier ${input.tier} resolved to unknown thinking level ${resolved.thinkingLevel}`);
+            }
+            initialModel = resolved.model;
+            initialThinkingLevel = resolved.thinkingLevel;
+        }
         const created = await this.startSession(decision.cwd, {
             ...(input.parentSessionFile === undefined ? {} : { parentSession: input.parentSessionFile }),
-            ...(input.model === undefined ? {} : { initialModel: input.model }),
+            ...(initialModel === undefined ? {} : { initialModel }),
+            ...(initialThinkingLevel === undefined ? {} : { initialThinkingLevel }),
             creationProvenance: "tracked-subsession",
         });
         const parentSessionFile = nonEmptyString(input.parentSessionFile);
@@ -1899,6 +1943,7 @@ export class PiSessionService {
             sessionManager,
             delegationToolsEnabled,
             ...(options.initialModel === undefined ? {} : { initialModel: options.initialModel }),
+            ...(options.initialThinkingLevel === undefined ? {} : { initialThinkingLevel: options.initialThinkingLevel }),
         });
         const active = { runtime, unsubscribe: noop };
         let boundSession = runtime.session;