specrails-desktop 2.30.2 → 2.31.0

package/server/dist/mcp/tools/agents.js

@@ -5,35 +5,31 @@ const zod_1 = require("zod");
 const types_1 = require("./types");
 /**
  * Agents domain — agent PROFILES (declarative per-project routing config) and
- * the agents CATALOG (the `.claude/agents/*.md` definitions: read-only `sr-*`
- * upstream agents + user-authored `custom-*` agents, with AI generate/test/
+ * the provider-native agents CATALOG (read-only `sr-*` upstream agents +
+ * user-authored `custom-*` roles, with capability-gated AI generate/test/
  * iterative-refine on the custom ones).
  *
- * CLAUDE-ONLY: agent profiles are a Claude concept. On a project whose primary
- * provider (or any installed provider) is codex/gemini, rails force-null the
- * profile and the whole section is hidden client-side — creating profiles for a
- * non-Claude project is mostly inert. The server still validates against that
- * provider's adapter catalog. Prefer using this tool on Claude projects.
- *
  * Every operation is per-project (mounted at /api/projects/:projectId/profiles)
  * and is gated by SPECRAILS_AGENTS_SECTION — a disabled server 404s every route.
  *
  * The catalog `generate`, `test`, `refine_start`, and `refine_turn` actions
- * SPAWN the claude CLI and incur real cost (refine records ai_invocations and
- * streams agent_refine_* WS events). `refine_apply` / `update_custom` /
- * `delete_custom` / `create_custom` mutate `custom-*.md` files on disk.
+ * SPAWN the selected provider CLI and incur real cost when that adapter exposes
+ * a safe output-only/read-only policy (refine records ai_invocations and
+ * streams agent_refine_* WS events). Other actions read/write the provider's
+ * native custom-role artifact (`custom-*.md`, or Kimi
+ * `custom-<id>/SKILL.md`).
  */
 function agentsTools() {
     return [
         {
             name: 'specrails_agents',
             title: 'Agents (Profiles & Catalog)',
-            description: 'Manage agent PROFILES and the agents CATALOG for a project (Claude-only — profiles are inert on codex/gemini projects). ' +
+            description: 'Manage provider-aware agent PROFILES and the agents CATALOG for a project. Pass provider to target a non-primary installed provider. ' +
                 'PROFILE actions: list, get, resolve (preview which profile a rail would resolve to), create, update, delete (destructive — protected default/project-default cannot be deleted), ' +
-                'duplicate, rename, migrate (seed a default profile from installed sr-*.md frontmatter), analytics (per-profile metrics), core_version (specrails-core version + 4.1.0 profile-aware check). ' +
-                'CATALOG actions: catalog_list, catalog_get (full agent .md body), versions (custom agent edit history), create_custom (custom-*.md), update_custom, delete_custom (destructive), ' +
-                'generate (AI-generate a draft custom agent — spawns claude, costs), test (AI smoke-test a draft body — spawns claude, costs), ' +
-                'refine_start / refine_turn (AI iterative refine of a custom agent — spawn claude, cost, stream over WS), refine_list, refine_get, refine_patch (toggle autoTest), refine_cancel (kill the spawn), refine_apply (write the refined draft to disk).',
+                'duplicate, rename, migrate (seed a default profile from installed provider-native sr-* role frontmatter), analytics (per-profile metrics), core_version (specrails-core version + 4.1.0 profile-aware check). ' +
+                'CATALOG actions: catalog_list, catalog_get (full provider-native role body), versions (custom role edit history), create_custom, update_custom, delete_custom (destructive), ' +
+                'generate (AI-generate a draft custom role — selected provider spawn, costs), test (AI smoke-test a draft body — selected provider spawn, costs), ' +
+                'refine_start / refine_turn (AI iterative refine — selected provider spawn, cost, stream over WS), refine_list, refine_get, refine_patch (toggle autoTest), refine_cancel (kill the spawn), refine_apply (write the refined draft). AI automation is rejected when the provider lacks a safe none/read-only tool policy; Kimi custom roles remain manually editable.',
             hintTier: 'read',
             tier: (a) => {
                 const action = a.action;
@@ -92,11 +88,15 @@ function agentsTools() {
                 ])
                     .describe('Operation to perform (profile or catalog action)'),
                 projectId: zod_1.z.string().optional().describe('Project id (defaults to the active project)'),
+                provider: zod_1.z
+                    .string()
+                    .optional()
+                    .describe('Installed project provider to target (defaults to the project primary provider)'),
                 // Profile params
                 name: zod_1.z
                     .string()
                     .optional()
-                    .describe('Profile name (get/update/delete/duplicate/rename source). For duplicate/rename, the NEW name goes in `newName`.'),
+                    .describe("Profile name (get/update/delete/duplicate/rename source). For duplicate/rename, the NEW name goes in `newName`."),
                 newName: zod_1.z.string().optional().describe('New profile name (for duplicate / rename)'),
                 profileName: zod_1.z
                     .string()
@@ -128,39 +128,45 @@ function agentsTools() {
             async handler(ctx, args) {
                 const base = `${(0, types_1.projectPath)(ctx, args.projectId)}/profiles`;
                 const action = args.action;
+                const provider = args.provider;
+                const withProvider = (url) => {
+                    if (!provider)
+                        return url;
+                    return `${url}${url.includes('?') ? '&' : '?'}provider=${encodeURIComponent(provider)}`;
+                };
                 const agentId = args.agentId;
                 const refineId = args.refineId;
                 const profileName = args.name;
                 switch (action) {
                     // ── PROFILES ────────────────────────────────────────────────────
                     case 'list':
-                        return (0, types_1.apiCall)(ctx, 'GET', base);
+                        return (0, types_1.apiCall)(ctx, 'GET', withProvider(base));
                     case 'get': {
                         if (!profileName)
                             throw new Error('get requires a profile "name".');
-                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/${encodeURIComponent(profileName)}`);
+                        return (0, types_1.apiCall)(ctx, 'GET', withProvider(`${base}/${encodeURIComponent(profileName)}`));
                     }
                     case 'resolve': {
                         const p = args.profileName;
                         const qs = p ? `?profile=${encodeURIComponent(p)}` : '';
-                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/resolve${qs}`);
+                        return (0, types_1.apiCall)(ctx, 'GET', withProvider(`${base}/resolve${qs}`));
                     }
                     case 'create': {
                         if (!args.profile)
                             throw new Error('create requires a "profile" body.');
-                        return (0, types_1.apiCall)(ctx, 'POST', base, args.profile);
+                        return (0, types_1.apiCall)(ctx, 'POST', withProvider(base), args.profile);
                     }
                     case 'update': {
                         if (!profileName)
                             throw new Error('update requires a profile "name".');
                         if (!args.profile)
                             throw new Error('update requires a "profile" body (its name must equal "name").');
-                        return (0, types_1.apiCall)(ctx, 'PATCH', `${base}/${encodeURIComponent(profileName)}`, args.profile);
+                        return (0, types_1.apiCall)(ctx, 'PATCH', withProvider(`${base}/${encodeURIComponent(profileName)}`), args.profile);
                     }
                     case 'delete': {
                         if (!profileName)
                             throw new Error('delete requires a profile "name".');
-                        return (0, types_1.apiCall)(ctx, 'DELETE', `${base}/${encodeURIComponent(profileName)}`);
+                        return (0, types_1.apiCall)(ctx, 'DELETE', withProvider(`${base}/${encodeURIComponent(profileName)}`));
                     }
                     case 'duplicate': {
                         if (!profileName)
@@ -168,7 +174,7 @@ function agentsTools() {
                         const newName = args.newName;
                         if (!newName)
                             throw new Error('duplicate requires a "newName".');
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/${encodeURIComponent(profileName)}/duplicate`, { name: newName });
+                        return (0, types_1.apiCall)(ctx, 'POST', withProvider(`${base}/${encodeURIComponent(profileName)}/duplicate`), { name: newName });
                     }
                     case 'rename': {
                         if (!profileName)
@@ -176,10 +182,10 @@ function agentsTools() {
                         const newName = args.newName;
                         if (!newName)
                             throw new Error('rename requires a "newName".');
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/${encodeURIComponent(profileName)}/rename`, { name: newName });
+                        return (0, types_1.apiCall)(ctx, 'POST', withProvider(`${base}/${encodeURIComponent(profileName)}/rename`), { name: newName });
                     }
                     case 'migrate':
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/migrate-from-settings`);
+                        return (0, types_1.apiCall)(ctx, 'POST', withProvider(`${base}/migrate-from-settings`));
                     case 'analytics': {
                         const wd = args.windowDays;
                         const qs = typeof wd === 'number' ? `?windowDays=${wd}` : '';
@@ -189,16 +195,16 @@ function agentsTools() {
                         return (0, types_1.apiCall)(ctx, 'GET', `${base}/core-version`);
                     // ── CATALOG: definitions ────────────────────────────────────────
                     case 'catalog_list':
-                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/catalog`);
+                        return (0, types_1.apiCall)(ctx, 'GET', withProvider(`${base}/catalog`));
                     case 'catalog_get': {
                         if (!agentId)
                             throw new Error('catalog_get requires an "agentId".');
-                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/catalog/${encodeURIComponent(agentId)}`);
+                        return (0, types_1.apiCall)(ctx, 'GET', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}`));
                     }
                     case 'versions': {
                         if (!agentId)
                             throw new Error('versions requires an "agentId".');
-                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/catalog/${encodeURIComponent(agentId)}/versions`);
+                        return (0, types_1.apiCall)(ctx, 'GET', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}/versions`));
                     }
                     case 'create_custom': {
                         const id = args.agentName;
@@ -207,7 +213,7 @@ function agentsTools() {
                             throw new Error('create_custom requires an "agentName" (custom-* id).');
                         if (!body)
                             throw new Error('create_custom requires a "body".');
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/catalog`, { id, body });
+                        return (0, types_1.apiCall)(ctx, 'POST', withProvider(`${base}/catalog`), { id, body });
                     }
                     case 'update_custom': {
                         if (!agentId)
@@ -215,12 +221,12 @@ function agentsTools() {
                         const body = args.body;
                         if (!body)
                             throw new Error('update_custom requires a "body".');
-                        return (0, types_1.apiCall)(ctx, 'PATCH', `${base}/catalog/${encodeURIComponent(agentId)}`, { body });
+                        return (0, types_1.apiCall)(ctx, 'PATCH', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}`), { body });
                     }
                     case 'delete_custom': {
                         if (!agentId)
                             throw new Error('delete_custom requires an "agentId" (custom-* only).');
-                        return (0, types_1.apiCall)(ctx, 'DELETE', `${base}/catalog/${encodeURIComponent(agentId)}`);
+                        return (0, types_1.apiCall)(ctx, 'DELETE', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}`));
                     }
                     // ── CATALOG: AI spawns (cost) ───────────────────────────────────
                     case 'generate': {
@@ -230,7 +236,7 @@ function agentsTools() {
                             throw new Error('generate requires an "agentName" (custom-* id).');
                         if (!description)
                             throw new Error('generate requires a "description".');
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/catalog/generate`, { name, description });
+                        return (0, types_1.apiCall)(ctx, 'POST', withProvider(`${base}/catalog/generate`), { name, description });
                     }
                     case 'test': {
                         const draftBody = args.draftBody;
@@ -239,7 +245,7 @@ function agentsTools() {
                             throw new Error('test requires a "draftBody".');
                         if (!sampleTask)
                             throw new Error('test requires a "sampleTask".');
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/catalog/test`, {
+                        return (0, types_1.apiCall)(ctx, 'POST', withProvider(`${base}/catalog/test`), {
                             ...(agentId ? { agentId } : {}),
                             draftBody,
                             sampleTask,
@@ -252,7 +258,7 @@ function agentsTools() {
                         const instruction = args.instruction;
                         if (!instruction)
                             throw new Error('refine_start requires an "instruction".');
-                        const r = await (0, types_1.apiCall)(ctx, 'POST', `${base}/catalog/${encodeURIComponent(agentId)}/refine`, {
+                        const r = await (0, types_1.apiCall)(ctx, 'POST', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}/refine`), {
                             instruction,
                             ...(typeof args.autoTest === 'boolean' ? { autoTest: args.autoTest } : {}),
                         });
