@hraness/dawg 0.6.0 → 0.7.0

package/guides/providers.md

@@ -1,25 +1,31 @@
 ---
 id: providers
 title: Providers and models
-parent: project
-order: 3
+parent: agent
+order: 2
 ---
 
-Commands work offline. Plain requests go to the agent once a provider
-is set: AI Gateway, OpenRouter, or a Codex or Claude subscription.
+Plain requests go to the agent once a provider is set: AI Gateway,
+OpenRouter, or a Codex or Claude subscription.
 
-## Shell
+## Ask
 
-- `dawg login` finds existing setups and lets you pick
-- `dawg login gateway` · `openrouter` · `codex` · `claude`
-- `dawg model` pick a model with the cost per prompt
-- `dawg auth status --check` · `dawg logout`
+- "which model are you?" (after `model key`)
 
-## In the app
+## Type it yourself
 
-- `/login` · `/model` picker · `/model <alias>` · `/logout`
-- `/auth --check` provider and audio status
+- `dawg model key` finds setups · `dawg model key gateway`
+- `model key` · `model` picker · `model fast` · `logout`
+- `/auth --check` · `DAWG_MODEL=<alias>` · `DAWG_AI=0` no agent
 
-## Environment
+## Menu
 
-- `DAWG_PROVIDER=gateway` · `DAWG_MODEL=<alias>` · `DAWG_AI=0` no agent
+- Ctrl-K › Project › agent › model · model key
+
+## Keys
+
+- In the model picker ↑↓ move · Enter choose · `/` filter
+
+## Next
+
+- `guide agent` · `guide web-search`

package/guides/resample.md

@@ -0,0 +1,32 @@
+---
+id: resample
+title: Resample, grains and shift
+parent: sound
+order: 3
+---
+
+Turn a part into a sample, grain it, and play the grains like an
+instrument.
+
+## Ask
+
+- "resample the lead and make a grain cloud of bars 1-2"
+
+## Type it yourself
+
+- `resample lead` · `resample drums bars 1-2 grain`
+- `shift 7` · `shift 7 formant keep` · `fade out 0.5`
+- `grain sync 1/16` · `grain quant scale` · `grain mono on`
+- `automate grain-pos points 0:0.1 8:0.9` sweeps the head
+
+## Menu
+
+- Ctrl-K › Project › resample · Ctrl-K › Sound › granular
+
+## Keys
+
+- In the granular rows ←→ adjust · Enter opens a fader
+
+## Next
+
+- `guide media` · `guide automation`

package/guides/rhythm.md

@@ -1,26 +1,30 @@
 ---
 id: rhythm
 title: Rhythm and drums
-parent: music
-order: 5
+order: 6
 ---
 
+A drum track has one row per drum: kick, snare, hat and more.
+
 ## Ask
 
 - "give me a house beat" · "add a swung hat, seven hits in sixteen"
 
 ## Type it yourself
 
-- `/pattern house` a starting groove · `/pattern` picker (previews)
-- `/kit syn909` a drum kit · `/kit` picker
-- `hit kick at 0` · `hit snare at 1 vel 0.7`
-- `pattern kick 0 1 2 3` · `pattern hat every 0.5 from 0.25`
-- `euclid hat 7 16 rotate 2` hits spread over steps
-- `euclid hat swing 0.15` · `euclid hat off` · `euclid hat freeze`
-- `grid snare ....X.......x...` explicit steps, X accents
-- `clear hat` remove one voice
+- `pattern house` a groove · `kit syn909` a kit
+- `hit kick at 0` · `pattern kick 0 1 2 3` · `pattern hat every 0.5`
+- `euclid hat 7 16 rotate 2` · `euclid hat swing 0.15`
+- `grid snare ....X.......x...` steps, X accents · `clear hat`
+
+## Menu
+
+- Ctrl-K › Rhythm › euclid editor · grooves · kits · grid
+
+## Keys
+
+- In the euclid editor ↑↓ drum · ←→ adjust · Tab field · Space loop
 
-## Editor
+## Next
 
-- `/euclid` (Ctrl-K › Rhythm): ↑↓ voice, ←→ adjust, Tab field,
-  Space loop, `x` off, Esc back
+- `guide tempo` · `guide mix`

package/guides/sessions.md

@@ -8,14 +8,24 @@ order: 2
 Open `dawg` in more than one terminal on the same folder: each window
 focuses a different track and every edit syncs to all of them.
 
+## Ask
+
+- "name this session night drive"
+
 ## Type it yourself
 
