@inferencesh/sdk 0.10.1 → 0.11.0

package/dist/types.js

@@ -79,6 +79,12 @@ export const ScopeTeams = "teams";
  * Empty scopes = full access (for backwards compatibility with existing keys).
  */
 export const ScopeBilling = "billing";
+/**
+ * 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 ScopeArtifacts = "artifacts";
 /**
  * Action-level scopes for Agents
  */
@@ -218,6 +224,16 @@ export const ScopeEnginesRead = "engines:read";
  * Empty scopes = full access (for backwards compatibility with existing keys).
  */
 export const ScopeEnginesWrite = "engines:write";
+/**
+ * Action-level scopes for Remotes
+ */
+export const ScopeRemotesRead = "remotes: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 ScopeRemotesWrite = "remotes:write";
 /**
  * Action-level scopes for API Keys
  */
@@ -241,12 +257,6 @@ export const ScopeKnowledgeWrite = "knowledge:write";
 /**
  * Action-level scopes for Artifacts (published HTML/Markdown pages)
  */
-export const ScopeArtifacts = "artifacts";
-/**
- * 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 ScopeArtifactsRead = "artifacts:read";
 /**
  * API Key Scopes - hierarchical permission system.
@@ -286,11 +296,60 @@ export const ScopeGroupBilling = "billing";
 export const ScopeGroupSecrets = "secrets";
 export const ScopeGroupCredentials = "credentials";
 export const ScopeGroupEngines = "engines";
+export const ScopeGroupRemotes = "remotes";
 export const ScopeGroupApiKeys = "apikeys";
 export const ScopeGroupKnowledge = "knowledge";
 export const ScopeGroupArtifacts = "artifacts";
 export const ScopeGroupUser = "user";
 export const ScopeGroupSettings = "settings";
+export const ErrorCodeInvalidRequest = "invalid_request";
+export const ErrorCodeValidationError = "validation_error";
+export const ErrorCodeUnauthorized = "unauthorized";
+export const ErrorCodeForbidden = "forbidden";
+export const ErrorCodeNotFound = "not_found";
+export const ErrorCodeConflict = "conflict";
+export const ErrorCodeNameConflict = "name_conflict";
+export const ErrorCodeAlreadyExists = "already_exists";
+export const ErrorCodeNotConfigured = "not_configured";
+export const ErrorCodeMethodNotAllowed = "method_not_allowed";
+export const ErrorCodeRateLimited = "rate_limited";
+export const ErrorCodeInternalError = "internal_error";
+/**
+ * ErrorCodeTeamRoleRequired: the caller's team role or org-admin status
+ * does not allow the action. Meta is TeamRoleRequiredMeta when a
+ * capability gate refused it.
+ */
+export const ErrorCodeTeamRoleRequired = "team_role_required";
+/**
+ * ErrorCodeBlockedByUsagePolicy: the resource is outside the team or org
+ * usage policy. The message names who to ask.
+ */
+export const ErrorCodeBlockedByUsagePolicy = "blocked_by_usage_policy";
+export const ErrorCodeOTPRequired = "otp_required";
+export const ErrorCodeMCPAuthExpired = "mcp_auth_expired";
+/**
+ * Entitlements. LimitExceeded (402) and FeatureNotAvailable (403) carry
+ * EntitlementErrorMeta. EntitlementUnavailable (500) means the plan could
+ * not be checked and the request is retriable.
+ */
+export const ErrorCodeLimitExceeded = "limit_exceeded";
+export const ErrorCodeFeatureNotAvailable = "feature_not_available";
+export const ErrorCodeEntitlementUnavailable = "entitlement_unavailable";
+export const ErrorCodePaymentRequired = "payment_required";
+/**
+ * ErrorCodePaymentMethodRequired (402): a bounty program requires a saved
+ * payment method and the caller's team has none. Meta is
+ * PaymentMethodRequiredMeta; clients send the user to BillingPage.
+ */
+export const ErrorCodePaymentMethodRequired = "payment_method_required";
+/**
+ * Remote harness refusals.
+ */
+export const ErrorCodeAgentsDisabled = "agents_disabled";
+export const ErrorCodeRemoteOffline = "remote_offline";
+export const ErrorCodeRemoteTimeout = "remote_timeout";
+export const ErrorCodeHarnessNotDrivable = "harness_not_drivable";
+export const ErrorCodeHarnessTooOld = "harness_too_old";
 /**
  * Flow graph action type constants.
  */
