bopodev-agent-sdk 0.1.13 → 0.1.15

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
 
-> bopodev-agent-sdk@0.1.13 build /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopohq/packages/agent-sdk
+> bopodev-agent-sdk@0.1.15 build /Users/danielkrusenstrahle/Documents/Projects/Monorepo/bopodev/packages/agent-sdk
 > tsc -p tsconfig.json --emitDeclarationOnly
 

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 BopoDev contributors
+Copyright (c) 2026 Bopo
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/adapters/claude-code/src/server/parse.d.ts

@@ -1,2 +1,13 @@
-export { parseClaudeStreamOutput as parseClaudeOutput } from "../../../../agent-sdk/src/runtime-parsers";
+import type { AdapterRuntimeUsageResolution } from "../../../../agent-sdk/src/adapters";
 export { isClaudeRunIncomplete, isUnknownSessionError as isClaudeUnknownSessionError } from "../../../../agent-sdk/src/adapters";
+export declare function resolveClaudeRuntimeUsage(input: {
+    stdout: string;
+    stderr: string;
+    parsedUsage?: {
+        tokenInput?: number;
+        tokenOutput?: number;
+        usdCost?: number;
+        summary?: string;
+    };
+    structuredOutputSource?: "stdout" | "stderr";
+}): AdapterRuntimeUsageResolution;

package/dist/adapters/codex/src/server/parse.d.ts

@@ -1,2 +1,13 @@
-export { parseStructuredUsage as parseCodexOutput } from "../../../../agent-sdk/src/runtime-parsers";
+import type { AdapterRuntimeUsageResolution } from "../../../../agent-sdk/src/adapters";
 export { isUnknownSessionError as isCodexUnknownSessionError } from "../../../../agent-sdk/src/adapters";
+export declare function resolveCodexRuntimeUsage(input: {
+    stdout: string;
+    stderr: string;
+    parsedUsage?: {
+        tokenInput?: number;
+        tokenOutput?: number;
+        usdCost?: number;
+        summary?: string;
+    };
+    structuredOutputSource?: "stdout" | "stderr";
+}): AdapterRuntimeUsageResolution;

package/dist/adapters/cursor/src/server/parse.d.ts

@@ -1,2 +1,13 @@
-export { parseCursorStreamOutput as parseCursorOutput } from "../../../../agent-sdk/src/runtime-parsers";
+import type { AdapterRuntimeUsageResolution } from "../../../../agent-sdk/src/adapters";
 export { isUnknownSessionError as isCursorUnknownSessionError, readRuntimeSessionId } from "../../../../agent-sdk/src/adapters";
+export declare function resolveCursorRuntimeUsage(input: {
+    stdout: string;
+    stderr: string;
+    parsedUsage?: {
+        tokenInput?: number;
+        tokenOutput?: number;
+        usdCost?: number;
+        summary?: string;
+    };
+    structuredOutputSource?: "stdout" | "stderr";
+}): AdapterRuntimeUsageResolution;

package/dist/adapters/gemini-cli/src/cli/format-event.d.ts

@@ -0,0 +1 @@
+export declare function formatStdoutEvent(line: string, debug: boolean): void;

package/dist/adapters/gemini-cli/src/cli/index.d.ts

@@ -0,0 +1 @@
+export { formatStdoutEvent } from "./format-event";

package/dist/adapters/gemini-cli/src/index.d.ts

