tutticode 0.1.1 → 0.2.1

package/README.md

@@ -9,8 +9,15 @@ Claude Desktop and friends.
 
 Rendering happens **in your own browser**, on the same engine as
 tuttidaw.com/code, so a file sounds exactly like the editor. Nothing is
-rendered on a server, there is no account, and it costs nothing. Every result
-carries an `editUrl` that opens the program in TuttiDAW to keep editing.
+rendered on a server and it costs nothing. Every result carries an `editUrl`
+that opens the program in TuttiDAW to keep editing.
+
+Once TuttiDAW switches its limits on (they are being rolled out; until then
+no render is cut or tagged), renders without an account are limited to 60 s,
+and renders over 30 s carry a spoken "register at TuttiDAW" tag. A free
+account lifts both:
+`tutticode login` (renders up to 5 minutes, no tag). See
+[Sign-in and limits](#sign-in-and-limits).
 
 ## Install
 
@@ -72,8 +79,13 @@ peak, the gain applied, per-voice levels, the bar and beat grid (seconds, for
 syncing cuts), the check report, the analysis, the `editUrl` and the written
 files. Audio is never printed.
 
+`--no-brand-tag` (or `TUTTICODE_BRAND_TAG=0`) leaves the "Made with
+TuttiCode" metadata out of the files; signed-in renders only.
+
 Exit codes: `0` ok, `1` errors in the code (or a loudness target that would
-clip), `2` bridge or browser problem, `3` usage.
+clip), `2` bridge or browser problem, `3` usage, `4` not signed in
+(`whoami`), `5` over a limit without sign-in, `6` this tutticode is too old
+(`npm i -g tutticode@latest`).
 
 ### MCP tools
 
@@ -87,8 +99,58 @@ skill teaches both:
 | `code_compare` | compare a render with goals (or a Muse style), or two renders |
 | `code_open` | open a program in a visible TuttiCode tab (`tutticode mcp --headless`: no window, returns the link) |
 | `code_reference` | search the TuttiCode reference shipped in the package |
+| `code_account` | signed in or not, the length limits and today's usage |
 
 The reference documents are also MCP resources (`tutticode://skills/...`).
+`tutticode mcp` uses the same sign-in as the CLI (`tutticode login`, or
+`TUTTICODE_TOKEN` in its environment); it never starts a sign-in itself.
+
+## Sign-in and limits
+
+The limits below apply once TuttiDAW switches them on (they are being rolled
+out; until then every render runs in full and untagged). The sign-in works
+today.
+
+| | Without sign-in | Free account |
+| --- | --- | --- |
+| Longest render | 60 s (longer: error `limit`, exit 5) | 5 minutes |
+| Voice tag "register at TuttiDAW" | mixed in throughout renders over 30 s | never |
+| Formats, stems | all | all |
+
+```sh
+tutticode login                  # opens your browser; approve, come back
+tutticode login --device         # no browser here (SSH, a server): approve a code on any device
+tutticode whoami                 # who renders, the limits, today's usage
+tutticode logout                 # sign this computer out
+```
+
+**For agents.** On a `limit` error, tell the user its message in one
+sentence and carry on within the limit. `tutticode login --device --no-wait
+--json` prints `{verificationUri, verificationUriComplete, userCode,
+expiresIn}` and returns at once: give the user the link, keep working, and
+tutticode finishes the sign-in in the background once they approve. `login`
+without `--no-wait` needs a terminal (exit 3 otherwise).
+
+**The voice tag.** An anonymous render over 30 s has the tag mixed in from
+the start, every few seconds, in the mix and in every stem, before any
+measurement: the loudness, bands, voice levels and `code_compare` include
+it. The report says so (`watermark: {reason, at, removeWith}`) and the CLI
+prints one line. The tag is not part of your program: do not change the code
+to remove it. `tutticode login` (free) does.
+
+**What the sign-in can do.** It can only render with TuttiCode: it cannot
+open your projects, account or billing. It lasts a year; the access token is
+refreshed on its own. Revoke a device, or create an access token for CI, on
+the account page (tuttidaw.com/studio/account).
+
+**CI.** Set `TUTTICODE_TOKEN` to an access token from the account page; it
+wins over a stored sign-in and is never refreshed.
+
+**Where it is stored.** `~/.tutticode/credentials`, one entry per site,
+readable only by you (mode 0600; on Windows an ACL with only your user).
+`tutticode doctor` checks it and `tutticode doctor --fix` repairs it.
+`~/.tutticode/install-id` is a random id the page counts anonymous installs
+by; it is not tied to you.
 
 ## How it works
 
@@ -129,8 +191,11 @@ written inside the stems folder, and never through a symbolic link.
 
 ## Commands
 
