@hraness/dawg 0.6.1 → 0.7.0

package/src/audio/winds/engine.ts

@@ -170,7 +170,11 @@ export function renderWindTrack(
     if (points) lanes.set(param, points);
   }
   const base = windSettings(track.wind);
-  const trim = windTrim(windPresetOf(track.wind), sampleRate);
+  const trim = windTrim(
+    windPresetOf(track.wind),
+    sampleRate,
+    context.score.calibration ?? 0,
+  );
   const players = Math.max(1, Math.round(base.players));
   const seedTick = context.seedTick ?? 0;
   const volumeLane = track.volumeAutomation ?? [];

package/src/audio/winds/trim.ts

@@ -11,6 +11,7 @@
  */
 import type { WindPresetName } from "../../../core/winds.ts";
 import { WIND_TRIM_TABLE } from "./trims.ts";
+import { WIND_TRIM_TABLE_1 } from "./trims1.ts";
 import type { WindTrim } from "./voice.ts";
 
 /** House sustain level of every preset at velocity 0.8, dBFS RMS. */
@@ -44,8 +45,19 @@ function nearestRate(sampleRate: number): number {
 export function windTrimRow(
   preset: WindPresetName,
   sampleRate: number,
+  calibration = 0,
 ): WindTrimRow | undefined {
-  return WIND_TRIM_TABLE[nearestRate(sampleRate)]?.[preset];
+  const rate = nearestRate(sampleRate);
+  if (calibration >= 1) {
+    const row = WIND_TRIM_TABLE_1[rate]?.[preset];
+    if (row) return row;
+  }
+  return WIND_TRIM_TABLE[rate]?.[preset];
+}
+
+/** True when `preset` has a calibration 1 row (the lip-model brass). */
+export function windCalibrated(preset: WindPresetName): boolean {
+  return WIND_TRIM_TABLE_1[WIND_TRIM_RATES[0]!]?.[preset] !== undefined;
 }
 
 function interpolate(lo: number, grid: readonly number[], hz: number): number {
@@ -69,12 +81,24 @@ export function rowGain(row: WindTrimRow, hz: number): number {
   return row.gains ? 10 ** (interpolate(row.lo, row.gains, hz) / 20) : 1;
 }
 
-export function windTrim(preset: WindPresetName, sampleRate: number): WindTrim {
-  const row = windTrimRow(preset, sampleRate);
-  if (!row) return { cents: () => 0, level: 1 };
+/**
+ * The voice trim of `preset` at `sampleRate`. Under calibration 1 the
+ * lip-model brass use the calibration 1 rows (`trims1.ts`) and the
+ * calibrated lips; everything else, and every legacy song, keeps the
+ * original table.
+ */
+export function windTrim(
+  preset: WindPresetName,
+  sampleRate: number,
+  calibration = 0,
+): WindTrim {
+  const lips = calibration >= 1 && windCalibrated(preset);
+  const row = windTrimRow(preset, sampleRate, calibration);
+  if (!row) return { cents: () => 0, level: 1, ...(lips ? { lips: 1 } : {}) };
   return {
     cents: (hz) => rowCents(row, hz),
     level: row.level,
     gain: (hz) => rowGain(row, hz),
+    ...(lips ? { lips: 1 as const } : {}),
   };
 }

package/src/audio/winds/trims1.ts

@@ -0,0 +1,297 @@
+// Generated by scripts/calibrate-winds.ts --lips1; do not edit.
+export const WIND_TRIM_TABLE_1: Readonly<
+  Record<
+    number,
+    Readonly<
+      Record<
+        string,
+        Readonly<{
+          lo: number;
+          cents: readonly number[];
+          level: number;
+          gains?: readonly number[];
+        }>
+      >
+    >
+  >
+> = {
+  "22050": {
+    trumpet: {
+      lo: 50,
+      cents: [
+        -4225, -4228, -4232, -4238, -4246, -4256, -4267, -4281, -4296, -4313,
+        -4333, -4354, -4379, -4404, -4433, -4464, -4499, -4535, -4572, -4616,
+        -4665, -4713, -4767, -4823, -4878, -4948, -5019, -5091, -5177, -5257,
+        -5352, -5450, -5551, -5652, -5784,
+      ],
+      level: 0.9712,
+      gains: [
+        138, 131, 124, 118, 111, 104, 97, 90, 83, 75, 67, 59, 50, 41, 32, 21,
+        11, 0, -14, -25, -35, -48, -61, -74, -92, -101, -112, -126, -133, -147,
+        -153, -161, -169, -181, -176,
+      ],
+    },
+    harmon: {
+      lo: 50,
+      cents: [
+        -4225, -4228, -4232, -4238, -4246, -4256, -4267, -4281, -4296, -4313,
+        -4333, -4354, -4379, -4404, -4433, -4464, -4499, -4535, -4572, -4616,
+        -4665, -4713, -4767, -4823, -4878, -4948, -5019, -5091, -5177, -5257,
+        -5352, -5450, -5551, -5652, -5784,
+      ],
+      level: 0.6641,
+      gains: [
+        1292, 1201, 1089, 1028, 939, 862, 750, 650, 454, 487, 509, 434, 300, 40,
+        -245, -50, 106, 79, -24, 39, 0, -165, -484, -728, -450, -232, -166,
+        -207, -357, -677, -924, -616, -345, -204, -117,
+      ],
+    },
+    plunger: {
+      lo: 50,
+      cents: [
+        -4235, -4238, -4243, -4249, -4256, -4267, -4278, -4292, -4307, -4324,
+        -4344, -4366, -4390, -4416, -4445, -4476, -4511, -4548, -4585, -4629,
+        -4678, -4726, -4781, -4837, -4892, -4963, -5034, -5107, -5194, -5274,
+        -5370, -5468, -5571, -5672, -5805,
+      ],
+      level: 0.798,
+      gains: [
+        15, 0, -14, -27, -41, -56, -70, -84, -97, -108, -114, -116, -114, -110,
+        -106, -99, -86, -65, -33, 11, 62, 111, 157, 192, 216, 232, 240, 247,
+        260, 284, 324, 382, 456, 543, 637,
+      ],
+    },
+    trombone: {
+      lo: 38,
+      cents: [
+        -4316, -4300, -4284, -4272, -4261, -4251, -4243, -4236, -4231, -4227,
+        -4225, -4224, -4225, -4228, -4232, -4238, -4246, -4256, -4267, -4281,
+        -4296, -4313, -4333, -4354, -4379, -4404, -4433, -4464, -4499, -4535,
+        -4572, -4616, -4665, -4713, -4767, -4823, -4878,
+      ],
+      level: 1.1414,
+      gains: [
+        118, 110, 103, 99, 92, 84, 77, 72, 66, 59, 51, 44, 37, 31, 25, 19, 12,
+        7, 0, -6, -13, -20, -26, -34, -42, -50, -58, -68, -77, -88, -101, -112,
+        -122, -135, -148, -162, -180,
+      ],
+    },
+    tuba: {
+      lo: 26,
+      cents: [
+        -4028, -3992, -4101, -4190, -4224, -4209, -4268, -4354, -4368, -4358,
+        -4338, -4329, -4316, -4300, -4286, -4272, -4261, -4251, -4243, -4236,
+        -4231, -4227, -4225, -4224, -4225, -4228, -4232, -4238, -4246, -4256,
+        -4267, -4281, -4296, -4313, -4333,
+      ],
+      level: 1.2795,
+      gains: [
+        144, 115, 104, 96, 84, 70, 62, 72, 67, 56, 46, 36, 27, 20, 11, 9, 4, 0,
+        -3, -3, -6, -8, -14, -21, -28, -34, -40, -45, -51, -56, -62, -68, -74,
+        -80, -86,
+      ],
+    },
+    horn: {
+      lo: 39,
+      cents: [
+        -4278, -4265, -4251, -4240, -4230, -4222, -4215, -4210, -4207, -4204,
+        -4203, -4204, -4207, -4211, -4217, -4224, -4234, -4245, -4258, -4273,
+        -4290, -4310, -4331, -4355, -4380, -4409, -4439, -4473, -4509, -4545,
+        -4588, -4636, -4684, -4737, -4793, -4847, -4916, -4986, -5057, -5142,
+        -5220,
+      ],
+      level: 1.7422,
+      gains: [
+        93, 84, 82, 78, 74, 72, 73, 71, 71, 65, 58, 51, 45, 39, 34, 29, 23, 17,
+        12, 6, 0, -6, -12, -19, -26, -33, -42, -50, -60, -72, -82, -92, -105,
+        -118, -133, -150, -162, -176, -192, -203, -219,
+      ],
+    },
+  },
+  "44100": {
+    trumpet: {
+      lo: 50,
+      cents: [
+        -4106, -4101, -4097, -4094, -4092, -4091, -4092, -4094, -4097, -4101,
+        -4107, -4114, -4122, -4131, -4142, -4154, -4167, -4182, -4199, -4217,
+        -4238, -4259, -4282, -4308, -4335, -4365, -4397, -4432, -4469, -4508,
+        -4548, -4594, -4640, -4695, -4751,
+      ],
+      level: 0.9423,
+      gains: [
+        160, 153, 145, 138, 131, 123, 115, 107, 98, 89, 80, 70, 60, 49, 38, 26,
+        13, 0, -14, -28, -42, -57, -73, -88, -104, -119, -134, -149, -163, -176,
+        -190, -202, -214, -221, -228,
+      ],
+    },
+    harmon: {
+      lo: 50,
+      cents: [
+        -4106, -4101, -4097, -4094, -4092, -4091, -4092, -4094, -4097, -4101,
+        -4107, -4114, -4122, -4131, -4142, -4154, -4167, -4182, -4199, -4217,
+        -4238, -4259, -4282, -4308, -4335, -4365, -4397, -4432, -4469, -4508,
+        -4548, -4594, -4640, -4695, -4751,
+      ],
+      level: 0.617,
+      gains: [
+        1335, 1242, 1130, 1064, 972, 893, 778, 669, 469, 500, 527, 453, 311, 43,
+        -240, -54, 99, 64, -44, 29, 0, -157, -469, -703, -437, -232, -173, -218,
+        -379, -699, -947, -655, -387, -236, -154,
+      ],
+    },
+    plunger: {
+      lo: 50,
+      cents: [
+        -4116, -4110, -4106, -4103, -4102, -4101, -4102, -4104, -4107, -4111,
+        -4117, -4124, -4132, -4141, -4152, -4164, -4178, -4193, -4210, -4228,
+        -4249, -4271, -4294, -4320, -4346, -4377, -4410, -4444, -4481, -4521,
+        -4561, -4607, -4654, -4709, -4765,
+      ],
+      level: 0.792,
+      gains: [
+        16, 0, -14, -29, -43, -58, -72, -87, -101, -112, -118, -121, -121, -118,
+        -115, -109, -97, -76, -43, 1, 53, 107, 157, 200, 232, 255, 272, 287,
+        307, 337, 381, 443, 521, 609, 705,
+      ],
+    },
+    trombone: {
+      lo: 38,
+      cents: [
+        -4263, -4243, -4223, -4206, -4191, -4176, -4163, -4151, -4139, -4129,
+        -4120, -4113, -4106, -4101, -4097, -4094, -4092, -4091, -4092, -4094,
+        -4097, -4101, -4107, -4114, -4122, -4131, -4142, -4154, -4167, -4182,
+        -4199, -4217, -4238, -4259, -4282, -4308, -4335,
+      ],
+      level: 1.1326,
+      gains: [
+        126, 117, 111, 105, 98, 90, 83, 78, 71, 64, 56, 49, 41, 34, 27, 21, 14,
+        7, 0, -8, -15, -23, -31, -39, -49, -58, -68, -79, -91, -103, -116, -130,
+        -144, -158, -174, -189, -206,
+      ],
+    },
+    tuba: {
+      lo: 26,
+      cents: [
+        -4009, -3969, -4075, -4161, -4193, -4176, -4232, -4316, -4327, -4314,
+        -4291, -4280, -4263, -4243, -4225, -4207, -4191, -4176, -4163, -4151,
+        -4139, -4129, -4120, -4113, -4106, -4101, -4097, -4094, -4092, -4091,
+        -4092, -4094, -4097, -4101, -4107,
+      ],
+      level: 1.2794,
+      gains: [
+        146, 117, 106, 98, 86, 71, 64, 74, 69, 58, 47, 37, 28, 21, 12, 9, 4, 0,
+        -3, -4, -7, -9, -15, -22, -30, -36, -43, -49, -55, -61, -68, -74, -81,
+        -88, -95,
+      ],
+    },
+    horn: {
+      lo: 39,
+      cents: [
+        -4222, -4205, -4187, -4171, -4156, -4143, -4131, -4120, -4110, -4101,
+        -4093, -4087, -4081, -4077, -4074, -4072, -4071, -4072, -4073, -4076,
+        -4080, -4086, -4092, -4100, -4110, -4120, -4132, -4145, -4160, -4176,
+        -4195, -4214, -4236, -4259, -4284, -4310, -4341, -4372, -4406, -4442,
+        -4481,
+      ],
+      level: 1.7269,
+      gains: [
+        102, 92, 90, 86, 82, 80, 80, 78, 78, 72, 64, 57, 50, 44, 38, 32, 26, 20,
+        13, 7, 0, -7, -14, -22, -30, -39, -48, -59, -70, -82, -95, -108, -122,
+        -138, -153, -170, -186, -203, -220, -236, -252,
+      ],
+    },
+  },
+  "48000": {
+    trumpet: {
+      lo: 50,
+      cents: [
+        -4097, -4091, -4086, -4082, -4080, -4078, -4078, -4079, -4081, -4084,
+        -4089, -4094, -4101, -4109, -4119, -4129, -4141, -4155, -4170, -4186,
+        -4204, -4223, -4245, -4267, -4292, -4319, -4348, -4378, -4411, -4448,
+        -4487, -4527, -4572, -4618, -4665,
+      ],
+      level: 0.9403,
+      gains: [
+        162, 155, 147, 140, 132, 124, 116, 108, 99, 90, 81, 71, 61, 50, 38, 26,
+        13, 0, -14, -28, -43, -58, -74, -89, -105, -121, -136, -152, -167, -180,
+        -193, -206, -216, -225, -236,
+      ],
+    },
+    harmon: {
+      lo: 50,
+      cents: [
+        -4097, -4091, -4086, -4082, -4080, -4078, -4078, -4079, -4081, -4084,
+        -4089, -4094, -4101, -4109, -4119, -4129, -4141, -4155, -4170, -4186,
+        -4204, -4223, -4245, -4267, -4292, -4319, -4348, -4378, -4411, -4448,
+        -4487, -4527, -4572, -4618, -4665,
+      ],
+      level: 0.6137,
+      gains: [
+        1339, 1245, 1133, 1066, 974, 895, 780, 671, 469, 501, 528, 454, 312, 43,
+        -240, -55, 99, 63, -46, 28, 0, -156, -467, -701, -436, -232, -173, -220,
+        -381, -701, -948, -657, -388, -239, -159,
+      ],
+    },
+    plunger: {
+      lo: 50,
+      cents: [
+        -4106, -4100, -4095, -4092, -4089, -4088, -4088, -4089, -4091, -4094,
+        -4099, -4104, -4111, -4119, -4129, -4140, -4152, -4165, -4180, -4196,
+        -4215, -4234, -4256, -4279, -4304, -4331, -4360, -4390, -4423, -4461,
+        -4499, -4539, -4585, -4632, -4679,
+      ],
+      level: 0.7915,
+      gains: [
+        16, 0, -14, -29, -43, -58, -72, -87, -101, -112, -119, -122, -121, -119,
+        -116, -110, -98, -77, -44, 0, 53, 106, 157, 200, 233, 257, 275, 290,
+        310, 341, 386, 448, 526, 615, 711,
+      ],
+    },
+    trombone: {
+      lo: 38,
+      cents: [
+        -4258, -4238, -4219, -4201, -4185, -4170, -4156, -4144, -4132, -4122,
+        -4112, -4104, -4097, -4091, -4086, -4082, -4080, -4078, -4078, -4079,
+        -4081, -4084, -4089, -4094, -4101, -4109, -4119, -4129, -4141, -4155,
+        -4170, -4186, -4204, -4223, -4245, -4267, -4292,
+      ],
+      level: 1.1319,
+      gains: [
+        126, 118, 111, 106, 99, 91, 84, 78, 71, 64, 56, 49, 41, 34, 28, 21, 14,
+        7, 0, -8, -15, -23, -31, -40, -49, -59, -69, -80, -92, -104, -117, -131,
+        -146, -160, -176, -192, -208,
+      ],
+    },
+    tuba: {
+      lo: 26,
+      cents: [
+        -4007, -3967, -4073, -4159, -4190, -4173, -4229, -4313, -4324, -4311,
+        -4287, -4276, -4258, -4238, -4220, -4202, -4185, -4170, -4156, -4144,
+        -4132, -4122, -4112, -4104, -4097, -4091, -4086, -4082, -4080, -4078,
+        -4078, -4079, -4081, -4084, -4089,
+      ],
+      level: 1.2794,
+      gains: [
+        146, 117, 106, 98, 86, 72, 65, 74, 69, 58, 48, 38, 28, 21, 12, 9, 4, 0,
+        -3, -4, -7, -9, -15, -22, -30, -36, -43, -49, -55, -61, -68, -75, -81,
+        -89, -96,
+      ],
+    },
+    horn: {
+      lo: 39,
+      cents: [
+        -4218, -4200, -4182, -4165, -4151, -4137, -4124, -4113, -4102, -4093,
+        -4084, -4077, -4071, -4066, -4062, -4060, -4058, -4058, -4059, -4061,
+        -4064, -4068, -4073, -4080, -4088, -4097, -4108, -4119, -4133, -4147,
+        -4163, -4181, -4200, -4221, -4244, -4268, -4295, -4324, -4353, -4386,
+        -4422,
+      ],
+      level: 1.7256,
+      gains: [
+        102, 93, 91, 86, 82, 80, 80, 79, 78, 72, 65, 57, 51, 44, 38, 33, 26, 20,
+        13, 7, 0, -7, -14, -22, -31, -39, -49, -59, -71, -83, -96, -109, -124,
+        -139, -155, -172, -188, -205, -223, -240, -255,
+      ],
+    },
+  },
+};

package/src/audio/winds/voice.ts

@@ -59,6 +59,13 @@ export type WindTrim = Readonly<{
   level: number;
   /** Loudness curve over the range: a gain factor at `hz` (default 1). */
   gain?: (hz: number) => number;
+  /**
+   * Calibration 1 lips (q08): the lip resonance sits on the sounding pitch
+   * at Q 40 and the lip opening saturates softly, so the lips lock to the
+   * bore's mode instead of beating against it (a 23-35% warble every 8 or
+   * 9 periods before). Only the calibration 1 trim rows set it.
+   */
+  lips?: 1;
 }>;
 
 const NO_TRIM: WindTrim = { cents: () => 0, level: 1 };
@@ -328,8 +335,11 @@ export class WindVoice {
         // STK Brass: a bore of two periods sounding its 2nd mode and a lip
         // resonance a little below f (constant Q 12, unit DC gain x 3 so
         // every register speaks); the trim removes the pull (+15..45 c).
+        // Calibration 1 tunes the lips to f at Q 40 (see WindTrim.lips).
         this.d0.set(2 * period - dcBlockDelay(this.dc.r, w), w);
-        this.lip.set(f * (0.95 + 0.04 * (p.reed - 0.5)), 12, 3, rate);
+        if (this.trim.lips)
+          this.lip.set(f * (1 + 0.04 * (p.reed - 0.5)), 40, 3, rate);
+        else this.lip.set(f * (0.95 + 0.04 * (p.reed - 0.5)), 12, 3, rate);
         break;
     }
     // Brightness for the reed, sax and lip bores: a high shelf from about
@@ -416,7 +426,10 @@ export class WindVoice {
         const mouth = 0.3 * breath;
         let delta = this.lip.process(mouth - bore);
         delta *= delta;
-        if (delta > 1) delta = 1;
+        // Calibration 1: a soft opening (x / (1 + x)) in place of the hard
+        // clamp, whose corner fed the warble.
+        if (this.trim.lips) delta = delta / (1 + delta);
+        else if (delta > 1) delta = 1;
         const frame = delta * mouth + (1 - delta) * bore;
         this.d0.push(this.dc.process(frame));
         return bore * 2;

package/src/auth/cli.ts

@@ -24,19 +24,20 @@ import { selectProvider } from "../agent/provider.ts";
 import { audioStatusLine } from "../audio/engine.ts";
 
 export const AUTH_USAGE = `Usage:
-  dawg login                  find existing setups and pick a provider (reuses a saved one)
-  dawg login gateway          Vercel AI Gateway: existing key, or create one with the Vercel CLI
-  dawg login openrouter       OpenRouter: sign in through your browser (OAuth PKCE)
-  dawg login codex            ChatGPT/Codex subscription through xcb
-  dawg login claude           Claude subscription through xcb
-  dawg login --pick           show the picker even when a provider is saved
-  dawg login --key            paste an AI Gateway key (hidden input)
-  dawg login --xcb            any xcb account (Devin included)
-  dawg login gateway --budget <dollars>   spend limit for a created key
-  dawg login codex|claude [--account <id>] [--model <key>]
+  dawg model key              find existing setups and pick a provider (reuses a saved one)
+  dawg model key gateway      Vercel AI Gateway: existing key, or create one with the Vercel CLI
+  dawg model key openrouter   OpenRouter: authorize in your browser (OAuth PKCE)
+  dawg model key codex        ChatGPT/Codex subscription through xcb
+  dawg model key claude       Claude subscription through xcb
+  dawg model key --pick       show the picker even when a provider is saved
+  dawg model key --key        paste an AI Gateway key (hidden input)
+  dawg model key --xcb        any xcb account (Devin included)
+  dawg model key gateway --budget <dollars>   spend limit for a created key
+  dawg model key codex|claude [--account <id>] [--model <key>]
   dawg model [<alias>|<vendor/model>]     pick the model (cost per prompt shown)
   dawg logout [gateway|openrouter|codex|claude|xcb]   forget keys and the saved choice
-  dawg auth status [--check]  every provider: detected, active, validated`;
+  dawg auth status [--check]  every provider: detected, active, validated
+The older spelling of \`model key\` still works as an alias.`;
 
 /** Entry for `dawg login|logout|auth|model`. Returns the process exit code. */
 export async function runAuthCommand(argv: readonly string[]): Promise<number> {
@@ -82,40 +83,41 @@ export async function runAuthCommand(argv: readonly string[]): Promise<number> {
   return login(parsed.target, deps, parsed.options);
 }
 
+/** A one-time card the TUI shows at launch about the agent. */
+export type FirstRunCard = Readonly<{
+  text: string;
+  tone: "info" | "warning";
+}>;
+
 /**
- * The first run of `dawg` in a terminal: when nothing is configured (and the
- * picker was never dismissed), or a saved sign-in stopped working, show the
- * sign-in picker before the TUI starts. Dismissing it is remembered.
+ * The launch note about the agent. dawg opens straight into the TUI: music
+ * first, sign-in optional. The first session with no provider gets one
+ * faint card, `/model key adds an agent · optional`, and records that it was
+ * shown so later sessions stay quiet; a saved sign-in that stopped working
+ * says so. `dawg login` and `/login` keep the picker.
  */
-export async function runFirstRunLogin(
+export async function firstRunCard(
   runner: CommandRunner = systemRunner,
-): Promise<void> {
+): Promise<FirstRunCard | undefined> {
   const auth = defaultAuthEnv(runner);
   const config = await readConfig(auth).catch(() => ({}) as DawgConfig);
-  if (auth.env.DAWG_PROVIDER) return;
-  if (!config.provider && config.setup === "skipped") return;
+  if (auth.env.DAWG_PROVIDER) return undefined;
+  if (!config.provider && config.setup === "skipped") return undefined;
   const selection = await selectProvider(auth).catch(() => undefined);
-  if (!selection || selection.kind !== "offline") return;
-  if (config.provider && !selection.invalidSaved) return;
-  const io = terminalIO();
-  if (!io.interactive) return;
+  if (!selection || selection.kind !== "offline") return undefined;
   if (selection.invalidSaved)
-    io.print(`Your saved sign-in stopped working: ${selection.reason}.`);
-  else io.print("Welcome to dawg. Sign in to enable the agent (Esc to skip).");
-  const code = await login("pick", {
-    auth,
-    io,
-    hostname: hostname(),
-  }).catch((error: unknown) => {
-    io.print(
-      `sign-in failed: ${error instanceof Error ? error.message : String(error)}`,
-    );
-    return 1;
-  });
-  if (code !== 0 && !config.provider)
-    await writeConfig(auth, { setup: "skipped" }).catch(() => undefined);
+    return {
+      text: `saved sign-in stopped working: ${selection.reason} · /login`,
+      tone: "warning",
+    };
+  if (config.provider) return undefined;
+  await writeConfig(auth, { setup: "skipped" }).catch(() => undefined);
+  return { text: FIRST_RUN_CARD, tone: "info" };
 }
 
+/** The first session's agent note. */
+export const FIRST_RUN_CARD = "/model key adds an agent · optional";
+
 /** `/login` in the TUI, run while the screen is handed back to the shell. */
 export async function runTuiLogin(
   target: LoginTarget,

package/src/auth/credentials.ts

@@ -83,11 +83,29 @@ export type DawgConfig = Readonly<{
   openrouterModel?: string;
   /** Set when the first-run picker was dismissed, so it does not nag. */
   setup?: "skipped";
+  /** Show-me level of agent turns (`/showme`); absent is on. */
+  showMe?: "on" | "quiet" | "off";
 }>;
 
 /** `vendor/model` IDs as the AI Gateway and OpenRouter spell them. */
 export const PROVIDER_MODEL_ID_PATTERN =
   /^[a-z0-9][a-z0-9-]{0,63}\/[a-z0-9][a-z0-9._-]{0,127}$/i;
+/**
+ * OpenRouter also takes a routing variant after a colon: `:nitro`
+ * (throughput first), `:floor` (price first), `:free`, `:online` and so on.
+ */
+export const OPENROUTER_MODEL_ID_PATTERN =
+  /^[a-z0-9][a-z0-9-]{0,63}\/[a-z0-9][a-z0-9._-]{0,127}(?::[a-z0-9-]{1,32})?$/i;
+
+/** True for an ID the given provider accepts; any provider when omitted. */
+export function isProviderModelId(
+  id: string,
+  provider?: "gateway" | "openrouter",
+): boolean {
+  return provider === "gateway"
+    ? PROVIDER_MODEL_ID_PATTERN.test(id)
+    : OPENROUTER_MODEL_ID_PATTERN.test(id);
+}
 
 export type CredentialSource = "env" | "keychain" | "file" | "oidc";
 export type ResolvedKey = Readonly<{ key: string; source: CredentialSource }>;
@@ -314,6 +332,7 @@ export function parseConfig(value: unknown): DawgConfig {
     gatewayModel?: string;
     openrouterModel?: string;
     setup?: "skipped";
+    showMe?: "on" | "quiet" | "off";
   } = {};
   if (PROVIDER_CHOICES.includes(record.provider as ProviderChoice))
     config.provider = record.provider as ProviderChoice;
@@ -323,10 +342,19 @@ export function parseConfig(value: unknown): DawgConfig {
   }
   for (const field of ["gatewayModel", "openrouterModel"] as const) {
     const id = record[field];
-    if (typeof id === "string" && PROVIDER_MODEL_ID_PATTERN.test(id))
+    if (
+      typeof id === "string" &&
+      isProviderModelId(id, field === "gatewayModel" ? "gateway" : "openrouter")
+    )
       config[field] = id;
   }
   if (record.setup === "skipped") config.setup = "skipped";
+  if (
+    record.showMe === "on" ||
+    record.showMe === "quiet" ||
+    record.showMe === "off"
+  )
+    config.showMe = record.showMe;
   return config;
 }
 
@@ -350,6 +378,7 @@ export type ConfigPatch = Partial<{
   gatewayModel: string | undefined;
   openrouterModel: string | undefined;
   setup: "skipped" | undefined;
+  showMe: "on" | "quiet" | "off" | undefined;
 }>;
 
 export async function writeConfig(

package/src/auth/login.ts

@@ -135,7 +135,7 @@ export async function login(
       const selection = await selectProvider(deps.auth);
       if (selection.kind !== "offline") {
         deps.io.print(
-          `Signed in · ${providerLabel(selection)}. Switch with \`dawg login <gateway|openrouter|codex|claude>\` or \`dawg model\`.`,
+          `Agent key · ${providerLabel(selection)}. Switch with \`dawg model key <gateway|openrouter|codex|claude>\` or \`dawg model\`.`,
         );
         return 0;
       }
@@ -165,7 +165,7 @@ async function loginPick(
     if (!best) {
       io.print("No AI provider is set up, and this is not a terminal.");
       io.print(
-        "Set AI_GATEWAY_API_KEY or OPENROUTER_API_KEY, or run `dawg login` in a terminal.",
+        "Set AI_GATEWAY_API_KEY or OPENROUTER_API_KEY, or run `dawg model key` in a terminal.",
       );
       return 1;
     }
@@ -269,7 +269,7 @@ async function loginGateway(
   if (!who) {
     if (!io.interactive) {
       io.print(
-        "Not logged in to Vercel. Run `vercel login` first, or re-run `dawg login` in a terminal.",
+        "Not logged in to Vercel. Run `vercel login` first, or re-run `dawg model key` in a terminal.",
       );
       return 1;
     }
@@ -319,7 +319,7 @@ async function loginGateway(
     io.print(
       `Could not create a key${detail ? `: ${redactKeys(detail)}` : ` (exit ${created.code})`}.`,
     );
-    io.print("You can paste one instead with `dawg login --key`.");
+    io.print("You can paste one instead with `dawg model key --key`.");
     return 1;
   }
   return saveAndReport(deps, "gateway", key, "created");
@@ -622,7 +622,7 @@ async function loginSubscription(
     );
     io.print(`  Install: ${XCB_INSTALL}`);
     io.print(`  Docs:    ${XCB_DOC_URL}`);
-    io.print(`Then run \`dawg login ${family}\` again (or set XCB_BIN).`);
+    io.print(`Then run \`dawg model key ${family}\` again (or set XCB_BIN).`);
     return 1;
   }
   const read = async (): Promise<XcbAccount[] | undefined> => {
@@ -657,7 +657,7 @@ async function loginSubscription(
     const setup = `xcb setup ${family}${mine.length > 0 ? " --new" : ""}`;
     if (!io.interactive) {
       io.print(
-        `No ${FAMILY_TITLES[family]} is ready. Run \`${setup}\`, then \`dawg login ${family}\`.`,
+        `No ${FAMILY_TITLES[family]} is ready. Run \`${setup}\`, then \`dawg model key ${family}\`.`,
       );
       return 1;
     }
@@ -669,7 +669,9 @@ async function loginSubscription(
       .trim()
       .toLowerCase();
     if (answer !== "" && answer !== "y" && answer !== "yes") {
-      io.print(`Run \`${setup}\` when ready, then \`dawg login ${family}\`.`);
+      io.print(
+        `Run \`${setup}\` when ready, then \`dawg model key ${family}\`.`,
+      );
       return 1;
     }
     const result = await auth.runner.run(bin, setup.split(" ").slice(1), {
@@ -809,7 +811,9 @@ async function loginXcb(deps: LoginDeps, preset?: XcbPreset): Promise<number> {
     );
     io.print(`  Install: ${XCB_INSTALL}`);
     io.print(`  Docs:    ${XCB_DOC_URL}`);
-    io.print("Then run `dawg login --xcb` again (or set XCB_BIN to its path).");
+    io.print(
+      "Then run `dawg model key --xcb` again (or set XCB_BIN to its path).",
+    );
     return 1;
   }
   let accounts: readonly XcbAccount[];
@@ -1065,7 +1069,9 @@ export async function logout(
     patch.provider = undefined;
     patch.gatewayModel = undefined;
     patch.openrouterModel = undefined;
-    io.print("Cleared the saved provider and model; `dawg login` asks again.");
+    io.print(
+      "Cleared the saved provider and model; `dawg model key` asks again.",
+    );
   } else if (target === "gateway") patch.gatewayModel = undefined;
   else if (target === "openrouter") patch.openrouterModel = undefined;
   patch.setup = undefined;