@simonpeacocks/peacockery-voice-client 0.1.0 → 0.1.3

package/README.md

@@ -2,14 +2,14 @@
 
 The request and response types in `src/schema.ts` are generated from the service's checked-in `openapi.json`. The small runtime wrapper uses `openapi-fetch` and accepts either the `lab` or `production` environment.
 
-Install it from the private repository:
+Install it from npm:
 
 ```bash
-pnpm add '@chikingsley/peacockery-voice-client@github:chikingsley/peacockery-voice#main&path:/clients/typescript'
+pnpm add @simonpeacocks/peacockery-voice-client
 ```
 
 ```ts
-import { createPeacockeryVoiceClient } from "@chikingsley/peacockery-voice-client";
+import { createPeacockeryVoiceClient } from "@simonpeacocks/peacockery-voice-client";
 
 const voice = createPeacockeryVoiceClient({
   apiKey: process.env.PEACOCKERY_VOICE_API_KEY!,
@@ -23,4 +23,22 @@ For a device-bound child, pass `authorizationScheme: "DPoP"` and a platform proo
 
 Private-key creation and signing stay in platform code. On Apple hardware the intended provider uses a non-exportable Secure Enclave P-256 key; the generated client never serializes or persists that key.
 
-Run `pnpm run generate:sdk` from the repository root whenever the OpenAPI contract changes. Compiled JavaScript and declarations are checked in so a private Git installation does not need to execute package lifecycle scripts. Realtime WebSockets still use the protocol documented by `/v1/realtime`; `openapi-fetch` covers the HTTP surface.
+Run `pnpm run generate:sdk` from the repository root whenever the OpenAPI contract changes. Compiled JavaScript and declarations are checked in, and private Git installations consume them directly. Realtime WebSockets still use the protocol documented by `/v1/realtime`; `openapi-fetch` covers the HTTP surface.
+
+## Release
+
+Run one guarded command from a clean, synchronized `main` branch:
+
+```bash
+pnpm release:voice-client patch
+```
+
+The command regenerates the SDK, validates the TypeScript client and Swift package when Swift is available, increments the requested semantic version, commits only generated client release files, creates the matching `voice-client-vX.Y.Z` tag, atomically pushes `main` and the tag, watches the GitHub Actions publication, and verifies the new npm version.
+
+Use `minor`, `major`, or an explicit stable version in place of `patch`. Run the complete preflight while keeping the repository unchanged with:
+
+```bash
+pnpm release:voice-client patch --check
+```
+
+If GitHub Actions reports a provider-side failure after the atomic push, repair the publisher configuration and rerun that workflow. The existing version commit and release tag remain the canonical release identity.

package/dist/schema.d.ts

@@ -1977,8 +1977,7 @@ export interface components {
             /** @enum {string} */
             kind: "language" | "transcription";
             provider: string;
-            /** @enum {string} */
-            reasoning_profile?: "low" | "medium" | "minimal" | "none";
+            reasoning?: components["schemas"]["LanguageModelReasoningSpec"];
             routes?: {
                 batch?: components["schemas"]["AsrRouteSpec"];
                 realtime?: components["schemas"]["AsrRouteSpec"];
@@ -2003,6 +2002,11 @@ export interface components {
             source: "artificial-analysis";
             source_version: string;
         };
+        LanguageModelReasoningSpec: {
+            /** @enum {string} */
+            default_effort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+            supported_efforts: ("none" | "minimal" | "low" | "medium" | "high" | "xhigh")[];
+        };
         AsrRouteSpec: {
             model: string;
             provider: string;
@@ -2025,6 +2029,7 @@ export interface components {
             completed_at: string | null;
             created_at: string;
             error: string | null;
+            error_details: components["schemas"]["ProviderFailureDiagnostic"];
             job_id: string;
             /** @enum {string} */
             kind: "transcription";
@@ -2036,6 +2041,17 @@ export interface components {
             status: "pending" | "queued" | "running" | "succeeded" | "failed";
             updated_at: string;
         };
+        ProviderFailureDiagnostic: {
+            /** @enum {string} */
+            category: "authentication" | "empty_output" | "invalid_request" | "network" | "rate_limited" | "timeout" | "unavailable" | "unknown";
+            message: string;
+            provider?: string;
+            providerCode?: string;
+            requestId?: string;
+            retryAfterMs?: number;
+            retryable: boolean;
+            statusCode?: number;
+        } | null;
         TranscriptionArtifact: {
             content: {
                 audio_events: {
@@ -2193,17 +2209,28 @@ export interface components {
                     [key: string]: unknown;
                 };
             };
+            /**
+             * @deprecated
+             * @description Accepted for client compatibility. Transcription jobs are always queued and returned immediately.
+             */
             sync?: boolean;
         };
         TextResponse: {
+            cache: components["schemas"]["TextCacheStatuses"];
+            context: components["schemas"]["TextExecutionContext"];
             finishReason: string;
             model: string;
             provider: string;
             providerLatencyMs: number;
             upstreamModel: string;
             usage: {
+                cacheReadTokens?: number;
+                cacheWriteTokens?: number;
                 inputTokens?: number;
                 outputTokens?: number;
+                providerCostUsd?: number;
+                reasoningTokens?: number;
+                textTokens?: number;
                 totalTokens?: number;
             };
             warnings?: unknown[];
@@ -2213,14 +2240,21 @@ export interface components {
             /** @enum {string} */
             outputType: "object";
         } | {
+            cache: components["schemas"]["TextCacheStatuses"];
+            context: components["schemas"]["TextExecutionContext"];
             finishReason: string;
             model: string;
             provider: string;
             providerLatencyMs: number;
             upstreamModel: string;
             usage: {
+                cacheReadTokens?: number;
+                cacheWriteTokens?: number;
                 inputTokens?: number;
                 outputTokens?: number;
+                providerCostUsd?: number;
+                reasoningTokens?: number;
+                textTokens?: number;
                 totalTokens?: number;
             };
             warnings?: unknown[];
@@ -2228,7 +2262,17 @@ export interface components {
             outputType: "text";
             text: string;
         };
+        TextCacheStatuses: {
+            cloudflare?: string;
+            openRouter?: string;
+        };
+        TextExecutionContext: {
+            conversationId?: string;
+            requestId: string;
+            turnId: string;
+        };
         TextRequest: {
+            context?: components["schemas"]["TextRequestContext"];
             maxOutputTokens?: number;
             messages: components["schemas"]["TextMessage"][];
             model: string;
@@ -2244,20 +2288,39 @@ export interface components {
             providerOptions?: {
                 [key: string]: unknown;
             };
+            reasoning?: components["schemas"]["TextReasoningRequest"];
+            routing?: components["schemas"]["TextRoutingRequest"];
             temperature?: number;
         };
+        TextRequestContext: {
+            conversationId?: string;
+            turnId?: string;
+        };
         TextMessage: {
             content: string;
             /** @enum {string} */
             role: "assistant" | "system" | "user";
         };
+        TextReasoningRequest: {
+            /** @enum {string} */
+            effort: "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+        };
+        TextRoutingRequest: {
+            attemptTimeoutMs?: number;
+            fallbackModels?: string[];
+            /** @enum {string} */
+            transport?: "gateway" | "direct";
+        };
         TextStreamRequest: {
+            context?: components["schemas"]["TextRequestContext"];
             maxOutputTokens?: number;
             messages: components["schemas"]["TextMessage"][];
             model: string;
             providerOptions?: {
                 [key: string]: unknown;
             };
+            reasoning?: components["schemas"]["TextReasoningRequest"];
+            routing?: components["schemas"]["TextRoutingRequest"];
             temperature?: number;
         };
         RealtimeSessionResult: {
@@ -2294,6 +2357,8 @@ export interface components {
         UsageDailyRow: {
             account_key: string;
             asr_seconds: number;
+            cache_read_tokens: number;
+            cache_write_tokens: number;
             day: string;
             estimated_cost_complete: boolean;
             /** @description Estimated provider cost in millionths of one US dollar. This is not an invoice amount. */
@@ -2306,6 +2371,9 @@ export interface components {
             model: string;
             output_tokens: number;
             provider: string;
+            provider_cost_micro_usd: number;
+            provider_cost_request_count: number;
+            provider_cost_usd: number;
             provider_latency_ms: number;
             request_count: number;
             total_tokens: number;
@@ -2315,6 +2383,8 @@ export interface components {
         };
         UsageTotals: {
             asr_seconds: number;
+            cache_read_tokens: number;
+            cache_write_tokens: number;
             /** @description True only when every included request has both measured usage and a matching price. */
             estimated_cost_complete: boolean;
             /** @description Estimated provider cost in millionths of one US dollar. This is not an invoice amount. */
@@ -2324,6 +2394,9 @@ export interface components {
             estimated_cost_usd: number;
             input_tokens: number;
             output_tokens: number;
+            provider_cost_micro_usd: number;
+            provider_cost_request_count: number;
+            provider_cost_usd: number;
             provider_latency_ms: number;
             request_count: number;
             total_tokens: number;
@@ -2334,6 +2407,10 @@ export interface components {
             recent_request_logs: {
                 account_key: string;
                 asr_seconds: number | null;
+                cache_read_tokens: number | null;
+                cache_write_tokens: number | null;
+                cloudflare_cache_status: string | null;
+                conversation_id: string | null;
                 created_at: string;
                 error: string | null;
                 /** @description Estimated provider cost in millionths of one US dollar. This is not an invoice amount. */
@@ -2347,6 +2424,7 @@ export interface components {
                 /** @enum {string} */
                 kind: "asr" | "llm" | "realtime_asr";
                 model: string;
+                openrouter_cache_status: string | null;
                 output_tokens: number | null;
                 price_basis: string | null;
                 price_effective_at: string | null;
@@ -2356,10 +2434,13 @@ export interface components {
                 /** @enum {string|null} */
                 price_unit: "audio_second" | "token" | null;
                 provider: string;
+                provider_cost_micro_usd: number | null;
+                provider_cost_usd: number | null;
                 provider_latency_ms: number | null;
                 route: string | null;
                 status: number | null;
                 total_tokens: number | null;
+                turn_id: string | null;
                 upstream_model: string | null;
             }[];
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simonpeacocks/peacockery-voice-client",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Generated TypeScript client for the Peacockery Voice API",
   "type": "module",
   "license": "MIT",