tutticode 0.1.0 → 0.2.0

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
 
@@ -52,7 +59,7 @@ anywhere else (for example a project's `.claude/skills`).
 tutticode check song.tc                     # diagnostics, no audio
 tutticode render song.tc -o bed.wav --seconds 12 --fade-out 1.5 --lufs -16 --json
 tutticode render song.tc -o loop.flac --loops 4 --stems stems/
-tutticode open song.tc                      # open it in TuttiCode for a human
+tutticode open song.tc                      # open it in TuttiCode for a human (--headless: prints the link)
 cat song.tc | tutticode check -             # read the program from stdin
 ```
 
@@ -60,16 +67,25 @@ cat song.tc | tutticode check -             # read the program from stdin
 `--format wav|flac|mp3` (default from the `-o` extension),
 `--sample-rate 44100|48000`, `--bit-depth 16|24`, `--stems <dir>`,
 `--fade-in s`, `--fade-out s`, `--tail s`, `--lufs N`, `--true-peak N`,
-`--json`, `--timeout s`. `--lufs` applies one static gain; when the true-peak
-ceiling cannot be met the render fails with `clip` instead of being limited.
+`--limit`, `--json`, `--timeout s`. No file is written clipped: a render
+whose true peak would pass the ceiling (`--true-peak`, default -1 dBTP) is
+lowered by one static gain, and the CLI says so ("Lowered 4.6 dB to avoid
+clipping"). `--lufs` applies one static gain; when the true-peak ceiling
+cannot be met the render fails with `clip`, unless you add `--limit`: a
+true-peak limiter on the mix (not the stems), reported as `limitDb`.
 
 `--json` prints the render report: length, bars, tempo, loudness and true
 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
 
@@ -83,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
 
@@ -125,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
@@ -141,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 分钟,没有语音标签。见[登录与限制](#登录与限制)。
 
 ## 安装
 
@@ -45,23 +49,30 @@ Claude Code、Copilot CLI 和 Codex 分别从 `~/.claude/skills`、`~/.copilot/s
 tutticode check song.tc                     # 只检查,不出声音
 tutticode render song.tc -o bed.wav --seconds 12 --fade-out 1.5 --lufs -16 --json
 tutticode render song.tc -o loop.flac --loops 4 --stems stems/
-tutticode open song.tc                      # 在 TuttiCode 里打开给人看
+tutticode open song.tc                      # 在 TuttiCode 里打开给人看(--headless:只打印链接)
 cat song.tc | tutticode check -             # 从 stdin 读程序
 ```
 
 `render` 参数: `--seconds|--bars|--loops N`、`--bpm N`、
 `--format wav|flac|mp3`(默认按 `-o` 的扩展名)、`--sample-rate 44100|48000`、
 `--bit-depth 16|24`、`--stems <目录>`、`--fade-in 秒`、`--fade-out 秒`、
-`--tail 秒`、`--lufs N`、`--true-peak N`、`--json`、`--timeout 秒`。
+`--tail 秒`、`--lufs N`、`--true-peak N`、`--limit`、`--json`、`--timeout 秒`。
+不会写出削波的文件:true peak 超过上限(`--true-peak`,默认 -1 dBTP)的渲染会
+整体降低一次静态增益,CLI 会说明("Lowered 4.6 dB to avoid clipping")。
 `--lufs` 只做一次静态增益;如果达不到 true peak 上限,会以 `clip` 失败,而不是
-偷偷加限制器。
+偷偷加限制器;需要时加 `--limit`:对混音(不含分轨)加 true peak 限制器,
+报告里的 `limitDb` 是它最多压下的量。
 
 `--json` 输出渲染报告:时长、小节数、速度、响度和 true peak、施加的增益、每个
 声部的电平、小节和拍的时间点(秒,用来对齐剪辑点)、检查报告、分析结果、
 `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 工具
 
@@ -74,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,页面用它统计匿名安装数,和你本人无关。
 
 ## 工作原理
 
@@ -107,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),
@@ -121,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

@@ -71,10 +71,11 @@ _lead: n("0 2 4 7").scale("C:minor")         // a leading _ mutes a voice
 The same tools, with the same names and report shapes, run on two backends.
 Use whichever this agent has; 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 +92,15 @@ 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 TuttiDAW switches its limits on (they are being
+rolled out; until then no local render is cut or tagged), local renders
+stop at 60 s (error `limit`) and over 30 s carry a spoken "register at
+TuttiDAW" tag (`watermark`; it is in every stat, not in your program:
+never edit code to remove it). When a render hits one, tell the user once;
+`tutticode login` (free) lifts both. Agents: run `tutticode login
+--device --no-wait --json`, give the user its link (`references/agent-loop.md`).
 
 ## Workflow: write -> check -> render -> revise
 
