stratus-sdk 0.6.0 → 0.6.3

package/README.md

@@ -10,9 +10,12 @@
 
 [usestratus.dev](https://usestratus.dev)
 
+[![npm version](https://img.shields.io/npm/v/stratus-sdk)](https://www.npmjs.com/package/stratus-sdk)
+[![CI](https://github.com/tylergibbs1/stratus/actions/workflows/ci.yml/badge.svg)](https://github.com/tylergibbs1/stratus/actions/workflows/ci.yml)
+
 A TypeScript agent framework for Azure OpenAI. Build multi-agent systems with tools, handoffs, guardrails, streaming, structured output, and more.
 
-`agents` `tools` `streaming` `structured output` `handoffs` `subagents` `guardrails` `hooks` `tracing` `sessions` `abort signals`
+`agents` `tools` `streaming` `structured output` `handoffs` `subagents` `guardrails` `hooks` `tracing` `sessions` `abort signals` `todo tracking` `cost tracking`
 
 ## Install
 
@@ -331,6 +334,55 @@ try {
 }
 ```
 
+### Todo Tracking
+
+Track task progress during agent execution:
+
+```ts
+import { todoTool, TodoList } from "stratus-sdk";
+
+const todos = new TodoList();
+todos.onUpdate((items) => {
+  for (const item of items) {
+    const icon = item.status === "completed" ? "+" : item.status === "in_progress" ? ">" : "-";
+    console.log(`${icon} ${item.content}`);
+  }
+});
+
+const agent = new Agent({
+  name: "planner",
+  instructions: "Break tasks into steps and track progress with todo_write.",
+  model,
+  tools: [todoTool(todos)],
+});
+
+await run(agent, "Set up a new TypeScript project");
+```
+
+### Usage & Cost Tracking
+
+Track token usage and estimate costs:
+
+```ts
+import { createCostEstimator } from "stratus-sdk";
+
+const estimator = createCostEstimator({
+  inputTokenCostPer1k: 0.01,
+  outputTokenCostPer1k: 0.03,
+});
+
+const result = await run(agent, "Hello", { costEstimator: estimator });
+console.log(result.usage.totalTokens); // token counts
+console.log(result.totalCostUsd);      // estimated cost
+console.log(result.numTurns);          // model call count
+
+// Set budget limits
+const result = await run(agent, "Hello", {
+  costEstimator: estimator,
+  maxBudgetUsd: 0.50, // throws MaxBudgetExceededError if exceeded
+});
+```
+
 ### Tool Choice & Tool Use Behavior
 
 Control how the model uses tools:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stratus-sdk",
-  "version": "0.6.0",
+  "version": "0.6.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,9 +18,7 @@
       "import": "./dist/azure/index.js"
     }
   },
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",