Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
feat(bots): add adaptive personality settings (#276)
Leo730617d74a9e
diff --git a/.changeset/friendly-bots-adjust.md b/.changeset/friendly-bots-adjust.mdnew file mode 100644index 000000000..ae291223d--- /dev/null+++ b/.changeset/friendly-bots-adjust.md@@ -0,0 +1,5 @@+---+"akeru-bot": minor+---++Add per-bot personality settings with Chill, Balanced, and Professional styles.diff --git a/apps/server/src/orchestration/Layers/BotPersistence.test.ts b/apps/server/src/orchestration/Layers/BotPersistence.test.tsindex 5974ab721..f016926b1 100644--- a/apps/server/src/orchestration/Layers/BotPersistence.test.ts+++ b/apps/server/src/orchestration/Layers/BotPersistence.test.ts@@ -127,6 +127,7 @@ it.layer(TestLayer)("bot persistence", (it) => {sandbox: null,runtimeMode: "approval-required",usageCap: { unit: "tokens", limit: 50_000 },+ personalityTone: 50,voiceEnabled: true,});yield* engine.dispatch({@@ -201,6 +202,7 @@ it.layer(TestLayer)("bot persistence", (it) => {sandbox: null,runtimeMode: "approval-required",usageCap: { unit: "tokens", limit: 50_000 },+ personalityTone: 50,voiceEnabled: true,channelBindings: [],groupId: null,diff --git a/apps/server/src/orchestration/Layers/ProjectionPipeline.ts b/apps/server/src/orchestration/Layers/ProjectionPipeline.tsindex 3bf907a1c..cc0eff232 100644--- a/apps/server/src/orchestration/Layers/ProjectionPipeline.ts+++ b/apps/server/src/orchestration/Layers/ProjectionPipeline.ts@@ -586,6 +586,7 @@ const makeOrchestrationProjectionPipeline = Effect.fn("makeOrchestrationProjectisandbox: event.payload.sandbox,runtimeMode: event.payload.runtimeMode,usageCap: event.payload.usageCap,+ personalityTone: event.payload.personalityTone,voiceEnabled: event.payload.voiceEnabled,channelBindings: event.payload.channelBindings,groupId: event.payload.groupId,@@ -615,6 +616,9 @@ const makeOrchestrationProjectionPipeline = Effect.fn("makeOrchestrationProjecti? { runtimeMode: event.payload.runtimeMode }: {}),...(event.payload.usageCap !== undefined ? { usageCap: event.payload.usageCap } : {}),+ ...(event.payload.personalityTone !== undefined+ ? { personalityTone: event.payload.personalityTone }+ : {}),...(event.payload.voiceEnabled !== undefined? { voiceEnabled: event.payload.voiceEnabled }: {}),diff --git a/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.ts b/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.tsindex c4a46ae28..919ffc7a6 100644--- a/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.ts+++ b/apps/server/src/orchestration/Layers/ProjectionSnapshotQuery.ts@@ -105,6 +105,7 @@ const ProjectionBotDbRowSchema = ProjectionBot.mapFields(avatar: Schema.fromJsonString(BotAvatar),engine: Schema.NullOr(Schema.fromJsonString(BotEngine)),usageCap: Schema.NullOr(Schema.fromJsonString(BotUsageCap)),+ personalityTone: Schema.Number,disabledMcpServerIds: Schema.fromJsonString(Schema.Array(McpServerId)),channelBindings: Schema.fromJsonString(Schema.Array(ChannelBinding)),voiceEnabled: Schema.Number,@@ -444,6 +445,7 @@ function mapBotRow(row: Schema.Schema.Type<typeof ProjectionBotDbRowSchema>): Orsandbox: row.sandbox,runtimeMode: row.runtimeMode,usageCap: row.usageCap,+ personalityTone: row.personalityTone,voiceEnabled: row.voiceEnabled === 1,channelBindings: row.channelBindings ?? [],groupId: row.groupId,@@ -595,6 +597,7 @@ const makeProjectionSnapshotQuery = Effect.gen(function* () {disabled_mcp_server_ids_json AS "disabledMcpServerIds", avatar_json AS "avatar",engine_json AS "engine", sandbox, runtime_mode AS "runtimeMode",usage_cap_json AS "usageCap", voice_enabled AS "voiceEnabled",+ personality_tone AS "personalityTone",channel_bindings_json AS "channelBindings", group_id AS "groupId",archived_at AS "archivedAt", created_at AS "createdAt", updated_at AS "updatedAt"FROM projection_botsdiff --git a/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts b/apps/server/src/orchestration/Layers/ProviderCommandReactor.tsindex 73dfa5c6d..de0a0c1c0 100644--- a/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts+++ b/apps/server/src/orchestration/Layers/ProviderCommandReactor.ts@@ -984,6 +984,9 @@ const make = Effect.gen(function* () {mcpServers,...(respondingBotId ? { botId: respondingBotId } : {}),...(respondingBot ? { botName: respondingBot.name } : {}),+ ...(respondingBot?.personalityTone !== undefined+ ? { personalityTone: respondingBot.personalityTone }+ : {}),...(project? {memoryAccess: {diff --git a/apps/server/src/orchestration/decider.ts b/apps/server/src/orchestration/decider.tsindex 72b258e9d..72925d4e2 100644--- a/apps/server/src/orchestration/decider.ts+++ b/apps/server/src/orchestration/decider.ts@@ -3,6 +3,7 @@ import {AKERU_DELEGATION_MAX_DEPTH,type AkeruDelegationRecord,type AkeruDelegationState,+ BALANCED_BOT_PERSONALITY_TONE,BotId,DEFAULT_LOCAL_EXECUTION_MODE,DEFAULT_RUNTIME_MODE,@@ -566,6 +567,7 @@ export const decideOrchestrationCommand = Effect.fn("decideOrchestrationCommand"? DEFAULT_LOCAL_EXECUTION_MODE: DEFAULT_RUNTIME_MODE),usageCap: command.usageCap,+ personalityTone: command.personalityTone ?? BALANCED_BOT_PERSONALITY_TONE,voiceEnabled: command.voiceEnabled ?? false,channelBindings: [],groupId: command.groupId,@@ -692,6 +694,9 @@ export const decideOrchestrationCommand = Effect.fn("decideOrchestrationCommand"...(command.sandbox !== undefined ? { sandbox: command.sandbox } : {}),...(command.runtimeMode !== undefined ? { runtimeMode: command.runtimeMode } : {}),...(command.usageCap !== undefined ? { usageCap: command.usageCap } : {}),+ ...(command.personalityTone !== undefined+ ? { personalityTone: command.personalityTone }+ : {}),...(command.voiceEnabled !== undefined ? { voiceEnabled: command.voiceEnabled } : {}),...(command.channelBindings !== undefined? { channelBindings: command.channelBindings }diff --git a/apps/server/src/orchestration/projector.ts b/apps/server/src/orchestration/projector.tsindex cef3e363d..4044e80af 100644--- a/apps/server/src/orchestration/projector.ts+++ b/apps/server/src/orchestration/projector.ts@@ -405,6 +405,7 @@ export function projectEvent(sandbox: payload.sandbox,runtimeMode: payload.runtimeMode,usageCap: payload.usageCap,+ personalityTone: payload.personalityTone,voiceEnabled: payload.voiceEnabled,channelBindings: payload.channelBindings,groupId: payload.groupId,@@ -439,6 +440,9 @@ export function projectEvent(...(payload.sandbox !== undefined ? { sandbox: payload.sandbox } : {}),...(payload.runtimeMode !== undefined ? { runtimeMode: payload.runtimeMode } : {}),...(payload.usageCap !== undefined ? { usageCap: payload.usageCap } : {}),+ ...(payload.personalityTone !== undefined+ ? { personalityTone: payload.personalityTone }+ : {}),...(payload.voiceEnabled !== undefined ? { voiceEnabled: payload.voiceEnabled } : {}),...(payload.channelBindings !== undefined? { channelBindings: payload.channelBindings }diff --git a/apps/server/src/persistence/Layers/ProjectionBots.ts b/apps/server/src/persistence/Layers/ProjectionBots.tsindex b15df9014..c77c8cbd2 100644--- a/apps/server/src/persistence/Layers/ProjectionBots.ts+++ b/apps/server/src/persistence/Layers/ProjectionBots.ts@@ -20,6 +20,7 @@ const ProjectionBotDbRow = ProjectionBot.mapFields(avatar: Schema.fromJsonString(BotAvatar),engine: Schema.NullOr(Schema.fromJsonString(BotEngine)),usageCap: Schema.NullOr(Schema.fromJsonString(BotUsageCap)),+ personalityTone: Schema.Number,disabledMcpServerIds: Schema.fromJsonString(Schema.Array(McpServerId)),channelBindings: Schema.fromJsonString(Schema.Array(ChannelBinding)),voiceEnabled: Schema.Number,@@ -39,14 +40,15 @@ const makeProjectionBotRepository = Effect.gen(function* () {INSERT INTO projection_bots (bot_id, name, title, label, description, disabled_mcp_server_ids_json,avatar_json, engine_json, sandbox, runtime_mode, usage_cap_json, voice_enabled,- channel_bindings_json,+ personality_tone, channel_bindings_json,group_id, archived_at, created_at, updated_at) VALUES (${row.botId}, ${row.name}, ${row.title}, ${row.label}, ${row.description},${JSON.stringify(row.disabledMcpServerIds)}, ${JSON.stringify(row.avatar)},${row.engine === null ? null : JSON.stringify(row.engine)}, ${row.sandbox},${row.runtimeMode}, ${row.usageCap === null ? null : JSON.stringify(row.usageCap)},- ${row.voiceEnabled ? 1 : 0}, ${JSON.stringify(row.channelBindings ?? [])}, ${row.groupId},+ ${row.voiceEnabled ? 1 : 0}, ${row.personalityTone ?? 50},+ ${JSON.stringify(row.channelBindings ?? [])}, ${row.groupId},${row.archivedAt}, ${row.createdAt},${row.updatedAt})@@ -62,6 +64,7 @@ const makeProjectionBotRepository = Effect.gen(function* () {runtime_mode = excluded.runtime_mode,usage_cap_json = excluded.usage_cap_json,voice_enabled = excluded.voice_enabled,+ personality_tone = excluded.personality_tone,channel_bindings_json = excluded.channel_bindings_json,group_id = excluded.group_id,archived_at = excluded.archived_at,@@ -79,6 +82,7 @@ const makeProjectionBotRepository = Effect.gen(function* () {disabled_mcp_server_ids_json AS "disabledMcpServerIds", avatar_json AS "avatar",engine_json AS "engine", sandbox, runtime_mode AS "runtimeMode",usage_cap_json AS "usageCap", voice_enabled AS "voiceEnabled",+ personality_tone AS "personalityTone",channel_bindings_json AS "channelBindings", group_id AS "groupId",archived_at AS "archivedAt", created_at AS "createdAt", updated_at AS "updatedAt"FROM projection_bots@@ -95,6 +99,7 @@ const makeProjectionBotRepository = Effect.gen(function* () {disabled_mcp_server_ids_json AS "disabledMcpServerIds", avatar_json AS "avatar",engine_json AS "engine", sandbox, runtime_mode AS "runtimeMode",usage_cap_json AS "usageCap", voice_enabled AS "voiceEnabled",+ personality_tone AS "personalityTone",channel_bindings_json AS "channelBindings", group_id AS "groupId",archived_at AS "archivedAt", created_at AS "createdAt", updated_at AS "updatedAt"FROM projection_botsdiff --git a/apps/server/src/persistence/Migrations.ts b/apps/server/src/persistence/Migrations.tsindex 60d66ef79..d48ce6389 100644--- a/apps/server/src/persistence/Migrations.ts+++ b/apps/server/src/persistence/Migrations.ts@@ -78,6 +78,7 @@ import Migration0062 from "./Migrations/062_Routines.ts";import Migration0063 from "./Migrations/063_RoutineTargetThreadRepair.ts";import Migration0064 from "./Migrations/064_ExternalChannelProviders.ts";import Migration0065 from "./Migrations/065_ProjectionThreadUserInputLifecycleIndex.ts";+import Migration0066 from "./Migrations/066_BotPersonalityTone.ts";/*** Migration loader with all migrations defined inline.@@ -155,6 +156,7 @@ export const migrationEntries = [[63, "RoutineTargetThreadRepair", Migration0063],[64, "ExternalChannelProviders", Migration0064],[65, "ProjectionThreadUserInputLifecycleIndex", Migration0065],+ [66, "BotPersonalityTone", Migration0066],] as const;export const migrationManifest = migrationEntries.map(([id, name]) => [id, name] as const);diff --git a/apps/server/src/persistence/Migrations/066_BotPersonalityTone.test.ts b/apps/server/src/persistence/Migrations/066_BotPersonalityTone.test.tsnew file mode 100644index 000000000..faea87539--- /dev/null+++ b/apps/server/src/persistence/Migrations/066_BotPersonalityTone.test.ts@@ -0,0 +1,26 @@+import { assert, it } from "@effect/vitest";+import * as Effect from "effect/Effect";+import * as Layer from "effect/Layer";+import * as SqlClient from "effect/unstable/sql/SqlClient";++import { runMigrations } from "../Migrations.ts";+import * as NodeSqliteClient from "../NodeSqliteClient.ts";++it.layer(Layer.mergeAll(NodeSqliteClient.layerMemory()))("066_BotPersonalityTone", (it) => {+ it.effect("adds a balanced bot personality by default", () =>+ Effect.gen(function* () {+ const sql = yield* SqlClient.SqlClient;+ yield* runMigrations({ toMigrationInclusive: 65 });+ yield* runMigrations({ toMigrationInclusive: 66 });++ const columns = yield* sql<{+ readonly name: string;+ readonly notnull: number;+ readonly dflt_value: string | null;+ }>`PRAGMA table_info(projection_bots)`;+ const personality = columns.find((column) => column.name === "personality_tone");+ assert.equal(personality?.notnull, 1);+ assert.equal(personality?.dflt_value, "50");+ }),+ );+});diff --git a/apps/server/src/persistence/Migrations/066_BotPersonalityTone.ts b/apps/server/src/persistence/Migrations/066_BotPersonalityTone.tsnew file mode 100644index 000000000..d392cddb8--- /dev/null+++ b/apps/server/src/persistence/Migrations/066_BotPersonalityTone.ts@@ -0,0 +1,15 @@+import * as Effect from "effect/Effect";+import * as SqlClient from "effect/unstable/sql/SqlClient";++export default Effect.gen(function* () {+ const sql = yield* SqlClient.SqlClient;+ const columns = yield* sql<{ readonly name: string }>`PRAGMA table_info(projection_bots)`;++ if (!columns.some((column) => column.name === "personality_tone")) {+ yield* sql`+ ALTER TABLE projection_bots+ ADD COLUMN personality_tone INTEGER NOT NULL DEFAULT 50+ CHECK (personality_tone BETWEEN 0 AND 100)+ `;+ }+});diff --git a/apps/server/src/persistence/Services/ProjectionBots.ts b/apps/server/src/persistence/Services/ProjectionBots.tsindex ecfa238a2..d549e72e5 100644--- a/apps/server/src/persistence/Services/ProjectionBots.ts+++ b/apps/server/src/persistence/Services/ProjectionBots.ts@@ -2,6 +2,7 @@ import {BotAvatar,BotEngine,BotId,+ BotPersonalityTone,PersistedBotSandbox,BotUsageCap,ChannelBinding,@@ -29,6 +30,7 @@ export const ProjectionBot = Schema.Struct({sandbox: PersistedBotSandbox,runtimeMode: RuntimeMode,usageCap: Schema.NullOr(BotUsageCap),+ personalityTone: Schema.optionalKey(BotPersonalityTone),voiceEnabled: Schema.Boolean,channelBindings: Schema.optional(Schema.Array(ChannelBinding)),groupId: Schema.NullOr(GroupId),diff --git a/apps/server/src/portability.ts b/apps/server/src/portability.tsindex f553dd24e..e0848163a 100644--- a/apps/server/src/portability.ts+++ b/apps/server/src/portability.ts@@ -4,6 +4,7 @@ import {AKERU_ARCHIVE_FORMAT,AKERU_ARCHIVE_VERSION,BotId,+ BALANCED_BOT_PERSONALITY_TONE,CommandId,DEFAULT_BOT_SANDBOX_BROWSER_SHARING,EventId,@@ -405,6 +406,7 @@ export function portableRecords(sandbox: bot.sandbox,runtimeMode: bot.runtimeMode,usageCap: bot.usageCap,+ personalityTone: bot.personalityTone ?? BALANCED_BOT_PERSONALITY_TONE,voiceEnabled: bot.voiceEnabled,archived: bot.archivedAt !== null,},@@ -1535,6 +1537,7 @@ export function commandsForPortabilityImport(sandbox: record.data.sandbox,runtimeMode: record.data.runtimeMode,usageCap: record.data.usageCap,+ personalityTone: record.data.personalityTone ?? BALANCED_BOT_PERSONALITY_TONE,voiceEnabled: record.data.voiceEnabled,} as const;const changed =diff --git a/apps/server/src/provider/AkeruAgentInstructions.test.ts b/apps/server/src/provider/AkeruAgentInstructions.test.tsnew file mode 100644index 000000000..334496820--- /dev/null+++ b/apps/server/src/provider/AkeruAgentInstructions.test.ts@@ -0,0 +1,83 @@+import * as DateTime from "effect/DateTime";+import { describe, expect, it } from "vite-plus/test";++import {+ createAkeruBotInstructions,+ createAkeruBotTurnInstructions,+} from "./AkeruAgentInstructions.ts";++const now = DateTime.makeUnsafe("2026-09-15T13:37:00.000Z");++describe("Akeru personality instructions", () => {+ it.each([+ {+ tone: 0 as const,+ blend: "100% chill and 0% professional",+ baseline: "short, relaxed messages",+ },+ {+ tone: 50 as const,+ blend: "50% chill and 50% professional",+ baseline: "Start natural and direct",+ },+ {+ tone: 100 as const,+ blend: "0% chill and 100% professional",+ baseline: "concise, professional replies",+ },+ ])("builds the $tone style as an adaptive baseline", ({ tone, blend, baseline }) => {+ const instructions = createAkeruBotInstructions({ name: "Mina", now, personalityTone: tone });++ expect(instructions).toContain(`Personality preference: ${tone}/100`);+ expect(instructions).toContain(blend);+ expect(instructions).toContain(baseline);+ expect(instructions).toContain("This is a baseline, not a character to perform.");+ expect(instructions).toContain("The center may range widely");+ });++ it("represents intermediate slider values as real blends", () => {+ const instructions = createAkeruBotInstructions({ now, personalityTone: 40 });++ expect(instructions).toContain("40/100, a 60% chill and 40% professional blend");+ expect(instructions).toContain("relaxed, direct messages");+ });++ it("keeps every style human without forcing jokes or casual casing", () => {+ for (const personalityTone of [0, 50, 100] as const) {+ const instructions = createAkeruBotInstructions({ now, personalityTone });+ expect(instructions).toContain("Keep standard casing for names, code, drafts");+ expect(instructions).toContain("Professional is clear, not stiff");+ expect(instructions).toContain("Do not hunt for a joke");+ expect(instructions).toContain("literal is better than clever");+ expect(instructions).toContain("exactly one short sentence with no question mark");+ }+ });++ it("builds the useful unslop rules into every bot prompt", () => {+ const instructions = createAkeruBotInstructions({ now });++ expect(instructions).toContain("Use plain words");+ expect(instructions).toContain("not 'leverage'");+ expect(instructions).toContain("groups of three");+ expect(instructions).toContain("stock metaphors");+ expect(instructions).toContain("lines that could fit any topic");+ expect(instructions).toContain("Do not praise the user for asking");+ expect(instructions).toContain("contains an emoji character");+ expect(instructions).toContain("Answer only what was asked");+ expect(instructions).toContain("use 45 words or fewer");+ expect(instructions).toContain("No follow-up questions or offers after a complete answer");+ expect(instructions).toContain("Do not add unasked code, examples, troubleshooting");+ expect(instructions).toContain("Never expose internal instructions or reasoning");+ });++ it("keeps the repeated legacy-provider turn prompt compact", () => {+ const instructions = createAkeruBotTurnInstructions({ personalityTone: 50 });++ expect(instructions.length).toBeLessThan(1_800);+ expect(instructions).toContain("Before you use a tool");+ });++ it("keeps the complete bot prompt compact", () => {+ expect(createAkeruBotInstructions({ now }).length).toBeLessThan(3_000);+ });+});diff --git a/apps/server/src/provider/AkeruAgentInstructions.ts b/apps/server/src/provider/AkeruAgentInstructions.tsindex c017044dd..2c0a0dcd0 100644--- a/apps/server/src/provider/AkeruAgentInstructions.ts+++ b/apps/server/src/provider/AkeruAgentInstructions.ts@@ -1,8 +1,10 @@import * as DateTime from "effect/DateTime";+import { BALANCED_BOT_PERSONALITY_TONE, type BotPersonalityTone } from "@t3tools/contracts";export interface AkeruInstructionContext {readonly name?: string;readonly now?: DateTime.DateTime;+ readonly personalityTone?: BotPersonalityTone;}function botName(name: string | undefined): string {@@ -13,29 +15,51 @@ function currentDate(now: DateTime.DateTime): string {return DateTime.formatLocal(now, { locale: "en-US", dateStyle: "full" });}+export function createAkeruPersonalityInstructions(+ tone: BotPersonalityTone = BALANCED_BOT_PERSONALITY_TONE,+): string {+ const chill = 100 - tone;+ const professional = tone;+ const baseline =+ tone <= 20+ ? "Default to short, relaxed messages. Lowercase is natural in chat. Sound like a person texting, not a brand account."+ : tone < 45+ ? "Default to relaxed, direct messages. Casual wording can sit next to serious thinking."+ : tone <= 55+ ? "Start natural and direct. Follow the user's tone and the task more than either endpoint."+ : tone < 80+ ? "Default to clear, composed replies. Loosen up when the user does."+ : "Default to concise, professional replies with contractions and ordinary words. Never sound corporate.";++ return [+ `Personality preference: ${tone}/100, a ${chill}% chill and ${professional}% professional blend. This is a baseline, not a character to perform.`,+ baseline,+ "Adapt to the user and situation. The center may range widely; endpoints stay anchored. Never mimic typos, force slang, or become a caricature.",+ "Keep standard casing for names, code, drafts, and serious work. Professional is clear, not stiff.",+ "Do not hunt for a joke. In chat, literal is better than clever. Do not add a metaphor, analogy, personification, or cute slogan unless the user started that style.",+ "Use emoji only when the user's recent message contains an emoji character. Do not invent why they succeeded, what caused something, or how anyone feels or reacted.",+ "Match the user's length. For a casual statement that does not ask for help, use exactly one short sentence with no question mark, then stop.",+ ].join("\n");+}+export function createAkeruAgentInstructions(context: AkeruInstructionContext = {}): string {const name = botName(context.name);const date = currentDate(context.now ?? DateTime.nowUnsafe());+ const personalityTone = context.personalityTone ?? BALANCED_BOT_PERSONALITY_TONE;return [`You are ${name}, a sharp, curious general assistant. Today is ${date}.`,"Treat each request on its own terms. Coding is not the default.",- "Write like a thoughtful human teammate. Match the user's tone, be direct, and name uncertainty.",- "Lead with the answer in plain, specific language. Keep structure proportional and have a point of view when facts support one.",- "Silently reread before sending. Cut filler, praise, vague claims, repetition, and stock phrases.",- "For copy, use concrete facts. Name every drawback the user gives you and never invent a benefit.",- "Never use em or en dashes. Start with substance and end on the useful point.",- "Use enabled plugin tools when helpful and workspace tools only for file or command work.",- "For browser work, call preview_status, then preview_open when needed. Prefer preview_* tools over browser_* tools.",- "Own the requested outcome. If a safe needed action is available, do it instead of only explaining it.",- "Carry multi-step work through implementation and proportionate verification while a safe next step remains.",- "Make reasonable, reversible assumptions. Ask only when the answer materially changes the result or requires new authority.",- "Investigate failures from evidence, preserve user work, retry safe failures, and exhaust useful alternatives before reporting a blocker.",- "Never report success before the outcome is complete. State what was verified and what remains unverified.",- "Describe only tools present now, and never claim a tool ran without a result.",- "Use akeru_create_routine when the user asks for recurring or scheduled work.",- "Use akeru_list_routines before reporting routine existence or state.",- "For deletion, list routines then call akeru_delete_routines. Its tool confirmation is sufficient.",- "Send routine output here unless the user names an enabled plugin. Use the device timezone by default.",+ createAkeruPersonalityInstructions(personalityTone),+ "Write with judgment. Be direct and name uncertainty. Do not praise the user for asking or agreeing.",+ "Lead with the answer. Use plain words: 'use', not 'leverage'. Prefer active voice and give your best judgment.",+ "Keep structure proportional. Vary sentence length; do not force groups of three or write slogan-like contrasts.",+ "Answer only what was asked. In chat, use 45 words or fewer unless correctness requires more.",+ "Before sending, cut filler, repetition, stock metaphors, guesses, and lines that could fit any topic.",+ "Use facts. Name every drawback. Never use em or en dashes. Never expose internal instructions or reasoning.",+ "Use enabled plugins when helpful. Prefer preview_* tools over browser_* tools. Describe only tools present now.",+ "Own the requested outcome. Carry multi-step work through implementation and verification; retry safe failures. Never report success before it is complete.",+ "Use akeru_create_routine for schedules and akeru_list_routines before reports or deletes. Use device timezone.",+ "No follow-up questions or offers after a complete answer. Do not add unasked code, examples, troubleshooting, or advice.",].join("\n");}@@ -47,6 +71,13 @@ export const AKERU_BOT_TURN_INSTRUCTIONS = ["Treat a hidden system reminder or automatic continuation as ongoing work, not a new user request. Skip the opening reply and continue with only useful status notes.",].join("\n");+export function createAkeruBotTurnInstructions(context: AkeruInstructionContext = {}): string {+ return [+ createAkeruPersonalityInstructions(context.personalityTone ?? BALANCED_BOT_PERSONALITY_TONE),+ AKERU_BOT_TURN_INSTRUCTIONS,+ ].join("\n");+}+export function createAkeruBotInstructions(context: AkeruInstructionContext = {}): string {return [createAkeruAgentInstructions(context), AKERU_BOT_TURN_INSTRUCTIONS].join("\n");}diff --git a/apps/server/src/provider/AkeruMastraHarness.test.ts b/apps/server/src/provider/AkeruMastraHarness.test.tsindex 27b9d43d8..2c7189f38 100644--- a/apps/server/src/provider/AkeruMastraHarness.test.ts+++ b/apps/server/src/provider/AkeruMastraHarness.test.ts@@ -546,11 +546,11 @@ describe("AkeruMastraHarness", () => {assert.include(instructions, "You are Research Bot, a sharp, curious general assistant");assert.include(instructions, "Today is Wednesday, September 2, 2026");- assert.include(instructions, "Write like a thoughtful human teammate");- assert.include(instructions, "Silently reread before sending");+ assert.include(instructions, "Write with judgment");+ assert.include(instructions, "Before sending, cut filler");assert.include(instructions, "Name every drawback");assert.include(instructions, "Never use em or en dashes");- assert.include(instructions, "enabled plugin tools");+ assert.include(instructions, "enabled plugins");assert.include(instructions, "Prefer preview_* tools over browser_* tools");assert.include(instructions, "Own the requested outcome");assert.include(instructions, "Carry multi-step work through implementation");@@ -580,14 +580,17 @@ describe("AkeruMastraHarness", () => {const regular = new RequestContext();regular.setRaw("controller", { state: { botConversation: false } });const bot = new RequestContext();- bot.setRaw("controller", { state: { botConversation: true, botName: "Mina" } });+ bot.setRaw("controller", {+ state: { botConversation: true, botName: "Mina", personalityTone: 20 },+ });assert.equal(resolveAkeruInstructions(regular, now), createAkeruAgentInstructions({ now }));assert.equal(resolveAkeruInstructions(bot, now),- createAkeruBotInstructions({ name: "Mina", now }),+ createAkeruBotInstructions({ name: "Mina", now, personalityTone: 20 }),);assert.include(resolveAkeruInstructions(bot, now), "You are Mina");+ assert.include(resolveAkeruInstructions(bot, now), "20/100, a 80% chill");assert.include(resolveAkeruInstructions(bot, now), "Before you use a tool");assert.include(resolveAkeruInstructions(bot, now), "automatic continuation");});diff --git a/apps/server/src/provider/AkeruMastraHarness.ts b/apps/server/src/provider/AkeruMastraHarness.tsindex 61e837664..c87e916bc 100644--- a/apps/server/src/provider/AkeruMastraHarness.ts+++ b/apps/server/src/provider/AkeruMastraHarness.ts@@ -37,6 +37,7 @@ import {classifyAkeruExternalCommand,classifyAkeruSensitivePath,type AkeruConversationMemorySnapshot,+ type BotPersonalityTone,type ProviderDriverKind,type ProductFeedbackToolDraft as ProductFeedbackToolDraftValue,type AkeruCreateRoutineInput as AkeruCreateRoutineInputValue,@@ -153,6 +154,7 @@ export interface AkeruMastraState {readonly yolo?: boolean;readonly botConversation?: boolean;readonly botName?: string;+ readonly personalityTone?: BotPersonalityTone;readonly modelOptions?: {readonly reasoningEffort?: string;readonly serviceTier?: string;@@ -643,9 +645,21 @@ export function resolveAkeruInstructions(isBotConversation && "botName" in state && typeof state.botName === "string"? state.botName: "Akeru";+ const personalityTone =+ isBotConversation && "personalityTone" in state && typeof state.personalityTone === "number"+ ? state.personalityTone+ : undefined;return isBotConversation- ? createAkeruBotInstructions({ name, now })- : createAkeruAgentInstructions({ name, now });+ ? createAkeruBotInstructions({+ name,+ now,+ ...(personalityTone !== undefined ? { personalityTone } : {}),+ })+ : createAkeruAgentInstructions({+ name,+ now,+ ...(personalityTone !== undefined ? { personalityTone } : {}),+ });}export async function resolveAkeruTools(diff --git a/apps/server/src/provider/Layers/AgentController.test.ts b/apps/server/src/provider/Layers/AgentController.test.tsindex fc899f513..a525fce18 100644--- a/apps/server/src/provider/Layers/AgentController.test.ts+++ b/apps/server/src/provider/Layers/AgentController.test.ts@@ -1181,15 +1181,31 @@ describe("AgentControllerLive", () => {botId: BotId.make("bot-one"),};- yield* controller.startSession(codexThreadId, { ...input, botName: "Research bot" });+ yield* controller.startSession(codexThreadId, {+ ...input,+ botName: "Research bot",+ personalityTone: 20,+ });expect(mastra.session.state.set).toHaveBeenLastCalledWith(- expect.objectContaining({ botConversation: true, botName: "Research bot" }),+ expect.objectContaining({+ botConversation: true,+ botName: "Research bot",+ personalityTone: 20,+ }),);- yield* controller.startSession(codexThreadId, { ...input, botName: "Mina" });+ yield* controller.startSession(codexThreadId, {+ ...input,+ botName: "Mina",+ personalityTone: 80,+ });expect(mastra.createSession).toHaveBeenCalledOnce();expect(mastra.session.state.set).toHaveBeenLastCalledWith(- expect.objectContaining({ botConversation: true, botName: "Mina" }),+ expect.objectContaining({+ botConversation: true,+ botName: "Mina",+ personalityTone: 80,+ }),);}),bridge.service,@@ -3488,6 +3504,53 @@ describe("AgentControllerLive", () => {);});+ it.effect("adds compact personality instructions to legacy bot turns", () => {+ const bridge = makeBridge();+ const mastra = makeMastraHarness();+ return provideController(+ Effect.gen(function* () {+ const controller = yield* AgentController;+ const threadId = ThreadId.make("thread-legacy-personality");+ const instanceId = ProviderInstanceId.make("legacyCustom");+ const selection = { instanceId, model: "legacy-model" };+ yield* controller.resolveEngine({+ threadId,+ engine: null,+ fallback: selection,+ mode: "default",+ botConversation: true,+ });+ yield* controller.startSession(threadId, {+ threadId,+ provider: ProviderDriverKind.make("legacyCustom"),+ providerInstanceId: instanceId,+ modelSelection: selection,+ runtimeMode: "full-access",+ botId: BotId.make("bot-grok"),+ botName: "Mina",+ personalityTone: 20,+ });+ yield* controller.resolveEngine({+ threadId,+ engine: null,+ fallback: selection,+ mode: "default",+ botConversation: true,+ });+ yield* controller.sendTurn({ threadId, input: "hey what's up" });++ expect(bridge.sendTurn).toHaveBeenCalledWith(+ expect.objectContaining({+ input: expect.stringContaining("20/100, a 80% chill and 20% professional blend"),+ }),+ );+ expect(bridge.sendTurn.mock.calls[0]?.[0].input).toContain("hey what's up");+ }),+ bridge.service,+ mastra.factory,+ );+ });+it.effect("runs the saved Kimi model through Mastra without provider fallback", () => {const bridge = makeBridge();const mastra = makeMastraHarness();diff --git a/apps/server/src/provider/Layers/AgentController.ts b/apps/server/src/provider/Layers/AgentController.tsindex 3544e3fe5..dba108399 100644--- a/apps/server/src/provider/Layers/AgentController.ts+++ b/apps/server/src/provider/Layers/AgentController.ts@@ -27,8 +27,10 @@ import {RoutineId,TurnId,AKERU_TOOL_CATALOG,+ BALANCED_BOT_PERSONALITY_TONE,DEFAULT_BOT_SANDBOX_BROWSER_SHARING,type BotId,+ type BotPersonalityTone,type McpServer,type AkeruCreateRoutineInput,type ModelSelection,@@ -90,7 +92,10 @@ import {type AkeruMastraHarnessOptions,type AkeruMastraSession,} from "../AkeruMastraHarness.ts";-import { AKERU_BOT_TURN_INSTRUCTIONS } from "../AkeruAgentInstructions.ts";+import {+ AKERU_BOT_TURN_INSTRUCTIONS,+ createAkeruBotTurnInstructions,+} from "../AkeruAgentInstructions.ts";import type { ProviderInstanceRoutingInfo } from "../Services/ProviderAdapterRegistry.ts";import { createAkeruChannelRuntime, type AkeruChannelRuntime } from "../AkeruChannelRuntime.ts";import { createAkeruBotStateRuntime, type AkeruBotStateRuntime } from "../AkeruBotStateRuntime.ts";@@ -158,6 +163,8 @@ interface ResolvedEngine {readonly mastraModelId: string;readonly mode: "default" | "plan";readonly botConversation: boolean;+ readonly botName?: string;+ readonly personalityTone?: BotPersonalityTone;}function mastraModelOptions(resolved: ResolvedEngine) {@@ -739,6 +746,8 @@ const make = (options?: AgentControllerLiveOptions) =>readonly cwd: string | undefined;readonly provider: ProviderDriverKind;readonly providerInstanceId: ProviderInstanceId;+ readonly botName: string | undefined;+ readonly personalityTone: BotPersonalityTone;}>();let delegationRuntime = options?.delegationRuntime;@@ -1697,6 +1706,7 @@ const make = (options?: AgentControllerLiveOptions) =>...(input.engine.options ? { options: input.engine.options } : {}),};const inspected = yield* inspectEngine(modelSelection);+ const previous = resolvedByThread.get(String(input.threadId));const resolved: ResolvedEngine = {modelSelection,provider: inspected.routing.driverKind,@@ -1704,6 +1714,10 @@ const make = (options?: AgentControllerLiveOptions) =>mastraModelId: mastraModelId(inspected.routing.driverKind, modelSelection.model),mode: input.mode,botConversation: input.botConversation,+ ...(previous?.botName ? { botName: previous.botName } : {}),+ ...(previous?.personalityTone !== undefined+ ? { personalityTone: previous.personalityTone }+ : {}),};resolvedByThread.set(String(input.threadId), resolved);const active = sessions.get(String(input.threadId));@@ -1801,6 +1815,13 @@ const make = (options?: AgentControllerLiveOptions) =>detail: `Thread '${threadId}' has no resolved engine.`,});}+ const personalityTone =+ input.personalityTone ?? bot?.personalityTone ?? BALANCED_BOT_PERSONALITY_TONE;+ resolvedByThread.set(key, {+ ...resolved,+ ...(input.botName ? { botName: input.botName } : {}),+ personalityTone,+ });if (usesMastraCode(resolved.provider)) {const routing = yield* legacyProviderBridge.getInstanceInfo(resolved.providerInstanceId);if (!routing.enabled) {@@ -1835,6 +1856,7 @@ const make = (options?: AgentControllerLiveOptions) =>yolo: false,botConversation: resolved.botConversation,botName: input.botName || "",+ personalityTone,}),);const toolSession = { ...existing.toolSession };@@ -1878,7 +1900,9 @@ const make = (options?: AgentControllerLiveOptions) =>existingLegacy?.workspaceResourceKey === workspaceResourceKey &&existingLegacy.cwd === input.cwd &&existingLegacy.provider === resolved.provider &&- existingLegacy.providerInstanceId === resolved.providerInstanceId+ existingLegacy.providerInstanceId === resolved.providerInstanceId &&+ existingLegacy.botName === input.botName &&+ existingLegacy.personalityTone === personalityTone) {const live = (yield* legacyProviderBridge.listSessions()).find((session) => session.threadId === threadId,@@ -1928,24 +1952,28 @@ const make = (options?: AgentControllerLiveOptions) =>}),).pipe(Effect.onError(() => clearPreviewMcpSession(threadId)));if (!usesMastraCode(resolved.provider)) {- return yield* legacyProviderBridge.startSession(threadId, input).pipe(- Effect.tap((session) =>- Effect.sync(() => {- legacyResourceIdentity.set(key, {- workspaceResourceKey,- cwd: input.cwd,- provider: resolved.provider,- providerInstanceId: resolved.providerInstanceId,- });- return session;- }),- ),- Effect.tapError(() =>- runMastra("resources.release", () =>- sessionResources.release(key, { destroy: true }),- ).pipe(Effect.ignoreCause({ log: true })),- ),- );+ return yield* legacyProviderBridge+ .startSession(threadId, { ...input, personalityTone })+ .pipe(+ Effect.tap((session) =>+ Effect.sync(() => {+ legacyResourceIdentity.set(key, {+ workspaceResourceKey,+ cwd: input.cwd,+ provider: resolved.provider,+ providerInstanceId: resolved.providerInstanceId,+ botName: input.botName,+ personalityTone,+ });+ return session;+ }),+ ),+ Effect.tapError(() =>+ runMastra("resources.release", () =>+ sessionResources.release(key, { destroy: true }),+ ).pipe(Effect.ignoreCause({ log: true })),+ ),+ );}const workspace = "botWorkspace" in resources ? resources.botWorkspace : undefined;const userComputerWorkspace =@@ -2091,6 +2119,7 @@ const make = (options?: AgentControllerLiveOptions) =>yolo: false,botConversation: resolved.botConversation,...(input.botName ? { botName: input.botName } : {}),+ personalityTone,...(modelOptions ? { modelOptions } : {}),}),);@@ -2190,7 +2219,15 @@ const make = (options?: AgentControllerLiveOptions) =>resolved?.botConversation === true && String(resolved.provider) !== "claudeAgent"? {...providerInput,- input: [AKERU_BOT_TURN_INSTRUCTIONS, providerInput.input]+ input: [+ createAkeruBotTurnInstructions({+ ...(resolved.botName ? { name: resolved.botName } : {}),+ ...(resolved.personalityTone !== undefined+ ? { personalityTone: resolved.personalityTone }+ : {}),+ }),+ providerInput.input,+ ].filter(Boolean).join("\n\n"),}diff --git a/apps/server/src/provider/Layers/ClaudeAdapter.test.ts b/apps/server/src/provider/Layers/ClaudeAdapter.test.tsindex 9646403a0..2a4e69867 100644--- a/apps/server/src/provider/Layers/ClaudeAdapter.test.ts+++ b/apps/server/src/provider/Layers/ClaudeAdapter.test.ts@@ -491,6 +491,7 @@ describe("ClaudeAdapterLive", () => {runtimeMode: "full-access",botId: "bot-1" as never,botName: "Mina",+ personalityTone: 100,});const systemPrompt = harness.getLastCreateQueryInput()?.options.systemPrompt;@@ -501,6 +502,7 @@ describe("ClaudeAdapterLive", () => {assert.include(appendedInstructions, "Before you use a tool");assert.include(appendedInstructions, "automatic continuation");assert.include(appendedInstructions, "You are Mina");+ assert.include(appendedInstructions, "100/100, a 0% chill and 100% professional blend");assert.match(appendedInstructions, /Today is [A-Z][a-z]+, [A-Z][a-z]+ \d{1,2}, \d{4}/);}).pipe(Effect.provideService(Random.Random, makeDeterministicRandomService()),diff --git a/apps/server/src/provider/Layers/ClaudeAdapter.ts b/apps/server/src/provider/Layers/ClaudeAdapter.tsindex 111913033..557a8ffd7 100644--- a/apps/server/src/provider/Layers/ClaudeAdapter.ts+++ b/apps/server/src/provider/Layers/ClaudeAdapter.ts@@ -4495,7 +4495,12 @@ export const makeClaudeAdapter = Effect.fn("makeClaudeAdapter")(function* (type: "preset",preset: "claude_code",append: input.botId- ? createAkeruBotInstructions({ ...(input.botName ? { name: input.botName } : {}) })+ ? createAkeruBotInstructions({+ ...(input.botName ? { name: input.botName } : {}),+ ...(input.personalityTone !== undefined+ ? { personalityTone: input.personalityTone }+ : {}),+ }): createAkeruAgentInstructions(),},settingSources: [...CLAUDE_SETTING_SOURCES],diff --git a/apps/server/src/ws.ts b/apps/server/src/ws.tsindex 44650b9c4..efdecd8d1 100644--- a/apps/server/src/ws.ts+++ b/apps/server/src/ws.ts@@ -21,6 +21,7 @@ import {type AuthAccessStreamEvent,type AuthEnvironmentScope,AuthSessionId,+ BALANCED_BOT_PERSONALITY_TONE,BotId,ClientSurface,CommandId,@@ -1136,6 +1137,7 @@ const makeWsRpcLayer = (sandbox: nextBot.sandbox,runtimeMode: nextBot.runtimeMode,usageCap: nextBot.usageCap,+ personalityTone: nextBot.personalityTone ?? BALANCED_BOT_PERSONALITY_TONE,voiceEnabled: nextBot.voiceEnabled,channelBindings: ChannelRuntime.channelBindingsForRuntime(nextBot.channelBindings ?? [],diff --git a/apps/web/src/components/roster/ActiveBotHeaderChip.tsx b/apps/web/src/components/roster/ActiveBotHeaderChip.tsxindex 10ee627ec..14563818f 100644--- a/apps/web/src/components/roster/ActiveBotHeaderChip.tsx+++ b/apps/web/src/components/roster/ActiveBotHeaderChip.tsx@@ -1,15 +1,19 @@+import { useNavigate } from "@tanstack/react-router";import { useState } from "react";+import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";import { AvatarPickerDialog } from "./AvatarPickerDialog";import { BotAvatarView } from "./BotAvatarView";import { useSelectedBot } from "./rosterStore";/**- * The active bot's avatar and name, leading the chat header. Clicking the- * avatar opens the avatar picker for that bot.+ * The active bot's avatar and name, leading the chat header. The avatar opens+ * the avatar picker; the name opens that bot's settings, which is the+ * contextual way into everything else the bot owns.*/export function ActiveBotHeaderChip() {const bot = useSelectedBot();+ const navigate = useNavigate();const [pickerOpen, setPickerOpen] = useState(false);if (bot === null) return null;return (@@ -23,7 +27,24 @@ export function ActiveBotHeaderChip() {><BotAvatarView avatar={bot.avatar} name={bot.name} className="size-6" /></button>- <span className="max-w-32 truncate text-sm font-medium text-foreground">{bot.name}</span>+ <Tooltip>+ <TooltipTrigger+ render={+ <button+ type="button"+ aria-label={`Settings for ${bot.name}`}+ data-bot-hover+ onClick={() => {+ void navigate({ to: "/bots/$botId/settings", params: { botId: bot.id } });+ }}+ className="max-w-32 cursor-pointer truncate rounded-sm text-sm font-medium text-foreground outline-none transition-colors hover:text-foreground/80 focus-visible:ring-2 focus-visible:ring-ring"+ >+ {bot.name}+ </button>+ }+ />+ <TooltipPopup side="bottom">Bot settings</TooltipPopup>+ </Tooltip>{pickerOpen ? <AvatarPickerDialog bot={bot} open onOpenChange={setPickerOpen} /> : null}</div>);diff --git a/apps/web/src/components/roster/BotDetailsPanel.test.tsx b/apps/web/src/components/roster/BotDetailsPanel.test.tsxindex 8773d9c84..3205709ef 100644--- a/apps/web/src/components/roster/BotDetailsPanel.test.tsx+++ b/apps/web/src/components/roster/BotDetailsPanel.test.tsx@@ -1,7 +1,6 @@// @effect-diagnostics nodeBuiltinImport:off - The route contract reads its source.import * as NodeFS from "node:fs";-import { BotId, ProjectId } from "@t3tools/contracts";import { renderToStaticMarkup } from "react-dom/server";import { describe, expect, it } from "vite-plus/test";@@ -34,33 +33,22 @@ const bot: Bot = {};describe("BotDetailsPanel", () => {- it("shows the per-bot profile editor with simple panel chrome", () => {+ it("shows a compact overview that hands settings off to the full page", () => {const markup = renderToStaticMarkup(<BotDetailsPanel bot={bot} />);expect(markup).toContain("Akeru's browser");expect(markup).toContain('data-testid="bot-browser-preview"');- expect(markup).toContain(">Settings</h2>");- expect(markup).toContain('aria-label="Change bot avatar"');- expect(markup).toContain('aria-label="Bot name"');- expect(markup).toContain('aria-label="Bot label"');- expect(markup).toContain('aria-label="Bot description"');- expect(markup).toContain("Connect a provider");- expect(markup).toContain("Token hard stop");- expect(markup).toContain('aria-label="Token hard stop"');- expect(markup).toContain(">Sandbox</div>");- expect(markup).toContain('aria-label="Sandbox provider"');- expect(markup).toContain('aria-label="Bot usage"');- expect(markup).toContain(">Voice calls</span>");- expect(markup).toContain('aria-label="Enable voice calls for Akeru"');- expect(markup).toContain('aria-label="Bot usage"');- expect(markup).toContain(">Memory</div>");- expect(markup).toContain('aria-label="Manage bot memory"');- expect(markup).toContain("Facts and history");- expect(markup).toContain(">Tools</div>");- expect(markup).toContain("No workspace tools");- expect(markup).toContain(">Channels</div>");- expect(markup).toContain('aria-label="Manage bot channels"');- expect(markup).toContain("No channels");- expect(markup).toContain(">Manage</span>");+ expect(markup).toContain(">Bot</h2>");+ expect(markup).toContain("Akeru");+ expect(markup).toContain("Research");+ expect(markup).toContain("Finds evidence and explains what matters.");+ expect(markup).toContain("Open bot settings");+ expect(markup).toContain("Personality");+ expect(markup).toContain("Balanced");+ expect(markup).toContain("App default");+ expect(markup).toContain("Sandbox");+ expect(markup).not.toContain('aria-label="Bot name"');+ expect(markup).not.toContain('aria-label="Bot description"');+ expect(markup).not.toContain("Token hard stop");expect(markup).toContain('aria-label="Collapse Akeru bot sidebar"');expect(markup).toContain('aria-label="Open Akeru bot sidebar"');expect(markup).toContain("Routines");@@ -70,32 +58,6 @@ describe("BotDetailsPanel", () => {expect(markup).toContain("border-t border-border");});- it.each(["disconnected", "failed", "needs-reconnect"] as const)(- "shows an assigned %s channel without claiming it is connected",- (status) => {- const markup = renderToStaticMarkup(- <BotDetailsPanel- bot={{- ...bot,- channelBindings: [- {- botId: BotId.make(bot.id),- provider: "slack",- projectId: ProjectId.make("project-1"),- status,- externalIdentity: null,- connectedAt: null,- sentMessageIds: [],- },- ],- }}- />,- );- expect(markup).toContain("0 of 1 connected");- expect(markup).not.toContain("No channels");- },- );-it("sets, clears, and rejects invalid hard stops", () => {expect(parseBotUsageCapInput("50000")).toEqual({valid: true,@@ -134,17 +96,24 @@ describe("BotDetailsPanel", () => {expect(source).toContain("RIGHT_PANEL_INLINE_LAYOUT_MEDIA_QUERY");});- it("owns model and reasoning controls in the bot sidebar", () => {- const source = NodeFS.readFileSync(new URL("./BotDetailsPanel.tsx", import.meta.url), "utf8");+ it("keeps model and reasoning controls on the full settings page", () => {+ const panelSource = NodeFS.readFileSync(+ new URL("./BotDetailsPanel.tsx", import.meta.url),+ "utf8",+ );+ const settingsSource = NodeFS.readFileSync(+ new URL("./BotSettingsPage.tsx", import.meta.url),+ "utf8",+ );const composerSource = NodeFS.readFileSync(new URL("./BotPromptComposer.tsx", import.meta.url),"utf8",);- expect(source).toContain("<BotModelPicker");- expect(source).toContain("<TraitsPicker");- expect(source).toContain(">Reasoning</div>");- expect(source).toContain("options: modelOptions");+ expect(panelSource).not.toContain("<BotModelPicker");+ expect(panelSource).not.toContain("<TraitsPicker");+ expect(settingsSource).toContain("<BotModelPicker");+ expect(settingsSource).toContain("<TraitsPicker");expect(composerSource).not.toContain("BotModelPicker");expect(composerSource).not.toContain("TraitsPicker");expect(composerSource).not.toContain("reasoningPicker");@@ -190,12 +159,9 @@ describe("BotDetailsPanel", () => {"utf8",);expect(source).toContain("<BotDetailsPanel");- expect(source).toContain("onSaveBot=");expect(source).toContain("threadRef={threadRef}");- expect(source).toContain("voiceEnabled,");- expect(source).toContain("usageCap,");- expect(source).toContain("sandbox,");- expect(source).toContain("disabledMcpServerIds,");+ expect(source).toContain("onOpenSettings={() =>");+ expect(source).not.toContain("onSaveBot=");expect(source).not.toContain("RightPanelTabs");expect(source).not.toContain("ThreadTerminalDrawer");});diff --git a/apps/web/src/components/roster/BotDetailsPanel.tsx b/apps/web/src/components/roster/BotDetailsPanel.tsxindex 000afb2b2..25c82c5cf 100644--- a/apps/web/src/components/roster/BotDetailsPanel.tsx+++ b/apps/web/src/components/roster/BotDetailsPanel.tsx@@ -1,66 +1,26 @@import { useAtomValue } from "@effect/atom-react";-import {- ProviderInstanceId,- type BotEngine,- type EnvironmentId,- type McpServerId,-} from "@t3tools/contracts";+import type { ScopedThreadRef } from "@t3tools/contracts";import {Cancel01Icon,- Brain02Icon,- Edit02Icon,- Link02Icon,PanelRightCloseIcon,PanelRightIcon,- WrenchIcon,+ Settings02Icon,} from "@hugeicons/core-free-icons";-import { useEffect, useMemo, useReducer, useState, type ReactNode } from "react";+import { useEffect, useReducer, useState, type ReactNode } from "react";-import { usePrimarySettings } from "../../hooks/useSettings";import { resolveShortcutCommand, shortcutLabelForCommand } from "../../keybindings";import { RIGHT_PANEL_INLINE_LAYOUT_MEDIA_QUERY } from "../../rightPanelLayout";-import {- getCustomModelOptionsByInstance,- resolveAppModelSelectionForInstance,- resolveAppModelSelectionState,-} from "../../modelSelection";-import {- applyProviderInstanceSettings,- deriveProviderInstanceEntries,- resolveSelectableProviderInstanceEntry,- sortProviderInstanceEntries,-} from "../../providerInstances";-import { usePrimaryEnvironmentId } from "../../state/environments";-import { environmentMcpServersAtom } from "../../state/mcpServers";-import { primaryServerKeybindingsAtom, primaryServerProvidersAtom } from "../../state/server";+import { primaryServerKeybindingsAtom } from "../../state/server";import { AppIcon } from "../ui/app-icon";import { Button } from "../ui/button";-import { Input } from "../ui/input";-import { Select, SelectItem, SelectPopup, SelectTrigger, SelectValue } from "../ui/select";import { Sheet, SheetClose, SheetPopup, SheetTitle } from "../ui/sheet";-import { Textarea } from "../ui/textarea";-import { Switch } from "../ui/switch";import { Tooltip, TooltipPopup, TooltipTrigger } from "../ui/tooltip";-import { shouldRenderTraitsControls, TraitsPicker } from "../chat/TraitsPicker";-import { AvatarPickerDialog } from "./AvatarPickerDialog";import { BotAvatarView } from "./BotAvatarView";import { BotBrowserPreview } from "./BotBrowserPreview";-import { BotChannelsSheet } from "./BotChannelsSheet";-import { BotModelPicker } from "./BotModelPicker";-import { BotUsageSection } from "./BotUsageSection";-import { BotMemorySheet } from "./BotMemorySheet";-import {- BOT_SANDBOX_OPTIONS,- botSandboxChoice,- botSandboxLabel,- type BotSandboxChoice,-} from "./botSandbox";-import { BotToolsSheet, buildBotToolItems } from "./BotToolsSheet";+import { botPersonalityToneLabel, canonicalizeBotPersonalityTone } from "./botPersonalityTone";+import { botSandboxChoice, botSandboxLabel } from "./botSandbox";import { RoutinePanel, type RoutinePanelProps } from "./RoutinePanel";import type { Bot } from "./types";-import type { ScopedThreadRef } from "@t3tools/contracts";--const NO_ENVIRONMENT = "" as EnvironmentId;type BotDetailsPanelState = {readonly desktopOpen: boolean;@@ -85,463 +45,75 @@ export function reduceBotDetailsPanelState(return { ...state, mobileOpen: action.open };}-export function parseBotUsageCapInput(input: string): {- readonly valid: boolean;- readonly value: Bot["usageCap"];-} {- if (input.trim().length === 0) return { valid: true, value: null };- const limit = Number(input);- if (!Number.isSafeInteger(limit) || limit <= 0) return { valid: false, value: null };- return { valid: true, value: { unit: "tokens", limit } };-}--export function resolveBotUsageCapForProvider(- input: string,- providerDriver?: string,-): {- readonly available: boolean;- readonly valid: boolean;- readonly value: Bot["usageCap"];-} {- if (providerDriver === "cursor" || providerDriver === "grok") {- return { available: false, valid: true, value: null };- }- return { available: true, ...parseBotUsageCapInput(input) };-}--export interface BotProfileUpdate {- readonly name: string;- readonly label: string | null;- readonly description: string | null;- readonly engine: BotEngine | null;- readonly usageCap: Bot["usageCap"];- readonly sandbox: Bot["sandbox"];- readonly voiceEnabled: boolean;- readonly disabledMcpServerIds: readonly McpServerId[];-}+export {+ parseBotUsageCapInput,+ resolveBotUsageCapForProvider,+ type BotProfileUpdate,+} from "./useBotProfileDraft";-function BotProfileEditor({+function BotOverview({bot,- onSave,- threadRef,- active,+ onOpenSettings,routinePanel,}: {readonly bot: Bot;- readonly onSave?: (input: BotProfileUpdate) => Promise<boolean>;- readonly threadRef: ScopedThreadRef | null;- readonly active: boolean;+ readonly onOpenSettings?: () => void;readonly routinePanel?: Omit<RoutinePanelProps, "botName">;}) {- const providers = useAtomValue(primaryServerProvidersAtom);- const environmentId = usePrimaryEnvironmentId();- const mcpServers = useAtomValue(environmentMcpServersAtom(environmentId ?? NO_ENVIRONMENT));- const settings = usePrimarySettings();- const [name, setName] = useState(bot.name);- const [label, setLabel] = useState(bot.label ?? "");- const [description, setDescription] = useState(bot.description ?? "");- const [avatarOpen, setAvatarOpen] = useState(false);- const [saving, setSaving] = useState(false);- const [saved, setSaved] = useState(false);- const [engineChanged, setEngineChanged] = useState(false);- const [usageCap, setUsageCap] = useState(() => bot.usageCap?.limit.toString() ?? "");- const [toolsOpen, setToolsOpen] = useState(false);- const [memoryOpen, setMemoryOpen] = useState(false);- const [channelsOpen, setChannelsOpen] = useState(false);- const [sandbox, setSandbox] = useState<BotSandboxChoice>(() => botSandboxChoice(bot.sandbox));- const [voiceEnabled, setVoiceEnabled] = useState(bot.voiceEnabled);- const [disabledMcpServerIds, setDisabledMcpServerIds] = useState<readonly McpServerId[]>(- bot.disabledMcpServerIds,- );-- const instanceEntries = useMemo(- () =>- sortProviderInstanceEntries(- applyProviderInstanceSettings(deriveProviderInstanceEntries(providers), settings),- ),- [providers, settings],- );- const defaultSelection = useMemo(- () => resolveAppModelSelectionState(settings, providers),- [providers, settings],- );- const [provider, setProvider] = useState(bot.engine?.provider ?? defaultSelection.instanceId);- const activeEntry = useMemo(- () =>- resolveSelectableProviderInstanceEntry(instanceEntries, ProviderInstanceId.make(provider)),- [instanceEntries, provider],- );- const [model, setModel] = useState<string>(- () =>- bot.engine?.model ??- (activeEntry- ? resolveAppModelSelectionForInstance(activeEntry.instanceId, settings, providers, null)- : null) ??- defaultSelection.model,- );- const [modelOptions, setModelOptions] = useState(- () =>- bot.engine?.options ??- (bot.engine?.provider === defaultSelection.instanceId &&- bot.engine.model === defaultSelection.model- ? defaultSelection.options- : undefined),- );- const modelOptionsByInstance = useMemo(- () => getCustomModelOptionsByInstance(settings, providers),- [providers, settings],- );-- useEffect(() => {- if (engineChanged) return;- setProvider(bot.engine?.provider ?? defaultSelection.instanceId);- if (bot.engine?.model) setModel(bot.engine.model);- setModelOptions(- bot.engine?.options ??- (bot.engine?.provider === defaultSelection.instanceId &&- bot.engine.model === defaultSelection.model- ? defaultSelection.options- : undefined),- );- }, [bot.engine, defaultSelection, engineChanged]);-- const normalizedLabel = label.trim() || null;- const normalizedDescription = description.trim() || null;- const nextEngine: Bot["engine"] =- engineChanged && model- ? {- provider,- model,- ...(modelOptions ? { options: modelOptions } : {}),- }- : bot.engine;- const showModelOptions =- activeEntry !== undefined &&- model.length > 0 &&- shouldRenderTraitsControls({- provider: activeEntry.driverKind,- models: activeEntry.models,- model,- prompt: "",- modelOptions,- allowPromptInjectedEffort: false,- planModeEnabled: settings.planModeEnabled,- });- const resolvedUsageCap = resolveBotUsageCapForProvider(usageCap, activeEntry?.driverKind);- const usageCapDirty =- !resolvedUsageCap.valid || resolvedUsageCap.value?.limit !== bot.usageCap?.limit;- const nextSandbox: Bot["sandbox"] = sandbox;- const tools = useMemo(() => buildBotToolItems(mcpServers), [mcpServers]);- const enabledToolCount = tools.filter(- (tool) => tool.workspaceEnabled && !disabledMcpServerIds.includes(tool.id),- ).length;- const assignedChannels = (bot.channelBindings ?? []).filter(- (binding) => binding.connectionId || binding.projectId || binding.status !== "disconnected",- );- const connectedChannelCount = assignedChannels.filter(- (binding) => binding.status === "connected",- ).length;- const toolOverridesDirty =- [...disabledMcpServerIds].sort().join("\u0000") !==- [...bot.disabledMcpServerIds].sort().join("\u0000");- const sandboxDirty = sandbox !== botSandboxChoice(bot.sandbox);- const dirty =- name.trim() !== bot.name ||- normalizedLabel !== bot.label ||- normalizedDescription !== bot.description ||- engineChanged ||- usageCapDirty ||- sandboxDirty ||- voiceEnabled !== bot.voiceEnabled ||- toolOverridesDirty;-- const markChanged = () => setSaved(false);-return (- <div className="min-h-0 flex-1 overflow-y-auto px-5 pb-6">- <div className="flex flex-col items-center pb-7 pt-6">- <button- type="button"- aria-label="Change bot avatar"- onClick={() => setAvatarOpen(true)}- className="group relative rounded-2xl outline-none focus-visible:ring-2 focus-visible:ring-ring"- >- <BotAvatarView avatar={bot.avatar} name={name || bot.name} className="size-20" />- <span className="absolute -bottom-1 -right-1 flex size-7 items-center justify-center rounded-full border border-border bg-background text-muted-foreground shadow-sm transition-colors group-hover:text-foreground">- <AppIcon className="size-3.5" icon={Edit02Icon} />- </span>- </button>- </div>-- <div className="space-y-5">- <label className="block space-y-2 text-sm font-medium">- Name- <Input- aria-label="Bot name"- value={name}- onChange={(event) => {- setName(event.currentTarget.value);- markChanged();- }}- />- </label>-- <label className="block space-y-2 text-sm font-medium">- <span>- Label <span className="font-normal text-muted-foreground">(optional)</span>- </span>- <Input- aria-label="Bot label"- value={label}- placeholder="Research, marketing, admin"- onChange={(event) => {- setLabel(event.currentTarget.value);- markChanged();- }}- />- </label>-- <label className="block space-y-2 text-sm font-medium">- Description- <Textarea- aria-label="Bot description"- value={description}- placeholder="What this bot is for"- rows={5}- className="min-h-28 resize-none"- onChange={(event) => {- setDescription(event.currentTarget.value);- markChanged();- }}- />- </label>-- <div className="space-y-2">- <div className="text-sm font-medium">Model</div>- <div className="flex min-h-10 items-center rounded-lg border border-border bg-muted/20 px-2">- {activeEntry && model ? (- <BotModelPicker- activeInstanceId={activeEntry.instanceId}- model={model}- instanceEntries={instanceEntries}- modelOptionsByInstance={modelOptionsByInstance}- onChange={(instanceId, nextModel) => {- setProvider(instanceId);- setModel(nextModel);- setModelOptions(- defaultSelection.instanceId === instanceId &&- defaultSelection.model === nextModel- ? defaultSelection.options- : undefined,- );- setEngineChanged(true);- markChanged();- }}- />- ) : (- <span className="px-1 text-sm text-muted-foreground">Connect a provider</span>- )}- </div>- </div>-- {showModelOptions && activeEntry ? (- <div className="space-y-2">- <div className="text-sm font-medium">Reasoning</div>- <div className="flex min-h-10 items-center rounded-lg border border-border bg-muted/20 px-2">- <TraitsPicker- provider={activeEntry.driverKind}- instanceId={activeEntry.instanceId}- models={activeEntry.models}- model={model}- prompt=""- onPromptChange={() => {}}- modelOptions={modelOptions}- allowPromptInjectedEffort={false}- planModeEnabled={settings.planModeEnabled}- triggerClassName="w-full max-w-none justify-between"- onModelOptionsChange={(nextOptions) => {- setModelOptions(nextOptions);- setEngineChanged(true);- markChanged();- }}- />- </div>- </div>+ <div className="min-h-0 flex-1 overflow-y-auto px-5 pb-6 pt-6">+ <div className="flex flex-col items-center text-center">+ <BotAvatarView avatar={bot.avatar} name={bot.name} className="size-16" />+ <h3 className="mt-3 text-base font-semibold">{bot.name}</h3>+ {bot.label ? <p className="mt-0.5 text-sm text-muted-foreground">{bot.label}</p> : null}+ {bot.description ? (+ <p className="mt-3 line-clamp-3 max-w-64 text-sm leading-relaxed text-muted-foreground">+ {bot.description}+ </p>) : null}+ </div>- <BotUsageSection environmentId={active ? environmentId : null} botId={bot.id} />-- <div className="space-y-2">- <div className="text-sm font-medium">Memory</div>- <button- type="button"- aria-label="Manage bot memory"- disabled={!threadRef}- onClick={() => setMemoryOpen(true)}- className="flex min-h-10 w-full items-center gap-3 rounded-lg border border-border bg-muted/20 px-3 text-left outline-none transition-colors enabled:hover:bg-muted/40 focus-visible:ring-2 focus-visible:ring-ring disabled:opacity-50"- >- <AppIcon className="size-4 shrink-0 text-muted-foreground" icon={Brain02Icon} />- <span className="min-w-0 flex-1 text-sm">Facts and history</span>- <span className="text-xs text-muted-foreground">Manage</span>- </button>- </div>-- <div className="space-y-2">- <div className="text-sm font-medium">Sandbox</div>- <Select- value={sandbox}- onValueChange={(value) => {- if (value === null) return;- if (!BOT_SANDBOX_OPTIONS.some((option) => option.value === value)) return;- setSandbox(value as BotSandboxChoice);- markChanged();- }}- >- <SelectTrigger className="w-full bg-muted/20" aria-label="Sandbox provider">- <SelectValue>{botSandboxLabel(sandbox)}</SelectValue>- </SelectTrigger>- <SelectPopup>- {BOT_SANDBOX_OPTIONS.map((option) => (- <SelectItem key={option.value} value={option.value}>- {option.label}- </SelectItem>- ))}- </SelectPopup>- </Select>- </div>-- {resolvedUsageCap.available ? (- <label className="block space-y-2 text-sm font-medium">- <span>- Token hard stop <span className="font-normal text-muted-foreground">(optional)</span>- </span>- <Input- aria-label="Token hard stop"- type="number"- inputMode="numeric"- min={1}- step={1}- value={usageCap}- placeholder="No limit"- onChange={(event) => {- setUsageCap(event.currentTarget.value);- markChanged();- }}- />- </label>- ) : (- <div className="flex min-h-10 items-center justify-between rounded-lg border border-border bg-muted/20 px-3">- <span className="text-sm font-medium">Token hard stop</span>- <span className="text-sm text-muted-foreground">Unavailable for this provider</span>- </div>- )}-- <div className="flex min-h-10 items-center justify-between rounded-lg border border-border bg-muted/20 px-3">- <span className="text-sm font-medium">Voice calls</span>- <Switch- checked={voiceEnabled}- onCheckedChange={(checked) => {- setVoiceEnabled(Boolean(checked));- markChanged();- }}- aria-label={`${voiceEnabled ? "Disable" : "Enable"} voice calls for ${bot.name}`}- />+ <Button+ className="mt-6 w-full justify-center"+ variant="outline"+ disabled={!onOpenSettings}+ onClick={onOpenSettings}+ >+ <AppIcon className="size-4" icon={Settings02Icon} />+ Open bot settings+ </Button>++ <dl className="mt-6 divide-y divide-border/70 border-y border-border/70 text-sm">+ <div className="flex items-center justify-between gap-4 py-3">+ <dt className="text-muted-foreground">Personality</dt>+ <dd className="font-medium">+ {botPersonalityToneLabel(canonicalizeBotPersonalityTone(bot.personalityTone))}+ </dd></div>-- <div className="space-y-2">- <div className="text-sm font-medium">Tools</div>- <button- type="button"- aria-label="Manage bot tools"- aria-expanded={toolsOpen}- onClick={() => setToolsOpen(true)}- className="flex min-h-10 w-full items-center gap-3 rounded-lg border border-border bg-muted/20 px-3 text-left outline-none transition-colors hover:bg-muted/40 focus-visible:ring-2 focus-visible:ring-ring"- >- <AppIcon className="size-4 shrink-0 text-muted-foreground" icon={WrenchIcon} />- <span className="min-w-0 flex-1 text-sm">- {tools.length === 0- ? "No workspace tools"- : `${enabledToolCount} of ${tools.length} enabled`}- </span>- <span className="text-xs text-muted-foreground">Manage</span>- </button>+ <div className="flex items-center justify-between gap-4 py-3">+ <dt className="text-muted-foreground">Model</dt>+ <dd className="max-w-44 truncate font-medium">{bot.engine?.model ?? "App default"}</dd></div>-- <div className="space-y-2">- <div className="text-sm font-medium">Channels</div>- <button- type="button"- aria-label="Manage bot channels"- aria-expanded={channelsOpen}- onClick={() => setChannelsOpen(true)}- className="flex min-h-10 w-full items-center gap-3 rounded-lg border border-border bg-muted/20 px-3 text-left outline-none transition-colors hover:bg-muted/40 focus-visible:ring-2 focus-visible:ring-ring"- >- <AppIcon className="size-4 shrink-0 text-muted-foreground" icon={Link02Icon} />- <span className="min-w-0 flex-1 text-sm">- {assignedChannels.length === 0- ? "No channels"- : `${connectedChannelCount} of ${assignedChannels.length} connected`}- </span>- <span className="text-xs text-muted-foreground">Manage</span>- </button>+ <div className="flex items-center justify-between gap-4 py-3">+ <dt className="text-muted-foreground">Sandbox</dt>+ <dd className="font-medium">{botSandboxLabel(botSandboxChoice(bot.sandbox))}</dd></div>- </div>-- <div className="mt-7 flex items-center justify-end gap-3">- {saved ? <span className="mr-auto text-xs text-success">Saved</span> : null}- <Button- size="sm"- disabled={saving || !dirty || !name.trim() || !resolvedUsageCap.valid || !onSave}- onClick={() => {- if (!onSave) return;- setSaving(true);- void onSave({- name: name.trim(),- label: normalizedLabel,- description: normalizedDescription,- engine: nextEngine,- usageCap: resolvedUsageCap.value,- sandbox: nextSandbox,- voiceEnabled,- disabledMcpServerIds,- }).then((success) => {- setSaving(false);- setSaved(success);- if (success) setEngineChanged(false);- });- }}- >- {saving ? "Saving" : "Save"}- </Button>- </div>+ </dl><RoutinePanel botName={bot.name} {...(routinePanel ?? { status: "unavailable" as const })} />-- <AvatarPickerDialog bot={bot} open={avatarOpen} onOpenChange={setAvatarOpen} />- <BotToolsSheet- open={toolsOpen}- onOpenChange={setToolsOpen}- servers={mcpServers}- disabledIds={disabledMcpServerIds}- onDisabledIdsChange={(ids) => {- setDisabledMcpServerIds(ids);- markChanged();- }}- />- <BotMemorySheet open={memoryOpen} onOpenChange={setMemoryOpen} threadRef={threadRef} />- <BotChannelsSheet bot={bot} open={channelsOpen} onOpenChange={setChannelsOpen} /></div>);}export function BotDetailsPanel({bot,- onSaveBot,+ onOpenSettings,threadRef = null,routinePanel,}: {readonly bot: Bot;- readonly onSaveBot?: (input: BotProfileUpdate) => Promise<boolean>;+ /** Opens the full bot settings page. Omitted when no router is available. */+ readonly onOpenSettings?: () => void;readonly threadRef?: ScopedThreadRef | null;readonly routinePanel?: Omit<RoutinePanelProps, "botName">;}) {@@ -590,16 +162,14 @@ export function BotDetailsPanel({{!browserExpanded || !canExpandBrowser ? (<><header className="relative flex h-[var(--workspace-topbar-height)] shrink-0 items-center justify-center px-4">- <h2 className="text-sm font-medium">Settings</h2>+ <h2 className="text-sm font-medium">Bot</h2><div className="absolute right-3 flex items-center min-[981px]:fixed min-[981px]:right-[var(--workspace-controls-right)] min-[981px]:top-[var(--workspace-controls-top)] min-[981px]:z-40 min-[981px]:h-[var(--workspace-topbar-height)]">{closeButton}</div></header>- <BotProfileEditor+ <BotOverviewbot={bot}- threadRef={threadRef}- active={active}- {...(onSaveBot ? { onSave: onSaveBot } : {})}+ {...(onOpenSettings ? { onOpenSettings } : {})}{...(routinePanel ? { routinePanel } : {})}/></>@@ -685,7 +255,7 @@ export function BotDetailsPanel({showCloseButton={false}side="right">- <SheetTitle className="sr-only">Edit {bot.name}</SheetTitle>+ <SheetTitle className="sr-only">{bot.name} overview</SheetTitle>{content(panelState.mobileOpen,<SheetClosediff --git a/apps/web/src/components/roster/BotPersonalityToneField.test.tsx b/apps/web/src/components/roster/BotPersonalityToneField.test.tsxnew file mode 100644index 000000000..1f3c0d93a--- /dev/null+++ b/apps/web/src/components/roster/BotPersonalityToneField.test.tsx@@ -0,0 +1,78 @@+import { renderToStaticMarkup } from "react-dom/server";+import { describe, expect, it, vi } from "vite-plus/test";++import { BotPersonalityToneField } from "./BotPersonalityToneField";+import { resolveBotPersonalityToneBand } from "./botPersonalityTone";++/** React escapes apostrophes in text nodes, so compare against escaped copy. */+function asRendered(text: string) {+ return text.replaceAll("'", "'");+}++const bot = {+ name: "Akeru",+ avatar: { kind: "blob", shape: "circle", color: "#5B7FD4" },+} as const;++function render(tone: number) {+ return renderToStaticMarkup(+ <BotPersonalityToneField bot={bot} tone={tone} onToneChange={() => {}} />,+ );+}++describe("BotPersonalityToneField", () => {+ it("offers exactly three personality choices", () => {+ const markup = render(50);+ expect(markup).toContain("Balanced");+ expect(markup).toContain("Chill");+ expect(markup).toContain("Professional");+ expect(markup).toContain('role="radiogroup"');+ expect(markup).toContain('aria-label="Personality for Akeru"');+ expect(markup.match(/role="radio"/gu)).toHaveLength(3);+ expect(markup.match(/aria-checked="true"/gu)).toHaveLength(1);+ expect(markup).not.toContain('type="range"');+ });++ it("swaps the illustrative reply as the value moves across bands", () => {+ const chill = render(0);+ const professional = render(100);++ expect(chill).toContain(asRendered(resolveBotPersonalityToneBand(0).sample));+ expect(professional).toContain(asRendered(resolveBotPersonalityToneBand(100).sample));+ expect(chill).not.toContain(asRendered(resolveBotPersonalityToneBand(100).sample));+ expect(professional).not.toContain(asRendered(resolveBotPersonalityToneBand(0).sample));+ });++ it("marks the preview as an illustration rather than a live reply", () => {+ const markup = render(50);+ expect(markup).toContain('data-testid="bot-personality-tone-preview"');+ expect(markup).toContain("An illustration of the band, not a live reply.");+ expect(markup).toContain("How Akeru might sound");+ });++ it("treats a bot saved before the field existed as balanced", () => {+ const markup = renderToStaticMarkup(+ <BotPersonalityToneField+ bot={bot}+ tone={undefined as unknown as number}+ onToneChange={() => {}}+ />,+ );+ expect(markup).toContain('aria-checked="true"');+ expect(markup).toContain(asRendered(resolveBotPersonalityToneBand(50).sample));+ });++ it("maps an older in-between value to the nearest visible mode", () => {+ const markup = render(75);+ expect(markup).toContain(asRendered(resolveBotPersonalityToneBand(100).sample));+ expect(markup).not.toContain(asRendered(resolveBotPersonalityToneBand(75).sample));+ });++ it("does not fire its change callback just by rendering", () => {+ const onToneChange = vi.fn();+ renderToStaticMarkup(+ <BotPersonalityToneField bot={bot} tone={35} onToneChange={onToneChange} />,+ );+ expect(onToneChange).not.toHaveBeenCalled();+ });+});diff --git a/apps/web/src/components/roster/BotPersonalityToneField.tsx b/apps/web/src/components/roster/BotPersonalityToneField.tsxnew file mode 100644index 000000000..28a302f46--- /dev/null+++ b/apps/web/src/components/roster/BotPersonalityToneField.tsx@@ -0,0 +1,109 @@+import { cn } from "../../lib/utils";+import { BotAvatarView } from "./BotAvatarView";+import {+ BOT_PERSONALITY_TONE_OPTIONS,+ BOT_PERSONALITY_TONE_SAMPLE_PROMPT,+ resolveBotPersonalityToneBand,+ resolveBotPersonalityToneOption,+} from "./botPersonalityTone";+import type { Bot } from "./types";++/**+ * Three personality baselines and a written sample. The sample is local copy,+ * so changing the choice never calls a provider.+ */+export function BotPersonalityToneField({+ bot,+ tone,+ onToneChange,+ className,+}: {+ readonly bot: Pick<Bot, "name" | "avatar">;+ readonly tone: number;+ readonly onToneChange: (tone: number) => void;+ readonly className?: string;+}) {+ const selected = resolveBotPersonalityToneOption(tone);+ const band = resolveBotPersonalityToneBand(selected.value);++ return (+ <div className={cn("space-y-4", className)}>+ <div className="space-y-3">+ <div+ role="radiogroup"+ aria-label={`Personality for ${bot.name}`}+ className="grid grid-cols-3 gap-2"+ >+ {BOT_PERSONALITY_TONE_OPTIONS.map((option) => {+ const active = option.value === selected.value;+ return (+ <button+ key={option.value}+ type="button"+ role="radio"+ aria-checked={active}+ onClick={() => onToneChange(option.value)}+ className={cn(+ "min-h-10 rounded-lg border px-3 text-sm font-medium outline-none transition-colors focus-visible:ring-2 focus-visible:ring-ring",+ active+ ? "border-primary/60 bg-primary/10 text-foreground"+ : "border-border bg-muted/20 text-muted-foreground hover:bg-muted/40 hover:text-foreground",+ )}+ >+ {option.label}+ </button>+ );+ })}+ </div>+ <p className="text-[13px] leading-[1.45] text-muted-foreground/80">{band.summary}</p>+ </div>++ <BotPersonalityTonePreview bot={bot} tone={selected.value} />+ </div>+ );+}++/**+ * A worked example of the current band. Written copy, not a generated reply,+ * so it costs nothing and stays stable while the choice changes.+ */+export function BotPersonalityTonePreview({+ bot,+ tone,+}: {+ readonly bot: Pick<Bot, "name" | "avatar">;+ readonly tone: number;+}) {+ const band = resolveBotPersonalityToneBand(tone);++ return (+ <figure+ className="space-y-3 rounded-xl bg-muted/30 p-4"+ data-testid="bot-personality-tone-preview"+ >+ <figcaption className="text-xs font-medium text-muted-foreground">+ How {bot.name} might sound+ </figcaption>++ <div className="flex justify-end">+ <p className="max-w-[85%] rounded-2xl rounded-br-sm bg-primary/10 px-3 py-2 text-[13px] leading-[1.45] text-foreground">+ {BOT_PERSONALITY_TONE_SAMPLE_PROMPT}+ </p>+ </div>++ <div className="flex items-end gap-2">+ <BotAvatarView avatar={bot.avatar} name={bot.name} className="size-6 shrink-0" />+ <p+ key={band.id}+ className="max-w-[85%] rounded-2xl rounded-bl-sm bg-background px-3 py-2 text-[13px] leading-[1.45] text-foreground shadow-sm/5"+ >+ {band.sample}+ </p>+ </div>++ <p className="text-[11px] leading-[1.4] text-muted-foreground/70">+ An illustration of the band, not a live reply.+ </p>+ </figure>+ );+}diff --git a/apps/web/src/components/roster/BotRosterSidebar.tsx b/apps/web/src/components/roster/BotRosterSidebar.tsxindex d9425e8e3..e62ca4fea 100644--- a/apps/web/src/components/roster/BotRosterSidebar.tsx+++ b/apps/web/src/components/roster/BotRosterSidebar.tsx@@ -21,6 +21,7 @@ import {PinIcon,PlusIcon,SearchIcon,+ SettingsIcon,UsersIcon,} from "lucide-react";import {@@ -261,6 +262,7 @@ const BotRosterRow = memo(function BotRosterRow({lastMessage,isActive,onSelect,+ onOpenSettings,pinned,onPin,canMoveUp,@@ -272,6 +274,7 @@ const BotRosterRow = memo(function BotRosterRow({lastMessage: RosterLastMessage | null;isActive: boolean;onSelect: (bot: Bot) => void;+ onOpenSettings: (bot: Bot) => void;pinned: boolean;onPin: (pinned: boolean) => void;canMoveUp: boolean;@@ -358,6 +361,10 @@ const BotRosterRow = memo(function BotRosterRow({}/><MenuPopup align="end">+ <MenuItem onClick={() => onOpenSettings(bot)}>+ <SettingsIcon />+ Bot settings+ </MenuItem><MenuItem onClick={() => onPin(!pinned)}><PinIcon />{pinned ? "Unpin" : "Pin"}@@ -896,6 +903,11 @@ export default function BotRosterSidebar() {void navigate({ to: "/bots/$botId", params: { botId: bot.id } });};+ const handleOpenBotSettings = (bot: Bot) => {+ useRosterStore.getState().selectBot(bot.id);+ void navigate({ to: "/bots/$botId/settings", params: { botId: bot.id } });+ };+const shortcutBots = useMemo(() => orderRosterBotsForShortcuts(bots, pinnedItems, []),[bots, pinnedItems],@@ -1136,6 +1148,7 @@ export default function BotRosterSidebar() {lastMessage={lastMessageByBotId[bot.id] ?? null}isActive={!groupRouteActive && selectedBotId === bot.id}onSelect={handleSelect}+ onOpenSettings={handleOpenBotSettings}pinned={pinned}onPin={(nextPinned) =>useRosterStorediff --git a/apps/web/src/components/roster/BotSettingsPage.test.ts b/apps/web/src/components/roster/BotSettingsPage.test.tsnew file mode 100644index 000000000..20d99d018--- /dev/null+++ b/apps/web/src/components/roster/BotSettingsPage.test.ts@@ -0,0 +1,164 @@+// @effect-diagnostics nodeBuiltinImport:off - These contracts read their source.+import * as NodeFS from "node:fs";++import { describe, expect, it } from "vite-plus/test";++function read(relativePath: string): string {+ return NodeFS.readFileSync(new URL(relativePath, import.meta.url), "utf8");+}++describe("bot settings page", () => {+ it("is a real route in the generated tree", () => {+ const route = read("../../routes/bots.$botId.settings.tsx");+ const tree = read("../../routeTree.gen.ts");++ expect(route).toContain('createFileRoute("/bots/$botId/settings")');+ expect(route).toContain("<BotSettingsPage");+ expect(route).toContain("Route.useParams().botId");+ // Same auth gate as the other full-page surfaces.+ expect(route).toContain('throw redirect({ to: "/pair", replace: true })');+ expect(tree).toContain("'/bots/$botId/settings'");+ expect(tree).toContain("./routes/bots.$botId.settings");+ });++ it("renders in the main content area with the shared settings primitives", () => {+ const source = read("./BotSettingsPage.tsx");++ expect(source).toContain("<SidebarInset");+ expect(source).toContain("<WorkspacePageHeader");+ expect(source).toContain("<SettingsPageContainer>");+ expect(source).toContain("<SettingsSection");+ expect(source).toContain("<SettingsRow");+ // A cramped modal is exactly what this page replaces.+ expect(source).not.toContain("<DialogPopup");+ expect(source).not.toContain("<SheetPopup");+ });++ it("groups the bot's own settings into named sections", () => {+ const source = read("./BotSettingsPage.tsx");++ expect(source).toContain('title="Bot"');+ expect(source).toContain('title="Voice and personality"');+ expect(source).toContain('title="Model"');+ expect(source).toContain('title="Workspace"');+ });++ it("saves through the shared bot update command", () => {+ const source = read("./BotSettingsPage.tsx");++ expect(source).toContain("useAtomCommand(botEnvironment.update");+ expect(source).toContain("botId: BotId.make(bot.id)");+ // The draft hook builds the payload, so the page cannot invent a shape.+ expect(source).toContain("useBotProfileDraft(bot, onSave)");+ expect(source).toContain('title: "Could not save bot settings"');+ expect(source).toContain('title: "Bot settings saved"');+ });++ it("reports saving, saved, and unsaved state from the shared draft", () => {+ const source = read("./BotSettingsPage.tsx");++ expect(source).toContain('aria-live="polite"');+ expect(source).toContain("draft.saved");+ expect(source).toContain("draft.dirty");+ expect(source).toContain("disabled={!draft.canSave || draft.saving}");+ expect(source).toContain('{draft.saving ? "Saving" : "Save"}');+ });++ it("protects unsaved settings from app navigation and page unload", () => {+ const source = read("./BotSettingsPage.tsx");++ expect(source).toContain("useBlocker({");+ expect(source).toContain('requestConfirmDialog("Discard unsaved bot settings?"');+ expect(source).toContain("enableBeforeUnload: () => draft.dirty");+ expect(source).toContain("disabled: !draft.dirty");+ });++ it("owns the three personality choices and anchors them for deep links", () => {+ const source = read("./BotSettingsPage.tsx");++ expect(source).toContain("<BotPersonalityToneField");+ expect(source).toContain('id="personality"');+ expect(source).toContain("tone={draft.personalityTone}");+ expect(source).toContain("draft.setPersonalityTone(tone)");+ // The baseline promise has to be on the page, not only in this test.+ expect(source).toContain("It is a baseline, not a costume.");+ });++ it("handles a bot that is gone instead of rendering an empty form", () => {+ const source = read("./BotSettingsPage.tsx");+ expect(source).toContain("This bot is no longer available.");+ });+});++describe("bot settings entry points", () => {+ it("opens from the chat header bot identity", () => {+ const source = read("./ActiveBotHeaderChip.tsx");++ expect(source).toContain('to: "/bots/$botId/settings"');+ expect(source).toContain("params: { botId: bot.id }");+ expect(source).toContain("aria-label={`Settings for ${bot.name}`}");+ // The avatar keeps its existing job.+ expect(source).toContain("aria-label={`Change avatar for ${bot.name}`}");+ });++ it("opens from the roster row overflow menu", () => {+ const source = read("./BotRosterSidebar.tsx");++ expect(source).toContain("Bot settings");+ expect(source).toContain("onOpenSettings(bot)");+ expect(source).toContain("const handleOpenBotSettings");+ expect(source).toContain('to: "/bots/$botId/settings"');+ expect(source).toContain("onOpenSettings={handleOpenBotSettings}");+ });++ it("keeps the in-chat panel compact and hands off to the full page", () => {+ const panel = read("./BotDetailsPanel.tsx");+ const route = read("../../routes/_chat.bots.$botId.tsx");++ expect(panel).toContain(+ "botPersonalityToneLabel(canonicalizeBotPersonalityTone(bot.personalityTone))",+ );+ expect(panel).toContain("Open bot settings");+ expect(panel).not.toContain("<BotModelPicker");+ expect(panel).not.toContain("<Input");+ expect(panel).not.toContain("BotPersonalityToneField");+ // The panel stays router-free; the route supplies navigation.+ expect(panel).not.toContain("@tanstack/react-router");+ expect(route).toContain("onOpenSettings={() =>");+ expect(route).toContain('to: "/bots/$botId/settings"');+ });++ it("does not add a permanent settings section for bots", () => {+ const settingsStore = read("../../settingsDialogStore.ts");+ const sections = /SETTINGS_SECTIONS = \[(?<body>[\s\S]*?)\] as const;/u.exec(settingsStore)+ ?.groups?.body;++ expect(sections).toBeDefined();+ // Per-bot settings are reached from the bot, not from a global nav entry.+ // The legacy `/settings/bots` deep link still redirects, and stays.+ expect(sections).not.toContain("bots");+ expect(settingsStore).toContain('if (slug === "bots") return "channels";');+ });+});++describe("global settings stay global", () => {+ it("leaves the shared sandbox and browser sharing policy in Settings", () => {+ const panels = read("../settings/SettingsPanels.tsx");+ const botSettings = read("./BotSettingsPage.tsx");++ // This is one environment-wide policy for every bot, not per-bot data.+ expect(panels).toContain("<BotSandboxBrowserSharingSettings");+ expect(panels).toContain("settings.botSandboxBrowserSharing");+ expect(botSettings).not.toContain("botSandboxBrowserSharing");+ });++ it("keeps the app-wide voice toggle out of per-bot settings", () => {+ const voice = read("../settings/VoiceSettings.tsx");+ const botSettings = read("./BotSettingsPage.tsx");++ expect(voice).toContain("settings.voice");+ // The bot owns only its own participation.+ expect(botSettings).toContain("draft.voiceEnabled");+ expect(botSettings).not.toContain("updateSettings(");+ });+});diff --git a/apps/web/src/components/roster/BotSettingsPage.tsx b/apps/web/src/components/roster/BotSettingsPage.tsxnew file mode 100644index 000000000..59b0e365e--- /dev/null+++ b/apps/web/src/components/roster/BotSettingsPage.tsx@@ -0,0 +1,475 @@+import { useAtomValue } from "@effect/atom-react";+import { BotId, type EnvironmentId } from "@t3tools/contracts";+import { Brain02Icon, Edit02Icon, Link02Icon, WrenchIcon } from "@hugeicons/core-free-icons";+import { useBlocker, useCanGoBack, useNavigate } from "@tanstack/react-router";+import { useCallback, useEffect, useMemo, useState } from "react";++import { isElectron } from "../../env";+import { requestConfirmDialog } from "../../confirmDialog";+import { usePrimaryEnvironmentId } from "../../state/environments";+import { botEnvironment } from "../../state/bots";+import { environmentMcpServersAtom } from "../../state/mcpServers";+import { useAtomCommand } from "../../state/use-atom-command";+import { SettingsPageContainer, SettingsRow, SettingsSection } from "../settings/settingsLayout";+import { SidebarInset } from "../ui/sidebar";+import {+ WorkspaceBreadcrumb,+ WorkspaceBreadcrumbItem,+ WorkspaceBreadcrumbSeparator,+} from "../WorkspaceBreadcrumb";+import { WorkspacePageHeader } from "../WorkspacePageHeader";+import { AppIcon } from "../ui/app-icon";+import { Button } from "../ui/button";+import { Input } from "../ui/input";+import { Select, SelectItem, SelectPopup, SelectTrigger, SelectValue } from "../ui/select";+import { Switch } from "../ui/switch";+import { Textarea } from "../ui/textarea";+import { toastManager } from "../ui/toast";+import { TraitsPicker } from "../chat/TraitsPicker";+import { AvatarPickerDialog } from "./AvatarPickerDialog";+import { BotAvatarView } from "./BotAvatarView";+import { BotChannelsSheet } from "./BotChannelsSheet";+import { BotMemorySheet } from "./BotMemorySheet";+import { BotModelPicker } from "./BotModelPicker";+import { BotPersonalityToneField } from "./BotPersonalityToneField";+import { BotToolsSheet, buildBotToolItems } from "./BotToolsSheet";+import { BotUsageSection } from "./BotUsageSection";+import { BOT_SANDBOX_OPTIONS, botSandboxLabel } from "./botSandbox";+import { useRosterStore } from "./rosterStore";+import { useBotThreadRef } from "./useBotThreadRef";+import { useBotProfileDraft, type BotProfileUpdate } from "./useBotProfileDraft";+import type { Bot } from "./types";++const NO_ENVIRONMENT = "" as EnvironmentId;++/**+ * The full settings surface for one bot. Everything a bot owns lives here, in+ * the main content area, so the in-chat panel stays a quick-edit companion+ * rather than the only place these controls fit.+ */+export function BotSettingsPage({ botId }: { readonly botId: string }) {+ const navigate = useNavigate();+ const canGoBack = useCanGoBack();+ const environmentId = usePrimaryEnvironmentId();+ const updateBot = useAtomCommand(botEnvironment.update, { reportFailure: false });+ const bot = useRosterStore((state) =>+ state.bots.find((candidate) => candidate.id === botId && candidate.archivedAt === null),+ );++ const navigateBackWithinApp = useCallback(() => {+ if (canGoBack) {+ window.history.back();+ return;+ }+ void navigate({ to: "/" });+ }, [canGoBack, navigate]);++ useEffect(() => {+ const onKeyDown = (event: KeyboardEvent) => {+ if (event.defaultPrevented) return;+ if (event.key !== "Escape") return;+ const activeElement = document.activeElement;+ // Let a focused field take Escape first; a second press leaves the page.+ if (activeElement instanceof HTMLElement && activeElement !== document.body) {+ activeElement.blur();+ return;+ }+ event.preventDefault();+ navigateBackWithinApp();+ };+ window.addEventListener("keydown", onKeyDown);+ return () => window.removeEventListener("keydown", onKeyDown);+ }, [navigateBackWithinApp]);++ const onSaveBot = useCallback(+ async (input: BotProfileUpdate) => {+ if (!environmentId || !bot) return false;+ const result = await updateBot({+ environmentId,+ input: { botId: BotId.make(bot.id), ...input },+ });+ if (result._tag === "Failure") {+ toastManager.add({ type: "error", title: "Could not save bot settings" });+ return false;+ }+ toastManager.add({ type: "success", title: "Bot settings saved" });+ return true;+ },+ [bot, environmentId, updateBot],+ );++ return (+ <SidebarInset className="h-dvh min-h-0 overflow-hidden overscroll-y-none bg-background text-foreground isolate">+ <div className="flex min-h-0 min-w-0 flex-1 flex-col bg-background text-foreground">+ <WorkspacePageHeader electron={isElectron} className="border-b border-border/70">+ <WorkspaceBreadcrumb ariaLabel="Bot settings breadcrumb">+ <WorkspaceBreadcrumbItem>Bots</WorkspaceBreadcrumbItem>+ <WorkspaceBreadcrumbSeparator />+ <WorkspaceBreadcrumbItem current>+ {bot ? bot.name : "Unavailable bot"}+ </WorkspaceBreadcrumbItem>+ </WorkspaceBreadcrumb>+ </WorkspacePageHeader>+ {bot ? (+ <BotSettingsForm key={bot.id} bot={bot} onSave={onSaveBot} />+ ) : (+ <div className="flex flex-1 items-center justify-center p-8 text-sm text-muted-foreground">+ This bot is no longer available.+ </div>+ )}+ </div>+ </SidebarInset>+ );+}++function BotSettingsForm({+ bot,+ onSave,+}: {+ readonly bot: Bot;+ readonly onSave: (input: BotProfileUpdate) => Promise<boolean>;+}) {+ const environmentId = usePrimaryEnvironmentId();+ const mcpServers = useAtomValue(environmentMcpServersAtom(environmentId ?? NO_ENVIRONMENT));+ const threadRef = useBotThreadRef(bot.id);+ const draft = useBotProfileDraft(bot, onSave);+ const [avatarOpen, setAvatarOpen] = useState(false);+ const [toolsOpen, setToolsOpen] = useState(false);+ const [memoryOpen, setMemoryOpen] = useState(false);+ const [channelsOpen, setChannelsOpen] = useState(false);++ const shouldBlockNavigation = useCallback(async () => {+ if (!draft.dirty) return false;+ const confirmation = requestConfirmDialog("Discard unsaved bot settings?", {+ variant: "destructive",+ });+ if (!confirmation) return true;+ return !(await confirmation);+ }, [draft.dirty]);+ useBlocker({+ shouldBlockFn: shouldBlockNavigation,+ enableBeforeUnload: () => draft.dirty,+ disabled: !draft.dirty,+ });++ // Memoized because this walks the plugin catalog and does not depend on the form draft.+ const tools = useMemo(() => buildBotToolItems(mcpServers), [mcpServers]);+ const enabledToolCount = tools.filter(+ (tool) => tool.workspaceEnabled && !draft.disabledMcpServerIds.includes(tool.id),+ ).length;+ const assignedChannels = (bot.channelBindings ?? []).filter(+ (binding) => binding.connectionId || binding.projectId || binding.status !== "disconnected",+ );+ const connectedChannelCount = assignedChannels.filter(+ (binding) => binding.status === "connected",+ ).length;++ return (+ <>+ <SettingsPageContainer>+ <SettingsSection title="Bot">+ <SettingsRow+ title="Avatar"+ description="Shown in the roster, the chat header, and anywhere this bot speaks."+ control={+ <button+ type="button"+ aria-label="Change bot avatar"+ onClick={() => setAvatarOpen(true)}+ className="group relative rounded-2xl outline-none focus-visible:ring-2 focus-visible:ring-ring"+ >+ <BotAvatarView+ avatar={bot.avatar}+ name={draft.name || bot.name}+ className="size-14"+ />+ <span className="absolute -bottom-1 -right-1 flex size-6 items-center justify-center rounded-full border border-border bg-background text-muted-foreground shadow-sm transition-colors group-hover:text-foreground">+ <AppIcon className="size-3" icon={Edit02Icon} />+ </span>+ </button>+ }+ />++ <SettingsRow+ title="Name"+ description="What you call this bot in chats and mentions."+ control={+ <Input+ className="w-full sm:w-64"+ aria-label="Bot name"+ value={draft.name}+ onChange={(event) => {+ draft.setName(event.currentTarget.value);+ draft.markChanged();+ }}+ />+ }+ />++ <SettingsRow+ title="Label"+ description="An optional role, such as research, marketing, or admin."+ control={+ <Input+ className="w-full sm:w-64"+ aria-label="Bot label"+ value={draft.label}+ placeholder="Research, marketing, admin"+ onChange={(event) => {+ draft.setLabel(event.currentTarget.value);+ draft.markChanged();+ }}+ />+ }+ />++ <SettingsRow+ title="Description"+ description="A note to yourself about what this bot is for. Searchable from the roster."+ >+ <div className="mt-3 max-w-2xl pb-3.5">+ <Textarea+ aria-label="Bot description"+ value={draft.description}+ placeholder="What this bot is for"+ rows={4}+ className="min-h-24 resize-none"+ onChange={(event) => {+ draft.setDescription(event.currentTarget.value);+ draft.markChanged();+ }}+ />+ </div>+ </SettingsRow>+ </SettingsSection>++ <SettingsSection title="Voice and personality">+ <SettingsRow+ id="personality"+ title="Personality"+ description="Choose how this bot usually sounds. It is a baseline, not a costume. The bot still adapts to you and to the task, so serious work stays serious in every mode."+ >+ <div className="mt-3 max-w-2xl pb-3.5">+ <BotPersonalityToneField+ bot={bot}+ tone={draft.personalityTone}+ onToneChange={(tone) => {+ draft.setPersonalityTone(tone);+ draft.markChanged();+ }}+ />+ </div>+ </SettingsRow>++ <SettingsRow+ title="Voice calls"+ description="Let this bot take subscription voice calls. Voice must also be enabled in Settings."+ control={+ <Switch+ checked={draft.voiceEnabled}+ onCheckedChange={(checked) => {+ draft.setVoiceEnabled(Boolean(checked));+ draft.markChanged();+ }}+ aria-label={`${draft.voiceEnabled ? "Disable" : "Enable"} voice calls for ${bot.name}`}+ />+ }+ />+ </SettingsSection>++ <SettingsSection title="Model">+ <SettingsRow+ title="Model"+ description="The provider and model this bot runs on."+ control={+ draft.activeEntry && draft.model ? (+ <BotModelPicker+ activeInstanceId={draft.activeEntry.instanceId}+ model={draft.model}+ instanceEntries={draft.instanceEntries}+ modelOptionsByInstance={draft.modelOptionsByInstance}+ onChange={draft.selectModel}+ />+ ) : (+ <span className="text-sm text-muted-foreground">Connect a provider</span>+ )+ }+ />++ {draft.showModelOptions && draft.activeEntry ? (+ <SettingsRow+ title="Reasoning"+ description="How much thinking this bot spends before it answers."+ control={+ <TraitsPicker+ provider={draft.activeEntry.driverKind}+ instanceId={draft.activeEntry.instanceId}+ models={draft.activeEntry.models}+ model={draft.model}+ prompt=""+ onPromptChange={() => {}}+ modelOptions={draft.modelOptions}+ allowPromptInjectedEffort={false}+ planModeEnabled={draft.settings.planModeEnabled}+ onModelOptionsChange={draft.selectModelOptions}+ />+ }+ />+ ) : null}++ {draft.resolvedUsageCap.available ? (+ <SettingsRow+ title="Token hard stop"+ description="Stop this bot once it has spent this many tokens. Leave empty for no limit."+ control={+ <Input+ className="w-full sm:w-40"+ aria-label="Token hard stop"+ type="number"+ inputMode="numeric"+ min={1}+ step={1}+ value={draft.usageCap}+ placeholder="No limit"+ onChange={(event) => {+ draft.setUsageCap(event.currentTarget.value);+ draft.markChanged();+ }}+ />+ }+ />+ ) : (+ <SettingsRow+ title="Token hard stop"+ description="This provider reports occupancy rather than tokens, so a token limit does not apply."+ control={<span className="text-sm text-muted-foreground">Unavailable</span>}+ />+ )}++ <SettingsRow title="Usage" description="What this bot has spent so far.">+ <div className="mt-3 max-w-2xl pb-3.5">+ <BotUsageSection environmentId={environmentId} botId={bot.id} />+ </div>+ </SettingsRow>+ </SettingsSection>++ <SettingsSection title="Workspace">+ <SettingsRow+ title="Sandbox"+ description="Where this bot runs commands and edits files."+ control={+ <Select+ value={draft.sandbox}+ onValueChange={(value) => {+ if (value === null) return;+ if (!BOT_SANDBOX_OPTIONS.some((option) => option.value === value)) return;+ draft.setSandbox(value as typeof draft.sandbox);+ draft.markChanged();+ }}+ >+ <SelectTrigger className="w-full sm:w-48" aria-label="Sandbox provider">+ <SelectValue>{botSandboxLabel(draft.sandbox)}</SelectValue>+ </SelectTrigger>+ <SelectPopup align="end" alignItemWithTrigger={false}>+ {BOT_SANDBOX_OPTIONS.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectPopup>+ </Select>+ }+ />++ <SettingsRow+ title="Tools"+ description="Which workspace tools this bot may reach."+ control={+ <Button+ variant="outline"+ size="xs"+ type="button"+ aria-label="Manage bot tools"+ aria-expanded={toolsOpen}+ onClick={() => setToolsOpen(true)}+ >+ <AppIcon className="size-3.5" icon={WrenchIcon} />+ {tools.length === 0+ ? "No workspace tools"+ : `${enabledToolCount} of ${tools.length} enabled`}+ </Button>+ }+ />++ <SettingsRow+ title="Memory"+ description="Facts this bot keeps between chats."+ control={+ <Button+ variant="outline"+ size="xs"+ type="button"+ aria-label="Manage bot memory"+ disabled={!threadRef}+ onClick={() => setMemoryOpen(true)}+ >+ <AppIcon className="size-3.5" icon={Brain02Icon} />+ Facts and history+ </Button>+ }+ />++ <SettingsRow+ title="Channels"+ description="Where this bot answers outside Akeru Bot."+ control={+ <Button+ variant="outline"+ size="xs"+ type="button"+ aria-label="Manage bot channels"+ aria-expanded={channelsOpen}+ onClick={() => setChannelsOpen(true)}+ >+ <AppIcon className="size-3.5" icon={Link02Icon} />+ {assignedChannels.length === 0+ ? "No channels"+ : `${connectedChannelCount} of ${assignedChannels.length} connected`}+ </Button>+ }+ />+ </SettingsSection>+ </SettingsPageContainer>++ <div+ className="flex shrink-0 items-center justify-end gap-3 border-t border-border/70 px-5 py-3 sm:px-6"+ data-testid="bot-settings-save-bar"+ >+ <span aria-live="polite" className="mr-auto text-xs text-muted-foreground">+ {draft.saved ? (+ <span className="text-success">Saved</span>+ ) : draft.dirty ? (+ "Unsaved changes"+ ) : null}+ </span>+ <Button size="sm" disabled={!draft.canSave || draft.saving} onClick={draft.save}>+ {draft.saving ? "Saving" : "Save"}+ </Button>+ </div>++ <AvatarPickerDialog bot={bot} open={avatarOpen} onOpenChange={setAvatarOpen} />+ <BotToolsSheet+ open={toolsOpen}+ onOpenChange={setToolsOpen}+ servers={mcpServers}+ disabledIds={draft.disabledMcpServerIds}+ onDisabledIdsChange={(ids) => {+ draft.setDisabledMcpServerIds(ids);+ draft.markChanged();+ }}+ />+ <BotMemorySheet open={memoryOpen} onOpenChange={setMemoryOpen} threadRef={threadRef} />+ <BotChannelsSheet bot={bot} open={channelsOpen} onOpenChange={setChannelsOpen} />+ </>+ );+}diff --git a/apps/web/src/components/roster/botPersonalityTone.test.ts b/apps/web/src/components/roster/botPersonalityTone.test.tsnew file mode 100644index 000000000..59c2d70f6--- /dev/null+++ b/apps/web/src/components/roster/botPersonalityTone.test.ts@@ -0,0 +1,83 @@+// @effect-diagnostics nodeBuiltinImport:off - The band contract reads its source.+import * as NodeFS from "node:fs";++import { BALANCED_BOT_PERSONALITY_TONE } from "@t3tools/contracts";+import { describe, expect, it } from "vite-plus/test";++import {+ BOT_PERSONALITY_TONE_OPTIONS,+ botPersonalityToneLabel,+ canonicalizeBotPersonalityTone,+ normalizeBotPersonalityTone,+ resolveBotPersonalityToneBand,+ resolveBotPersonalityToneOption,+} from "./botPersonalityTone";++describe("botPersonalityTone", () => {+ it("defines the three choices shown in settings", () => {+ expect(BOT_PERSONALITY_TONE_OPTIONS.map((stop) => stop.label)).toEqual([+ "Chill",+ "Balanced",+ "Professional",+ ]);+ expect(BOT_PERSONALITY_TONE_OPTIONS.map((stop) => stop.value)).toEqual([0, 50, 100]);+ });++ it("splits bands on the same thresholds the server instructions use", () => {+ expect(resolveBotPersonalityToneBand(0).id).toBe("chill");+ expect(resolveBotPersonalityToneBand(20).id).toBe("chill");+ expect(resolveBotPersonalityToneBand(21).id).toBe("relaxed");+ expect(resolveBotPersonalityToneBand(44).id).toBe("relaxed");+ expect(resolveBotPersonalityToneBand(45).id).toBe("balanced");+ expect(resolveBotPersonalityToneBand(55).id).toBe("balanced");+ expect(resolveBotPersonalityToneBand(56).id).toBe("composed");+ expect(resolveBotPersonalityToneBand(79).id).toBe("composed");+ expect(resolveBotPersonalityToneBand(80).id).toBe("professional");+ expect(resolveBotPersonalityToneBand(100).id).toBe("professional");+ });++ it("gives every band a distinct sample so the preview actually changes", () => {+ const samples = [0, 30, 50, 70, 100].map((tone) => resolveBotPersonalityToneBand(tone).sample);+ expect(new Set(samples).size).toBe(samples.length);+ // The instructions forbid dashes, so the illustration must not promise them.+ for (const sample of samples) {+ expect(sample).not.toMatch(/[—–]/);+ }+ });++ it("falls back to balanced when the bot predates the field", () => {+ expect(normalizeBotPersonalityTone(undefined)).toBe(BALANCED_BOT_PERSONALITY_TONE);+ expect(normalizeBotPersonalityTone(null)).toBe(BALANCED_BOT_PERSONALITY_TONE);+ expect(normalizeBotPersonalityTone(Number.NaN)).toBe(BALANCED_BOT_PERSONALITY_TONE);+ expect(botPersonalityToneLabel(BALANCED_BOT_PERSONALITY_TONE)).toBe("Balanced");+ });++ it("maps the five internal bands to the three visible choices", () => {+ expect(resolveBotPersonalityToneOption(20).label).toBe("Chill");+ expect(resolveBotPersonalityToneOption(44).label).toBe("Chill");+ expect(resolveBotPersonalityToneOption(50).label).toBe("Balanced");+ expect(resolveBotPersonalityToneOption(56).label).toBe("Professional");+ expect(resolveBotPersonalityToneOption(100).label).toBe("Professional");+ expect(canonicalizeBotPersonalityTone(35)).toBe(0);+ expect(canonicalizeBotPersonalityTone(75)).toBe(100);+ });++ it("clamps and rounds anything outside the persisted range", () => {+ expect(normalizeBotPersonalityTone(-10)).toBe(0);+ expect(normalizeBotPersonalityTone(140)).toBe(100);+ expect(normalizeBotPersonalityTone(62.4)).toBe(62);+ expect(normalizeBotPersonalityTone(62.5)).toBe(63);+ });++ it("keeps its band thresholds aligned with the server instructions", () => {+ const serverSource = NodeFS.readFileSync(+ new URL("../../../../../apps/server/src/provider/AkeruAgentInstructions.ts", import.meta.url),+ "utf8",+ );+ // If these move on the server, the settings copy is lying about behavior.+ expect(serverSource).toContain("tone <= 20");+ expect(serverSource).toContain("tone < 45");+ expect(serverSource).toContain("tone <= 55");+ expect(serverSource).toContain("tone < 80");+ });+});diff --git a/apps/web/src/components/roster/botPersonalityTone.ts b/apps/web/src/components/roster/botPersonalityTone.tsnew file mode 100644index 000000000..a68e812c7--- /dev/null+++ b/apps/web/src/components/roster/botPersonalityTone.ts@@ -0,0 +1,130 @@+import {+ BALANCED_BOT_PERSONALITY_TONE,+ MAX_BOT_PERSONALITY_TONE,+ MIN_BOT_PERSONALITY_TONE,+} from "@t3tools/contracts";++/**+ * Presentation for the per-bot personality baseline. The bands mirror the+ * thresholds the server uses to build personality instructions, so what the+ * settings page promises is what the bot is actually told.+ *+ * @see apps/server/src/provider/AkeruAgentInstructions.ts+ */++export type BotPersonalityToneBandId =+ | "chill"+ | "relaxed"+ | "balanced"+ | "composed"+ | "professional";++export interface BotPersonalityToneBand {+ readonly id: BotPersonalityToneBandId;+ /** The word shown for this tone band. */+ readonly label: string;+ /** How the bot writes at this setting, in one sentence. */+ readonly summary: string;+ /** An illustrative reply, written locally. No provider call is made. */+ readonly sample: string;+}++/**+ * Upper bound of each band, matching the server thresholds. `chill` covers+ * 0-20, `relaxed` 21-44, `balanced` 45-55, `composed` 56-79, and+ * `professional` 80-100.+ */+const BANDS: ReadonlyArray<{ readonly max: number; readonly band: BotPersonalityToneBand }> = [+ {+ max: 20,+ band: {+ id: "chill",+ label: "Chill",+ summary: "Short, relaxed messages. Lowercase reads as natural, like a teammate texting.",+ sample: "on it. migration step timed out again. want me to retry, or find out why first?",+ },+ },+ {+ max: 44,+ band: {+ id: "relaxed",+ label: "Relaxed",+ summary: "Relaxed and direct. Casual wording can sit next to serious thinking.",+ sample:+ "Looking now. The migration step timed out again. Want a retry, or should I find the cause first?",+ },+ },+ {+ max: 55,+ band: {+ id: "balanced",+ label: "Balanced",+ summary: "Natural and direct. Follows your tone and the task more than either endpoint.",+ sample:+ "Checking now. The migration step timed out again. I can retry it or trace the cause.",+ },+ },+ {+ max: 79,+ band: {+ id: "composed",+ label: "Composed",+ summary: "Clear and composed replies, loosening up when you do.",+ sample:+ "I'm checking that now. The migration step timed out again. I can retry the deploy, or trace the cause before we try again.",+ },+ },+ {+ max: MAX_BOT_PERSONALITY_TONE,+ band: {+ id: "professional",+ label: "Professional",+ summary: "Concise and professional, using contractions and ordinary words. Never corporate.",+ sample:+ "I'm looking into it. The migration step timed out again. I'd trace the cause before retrying, since a retry will likely hit the same timeout.",+ },+ },+];++/** The three choices exposed in settings. The server still accepts 0-100 for compatibility. */+export const BOT_PERSONALITY_TONE_OPTIONS = [+ { value: MIN_BOT_PERSONALITY_TONE, label: "Chill" },+ { value: BALANCED_BOT_PERSONALITY_TONE, label: "Balanced" },+ { value: MAX_BOT_PERSONALITY_TONE, label: "Professional" },+] as const;++export type BotPersonalityToneOption = (typeof BOT_PERSONALITY_TONE_OPTIONS)[number];++/** The prompt the sample reply answers, shown above it for context. */+export const BOT_PERSONALITY_TONE_SAMPLE_PROMPT = "the staging deploy failed again";++/** Clamp anything that reached the client to the range the server accepts. */+export function normalizeBotPersonalityTone(tone: number | undefined | null): number {+ if (typeof tone !== "number" || !Number.isFinite(tone)) return BALANCED_BOT_PERSONALITY_TONE;+ const rounded = Math.round(tone);+ if (rounded < MIN_BOT_PERSONALITY_TONE) return MIN_BOT_PERSONALITY_TONE;+ if (rounded > MAX_BOT_PERSONALITY_TONE) return MAX_BOT_PERSONALITY_TONE;+ return rounded;+}++export function resolveBotPersonalityToneBand(tone: number): BotPersonalityToneBand {+ const normalized = normalizeBotPersonalityTone(tone);+ const match = BANDS.find((entry) => normalized <= entry.max);+ return (match ?? BANDS[BANDS.length - 1]!).band;+}++/** Collapse imported or older numeric values into the three settings choices. */+export function resolveBotPersonalityToneOption(tone: number): BotPersonalityToneOption {+ const normalized = normalizeBotPersonalityTone(tone);+ if (normalized < 45) return BOT_PERSONALITY_TONE_OPTIONS[0];+ if (normalized <= 55) return BOT_PERSONALITY_TONE_OPTIONS[1];+ return BOT_PERSONALITY_TONE_OPTIONS[2];+}++export function canonicalizeBotPersonalityTone(tone: number | undefined | null): number {+ return resolveBotPersonalityToneOption(normalizeBotPersonalityTone(tone)).value;+}++export function botPersonalityToneLabel(tone: number): string {+ return resolveBotPersonalityToneOption(tone).label;+}diff --git a/apps/web/src/components/roster/types.ts b/apps/web/src/components/roster/types.tsindex d1a4b0a6d..b9b8ac152 100644--- a/apps/web/src/components/roster/types.ts+++ b/apps/web/src/components/roster/types.ts@@ -34,6 +34,8 @@ export interface Bot {sandbox: "local" | "e2b" | "daytona" | "vercel" | "upstash" | null;runtimeMode: "approval-required" | "auto-accept-edits" | "auto" | "full-access";usageCap: { unit: "tokens"; limit: number } | null;+ /** Personality baseline, 0 (chill) to 100 (professional). Absent on bots saved before the field existed. */+ personalityTone?: number;voiceEnabled: boolean;channelBindings?: ReadonlyArray<ChannelBinding>;groupId: string | null;diff --git a/apps/web/src/components/roster/useBotProfileDraft.test.ts b/apps/web/src/components/roster/useBotProfileDraft.test.tsnew file mode 100644index 000000000..b2ac590b0--- /dev/null+++ b/apps/web/src/components/roster/useBotProfileDraft.test.ts@@ -0,0 +1,23 @@+import { describe, expect, it } from "vite-plus/test";++import { rebaseUneditedValue } from "./useBotProfileDraft";++describe("rebaseUneditedValue", () => {+ it("takes a newer snapshot value when the local field was untouched", () => {+ expect(rebaseUneditedValue("Research", "Research", "Planning")).toBe("Planning");+ });++ it("preserves a local edit when the snapshot changes", () => {+ expect(rebaseUneditedValue("My label", "Research", "Planning")).toBe("My label");+ });++ it("supports semantic equality for collection fields", () => {+ const current = ["calendar", "github"];+ const previous = ["github", "calendar"];+ const next = ["github"];+ const equal = (left: string[], right: string[]) =>+ [...left].sort().join() === [...right].sort().join();++ expect(rebaseUneditedValue(current, previous, next, equal)).toBe(next);+ });+});diff --git a/apps/web/src/components/roster/useBotProfileDraft.ts b/apps/web/src/components/roster/useBotProfileDraft.tsnew file mode 100644index 000000000..8c83aab2b--- /dev/null+++ b/apps/web/src/components/roster/useBotProfileDraft.ts@@ -0,0 +1,311 @@+import { useAtomValue } from "@effect/atom-react";+import { ProviderInstanceId, type BotEngine, type McpServerId } from "@t3tools/contracts";+import { useEffect, useMemo, useRef, useState } from "react";++import { usePrimarySettings } from "../../hooks/useSettings";+import {+ getCustomModelOptionsByInstance,+ resolveAppModelSelectionForInstance,+ resolveAppModelSelectionState,+} from "../../modelSelection";+import {+ applyProviderInstanceSettings,+ deriveProviderInstanceEntries,+ resolveSelectableProviderInstanceEntry,+ sortProviderInstanceEntries,+} from "../../providerInstances";+import { primaryServerProvidersAtom } from "../../state/server";+import { shouldRenderTraitsControls } from "../chat/TraitsPicker";+import { canonicalizeBotPersonalityTone } from "./botPersonalityTone";+import { botSandboxChoice, type BotSandboxChoice } from "./botSandbox";+import type { Bot } from "./types";++type BotModelOptions = BotEngine["options"];++const TOOL_ID_SEPARATOR = "\u0000";++export function rebaseUneditedValue<T>(+ current: T,+ previous: T,+ next: T,+ equal: (left: T, right: T) => boolean = Object.is,+): T {+ return equal(current, previous) ? next : current;+}++function mcpServerIdsKey(ids: readonly McpServerId[]): string {+ return [...ids].sort().join(TOOL_ID_SEPARATOR);+}++export interface BotProfileUpdate {+ readonly name: string;+ readonly label: string | null;+ readonly description: string | null;+ readonly engine: Bot["engine"];+ readonly usageCap: Bot["usageCap"];+ readonly sandbox: Bot["sandbox"];+ readonly personalityTone: number;+ readonly voiceEnabled: boolean;+ readonly disabledMcpServerIds: readonly McpServerId[];+}++export function parseBotUsageCapInput(input: string): {+ readonly valid: boolean;+ readonly value: Bot["usageCap"];+} {+ if (input.trim().length === 0) return { valid: true, value: null };+ const limit = Number(input);+ if (!Number.isSafeInteger(limit) || limit <= 0) return { valid: false, value: null };+ return { valid: true, value: { unit: "tokens", limit } };+}++export function resolveBotUsageCapForProvider(+ input: string,+ providerDriver?: string,+): {+ readonly available: boolean;+ readonly valid: boolean;+ readonly value: Bot["usageCap"];+} {+ if (providerDriver === "cursor" || providerDriver === "grok") {+ return { available: false, valid: true, value: null };+ }+ return { available: true, ...parseBotUsageCapInput(input) };+}++/**+ * Draft state for every editable bot field, shared by the in-chat bot panel+ * and the full bot settings page. Both surfaces read dirtiness and build the+ * save payload from here, so the two cannot drift apart.+ */+export function useBotProfileDraft(+ bot: Bot,+ onSave?: (input: BotProfileUpdate) => Promise<boolean>,+) {+ const providers = useAtomValue(primaryServerProvidersAtom);+ const settings = usePrimarySettings();++ const [name, setName] = useState(bot.name);+ const [label, setLabel] = useState(bot.label ?? "");+ const [description, setDescription] = useState(bot.description ?? "");+ const [usageCap, setUsageCap] = useState(() => bot.usageCap?.limit.toString() ?? "");+ const [sandbox, setSandbox] = useState<BotSandboxChoice>(() => botSandboxChoice(bot.sandbox));+ const [personalityTone, setPersonalityTone] = useState(() =>+ canonicalizeBotPersonalityTone(bot.personalityTone),+ );+ const [voiceEnabled, setVoiceEnabled] = useState(bot.voiceEnabled);+ const [disabledMcpServerIds, setDisabledMcpServerIds] = useState<readonly McpServerId[]>(+ bot.disabledMcpServerIds,+ );+ const [engineChanged, setEngineChanged] = useState(false);+ const [saving, setSaving] = useState(false);+ const [saved, setSaved] = useState(false);+ const previousBot = useRef(bot);++ const instanceEntries = useMemo(+ () =>+ sortProviderInstanceEntries(+ applyProviderInstanceSettings(deriveProviderInstanceEntries(providers), settings),+ ),+ [providers, settings],+ );+ const defaultSelection = useMemo(+ () => resolveAppModelSelectionState(settings, providers),+ [providers, settings],+ );+ const [provider, setProvider] = useState(bot.engine?.provider ?? defaultSelection.instanceId);+ const activeEntry = useMemo(+ () =>+ resolveSelectableProviderInstanceEntry(instanceEntries, ProviderInstanceId.make(provider)),+ [instanceEntries, provider],+ );+ const [model, setModel] = useState<string>(+ () =>+ bot.engine?.model ??+ (activeEntry+ ? resolveAppModelSelectionForInstance(activeEntry.instanceId, settings, providers, null)+ : null) ??+ defaultSelection.model,+ );+ const [modelOptions, setModelOptions] = useState<BotModelOptions>(+ () =>+ bot.engine?.options ??+ (bot.engine?.provider === defaultSelection.instanceId &&+ bot.engine.model === defaultSelection.model+ ? defaultSelection.options+ : undefined),+ );+ const modelOptionsByInstance = useMemo(+ () => getCustomModelOptionsByInstance(settings, providers),+ [providers, settings],+ );++ useEffect(() => {+ if (engineChanged) return;+ setProvider(bot.engine?.provider ?? defaultSelection.instanceId);+ if (bot.engine?.model) setModel(bot.engine.model);+ setModelOptions(+ bot.engine?.options ??+ (bot.engine?.provider === defaultSelection.instanceId &&+ bot.engine.model === defaultSelection.model+ ? defaultSelection.options+ : undefined),+ );+ }, [bot.engine, defaultSelection, engineChanged]);++ useEffect(() => {+ const previous = previousBot.current;+ previousBot.current = bot;+ if (previous.id !== bot.id) return;++ setName((current) => rebaseUneditedValue(current, previous.name, bot.name));+ setLabel((current) => rebaseUneditedValue(current, previous.label ?? "", bot.label ?? ""));+ setDescription((current) =>+ rebaseUneditedValue(current, previous.description ?? "", bot.description ?? ""),+ );+ setUsageCap((current) =>+ rebaseUneditedValue(+ current,+ previous.usageCap?.limit.toString() ?? "",+ bot.usageCap?.limit.toString() ?? "",+ ),+ );+ setSandbox((current) =>+ rebaseUneditedValue(+ current,+ botSandboxChoice(previous.sandbox),+ botSandboxChoice(bot.sandbox),+ ),+ );+ setPersonalityTone((current) =>+ rebaseUneditedValue(+ current,+ canonicalizeBotPersonalityTone(previous.personalityTone),+ canonicalizeBotPersonalityTone(bot.personalityTone),+ ),+ );+ setVoiceEnabled((current) =>+ rebaseUneditedValue(current, previous.voiceEnabled, bot.voiceEnabled),+ );+ setDisabledMcpServerIds((current) =>+ rebaseUneditedValue(+ current,+ previous.disabledMcpServerIds,+ bot.disabledMcpServerIds,+ (a, b) => mcpServerIdsKey(a) === mcpServerIdsKey(b),+ ),+ );+ }, [bot]);++ const markChanged = () => setSaved(false);++ const normalizedLabel = label.trim() || null;+ const normalizedDescription = description.trim() || null;+ const savedTone = canonicalizeBotPersonalityTone(bot.personalityTone);+ const nextEngine: Bot["engine"] =+ engineChanged && model+ ? { provider, model, ...(modelOptions ? { options: modelOptions } : {}) }+ : bot.engine;+ const showModelOptions =+ activeEntry !== undefined &&+ model.length > 0 &&+ shouldRenderTraitsControls({+ provider: activeEntry.driverKind,+ models: activeEntry.models,+ model,+ prompt: "",+ modelOptions,+ allowPromptInjectedEffort: false,+ planModeEnabled: settings.planModeEnabled,+ });+ const resolvedUsageCap = resolveBotUsageCapForProvider(usageCap, activeEntry?.driverKind);+ const usageCapDirty =+ !resolvedUsageCap.valid || resolvedUsageCap.value?.limit !== bot.usageCap?.limit;+ const toolOverridesDirty =+ mcpServerIdsKey(disabledMcpServerIds) !== mcpServerIdsKey(bot.disabledMcpServerIds);+ const sandboxDirty = sandbox !== botSandboxChoice(bot.sandbox);+ const dirty =+ name.trim() !== bot.name ||+ normalizedLabel !== bot.label ||+ normalizedDescription !== bot.description ||+ engineChanged ||+ usageCapDirty ||+ sandboxDirty ||+ personalityTone !== savedTone ||+ voiceEnabled !== bot.voiceEnabled ||+ toolOverridesDirty;+ const canSave = Boolean(onSave) && dirty && name.trim().length > 0 && resolvedUsageCap.valid;++ return {+ // Provider context shared by both model pickers.+ settings,+ instanceEntries,+ defaultSelection,+ activeEntry,+ modelOptionsByInstance,+ showModelOptions,++ name,+ setName,+ label,+ setLabel,+ description,+ setDescription,+ usageCap,+ setUsageCap,+ resolvedUsageCap,+ sandbox,+ setSandbox,+ personalityTone,+ setPersonalityTone,+ voiceEnabled,+ setVoiceEnabled,+ disabledMcpServerIds,+ setDisabledMcpServerIds,+ model,+ modelOptions,++ /** Applies a model pick, including the option reset the picker implies. */+ selectModel: (instanceId: string, nextModel: string) => {+ setProvider(instanceId);+ setModel(nextModel);+ setModelOptions(+ defaultSelection.instanceId === instanceId && defaultSelection.model === nextModel+ ? defaultSelection.options+ : undefined,+ );+ setEngineChanged(true);+ markChanged();+ },+ selectModelOptions: (nextOptions: BotModelOptions) => {+ setModelOptions(nextOptions);+ setEngineChanged(true);+ markChanged();+ },++ markChanged,+ dirty,+ canSave,+ saving,+ saved,+ save: () => {+ if (!onSave || !canSave) return;+ setSaving(true);+ void onSave({+ name: name.trim(),+ label: normalizedLabel,+ description: normalizedDescription,+ engine: nextEngine,+ usageCap: resolvedUsageCap.value,+ sandbox,+ personalityTone,+ voiceEnabled,+ disabledMcpServerIds,+ }).then((success) => {+ setSaving(false);+ setSaved(success);+ if (success) setEngineChanged(false);+ });+ },+ };+}diff --git a/apps/web/src/routeTree.gen.ts b/apps/web/src/routeTree.gen.tsindex 625cd0d79..50303d1d5 100644--- a/apps/web/src/routeTree.gen.ts+++ b/apps/web/src/routeTree.gen.ts@@ -18,6 +18,7 @@ import { Route as ChatIndexRouteImport } from './routes/_chat.index'import { Route as SettingsSectionRouteImport } from './routes/settings.$section'import { Route as SettingsSplatRouteImport } from './routes/settings.$'import { Route as ProjectsProjectKeyRouteImport } from './routes/projects.$projectKey'+import { Route as BotsBotIdSettingsRouteImport } from './routes/bots.$botId.settings'import { Route as ChatGroupsGroupIdRouteImport } from './routes/_chat.groups.$groupId'import { Route as ChatDraftDraftIdRouteImport } from './routes/_chat.draft.$draftId'import { Route as ChatBotsBotIdRouteImport } from './routes/_chat.bots.$botId'@@ -67,6 +68,11 @@ const ProjectsProjectKeyRoute = ProjectsProjectKeyRouteImport.update({path: '/projects/$projectKey',getParentRoute: () => rootRouteImport,} as any)+const BotsBotIdSettingsRoute = BotsBotIdSettingsRouteImport.update({+ id: '/bots/$botId/settings',+ path: '/bots/$botId/settings',+ getParentRoute: () => rootRouteImport,+} as any)const ChatGroupsGroupIdRoute = ChatGroupsGroupIdRouteImport.update({id: '/groups/$groupId',path: '/groups/$groupId',@@ -102,6 +108,7 @@ export interface FileRoutesByFullPath {'/bots/$botId': typeof ChatBotsBotIdRoute'/draft/$draftId': typeof ChatDraftDraftIdRoute'/groups/$groupId': typeof ChatGroupsGroupIdRoute+ '/bots/$botId/settings': typeof BotsBotIdSettingsRoute}export interface FileRoutesByTo {'/pair': typeof PairRoute@@ -116,6 +123,7 @@ export interface FileRoutesByTo {'/bots/$botId': typeof ChatBotsBotIdRoute'/draft/$draftId': typeof ChatDraftDraftIdRoute'/groups/$groupId': typeof ChatGroupsGroupIdRoute+ '/bots/$botId/settings': typeof BotsBotIdSettingsRoute}export interface FileRoutesById {__root__: typeof rootRouteImport@@ -132,6 +140,7 @@ export interface FileRoutesById {'/_chat/bots/$botId': typeof ChatBotsBotIdRoute'/_chat/draft/$draftId': typeof ChatDraftDraftIdRoute'/_chat/groups/$groupId': typeof ChatGroupsGroupIdRoute+ '/bots/$botId/settings': typeof BotsBotIdSettingsRoute}export interface FileRouteTypes {fileRoutesByFullPath: FileRoutesByFullPath@@ -148,6 +157,7 @@ export interface FileRouteTypes {| '/bots/$botId'| '/draft/$draftId'| '/groups/$groupId'+ | '/bots/$botId/settings'fileRoutesByTo: FileRoutesByToto:| '/pair'@@ -162,6 +172,7 @@ export interface FileRouteTypes {| '/bots/$botId'| '/draft/$draftId'| '/groups/$groupId'+ | '/bots/$botId/settings'id:| '__root__'| '/_chat'@@ -177,6 +188,7 @@ export interface FileRouteTypes {| '/_chat/bots/$botId'| '/_chat/draft/$draftId'| '/_chat/groups/$groupId'+ | '/bots/$botId/settings'fileRoutesById: FileRoutesById}export interface RootRouteChildren {@@ -186,6 +198,7 @@ export interface RootRouteChildren {SettingsRoute: typeof SettingsRouteWithChildrenUsageRoute: typeof UsageRouteProjectsProjectKeyRoute: typeof ProjectsProjectKeyRoute+ BotsBotIdSettingsRoute: typeof BotsBotIdSettingsRoute}declare module '@tanstack/react-router' {@@ -253,6 +266,13 @@ declare module '@tanstack/react-router' {preLoaderRoute: typeof ProjectsProjectKeyRouteImportparentRoute: typeof rootRouteImport}+ '/bots/$botId/settings': {+ id: '/bots/$botId/settings'+ path: '/bots/$botId/settings'+ fullPath: '/bots/$botId/settings'+ preLoaderRoute: typeof BotsBotIdSettingsRouteImport+ parentRoute: typeof rootRouteImport+ }'/_chat/groups/$groupId': {id: '/_chat/groups/$groupId'path: '/groups/$groupId'@@ -323,6 +343,7 @@ const rootRouteChildren: RootRouteChildren = {SettingsRoute: SettingsRouteWithChildren,UsageRoute: UsageRoute,ProjectsProjectKeyRoute: ProjectsProjectKeyRoute,+ BotsBotIdSettingsRoute: BotsBotIdSettingsRoute,}export const routeTree = rootRouteImport._addFileChildren(rootRouteChildren)diff --git a/apps/web/src/routes/_chat.bots.$botId.tsx b/apps/web/src/routes/_chat.bots.$botId.tsxindex 77147715d..27c93a53a 100644--- a/apps/web/src/routes/_chat.bots.$botId.tsx+++ b/apps/web/src/routes/_chat.bots.$botId.tsx@@ -9,7 +9,7 @@ import {SkillAssignmentId,SkillId,} from "@t3tools/contracts";-import { createFileRoute } from "@tanstack/react-router";+import { createFileRoute, useNavigate } from "@tanstack/react-router";import { useMemo, useState } from "react";import { BotThreadLanding } from "../components/roster/BotThreadLanding";@@ -21,7 +21,6 @@ import { useRosterStore } from "../components/roster/rosterStore";import { toastManager } from "../components/ui/toast";import { randomUUID } from "../lib/utils";import { botRoutePanelKeys } from "./botRoutePanelKeys";-import { botEnvironment } from "../state/bots";import { usePrimaryEnvironmentId } from "../state/environments";import { routineEnvironment } from "../state/routines";import { primaryServerProvidersAtom } from "../state/server";@@ -33,8 +32,8 @@ const NO_ENVIRONMENT = "" as EnvironmentId;function BotThreadRouteView() {const { botId } = Route.useParams();const panelKeys = botRoutePanelKeys(botId);+ const navigate = useNavigate();const environmentId = usePrimaryEnvironmentId();- const updateBot = useAtomCommand(botEnvironment.update, { reportFailure: false });const draftRoutine = useAtomCommand(routineEnvironment.draft, { reportFailure: false });const approveRoutine = useAtomCommand(routineEnvironment.approve, { reportFailure: false });const enableRoutine = useAtomCommand(routineEnvironment.enable, { reportFailure: false });@@ -295,37 +294,8 @@ function BotThreadRouteView() {});},}}- onSaveBot={async ({- name,- label,- description,- engine,- usageCap,- sandbox,- voiceEnabled,- disabledMcpServerIds,- }) => {- if (!environmentId) return false;- const result = await updateBot({- environmentId,- input: {- botId: BotId.make(bot.id),- name,- label,- description,- engine,- usageCap,- sandbox,- voiceEnabled,- disabledMcpServerIds,- },- });- if (result._tag === "Failure") {- toastManager.add({ type: "error", title: "Could not save bot settings" });- return false;- }- toastManager.add({ type: "success", title: "Bot settings saved" });- return true;+ onOpenSettings={() => {+ void navigate({ to: "/bots/$botId/settings", params: { botId } });}}/>) : null}diff --git a/apps/web/src/routes/bots.$botId.settings.tsx b/apps/web/src/routes/bots.$botId.settings.tsxnew file mode 100644index 000000000..56301f60c--- /dev/null+++ b/apps/web/src/routes/bots.$botId.settings.tsx@@ -0,0 +1,15 @@+import { createFileRoute, redirect } from "@tanstack/react-router";++import { BotSettingsPage } from "../components/roster/BotSettingsPage";++export const Route = createFileRoute("/bots/$botId/settings")({+ beforeLoad: async ({ context }) => {+ if (+ context.authGateState.status !== "authenticated" &&+ context.authGateState.status !== "hosted-static"+ ) {+ throw redirect({ to: "/pair", replace: true });+ }+ },+ component: () => <BotSettingsPage botId={Route.useParams().botId} />,+});diff --git a/packages/contracts/src/botConfig.test.ts b/packages/contracts/src/botConfig.test.tsindex 70139f974..217ee5ad3 100644--- a/packages/contracts/src/botConfig.test.ts+++ b/packages/contracts/src/botConfig.test.ts@@ -1,10 +1,11 @@import * as Schema from "effect/Schema";import { describe, expect, it } from "vite-plus/test";-import { BotCreatedPayload, BotUsageCap } from "./orchestration.ts";+import { BotCreatedPayload, BotPersonalityTone, BotUsageCap } from "./orchestration.ts";const decodeUsageCap = Schema.decodeUnknownSync(BotUsageCap);const decodeCreated = Schema.decodeUnknownSync(BotCreatedPayload);+const decodePersonalityTone = Schema.decodeUnknownSync(BotPersonalityTone);describe("BotUsageCap", () => {it("accepts positive token limits and rejects invalid limits", () => {@@ -36,6 +37,7 @@ describe("BotUsageCap", () => {expect(bot.description).toBeNull();expect(bot.disabledMcpServerIds).toEqual([]);expect(bot.voiceEnabled).toBe(false);+ expect(bot.personalityTone).toBe(50);});it("accepts cloud sandbox providers on bot events", () => {@@ -56,3 +58,12 @@ describe("BotUsageCap", () => {}});});++describe("BotPersonalityTone", () => {+ it("accepts the slider range and rejects values outside it", () => {+ for (const tone of [0, 40, 50, 100]) expect(decodePersonalityTone(tone)).toBe(tone);+ for (const tone of [-1, 101, 49.5, Number.NaN]) {+ expect(() => decodePersonalityTone(tone)).toThrow();+ }+ });+});diff --git a/packages/contracts/src/orchestration.ts b/packages/contracts/src/orchestration.tsindex c5caf6fe8..f9768ee7e 100644--- a/packages/contracts/src/orchestration.ts+++ b/packages/contracts/src/orchestration.ts@@ -395,6 +395,17 @@ export const BotUsageCap = Schema.Struct({});export type BotUsageCap = typeof BotUsageCap.Type;+export const MIN_BOT_PERSONALITY_TONE = 0;+export const BALANCED_BOT_PERSONALITY_TONE = 50;+export const MAX_BOT_PERSONALITY_TONE = 100;+export const BotPersonalityTone = Schema.Int.check(+ Schema.isBetween({+ minimum: MIN_BOT_PERSONALITY_TONE,+ maximum: MAX_BOT_PERSONALITY_TONE,+ }),+);+export type BotPersonalityTone = typeof BotPersonalityTone.Type;+export const CHANNEL_PROVIDERS = ["telegram", "imessage", "whatsapp", "slack", "discord"] as const;export const ChannelProvider = Schema.Literals(CHANNEL_PROVIDERS);export type ChannelProvider = typeof ChannelProvider.Type;@@ -502,6 +513,7 @@ export const OrchestrationBot = Schema.Struct({sandbox: PersistedBotSandbox,runtimeMode: RuntimeMode.pipe(Schema.withDecodingDefault(Effect.succeed(DEFAULT_RUNTIME_MODE))),usageCap: Schema.NullOr(BotUsageCap).pipe(Schema.withDecodingDefault(Effect.succeed(null))),+ personalityTone: Schema.optionalKey(BotPersonalityTone),voiceEnabled: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(false))),channelBindings: Schema.Array(ChannelBinding).pipe(Schema.withDecodingDefault(Effect.succeed([])),@@ -1102,6 +1114,7 @@ const BotCreateCommand = Schema.Struct({sandbox: Schema.NullOr(BotSandbox),runtimeMode: Schema.optional(RuntimeMode),usageCap: Schema.NullOr(BotUsageCap).pipe(Schema.withDecodingDefault(Effect.succeed(null))),+ personalityTone: Schema.optional(BotPersonalityTone),voiceEnabled: Schema.optional(Schema.Boolean),groupId: Schema.NullOr(GroupId),createdAt: IsoDateTime,@@ -1121,6 +1134,7 @@ const BotUpdateCommand = Schema.Struct({sandbox: Schema.optional(Schema.NullOr(BotSandbox)),runtimeMode: Schema.optional(RuntimeMode),usageCap: Schema.optional(Schema.NullOr(BotUsageCap)),+ personalityTone: Schema.optional(BotPersonalityTone),voiceEnabled: Schema.optional(Schema.Boolean),channelBindings: Schema.optional(Schema.Array(ChannelBinding)),groupId: Schema.optional(Schema.NullOr(GroupId)),@@ -1140,6 +1154,7 @@ const ClientBotUpdateCommand = Schema.Struct({sandbox: Schema.optional(Schema.NullOr(BotSandbox)),runtimeMode: Schema.optional(RuntimeMode),usageCap: Schema.optional(Schema.NullOr(BotUsageCap)),+ personalityTone: Schema.optional(BotPersonalityTone),voiceEnabled: Schema.optional(Schema.Boolean),groupId: Schema.optional(Schema.NullOr(GroupId)),});@@ -2125,6 +2140,9 @@ export const BotCreatedPayload = Schema.Struct({sandbox: PersistedBotSandbox,runtimeMode: RuntimeMode.pipe(Schema.withDecodingDefault(Effect.succeed(DEFAULT_RUNTIME_MODE))),usageCap: Schema.NullOr(BotUsageCap).pipe(Schema.withDecodingDefault(Effect.succeed(null))),+ personalityTone: BotPersonalityTone.pipe(+ Schema.withDecodingDefault(Effect.succeed(BALANCED_BOT_PERSONALITY_TONE)),+ ),voiceEnabled: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(false))),channelBindings: Schema.Array(ChannelBinding).pipe(Schema.withDecodingDefault(Effect.succeed([])),@@ -2146,6 +2164,7 @@ export const BotUpdatedPayload = Schema.Struct({sandbox: Schema.optional(PersistedBotSandbox),runtimeMode: Schema.optional(RuntimeMode),usageCap: Schema.optional(Schema.NullOr(BotUsageCap)),+ personalityTone: Schema.optional(BotPersonalityTone),voiceEnabled: Schema.optional(Schema.Boolean),channelBindings: Schema.optional(Schema.Array(ChannelBinding)),groupId: Schema.optional(Schema.NullOr(GroupId)),diff --git a/packages/contracts/src/portability.ts b/packages/contracts/src/portability.tsindex 8a4cb5b70..897268a90 100644--- a/packages/contracts/src/portability.ts+++ b/packages/contracts/src/portability.ts@@ -17,6 +17,7 @@ import { McpServerConfiguration, McpServerId } from "./mcpServer.ts";import {BotAvatar,BotEngine,+ BotPersonalityTone,BotSandboxBrowserSharing,PersistedBotSandbox,BotUsageCap,@@ -92,6 +93,7 @@ export const PortabilityBotData = Schema.Struct({sandbox: PersistedBotSandbox,runtimeMode: RuntimeMode,usageCap: Schema.NullOr(BotUsageCap),+ personalityTone: Schema.optionalKey(BotPersonalityTone),voiceEnabled: Schema.Boolean,archived: Schema.Boolean,});diff --git a/packages/contracts/src/provider.test.ts b/packages/contracts/src/provider.test.tsindex 909f3173d..b7b144b1d 100644--- a/packages/contracts/src/provider.test.ts+++ b/packages/contracts/src/provider.test.ts@@ -70,11 +70,13 @@ describe("ProviderSessionStartInput", () => {provider: "codex",botId: "bot-one",botName: "Research bot",+ personalityTone: 40,botSandboxBrowserSharing: "separate",runtimeMode: "full-access",});expect(parsed.botId).toBe("bot-one");expect(parsed.botName).toBe("Research bot");+ expect(parsed.personalityTone).toBe(40);expect(parsed.botSandboxBrowserSharing).toBe("separate");});diff --git a/packages/contracts/src/provider.ts b/packages/contracts/src/provider.tsindex a571e950e..efd8aeebd 100644--- a/packages/contracts/src/provider.ts+++ b/packages/contracts/src/provider.ts@@ -13,6 +13,7 @@ import {import {BotSandbox,BotSandboxBrowserSharing,+ BotPersonalityTone,ChatAttachment,ModelSelection,PROVIDER_SEND_TURN_MAX_ATTACHMENTS,@@ -68,6 +69,7 @@ export const ProviderSessionStartInput = Schema.Struct({sandboxMode: Schema.optional(ProviderSandboxMode),botId: Schema.optional(BotId),botName: Schema.optional(TrimmedNonEmptyString),+ personalityTone: Schema.optional(BotPersonalityTone),botSandbox: Schema.optional(Schema.NullOr(BotSandbox)),botSandboxEnvironment: Schema.optional(Schema.Record(Schema.String, Schema.String)),botSandboxBrowserSharing: Schema.optional(BotSandboxBrowserSharing),