@inferencesh/sdk 0.33.0 → 0.34.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.34.0] - 2026-10-26
+
+### Breaking
+- `CursorListRequest.page` and `CursorListResponse.total_items` are gone: lists are cursor-only. Page with `cursor` and `has_more`.
+
+### Added
+- `ToolInvocationDTO.action`: the phrase the model wrote for the call ("Fetch unread emails from alice@x.com"). Empty when it left it out.
+- `AgentRunDTO.finished_at`: when the run reached a terminal state.
+- `ChatRunEvent.duration_ms`: how long the run took, from its start to its end.
+
+### Changed
+- Auth scheme scopes (`scopes`, `required_scopes`) are the provider's own scope names; `scope_aliases` are optional shorthand for them.
+
 ## [0.33.0] - 2026-10-24
 
 ### Breaking

package/dist/types.d.ts

@@ -394,6 +394,10 @@ export interface AgentRunDTO extends BaseModelDTO, PermissionModelDTO {
     state: AgentRunState;
     error?: string;
     output?: any;
+    /**
+     * FinishedAt is when the run reached a terminal state; nil while it runs.
+     */
+    finished_at?: string;
     interrupt_reason?: InterruptReason;
     interrupt_tool_id?: string;
     interrupt_meta?: any;
@@ -2786,7 +2790,6 @@ export interface SortOrder {
  */
 export interface CursorListRequest {
     cursor: string;
-    page?: number;
     limit: number;
     direction: string;
     search?: SearchRequest;
@@ -2812,7 +2815,6 @@ export interface CursorListResponse<T extends any> {
     has_next: boolean;
     has_previous: boolean;
     items_per_page: number;
-    total_items: number;
 }
 /**
  * CountResponse is the response for count endpoints.
@@ -5419,6 +5421,11 @@ export interface ToolInvocationDTO extends BaseModelDTO, PermissionModelDTO {
     tool_invocation_id: string;
     type: ToolType;
     display_name?: string;
+    /**
+     * Action is what the model said the call does, as an imperative phrase
+     * ("Fetch unread emails from alice@x.com"). Empty when it left it out.
+     */
+    action?: string;
     execution_id?: string;
     function: ToolInvocationFunction;
     status: ToolInvocationStatus;
@@ -5994,8 +6001,8 @@ export interface AuthMethodLookup {
 }
 /**
  * AuthMethodCapability is something an app can ask for from this provider,
- * satisfied by a connection holding its scopes. Scopes are in the scheme's
- * own (friendly) names, the ones a credential stores.
+ * satisfied by a connection holding its scopes. Scopes are the provider's
+ * own names (Wire form), the ones a credential stores.
  */
 export interface AuthMethodCapability {
     key: string;
@@ -6052,10 +6059,11 @@ export interface AuthMethod {
     authorization_endpoint?: string;
     scopes?: string[];
     /**
-     * ScopeAliases map the scheme's own scope names to what the provider
-     * wants on the wire ("gmail.send" → "https://www.googleapis.com/auth/
-     * gmail.send"). Credentials store the alias; the wire form is used only
-     * in requests. A scope with no alias is sent as is.
+     * ScopeAliases are shorthand a caller may write for a provider scope
+     * ("gmail.send" → "https://www.googleapis.com/auth/gmail.send"). They
+     * are accepted on input only: credentials, capabilities and allowed
+     * lists hold the provider's own name (Wire), and every comparison is
+     * in that form. A scope with no alias is the provider's name as is.
      */
     scope_aliases?: {
         [key: string]: string;
@@ -6103,7 +6111,7 @@ export interface AuthMethod {
      * re-authorizing for more scopes, whatever the caller asked for: the
      * scopes the identity lookup and token refresh need (Google's openid,
      * email and profile; X's users.read and offline.access). In the
-     * scheme's own names, like Scopes. Empty = only what was asked for.
+     * provider's own names, like Scopes. Empty = only what was asked for.
      */
     required_scopes?: string[];
     /**
@@ -6422,6 +6430,11 @@ export interface ChatRunEvent {
     run_id: string;
     state: AgentRunState;
     reason?: RunEndReason;
+    /**
+     * DurationMs is how long the run took, from its start to its end. The
+     * event message's created_at is when it ended.
+     */
+    duration_ms?: number;
 }
 /**
  * ChatEvent is the payload of an event-role message: system info shown in the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inferencesh/sdk",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Official JavaScript/TypeScript SDK for inference.sh - Run AI models with a simple API",
   "type": "module",
   "main": "dist/index.js",