@@ -125,6 +135,7 @@ Read only what the task needs:
 - `references/mini-notation.md`: Mini-notation. The rhythm language inside the quotes - sequences, rests, groups, alternation, polymeter, Euclidean rhythms and chance.
 - `references/time-and-structure.md`: Time and structure. Functions that speed up, shift, reverse, repeat and combine patterns, and arrange them into sections.
 - `references/harmony-and-scales.md`: Harmony and scales. Note names and octaves, scale degrees, transposition, chord symbols, voicings and arpeggios.
+- `references/melodies-with-do-re-mi.md`: Melodies with do re mi. Write notes in solfège (do re mi fa sol la si) wherever a note name goes; strudel.cc gets letters.
 - `references/sounds.md`: Sounds. Drum kits and banks, synth waveforms, General MIDI instrument names, Ensemble sounds and your own samples.
 - `references/effect-controls.md`: Effect controls. Filters, reverb, delay, distortion, panning, envelopes and synth controls - and moving them with signals.
 - `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.
@@ -136,5 +147,5 @@ Read only what the task needs:
 - `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 15.
+Language: PATTERN LANGUAGE 1.2.0, engine 16.
 Human guide: https://tuttidaw.com/code/learn; agents: https://tuttidaw.com/code/learn/for-agents

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

