@inferencesh/sdk 0.34.0 → 0.35.0

package/CHANGELOG.md

@@ -7,6 +7,14 @@ 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

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

@@ -6459,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;
 }
@@ -8083,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.34.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",