@inferencesh/sdk 0.6.29 → 0.6.47

package/dist/types.js

@@ -211,6 +211,16 @@ export const ScopeApiKeysRead = "apikeys:read";
  * Empty scopes = full access (for backwards compatibility with existing keys).
  */
 export const ScopeApiKeysWrite = "apikeys:write";
+/**
+ * Action-level scopes for Knowledge (includes skills)
+ */
+export const ScopeKnowledgeRead = "knowledge:read";
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export const ScopeKnowledgeWrite = "knowledge:write";
 /**
  * Action-level scopes for User profile
  */
@@ -244,8 +254,111 @@ export const ScopeGroupSecrets = "secrets";
 export const ScopeGroupIntegrations = "integrations";
 export const ScopeGroupEngines = "engines";
 export const ScopeGroupApiKeys = "apikeys";
+export const ScopeGroupKnowledge = "knowledge";
 export const ScopeGroupUser = "user";
 export const ScopeGroupSettings = "settings";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeAdd = "node.add";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeRemove = "node.remove";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeMove = "node.move";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeMoveMany = "node.move_many";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeDuplicate = "node.duplicate";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeRename = "node.rename";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeSetApp = "node.set_app";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeUpdate = "node.update";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeSetInput = "node.set_input";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionNodeClearInput = "node.clear_input";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionEdgeAdd = "edge.add";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionEdgeRemove = "edge.remove";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionFlowSetInputSchema = "flow.set_input_schema";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionFlowSetOutputSchema = "flow.set_output_schema";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionFlowSetOutputMapping = "flow.set_output_mapping";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionFlowRemoveOutputMapping = "flow.remove_output_mapping";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionFlowRenameOutputField = "flow.rename_output_field";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionUndo = "undo";
+/**
+ * Flow graph action type constants.
+ */
+export const ActionRedo = "redo";
+export const ElicitActionAccept = "accept";
+export const ElicitActionDecline = "decline";
+export const ElicitActionCancel = "cancel";
+/**
+ * ResultTypeComplete marks an ordinary, finished result.
+ */
+export const ResultTypeComplete = "complete";
+/**
+ * ResultTypeInputRequired marks a Multi Round-Trip Request interim result.
+ * Recognised so the outbound client never mistakes one for tool output.
+ */
+export const ResultTypeInputRequired = "input_required";
+/**
+ * CacheScopePublic marks a response as free of user-specific data, so any
+ * client or shared intermediary may cache it across authorization contexts.
+ */
+export const CacheScopePublic = "public";
+/**
+ * CacheScopePrivate restricts reuse to the same authorization context.
+ */
+export const CacheScopePrivate = "private";
+export const ToolContentTypeText = "text";
+export const ToolContentTypeImage = "image";
+export const ToolContentTypeAudio = "audio";
+export const ToolContentTypeResourceLink = "resource_link";
+export const ToolContentTypeResource = "resource";
 /**
  * Requirement error types
  */
@@ -261,6 +374,72 @@ export const RequirementTypeScope = "scope";
 export const SetupActionAddSecret = "add_secret";
 export const SetupActionConnect = "connect";
 export const SetupActionAddScopes = "add_scopes";
