@pivanov/claude-wire 0.0.3 → 0.1.0

package/dist/types/protocol.d.ts

@@ -3,7 +3,7 @@ export type TModelUsageEntry = {
     outputTokens: number;
     cacheReadInputTokens?: number;
     cacheCreationInputTokens?: number;
-    contextWindow: number;
+    contextWindow?: number;
 };
 export type TClaudeContentType = "text" | "thinking" | "tool_use" | "tool_result" | (string & {});
 export type TClaudeContent = {
@@ -32,11 +32,7 @@ export type TClaudeEvent = {
     model?: string;
     tools?: string[];
     duration_ms?: number;
-    duration_api_ms?: number;
-    cost_usd?: number;
     total_cost_usd?: number;
     is_error?: boolean;
-    num_turns?: number;
     modelUsage?: Record<string, TModelUsageEntry>;
-    usage?: unknown;
 };

package/dist/types/results.d.ts

@@ -1,16 +1,16 @@
 import type { TRelayEvent } from "./events.js";
+export type TTokens = {
+    input: number;
+    output: number;
+};
 export type TCostSnapshot = {
     totalUsd: number;
-    inputTokens: number;
-    outputTokens: number;
+    tokens: TTokens;
 };
 export type TAskResult = {
     text: string;
     costUsd: number;
-    tokens: {
-        input: number;
-        output: number;
-    };
+    tokens: TTokens;
     duration: number;
     sessionId?: string;
     events: TRelayEvent[];

package/dist/validation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Rejects non-finite values and negatives. Zero is intentionally allowed
+ * so callers can express "disallow any spend" (useful in tests).
+ */
+export declare const assertPositiveNumber: (value: number | undefined, name: string) => void;
+/**
+ * Rejects empty strings. Used on writer payloads where an empty value
+ * would produce a malformed JSON line on the CLI's stdin.
+ */
+export declare const requireNonEmpty: (value: string, name: string) => void;

package/dist/validation.js

@@ -0,0 +1,23 @@
+import { ClaudeError } from "./errors.js";
+// Boundary validators -- throw ClaudeError with a stable message shape so
+// callers (SDK tests, consumer apps) can pattern-match on field name.
+// Both helpers are cheap; performance-sensitive paths should still prefer
+// type-level guards, but runtime checks catch undeclared-undefined drift.
+/**
+ * Rejects non-finite values and negatives. Zero is intentionally allowed
+ * so callers can express "disallow any spend" (useful in tests).
+ */
+export const assertPositiveNumber = (value, name) => {
+    if (value !== undefined && (!Number.isFinite(value) || value < 0)) {
+        throw new ClaudeError(`${name} must be a finite non-negative number`);
+    }
+};
+/**
+ * Rejects empty strings. Used on writer payloads where an empty value
+ * would produce a malformed JSON line on the CLI's stdin.
+ */
+export const requireNonEmpty = (value, name) => {
+    if (!value) {
+        throw new ClaudeError(`${name} must be a non-empty string`);
+    }
+};

package/dist/warnings.d.ts

@@ -0,0 +1,2 @@
+export type TWarn = (message: string, cause?: unknown) => void;
+export declare const createWarn: (onWarning?: TWarn) => TWarn;

package/dist/warnings.js

@@ -0,0 +1,24 @@
+// One-line library-warning emitter. Consumers set `onWarning` on
+// IClaudeOptions to route warnings anywhere; when unset we fall back to
+// `console.warn` so behavior is unchanged for casual users.
+const DEFAULT = (message, cause) => {
+    if (cause === undefined) {
+        console.warn(`[claude-wire] ${message}`);
+    }
+    else {
+        console.warn(`[claude-wire] ${message}`, cause);
+    }
+};
+export const createWarn = (onWarning) => {
+    return onWarning
+        ? (message, cause) => {
+            try {
+                onWarning(message, cause);
+            }
+            catch {
+                // A user hook that itself throws shouldn't take down the stream.
+                DEFAULT(message, cause);
+            }
+        }
+        : DEFAULT;
+};

package/dist/writer.d.ts

@@ -2,6 +2,15 @@ export declare const writer: {
     user: (content: string) => string;
     approve: (toolUseId: string) => string;
     deny: (toolUseId: string) => string;
-    toolResult: (toolUseId: string, content: string) => string;
+    /**
+     * Send a tool result in response to a `tool_use` event. Pass
+     * `{ isError: true }` to mark the result as a tool-side error -- the model
+     * will see it as an error and can react (retry, apologize, pick another
+     * tool) rather than treating it as success. The protocol supports the
+     * flag natively; without it, results are assumed successful.
+     */
+    toolResult: (toolUseId: string, content: string, options?: {
+        isError?: boolean;
+    }) => string;
     abort: () => string;
 };

package/dist/writer.js

@@ -1,10 +1,5 @@
-import { ClaudeError } from "./errors.js";
+import { requireNonEmpty } from "./validation.js";
 const ABORT_LINE = `${JSON.stringify({ type: "abort" })}\n`;
-const requireNonEmpty = (value, name) => {
-    if (!value) {
-        throw new ClaudeError(`${name} must be a non-empty string`);
-    }
-};
 export const writer = {
     user: (content) => {
         requireNonEmpty(content, "content");
@@ -18,9 +13,20 @@ export const writer = {
         requireNonEmpty(toolUseId, "toolUseId");
         return `${JSON.stringify({ type: "deny", tool_use_id: toolUseId })}\n`;
     },
-    toolResult: (toolUseId, content) => {
+    /**
+     * Send a tool result in response to a `tool_use` event. Pass
+     * `{ isError: true }` to mark the result as a tool-side error -- the model
+     * will see it as an error and can react (retry, apologize, pick another
+     * tool) rather than treating it as success. The protocol supports the
+     * flag natively; without it, results are assumed successful.
+     */
+    toolResult: (toolUseId, content, options) => {
         requireNonEmpty(toolUseId, "toolUseId");
-        return `${JSON.stringify({ type: "tool_result", tool_use_id: toolUseId, content })}\n`;
+        const payload = { type: "tool_result", tool_use_id: toolUseId, content };
+        if (options?.isError) {
+            payload.is_error = true;
+        }
+        return `${JSON.stringify(payload)}\n`;
     },
     abort: () => ABORT_LINE,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pivanov/claude-wire",
-  "version": "0.0.3",
+  "version": "0.1.0",
   "description": "Run Claude Code programmatically. Typed SDK for spawning, streaming, and controlling the CLI.",
   "type": "module",
   "engines": {