@inferencesh/sdk 0.33.0 → 0.35.0

package/CHANGELOG.md

@@ -7,6 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.35.0] - 2026-10-28
+
+### Breaking
+- The builtin hooks are `suggest` and `extract`, not `belt:suggest` and `belt:extract`. `BuiltinHookBeltSuggest` and `BuiltinHookBeltExtract` are now `BuiltinHookSuggest` and `BuiltinHookExtract`; `learningHooks()` writes the new names.
+
+### Added
+- `ChatHookEvent.injection_ids`: the injection messages a hook run wrote.
+
+## [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/agent/api.js

@@ -81,6 +81,8 @@ export async function fetchAgentInfo(client, agentRef) {
             description: version?.description,
             example_prompts: version?.example_prompts,
             model_capabilities: Array.isArray(capabilities) ? capabilities : undefined,
+            agent_id: resp.data?.id,
+            version_id: resp.data?.version_id || version?.id,
         };
     }
     catch {

package/dist/agent/types.d.ts

@@ -95,6 +95,13 @@ export type AgentInfo = Partial<Pick<AgentVersionDTO, 'description' | 'example_p
      * its app version. Undefined when unknown; then assume everything.
      */
     model_capabilities?: string[];
+    /** The agent's id. */
+    agent_id?: string;
+    /**
+     * The agent's current version. A chat stays on the version it started
+     * with; one on another version can move to this one with switchAgent.
+     */
+    version_id?: string;
 };
 /**
  * Status of the chat

package/dist/hook-builder.d.ts

@@ -13,7 +13,7 @@ export declare class LifecycleHookBuilder {
     webhook(url: string): this;
     /** Set handler to a task (agent ref) */
     task(agentRef: string): this;
-    /** Set handler to a builtin the platform runs itself (e.g. belt:suggest) */
+    /** Set handler to a builtin the platform runs itself (e.g. suggest) */
     builtin(name: BuiltinHook): this;
     /** Set async execution */
     async(enabled: boolean): this;

package/dist/hook-builder.js

@@ -1,7 +1,7 @@
 /**
  * Hook Builder - Fluent API for defining lifecycle hooks
  */
-import { HookHandlerWebhook, HookHandlerTask, HookHandlerBuiltin, BuiltinHookBeltSuggest, BuiltinHookBeltExtract, HookEventTurnStart, HookEventAgentComplete, HookEventPreCompact, } from './types.js';
+import { HookHandlerWebhook, HookHandlerTask, HookHandlerBuiltin, BuiltinHookSuggest, BuiltinHookExtract, HookEventTurnStart, HookEventAgentComplete, HookEventPreCompact, } from './types.js';
 // =============================================================================
 // Hook Builder
 // =============================================================================
@@ -23,7 +23,7 @@ export class LifecycleHookBuilder {
         this.handlerRef = agentRef;
         return this;
     }
-    /** Set handler to a builtin the platform runs itself (e.g. belt:suggest) */
+    /** Set handler to a builtin the platform runs itself (e.g. suggest) */
     builtin(name) {
         this.handlerType = HookHandlerBuiltin;
         this.handlerRef = name;
@@ -64,11 +64,11 @@ export const lifecycleHook = (event) => new LifecycleHookBuilder(event);
 export function learningHooks(opts) {
     const hooks = [];
     if (opts.suggest) {
-        hooks.push(lifecycleHook(HookEventTurnStart).builtin(BuiltinHookBeltSuggest).build());
+        hooks.push(lifecycleHook(HookEventTurnStart).builtin(BuiltinHookSuggest).build());
     }
     if (opts.learn) {
         for (const event of [HookEventAgentComplete, HookEventPreCompact]) {
-            hooks.push(lifecycleHook(event).builtin(BuiltinHookBeltExtract).build());
+            hooks.push(lifecycleHook(event).builtin(BuiltinHookExtract).build());
         }
     }
     return hooks;

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
@@ -6446,6 +6459,11 @@ export interface ChatHookEvent {
     decision?: HookDecision;
     reason?: string;
     injected?: boolean;
+    /**
+     * InjectionIDs are the injection messages the run wrote, so a reader
+     * shows what the hook added with the run instead of as rows of its own.
+     */
+    injection_ids?: string[];
     error?: string;
     duration_ms: number;
 }
@@ -8070,21 +8088,21 @@ export declare const HookHandlerBuiltin: HookHandlerType;
  * agent config is validated against it, and clients enumerate it to show what
  * an agent can switch on without hosting anything.
  */
-export type BuiltinHook = "belt:suggest" | "belt:extract";
+export type BuiltinHook = "suggest" | "extract";
 /**
- * BuiltinHookBeltSuggest searches the team's skills, knowledge and apps
+ * BuiltinHookSuggest searches the team's skills, knowledge and apps
  * for what the turn is about and injects the matches, so an agent picks up
  * procedural knowledge it was never prompted with.
  */
-export declare const BuiltinHookBeltSuggest: BuiltinHook;
+export declare const BuiltinHookSuggest: BuiltinHook;
 /**
- * BuiltinHookBeltExtract reviews the conversation for reusable knowledge
+ * BuiltinHookExtract reviews the conversation for reusable knowledge
  * and saves it to the team's registry, deduplicated against what is
- * there, so belt:suggest can hand it back later. It runs in the
+ * there, so suggest can hand it back later. It runs in the
  * background: on agent.complete every tenth user turn, and before
  * compaction drops the turns it would have learned from.
  */
-export declare const BuiltinHookBeltExtract: BuiltinHook;
+export declare const BuiltinHookExtract: BuiltinHook;
 /**
  * BuiltinHookDefinition describes a builtin hook and where it may be used.
  */

package/dist/types.js

@@ -1720,19 +1720,19 @@ export const HookHandlerTask = "task";
 export const HookHandlerGate = "gate";
 export const HookHandlerBuiltin = "builtin";
 /**
- * BuiltinHookBeltSuggest searches the team's skills, knowledge and apps
+ * BuiltinHookSuggest searches the team's skills, knowledge and apps
  * for what the turn is about and injects the matches, so an agent picks up
  * procedural knowledge it was never prompted with.
  */
-export const BuiltinHookBeltSuggest = "belt:suggest";
+export const BuiltinHookSuggest = "suggest";
 /**
- * BuiltinHookBeltExtract reviews the conversation for reusable knowledge
+ * BuiltinHookExtract reviews the conversation for reusable knowledge
  * and saves it to the team's registry, deduplicated against what is
- * there, so belt:suggest can hand it back later. It runs in the
+ * there, so suggest can hand it back later. It runs in the
  * background: on agent.complete every tenth user turn, and before
  * compaction drops the turns it would have learned from.
  */
-export const BuiltinHookBeltExtract = "belt:extract";
+export const BuiltinHookExtract = "extract";
 export const AgentEventSubagentStarted = "subagent.started";
 export const AgentEventSubagentUpdated = "subagent.updated";
 export const AgentEventSubagentCompleted = "subagent.completed";

package/package.json

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