@@ -0,0 +1,28 @@
+import type { AdapterMetadata, AdapterModule } from "../../../agent-sdk/src/types";
+export declare const type: "gemini_cli";
+export declare const label = "Gemini CLI";
+export declare const models: readonly [{
+    readonly id: "gemini-2.5-pro";
+    readonly label: "Gemini 2.5 Pro";
+}, {
+    readonly id: "gemini-2.5-flash";
+    readonly label: "Gemini 2.5 Flash";
+}, {
+    readonly id: "gemini-2.5-flash-lite";
+    readonly label: "Gemini 2.5 Flash Lite";
+}, {
+    readonly id: "gemini-3.1-flash-lite";
+    readonly label: "Gemini 3.1 Flash Lite";
+}, {
+    readonly id: "gemini-3-flash";
+    readonly label: "Gemini 3 Flash";
+}, {
+    readonly id: "gemini-3-pro";
+    readonly label: "Gemini 3 Pro";
+}, {
+    readonly id: "gemini-3-pro-200k";
+    readonly label: "Gemini 3 Pro (>200k context)";
+}];
+export declare const agentConfigurationDoc = "# Gemini CLI agent configuration\n\nAdapter: gemini_cli\n\nUse when:\n- You want to run the Gemini CLI locally on the host machine.\n- You want Gemini chat sessions resumed across heartbeats with --resume.\n- You need Google Gemini model selection (e.g. 2.5 Pro, 2.5 Flash, 3 Flash).\n\nDon't use when:\n- You need webhook-style external invocation (use http adapter).\n- You only need a one-shot script without an AI coding agent loop (use shell).\n- Gemini CLI is not installed on the machine that runs the agent.\n\nCore fields:\n- cwd (string, optional): absolute working directory for the agent process.\n- model (string, optional): Gemini model id (e.g. gemini-2.5-pro, gemini-2.5-flash).\n- command (string, optional): defaults to \"gemini\".\n- timeoutSec / timeoutMs (number, optional): run timeout.\n- args (string[], optional): additional CLI args.\n\nNotes:\n- Runs use positional prompt; prompt is passed as the final argument.\n- Sessions resume with --resume when stored session cwd matches the current cwd.\n- Authentication can use GEMINI_API_KEY or GOOGLE_API_KEY.";
+export declare const metadata: AdapterMetadata;
+export declare const geminiCliAdapterModule: AdapterModule;

package/dist/adapters/gemini-cli/src/server/execute.d.ts

@@ -0,0 +1,2 @@
+import type { HeartbeatContext, AdapterExecutionResult } from "../../../../agent-sdk/src/types";
+export declare function execute(context: HeartbeatContext): Promise<AdapterExecutionResult>;

package/dist/adapters/gemini-cli/src/server/index.d.ts

@@ -0,0 +1,6 @@
+import type { AgentRuntimeConfig, AdapterModelOption } from "../../../../agent-sdk/src/types";
+import { execute } from "./execute";
+import { testEnvironment } from "./test";
+export { execute, testEnvironment };
+export * from "./parse";
+export declare function listModels(runtime?: AgentRuntimeConfig): Promise<AdapterModelOption[]>;

package/dist/adapters/gemini-cli/src/server/parse.d.ts

@@ -0,0 +1,13 @@
+import type { AdapterRuntimeUsageResolution } from "../../../../agent-sdk/src/adapters";
+export { parseGeminiOutput, isGeminiUnknownSessionError } from "../../../../agent-sdk/src/adapters";
+export declare function resolveGeminiRuntimeUsage(input: {
+    stdout: string;
+    stderr: string;
+    parsedUsage?: {
+        tokenInput?: number;
+        tokenOutput?: number;
+        usdCost?: number;
+        summary?: string;
+    };
+    structuredOutputSource?: "stdout" | "stderr";
+}): AdapterRuntimeUsageResolution;

package/dist/adapters/gemini-cli/src/server/test.d.ts

@@ -0,0 +1,2 @@
+import type { AgentRuntimeConfig, AdapterEnvironmentResult } from "../../../../agent-sdk/src/types";
+export declare function testEnvironment(runtime?: AgentRuntimeConfig): Promise<AdapterEnvironmentResult>;

package/dist/adapters/gemini-cli/src/ui/build-config.d.ts

@@ -0,0 +1 @@
+export declare function buildAdapterConfig(values: Record<string, unknown>): Record<string, unknown>;

package/dist/adapters/gemini-cli/src/ui/index.d.ts

@@ -0,0 +1,2 @@
+export { parseStdoutLine } from "./parse-stdout";
+export { buildAdapterConfig } from "./build-config";

package/dist/adapters/gemini-cli/src/ui/parse-stdout.d.ts

@@ -0,0 +1,6 @@
+export declare function parseStdoutLine(line: string, timestampIso: string): {
+    kind: string;
+    ts: string;
+    text: string;
+    adapterType: string;
+}[];

package/dist/agent-sdk/src/adapters.d.ts

@@ -1,5 +1,25 @@
-import type { AdapterEnvironmentCheck, AdapterEnvironmentResult, AdapterExecutionResult, AdapterMetadata, AdapterModelOption, AgentAdapter, AgentProviderType, AgentRuntimeConfig, HeartbeatContext } from "./types";
+import type { AdapterEnvironmentCheck, AdapterEnvironmentResult, AdapterExecutionResult, AdapterMetadata, AdapterModelOption, AdapterNormalizedUsage, AgentAdapter, AgentProviderType, AgentRuntimeConfig, HeartbeatContext } from "./types";
 import { type DirectApiProvider } from "./runtime-http";