-- `tutticode doctor` - Node, the browser, the page, the connection and the
-  engine version.
+- `tutticode doctor [--fix]` - Node, the browser, the page, the connection,
+  the engine version, who renders and whether the credentials file is
+  private (`--fix` makes it private again).
+- `tutticode login [--device [--no-wait] [--json]]`, `tutticode logout`,
+  `tutticode whoami [--json]` - see [Sign-in and limits](#sign-in-and-limits).
 - `tutticode setup` - explains, asks, and then sets the browser policy
   `LocalNetworkAccessAllowedForUrls = ["https://tuttidaw.com"]` for your
   user (Windows: HKCU registry; macOS: `defaults`; Linux: a managed policy
@@ -145,13 +210,16 @@ Bridge flags for every command: `--show` / `--headless`,
 `--browser chrome|edge|<path>`, `--origin <url>` (staging / local dev),
 `--dev-origin <url>`, `--locale <locale>`, `--no-daemon`, `--verbose`.
 Environment: `TUTTICODE_BROWSER` (browser path), `TUTTICODE_HOME` (state
-folder), `TUTTICODE_BROWSER_ARGS` (extra browser flags).
+folder), `TUTTICODE_BROWSER_ARGS` (extra browser flags), `TUTTICODE_TOKEN`
+(an access token, for CI), `TUTTICODE_BRAND_TAG=0` (no metadata tag).
 
 ## Privacy
 
 tutticode sends no telemetry. Your program goes only to the TuttiCode page
-in your own browser. Logs stay in `~/.tutticode/logs` and never contain your
-program or audio.
+in your own browser. The page records each render's length, format and
+outcome (with your account when signed in, else as anonymous counts), never
+the program, file names or audio. Logs stay in `~/.tutticode/logs` and
+never contain your program, audio or tokens.
 
 ## Browsers
 

package/README.zh-CN.md

@@ -7,8 +7,12 @@ Strudel 的超集)变成音频文件,任何 agent 或脚本都能用。它是一
 MCP server,适用于 Claude Code、Copilot CLI、Codex、Cursor、Claude Desktop 等。
 
 渲染**在你自己的浏览器里**进行,用的就是 tuttidaw.com/code 的同一个引擎,所以