+export const A2UIRow = "Row";
+export const A2UIColumn = "Column";
+export const A2UIList = "List";
+export const A2UIText = "Text";
+export const A2UIImage = "Image";
+export const A2UIIcon = "Icon";
+export const A2UIDivider = "Divider";
+export const A2UIButton = "Button";
+export const A2UITextField = "TextField";
+export const A2UICheckBox = "CheckBox";
+export const A2UISlider = "Slider";
+export const A2UIDateTimeInput = "DateTimeInput";
+export const A2UIChoicePicker = "ChoicePicker";
+export const A2UICard = "Card";
+export const A2UIModal = "Modal";
+export const A2UITabs = "Tabs";
+/**
+ * Extensions (inferencesh/v1 catalog)
+ */
+export const A2UIBadge = "Badge";
+export const A2UISpacer = "Spacer";
+export const A2UIChart = "Chart";
+export const A2UIForm = "Form";
+/**
+ * Run lifecycle
+ */
+export const AgentEventRunStarted = "run.started";
+export const AgentEventRunStateChanged = "run.state_changed";
+/**
+ * Turn lifecycle
+ */
+export const AgentEventTurnStarted = "turn.started";
+export const AgentEventTurnCompleted = "turn.completed";
+/**
+ * Content streaming — structural wrapper; high-frequency token deltas
+ * still flow via the existing DeltaEvent channel for efficiency.
+ */
+export const AgentEventContentDelta = "content.delta";
+/**
+ * Tool lifecycle
+ */
+export const AgentEventToolStarted = "tool.started";
+export const AgentEventToolCompleted = "tool.completed";
+/**
+ * Approval flow
+ */
+export const AgentEventApprovalRequired = "approval.required";
+export const AgentEventApprovalResolved = "approval.resolved";
+/**
+ * Hook lifecycle
+ */
+export const AgentEventHookExecuted = "hook.executed";
+/**
+ * Usage
+ */
+export const AgentEventUsageUpdated = "usage.updated";
+/**
+ * Context management
+ */
+export const AgentEventContextCompacted = "context.compacted";
+/**
+ * Errors
+ */
+export const AgentEventError = "error";
+export const ContentDeltaText = "text";
+export const ContentDeltaReasoning = "reasoning";
 export const AgentRunStateSubmitted = "submitted";
 export const AgentRunStateWorking = "working";
 export const AgentRunStateInputRequired = "input_required";
@@ -274,6 +453,7 @@ export const InterruptReasonClientTool = "client_tool";
 export const InterruptReasonWidget = "widget";
 export const InterruptReasonAuth = "auth";
 export const InterruptReasonConfirmation = "confirmation";
+export const InterruptReasonHookGate = "hook_gate";
 export const AppCategoryImage = "image";
 export const AppCategoryVideo = "video";
 export const AppCategoryAudio = "audio";
@@ -293,8 +473,11 @@ export const GPUTypeNvidia = "nvidia";
 export const GPUTypeAMD = "amd";
 export const GPUTypeApple = "apple";
 export const VisibilityPrivate = "private";
+export const VisibilityTeam = "team";
 export const VisibilityPublic = "public";
 export const VisibilityUnlisted = "unlisted";
+export const PermRead = "read";
+export const PermWrite = "write";
 export const SubscriptionStatusTrialing = "trialing";
 export const SubscriptionStatusActive = "active";
 export const SubscriptionStatusPastDue = "past_due";
@@ -321,11 +504,21 @@ export const PlanStepStatusPending = "pending";
 export const PlanStepStatusInProgress = "in_progress";
 export const PlanStepStatusCompleted = "completed";
 export const PlanStepStatusCancelled = "cancelled";
+/**
+ * LLM wire-protocol roles
+ */
 export const ChatMessageRoleSystem = "system";
 export const ChatMessageRoleUser = "user";
 export const ChatMessageRoleAssistant = "assistant";
 export const ChatMessageRoleTool = "tool";
+/**
+ * Internal bookkeeping roles — never sent to the LLM provider.
+ * BuildContext converts these to system messages or skips them.
+ */
+export const ChatMessageRoleInjection = "injection";
+export const ChatMessageRoleCompaction = "compaction";
 export const ChatMessageStatusPending = "pending";
+export const ChatMessageStatusQueued = "queued";
 export const ChatMessageStatusReady = "ready";
 export const ChatMessageStatusFailed = "failed";
 export const ChatMessageStatusCancelled = "cancelled";
@@ -387,6 +580,57 @@ export const GraphEdgeTypeReferences = "references";
 export const GraphEdgeTypeSupersedes = "supersedes";
 export const GraphEdgeTypeInput = "input";
 export const GraphEdgeTypeOutput = "output";