@@ -510,7 +569,8 @@ 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.
+ * BuildContext folds injections into the user turn and replaces
+ * compaction markers with their summary.
  */
 export const ChatMessageRoleInjection = "injection";
 export const ChatMessageRoleCompaction = "compaction";
@@ -1004,6 +1064,26 @@ export const TeamStatusTerminated = "terminated";
 export const TeamRoleOwner = "owner";
 export const TeamRoleAdmin = "admin";
 export const TeamRoleMember = "member";
+export const TeamCapabilityEditProfile = "edit_profile";
+export const TeamCapabilityManageMembers = "manage_members";
+export const TeamCapabilityViewMembers = "view_members";
+export const TeamCapabilityManageKeys = "manage_keys";
+export const TeamCapabilityManageVault = "manage_vault";
+export const TeamCapabilityViewBilling = "view_billing";
+export const TeamCapabilityManageBilling = "manage_billing";
+export const TeamCapabilityViewPolicy = "view_policy";
+export const TeamCapabilityManagePolicy = "manage_policy";
+export const TeamCapabilityManageOrg = "manage_org";
+export const TeamCapabilityManageSSO = "manage_sso";
+export const TeamCapabilityArchive = "archive";
+export const TeamCapabilityCreateTeam = "create_team";
+export const TeamCapabilityCreateOrg = "create_org";
+/**
+ * Connecting a credential the whole org, or the whole platform, resolves.
+ * The workspace level is manage_vault.
+ */
+export const TeamCapabilityConnectOrgCredential = "connect_org_credential";
+export const TeamCapabilityConnectPlatformCredential = "connect_platform_credential";
 export const RoleGuest = "guest";
 export const RoleUser = "user";
 export const RoleAdmin = "admin";
@@ -1094,6 +1174,8 @@ export const HookDecisionSuspend = "suspend";
 export const HookHandlerWebhook = "webhook";
 export const HookHandlerTask = "task";
 export const HookHandlerGate = "gate";
+export const HookHandlerBuiltin = "builtin";
+export const BuiltinHookBeltSuggest = "belt:suggest";
 export const ToolInvocationStatusPending = "pending";
 export const ToolInvocationStatusInProgress = "in_progress";
 export const ToolInvocationStatusAwaitingInput = "awaiting_input";
@@ -1109,6 +1191,7 @@ export const ToolTypeCall = "call";
 export const ToolTypeMCP = "mcp";
 export const ToolTypeClient = "client";
 export const ToolTypeInternal = "internal";
+export const ToolTypeHarness = "harness";
 /**
  * Tool call types
  */

package/dist/utils.d.ts

@@ -3,7 +3,7 @@
  * Provides future compatibility when API migrates from int to string status.
  */
 import { TaskStatus } from './types';
-import type { ChatDTO } from './types';
+import type { AgentRunState, ChatDTO, ChatMessageStatus } from './types';
 /**
  * Parse task status from int or string to TaskStatus number.
  * Handles both current int-based API and future string-based API.
@@ -14,7 +14,18 @@ export declare function parseStatus(status: number | string | undefined | null):
  * Handles both int and string status values.
  */
 export declare function isTerminalStatus(status: number | string | undefined | null): boolean;
+export declare function isRunTerminal(state: AgentRunState | null | undefined): boolean;
+/** Parked on a human: a tool approval or input (input_required) or an authorization (auth_required). */
+export declare function isRunInterrupted(state: AgentRunState | null | undefined): boolean;
+/** The run produces no further events this turn: terminal or interrupted. */
+export declare function isRunSettled(state: AgentRunState | null | undefined): boolean;
+/** The run is executing: submitted or working. */
+export declare function isRunWorking(state: AgentRunState | null | undefined): boolean;
+export declare function isMessageTerminal(status: ChatMessageStatus | null | undefined): boolean;
+/** The turn is still open: the run is working or parked on a human (approval, input, authorization). */
 export declare function isChatBusy(chat: ChatDTO | null | undefined): boolean;