-文件和编辑器里听到的一模一样。不经过服务器渲染,不需要账号,也不收费。每个结果
-都带一个 `editUrl`,可以在 TuttiDAW 里打开这段程序继续编辑。
+文件和编辑器里听到的一模一样。不经过服务器渲染,也不收费。每个结果都带一个
+`editUrl`,可以在 TuttiDAW 里打开这段程序继续编辑。
+
+TuttiDAW 启用限制后(正在逐步上线;在此之前渲染既不截断也不加标签),不登录时每次渲染最长 60 秒,超过 30 秒的渲染会混入一段语音标签
+"register at TuttiDAW"。用免费账号登录(`tutticode login`)就没有这些限制:
+每次最长 5 分钟,没有语音标签。见[登录与限制](#登录与限制)。
 
 ## 安装
 
@@ -63,8 +67,12 @@ cat song.tc | tutticode check -             # 从 stdin 读程序
 声部的电平、小节和拍的时间点(秒,用来对齐剪辑点)、检查报告、分析结果、
 `editUrl` 和写出的文件路径。永远不会把音频打印到终端。
 
+`--no-brand-tag`(或 `TUTTICODE_BRAND_TAG=0`)不在文件里写 "Made with
+TuttiCode" 元数据;仅登录后有效。
+
 退出码: `0` 成功, `1` 代码有错(或响度目标会削波), `2` bridge / 浏览器问题,
-`3` 用法错误。
+`3` 用法错误, `4` 未登录(`whoami`), `5` 超出未登录时的限制, `6` tutticode
+版本太旧(`npm i -g tutticode@latest`)。
 
 ### MCP 工具
 
@@ -77,8 +85,51 @@ cat song.tc | tutticode check -             # 从 stdin 读程序
 | `code_compare` | 把一次渲染和目标(或 Muse 风格)比较,或比较两次渲染 |
 | `code_open` | 在可见的 TuttiCode 标签页里打开程序（`tutticode mcp --headless` 时不开窗口，只返回链接） |
 | `code_reference` | 搜索包里自带的 TuttiCode 参考文档 |
+| `code_account` | 是否已登录、时长限制和今天的用量 |
 
 参考文档同时作为 MCP resources 提供(`tutticode://skills/...`)。
+`tutticode mcp` 和 CLI 用同一个登录(`tutticode login`,或它环境里的
+`TUTTICODE_TOKEN`);它自己从不发起登录。
+
+## 登录与限制
+
+下面的限制在 TuttiDAW 启用后生效(正在逐步上线;在此之前每次渲染都完整、不加标签)。
+登录现在就能用。
+
+| | 不登录 | 免费账号 |
+| --- | --- | --- |
+| 每次渲染最长 | 60 秒(更长:错误 `limit`,退出码 5) | 5 分钟 |
+| 语音标签 "register at TuttiDAW" | 超过 30 秒的渲染全程混入 | 没有 |
+| 格式、分轨 | 全部 | 全部 |
+
+```sh
+tutticode login                  # 打开浏览器,确认后回到终端
+tutticode login --device         # 这台机器没有浏览器(SSH、服务器):在任意设备上确认一个码
+tutticode whoami                 # 谁在渲染、限制、今天的用量
+tutticode logout                 # 让这台电脑退出登录
+```
+
+**给 agent。** 遇到 `limit` 错误时,用一句话把错误信息转告用户,然后在限制内继续。
+`tutticode login --device --no-wait --json` 会输出 `{verificationUri,
+verificationUriComplete, userCode, expiresIn}` 并立即返回:把链接交给用户,继续
+工作;用户确认后,tutticode 会在后台完成登录。不带 `--no-wait` 的 `login` 需要
+终端(否则退出码 3)。
+
+**语音标签。** 不登录、超过 30 秒的渲染,从开头起每隔几秒混入一次标签,混音和
+每个分轨都有,而且在所有测量之前混入:响度、频段、声部电平和 `code_compare` 都包含
+它。报告会注明(`watermark: {reason, at, removeWith}`),CLI 也会打印一行说明。
+标签不是你程序的一部分:不要为了去掉它而修改代码。`tutticode login`(免费)即可去掉。
+
+**登录能做什么。** 它只能用 TuttiCode 渲染:打不开你的项目、账号或账单。有效期一年;
+access token 会自动刷新。在账号页面(tuttidaw.com/studio/account)可以撤销某台设备,
+或为 CI 创建 access token。
+
+**CI。** 把 `TUTTICODE_TOKEN` 设为账号页面创建的 access token;它优先于已保存的
+登录,而且不会被刷新。
+
+**保存在哪里。** `~/.tutticode/credentials`,每个站点一条,只有你能读(权限 0600;
+Windows 上 ACL 只含你的用户)。`tutticode doctor` 会检查,`tutticode doctor --fix`
+会修复。`~/.tutticode/install-id` 是一个随机 id,页面用它统计匿名安装数,和你本人无关。
 
 ## 工作原理
 
@@ -110,7 +161,10 @@ token 通信,网页无法访问。无头浏览器通过私有管道(`--remote-de
 
 ## 命令
 
-- `tutticode doctor` —— 检查 Node、浏览器、页面、连接和引擎版本。
+- `tutticode doctor [--fix]` —— 检查 Node、浏览器、页面、连接、引擎版本、谁在渲染,
+  以及登录凭据文件是否只有你能读(`--fix` 修复)。
+- `tutticode login [--device [--no-wait] [--json]]`、`tutticode logout`、
+  `tutticode whoami [--json]` —— 见[登录与限制](#登录与限制)。
 - `tutticode setup` —— 先说明、再询问,同意后为当前用户设置浏览器策略
   `LocalNetworkAccessAllowedForUrls = ["https://tuttidaw.com"]`
   (Windows:HKCU 注册表;macOS:`defaults`;Linux:托管策略文件,需要 sudo),
@@ -124,12 +178,15 @@ token 通信,网页无法访问。无头浏览器通过私有管道(`--remote-de
 `--browser chrome|edge|<路径>`、`--origin <url>`(预发 / 本地开发)、
 `--dev-origin <url>`、`--locale <语言>`、`--no-daemon`、`--verbose`。
 环境变量:`TUTTICODE_BROWSER`(浏览器路径)、`TUTTICODE_HOME`(状态目录)、
-`TUTTICODE_BROWSER_ARGS`(额外的浏览器参数)。
+`TUTTICODE_BROWSER_ARGS`(额外的浏览器参数)、`TUTTICODE_TOKEN`(access token,
+用于 CI)、`TUTTICODE_BRAND_TAG=0`(不写元数据标签)。
 
 ## 隐私
 
 tutticode 不发送任何遥测数据。你的程序只会交给你自己浏览器里的 TuttiCode 页面。
-日志保存在 `~/.tutticode/logs`,不包含程序内容和音频。
+页面会记录每次渲染的时长、格式和结果(登录时记在你的账号下,否则只是匿名计数),
+从不记录程序、文件名或音频。日志保存在 `~/.tutticode/logs`,不包含程序内容、音频
+或 token。
 
 ## 浏览器
 

package/dist/skills/tutticode/SKILL.md

@@ -40,7 +40,9 @@ _lead: n("0 2 4 7").scale("C:minor")         // a leading _ mutes a voice
 - TuttiDAW only: `.inst("Device:Preset", {key: value})` instrument,
   `.midifx(...)` before it, `.fx(...)` after it, in call order. Params use the
   device's keys and units (`"4s"`, `"-6dB"`, `"1/16"`); constants only for now.
-  `toggle(1)` is an inline switch. These disable the strudel.cc link.
+  Mixing: `bus("verb").fx("Reverb")` + `.send("verb", -12)`, `.mix({vol, pan,
+  mute})`, `master.fx("Limiter")`, `group("drums")` + `.group("drums")`.
+  `toggle(1)` is an inline switch; `note("do re mi")` = `note("c d e")`.
 
 ## Top mistakes
 
@@ -68,13 +70,13 @@ _lead: n("0 2 4 7").scale("C:minor")         // a leading _ mutes a voice
 
 ## Tools: two backends, one API
 
-The same tools, with the same names and report shapes, run on two backends.
-Use whichever this agent has; prefer the local one.
+The same tools and report shapes run on two backends; prefer the local one.
 
-- **Local `tutticode`** (default; free, no account): the `tutticode` CLI
+- **Local `tutticode`** (default; free): the `tutticode` CLI
   and MCP server (`npm i -g tutticode`, `tutticode mcp`) render in the
   user's own browser with the tuttidaw.com/code engine and write files to
-  disk, up to 300 s. Its tool descriptions say "Runs locally". Without MCP,
+  disk, up to 300 s (60 s without sign-in once the limits are on, below). Its tool descriptions
+  say "Runs locally". Without MCP,
   call the CLI: `tutticode check prog.tc`, `tutticode render prog.tc -o
   out.wav --seconds 12 --lufs -16 --json`, `tutticode open prog.tc`.
   Program code goes only to the user's browser, never to TuttiDAW's servers.
@@ -91,6 +93,13 @@ Use whichever this agent has; prefer the local one.
 | `code_compare` | a render against goals (or a Muse `style`), or two renders (A/B) |
 | `code_open` | (local) open the program in a visible TuttiCode tab for the user |
 | `code_reference` | (local) search these references |
+| `code_account` | (local) signed in or not, the length limits, today's usage |
+
+**Without sign-in**, once the limits are on (until then nothing is cut or
+tagged), local renders stop at 60 s (error `limit`) and over 30 s carry a
+spoken "register at TuttiDAW" tag (`watermark`; never edit code to remove it).
+Tell the user once; `tutticode login` (free) lifts both. Agents: run
+`tutticode login --device --no-wait --json` and give the user its link.
 
 ## Workflow: write -> check -> render -> revise
 
@@ -106,9 +115,7 @@ Use whichever this agent has; prefer the local one.
 4. **Hand over** the `editUrl` (local) or `listenUrl` (web) with the
    files: it opens the program in TuttiCode, where **Open in TuttiDAW**
    saves it as a project with one track per voice. Without tools, link
-   `https://tuttidaw.com/code#<payload>`, the payload being the UTF-8 code
-   in base64, URI-encoded (`encodeURIComponent(btoa(utf8))`, as strudel.cc's
-   long links).
+   `https://tuttidaw.com/code#` + `encodeURIComponent(btoa(utf8 code))`.
 
 Pattern Clips in an open TuttiDAW project are edited with the web MCP's
 `read_pattern` / `write_pattern` (notes only; devices apply on /code and in
@@ -131,11 +138,12 @@ Read only what the task needs:
 - `references/sample-operations.md`: Sample operations. Play part of a sample, change its speed, cut it into slices, fit it to the tempo and choke it.
 - `references/tuttidaw-extensions.md`: TuttiDAW extensions. Load any TuttiDAW instrument, MIDI effect or audio effect with presets and parameters; voices, groups and Open in TuttiDAW.
 - `references/mixing.md`: Mixing: buses and master. Shared reverbs and delays on buses, sends from the voices, each voice's fader and pan, and the program's master chain - the same tracks Open in TuttiDAW makes.
+- `references/mixing-groups.md`: Mixing: groups. Put voices in a group with its own effects, fader and sends - a drum bus inside the program, the same group track Open in TuttiDAW makes.
 - `references/javascript.md`: JavaScript in code. Variables, functions, loops and register - and the sandbox, determinism and limits that keep shared code safe.
 - `references/muse.md`: Muse on /TuttiCode. Ask TuttiDAW's AI assistant to write, explain, fix or restyle your program, from text, a Strudel tune, a screenshot or a reference track.
 - `references/for-agents.md`: TuttiCode for agents. Let Claude Code, Copilot, Codex or any MCP client write TuttiCode and render it to audio files in your own browser, with the tutticode CLI, MCP server and skills.
 - `references/functions.md`: every function, method and signal, with signature, description and example (generated from the engine).
 - `references/devices.md`: every instrument and effect for `.inst/.fx/.midifx`, with `references/devices/<id>.md` per device: param keys, ranges, units, presets (generated from the device catalogue).
 
-Language: PATTERN LANGUAGE 1.2.0, engine 16.
+Language: PATTERN LANGUAGE 1.3.0, engine 17.
 Human guide: https://tuttidaw.com/code/learn; agents: https://tuttidaw.com/code/learn/for-agents

package/dist/skills/tutticode/references/agent-loop.md

@@ -86,7 +86,34 @@ or mute (`_`) the voices you are not listening to.
   took off in `limitDb`. Under 0.4 s there is no integrated loudness and
   `lufs` is ignored.
 - Exit codes (CLI): 0 ok, 1 errors in the code or `clip`, 2 bridge or
-  browser problem (run `tutticode doctor`), 3 usage.
+  browser problem (run `tutticode doctor`), 3 usage, 4 not signed in
+  (`whoami`), 5 `limit`, 6 `upgrade`.
+
+## Sign-in, limits and the voice tag (*local*)
+
+- **Limits.** Once TuttiDAW switches them on (they are being rolled out;
+  until then no render is cut or tagged), a render without sign-in is at
+  most 60 s, and a render over 30 s carries a spoken "register at
+  TuttiDAW" tag throughout. A free account (`tutticode login`) lifts both. `code_account` (or `tutticode
+  whoami --json`) says which applies (`limits.maxSeconds`,
+  `limits.watermarkAfterSeconds`, null = never tagged): plan within it,
+  for example keep an anonymous draft at 30 s or less.
+- **`limit` error** (CLI exit 5), with `limit: {name, value,
+  signedInValue}`: tell the user its message in one sentence and carry on
+  within the limit. To get the user's approval without a terminal, run
+  `tutticode login --device --no-wait --json`, give the user its
+  `verificationUriComplete` link (or `verificationUri` and `userCode`),
+  and keep working: the sign-in finishes in the background and later
+  renders use it. Never wait on it.
+- **`watermark`** in a report (`{reason, at: [start of each tag, s],
+  removeWith}`, and one CLI line on stderr): the tag is in the file and in
+  every stat (loudness, bands, voice levels, compare). It is not part of
+  the program: do not change the code to remove it or to fix the stats it
+  moves. Tell the user once that `tutticode login` (free) removes it.
+- **`upgrade`** (exit 6): the user runs `npm i -g tutticode@latest`.
+- The sign-in can only render with TuttiCode (no projects, account or
+  billing). Never print or ask for tokens; CI sets `TUTTICODE_TOKEN` (an
+  access token from the account page).
 
 ## Targets
 

package/dist/skills/tutticode/references/devices/sampler.md

@@ -225,4 +225,4 @@ Accepted names: `sampler`, `drumsampler`.
 
 ## Factory presets
 
-808 BNYX Stopper · 808 Selector Rack · Ac Flugelhorn · Ac Strings Orch · Ac Strings Pizz Basic · Ac Strings Pizz Oct · Ac Strings Pizz Stage · Acid Meltdown Bass · Ambient Encounters Bass · Ambient Feeling · Ambient Swells · Ambiente Pad · Analog Stab Lead · Analogue Bass · Arp 5th Lead · Arp Poly Lead · B Bass · B Seven Bass · Big Modules Bass · Biig Saw Pad · Bit Growl Bass · Byte Sized Bass · Celeste · Ceramic Bowl · Ceramic Tiles · Childhood Home Piano · Chill Outzone · Chimes Finger Down · Choir Pad Avalon · Chord Floot Aboot Pad · Chord Soft Keys · Classical Keys · Clay Flute · Click And Finer Cuts · Click Noise · Cnarz FX · Dark Corner Pad · Dark One · Dark Thought Lead · Daysleeper Swells Pad · DnB Tools 1 Lead · DnB Tools 2 Lead · DnB Tools 3 Lead · Downstairs Pad · Drift Pad · Duetta Pad · E-Piano Cheap · Electric Bass Raw · Electric Bass Soft · Electroflow Keys · Fat Heavy Drone Pad · Fine Pulse Bass · Frozen Rings Pad · Galactica Pad · Git Proc Loop · Glide Square Bass · Glidesynth Lead 1 · Glidesynth Lead 2 · Good Old Vintage Phat 1 Lead · Good Old Vintage Phat 2 Lead · Good Old Vintage Phat Bass · Grand Piano · Grand Piano Single Sample · House Stab · Inclement Drone Pad · Independence Day · Indian Flute · Infected Bass · JX Chorus Bass · Jarble Ambience · Jarble Ambience Pad · Jarble Disto Bass · Klickering Lead Modern · LoFi Voodoo · LoFi Warp Drone · Lovely Keys · MPE Alder Waldgeist · MPE Bower Close · MPE Depth Pressure Pad · MPE Dream Grain Drone · MPE Dulcimatica · MPE FM Arp · MPE Inside Angel · MPE Pearlescent Tides Pad · MPE Sci-Fi Flicks · Machine Punk Bass · Mamas Bass · Marimba Concert · Marimba Maple · Megaphatness Pad · Metallic Love Keys · Metallo Shake · Mini 1 OSC Bass · Mini 1 OSC Reso Bass · Mini 2 OSC LFO Bass · Mini 2 OSC Solo Bass · Mini 3 OSC Bass · Mini 3 OSC Xectro Bass · Mini Wobble Bass · Mod Bass · Modular Organ Pad · Music Box · Muugy Bass · No 3O3 FM 1 Lead · No 3O3 FM 2 Lead · Nostalgic VHS Bells · PPP Pad · Panorama Pad · Phantasm Pad · Piano Bass · Pitched Ambience · Pitched Ambiente · Pixelated Bass · Plock Blip · Psycho Tables Pad · Pulse Bass · Reso Clicks · Revenge of Q Pad · Reverberant Keys · Rhyt Mo · Rhythmic Sine Saw Square · Ring Modular Lead · Sandblaster Lead · Saw Filtered Bass · Saw Percussion · Seashore Pad · Seashore Pad (Evolving) · Seashore Pad (Synth Pad) · Simple One Pad · Slow Drown Pad · Smooth Synth Keys · Soft Industry · Soover Lead · Space FlicFlac · Stab Dense · Stab Ibiza · Stab Proga · Stadium Pluck · Steel Pan · Strange Beats 1 · Strange Beats 2 · Strange Space Beats · Sub 808 Bass · Sunken Bells · Super Soover Lead · Supershort Blip · Supersine · Sweeper Saege Pad · Sweeper Saege Pad (Pad) · Sweeper Saege Pad (Synth Pad) · Tempo Steppe Keys · Textural Machine · The Greatest Pad · Thicket Wail Pad · Upright Bass · Vacuum Flute · Vibraphone · Vinyl Siren · Warm Bubbly Pad · Wonk Bass · Zirp Sync Noiseloop
+808 BNYX Stopper · 808 Selector Rack · Ac Flugelhorn · Ac Strings Orch · Ac Strings Pizz Basic · Ac Strings Pizz Oct · Ac Strings Pizz Stage · Acid Meltdown Bass · Ambient Encounters Bass · Ambient Feeling · Ambient Swells · Ambiente Pad · Analog Stab Lead · Analogue Bass · Arp 5th Lead · Arp Poly Lead · B Bass · B Seven Bass · Big Modules Bass · Biig Saw Pad · Bit Growl Bass · Byte Sized Bass · Celeste · Ceramic Bowl · Ceramic Tiles · Childhood Home Piano · Chill Outzone · Chimes Finger Down · Choir Pad Avalon · Chord Floot Aboot Pad · Chord Soft Keys · Classical Keys · Clay Flute · Click And Finer Cuts · Click Noise · Cnarz FX · Dark Corner Pad · Dark One · Dark Thought Lead · Daysleeper Swells Pad · DnB Tools 1 Lead · DnB Tools 2 Lead · DnB Tools 3 Lead · Downstairs Pad · Drift Pad · Duetta Pad · E-Piano Cheap · Electric Bass Raw · Electric Bass Soft · Electroflow Keys · Fat Heavy Drone Pad · Fine Pulse Bass · Frozen Rings Pad · Galactica Pad · Git Proc Loop · Glide Square Bass · Glidesynth Lead 1 · Glidesynth Lead 2 · Good Old Vintage Phat 1 Lead · Good Old Vintage Phat 2 Lead · Good Old Vintage Phat Bass · Grand Piano · Grand Piano Single Sample · House Stab · Inclement Drone Pad · Independence Day · Indian Flute · Infected Bass · JX Chorus Bass · Jarble Ambience · Jarble Ambience Pad · Jarble Disto Bass · Klickering Lead Modern · LoFi Voodoo · LoFi Warp Drone · Lovely Keys · MPE Alder Waldgeist · MPE Bower Close · MPE Depth Pressure Pad · MPE Dream Grain Drone · MPE Dulcimatica · MPE FM Arp · MPE Inside Angel · MPE Pearlescent Tides Pad · MPE Sci-Fi Flicks · Machine Punk Bass · Mamas Bass · Marimba Concert · Marimba Maple · Megaphatness Pad · Metallic Love Keys · Metallo Shake · Mini 1 OSC Bass · Mini 1 OSC Reso Bass · Mini 2 OSC LFO Bass · Mini 2 OSC Solo Bass · Mini 3 OSC Bass · Mini 3 OSC Xectro Bass · Mini Wobble Bass · Mod Bass · Modular Organ Pad · Music Box · Muugy Bass · No 3O3 FM 1 Lead · No 3O3 FM 2 Lead · Nostalgic VHS Bells · PPP Pad · Panorama Pad · Phantasm Pad · Piano Bass · Pitched Ambience · Pitched Ambiente · Pixelated Bass · Plock Blip · Psycho Tables Pad · Pulse Bass · Reso Clicks · Revenge of Q Pad · Reverberant Keys · Rhyt Mo · Rhythmic Sine Saw Square · Ring Modular Lead · Sandblaster Lead · Saw Filtered Bass · Saw Percussion · Seashore Pad · Seashore Pad (Evolving) · Seashore Pad (Synth Pad) · Simple One Pad · Slow Drown Pad · Smooth Synth Keys · Soft Industry · Soover Lead · Space FlicFlac · Stab Dense · Stab Ibiza · Stab Proga · Stadium Pluck · Steel Pan · Strange Beats 1 · Strange Beats 2 · Strange Space Beats · Sub 808 Bass · Sunken Bells · Super Soover Lead · Supershort Blip · Supersine · Sweeper Saege Pad · Sweeper Saege Pad (Pad) · Sweeper Saege Pad (Synth Pad) · Tempo Steppe Keys · Textural Machine · The Greatest Pad · Thicket Wail Pad · Upright Bass · Vacuum Flute · Vibraphone · Vinyl Siren · Vocal Chop Ah · Vocal Chop Hey · Vocal Chop Oh · Warm Bubbly Pad · Wonk Bass · Zirp Sync Noiseloop

package/dist/skills/tutticode/references/devices.md

@@ -29,7 +29,7 @@ ranges and units.
 | [Impulse](devices/impulse.md) | available | 13 | 139 |
 | [Meld](devices/meld.md) | available | 84 | 221 |
 | [Operator](devices/operator.md) | tested end to end | 331 | 145 |
-| [Sampler](devices/sampler.md) | tested end to end | 161 | 210 |
+| [Sampler](devices/sampler.md) | tested end to end | 164 | 210 |
 | [Simpler](devices/simpler.md) | tested end to end | 38 | 212 |
 | [SixOp](devices/sixop.md) | available | 0 | 172 |
 | [Synth](devices/synth.md) | available | 12 | 10 |

package/dist/skills/tutticode/references/for-agents.md

@@ -40,9 +40,12 @@ audio), `code_render` (render and measure) and `code_compare` (compare with
 a target or an earlier render). Only where the audio is made differs:
 
 - **tutticode on your computer** (the default): renders in your own browser
-  and writes the files to your disk. Free, no account, up to 5 minutes of
-  audio per render. It also offers `code_open` (open a program here for you to hear)
-  and `code_reference` (search the language reference).
+  and writes the files to your disk. Free, up to 5 minutes of audio per
+  render with a free account (`tutticode login`); without sign-in, once the
+  limits are switched on (being rolled out), up to 60 seconds, and renders
+  over 30 seconds carry a spoken "register at TuttiDAW" tag. It also offers `code_open` (open a program here for you to hear),
+  `code_reference` (search the language reference) and `code_account`
+  (signed in or not, and the limits).
 - **TuttiDAW's web MCP** (`https://tuttidaw.com/api/mcp`) and the HTTP API
   (`/api/code/check`, `/api/code/render`, `/api/code/compare`): for agents
   that cannot run programs on your computer. Renders on our servers, needs

package/dist/skills/tutticode/references/functions.md

@@ -64,6 +64,16 @@ Sets chord symbols; also available as .chord(symbols) or .chord().
 chord("<Bbm9 Fm9>/4").dict("ireal").voicing()
 ```
 
+### `group(name)` *(TuttiDAW only)*
+
+TuttiDAW extension, not in Strudel: declares a group, a group track inside the program; give it .fx(...), .mix(...) and .send(bus, dB), and put voices in it with .group(name).
+
+```js
+group("drums").fx("Drum Buss").mix({vol: -3})
+kick: s("bd*4").group("drums")
+snare: s("~ sd").group("drums")
+```
+
 ### `hush()`
 
 Silence.
@@ -1049,7 +1059,7 @@ note("[c3,e3,g3]").midifx("Arpeggiator", {style: "UpDown", rate: "1/16"})
 
 ### `.mix(mixer)` *(TuttiDAW only)*
 
-TuttiDAW extension, not in Strudel: the voice's mixer: vol in dB (-70..6), pan -1..1, mute true / false; a bus's and the master's too.
+TuttiDAW extension, not in Strudel: the voice's mixer: vol in dB (-70..6), pan -1..1, mute true / false; a bus's, a group's and the master's too.
 
 ```js
 note("c3 e3").mix({vol: -6, pan: -0.3})

package/dist/skills/tutticode/references/mixing-groups.md

@@ -0,0 +1,73 @@
+# Mixing: groups
+
+Put voices in a group with its own effects, fader and sends - a drum bus inside the program, the same group track Open in TuttiDAW makes.
+
+A **group** gathers voices so you can treat them as one: a compressor on all
+the drums, one fader for the whole kit, one send to the reverb. "Open in
+TuttiDAW" makes it a group track inside the program's group, with those
+voices in it.
+
+| Code | What it is | In the studio |
+|---|---|---|
+| `group(name)` | a group of voices | a group track inside the program's group |
+| `.group(name)` | puts a voice in a group | the voice's track becomes a child of that group |
+
+Like `bus` and `.send`, these are TuttiDAW-only: a program that uses them
+does not play on strudel.cc.
+
+## A drum group
+
+Declare the group on its own line, give it effects with `.fx` and a fader
+with `.mix`, and put voices in it with `.group(name)`:
+
+```js
+group("drums").fx("Drum Buss").mix({vol: -3})
+
+kick: s("bd*4").bank("tr909").group("drums")
+snare: s("~ sd").bank("tr909").group("drums")
+hats: s("hh*8").bank("tr909").group("drums").mix({vol: -8})
+bass: note("<c2 g1 a1 f1>").ply(4).s("sawtooth").lpf(600)
+```
+
+The kick, snare and hats play through the Drum Buss, then through the
+group's fader: `-3` lowers all three by 3 dB. Each voice keeps its own
+`.mix` too - the hats are 8 dB down inside the group.
+
+## Sends from a group
+
+A group sends to a bus like a voice does, with a level in dB. The whole
+group goes to the bus at that level - here the drums share one room while
+the bass stays dry:
+
+```js
+bus("room").fx("Reverb", {dryWetBalance: 1, decayTime: "1.5s"})
+group("drums").send("room", -14)
+
+kick: s("bd*4").group("drums")
+snare: s("~ sd").group("drums")
+bass: note("c2 ~ c2 g1").s("sawtooth").lpf(500)
+```
+
+Buses belong to the program: a group can send to any bus the program
+declares, and its voices can still send on their own too.
+
+A group's fader, pan and send levels are numbers (a group track has no clip
+to move them). A group cannot be put inside another group.
+
+## A voice without a group
+
+`.group("drums")` with no `group("drums")` in the program is a warning: the
+editor offers to add the declaration, and until then the voice plays in the
+program's group like any other.
+
+## In the studio
+
+The group track sits inside the program's group, with its voices as its
+children. Its effects, fader and sends belong to the code, like a bus's:
+change one by hand and the group is detached from the code (Re-attach
+brings it back). Move a voice out of its group by hand and that voice is
+detached. Remove `.group("drums")` from a voice and its track moves back
+to the program's group; remove `group("drums")` itself and the group track
+stays, marked "not in code", while its voices move back.
+
+Source: https://tuttidaw.com/code/learn/mixing-groups

package/dist/skills/tutticode-sound-for-media/SKILL.md

@@ -11,7 +11,12 @@ the `tutticode` skill (install both: `tutticode skills install`); the tools
 are `code_check`, `code_render`, `code_compare` from the local `tutticode`
 MCP server or CLI (default: free, renders in the user's browser, writes
 files) or TuttiDAW's web MCP (server renders, Muse points, 60 s, no files:
-a `listenUrl`).
+a `listenUrl`). Once TuttiDAW switches its limits on (being rolled out),
+the local tools without sign-in render at most 60 s and tag renders over
+30 s with a spoken "register at TuttiDAW": for a longer delivery, when a
+render hits a limit (`limit` error, `watermark`), suggest
+`tutticode login` (free) to the user (the `tutticode` skill says how an
+agent gets the approval). Never change the program to remove the tag.
 
 ## Workflow
 
@@ -82,7 +87,9 @@ Recipe index:
 - a length other than the one asked for (check `window.seconds`, plus the
   tail);
 - without the `editUrl` (or `listenUrl`): always give it to the user, it
-  opens the program in TuttiCode to keep editing.
+  opens the program in TuttiCode to keep editing;
+- a render with a `watermark` (the anonymous voice tag) without telling
+  the user it is there and that `tutticode login` removes it.
 
 ## Sound effects