@@ -269,7 +275,7 @@ function agentsTools() {
                         const instruction = args.instruction;
                         if (!instruction)
                             throw new Error('refine_turn requires an "instruction".');
-                        const r = await (0, types_1.apiCall)(ctx, 'POST', `${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}/turn`, { instruction });
+                        const r = await (0, types_1.apiCall)(ctx, 'POST', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}/turn`), { instruction });
                         return {
                             ...r,
                             hint: 'The turn streams over WS (agent_refine_* events). Use refine_get with the refineId to read the updated draft.',
@@ -278,14 +284,14 @@ function agentsTools() {
                     case 'refine_list': {
                         if (!agentId)
                             throw new Error('refine_list requires an "agentId".');
-                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/catalog/${encodeURIComponent(agentId)}/refine`);
+                        return (0, types_1.apiCall)(ctx, 'GET', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}/refine`));
                     }
                     case 'refine_get': {
                         if (!agentId)
                             throw new Error('refine_get requires an "agentId".');
                         if (!refineId)
                             throw new Error('refine_get requires a "refineId".');
-                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}`);
+                        return (0, types_1.apiCall)(ctx, 'GET', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}`));
                     }
                     case 'refine_patch': {
                         if (!agentId)
@@ -294,21 +300,21 @@ function agentsTools() {
                             throw new Error('refine_patch requires a "refineId".');
                         if (typeof args.autoTest !== 'boolean')
                             throw new Error('refine_patch requires a boolean "autoTest".');
-                        return (0, types_1.apiCall)(ctx, 'PATCH', `${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}`, { autoTest: args.autoTest });
+                        return (0, types_1.apiCall)(ctx, 'PATCH', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}`), { autoTest: args.autoTest });
                     }
                     case 'refine_cancel': {
                         if (!agentId)
                             throw new Error('refine_cancel requires an "agentId".');
                         if (!refineId)
                             throw new Error('refine_cancel requires a "refineId".');
-                        return (0, types_1.apiCall)(ctx, 'DELETE', `${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}`);
+                        return (0, types_1.apiCall)(ctx, 'DELETE', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}`));
                     }
                     case 'refine_apply': {
                         if (!agentId)
                             throw new Error('refine_apply requires an "agentId".');
                         if (!refineId)
                             throw new Error('refine_apply requires a "refineId".');
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}/apply`, { ...(typeof args.force === 'boolean' ? { force: args.force } : {}) });
+                        return (0, types_1.apiCall)(ctx, 'POST', withProvider(`${base}/catalog/${encodeURIComponent(agentId)}/refine/${encodeURIComponent(refineId)}/apply`), { ...(typeof args.force === 'boolean' ? { force: args.force } : {}) });
                     }
                     default:
                         throw new Error(`Unknown action "${action}".`);

