tutticode 0.2.0 → 0.2.2

package/README.md

@@ -12,8 +12,7 @@ tuttidaw.com/code, so a file sounds exactly like the editor. Nothing is
 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,
+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
@@ -107,9 +106,8 @@ The reference documents are also MCP resources (`tutticode://skills/...`).
 
 ## 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.
+TuttiDAW enforces the limits below. A CLI older than 0.2.1 is refused with
+error `upgrade` (exit 6): update it with `npm i -g tutticode`.
 
 | | Without sign-in | Free account |
 | --- | --- | --- |

package/README.zh-CN.md

@@ -10,7 +10,7 @@ MCP server,适用于 Claude Code、Copilot CLI、Codex、Cursor、Claude Desktop
 文件和编辑器里听到的一模一样。不经过服务器渲染,也不收费。每个结果都带一个
 `editUrl`,可以在 TuttiDAW 里打开这段程序继续编辑。
 
-TuttiDAW 启用限制后(正在逐步上线;在此之前渲染既不截断也不加标签),不登录时每次渲染最长 60 秒,超过 30 秒的渲染会混入一段语音标签
+不登录时每次渲染最长 60 秒,超过 30 秒的渲染会混入一段语音标签
 "register at TuttiDAW"。用免费账号登录(`tutticode login`)就没有这些限制:
 每次最长 5 分钟,没有语音标签。见[登录与限制](#登录与限制)。
 
@@ -93,8 +93,8 @@ TuttiCode" 元数据;仅登录后有效。
 
 ## 登录与限制
 
-下面的限制在 TuttiDAW 启用后生效(正在逐步上线;在此之前每次渲染都完整、不加标签)。
-登录现在就能用。
+TuttiDAW 已经启用下面的限制。低于 0.2.1 的 CLI 会被拒绝,报错 `upgrade`(退出码 6):
+用 `npm i -g tutticode` 升级。
 
 | | 不登录 | 免费账号 |
 | --- | --- | --- |

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,12 @@ _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): 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 (60 s without sign-in once the limits are on, below). Its tool descriptions
+  disk, up to 300 s (60 s without sign-in, 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`.
@@ -94,13 +95,10 @@ Use whichever this agent has; prefer the local one.
 | `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`).
+**Without sign-in**, 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
 
@@ -116,9 +114,7 @@ never edit code to remove it). When a render hits one, tell the user once;
 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
@@ -141,11 +137,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

@@ -91,10 +91,8 @@ or mute (`_`) the voices you are not listening to.
 
 ## 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
+- **Limits.** 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.

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

@@ -41,8 +41,8 @@ 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, 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
+  render with a free account (`tutticode login`); without sign-in, 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).

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,8 +11,8 @@ 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`). Once TuttiDAW switches its limits on (being rolled out),
-the local tools without sign-in render at most 60 s and tag renders over
+a `listenUrl`). Without sign-in,
+the local tools 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

package/dist/tutticode.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/* tutticode v0.2.0 | https://tuttidaw.com */
+/* tutticode v0.2.2 | https://tuttidaw.com */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -4598,13 +4598,14 @@ function tutticodeTermsUrl(origin) {
 }
 var TUTTICODE_LOGIN_HINT_COMMAND = "tutticode login --device --no-wait";
 var DEFAULT_TUTTICODE_LIMITS = {
-  enforce: false,
+  enforce: true,
   anonMaxSeconds: 60,
   anonWatermarkAfterSeconds: 30,
   watermarkGapSeconds: 3,
   signedInMaxSeconds: 300,
   signedInDailyRenders: 1e3,
-  minCliVersion: "0.2.0"
+  // 0.2.0's sign-in is broken on Windows
+  minCliVersion: "0.2.1"
 };
 var VERSION = /^(\d{1,6})\.(\d{1,6})\.(\d{1,6})(?:-[0-9A-Za-z.-]{1,32})?$/;
 function isCliVersion(v) {
@@ -4902,7 +4903,7 @@ var import_node_path2 = require("node:path");
 var import_node_fs = require("node:fs");
 var import_node_os = require("node:os");
 var import_node_path = require("node:path");
-var VERSION2 = true ? "0.2.0" : readPackageVersion();
+var VERSION2 = true ? "0.2.2" : readPackageVersion();
 function envBrowserArgs() {
   const args = process.env.TUTTICODE_BROWSER_ARGS?.split(" ").filter(Boolean);
   return args?.length ? args : void 0;
@@ -4999,7 +5000,7 @@ function saveAccount(origin, account) {
 var PrivateDirError = class extends Error {
 };
 var privateDirs = /* @__PURE__ */ new Map();
-var fileId = (st) => `${st.dev}:${st.ino}`;
+var fileId = (st, platform = process.platform) => platform === "win32" ? `${st.ino}` : `${st.dev}:${st.ino}`;
 function refusal(dir, why) {
   return new PrivateDirError(
     `${dir} ${why}, so tutticode will not keep a sign-in there. Point TUTTICODE_HOME at a folder you own that only you can use (or unset it for ~/.tutticode).`
@@ -6223,9 +6224,8 @@ Usage:
   tutticode setup                     optional browser policy + skills
   tutticode skills install            install the agent skills
 
-Once TuttiDAW switches its limits on (being rolled out), renders without
-sign-in are limited to 60 s, and renders over 30 s carry a spoken "register
-at TuttiDAW" tag. TUTTICODE_TOKEN (an access token from the
+Renders without sign-in are limited to 60 s, and renders over 30 s carry a
+spoken "register at TuttiDAW" tag. TUTTICODE_TOKEN (an access token from the
 account page) signs in CI.
 
 Exit codes: 0 ok, 1 errors in the code, 2 bridge/browser problem, 3 usage,
@@ -8957,7 +8957,7 @@ var CODE_OPEN_TOOL = "code_open";
 var CODE_REFERENCE_TOOL = "code_reference";
 var CODE_ACCOUNT_TOOL = "code_account";
 var BACKEND_NOTE = "Runs locally: tutticode renders in your own browser with the tuttidaw.com/code engine (free).";
-var LIMITS_NOTE = `Once TuttiDAW switches its limits on (being rolled out; until then nothing is cut or tagged), renders without sign-in are limited to ${DEFAULT_TUTTICODE_LIMITS.anonMaxSeconds} s (error code "limit") and renders over ${DEFAULT_TUTTICODE_LIMITS.anonWatermarkAfterSeconds} s carry a spoken "register at TuttiDAW" tag, reported as \`watermark\`: it is not part of the program and is in the stats; never change the code to remove it, tell the user once that \`tutticode login\` (free) removes it.`;
+var LIMITS_NOTE = `Renders without sign-in are limited to ${DEFAULT_TUTTICODE_LIMITS.anonMaxSeconds} s (error code "limit") and renders over ${DEFAULT_TUTTICODE_LIMITS.anonWatermarkAfterSeconds} s carry a spoken "register at TuttiDAW" tag, reported as \`watermark\`: it is not part of the program and is in the stats; never change the code to remove it, tell the user once that \`tutticode login\` (free) removes it.`;
 var codeProperty2 = codeCheckTool.inputSchema.properties.code;
 var renderProperties2 = {
   code: codeProperty2,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tutticode",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": false,
   "description": "Turn TuttiCode (tuttidaw.com/code pattern code) into audio files from any agent: a CLI and an MCP server that render in your own browser with the TuttiDAW engine.",
   "license": "MIT",