+export const InterruptStatusPending = "pending";
+export const InterruptStatusResolved = "resolved";
+export const InterruptStatusExpired = "expired";
+export const InterruptStatusCancelled = "cancelled";
+export const InterruptResolutionAllow = "allow";
+export const InterruptResolutionDeny = "deny";
+export const InterruptResourceToolInvocation = "tool_invocation";
+export const InterruptResourceHookEvent = "hook_event";
+export const HookEventAgentStart = "agent.start";
+export const HookEventTurnStart = "agent.turn_start";
+export const HookEventToolCall = "agent.tool_call";
+export const HookEventToolResult = "agent.tool_result";
+export const HookEventTurnComplete = "agent.turn_complete";
+export const HookEventAgentError = "agent.error";
+export const HookEventAgentComplete = "agent.complete";
+export const HookEventAgentIdle = "agent.idle";
+export const HookEventPreCompact = "agent.pre_compact";
+export const HookEventPostCompact = "agent.post_compact";
+export const HookDecisionAllow = "allow";
+export const HookDecisionDeny = "deny";
+export const HookDecisionStop = "stop";
+export const HookDecisionSuspend = "suspend";
+export const HookHandlerWebhook = "webhook";
+export const HookHandlerTask = "task";
+export const HookHandlerGate = "gate";
+export const MergeStrategyConcat = "concat";
+export const MergeStrategyReplace = "replace";
+export const MergeStrategyIndexed = "indexed";
+export const MergeStrategyNested = "nested";
+export const LLMDelta_fieldTags = {
+    response: { merge: "concat" },
+    reasoning: { merge: "concat" },
+    tool_calls: { merge: "indexed" },
+    usage: { merge: "replace" },
+};
+export const ToolCallDelta_fieldTags = {
+    id: { merge: "replace" },
+    type: { merge: "replace" },
+    function: { merge: "nested" },
+};
+export const ToolCallFunctionDelta_fieldTags = {
+    name: { merge: "replace" },
+    arguments: { merge: "concat" },
+};
+export const ToolChoiceModeNone = "none";
+export const ToolChoiceModeAuto = "auto";
+export const ToolChoiceModeRequired = "required";
+export const ToolChoiceModeFunction = "function";
+export const ResponseFormatTypeText = "text";
+export const ResponseFormatTypeJSONObject = "json_object";
+export const ResponseFormatTypeJSONSchema = "json_schema";
 /**
  * SecretScopeTeam is a normal user secret, visible in team secret lists
  */
@@ -407,6 +651,7 @@ export const PageStatusScheduled = 4;
 export const PageTypeDoc = "doc";
 export const PageTypeBlog = "blog";
 export const PageTypePage = "page";
+export const PageTypeAnnouncement = "announcement";
 export const ToolInvocationStatusPending = "pending";
 export const ToolInvocationStatusInProgress = "in_progress";
 export const ToolInvocationStatusAwaitingInput = "awaiting_input";
@@ -501,6 +746,8 @@ export const KnowledgeTypeProject = "project";
 export const KnowledgeTypeAgentConfig = "agent-config";
 export const KnowledgeLifecyclePermanent = "permanent";
 export const KnowledgeLifecycleDecay = "decay";
+export const KnowledgeLifecycleDraft = "draft";
+export const KnowledgeLifecycleDeprecated = "deprecated";
 export const OpEqual = "eq";
 export const OpNotEqual = "neq";
 export const OpIn = "in";
@@ -594,40 +841,18 @@ export const IntegrationStatusConnected = "connected";
 export const IntegrationStatusDisconnected = "disconnected";
 export const IntegrationStatusExpired = "expired";
 export const IntegrationStatusError = "error";
+export const IntegrationScopeTeam = "team";
+export const IntegrationScopePlatform = "platform";
+export const IntegrationScopeUser = "user";
 /**
- * IntegrationScopeTeam is owned by a user/team (BYOK credentials, user connections)
+ * IntegrationGrantCredentials provides OAuth app credentials (client_id/secret).
+ * Users connect their own accounts against it. Only valid for type=oauth.
  */
-export const IntegrationScopeTeam = "team";
+export const IntegrationGrantCredentials = "credentials";
 /**
- * IntegrationScopePlatform is owned by the platform (managed credentials, admin-configured)
+ * IntegrationGrantToken provides ready-to-use access (token, API key, etc.).
  */