package/server/dist/mcp/tools/analytics.js

@@ -57,11 +57,11 @@ function analyticsTools() {
                 modelProvider: zod_1.z
                     .array(zod_1.z.string())
                     .optional()
-                    .describe('Providers index-aligned to model[] (scopes each model id to its provider so codex/gemini estimated cost does not merge into a claude bar)'),
+                    .describe('Providers index-aligned to model[] (scopes each model id to its provider so native or estimated costs from claude/codex/gemini/kimi do not merge into another provider\'s bar)'),
                 provider: zod_1.z
                     .array(zod_1.z.string())
                     .optional()
-                    .describe('Filter to these providers (e.g. claude, codex, gemini) (CSV)'),
+                    .describe('Filter to these providers (e.g. claude, codex, gemini, kimi) (CSV)'),
                 status: zod_1.z.enum(['success', 'failed', 'aborted']).optional().describe('Filter by invocation status'),
                 minCostUsd: zod_1.z.number().optional().describe('Only invocations costing at least this many USD'),
                 ticketId: zod_1.z.number().int().optional().describe('Scope to a single ticket id'),

package/server/dist/mcp/tools/loops.js

@@ -124,9 +124,9 @@ function loopsTools() {
                     .optional()
                     .describe('Model for run — validated against the chosen provider\'s catalog; omit for the provider default'),
                 reasoning_effort: zod_1.z
-                    .enum(['low', 'medium', 'high'])
+                    .enum(['minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'])
                     .optional()
-                    .describe('Reasoning-effort tier for run'),
+                    .describe('Provider-supported reasoning-effort tier for run; Kimi K3 supports low/high/max'),
                 loops: zod_1.z.array(zod_1.z.unknown()).optional().describe('Array of loop export envelopes (for import)'),
             },
             async handler(ctx, args) {

package/server/dist/mcp/tools/plugins.js

@@ -19,7 +19,7 @@ function pluginsTools() {
             title: 'Plugins',
             description: 'List and manage a project\'s MCP-based integration plugins (Integrations). ' +
                 'Actions: list (catalog with status/health/version/drift), preview (dry-run install diff + requirements), ' +
-                'install (write — runs the installer + verify, surgically merges .mcp.json, streams plugin.install_progress; long-running), ' +
+                'install (write — runs the installer + verify, updates the provider-native MCP registry, streams plugin.install_progress; long-running), ' +
                 'uninstall (destructive — reverts contributors, removes owned mcpServers + installed files, drops state), ' +
                 'activate (re-enable an installed-but-off plugin), deactivate (toggle off without uninstalling), ' +
                 'update (apply manifest drift — re-merge owned mcpServers + re-apply contributors), ' +
@@ -38,6 +38,7 @@ function pluginsTools() {
                     .enum(['list', 'preview', 'install', 'uninstall', 'activate', 'deactivate', 'update', 'health'])
                     .describe('Operation to perform'),
                 projectId: zod_1.z.string().optional().describe('Project id (defaults to the active project)'),
+                provider: zod_1.z.string().optional().describe('Configured AI provider to manage (defaults to the launching conversation provider, then the project primary)'),
                 name: zod_1.z
                     .string()
                     .optional()
@@ -47,6 +48,10 @@ function pluginsTools() {
                 const base = `${(0, types_1.projectPath)(ctx, args.projectId)}/plugins`;
                 const action = args.action;
                 const name = args.name;
+                const provider = args.provider
+                    ?? (0, types_1.originConversationDefaults)(ctx).provider;
+                const query = provider ? `?provider=${encodeURIComponent(provider)}` : '';
+                const body = provider ? { provider } : undefined;
                 const requireName = () => {
                     if (!name)
                         throw new Error(`Action "${action}" requires a "name" (bundled plugin name).`);
@@ -54,26 +59,26 @@ function pluginsTools() {
                 };
                 switch (action) {
                     case 'list':
-                        return (0, types_1.apiCall)(ctx, 'GET', base);
+                        return (0, types_1.apiCall)(ctx, 'GET', `${base}${query}`);
                     case 'preview':
-                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/${requireName()}/preview-install`);
+                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/${requireName()}/preview-install${query}`);
                     case 'install': {
-                        const r = await (0, types_1.apiCall)(ctx, 'POST', `${base}/${requireName()}/install`);
+                        const r = await (0, types_1.apiCall)(ctx, 'POST', `${base}/${requireName()}/install`, body);
                         return {
                             ...(typeof r === 'object' && r !== null ? r : { result: r }),
                             hint: 'Install runs the plugin installer + verify and streams plugin.install_progress / plugin.installed WS events. Use specrails_watch to observe progress, or call action="health" to confirm the plugin verified.',
                         };
                     }
                     case 'uninstall':
-                        return (0, types_1.apiCall)(ctx, 'DELETE', `${base}/${requireName()}`);
+                        return (0, types_1.apiCall)(ctx, 'DELETE', `${base}/${requireName()}${query}`);
                     case 'activate':
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/${requireName()}/activate`);
+                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/${requireName()}/activate`, body);
                     case 'deactivate':
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/${requireName()}/deactivate`);
+                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/${requireName()}/deactivate`, body);
                     case 'update':
-                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/${requireName()}/update`);
+                        return (0, types_1.apiCall)(ctx, 'POST', `${base}/${requireName()}/update`, body);
                     case 'health':
-                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/${requireName()}/health`);
+                        return (0, types_1.apiCall)(ctx, 'GET', `${base}/${requireName()}/health${query}`);
                     default:
                         throw new Error(`Unknown action "${action}".`);
                 }

package/server/dist/mcp/tools/rails.js

@@ -3,10 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.railsTools = railsTools;
 const zod_1 = require("zod");
 const types_1 = require("./types");
-/** Launch-route contract (rails-router VALID_REASONING_EFFORTS): conversation
- *  efforts outside it (codex 'minimal', claude 'xhigh') are never defaulted —
- *  a default must not 400 a launch that would succeed without it. */
-const RAIL_REASONING_EFFORTS = new Set(['low', 'medium', 'high']);
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -30,7 +26,7 @@ function prDeliveryContinuesTickets(raw, ticketIds) {
 /**
  * Rails domain facade. A "rail" is a numbered launch slot per project: it holds
  * a set of assigned ticket IDs plus a mode/profile/engine/name, and launching it
- * spawns the AI pipeline (claude/codex/gemini) over those tickets.
+ * spawns the selected installed provider's AI pipeline over those tickets.
  *
  * Every operation is per-project under /api/projects/:projectId/rails. The
  * launch action is the only cost-incurring / repo-mutating one (ai-spawn, 202);
@@ -46,7 +42,7 @@ function railsTools() {
                 'Launching several rails in parallel is safe and normal: each launch runs in its own isolated git worktree. ' +
                 'Actions: list (rails + active jobs/loop runs), create_rail (add a new rail slot; returns its railIndex), set_tickets (assign ticket IDs), set_profile (default agent profile, null=legacy), ' +
                 'set_engine (provider override, null=primary), set_name (display label, null clears), ' +
-                'launch (ai-spawn — spawns claude/codex/gemini CLI job(s) that WRITE CODE, RUN TESTS, COMMIT, and INCUR TOKEN COST; returns 202 with jobId/jobIds/loopRunIds), ' +
+                'launch (ai-spawn — spawns the selected installed provider CLI job(s), including Kimi when installed, that WRITE CODE, RUN TESTS, COMMIT, and INCUR TOKEN COST; returns 202 with jobId/jobIds/loopRunIds), ' +
                 'launch_all (ai-spawn — launches EVERY rail that has tickets and no active run/uncontinuable pending PR decision, in parallel, using each rail\'s stored mode/engine/profile; returns per-rail outcomes with skip reasons), ' +
                 'stop (destructive — kills all active jobs and loop runs for the rail). ' +
                 'For on_review tickets with an already-open GitHub PR (including a published pr_ready delivery), launch automatically tries to continue that PR head branch; Jira-linked in_progress tickets can do the same when the PR match is explicit; fresh tickets still start from the project integration branch. ' +
@@ -103,11 +99,11 @@ function railsTools() {
                 mode: zod_1.z
                     .enum(['implement', 'batch-implement', 'freestyle', 'loop'])
                     .optional()
-                    .describe('Launch mode (launch; default "implement"). Use "freestyle" as the canonical API enum value for Freestyle: a free-form autonomous prompt sent straight to Claude, one job per ticket. In prose, call it "Freestyle". Loop runs an app-driven loop per ticket.'),
+                    .describe('Launch mode (launch; default "implement"). Use "freestyle" as the canonical API enum value for Freestyle. It invokes the selected provider\'s native free-form autonomous workflow (currently Claude and Kimi), one job per ticket. In prose, call it "Freestyle". Loop runs an app-driven loop per ticket.'),
                 model: zod_1.z
                     .string()
                     .optional()
-                    .describe('Model for launch. Freestyle is Claude-only and takes a Claude alias (haiku | sonnet | opus | fable); its API mode value is "freestyle". For loop mode, any model string valid for the rail\'s provider (claude/codex/gemini).'),
+                    .describe('Model for launch. For Freestyle or loop mode, pass a model string valid for the selected installed provider; Kimi preserves configured model aliases. Freestyle availability is capability-gated by provider.'),
                 interactive: zod_1.z
                     .boolean()
                     .optional()
@@ -117,9 +113,9 @@ function railsTools() {
                     .optional()
                     .describe('Loop id to run (launch). Use "factory:sdd-quick-openspec" for SDD Quick (OpenSpec): small OpenSpec-governed work via mode="loop". Factory ids (e.g. "factory:implement") map to a legacy mode; a custom published loop id keeps mode="loop". Browse/author loops with specrails_loops; the loop must be Published.'),
                 reasoning_effort: zod_1.z
-                    .enum(['low', 'medium', 'high'])
+                    .enum(['minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'])
                     .optional()
-                    .describe('Reasoning-effort tier for loop launches (launch, loop mode). From the in-app agent chat, omitting it defaults to the launching conversation\'s effort when that is low/medium/high.'),
+                    .describe('Provider-supported reasoning-effort tier for loop launches. Kimi K3 supports low/high/max; the server validates against the selected provider.'),
                 targetPrNumber: zod_1.z
                     .number()
                     .int()
@@ -228,14 +224,17 @@ function railsTools() {
                         // not silently launch claude via the router's rail/primary
                         // fall-through. Explicit aiEngine (string OR null) always wins; the
                         // router still validates installed-ness (clear 400 back). The
-                        // conversation's reasoning effort rides along only when it fits the
-                        // launch contract (low|medium|high). Dashboard / external-client
+                        // conversation's already-provider-validated reasoning effort rides
+                        // along only when this launch targets that same provider. Dashboard / external-client
                         // calls (no origin conversation) are byte-identical to before.
                         const defaults = (0, types_1.originConversationDefaults)(ctx);
                         if (body.aiEngine === undefined && defaults.provider) {
                             body.aiEngine = defaults.provider;
                         }
-                        if (body.reasoning_effort === undefined && defaults.reasoningEffort && RAIL_REASONING_EFFORTS.has(defaults.reasoningEffort)) {
+                        if (body.reasoning_effort === undefined &&
+                            defaults.reasoningEffort &&
+                            defaults.provider &&
+                            body.aiEngine === defaults.provider) {
                             body.reasoning_effort = defaults.reasoningEffort;
                         }
                         const r = await (0, types_1.apiCall)(ctx, 'POST', `${base}/${railIndex}/launch`, body);

package/server/dist/mcp/tools/support.js

@@ -131,7 +131,7 @@ function inferTopic(question) {
         return 'agent_chat';
     if (/\b(specrails-core|core framework|missing agents?|missing skills?|no agents?|no skills?|slash command|command not found|propose-feature|opsx|framework files?|reinstall)\b/.test(q))
         return 'framework_install';
-    if (/\b(claude|codex|gemini|provider|engine|cli|auth|login|api key|path)\b/.test(q))
+    if (/\b(claude|codex|gemini|kimi|provider|engine|cli|auth|login|api key|path)\b/.test(q))
         return 'provider_cli';
     if (/\b(add project|project setup|setup wizard|provision|checkpoint|install config)\b/.test(q))
         return 'project_setup';

package/server/dist/mobile/mobile-router.js

@@ -198,8 +198,12 @@ function createMobileRouter(deps) {
         // Additive — the frozen bare-`mode` path is untouched (a v1 client sends no loopId).
         if (typeof b.loopId === 'string')
             narrowed.loopId = b.loopId;
-        if (b.reasoning_effort === 'low' || b.reasoning_effort === 'medium' || b.reasoning_effort === 'high')
+        if (typeof b.reasoning_effort === 'string' &&
+            ['minimal', 'low', 'medium', 'high', 'xhigh', 'max', 'ultra'].includes(b.reasoning_effort)) {
+            // The internal rail route validates the tier against the selected
+            // provider. This gateway only narrows to the cross-provider enum.
             narrowed.reasoning_effort = b.reasoning_effort;
+        }
         if (typeof b.interactive === 'boolean')
             narrowed.interactive = b.interactive;
         void forward(res, 'POST', `/api/projects/${encodeURIComponent(pid)}/rails/${encodeURIComponent(i)}/launch`, '', narrowed);

package/server/dist/offline-assemble.js

@@ -17,6 +17,7 @@ const artifact_registry_1 = require("./artifact-registry");
 const install_config_path_1 = require("./install-config-path");
 const workspace_manager_1 = require("./workspace-manager");
 const core_package_1 = require("./core-package");
+const providers_1 = require("./providers");
 // ─── Offline workspace assemble (add-project-builder D4) ─────────────────────
 //
 // The single shared "assemble a project workspace from the BUNDLED framework"
@@ -127,6 +128,17 @@ function buildQuickInstallConfigYaml(provider, defaultModel) {
         '',
     ].join('\n');
 }
+function defaultModelForProvider(opts, provider) {
+    const providerOverride = opts.defaultModels?.[provider];
+    if (providerOverride)
+        return providerOverride;
+    // Preserve the original override API for its unambiguous use case. Applying
+    // one alias across a mixed-provider install is unsafe: `sonnet`, for example,
+    // is a Claude alias and is not a valid Kimi/Codex/Gemini default.
+    if (opts.providers.length === 1 && opts.defaultModel)
+        return opts.defaultModel;
+    return (0, providers_1.getAdapter)(provider).defaultModel();
+}
 /**
  * Assemble a project workspace from the bundled framework when available, or
  * from the npx fallback in development/runtimes-less builds: registry mirror
@@ -174,7 +186,7 @@ async function assembleProjectOffline(opts) {
     for (const provider of providers) {
         const configPath = (0, install_config_path_1.installConfigPathForProvider)({ slug, path: projectPath }, provider);
         (0, fs_1.mkdirSync)((0, path_1.dirname)(configPath), { recursive: true });
-        (0, fs_1.writeFileSync)(configPath, buildQuickInstallConfigYaml(provider, opts.defaultModel ?? 'sonnet'), 'utf-8');
+        (0, fs_1.writeFileSync)(configPath, buildQuickInstallConfigYaml(provider, defaultModelForProvider(opts, provider)), 'utf-8');
         const child = spawnInit(['--yes', '--from-config', configPath], projectPath);
         if (!child) {
             throw new Error('specrails-core is not available — reinstall the Specrails app');

package/server/dist/path-resolver.js

@@ -284,7 +284,7 @@ function resolveStartupPathBase() {
                 const inheritedSet = new Set(inherited);
                 const bundledDirs = [nodeBinDir, gitBinDir, uvBinDir].filter((d) => !!d && !inheritedSet.has(d));
                 bundledDirs.forEach((d) => inheritedSet.add(d));
-                // Provider CLIs (claude/codex/gemini) are NEVER bundled — they always
+                // Provider CLIs (claude/codex/gemini/kimi) are NEVER bundled — they always
                 // come from the system. On Windows their `.cmd` shims live in
                 // `%APPDATA%\npm`, which a GUI-launched (Explorer/Tauri) process may not
                 // have on PATH. This branch returns early, skipping the win32 fallback
@@ -317,7 +317,7 @@ function resolveStartupPathBase() {
     const inheritedSet = new Set(inherited);
     if (process.platform === 'win32') {
         // Prepend well-known global-CLI dirs (npm prefix, Program Files\nodejs) that
-        // a GUI-launched process may lack, so provider shims (claude/codex/gemini
+        // a GUI-launched process may lack, so provider shims (claude/codex/gemini/kimi
         // .cmd) — and any RECURSIVE bare-name invocation by a spawned CLI — resolve.
         // Existence-gated + deduped; no-op when already present (the common case).
         const winPrepend = [];