-- `/sessions` list · `/resume` picker · `/resume 2` or a name
-- `/rename night drive` · `/rename --auto` back to auto-naming
-- `/fork` copy the session to try an idea · `/status`
-- `/track bass` focus another track in this window
+- `sessions` · `/resume` picker · `/resume 2` or a name
+- `/rename night drive` · `/rename --auto` · `/fork` · `status`
+- `dawg --new` · `dawg --session <name>` · `dawg --track bass`
+
+## Menu
+
+- Ctrl-K › Project › session › rename · fork · resume
+
+## Keys
+
+- In the picker ↑↓ move · Enter resumes · `/` filter · Esc back
 
-## Shell
+## Next
 
-- `dawg --new` new session · `dawg --session <name>` open one
-- `dawg --track bass` start focused on a track · `dawg sessions`
+- `guide files` · `guide agent`

package/guides/show-me.md

@@ -0,0 +1,31 @@
+---
+id: show-me
+title: Learn by watching the agent
+parent: agent
+order: 1
+---
+
+The agent types dawg commands into your prompt bar as it writes them;
+each runs as its line ends. Captions name the key or fader.
+
+## Ask
+
+- "make the reverb wetter and play a C minor arpeggio"
+- At the end: `do it yourself: type …` and the Ctrl-K path
+
+## Type it yourself
+
+- `showme on` (default) · `showme quiet` no captions or sounds
+- `showme off` the agent edits without typing commands
+
+## Menu
+
+- Ctrl-K › Project › agent › show-me
+
+## Keys
+
+- Ctrl-O lists the lines as `agent › …` · Esc stops the agent
+
+## Next
+
+- `guide agent` · `guide audition`

package/guides/sound.md

@@ -1,15 +1,31 @@
 ---
 id: sound
-title: Shaping sound
+title: Sound
 order: 3
 ---
 
-Every track has an instrument, a fixed effects chain, automation lanes
-and a place in the mix. Try changes on a loop before you keep them.
+Every track plays one instrument. Sound shapes the focused track: its
+instrument, preset, parameters and how notes are played.
 
-- Sounds and presets
-- Effects
-- Automation
-- Mix
-- Menu and audition loop
-- Samples and media tools
+## Ask
+
+- "make the lead a bright pluck" · "a felt piano, softer"
+
+## Type it yourself
+
+- `instrument piano` · `synth preset pluck` · `synth lpf 800`
+- `piano felt` · `bowed cello` · `wind flute` · `grain cloud`
+- `try synth lpf 400` hear it on a loop first
+
+## Menu
+
+- Ctrl-K › Sound › instrument · preset · synth filter · instruments
+
+## Keys
+
+- In a value row ←→ adjust · Enter opens its fader · `x` reset
+
+## Next
+
+- `guide sounds` · `guide performance` · `guide resample`
+- `guide media`

package/guides/sounds.md

@@ -1,6 +1,6 @@
 ---
 id: sounds
-title: Sounds and presets
+title: Instruments and presets
 parent: sound
 order: 1
 ---
@@ -13,17 +13,20 @@ order: 1
 ## Type it yourself
 
 - `instrument sawtooth` · sine square triangle supersaw pulse
-- `synth preset pluck` · pad lead bass acid keys bell organ strings
-- `synth lpf 800 lpenv 3` any parameter · `synth adsr 0.01 0.2 0.5 0.3`
-- `synth lpf off` · `synth reset` · `synth` lists what is set
-- `piano felt` · grand ballad upright lofi · `keys hardness 0.3` · `keys`
-- `wt list` tables · `wt pwm` load one · `wt 0.5` position
-- `string sitar` · nylon koto harp … · `string buzz 0.8` · `string presets`
-- `/pack list` · `/pack use <pack>/<sound> as kick` · `/pack info vcsl`
-- `/sample samples/kick.wav as kick` add a sampler voice
-- `/bpm 174` the sample's tempo (a bare `bpm 174` is the song's) · `fitmode beats` (drums) or `tones` (pads) · `len 8`
+- `synth preset pad` · `synth lpf 800 lpenv 3` · `synth reset`
+- `piano felt` · `epiano suitcase` · `wurli` · `keys hardness 0.3`
+- `tonewheel gospel` · `combo vox` · `pipe flutes` · `rotary fast`
+- `wt list` · `string sitar` · `bowed violin` · `pack list`
 
 ## Menu
 
