release(core+gemini): prepare v0.16.0

- Added richer Gemini tool events to the shared type definitions and docs.
- Updated the repo and core READMEs with the canonical multi-provider example.
- Bumped @headless-coder-sdk/core and @headless-coder-sdk/gemini-adapter to 0.16.0 (core now depends on the new Gemini version) and refreshed the changelog plus pnpm lockfile.

Author: OhadAssulin

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.16.0] - 2025-11-10
+### ✨ Gemini Tool Mapping
+- Gemini adapter now emits richer `tool_use`/`tool_result` frames (name/callId/args/output/exitCode/error) so downstream ACP clients and SDK consumers can rely on structured metadata without inspecting `originalItem`.
+
+### 📚 Documentation
+- Updated the repo and core README multi-provider sections to use the canonical `registerAdapter` + `createCoder` flow, keeping the examples accurate for all environments.
+
+### 📦 Packaging
+- Bumped `@headless-coder-sdk/core` and `@headless-coder-sdk/gemini-adapter` to `0.16.0`; the core package now lists the Gemini adapter as a direct dependency, ensuring the richer tool events are always available.
+
 ## [0.15.0] - 2025-11-10
 ### 🗂 Documentation & Helpers
 - Core package now ships the monorepo README directly (`packages/core/README.md`) so npm consumers see the same getting-started guides without visiting GitHub.

README.md

@@ -144,13 +144,30 @@ console.log(followUp.text);
 ## 🔄 Multi-Provider Workflow
 
 ```ts
-import { createHeadlessCodex } from '@headless-coder-sdk/codex-adapter';
-import { createHeadlessClaude } from '@headless-coder-sdk/claude-adapter';
-import { createHeadlessGemini } from '@headless-coder-sdk/gemini-adapter';
+import {
+  registerAdapter,
+  createCoder,
+} from '@headless-coder-sdk/core/factory';
+import {
+  CODER_NAME as CODEX_CODER,
+  createAdapter as createCodexAdapter,
+} from '@headless-coder-sdk/codex-adapter';
+import {
+  CODER_NAME as CLAUDE_CODER,
+  createAdapter as createClaudeAdapter,
+} from '@headless-coder-sdk/claude-adapter';
+import {
+  CODER_NAME as GEMINI_CODER,
+  createAdapter as createGeminiAdapter,
+} from '@headless-coder-sdk/gemini-adapter';
+
+registerAdapter(CODEX_CODER, createCodexAdapter);
+registerAdapter(CLAUDE_CODER, createClaudeAdapter);
+registerAdapter(GEMINI_CODER, createGeminiAdapter);
 
-const codex = createHeadlessCodex();
-const claude = createHeadlessClaude();
-const gemini = createHeadlessGemini({ workingDirectory: process.cwd() });
+const codex = createCoder(CODEX_CODER);
+const claude = createCoder(CLAUDE_CODER);
+const gemini = createCoder(GEMINI_CODER, { workingDirectory: process.cwd() });
 
 // 1) Claude + Codex perform code review concurrently and emit structured findings.
 const reviewSchema = {

packages/core/README.md

@@ -144,13 +144,30 @@ console.log(followUp.text);
 ## 🔄 Multi-Provider Workflow
 
 ```ts
-import { createHeadlessCodex } from '@headless-coder-sdk/codex-adapter';
-import { createHeadlessClaude } from '@headless-coder-sdk/claude-adapter';
-import { createHeadlessGemini } from '@headless-coder-sdk/gemini-adapter';
+import {
+  registerAdapter,
+  createCoder,
+} from '@headless-coder-sdk/core/factory';
+import {
+  CODER_NAME as CODEX_CODER,
+  createAdapter as createCodexAdapter,
+} from '@headless-coder-sdk/codex-adapter';
+import {
+  CODER_NAME as CLAUDE_CODER,
+  createAdapter as createClaudeAdapter,
+} from '@headless-coder-sdk/claude-adapter';
+import {
+  CODER_NAME as GEMINI_CODER,
+  createAdapter as createGeminiAdapter,
+} from '@headless-coder-sdk/gemini-adapter';
+
+registerAdapter(CODEX_CODER, createCodexAdapter);
+registerAdapter(CLAUDE_CODER, createClaudeAdapter);
+registerAdapter(GEMINI_CODER, createGeminiAdapter);
 
-const codex = createHeadlessCodex();
-const claude = createHeadlessClaude();
-const gemini = createHeadlessGemini({ workingDirectory: process.cwd() });
+const codex = createCoder(CODEX_CODER);
+const claude = createCoder(CLAUDE_CODER);
+const gemini = createCoder(GEMINI_CODER, { workingDirectory: process.cwd() });
 
 // 1) Claude + Codex perform code review concurrently and emit structured findings.
 const reviewSchema = {

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@headless-coder-sdk/core",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Unified SDK for headless AI coders (Codex, Claude, Gemini) with standardized threading, streaming, and sandboxing.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -30,6 +30,9 @@
   "scripts": {
     "build": "tsup --config tsup.config.ts"
   },
+  "dependencies": {
+    "@headless-coder-sdk/gemini-adapter": "workspace:^0.16.0"
+  },
   "devDependencies": {
     "typescript": "^5.4.0"
   },

packages/core/src/types.ts

@@ -98,6 +98,7 @@ export type CoderStreamEvent =
       callId?: string;
       result?: any;
       exitCode?: number | null;
+      error?: unknown;
       ts: number;
       originalItem?: any;
     }

packages/gemini-adapter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@headless-coder-sdk/gemini-adapter",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -18,7 +18,7 @@
     "build": "tsup --config tsup.config.ts"
   },
   "peerDependencies": {
-    "@headless-coder-sdk/core": "^0.15.0"
+    "@headless-coder-sdk/core": "^0.16.0"
   },
   "devDependencies": {
     "typescript": "^5.4.0",