tutticode 0.2.0 → 0.2.1

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,8 +70,7 @@ _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
@@ -94,13 +95,11 @@ 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**, 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
 
@@ -116,9 +115,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 +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/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/tutticode.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/* tutticode v0.2.0 | https://tuttidaw.com */
+/* tutticode v0.2.1 | https://tuttidaw.com */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -4902,7 +4902,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.1" : readPackageVersion();
 function envBrowserArgs() {
   const args = process.env.TUTTICODE_BROWSER_ARGS?.split(" ").filter(Boolean);
   return args?.length ? args : void 0;
@@ -4999,7 +4999,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).`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tutticode",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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",