+type RuntimeParsedUsage = {
+    tokenInput?: number;
+    tokenOutput?: number;
+    usdCost?: number;
+    summary?: string;
+    inputTokens?: number;
+    cachedInputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+};
+export type AdapterRuntimeUsageResolution = {
+    parsedUsage?: RuntimeParsedUsage;
+    structuredOutputSource?: "stdout" | "stderr";
+};
+export type AdapterRuntimeUsageResolver = (runtime: {
+    stdout: string;
+    stderr: string;
+    parsedUsage?: RuntimeParsedUsage;
+    structuredOutputSource?: "stdout" | "stderr";
+}) => AdapterRuntimeUsageResolution;
 export declare class ClaudeCodeAdapter implements AgentAdapter {
     providerType: "claude_code";
     execute(context: HeartbeatContext): Promise<AdapterExecutionResult>;
@@ -47,37 +67,33 @@ export declare function testDirectApiEnvironment(providerType: DirectApiProvider
 export declare function runProviderWork(context: HeartbeatContext, provider: "claude_code" | "codex", pricing: {
     inputRate: number;
     outputRate: number;
+}, options?: {
+    usageResolver?: AdapterRuntimeUsageResolver;
+}): Promise<AdapterExecutionResult>;
+export declare function runCursorWork(context: HeartbeatContext, options?: {
+    usageResolver?: AdapterRuntimeUsageResolver;
 }): Promise<AdapterExecutionResult>;
-export declare function runCursorWork(context: HeartbeatContext): Promise<AdapterExecutionResult>;
 export declare function runOpenCodeWork(context: HeartbeatContext): Promise<AdapterExecutionResult>;
+export declare function runGeminiCliWork(context: HeartbeatContext, options?: {
+    usageResolver?: AdapterRuntimeUsageResolver;
+}): Promise<AdapterExecutionResult>;
 export declare function resolveFailedUsage(runtime: {
-    parsedUsage?: {
-        tokenInput?: number;
-        tokenOutput?: number;
-        usdCost?: number;
-        summary?: string;
-    };
+    parsedUsage?: RuntimeParsedUsage;
     failureType?: "timeout" | "spawn_error" | "nonzero_exit";
     stdout: string;
     stderr: string;
-}, prompt: string, pricing: {
-    inputRate: number;
-    outputRate: number;
 }): {
     tokenInput: number;
     tokenOutput: number;
     usdCost: number;
+    usage: AdapterNormalizedUsage | undefined;
     source: "structured";
 } | {
     tokenInput: number;
     tokenOutput: number;
     usdCost: number;
+    usage: AdapterNormalizedUsage;
     source: "none";
-} | {
-    tokenInput: number;
-    tokenOutput: number;
-    usdCost: number;
-    source: "estimated";
 };
 export declare function toProviderResult(context: HeartbeatContext, provider: AgentProviderType, prompt: string, runtime: {
     ok: boolean;
@@ -97,12 +113,7 @@ export declare function toProviderResult(context: HeartbeatContext, provider: Ag
         spawnErrorCode?: string;
         forcedKill: boolean;
     }>;
-    parsedUsage?: {
-        tokenInput?: number;
-        tokenOutput?: number;
-        usdCost?: number;
-        summary?: string;
-    };
+    parsedUsage?: RuntimeParsedUsage;
     structuredOutputSource?: "stdout" | "stderr";
     structuredOutputDiagnostics?: {
         stdoutJsonObjectCount: number;
@@ -142,7 +153,10 @@ export declare function toProviderResult(context: HeartbeatContext, provider: Ag
 }, pricing: {
     inputRate: number;
     outputRate: number;
-}, sessionUpdate?: ProviderSessionUpdate): AdapterExecutionResult;
+}, sessionUpdate?: ProviderSessionUpdate, pricingIdentity?: {
+    pricingProviderType?: string | null;
+    pricingModelId?: string | null;
+}): AdapterExecutionResult;
 export declare function resolveRuntimeFailureDetail(runtime: {
     stderr: string;
     stdout: string;
@@ -155,6 +169,10 @@ export declare function resolveRuntimeFailureDetail(runtime: {
 export declare function parseOpenCodeOutput(stdout: string): {
     sessionId: string | null;
 };
+export declare function parseGeminiOutput(stdout: string): {
+    sessionId: string | null;
+};
+export declare function isGeminiUnknownSessionError(stdout: string, stderr: string): boolean;
 export declare function resolveCursorResumeState(state: HeartbeatContext["state"], cwd: string): {
     resumeSessionId: null;
     resumeAttempted: boolean;

package/dist/agent-sdk/src/runtime-core.d.ts

@@ -1,2 +1,2 @@
 export type { RuntimeAttemptTrace, RuntimeCommandHealth, RuntimeExecutionOutput, RuntimeTranscriptEvent } from "./runtime";
-export { checkRuntimeCommandHealth, executeAgentRuntime, executePromptRuntime } from "./runtime";
+export { checkRuntimeCommandHealth, containsRateLimitFailure, executeAgentRuntime, executePromptRuntime } from "./runtime";

package/dist/agent-sdk/src/runtime-parsers.d.ts

@@ -1 +1 @@
-export { parseClaudeStreamOutput, parseCursorStreamOutput, parseRuntimeTranscript, parseStructuredUsage } from "./runtime";
+export { parseClaudeStreamOutput, parseCursorStreamOutput, parseGeminiStreamOutput, parseRuntimeTranscript, parseStructuredUsage } from "./runtime";

package/dist/agent-sdk/src/runtime.d.ts

@@ -1,5 +1,5 @@
 import type { AgentRuntimeConfig } from "./types";
-type LocalProvider = "claude_code" | "codex" | "cursor" | "opencode";
+type LocalProvider = "claude_code" | "codex" | "cursor" | "opencode" | "gemini_cli";
 type ClaudeContractDiagnostics = {
     commandOverride: boolean;
     commandLooksClaude: boolean;
@@ -93,16 +93,13 @@ export declare function executePromptRuntime(command: string, prompt: string, co
     provider?: LocalProvider;
     claudeContract?: ClaudeContractDiagnostics;
 }): Promise<RuntimeExecutionOutput>;
+export declare function containsRateLimitFailure(text: string): boolean;
 export declare function checkRuntimeCommandHealth(command: string, options?: {
     cwd?: string;
     timeoutMs?: number;
+    env?: Record<string, string>;
 }): Promise<RuntimeCommandHealth>;
-export declare function parseStructuredUsage(stdout: string): {
-    tokenInput: number | undefined;
-    tokenOutput: number | undefined;
-    usdCost: number | undefined;
-    summary: string | undefined;
-} | undefined;
+export declare function parseStructuredUsage(stdout: string): ParsedUsageRecord | undefined;
 export declare function parseClaudeStreamOutput(stdout: string): {
     usage: {
         summary: string | undefined;
@@ -115,5 +112,9 @@ export declare function parseClaudeStreamOutput(stdout: string): {
     sessionId: string | undefined;
 } | undefined;
 export declare function parseCursorStreamOutput(stdout: string): CursorParsedStream | undefined;
+export declare function parseGeminiStreamOutput(stdout: string, stderr?: string): {
+    usage: ParsedUsageRecord;
+    sessionId?: string;
+} | undefined;
 export declare function parseRuntimeTranscript(provider: LocalProvider | undefined, stdout: string, stderr: string): RuntimeTranscriptEvent[] | undefined;
 export {};

package/dist/agent-sdk/src/types.d.ts

@@ -58,12 +58,31 @@ export interface HeartbeatContext {
     memoryContext?: AgentMemoryContext;
     runtime?: AgentRuntimeConfig;
 }
+/**
+ * Normalized usage contract produced by adapter execution.
+ *
+ * Invariants:
+ * - `inputTokens` excludes cache reads.
+ * - `cachedInputTokens` tracks cache-hit prompt tokens only.
+ * - persisted `tokenInput` = `inputTokens + cachedInputTokens` for backwards compatibility.
+ * - `outputTokens` reflects generated/completion tokens.
+ */
+export interface AdapterNormalizedUsage {
+    inputTokens: number;
+    cachedInputTokens: number;
+    outputTokens: number;
+    costUsd?: number;
+    summary?: string;
+}
 export interface AdapterExecutionResult {
     status: "ok" | "skipped" | "failed";
     summary: string;
     tokenInput: number;
     tokenOutput: number;
     usdCost: number;
+    usage?: AdapterNormalizedUsage;
+    pricingProviderType?: string | null;
+    pricingModelId?: string | null;
     outcome?: ExecutionOutcome;
     nextState?: AgentState;
     trace?: AdapterTrace;
@@ -167,7 +186,7 @@ export interface AdapterTrace {
     timedOut?: boolean;
     failureType?: string;
     timeoutSource?: "runtime" | "watchdog" | null;
-    usageSource?: "structured" | "estimated" | "none" | "unknown";
+    usageSource?: "structured" | "none" | "unknown";
     attemptCount?: number;
     attempts?: Array<{
         attempt: number;
@@ -203,6 +222,7 @@ export interface AdapterTrace {
         claudeSessionId?: string;
         cursorSessionId?: string;
         cursorErrorMessage?: string;
+        geminiSessionId?: string;
         claudeContract?: {
             commandOverride: boolean;
             commandLooksClaude: boolean;

package/dist/contracts/src/index.d.ts

@@ -125,6 +125,7 @@ export declare const ProviderTypeSchema: z.ZodEnum<{
     codex: "codex";
     cursor: "cursor";
     opencode: "opencode";
+    gemini_cli: "gemini_cli";
     openai_api: "openai_api";
     anthropic_api: "anthropic_api";
     http: "http";
@@ -437,6 +438,7 @@ export declare const AgentCreateRequestSchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
         http: "http";
@@ -480,6 +482,7 @@ export declare const AgentUpdateRequestSchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
         http: "http";
@@ -530,6 +533,7 @@ export declare const AgentSchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
         http: "http";
@@ -769,6 +773,7 @@ export declare const OfficeOccupantSchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
         http: "http";
@@ -815,6 +820,7 @@ export declare const OfficeSpaceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
             codex: "codex";
             cursor: "cursor";
             opencode: "opencode";
+            gemini_cli: "gemini_cli";
             openai_api: "openai_api";
             anthropic_api: "anthropic_api";
             http: "http";
@@ -860,6 +866,7 @@ export declare const OfficeSpaceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
             codex: "codex";
             cursor: "cursor";
             opencode: "opencode";
+            gemini_cli: "gemini_cli";
             openai_api: "openai_api";
             anthropic_api: "anthropic_api";
             http: "http";
@@ -1142,6 +1149,7 @@ export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.Zod
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
                 http: "http";
@@ -1187,6 +1195,7 @@ export declare const RealtimeEventEnvelopeSchema: z.ZodDiscriminatedUnion<[z.Zod
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
                 http: "http";
@@ -1455,6 +1464,7 @@ export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
                 http: "http";
@@ -1500,6 +1510,7 @@ export declare const RealtimeEventMessageSchema: z.ZodDiscriminatedUnion<[z.ZodO
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
                 http: "http";
@@ -1768,6 +1779,7 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
                 http: "http";
@@ -1813,6 +1825,7 @@ export declare const RealtimeMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
                 codex: "codex";
                 cursor: "cursor";
                 opencode: "opencode";
+                gemini_cli: "gemini_cli";
                 openai_api: "openai_api";
                 anthropic_api: "anthropic_api";
                 http: "http";
@@ -1977,11 +1990,24 @@ export declare const CostLedgerEntrySchema: z.ZodObject<{
         codex: "codex";
         cursor: "cursor";
         opencode: "opencode";
+        gemini_cli: "gemini_cli";
         openai_api: "openai_api";
         anthropic_api: "anthropic_api";
         http: "http";
         shell: "shell";
     }>;
+    runtimeModelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    pricingProviderType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        opencode: "opencode";
+        openai_api: "openai_api";
+        anthropic_api: "anthropic_api";
+        gemini_api: "gemini_api";
+    }>>>;
+    pricingModelId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    pricingSource: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        exact: "exact";
+        missing: "missing";
+    }>>>;
     tokenInput: z.ZodNumber;
     tokenOutput: z.ZodNumber;
     usdCost: z.ZodNumber;

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "bopodev-agent-sdk",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "license": "MIT",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "dependencies": {
-    "bopodev-contracts": "0.1.13"
+    "bopodev-contracts": "0.1.15"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json --emitDeclarationOnly",