+/** The chat is blocked on a human: nothing more arrives until someone approves, answers or authorizes. */
+export declare function isAwaitingHuman(chat: ChatDTO | null | undefined): boolean;
 /** A tool invocation gated on human approval, projected from the chat's pending interrupts. */
 export type PendingApproval = {
     interruptId: string;

package/dist/utils.js

@@ -3,7 +3,7 @@
  * Provides future compatibility when API migrates from int to string status.
  */
 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';
+import { TaskStatusUnknown, TaskStatusReceived, TaskStatusQueued, TaskStatusDispatched, TaskStatusPreparing, TaskStatusServing, TaskStatusSettingUp, TaskStatusRunning, TaskStatusCancelling, TaskStatusUploading, TaskStatusCompleted, TaskStatusFailed, TaskStatusCancelled, AgentRunStateWorking, AgentRunStateSubmitted, AgentRunStateInputRequired, AgentRunStateAuthRequired, AgentRunStateCompleted, AgentRunStateFailed, AgentRunStateCanceled, AgentRunStateRejected, ChatMessageStatusReady, ChatMessageStatusFailed, ChatMessageStatusCancelled, ChatStatusBusy, ChatStatusAwaitingInput, } from './types';
 /** Map string status names to TaskStatus values (for future string-based API) */
 const STATUS_STRING_MAP = {
     unknown: TaskStatusUnknown,
@@ -44,13 +44,41 @@ export function isTerminalStatus(status) {
     const parsed = parseStatus(status);
     return parsed === TaskStatusCompleted || parsed === TaskStatusFailed || parsed === TaskStatusCancelled;
 }
+// Run and message state predicates. Ports of the Go methods AgentRunState.IsTerminal/
+// IsInterrupted/IsSettled and ChatMessageStatus.IsTerminal; every consumer uses these.
+export function isRunTerminal(state) {
+    return state === AgentRunStateCompleted || state === AgentRunStateFailed || state === AgentRunStateCanceled || state === AgentRunStateRejected;
+}
+/** Parked on a human: a tool approval or input (input_required) or an authorization (auth_required). */
+export function isRunInterrupted(state) {
+    return state === AgentRunStateInputRequired || state === AgentRunStateAuthRequired;
+}
+/** The run produces no further events this turn: terminal or interrupted. */
+export function isRunSettled(state) {
+    return isRunTerminal(state) || isRunInterrupted(state);
+}
+/** The run is executing: submitted or working. */
+export function isRunWorking(state) {
+    return state === AgentRunStateWorking || state === AgentRunStateSubmitted;
+}
+export function isMessageTerminal(status) {
+    return status === ChatMessageStatusReady || status === ChatMessageStatusFailed || status === ChatMessageStatusCancelled;
+}
+/** The turn is still open: the run is working or parked on a human (approval, input, authorization). */
 export function isChatBusy(chat) {
     const run = chat?.active_run;
     if (run) {
-        return run.state === AgentRunStateWorking || run.state === AgentRunStateSubmitted || run.state === AgentRunStateInputRequired;
+        return isRunWorking(run.state) || isRunInterrupted(run.state);
     }
     return chat?.status === ChatStatusBusy || chat?.status === ChatStatusAwaitingInput;
 }
+/** The chat is blocked on a human: nothing more arrives until someone approves, answers or authorizes. */
+export function isAwaitingHuman(chat) {
+    const run = chat?.active_run;
+    if (run)
+        return isRunInterrupted(run.state);
+    return chat?.status === ChatStatusAwaitingInput;
+}
 function parseApprovalMeta(interrupt) {
     const meta = interrupt.meta;
     if (!meta)

package/package.json

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