-- Ctrl-K › Sound: instrument, preset, envelope, filter, browse sounds
-- Ctrl-K › Sound › browse sounds › Strings: the plucked string presets
+- Ctrl-K › Sound › instruments › Strings › Bowed
+- Ctrl-K › Sound › instruments › Wavetable · sample packs
+
+## Keys
+
+- Enter on a preset auditions it · Esc reverts
+
+## Next
+
+- `guide sound` · `guide effects`

package/guides/styles.md

@@ -0,0 +1,31 @@
+---
+id: styles
+title: Styles
+parent: arrange
+order: 4
+---
+
+A style is a song recipe: meter, groove, scale, harmony and form. The
+same style, bars and seed always make the same song.
+
+## Ask
+
+- "make 16 bars of deep house" · "bebop, blended with bossa nova"
+
+## Type it yourself
+
+- `style deep-house 16` · `style bebop 8 3` (bars, then seed)
+- `style again` next seed · `style blend bebop bossa-nova 0.3`
+- `style search maqam` · `style list jazz` · `style info bebop`
+
+## Menu
+
+- Ctrl-K › Arrange › style: find, blend, families
+
+## Keys
+
+- `/` filters the style tree · Enter makes it · Ctrl-Z undoes
+
+## Next
+
+- `guide arrange` · `guide chords`

package/guides/tempo.md

@@ -1,8 +1,8 @@
 ---
 id: tempo
 title: Tempo and meter
-parent: music
-order: 6
+parent: arrange
+order: 3
 ---
 
 One tempo map drives playback, the click, recording and MIDI export.
@@ -10,18 +10,23 @@ Positions are beats from 0 or `bar <n>`.
 
 ## Ask
 
-- "slow down to 80 over the last four bars"
-- "switch to 7/8 at bar 5" · "hold the final chord"
+- "slow down to 80 over the last four bars" · "switch to 7/8 at bar 5"
 
 ## Type it yourself
 
-- `tempo 90 at bar 9` step · add `ramp` or `exp` to glide into it
+- `tempo 90 at bar 9` · add `ramp` or `exp` to glide into it
 - `rit 4 bars to 80` · `accel 8 bars to 174 at bar 9`
-- `fermata at 31 2` hold beat 31 for 2 extra beats
-- `meter 7/8 at bar 5` · `tempo map` show it · `tempo clear`
-- `track rate 3/2` · `track cycle 3` · `track phasing 3` · `track time off`
-- `/bpm 174` on a sampler voice follows the map · `fitmode beats|tones` keeps pitch
+- `fermata at 31 2` · `meter 7/8 at bar 5` · `tempo map`
+- `track rate 3/2` · `track phasing 3` · `/bpm 174` a sample's tempo
 
 ## Menu
 
-- Ctrl-K › Project › Tempo & meter (`/menu tempo`)
+- Ctrl-K › Project › tempo · tempo and meter
+
+## Keys
+
+- Click ▶ BPM in the header to play
+
+## Next
+
+- `guide styles` · `guide rhythm`

package/guides/tracks.md

@@ -1,8 +1,8 @@
 ---
 id: tracks
 title: Tracks and instruments
-parent: music
-order: 1
+parent: arrange
+order: 2
 ---
 
 ## Ask
@@ -12,14 +12,19 @@ order: 1
 
 ## Type it yourself
 
-- `/track drums` focus a track, creating it (drums get the kit)
-- `/tracks` list every track
-- `track name lead` rename the focused track
-- `instrument piano` · `instrument supersaw` · `instrument kit`
-- `meter 3` beats per bar · `key A minor` · `key none`
-- `clear` remove the focused track's notes
+- `track drums` focus a track, creating it (drums get the kit)
+- `tracks` list them · `track name lead` rename the focused track
+- `track rm pad` remove one · `track move pad 1` reorder
+- `instrument piano` · `instrument kit` · `clear` its notes
 
 ## Menu
 
-- Ctrl-K › Sound › instrument
-- Ctrl-K › Mix › all tracks (choosing one focuses it)
+- Ctrl-K › Arrange › tracks · Ctrl-K › Mix › all tracks
+
+## Keys
+
+- Click the track name in the header to list tracks
+
+## Next
+
+- `guide sound` · `guide sessions`

package/guides/tuning.md

