tandem-mode 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zdravko Lukic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,191 @@
+# Tandem Mode
+
+**English** | [Srpski](./README.sr.md)
+
+A terminal coding agent built specifically for the DeepSeek API — not a generic
+LLM harness with DeepSeek bolted on. Interactive REPL, planner/worker/reviewer
+orchestration, cache-aware prompt architecture, and Windows-first from the
+start.
+
+> **Independent open-source project. Not affiliated with or endorsed by
+> DeepSeek.**
+
+## Status
+
+Early stage (M0–M3 of the [development plan](./deepseek-cli-development-plan.md)
+are done, M4 in progress). Usable today for real coding tasks against a local
+repo.
+
+First benchmark run is in — see [full results](./docs/benchmark-results.md).
+Headline: all three configurations (Pro-only, Flash-only, orchestration)
+fixed 4/4 injected bugs correctly in a real WooCommerce plugin, with a clean
+`php -l` and zero unnecessary file changes. But for this class of task
+(single-file, well-scoped fixes), orchestration cost ~9.5× more and took
+~19× longer than Pro-only for the same correctness — the opposite of what
+you'd want orchestration for. Read as: orchestration's overhead needs a
+bigger, more decomposable task to pay for itself, which this first run didn't
+test. Reported as-is, not adjusted to fit expectations.
+
+## Features
+
+- **Agentic loop** — `deepseek-v4-pro`/`deepseek-v4-flash` with tool calling:
+  `read_file`, `list_dir`, `search`, `edit`, `git_diff`, `shell`, `view_image`,
+  `web_search`.
+- **Two entry points** — interactive REPL for normal work, single-shot mode
+  (`tandem "task" --yes`) for scripting and CI.
+- **Orchestration** (`/plan`) — a planner produces a JSON task list, workers
+  execute each task with a fresh minimal context, a reviewer checks the git
+  diff against the original task and either approves or requests corrections
+  (capped by `max_review_loops`).
+- **Cache-aware prompts** — the worker's system prompt + repo map + plan stay
+  byte-identical across calls in one orchestration run, so DeepSeek's context
+  cache actually hits. Measured live: cache-hit tokens grew call over call
+  within a single `/plan` run.
+- **Vision** — `view_image` lets the agent look at a screenshot you point it
+  to; `/paste` grabs an image straight from the Windows clipboard.
+- **Web search** — isolated calls to DeepSeek's Responses API when the agent
+  needs something outside the repo (an error message, a library's docs).
+- **Session persistence** — every session is a JSONL file; `/resume` continues
+  the latest (or a named) one, `/fork` branches off without touching the
+  original.
+- **Safety** — destructive actions (file edits, shell commands not on a small
+  read-only allowlist) always ask for confirmation; `y`/`n`/`a` where `a`
+  remembers the choice for that tool for the rest of the session. `--yes`
+  bypasses this for CI but always prints what it auto-approved.
+- **Cost control** — usage is read only from the API's own `usage` field,
+  never estimated. A budget (`/budget`, `--budget`) hard-stops the loop before
+  the next API call if exceeded, without losing the session. `/usage` also
+  shows what the session would have cost off-peak, and the REPL warns you at
+  startup if you're currently in a peak-pricing window.
+- **ESC to interrupt** — cancels the in-flight call (and any running shell
+  command) cleanly, keeping whatever was generated so far.
+- **Windows-first** — the shell tool runs PowerShell natively, file edits
+  preserve the original CRLF/LF line ending style, paths are handled with
+  `path.resolve` throughout.
+
+## Quick start
+
+```bash
+git clone https://github.com/zdrave08/Tandem-Mode.git
+cd Tandem-Mode
+pnpm install
+pnpm dev            # interactive REPL
+pnpm dev "explain what this repo does" --yes   # one-shot
+```
+
+(Not yet published to npm — `npm install -g tandem-mode` is a launch-day step,
+not available today.)
+
+To try it as a real installed `tandem` command instead of `pnpm dev` (useful
+before publishing, or to use it in another project without cloning next to
+it):
+
+```bash
+pnpm build
+npm link          # registers `tandem` globally, pointing at this checkout
+tandem            # now works from any directory
+```
+
+On first run you'll be asked for a DeepSeek API key (get one at
+[platform.deepseek.com](https://platform.deepseek.com)) and a default
+model/reasoning effort. On Windows the key is stored DPAPI-encrypted
+(tied to your OS user account, same protection Credential Manager itself
+relies on) in `%LOCALAPPDATA%\TandemMode\credentials.dat` — never in a
+config file or log. Linux/macOS storage isn't implemented yet (`DEEPSEEK_API_KEY`
+works everywhere in the meantime) — see good-first-issues.
+
+## Usage
+
+```bash
+tandem                              # interactive REPL
+tandem "fix the off-by-one in foo.ts"
+tandem --plan "add dark mode to the settings page"
+tandem "task" --model deepseek-v4-flash --effort low --budget 0.50 --yes
+```
+
+| Flag | Effect |
+|---|---|
+| `--resume` / `-r` | Continue the latest session in this directory |
+| `--yes` / `-y` | Auto-approve destructive actions (prints what it approved) |
+| `--plan` | Run planner/worker/reviewer orchestration instead of a single turn |
+| `--model` | `deepseek-v4-pro` or `deepseek-v4-flash` |
+| `--effort` | `low`, `high`, or `max` reasoning effort |
+| `--budget` | Hard USD cap for the run |
+| `--max-review-loops` | Cap on orchestration correction cycles (default 3) |
+
+### REPL commands
+
+| Command | Effect |
+|---|---|
+| `/plan <task>` | Planner/worker/reviewer orchestration |
+| `/model [name]` | Show or switch model |
+| `/thinking [on\|off]` | Toggle thinking mode |
+| `/effort [low\|high\|max]` | Show or set reasoning effort |
+| `/status` | Current session/settings |
+| `/usage` | Tokens, cost, off-peak projection |
+| `/budget [amount]` | Show or set the session budget |
+| `/new` | Start a fresh session |
+| `/fork` | New session, carrying over the current history |
+| `/resume [id]` | Continue the latest (or a named) session |
+| `/paste [message]` | Send a Windows-clipboard image to the agent |
+| `/clear` | Clear the screen |
+| `/help` | This list |
+| `/exit` | Quit |
+
+Press **ESC** at any time during a turn to interrupt it.
+
+## Architecture
+
+```
+tandem (no args)  ─┬─> interactive REPL ─┬─> single turn: agent loop (tools)
+                    │                     └─> /plan: planner → worker(s) → reviewer
+tandem "task"     ──┘   (single-shot, same agent loop, for scripts/CI)
+```
+
+- `src/deepseek/` — thin client for DeepSeek's OpenAI-compatible API
+  (streaming + non-streaming chat completions, vision, web search via
+  Responses API). See [`docs/api-notes.en.md`](./docs/api-notes.en.md)
+  (Serbian original: [`docs/api-notes.md`](./docs/api-notes.md)) for the
+  API behavior this is built against, verified live rather than assumed.
+- `src/agent/` — the tool-calling loop, tool implementations, session
+  persistence, usage/cost tracking.
+- `src/orchestrator/` — planner/worker/reviewer, repo-map generation, the
+  cache-aware stable-prefix construction.
+- `src/repl/` — slash commands, runtime config, the first-run wizard.
+- `src/cli.tsx` — Ink-based terminal UI and the REPL/single-shot entry points.
+
+## Configuration
+
+Layered: **session** (in-REPL commands) > **project** (`.tandem/config.json`
+in the current directory) > **global** (`~/.tandem/config.json`).
+
+```json
+{
+  "defaultModel": "deepseek-v4-pro",
+  "defaultReasoningEffort": "high",
+  "budgetUsd": 5,
+  "maxReviewLoops": 3
+}
+```
+
+The API key is never stored in these files — it lives DPAPI-encrypted on
+Windows (or `DEEPSEEK_API_KEY` env var, which takes priority, for CI use).
+
+## Development
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm dev "some task"
+```
+
+## Disclaimer
+
+This is an independent, community-run project. It is not affiliated with,
+endorsed by, or sponsored by DeepSeek.
+
+## License
+
+[MIT](./LICENSE)

package/README.sr.md

@@ -0,0 +1,194 @@
+# Tandem Mode
+
+[English](./README.md) | **Srpski**
+
+Terminalski coding agent napravljen posebno za DeepSeek API — ne generički
+LLM harness u koji je DeepSeek naknadno ugurana. Interaktivni REPL,
+planner/worker/reviewer orkestracija, cache-aware arhitektura prompta, i
+Windows kao prioritet od prvog dana.
+
+> **Nezavisan open-source projekat. Nije povezan sa DeepSeek-om niti od
+> njega podržan.**
+
+## Status
+
+Rana faza (M0–M3 iz [plana razvoja](./deepseek-cli-development-plan.md) su
+gotovi, M4 u toku). Upotrebljiv već danas za stvarne coding zadatke nad
+lokalnim repozitorijumom.
+
+Prvi benchmark je gotov — pun izveštaj u
+[docs/benchmark-results.md](./docs/benchmark-results.md) (na engleskom;
+srpska verzija: [docs/benchmark-results.sr.md](./docs/benchmark-results.sr.md)).
+Ukratko: sve tri konfiguracije (Pro-only, Flash-only, orkestracija) su
+ispravno rešile 4/4 ubačena bага u pravom WooCommerce pluginu, sa čistim
+`php -l` i nula nepotrebnih izmena. Ali za ovu klasu zadatka (mali,
+jednodatotečni fixevi) orkestracija je koštala ~9.5× više i trajala ~19×
+duže od Pro-only, za isti kvalitet — suprotno onome zbog čega bi se
+orkestracija tražila. Čitati kao: overhead orkestracije treba veći,
+razdvojiv zadatak da bi se isplatio, a ovaj prvi test to nije proverio.
+Prijavljeno onako kako jeste, ne prilagođeno očekivanjima.
+
+## Šta ima
+
+- **Agentic petlja** — `deepseek-v4-pro`/`deepseek-v4-flash` sa tool-calling:
+  `read_file`, `list_dir`, `search`, `edit`, `git_diff`, `shell`, `view_image`,
+  `web_search`.
+- **Dva načina rada** — interaktivni REPL za svakodnevni rad, single-shot
+  mod (`tandem "task" --yes`) za skriptovanje i CI.
+- **Orkestracija** (`/plan`) — planner pravi JSON listu taskova, workeri
+  izvršavaju svaki task sa svežim minimalnim kontekstom, reviewer proverava
+  git diff naspram originalnog zadatka i ili odobrava ili traži korekcije
+  (ograničeno sa `max_review_loops`).
+- **Cache-aware promptovi** — sistemski prompt workera + repo mapa + plan
+  ostaju bajt-za-bajt identični kroz pozive u jednoj orkestraciji, tako da
+  DeepSeek-ov keš stvarno pogađa. Izmereno uživo: cache-hit tokeni su rasli
+  iz poziva u poziv unutar jednog `/plan` pokretanja.
+- **Vision** — `view_image` omogućava agentu da pogleda screenshot na koji
+  ga uputiš; `/paste` uzima sliku direktno iz Windows clipboard-a.
+- **Web search** — izolovani pozivi ka DeepSeek Responses API-ju kad agentu
+  treba nešto van repozitorijuma (error poruka, dokumentacija biblioteke).
+- **Perzistencija sesije** — svaka sesija je JSONL fajl; `/resume` nastavlja
+  poslednju (ili navedenu), `/fork` grana bez diranja originalne.
+- **Bezbednost** — destruktivne akcije (izmene fajlova, shell komande van
+  male read-only bele liste) uvek traže potvrdu; `y`/`n`/`a` gde `a`
+  pamti izbor za taj alat do kraja sesije. `--yes` preskače ovo za CI, ali
+  uvek ispisuje šta je automatski odobreno.
+- **Kontrola troškova** — usage se čita isključivo iz API-jevog `usage`
+  polja, nikad se ne procenjuje. Budžet (`/budget`, `--budget`) zaustavlja
+  petlju pre sledećeg poziva ako se pređe, bez gubitka sesije. `/usage`
+  takođe pokazuje koliko bi sesija koštala off-peak, a REPL upozorava pri
+  startu ako si trenutno u peak periodu.
+- **ESC za prekid** — čisto prekida poziv u toku (i bilo koju shell komandu
+  koja radi), čuvajući ono što je do tada generisano.
+- **Windows prioritet** — shell alat pokreće PowerShell nativno, izmene
+  fajlova čuvaju originalni CRLF/LF stil, putanje se svuda tretiraju preko
+  `path.resolve`.
+
+## Brzi početak
+
+```bash
+git clone https://github.com/zdrave08/Tandem-Mode.git
+cd Tandem-Mode
+pnpm install
+pnpm dev            # interaktivni REPL
+pnpm dev "objasni sta radi ovaj repo" --yes   # jedan potez
+```
+
+(Još nije objavljeno na npm-u — `npm install -g tandem-mode` je korak za
+dan lansiranja, danas nije dostupan.)
+
+Da probaš kao pravu instaliranu `tandem` komandu umesto `pnpm dev` (korisno
+pre objave, ili da koristiš alat u drugom projektu bez kloniranja pored
+njega):
+
+```bash
+pnpm build
+npm link          # registruje `tandem` globalno, pokazuje na ovaj checkout
+tandem            # sad radi iz bilo kog direktorijuma
+```
+
+Pri prvom pokretanju bićeš pitan za DeepSeek API ključ (napravi ga na
+[platform.deepseek.com](https://platform.deepseek.com)) i podrazumevani
+model/reasoning effort. Na Windows-u se ključ čuva DPAPI-šifrovan (vezan za
+tvoj OS nalog, ista zaštita na kojoj se zasniva i sam Credential Manager) u
+`%LOCALAPPDATA%\TandemMode\credentials.dat` — nikad u config fajlu ili logu.
+Linux/macOS čuvanje još nije implementirano (`DEEPSEEK_API_KEY` radi svuda
+u međuvremenu) — videti good-first-issues.
+
+## Upotreba
+
+```bash
+tandem                              # interaktivni REPL
+tandem "popravi off-by-one u foo.ts"
+tandem --plan "dodaj dark mode na stranicu podešavanja"
+tandem "task" --model deepseek-v4-flash --effort low --budget 0.50 --yes
+```
+
+| Flag | Efekat |
+|---|---|
+| `--resume` / `-r` | Nastavi poslednju sesiju u ovom direktorijumu |
+| `--yes` / `-y` | Automatski odobri destruktivne akcije (ispisuje šta je odobreno) |
+| `--plan` | Pokreni planner/worker/reviewer orkestraciju umesto jednog poteza |
+| `--model` | `deepseek-v4-pro` ili `deepseek-v4-flash` |
+| `--effort` | `low`, `high`, ili `max` reasoning effort |
+| `--budget` | Tvrd USD limit za pokretanje |
+| `--max-review-loops` | Limit korekcionih ciklusa u orkestraciji (podrazumevano 3) |
+
+### REPL komande
+
+| Komanda | Efekat |
+|---|---|
+| `/plan <zadatak>` | Planner/worker/reviewer orkestracija |
+| `/model [ime]` | Prikaži ili promeni model |
+| `/thinking [on\|off]` | Uključi/isključi thinking mode |
+| `/effort [low\|high\|max]` | Prikaži ili postavi reasoning effort |
+| `/status` | Trenutna sesija/podešavanja |
+| `/usage` | Tokeni, cena, off-peak projekcija |
+| `/budget [iznos]` | Prikaži ili postavi budžet sesije |
+| `/new` | Nova sesija |
+| `/fork` | Nova sesija sa kopijom trenutne istorije |
+| `/resume [id]` | Nastavi poslednju (ili navedenu) sesiju |
+| `/paste [poruka]` | Pošalji sliku iz Windows clipboard-a agentu |
+| `/clear` | Očisti ekran |
+| `/help` | Ova lista |
+| `/exit` | Izlaz |
+
+Pritisni **ESC** u bilo kom trenutku tokom poteza da ga prekineš.
+
+## Arhitektura
+
+```
+tandem (bez argumenata) ─┬─> interaktivni REPL ─┬─> jedan potez: agent petlja (alati)
+                          │                      └─> /plan: planner → worker(i) → reviewer
+tandem "task"     ────────┘   (single-shot, ista agent petlja, za skripte/CI)
+```
+
+- `src/deepseek/` — tanak klijent za DeepSeek-ov OpenAI-kompatibilan API
+  (streaming + non-streaming chat completions, vision, web search preko
+  Responses API-ja). Vidi [`docs/api-notes.md`](./docs/api-notes.md) za
+  ponašanje API-ja protiv kog je ovo napravljeno, verifikovano uživo, ne
+  pretpostavljeno.
+- `src/agent/` — tool-calling petlja, implementacije alata, perzistencija
+  sesije, praćenje usage/troška.
+- `src/orchestrator/` — planner/worker/reviewer, generisanje repo mape,
+  cache-aware konstrukcija stabilnog prefiksa.
+- `src/repl/` — slash komande, runtime konfiguracija, first-run wizard.
+- `src/cli.tsx` — Ink terminalski UI i REPL/single-shot ulazne tačke.
+
+## Konfiguracija
+
+Slojevito: **sesija** (komande u REPL-u) > **projekat**
+(`.tandem/config.json` u trenutnom direktorijumu) > **globalno**
+(`~/.tandem/config.json`).
+
+```json
+{
+  "defaultModel": "deepseek-v4-pro",
+  "defaultReasoningEffort": "high",
+  "budgetUsd": 5,
+  "maxReviewLoops": 3
+}
+```
+
+API ključ se nikad ne čuva u ovim fajlovima — živi DPAPI-šifrovan na
+Windows-u (ili u `DEEPSEEK_API_KEY` env promenljivoj, koja ima prioritet,
+za CI upotrebu).
+
+## Razvoj
+
+Vidi [CONTRIBUTING.sr.md](./CONTRIBUTING.sr.md).
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm dev "neki zadatak"
+```
+
+## Disclaimer
+
+Ovo je nezavisan projekat koji vodi zajednica. Nije povezan sa DeepSeek-om,
+niti od njega podržan ili sponzorisan.
+
+## Licenca
+
+[MIT](./LICENSE)

package/dist/agent/clipboard.js

@@ -0,0 +1,26 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/**
+ * Samo Windows za sada — Linux/macOS clipboard pristup ide u good-first-issues
+ * (xclip/pngpaste), u duhu "Windows first-class" principa iz plana.
+ */
+export async function saveClipboardImage(destPath) {
+    if (process.platform !== "win32") {
+        throw new Error("Clipboard paste slike je trenutno podržan samo na Windows-u.");
+    }
+    const escapedPath = destPath.replace(/'/g, "''");
+    const script = `
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+if ([System.Windows.Forms.Clipboard]::ContainsImage()) {
+  $img = [System.Windows.Forms.Clipboard]::GetImage()
+  $img.Save('${escapedPath}', [System.Drawing.Imaging.ImageFormat]::Png)
+  Write-Output "OK"
+} else {
+  Write-Output "NO_IMAGE"
+}`;
+    const { stdout } = await execFileAsync("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script]);
+    return stdout.trim() === "OK";
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/agent/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../src/agent/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG;;;;;eAKF,WAAW;;;;EAIxB,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IAChH,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC;AAChC,CAAC"}

package/dist/agent/loop.js

@@ -0,0 +1,157 @@
+import { streamChatCompletion } from "../deepseek/client.js";
+import { findTool, toolSpecs } from "./tools/index.js";
+import { appendSessionMessage } from "./session.js";
+function isAbortError(err) {
+    return err instanceof Error && err.name === "AbortError";
+}
+/**
+ * `messages` mora već sadržati system + početni user zahtev (i istoriju ako
+ * se nastavlja sesija) — pozivalac je odgovoran da TE poruke upiše u sesiju
+ * pre poziva. Petlja perzistuje samo poruke koje sama generiše (assistant/tool).
+ */
+export async function* runAgentLoop(messages, opts) {
+    const ctx = { cwd: opts.cwd, env: opts.env, usage: opts.usage, ...(opts.signal ? { signal: opts.signal } : {}) };
+    const maxIterations = opts.maxIterations ?? 25;
+    for (let iteration = 0; iteration < maxIterations; iteration++) {
+        if (opts.signal?.aborted) {
+            yield { type: "interrupted" };
+            return;
+        }
+        if (opts.budgetUsd !== undefined) {
+            const spent = opts.usage.estimatedCostUsd();
+            if (spent >= opts.budgetUsd) {
+                yield { type: "budget_exceeded", spentUsd: spent, budgetUsd: opts.budgetUsd };
+                return;
+            }
+        }
+        let reasoning = "";
+        let content = "";
+        const toolCallBuf = new Map();
+        try {
+            for await (const ev of streamChatCompletion(opts.env, {
+                model: opts.model,
+                messages,
+                tools: toolSpecs,
+                ...(opts.thinking !== undefined ? { thinking: opts.thinking } : {}),
+                ...(opts.signal ? { signal: opts.signal } : {}),
+            })) {
+                switch (ev.type) {
+                    case "reasoning_delta":
+                        reasoning += ev.delta;
+                        yield { type: "reasoning_delta", delta: ev.delta };
+                        break;
+                    case "content_delta":
+                        content += ev.delta;
+                        yield { type: "content_delta", delta: ev.delta };
+                        break;
+                    case "tool_call_delta": {
+                        const buf = toolCallBuf.get(ev.index) ?? { args: "" };
+                        if (ev.id)
+                            buf.id = ev.id;
+                        if (ev.name)
+                            buf.name = ev.name;
+                        if (ev.argumentsDelta)
+                            buf.args += ev.argumentsDelta;
+                        toolCallBuf.set(ev.index, buf);
+                        break;
+                    }
+                    case "usage":
+                        opts.usage.add(opts.model, ev.usage);
+                        yield { type: "usage", usage: ev.usage };
+                        break;
+                    case "done":
+                        break;
+                }
+            }
+        }
+        catch (err) {
+            if (!isAbortError(err))
+                throw err;
+            // Prekinuto usred streama — sačuvaj šta god je stiglo do sad kao poruku,
+            // ali bez tool_calls (nepotpuni argumenti se ne mogu pouzdano izvršiti).
+            if (content || reasoning) {
+                const partialMessage = {
+                    role: "assistant",
+                    content: content || null,
+                    ...(reasoning ? { reasoningContent: reasoning } : {}),
+                };
+                messages.push(partialMessage);
+                await appendSessionMessage(opts.session, partialMessage);
+            }
+            yield { type: "interrupted" };
+            return;
+        }
+        const toolCalls = [...toolCallBuf.entries()]
+            .sort(([a], [b]) => a - b)
+            .map(([, v]) => ({
+            id: v.id ?? "",
+            type: "function",
+            function: { name: v.name ?? "", arguments: v.args },
+        }));
+        // `tools` se šalje na SVAKI poziv u ovoj petlji, pa dokumentacija traži
+        // da se reasoning_content svakog prethodnog poteza vrati — ne samo onih
+        // koji su zvali alat (inače dokumentovano 400, videti docs/api-notes.md #2).
+        const assistantMessage = {
+            role: "assistant",
+            content: content || null,
+            ...(reasoning ? { reasoningContent: reasoning } : {}),
+            ...(toolCalls.length > 0 ? { toolCalls } : {}),
+        };
+        messages.push(assistantMessage);
+        await appendSessionMessage(opts.session, assistantMessage);
+        if (toolCalls.length === 0) {
+            yield { type: "final", content };
+            return;
+        }
+        for (const call of toolCalls) {
+            if (opts.signal?.aborted) {
+                yield { type: "interrupted" };
+                return;
+            }
+            let args = {};
+            try {
+                args = JSON.parse(call.function.arguments || "{}");
+            }
+            catch {
+                // Ostaje {} — alat će prijaviti nedostajuće/neispravne argumente.
+            }
+            const tool = findTool(call.function.name);
+            if (!tool) {
+                const toolMsg = {
+                    role: "tool",
+                    toolCallId: call.id,
+                    content: `Nepoznat alat: ${call.function.name}`,
+                };
+                messages.push(toolMsg);
+                await appendSessionMessage(opts.session, toolMsg);
+                continue;
+            }
+            yield { type: "tool_call_start", id: call.id, name: tool.name, args };
+            if (tool.isDestructive(args)) {
+                const approved = await opts.approve(tool.name, args);
+                if (!approved) {
+                    yield { type: "tool_call_denied", id: call.id, name: tool.name };
+                    const toolMsg = {
+                        role: "tool",
+                        toolCallId: call.id,
+                        content: "Korisnik je odbio izvršavanje ovog alata.",
+                    };
+                    messages.push(toolMsg);
+                    await appendSessionMessage(opts.session, toolMsg);
+                    continue;
+                }
+            }
+            const result = await tool.execute(args, ctx);
+            if (opts.signal?.aborted) {
+                yield { type: "interrupted" };
+                return;
+            }
+            yield { type: "tool_call_result", id: call.id, name: tool.name, result };
+            const toolMsg = { role: "tool", toolCallId: call.id, content: result.output };
+            messages.push(toolMsg);
+            await appendSessionMessage(opts.session, toolMsg);
+        }
+    }
+    yield { type: "max_iterations_reached" };
+}
+//# sourceMappingURL=loop.js.map

package/dist/agent/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/agent/loop.ts"],"names":[],"mappings":"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"}

package/dist/agent/pricing.js

@@ -0,0 +1,21 @@
+export const PRICING = {
+    "deepseek-v4-flash": { inputPerMillion: 0.22, outputPerMillion: 0.66, cacheHitInputPerMillion: 0.007 },
+    "deepseek-v4-pro": { inputPerMillion: 0.66, outputPerMillion: 1.98, cacheHitInputPerMillion: 0.022 },
+};
+const PEAK_WINDOWS_UTC = [
+    [1, 4],
+    [6, 10],
+];
+export function isPeakHour(date) {
+    const hour = date.getUTCHours();
+    return PEAK_WINDOWS_UTC.some(([start, end]) => hour >= start && hour < end);
+}
+export function estimateCallCost(model, usage, isPeak) {
+    const p = PRICING[model];
+    const peakMultiplier = isPeak ? 2 : 1;
+    const inputCost = (usage.promptCacheMissTokens / 1_000_000) * p.inputPerMillion * peakMultiplier +
+        (usage.promptCacheHitTokens / 1_000_000) * p.cacheHitInputPerMillion * peakMultiplier;
+    const outputCost = (usage.completionTokens / 1_000_000) * p.outputPerMillion * peakMultiplier;
+    return inputCost + outputCost;
+}
+//# sourceMappingURL=pricing.js.map

package/dist/agent/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/agent/pricing.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,OAAO,GAAkE;IACpF,mBAAmB,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE;IACtG,iBAAiB,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE;CACrG,CAAC;AAEF,MAAM,gBAAgB,GAA4B;IAChD,CAAC,CAAC,EAAE,CAAC,CAAC;IACN,CAAC,CAAC,EAAE,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAA2B,EAC3B,KAAgG,EAChG,MAAe;IAEf,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,SAAS,GACb,CAAC,KAAK,CAAC,qBAAqB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,eAAe,GAAG,cAAc;QAC9E,CAAC,KAAK,CAAC,oBAAoB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,uBAAuB,GAAG,cAAc,CAAC;IACxF,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,gBAAgB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,gBAAgB,GAAG,cAAc,CAAC;IAC9F,OAAO,SAAS,GAAG,UAAU,CAAC;AAChC,CAAC"}