@@ -40,8 +40,9 @@ differences are marked *local* or *web*.
 
 *local* returns `files` (`audio`, `stems`: paths written on disk),
 `editUrl`, `window` (`bars`, `seconds`, `bpm`), `loudness` (`lufs`,
-`truePeak` of the delivered file, `gainDb` applied for a `lufs` target),
-`voices[]` (each voice's solo `lufs` and `truePeak`), `barTimes` /
+`truePeak` of the delivered file, `gainDb` applied for a `lufs` target or
+to avoid clipping, `limitDb` with `limit`), `warnings` (what was done to
+the audio), `voices[]` (each voice's solo `lufs` and `truePeak`), `barTimes` /
 `beatTimes` (seconds of each bar and beat: sync video cuts to them),
 `check` and `analysis`. *web* returns `analysis`, a `listenUrl` (24 h) and
 signed audio links.
@@ -71,13 +72,48 @@ or mute (`_`) the voices you are not listening to.
   (whole loops ring out past their end). `tail` adds seconds after the
   length for reverbs and delays and makes the file exactly length + tail;
   `fadeIn` / `fadeOut` are linear, in seconds.
+- No file is written clipped: without `lufs`, a render whose true peak
+  would pass `truePeak` (default -1 dBTP) is lowered by one static gain
+  (negative `gainDb`, a line in `warnings`); a stem that would clip on
+  its own is lowered further (its `gainDb` in `voices[]`). *web* lowers
+  the audio file the same way and says so in `warnings`; its `analysis`
+  measures the program before that gain.
 - `lufs` applies one static gain to that integrated loudness, the same on
-  the stems. When the true peak would pass `truePeak` (default -1 dBTP)
-  the render fails with code `clip` instead of limiting: ask for a lower
-  `lufs`, or make the program less peaky (lower its loudest voice). Under
-  0.4 s there is no integrated loudness and `lufs` is ignored.
+  the stems. When the true peak would pass `truePeak` the render fails
+  with code `clip`: ask for a lower `lufs`, make the program less peaky
+  (lower its loudest voice), or add `limit: true` (`--limit`), a
+  true-peak limiter on the mix (not the stems) that reports the most it
+  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

@@ -99,7 +99,7 @@ n("0 2 4").scale("C:minor")
 
 ### `note(notes)`
 
-Plays pitches: note names (c4, eb3) or MIDI numbers (60).
+Plays pitches: note names (c4, eb3), solfège (do re mi, sol4, sib) or MIDI numbers (60).
 
 ```js
 note("c3 e3 g3 b3")

package/dist/skills/tutticode/references/melodies-with-do-re-mi.md

@@ -0,0 +1,59 @@
+# Melodies with do re mi
+
+Write notes in solfège (do re mi fa sol la si) wherever a note name goes; strudel.cc gets letters.
+
+## Solfège is a note name
+
+Wherever a note name goes, you can write its solfège name instead:
+`do re mi fa sol la si`. TuttiCode uses fixed do: `do` is always C, `re` is D,
+`sol` is G, whatever the key. `so` and `ti` work too (the same as `sol` and
+`si`).
+
+```js
+note("do re mi fa sol la si do4")
+```
+
+Only the name differs: `note("do re mi")` plays exactly what `note("c d e")`
+plays.
+
+## Sharps, flats and octaves
+
+Add sharps, flats and octaves as you would to a letter: `do#4`, `mib` (E flat),
+`sib3` (B flat), `fa#`. A name without an octave is in octave 3, like `c`.
+Capitals work too: `Do`, `SOL`.
+
+```js
+note("<do4 mib4 sol4 sib4> [fa#3 la3]").s("piano")
+```
+
+## Scales and chords
+
+Scale roots take solfège: `.scale("re:minor")`. Stack names with commas to
+play a chord.
+
+```js
+n("0 2 4 <7 6>").scale("<re:dorian sol:mixolydian>")
+```
+
+```js
+note("<[do3,mi3,sol3] [la2,do3,mi3] [fa2,la2,do3] [sol2,si2,re3]>").s("piano")
+```
+
+Chord symbols (`chord("C^7")`, `.voicings()`) keep their letters: there `do`
+already means D diminished (`D` and `o`).
+
+## Where a word is not a note
+
+In `s()` and `sound()` words are sound names, so `s("do")` looks for a sound
+called "do". `n()` is also a sample or soundfont index, so `n("do")` is a
+word too: write `note("do")`. Solfège means a pitch only in `note()` /
+`.note()`, `.scale()` roots, `.mode()` and `.anchor()`, and `.add()` /
+`.sub()` / `.transpose()` on notes.
+
+## Opening in strudel.cc
+
+strudel.cc reads letter names only. "Open in strudel.cc" rewrites solfège to
+letters for you (`"do re mi"` becomes `"c d e"`), so the program plays the same
+there.
+
+Source: https://tuttidaw.com/code/learn/melodies-with-do-re-mi

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
 
@@ -52,19 +57,26 @@ Recipe index:
 | Broadcast (EBU R128) | -23 |
 | Short sound effects | -18..-26: peaky, see each recipe |
 
-- True peak ceiling -1 dBTP (the default). `lufs` is one static gain, never
-  a limiter: a peaky program fails with `clip`. Then lower the target, or
-  lower the loudest voice's `.gain` and render again. Where loudness
-  matters (music beds at -14..-17), end the program with
-  `master.fx("Limiter", {gainDb: 3, ceiling: -3})`: the program's own bus
-  catches the peaks before the gain, as the music recipes do.
+- True peak ceiling -1 dBTP (the default, `truePeak`). No file is written
+  clipped: without `lufs`, a render that would pass the ceiling is lowered
+  by one static gain (a negative `gainDb` and a line in `warnings`). `lufs`
+  is one static gain: a peaky program (most drum programs at -14..-16)
+  fails with `clip`. Then lower the target, lower the loudest voice's
+  `.gain` and render again, end the program with
+  `master.fx("Limiter", {gainDb: 3, ceiling: -3})` (the program's own bus
+  catches the peaks before the gain, as the music recipes do), or add
+  `limit: true` (`--limit`): the render's true-peak limiter holds the
+  ceiling and reports the most it took off (`limitDb`). More than about
+  6 dB of it flattens the drums: then lower the target instead.
 - Exact durations: `seconds` cuts exactly. A one-shot effect is one bar
   long: `setcpm` sets the bar (`setcpm(60)` = 1 s, `setcpm(15)` = 4 s).
 - Video beds: `fadeIn` 1-3 s, `fadeOut` 2-5 s, `tail` for the reverb.
 - Loops for apps and games: `loops` N with `tail: 0`, no fades, so the file
   is exactly N loops and repeats in time; keep the last step short.
-- Stems: `stems: true` writes one file per voice (named by the labels); a
-  `lufs` gain applies to the stems too, so they still sum to the mix.
+- Stems: `stems: true` writes one file per voice (named by the labels); the
+  mix's static gain applies to the stems too, so they still sum to the mix.
+  A stem that would clip on its own is lowered further (its `gainDb` in
+  `voices`, a line in `warnings`); the limiter never touches stems.
 
 ## Quality bar: never deliver
 
@@ -75,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