@@ -0,0 +1,32 @@
+---
+id: tuning
+title: Tuning
+parent: chords
+order: 1
+---
+
+Tuning sets how pitches are tuned: equal steps, ratios, cents or a Scala
+file. The key still names the tonic and scale.
+
+## Ask
+
+- "tune the song to 19-EDO" · "use a just intonation in D"
+
+## Type it yourself
+
+- `tuning 19-edo` · `tuning pelog` · `tuning edo 31` · `tuning list`
+- `tuning ratios 1/1 9/8 5/4 4/3 3/2` · `tuning ref 432`
+- `tuning scl <file>` · `tuning root D` · `tuning off`
+- `cents <id> -14` nudges one note
+
+## Menu
+
+- Ctrl-K › Chords and key › tuning · Ctrl-K › Sound › track tuning
+
+## Keys
+
+- In play mode, `play degrees` puts scale steps on the keys
+
+## Next
+
+- `guide chords` · `help chords`

package/guides/voice.md

@@ -0,0 +1,31 @@
+---
+id: voice
+title: Voice
+order: 4
+---
+
+Voice is sung or spoken audio: a built-in singer, imported clips and
+the tools that tune them.
+
+## Ask
+
+- "sing the melody as a soft choir on ooh"
+- "autotune the vocal, gentle"
+
+## Type it yourself
+
+- `sing choir` · `sing vowels a e i o` · `lyrics sun-lit morn-ing`
+- `vocal import take.wav` · `clip fade in .01` · `vocal pitch`
+- `autotune gentle` · `formant -4` · `vowel a o 0.5` · `vocoder talkbox`
+
+## Menu
+
+- Ctrl-K › Voice › sing · lyrics · clips · pitch · autotune · vocoder
+
+## Keys
+
+- In a value row ←→ adjust · Enter opens its fader · Esc back
+
+## Next
+
+- `help voice` every voice command · `guide media` stems

package/guides/web-search.md

@@ -1,21 +1,31 @@
 ---
 id: web-search
 title: Web search
-parent: project
-order: 4
+parent: agent
+order: 3
 ---
 
 The agent can search the web and read public pages, for example to look
-up a song's tempo or a chord chart. Fetches never reach private hosts.
+up a song's tempo. Fetches never reach private hosts.
 
 ## Ask
 
-- "look up the tempo and key of Teardrop by Massive Attack"
+- "look up the tempo and key of a song you name"
 - "read this page and copy its chord chart: <url>"
 
-## Where results come from (first match wins)
+## Type it yourself
 
 - `DAWG_WEB_SEARCH=duckduckgo|openrouter|gateway|brave` pins one
-- `BRAVE_SEARCH_API_KEY` set: Brave Search
-- an AI Gateway key (Exa by default), then an OpenRouter key
-- otherwise DuckDuckGo, with no key
+- otherwise Brave with a key, AI Gateway, OpenRouter, then DuckDuckGo
+
+## Menu
+
+- Ctrl-K › Project › agent › model
+
+## Keys
+
+- Ctrl-O shows each search and fetch in the transcript
+
+## Next
+
+- `guide agent` · `guide providers`

package/native/prebuilt/manifest.json

@@ -0,0 +1,21 @@
+{
+  "abi": 1,
+  "libraries": {
+    "darwin-arm64": {
+      "file": "darwin-arm64/libdawg_sink.dylib",
+      "sha256": "0bc32f2049a8e3f229dd249527063c853b937dda16fed4f3cec4c43ff20c8a00"
+    },
+    "darwin-x64": {
+      "file": "darwin-x64/libdawg_sink.dylib",
+      "sha256": "b9ed2993f0eb1a21c13432c497e71a6a01ca2de3c0e5d2bf7d9551fcac8c6501"
+    },
+    "linux-x64": {
+      "file": "linux-x64/libdawg_sink.so",
+      "sha256": "fddfa31ff82e99e5e967b82c21a8650cc584e9519149ce2b0bc0af02b76528c4"
+    },
+    "linux-arm64": {
+      "file": "linux-arm64/libdawg_sink.so",
+      "sha256": "72cbe8b86ac9bc1d0bc387dc337c31034e29df00c66277c584ecf8586d036e39"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hraness/dawg",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -23,13 +23,16 @@
     "guides/*.md",
     "guides/index.ts",
     "CHANGELOG.md",
-    "DAWG.md"
+    "DAWG.md",
+    "native/prebuilt/manifest.json",
+    "native/prebuilt/*/libdawg_sink.*"
   ],
   "bin": {
     "dawg": "./src/main.ts"
   },
   "scripts": {
     "dawg": "bun run src/main.ts",
+    "bench:perf": "bun bench/perf/run.ts",
     "test": "bun test",
     "typecheck": "tsc --noEmit",
     "check": "bun test && bun run typecheck && bun run format",