-export const IntegrationScopePlatform = "platform";
-export const WidgetNodeTypeText = "text";
-export const WidgetNodeTypeMarkdown = "markdown";
-export const WidgetNodeTypeImage = "image";
-export const WidgetNodeTypeBadge = "badge";
-export const WidgetNodeTypeButton = "button";
-export const WidgetNodeTypeInput = "input";
-export const WidgetNodeTypeSelect = "select";
-export const WidgetNodeTypeCheckbox = "checkbox";
-export const WidgetNodeTypeRow = "row";
-export const WidgetNodeTypeCol = "col";
-export const WidgetNodeTypeBox = "box";
-export const WidgetNodeTypeSpacer = "spacer";
-export const WidgetNodeTypeDivider = "divider";
-export const WidgetNodeTypeForm = "form";
-export const WidgetNodeTypeTitle = "title";
-export const WidgetNodeTypeCaption = "caption";
-export const WidgetNodeTypeLabel = "label";
-export const WidgetNodeTypeTextarea = "textarea";
-export const WidgetNodeTypeRadioGroup = "radio-group";
-export const WidgetNodeTypeDatePicker = "date-picker";
-export const WidgetNodeTypeIcon = "icon";
-export const WidgetNodeTypeChart = "chart";
-export const WidgetNodeTypeTransition = "transition";
-export const WidgetNodeTypePlanList = "plan-list";
-export const WidgetNodeTypeKeyValue = "key-value";
-export const WidgetNodeTypeStatusBadge = "status-badge";
+export const IntegrationGrantToken = "token";
 export const NotificationChannelEmail = "email";
 export const NotificationChannelSMS = "sms";
 export const NotificationChannelPush = "push";
@@ -649,6 +874,7 @@ export const NotificationTypeInvoice = "invoice";
 export const NotificationTypeSubscriptionCreated = "subscription_created";
 export const NotificationTypeSubscriptionCredit = "subscription_credit";
 export const NotificationTypeSubscriptionCanceled = "subscription_canceled";
+export const NotificationTypeSubscriptionPaymentFailed = "subscription_payment_failed";
 export const NotificationTypeSubscriptionTrialEnding = "subscription_trial_ending";
 /**
  * Account notifications

package/dist/utils.d.ts

@@ -15,3 +15,16 @@ export declare function parseStatus(status: number | string | undefined | null):
  */
 export declare function isTerminalStatus(status: number | string | undefined | null): boolean;
 export declare function isChatBusy(chat: ChatDTO | null | undefined): boolean;
+/** A tool invocation gated on human approval, projected from the chat's pending interrupts. */
+export type PendingApproval = {
+    interruptId: string;
+    toolInvocationId: string;
+    chatId: string;
+    toolName: string;
+    arguments: Record<string, unknown>;
+};
+/**
+ * Tool approvals the chat is currently waiting on. Reads `chat.pending_interrupts`,
+ * which the API projects onto the chat, so no message scan is needed.
+ */
+export declare function pendingApprovals(chat: ChatDTO | null | undefined): PendingApproval[];

package/dist/utils.js

@@ -2,7 +2,8 @@
  * Status utilities for handling both int and string-based status values.
  * Provides future compatibility when API migrates from int to string status.
  */
