@inixiative/agent-session 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Inixiative
+
+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

@@ -22,7 +22,7 @@ await session.start();
 
 const result = await session.send("Build a CLI that …");
 console.log(result.content);          // final text
-console.log(result.tokens);           // { input, output }
+console.log(result.tokens);           // input/output + reported cache/thinking counters
 for (const e of result.events) {      // full classified event stream
   if (e.kind === "tool_use") console.log("tool:", e.toolName);
 }
@@ -51,6 +51,21 @@ session.kill();
 `fork` / `interrupt` + an event handler). `ClaudeCodeSession` implements it over
 `claude --print --input-format stream-json --output-format stream-json`.
 
+## Usage telemetry
+
+Claude results preserve `cacheRead`, `cacheWrite`, `cacheWrite5m`, `cacheWrite1h`,
+and `thinking` alongside `input`/`output`. Input excludes the disjoint cache
+counters; thinking is already included in output and TTL counts are included in
+cacheWrite. Unreported optional counters remain absent. `providerUsage` retains
+the entire original usage object, including service tier and future tags.
+
+`result` events and `send().tokens` carry the native turn aggregate. Session
+`totalTokens` and artifact totals sum these completed results once. `usage`
+events carry request snapshots with the original envelope (request/message IDs,
+model and tags) in `raw`; they may repeat across content blocks. Do not sum
+request snapshots together with result totals. Interrupted turns retain request
+snapshots in the artifact but do not fabricate a completed-turn total.
+
 ## Roadmap
 
 | Runtime | Status |
@@ -62,6 +77,8 @@ session.kill();
 
 Opaque runtimes degrade gracefully — fewer event types, never a hard failure.
 
+Proposed [subscription pooling goals](tickets/README.md) cover distributing session workloads across subscriptions while keeping working context independent of the capacity supplying it.
+
 ## Provenance
 
 Extracted from [`inixiative/foundry`](https://github.com/inixiative/foundry),
@@ -71,3 +88,7 @@ and the inixiative bench.
 ## License
 
 MIT
+
+## Runtime
+
+Development and new continuation captures use Bun 1.4.2, pinned in `.bun-version` and `package.json`. Historical S0 recordings retain their original Bun 1.3.14 evidence; they are not new 1.4.2 captures.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inixiative/agent-session",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Drive coding-agent CLIs as persistent, streaming, event-captured sessions. Claude Code and Codex today; Gemini, Grok planned.",
   "type": "module",
   "main": "src/index.ts",
@@ -8,17 +8,42 @@
   "exports": {
     ".": "./src/index.ts"
   },
-  "files": ["src"],
+  "files": [
+    "src"
+  ],
   "scripts": {
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "check": "bun run typecheck && bun run test",
+    "prepublishOnly": "bun run check"
   },
   "keywords": [
-    "claude-code", "codex", "agent", "session", "stream", "stream-json",
-    "ai", "cli", "sandbox", "harness", "eval"
+    "claude-code",
+    "codex",
+    "agent",
+    "session",
+    "stream",
+    "stream-json",
+    "ai",
+    "cli",
+    "sandbox",
+    "harness",
+    "eval"
   ],
   "license": "MIT",
   "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5.7.0"
+    "@types/bun": "1.4.2",
+    "typescript": "6.0.3"
+  },
+  "packageManager": "bun@1.4.2",
+  "engines": {
+    "bun": ">=1.4.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/inixiative/agent-session.git"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }