genaicode 2.7.0 → 2.8.0

package/dist/ui/web-client.js.LEGAL.txt

@@ -0,0 +1,56 @@
+Bundled license information:
+
+react/cjs/react.production.js:
+  /**
+   * @license React
+   * react.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
+
+scheduler/cjs/scheduler.production.js:
+  /**
+   * @license React
+   * scheduler.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
+
+react-dom/cjs/react-dom.production.js:
+  /**
+   * @license React
+   * react-dom.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
+
+react-dom/cjs/react-dom-client.production.js:
+  /**
+   * @license React
+   * react-dom-client.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */
+
+react/cjs/react-jsx-runtime.production.js:
+  /**
+   * @license React
+   * react-jsx-runtime.production.js
+   *
+   * Copyright (c) Meta Platforms, Inc. and affiliates.
+   *
+   * This source code is licensed under the MIT license found in the
+   * LICENSE file in the root directory of this source tree.
+   */

package/docs/agents.md

@@ -74,6 +74,46 @@ failure of its own. A zero exit alone is not treated as success.
 
 Vendor events that have no mapping are dropped.
 
+## Follow-up turns
+
+`result.sessionId` names the agent's own session. Pass it as `resume` to continue that
+session with a new prompt; the agent keeps the earlier turns as context:
+
+```ts
+const agent = claude();
+const first = await agent.run({ prompt: 'Add a --dry-run flag', cwd }).result;
+const next = await agent.run({ prompt: 'Now cover it with a test', cwd, resume: first.sessionId }).result;
+```
+
+`claude`, `codex`, `cursor`, `opencode` and `copilot` support it (`capabilities.resume`).
+Other drivers fail the task before spawning anything rather than starting a fresh session.
+
+## Chat sessions
+
+`createAgentSession` keeps a conversation with one agent for chat front ends; the
+`genaicode chat` and `genaicode ui` commands are built on it:
+
+```ts
+import { claude, createAgentSession } from 'genaicode/agents';
+
+const session = createAgentSession({ agent: claude(), cwd: '/work/repo' });
+session.subscribe((state) => render(state)); // a new immutable snapshot on every change
+session.send('Add a --dry-run flag');
+await session.idle();
+session.send('Now cover it with a test'); // resumes the same agent session
+```
+
+- `state.turns[]` holds each prompt with its transcript: `text` (streamed, then final),
+  `tool` (input, clipped output, error flag), `files`, `approval`, `input` (steered text)
+  and `error` entries, plus the turn's `AgentResult`. Usage and cost add up in `state`.
+- `send()` while a turn runs steers the agent when it supports `steer()`, and otherwise
+  queues the prompt; queued prompts run in order. `stop()` aborts the turn and clears the
+  queue.
+- Approval requests wait in `state.approvals` until `approve(id, decision)`, unless
+  `autoApprove` decides them. `stop()` denies whatever is pending.
+- `setAgent()` switches agents between turns and starts a fresh agent session; `reset()`
+  does the same for the current agent.
+
 ## Drivers
 
 | Driver                | Command        | Mode                                     | Notes                                                                                  |

package/docs/pivot.md

@@ -44,9 +44,10 @@ The following 1.x capabilities are intentionally removed:
 The 2.x `genaicode/agents` subpath does not restore these. It drives _external_
 coding-agent CLIs behind one task/event interface, the same way providers wrap model APIs,
 and it adds no agent loop, prompts, or repository tools of its own. See [agents.md](./agents.md).
-The `genaicode` bin (`npx genaicode run`) is a thin command-line front end to those drivers,
-under the same rule: it parses flags, prints events, and adds nothing the library does not
-already do.
+The `genaicode` bin (`npx genaicode run`, `chat`, `ui`) is a thin front end to those drivers,
+under the same rule: it parses flags, shows events, and adds nothing the library does not
+already do. Its terminal and browser chat are bundled (Ink, React) into `dist/ui` and load
+only for those commands, so the library keeps no UI dependencies.
 
 This is a major-version break. The old implementation remains available in git history
 and in the 1.x npm line.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genaicode",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "A small, provider-neutral TypeScript toolkit for calling LLMs from backend code.",
   "author": "Grzegorz Tańczyk",
   "repository": {
@@ -49,8 +49,8 @@
   },
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
-    "build": "npm run clean && tsc -p tsconfig.build.json",
-    "lint": "eslint . --ext js,ts --report-unused-disable-directives --max-warnings 0",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node scripts/build-ui.mjs",
+    "lint": "eslint . --ext js,ts,tsx --report-unused-disable-directives --max-warnings 0",
     "test": "vitest --config vitest.unit.config.ts --run",
     "test:e2e": "vitest --config vitest.e2e.config.ts --run",
     "test:watch": "vitest --config vitest.unit.config.ts",
@@ -66,13 +66,20 @@
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
     "@typescript-eslint/eslint-plugin": "^7.17.0",
     "@typescript-eslint/parser": "^7.17.0",
+    "esbuild": "^0.28.2",
     "eslint": "^8.54.0",
     "eslint-config-prettier": "^9.0.0",
     "husky": "^9.1.1",
+    "ink": "^6.8.0",
+    "ink-testing-library": "^4.0.0",
     "lint-staged": "^15.2.7",
     "prettier": "^3.1.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
     "typescript": "^5.0.0",
     "vite": "^6.4.1",
     "vitest": "^3.0.7"