-import { TaskStatusUnknown, TaskStatusReceived, TaskStatusQueued, TaskStatusDispatched, TaskStatusPreparing, TaskStatusServing, TaskStatusSettingUp, TaskStatusRunning, TaskStatusCancelling, TaskStatusUploading, TaskStatusCompleted, TaskStatusFailed, TaskStatusCancelled, AgentRunStateWorking, AgentRunStateSubmitted, } from './types';
+import { InterruptReasonToolApproval, InterruptStatusPending } from './types';
+import { TaskStatusUnknown, TaskStatusReceived, TaskStatusQueued, TaskStatusDispatched, TaskStatusPreparing, TaskStatusServing, TaskStatusSettingUp, TaskStatusRunning, TaskStatusCancelling, TaskStatusUploading, TaskStatusCompleted, TaskStatusFailed, TaskStatusCancelled, AgentRunStateWorking, AgentRunStateSubmitted, AgentRunStateInputRequired, ChatStatusBusy, ChatStatusAwaitingInput, } from './types';
 /** Map string status names to TaskStatus values (for future string-based API) */
 const STATUS_STRING_MAP = {
     unknown: TaskStatusUnknown,
@@ -44,6 +45,45 @@ export function isTerminalStatus(status) {
     return parsed === TaskStatusCompleted || parsed === TaskStatusFailed || parsed === TaskStatusCancelled;
 }
 export function isChatBusy(chat) {
-    const state = chat?.active_run?.state;
-    return state === AgentRunStateWorking || state === AgentRunStateSubmitted;
+    const run = chat?.active_run;
+    if (run) {
+        return run.state === AgentRunStateWorking || run.state === AgentRunStateSubmitted || run.state === AgentRunStateInputRequired;
+    }
+    return chat?.status === ChatStatusBusy || chat?.status === ChatStatusAwaitingInput;
+}
+function parseApprovalMeta(interrupt) {
+    const meta = interrupt.meta;
+    if (!meta)
+        return {};
+    if (typeof meta === 'string') {
+        try {
+            return JSON.parse(meta);
+        }
+        catch {
+            return {};
+        }
+    }
+    return meta;
+}
+/**
+ * Tool approvals the chat is currently waiting on. Reads `chat.pending_interrupts`,
+ * which the API projects onto the chat, so no message scan is needed.
+ */
+export function pendingApprovals(chat) {
+    const interrupts = chat?.pending_interrupts ?? [];
+    const out = [];
+    for (const interrupt of interrupts) {
+        if (interrupt.reason !== InterruptReasonToolApproval || interrupt.status !== InterruptStatusPending) {
+            continue;
+        }
+        const meta = parseApprovalMeta(interrupt);
+        out.push({
+            interruptId: interrupt.id,
+            toolInvocationId: interrupt.resource_id ?? meta.tool_invocation_id ?? '',
+            chatId: interrupt.chat_id || chat?.id || '',
+            toolName: meta.tool_name ?? '',
+            arguments: meta.arguments ?? {},
+        });
+    }
+    return out;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inferencesh/sdk",
-  "version": "0.6.29",
+  "version": "0.6.47",
   "description": "Official JavaScript/TypeScript SDK for inference.sh - Run AI models with a simple API",
   "type": "module",
   "main": "dist/index.js",
@@ -29,6 +29,7 @@
     },
     "./proxy/remix": {
       "types": "./dist/proxy/remix.d.ts",
+      "inference-src": "./src/proxy/remix.ts",
       "default": "./dist/proxy/remix.js"
     },
     "./proxy/svelte": {
@@ -53,8 +54,8 @@
     "test:all": "jest --testTimeout=120000 --runInBand",
     "test:watch": "jest --watch --testPathIgnorePatterns=/integration\\.test\\.ts$ --testPathIgnorePatterns=\\.integration\\.test\\.ts$",
     "test:coverage": "jest --coverage --testPathIgnorePatterns=/integration\\.test\\.ts$ --testPathIgnorePatterns=\\.integration\\.test\\.ts$",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
     "format": "prettier --write \"src/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\"",
     "clean": "rimraf dist coverage",
@@ -94,21 +95,23 @@
   },
   "devDependencies": {
     "@sveltejs/kit": "^2.60.1",
-    "svelte": "^5.55.7",
     "@types/express": "^5.0.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^26.1.1",
     "@types/react": "^19.1.12",
+    "@eslint/js": "^9.39.5",
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.65.0",
     "eslint": "^9.32.0",
     "eslint-config-prettier": "^10.1.8",
-    "hono": "^4.0.0",
+    "globals": "^16.5.0",
+    "hono": "^4.13.1",
     "jest": "^30.4.2",
     "next": "^16.2.6",
     "prettier": "^3.6.2",
     "react": "^19.2.3",
     "rimraf": "^6.0.1",
+    "svelte": "^5.55.7",
     "ts-jest": "^29.2.5",
     "typescript": "~6.0.3"
   },