@inferencesh/sdk 0.14.0 → 0.14.1

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.14.1] - 2026-10-01
+
+### Added
+
+- `internalTools()` builder methods for every category: `knowledge()` (search, read, save and delete skills and knowledge entries), `agent()` (run a copy of the agent on a side task), `skills()`, `artifact()` and `remote()`.
+- `InternalToolsConfig.knowledge` and `InternalToolsConfig.agent`.
+
+### Changed
+
+- `InternalToolsConfig.spawn` is now `agent`. The API still reads a stored or sent `spawn` as `agent`.
+
+### Deprecated
+
+- `InternalToolsConfig.host_context`: the API ignores it and no longer offers `get_host_context` or `send_to_host`.
+
 ## [0.14.0] - 2026-09-27
 
 ### Fixed

package/README.md

@@ -378,7 +378,7 @@ Use the fluent builders to define `AgentTool` schemas. Client tools (`tool`) run
 | `httpTool(name, url)` / `callTool(name, url)` | Server | HTTP request with credential injection (preferred over `webhookTool`) |
 | `webhookTool(name, url)` | Server | Unsigned webhook (legacy; use `httpTool` for new tools) |
 | `mcpTool(name, credentialId, toolName)` | Server | Call a tool through a connected MCP credential |
-| `internalTools()` | Server | Built-in plan, memory, and widget tools |
+| `internalTools()` | Server | Built-in tools: plan, memory, widget, finish, skills, meta, remote, knowledge, artifact, agent |
 
 ```typescript
 import {

package/dist/tool-builder.d.ts

@@ -136,6 +136,14 @@ declare class InternalToolsBuilder {
     meta(enabled?: boolean): this;
     /** Enable remote tools (run commands on the user's connected remotes) */
     remote(enabled?: boolean): this;
+    /** Enable knowledge tools (search, read and save the user's skills and knowledge entries) */
+    knowledge(enabled?: boolean): this;
+    /** Enable skill_get for the skills configured on the agent (on by default) */
+    skills(enabled?: boolean): this;
+    /** Enable artifact tools (publish shareable HTML/Markdown pages) */
+    artifact(enabled?: boolean): this;
+    /** Enable the agent tool (run a copy of this agent on a side task) */
+    agent(enabled?: boolean): this;
     /** Enable all internal tools */
     all(): this;
     /** Disable all internal tools */

package/dist/tool-builder.js

@@ -293,6 +293,26 @@ class InternalToolsBuilder {
         this.config.remote = enabled;
         return this;
     }
+    /** Enable knowledge tools (search, read and save the user's skills and knowledge entries) */
+    knowledge(enabled = true) {
+        this.config.knowledge = enabled;
+        return this;
+    }
+    /** Enable skill_get for the skills configured on the agent (on by default) */
+    skills(enabled = true) {
+        this.config.skills = enabled;
+        return this;
+    }
+    /** Enable artifact tools (publish shareable HTML/Markdown pages) */
+    artifact(enabled = true) {
+        this.config.artifact = enabled;
+        return this;
+    }
+    /** Enable the agent tool (run a copy of this agent on a side task) */
+    agent(enabled = true) {
+        this.config.agent = enabled;
+        return this;
+    }
     /** Enable all internal tools */
     all() {
         this.config.plan = true;

package/dist/types.d.ts

@@ -10,8 +10,9 @@ export interface InternalToolsConfig {
     host_context?: boolean;
     meta?: boolean;
     artifact?: boolean;
-    spawn?: boolean;
+    agent?: boolean;
     remote?: boolean;
+    knowledge?: boolean;
 }
 /**
  * AgentTool represents a unified tool that can be used by an agent
@@ -84,6 +85,13 @@ export interface AppToolConfig {
     session_enabled?: boolean;
     setup?: any;
     input?: any;
+    /**
+     * FixedInput pins arguments: they are merged over whatever the model sent,
+     * and removed from the tool schema the model is shown, so it neither sees
+     * nor controls them. Input only supplies defaults the model may override;
+     * this is for values an operator decides, not the model.
+     */
+    fixed_input?: any;
 }
 export interface AgentToolConfig {
     ref: string;
@@ -153,6 +161,7 @@ export interface AppToolConfigDTO {
     session_enabled?: boolean;
     setup?: any;
     input?: any;
+    fixed_input?: any;
 }
 export interface AgentToolConfigDTO {
     ref: string;
@@ -2960,10 +2969,6 @@ export interface OrgDTO extends BaseModelDTO {
     name: string;
     avatar_url?: string;
     default_team_id?: string;
-    /**
-     * UsagePolicyID of the org's usage policy ('' = ungoverned, INF-808).
-     */
-    usage_policy_id?: string;
     /**
      * IsAdmin: whether the CALLER is on this org's admin grant list. Set on
      * caller-scoped responses.
@@ -4268,7 +4273,7 @@ export declare const PlanStepStatusPending: PlanStepStatus;
 export declare const PlanStepStatusInProgress: PlanStepStatus;
 export declare const PlanStepStatusCompleted: PlanStepStatus;
 export declare const PlanStepStatusCancelled: PlanStepStatus;
-export type ChatMessageRole = "system" | "user" | "assistant" | "tool" | "injection" | "compaction";
+export type ChatMessageRole = "system" | "user" | "assistant" | "tool" | "injection" | "compaction" | "event";
 /**
  * LLM wire-protocol roles
  */
@@ -4279,22 +4284,25 @@ export declare const ChatMessageRoleTool: ChatMessageRole;
 /**
  * Internal bookkeeping roles — never sent to the LLM provider.
  * BuildContext folds injections into the user turn and replaces
- * compaction markers with their summary.
+ * compaction markers with their summary. Event messages are display-only
+ * system info (a hook ran, ...) and BuildContext skips them.
  */
 export declare const ChatMessageRoleInjection: ChatMessageRole;
 export declare const ChatMessageRoleCompaction: ChatMessageRole;
+export declare const ChatMessageRoleEvent: ChatMessageRole;
 export type ChatMessageStatus = "pending" | "queued" | "ready" | "failed" | "cancelled";
 export declare const ChatMessageStatusPending: ChatMessageStatus;
 export declare const ChatMessageStatusQueued: ChatMessageStatus;
 export declare const ChatMessageStatusReady: ChatMessageStatus;
 export declare const ChatMessageStatusFailed: ChatMessageStatus;
 export declare const ChatMessageStatusCancelled: ChatMessageStatus;
-export type ChatMessageContentType = "text" | "reasoning" | "image" | "file" | "tool";
+export type ChatMessageContentType = "text" | "reasoning" | "image" | "file" | "tool" | "event";
 export declare const ChatMessageContentTypeText: ChatMessageContentType;
 export declare const ChatMessageContentTypeReasoning: ChatMessageContentType;
 export declare const ChatMessageContentTypeImage: ChatMessageContentType;
 export declare const ChatMessageContentTypeFile: ChatMessageContentType;
 export declare const ChatMessageContentTypeTool: ChatMessageContentType;
+export declare const ChatMessageContentTypeEvent: ChatMessageContentType;
 export type ChannelType = "slack" | "discord" | "teams" | "telegram";
 export declare const ChannelTypeSlack: ChannelType;
 export declare const ChannelTypeDiscord: ChannelType;
@@ -4328,6 +4336,34 @@ export interface ChatMessageContent {
     image?: string;
     file?: string;
     tool_calls?: ToolCall[];
+    event?: ChatEvent;
+}
+export type ChatEventType = "hook";
+export declare const ChatEventTypeHook: ChatEventType;
+/**
+ * ChatEvent is the payload of an event-role message: system info shown in the
+ * chat but never sent to the model.
+ */
+export interface ChatEvent {
+    type: ChatEventType;
+    hook?: ChatHookEvent;
+}
+/**
+ * ChatHookEvent records one lifecycle hook handler run.
+ */
+export interface ChatHookEvent {
+    event: HookEvent;
+    handler_type: HookHandlerType;
+    /**
+     * Handler names what ran: the builtin or agent ref, or a webhook's host
+     * (never its full URL, which can carry credentials).
+     */
+    handler: string;
+    decision?: HookDecision;
+    reason?: string;
+    injected?: boolean;
+    error?: string;
+    duration_ms: number;
 }
 /**
  * ChannelContext records which channel a chat or message came through

package/dist/types.js

@@ -575,10 +575,12 @@ export const ChatMessageRoleTool = "tool";
 /**
  * Internal bookkeeping roles — never sent to the LLM provider.
  * BuildContext folds injections into the user turn and replaces
- * compaction markers with their summary.
+ * compaction markers with their summary. Event messages are display-only
+ * system info (a hook ran, ...) and BuildContext skips them.
  */
 export const ChatMessageRoleInjection = "injection";
 export const ChatMessageRoleCompaction = "compaction";
+export const ChatMessageRoleEvent = "event";
 export const ChatMessageStatusPending = "pending";
 export const ChatMessageStatusQueued = "queued";
 export const ChatMessageStatusReady = "ready";
@@ -589,10 +591,12 @@ export const ChatMessageContentTypeReasoning = "reasoning";
 export const ChatMessageContentTypeImage = "image";
 export const ChatMessageContentTypeFile = "file";
 export const ChatMessageContentTypeTool = "tool";
+export const ChatMessageContentTypeEvent = "event";
 export const ChannelTypeSlack = "slack";
 export const ChannelTypeDiscord = "discord";
 export const ChannelTypeTeams = "teams";
 export const ChannelTypeTelegram = "telegram";
+export const ChatEventTypeHook = "hook";
 export const EngineStatusRunning = "running";
 export const EngineStatusPending = "pending";
 export const EngineStatusDraining = "draining";

package/package.json

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