@inferencesh/sdk 0.10.0 → 0.11.0

package/dist/types.d.ts

@@ -103,7 +103,7 @@ export interface ClientToolConfig {
 /**
  * ToolAuthType says how an HTTP tool authenticates.
  */
-export type ToolAuthType = string;
+export type ToolAuthType = "none" | "credential" | "api_key" | "bearer";
 /**
  * ToolAuthTypeNone sends no credentials (same as leaving type empty).
  */
@@ -316,7 +316,7 @@ export interface APIResponse<T extends any> {
     error?: APIError;
 }
 export interface APIError {
-    code: string;
+    code: ErrorCode;
     message: string;
     suggestions?: string[];
     meta?: {
@@ -369,6 +369,10 @@ export interface ApiAgentRunRequest {
         [key: string]: string;
     };
     stream?: boolean;
+    /**
+     * ChannelContext is recorded on the chat the first time it is seen.
+     */
+    channel_context?: ChannelContext;
 }
 /**
  * CreateAgentMessageRequest is the request for creating agent messages.
@@ -675,7 +679,7 @@ export interface EstimateCostResponse {
 /**
  * Scope represents an API key permission scope string.
  */
-export type Scope = string;
+export type Scope = "*" | "agents" | "apps" | "conversations" | "files" | "datastores" | "templates" | "flows" | "projects" | "teams" | "billing" | "artifacts" | "agents:read" | "agents:write" | "agents:execute" | "apps:read" | "apps:write" | "apps:execute" | "conversations:read" | "conversations:write" | "files:read" | "files:write" | "datastores:read" | "datastores:write" | "flows:read" | "flows:write" | "flows:execute" | "projects:read" | "projects:write" | "teams:read" | "teams:write" | "billing:read" | "billing:write" | "secrets:read" | "secrets:write" | "credentials:read" | "credentials:write" | "engines:read" | "engines:write" | "remotes:read" | "remotes:write" | "apikeys:read" | "apikeys:write" | "knowledge:read" | "knowledge:write" | "artifacts:read" | "artifacts:write" | "user:read" | "user:write" | "settings:read" | "settings:write";
 /**
  * API Key Scopes - hierarchical permission system.
  * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
@@ -740,6 +744,12 @@ export declare const ScopeTeams: Scope;
  * Empty scopes = full access (for backwards compatibility with existing keys).
  */
 export declare const ScopeBilling: Scope;
+/**
+ * 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 declare const ScopeArtifacts: Scope;
 /**
  * Action-level scopes for Agents
  */
@@ -879,6 +889,16 @@ export declare const ScopeEnginesRead: Scope;
  * Empty scopes = full access (for backwards compatibility with existing keys).
  */
 export declare const ScopeEnginesWrite: Scope;
+/**
+ * Action-level scopes for Remotes
+ */
+export declare const ScopeRemotesRead: Scope;
+/**
+ * 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 declare const ScopeRemotesWrite: Scope;
 /**
  * Action-level scopes for API Keys
  */
@@ -902,12 +922,6 @@ export declare const ScopeKnowledgeWrite: Scope;
 /**
  * Action-level scopes for Artifacts (published HTML/Markdown pages)
  */
-export declare const ScopeArtifacts: Scope;
-/**
- * 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 declare const ScopeArtifactsRead: Scope;
 /**
  * API Key Scopes - hierarchical permission system.
@@ -938,7 +952,7 @@ export declare const ScopeSettingsWrite: Scope;
 /**
  * ScopeGroup identifies a category of scopes for UI grouping
  */
-export type ScopeGroup = string;
+export type ScopeGroup = "agents" | "apps" | "conversations" | "files" | "datastores" | "flows" | "projects" | "teams" | "billing" | "secrets" | "credentials" | "engines" | "remotes" | "apikeys" | "knowledge" | "artifacts" | "user" | "settings";
 export declare const ScopeGroupAgents: ScopeGroup;
 export declare const ScopeGroupApps: ScopeGroup;
 export declare const ScopeGroupConversations: ScopeGroup;
@@ -951,6 +965,7 @@ export declare const ScopeGroupBilling: ScopeGroup;
 export declare const ScopeGroupSecrets: ScopeGroup;
 export declare const ScopeGroupCredentials: ScopeGroup;
 export declare const ScopeGroupEngines: ScopeGroup;
+export declare const ScopeGroupRemotes: ScopeGroup;
 export declare const ScopeGroupApiKeys: ScopeGroup;
 export declare const ScopeGroupKnowledge: ScopeGroup;
 export declare const ScopeGroupArtifacts: ScopeGroup;
@@ -2019,6 +2034,80 @@ export interface EntitlementErrorMeta {
     addon_plan_name?: string;
     addon_plan_price?: number;
 }
+/**
+ * ErrorCode is the machine-readable error code of an API error: the last
+ * segment of the problem+json type URI (https://api.inference.sh/errors/<code>)
+ * and APIError.Code on the legacy envelope. Clients branch on these, so a
+ * code is a named const here, where it generates into models and the SDKs.
+ */
+export type ErrorCode = "invalid_request" | "validation_error" | "unauthorized" | "forbidden" | "not_found" | "conflict" | "name_conflict" | "already_exists" | "not_configured" | "method_not_allowed" | "rate_limited" | "internal_error" | "team_role_required" | "blocked_by_usage_policy" | "otp_required" | "mcp_auth_expired" | "limit_exceeded" | "feature_not_available" | "entitlement_unavailable" | "payment_required" | "payment_method_required" | "agents_disabled" | "remote_offline" | "remote_timeout" | "harness_not_drivable" | "harness_too_old";
+export declare const ErrorCodeInvalidRequest: ErrorCode;
+export declare const ErrorCodeValidationError: ErrorCode;
+export declare const ErrorCodeUnauthorized: ErrorCode;
+export declare const ErrorCodeForbidden: ErrorCode;
+export declare const ErrorCodeNotFound: ErrorCode;
+export declare const ErrorCodeConflict: ErrorCode;
+export declare const ErrorCodeNameConflict: ErrorCode;
+export declare const ErrorCodeAlreadyExists: ErrorCode;
+export declare const ErrorCodeNotConfigured: ErrorCode;
+export declare const ErrorCodeMethodNotAllowed: ErrorCode;
+export declare const ErrorCodeRateLimited: ErrorCode;
+export declare const ErrorCodeInternalError: ErrorCode;
+/**
+ * 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 declare const ErrorCodeTeamRoleRequired: ErrorCode;
+/**
+ * ErrorCodeBlockedByUsagePolicy: the resource is outside the team or org
+ * usage policy. The message names who to ask.
+ */
+export declare const ErrorCodeBlockedByUsagePolicy: ErrorCode;
+export declare const ErrorCodeOTPRequired: ErrorCode;
+export declare const ErrorCodeMCPAuthExpired: ErrorCode;
+/**
+ * Entitlements. LimitExceeded (402) and FeatureNotAvailable (403) carry
+ * EntitlementErrorMeta. EntitlementUnavailable (500) means the plan could
+ * not be checked and the request is retriable.
+ */
+export declare const ErrorCodeLimitExceeded: ErrorCode;
+export declare const ErrorCodeFeatureNotAvailable: ErrorCode;
+export declare const ErrorCodeEntitlementUnavailable: ErrorCode;
+export declare const ErrorCodePaymentRequired: ErrorCode;
+/**
+ * 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 declare const ErrorCodePaymentMethodRequired: ErrorCode;
+/**
+ * Remote harness refusals.
+ */
+export declare const ErrorCodeAgentsDisabled: ErrorCode;
+export declare const ErrorCodeRemoteOffline: ErrorCode;
+export declare const ErrorCodeRemoteTimeout: ErrorCode;
+export declare const ErrorCodeHarnessNotDrivable: ErrorCode;
+export declare const ErrorCodeHarnessTooOld: ErrorCode;
+/**
+ * TeamRoleRequiredMeta is the meta of a team_role_required error from a
+ * capability gate. Only Capability is always set: a team that does not
+ * resolve answers with the capability alone, so clients must not assume
+ * RequiredRole is present.
+ */
+export interface TeamRoleRequiredMeta {
+    capability: TeamCapability;
+    actual_role?: TeamRole;
+    required_role?: TeamRole;
+    requires_org_admin?: boolean;
+}
+/**
+ * PaymentMethodRequiredMeta is the meta of a payment_method_required error.
+ */
+export interface PaymentMethodRequiredMeta {
+    bounty_id: string;
+    billing_page: string;
+}
 /**
  * FileMetadata holds probed media metadata cached on File records.
  */
@@ -2152,7 +2241,7 @@ export interface FlowRunDTO extends BaseModelDTO, PermissionModelDTO {
 /**
  * FlowActionType is the string type for action constants.
  */
-export type FlowActionType = string;
+export type FlowActionType = "node.add" | "node.remove" | "node.move" | "node.move_many" | "node.duplicate" | "node.rename" | "node.set_app" | "node.update" | "node.set_input" | "node.clear_input" | "edge.add" | "edge.remove" | "flow.set_input_schema" | "flow.set_output_schema" | "flow.set_output_mapping" | "flow.remove_output_mapping" | "flow.rename_output_field" | "undo" | "redo";
 /**
  * Flow graph action type constants.
  */
@@ -2617,7 +2706,7 @@ export interface InputRequest {
 /**
  * ElicitAction is the user's response to an elicitation request.
  */
-export type ElicitAction = string;
+export type ElicitAction = "accept" | "decline" | "cancel";
 export declare const ElicitActionAccept: ElicitAction;
 export declare const ElicitActionDecline: ElicitAction;
 export declare const ElicitActionCancel: ElicitAction;
@@ -2634,7 +2723,7 @@ export interface ElicitResult {
  * ResultType is the kind of result a response carries, required on every result
  * from 2026-07-28 onward.
  */
-export type ResultType = string;
+export type ResultType = "complete" | "input_required";
 /**
  * ResultTypeComplete marks an ordinary, finished result.
  */
@@ -2648,7 +2737,7 @@ export declare const ResultTypeInputRequired: ResultType;
  * CacheScope says who may reuse a cached result, per MCP 2026-07-28 (SEP-2549).
  * Analogous to HTTP Cache-Control public/private; the spec defines exactly these.
  */
-export type CacheScope = string;
+export type CacheScope = "public" | "private";
 /**
  * CacheScopePublic marks a response as free of user-specific data, so any
  * client or shared intermediary may cache it across authorization contexts.
@@ -2733,7 +2822,7 @@ export interface ToolCallResponse {
 /**
  * ToolContentType is the kind of a content block. The spec defines exactly these.
  */
-export type ToolContentType = string;
+export type ToolContentType = "text" | "image" | "audio" | "resource_link" | "resource";
 export declare const ToolContentTypeText: ToolContentType;
 export declare const ToolContentTypeImage: ToolContentType;
 export declare const ToolContentTypeAudio: ToolContentType;
@@ -2777,6 +2866,11 @@ export interface MCPServerDTO {
     default_scopes: StringSlice;
     documentation_url: string;
     connection_status?: string;
+    /**
+     * ConnectionScope is who the caller's connection to this server belongs
+     * to (user, team, org, platform); empty when not connected.
+     */
+    connection_scope?: CredentialScope;
 }
 /**
  * NotificationDTO is the data transfer object
@@ -2967,7 +3061,7 @@ export interface PlanLimit {
  * PlanLimits maps entitlement resources to their limits
  */
 export type PlanLimits = {
-    [key: EntitlementResource]: PlanLimit;
+    [key in EntitlementResource]?: PlanLimit;
 };
 /**
  * PlanDTO for API responses
@@ -3188,7 +3282,7 @@ export interface SuggestResult {
 /**
  * RequirementType identifies the kind of missing requirement.
  */
-export type RequirementType = string;
+export type RequirementType = "secret" | "credential" | "scope";
 /**
  * Requirement error types
  */
@@ -3213,7 +3307,7 @@ export interface RequirementError {
 /**
  * SetupActionType identifies the kind of action needed to resolve a requirement.
  */
-export type SetupActionType = string;
+export type SetupActionType = "add_secret" | "connect" | "add_scopes";
 export declare const SetupActionAddSecret: SetupActionType;
 export declare const SetupActionConnect: SetupActionType;
 export declare const SetupActionAddScopes: SetupActionType;
@@ -3793,7 +3887,7 @@ export interface UserMetadataDTO {
  * Alias of shared.A2UISurface so the type generation pipeline picks it up.
  */
 export type Widget = A2UISurface;
-export type A2UIComponentType = string;
+export type A2UIComponentType = "Row" | "Column" | "List" | "Text" | "Image" | "Icon" | "Divider" | "Button" | "TextField" | "CheckBox" | "Slider" | "DateTimeInput" | "ChoicePicker" | "Card" | "Modal" | "Tabs" | "Badge" | "Spacer" | "Chart" | "Form" | "Artifact";
 export declare const A2UIRow: A2UIComponentType;
 export declare const A2UIColumn: A2UIComponentType;
 export declare const A2UIList: A2UIComponentType;
@@ -3966,7 +4060,7 @@ export interface A2UISurface {
     components: A2UIComponent[];
     dataModel?: any;
 }
-export type AppCategory = string;
+export type AppCategory = "image" | "video" | "audio" | "text" | "chat" | "3d" | "other" | "flow";
 export declare const AppCategoryImage: AppCategory;
 export declare const AppCategoryVideo: AppCategory;
 export declare const AppCategoryAudio: AppCategory;
@@ -3975,12 +4069,12 @@ export declare const AppCategoryChat: AppCategory;
 export declare const AppCategory3D: AppCategory;
 export declare const AppCategoryOther: AppCategory;
 export declare const AppCategoryFlow: AppCategory;
-export type AppStatus = string;
+export type AppStatus = "active" | "maintenance" | "deprecated" | "retired";
 export declare const AppStatusActive: AppStatus;
 export declare const AppStatusMaintenance: AppStatus;
 export declare const AppStatusDeprecated: AppStatus;
 export declare const AppStatusRetired: AppStatus;
-export type GPUType = string;
+export type GPUType = "any" | "none" | "intel" | "nvidia" | "amd" | "apple";
 export declare const GPUTypeAny: GPUType;
 export declare const GPUTypeNone: GPUType;
 export declare const GPUTypeIntel: GPUType;
@@ -3990,7 +4084,7 @@ export declare const GPUTypeApple: GPUType;
 /**
  * Visibility represents the visibility level of a resource
  */
-export type Visibility = string;
+export type Visibility = "private" | "team" | "org" | "public" | "unlisted";
 export declare const VisibilityPrivate: Visibility;
 export declare const VisibilityTeam: Visibility;
 /**
@@ -4003,7 +4097,7 @@ export declare const VisibilityUnlisted: Visibility;
 /**
  * Permission represents a permission level for access checks.
  */
-export type Permission = string;
+export type Permission = "read" | "write" | "use";
 export declare const PermRead: Permission;
 export declare const PermWrite: Permission;
 /**
@@ -4013,25 +4107,25 @@ export declare const PermWrite: Permission;
  * governed by their team/org usage policy (reach, INF-808).
  */
 export declare const PermUse: Permission;
-export type SubscriptionStatus = string;
+export type SubscriptionStatus = "trialing" | "active" | "past_due" | "canceled" | "paused";
 export declare const SubscriptionStatusTrialing: SubscriptionStatus;
 export declare const SubscriptionStatusActive: SubscriptionStatus;
 export declare const SubscriptionStatusPastDue: SubscriptionStatus;
 export declare const SubscriptionStatusCanceled: SubscriptionStatus;
 export declare const SubscriptionStatusPaused: SubscriptionStatus;
-export type SubscriptionInterval = string;
+export type SubscriptionInterval = "monthly" | "yearly";
 export declare const SubscriptionIntervalMonthly: SubscriptionInterval;
 export declare const SubscriptionIntervalYearly: SubscriptionInterval;
-export type PlanType = string;
+export type PlanType = "base" | "addon";
 export declare const PlanTypeBase: PlanType;
 export declare const PlanTypeAddon: PlanType;
-export type EntitlementSource = string;
+export type EntitlementSource = "tier" | "override" | "whitelist" | "trial" | "addon";
 export declare const EntitlementSourceTier: EntitlementSource;
 export declare const EntitlementSourceOverride: EntitlementSource;
 export declare const EntitlementSourceWhitelist: EntitlementSource;
 export declare const EntitlementSourceTrial: EntitlementSource;
 export declare const EntitlementSourceAddon: EntitlementSource;
-export type EntitlementType = string;
+export type EntitlementType = "boolean" | "limit";
 export declare const EntitlementTypeBoolean: EntitlementType;
 export declare const EntitlementTypeLimit: EntitlementType;
 /**
@@ -4040,24 +4134,24 @@ export declare const EntitlementTypeLimit: EntitlementType;
  * ownership pattern used across the codebase; resolution matches all scopes
  * visible from an AuthContext in one query and mergeEntitlements arbitrates.
  */
-export type EntitlementScope = string;
+export type EntitlementScope = "org" | "team" | "member";
 export declare const EntitlementScopeOrg: EntitlementScope;
 export declare const EntitlementScopeTeam: EntitlementScope;
 export declare const EntitlementScopeMember: EntitlementScope;
-export type EnforcementMode = string;
+export type EnforcementMode = "block" | "warn";
 export declare const EnforcementBlock: EnforcementMode;
 export declare const EnforcementWarn: EnforcementMode;
-export type ChatStatus = string;
+export type ChatStatus = "busy" | "idle" | "awaiting_input" | "completed";
 export declare const ChatStatusBusy: ChatStatus;
 export declare const ChatStatusIdle: ChatStatus;
 export declare const ChatStatusAwaitingInput: ChatStatus;
 export declare const ChatStatusCompleted: ChatStatus;
-export type PlanStepStatus = string;
+export type PlanStepStatus = "pending" | "in_progress" | "completed" | "cancelled";
 export declare const PlanStepStatusPending: PlanStepStatus;
 export declare const PlanStepStatusInProgress: PlanStepStatus;
 export declare const PlanStepStatusCompleted: PlanStepStatus;
 export declare const PlanStepStatusCancelled: PlanStepStatus;
-export type ChatMessageRole = string;
+export type ChatMessageRole = "system" | "user" | "assistant" | "tool" | "injection" | "compaction";
 /**
  * LLM wire-protocol roles
  */
@@ -4067,23 +4161,24 @@ export declare const ChatMessageRoleAssistant: ChatMessageRole;
 export declare const ChatMessageRoleTool: ChatMessageRole;
 /**
  * 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 declare const ChatMessageRoleInjection: ChatMessageRole;
 export declare const ChatMessageRoleCompaction: ChatMessageRole;
-export type ChatMessageStatus = string;
+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 = string;
+export type ChatMessageContentType = "text" | "reasoning" | "image" | "file" | "tool";
 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 type ChannelType = string;
+export type ChannelType = "slack" | "discord" | "teams" | "telegram";
 export declare const ChannelTypeSlack: ChannelType;
 export declare const ChannelTypeDiscord: ChannelType;
 export declare const ChannelTypeTeams: ChannelType;
@@ -4129,7 +4224,7 @@ export interface ChannelContext {
 /**
  * EngineStatus represents the status of an engine.
  */
-export type EngineStatus = string;
+export type EngineStatus = "running" | "pending" | "draining" | "disconnected" | "restarting" | "stopping" | "stopped";
 export declare const EngineStatusRunning: EngineStatus;
 export declare const EngineStatusPending: EngineStatus;
 export declare const EngineStatusDraining: EngineStatus;
@@ -4140,7 +4235,7 @@ export declare const EngineStatusStopped: EngineStatus;
 /**
  * WorkerStatus represents the status of a worker.
  */
-export type WorkerStatus = string;
+export type WorkerStatus = "reserved" | "busy" | "idle" | "inactive";
 export declare const WorkerStatusReserved: WorkerStatus;
 export declare const WorkerStatusBusy: WorkerStatus;
 export declare const WorkerStatusIdle: WorkerStatus;
@@ -4242,7 +4337,7 @@ export interface SelectorConfig {
     mode: string;
     index?: number;
 }
-export type GraphNodeType = string;
+export type GraphNodeType = "unknown" | "join" | "split" | "execution" | "resource" | "approval" | "conditional" | "flow_node" | "trigger" | "credential_requirement";
 export declare const GraphNodeTypeUnknown: GraphNodeType;
 export declare const GraphNodeTypeJoin: GraphNodeType;
 export declare const GraphNodeTypeSplit: GraphNodeType;
@@ -4256,7 +4351,7 @@ export declare const GraphNodeTypeCredentialRequirement: GraphNodeType;
 /**
  * GraphNodeStatus represents the status of a node
  */
-export type GraphNodeStatus = string;
+export type GraphNodeStatus = "pending" | "ready" | "running" | "completed" | "failed" | "cancelled" | "skipped" | "blocked";
 export declare const GraphNodeStatusPending: GraphNodeStatus;
 export declare const GraphNodeStatusReady: GraphNodeStatus;
 export declare const GraphNodeStatusRunning: GraphNodeStatus;
@@ -4268,14 +4363,14 @@ export declare const GraphNodeStatusBlocked: GraphNodeStatus;
 /**
  * ResourceType identifies what kind of resource a graph node represents.
  */
-export type ResourceType = string;
+export type ResourceType = "knowledge" | "app" | "agent";
 export declare const ResourceTypeKnowledge: ResourceType;
 export declare const ResourceTypeApp: ResourceType;
 export declare const ResourceTypeAgent: ResourceType;
 /**
  * GraphEdgeType defines the type of edge relationship
  */
-export type GraphEdgeType = string;
+export type GraphEdgeType = "dependency" | "flow" | "conditional" | "execution" | "parent" | "ancestor" | "duplicate" | "references" | "supersedes" | "input" | "output";
 export declare const GraphEdgeTypeDependency: GraphEdgeType;
 export declare const GraphEdgeTypeFlow: GraphEdgeType;
 export declare const GraphEdgeTypeConditional: GraphEdgeType;
@@ -4290,7 +4385,7 @@ export declare const GraphEdgeTypeOutput: GraphEdgeType;
 /**
  * MergeStrategy defines how a delta field should be merged by consumers.
  */
-export type MergeStrategy = string;
+export type MergeStrategy = "concat" | "replace" | "indexed" | "nested";
 export declare const MergeStrategyConcat: MergeStrategy;
 export declare const MergeStrategyReplace: MergeStrategy;
 export declare const MergeStrategyIndexed: MergeStrategy;
@@ -4375,7 +4470,7 @@ export declare const ToolCallFunctionDelta_fieldTags: {
 /**
  * ToolChoiceMode controls whether the model must call a tool this turn.
  */
-export type ToolChoiceMode = string;
+export type ToolChoiceMode = "none" | "auto" | "required" | "function";
 export declare const ToolChoiceModeNone: ToolChoiceMode;
 export declare const ToolChoiceModeAuto: ToolChoiceMode;
 export declare const ToolChoiceModeRequired: ToolChoiceMode;
@@ -4392,7 +4487,7 @@ export interface ToolChoice {
 /**
  * ResponseFormatType selects how the model's output is constrained.
  */
-export type ResponseFormatType = string;
+export type ResponseFormatType = "text" | "json_object" | "json_schema";
 export declare const ResponseFormatTypeText: ResponseFormatType;
 export declare const ResponseFormatTypeJSONObject: ResponseFormatType;
 export declare const ResponseFormatTypeJSONSchema: ResponseFormatType;
@@ -4465,7 +4560,7 @@ export interface LLMContextMessage {
 /**
  * SecretScope defines the visibility/purpose of a secret
  */
-export type SecretScope = string;
+export type SecretScope = "team" | "internal" | "system";
 /**
  * SecretScopeTeam is a normal user secret, visible in team secret lists
  */
@@ -4487,7 +4582,7 @@ export declare const PageStatusScheduled: PageStatus;
 /**
  * PageType represents the type of page content
  */
-export type PageType = string;
+export type PageType = "doc" | "blog" | "page" | "announcement";
 export declare const PageTypeDoc: PageType;
 export declare const PageTypeBlog: PageType;
 export declare const PageTypePage: PageType;
@@ -4497,7 +4592,7 @@ export declare const CommentStatusUnknown: CommentStatus;
 export declare const CommentStatusDraft: CommentStatus;
 export declare const CommentStatusPublished: CommentStatus;
 export declare const CommentStatusArchived: CommentStatus;
-export type InstanceCloudProvider = string;
+export type InstanceCloudProvider = "aws" | "amaya" | "azure" | "boostrun" | "crusoe" | "datacrunch" | "denvr" | "digitalocean" | "excesssupply" | "horizon" | "hyperstack" | "imwt" | "jarvislabs" | "lambdalabs" | "latitude" | "massedcompute" | "nebius" | "oblivus" | "paperspace" | "phyntec" | "runpod" | "scaleway" | "shade" | "tensordock" | "verda" | "voltagepark" | "vultr";
 export declare const CloudAWS: InstanceCloudProvider;
 export declare const CloudAmaya: InstanceCloudProvider;
 export declare const CloudAzure: InstanceCloudProvider;
@@ -4525,7 +4620,7 @@ export declare const CloudTensorDock: InstanceCloudProvider;
 export declare const CloudVerda: InstanceCloudProvider;
 export declare const CloudVoltagePark: InstanceCloudProvider;
 export declare const CloudVultr: InstanceCloudProvider;
-export type InstanceStatus = string;
+export type InstanceStatus = "creating" | "pending_provider" | "pending" | "active" | "error" | "deleting" | "deleted";
 export declare const InstanceStatusCreating: InstanceStatus;
 export declare const InstanceStatusPendingProvider: InstanceStatus;
 export declare const InstanceStatusPending: InstanceStatus;
@@ -4533,29 +4628,29 @@ export declare const InstanceStatusActive: InstanceStatus;
 export declare const InstanceStatusError: InstanceStatus;
 export declare const InstanceStatusDeleting: InstanceStatus;
 export declare const InstanceStatusDeleted: InstanceStatus;
-export type InstanceTypeDeploymentType = string;
+export type InstanceTypeDeploymentType = "vm" | "container" | "baremetal";
 export declare const InstanceTypeDeploymentTypeVM: InstanceTypeDeploymentType;
 export declare const InstanceTypeDeploymentTypeContainer: InstanceTypeDeploymentType;
 export declare const InstanceTypeDeploymentTypeBaremetal: InstanceTypeDeploymentType;
-export type AppSessionStatus = string;
+export type AppSessionStatus = "active" | "ended" | "expired";
 export declare const AppSessionStatusActive: AppSessionStatus;
 export declare const AppSessionStatusEnded: AppSessionStatus;
 export declare const AppSessionStatusExpired: AppSessionStatus;
 /**
  * ProjectType represents different types of projects
  */
-export type ProjectType = string;
+export type ProjectType = "agent" | "app" | "flow" | "other";
 export declare const ProjectTypeAgent: ProjectType;
 export declare const ProjectTypeApp: ProjectType;
 export declare const ProjectTypeFlow: ProjectType;
 export declare const ProjectTypeOther: ProjectType;
-export type UsageEventResourceTier = string;
+export type UsageEventResourceTier = "private" | "cloud";
 export declare const UsageEventResourceTierPrivate: UsageEventResourceTier;
 export declare const UsageEventResourceTierCloud: UsageEventResourceTier;
 /**
  * MetaItemType is the type discriminator for MetaItem
  */
-export type MetaItemType = string;
+export type MetaItemType = "text" | "image" | "video" | "audio" | "raw";
 export declare const MetaItemTypeText: MetaItemType;
 export declare const MetaItemTypeImage: MetaItemType;
 export declare const MetaItemTypeVideo: MetaItemType;
@@ -4564,7 +4659,7 @@ export declare const MetaItemTypeRaw: MetaItemType;
 /**
  * VideoResolution represents standard video resolution presets
  */
-export type VideoResolution = string;
+export type VideoResolution = "480p" | "720p" | "1080p" | "1440p" | "4k";
 export declare const VideoRes480P: VideoResolution;
 export declare const VideoRes720P: VideoResolution;
 export declare const VideoRes1080P: VideoResolution;
@@ -4573,20 +4668,20 @@ export declare const VideoRes4K: VideoResolution;
 /**
  * MCPServerAuthType describes how a server authenticates clients.
  */
-export type MCPServerAuthType = string;
+export type MCPServerAuthType = "oauth" | "api_key" | "none";
 export declare const MCPServerAuthOAuth: MCPServerAuthType;
 export declare const MCPServerAuthAPIKey: MCPServerAuthType;
 export declare const MCPServerAuthNone: MCPServerAuthType;
 /**
  * TeamInviteStatus represents the status of a team invitation
  */
-export type TeamInviteStatus = string;
+export type TeamInviteStatus = "pending" | "accepted" | "declined" | "expired" | "revoked";
 export declare const TeamInviteStatusPending: TeamInviteStatus;
 export declare const TeamInviteStatusAccepted: TeamInviteStatus;
 export declare const TeamInviteStatusDeclined: TeamInviteStatus;
 export declare const TeamInviteStatusExpired: TeamInviteStatus;
 export declare const TeamInviteStatusRevoked: TeamInviteStatus;
-export type RefRouteType = string;
+export type RefRouteType = "app" | "agent" | "skill" | "url";
 export declare const RefRouteTypeApp: RefRouteType;
 export declare const RefRouteTypeAgent: RefRouteType;
 export declare const RefRouteTypeSkill: RefRouteType;
@@ -4595,10 +4690,10 @@ export declare const RefRouteTypeSkill: RefRouteType;
  * /docs/api/sdk/files). Alias and target are literal paths, not refs.
  */
 export declare const RefRouteTypeURL: RefRouteType;
-export type RefRouteMode = string;
+export type RefRouteMode = "rewrite" | "redirect";
 export declare const RefRouteModeRewrite: RefRouteMode;
 export declare const RefRouteModeRedirect: RefRouteMode;
-export type KnowledgeType = string;
+export type KnowledgeType = "concept" | "skill" | "observation" | "preference" | "reference" | "person" | "project" | "agent-config";
 export declare const KnowledgeTypeConcept: KnowledgeType;
 export declare const KnowledgeTypeSkill: KnowledgeType;
 export declare const KnowledgeTypeObservation: KnowledgeType;
@@ -4607,7 +4702,7 @@ export declare const KnowledgeTypeReference: KnowledgeType;
 export declare const KnowledgeTypePerson: KnowledgeType;
 export declare const KnowledgeTypeProject: KnowledgeType;
 export declare const KnowledgeTypeAgentConfig: KnowledgeType;
-export type KnowledgeLifecycle = string;
+export type KnowledgeLifecycle = "permanent" | "decay" | "draft" | "deprecated";
 export declare const KnowledgeLifecyclePermanent: KnowledgeLifecycle;
 export declare const KnowledgeLifecycleDecay: KnowledgeLifecycle;
 export declare const KnowledgeLifecycleDraft: KnowledgeLifecycle;
@@ -4615,10 +4710,10 @@ export declare const KnowledgeLifecycleDeprecated: KnowledgeLifecycle;
 /**
  * ArtifactType is the source format of an artifact page.
  */
-export type ArtifactType = string;
+export type ArtifactType = "html" | "markdown";
 export declare const ArtifactTypeHTML: ArtifactType;
 export declare const ArtifactTypeMarkdown: ArtifactType;
-export type FilterOperator = string;
+export type FilterOperator = "eq" | "neq" | "in" | "not_in" | "gt" | "gte" | "lt" | "lte" | "like" | "ilike" | "contains" | "not_contains" | "is_null" | "is_not_null" | "is_empty" | "is_not_empty";
 export declare const OpEqual: FilterOperator;
 export declare const OpNotEqual: FilterOperator;
 export declare const OpIn: FilterOperator;
@@ -4635,7 +4730,7 @@ export declare const OpIsNull: FilterOperator;
 export declare const OpIsNotNull: FilterOperator;
 export declare const OpIsEmpty: FilterOperator;
 export declare const OpIsNotEmpty: FilterOperator;
-export type DeviceAuthStatus = string;
+export type DeviceAuthStatus = "pending" | "approved" | "expired" | "denied" | "valid" | "invalid" | "loading";
 export declare const DeviceAuthStatusPending: DeviceAuthStatus;
 export declare const DeviceAuthStatusApproved: DeviceAuthStatus;
 export declare const DeviceAuthStatusExpired: DeviceAuthStatus;
@@ -4646,7 +4741,7 @@ export declare const DeviceAuthStatusLoading: DeviceAuthStatus;
 /**
  * DeviceTokenKind selects the credential minted when a device auth flow is approved.
  */
-export type DeviceTokenKind = string;
+export type DeviceTokenKind = "session" | "api_key";
 /**
  * DeviceTokenKindSession mints a revocable CLI session (acts as the user,
  * supports team switching via X-Team-ID).
@@ -4657,7 +4752,7 @@ export declare const DeviceTokenKindSession: DeviceTokenKind;
  * TODO: retire once CLIs older than the session-token release are gone.
  */
 export declare const DeviceTokenKindAPIKey: DeviceTokenKind;
-export type EntitlementResource = string;
+export type EntitlementResource = "api_keys" | "connectors" | "knowledge_bases" | "storage_mb" | "concurrency" | "rate_per_min" | "seats" | "triggers" | "retention_days" | "private_apps" | "task_executions" | "feature:byok" | "feature:seedance" | "feature:scopes" | "feature:webhooks" | "feature:team_billing" | "feature:auto_recharge" | "feature:invoices" | "feature:publish_apps";
 /**
  * Capacity limits — scale with tier
  */
@@ -4689,7 +4784,7 @@ export declare const ResourceFeatureTeamBilling: EntitlementResource;
 export declare const ResourceFeatureAutoRecharge: EntitlementResource;
 export declare const ResourceFeatureInvoices: EntitlementResource;
 export declare const ResourceFeaturePublishApps: EntitlementResource;
-export type ContentRating = string;
+export type ContentRating = "safe" | "sexual_suggestive" | "sexual_explicit" | "violence_non_graphic" | "violence_graphic" | "gore" | "unrated";
 export declare const ContentSafe: ContentRating;
 export declare const ContentSexualSuggestive: ContentRating;
 export declare const ContentSexualExplicit: ContentRating;
@@ -4700,7 +4795,7 @@ export declare const ContentUnrated: ContentRating;
 /**
  * CredentialProvider names the external service a credential is for.
  */
-export type CredentialProvider = string;
+export type CredentialProvider = "google" | "google-sa" | "slack" | "notion" | "github" | "x" | "microsoft" | "salesforce" | "discord" | "gcp" | "mcp" | "reddit";
 /**
  * Credential.Provider is a plain string; cast with string(...) when assigning.
  */
@@ -4752,7 +4847,7 @@ export declare const CredentialProviderReddit: CredentialProvider;
 /**
  * CredentialType describes the credential category.
  */
-export type CredentialType = string;
+export type CredentialType = "oauth" | "api_key" | "mcp" | "service_account" | "wif";
 export declare const CredentialTypeOAuth: CredentialType;
 export declare const CredentialTypeAPIKey: CredentialType;
 export declare const CredentialTypeMCP: CredentialType;
@@ -4761,7 +4856,7 @@ export declare const CredentialTypeWIF: CredentialType;
 /**
  * CredentialStatus represents the lifecycle state of a credential.
  */
-export type CredentialStatus = string;
+export type CredentialStatus = "pending" | "connected" | "disconnected" | "expired" | "error";
 export declare const CredentialStatusPending: CredentialStatus;
 export declare const CredentialStatusConnected: CredentialStatus;
 export declare const CredentialStatusDisconnected: CredentialStatus;
@@ -4770,7 +4865,7 @@ export declare const CredentialStatusError: CredentialStatus;
 /**
  * CredentialScope controls resolution priority and ownership.
  */
-export type CredentialScope = string;
+export type CredentialScope = "platform" | "org" | "team" | "user" | "agent";
 export declare const CredentialScopePlatform: CredentialScope;
 /**
  * CredentialScopeOrg: shared across all teams of an org. In the enum for
@@ -4788,7 +4883,7 @@ export declare const CredentialScopeAgent: CredentialScope;
  * the logins made through it (owned by a team or a user). Every other
  * credential type is a token row.
  */
-export type CredentialGrant = string;
+export type CredentialGrant = "credentials" | "token";
 /**
  * CredentialGrantCredentials: an OAuth app. Never a connection.
  */
@@ -4801,7 +4896,7 @@ export declare const CredentialGrantToken: CredentialGrant;
 /**
  * NotificationChannel represents a delivery channel
  */
-export type NotificationChannel = string;
+export type NotificationChannel = "email" | "sms" | "push" | "slack";
 export declare const NotificationChannelEmail: NotificationChannel;
 export declare const NotificationChannelSMS: NotificationChannel;
 export declare const NotificationChannelPush: NotificationChannel;
@@ -4809,7 +4904,7 @@ export declare const NotificationChannelSlack: NotificationChannel;
 /**
  * NotificationPriority represents notification priority
  */
-export type NotificationPriority = string;
+export type NotificationPriority = "low" | "normal" | "high" | "critical";
 export declare const NotificationPriorityLow: NotificationPriority;
 export declare const NotificationPriorityNormal: NotificationPriority;
 export declare const NotificationPriorityHigh: NotificationPriority;
@@ -4817,7 +4912,7 @@ export declare const NotificationPriorityCritical: NotificationPriority;
 /**
  * NotificationType represents the type/category of notification
  */
-export type NotificationType = string;
+export type NotificationType = "low_balance" | "auto_recharge" | "payment_success" | "payment_failed" | "usage_summary" | "spending_limit" | "invoice" | "credit_note" | "subscription_created" | "subscription_credit" | "subscription_canceled" | "subscription_payment_failed" | "subscription_trial_ending" | "welcome" | "welcome_agents" | "welcome_apps" | "welcome_flows" | "welcome_sdk" | "password_reset" | "email_verify" | "security_alert" | "task_complete" | "task_failed" | "data_export" | "system_alert" | "maintenance" | "tos_update" | "service_notice" | "team_invite";
 /**
  * Billing notifications
  */
@@ -4868,7 +4963,7 @@ export declare const NotificationTypeTeamInvite: NotificationType;
 /**
  * NotificationStatus represents the status of a notification
  */
-export type NotificationStatus = string;
+export type NotificationStatus = "pending" | "processing" | "sent" | "delivered" | "failed" | "bounced" | "cancelled";
 export declare const NotificationStatusPending: NotificationStatus;
 export declare const NotificationStatusProcessing: NotificationStatus;
 export declare const NotificationStatusSent: NotificationStatus;
@@ -4879,7 +4974,7 @@ export declare const NotificationStatusCancelled: NotificationStatus;
 /**
  * FunctionKind is how an app function talks to its caller.
  */
-export type FunctionKind = string;
+export type FunctionKind = "run" | "stream";
 /**
  * FunctionKindRun takes an input and returns an output (optionally
  * yielding progress on the way). The zero value means this.
@@ -4893,7 +4988,7 @@ export declare const FunctionKindStream: FunctionKind;
 /**
  * SocketStatus is where a socket is in its life.
  */
-export type SocketStatus = string;
+export type SocketStatus = "pending" | "open" | "closed";
 /**
  * SocketStatusPending: opened, and the two ends have not met yet. An end
  * that gave up waiting may dial again, so an unpaired end does not close
@@ -4911,7 +5006,7 @@ export declare const SocketStatusClosed: SocketStatus;
 /**
  * SocketOutcome is why a socket closed.
  */
-export type SocketOutcome = string;
+export type SocketOutcome = "client_closed" | "worker_closed" | "drained" | "never_paired" | "task_ended";
 export declare const SocketOutcomeClientClosed: SocketOutcome;
 export declare const SocketOutcomeWorkerClosed: SocketOutcome;
 /**
@@ -4982,7 +5077,7 @@ export declare const TaskStatusCancelled: TaskStatus;
 /**
  * Infra defines where a task should run.
  */
-export type Infra = string;
+export type Infra = "private" | "cloud" | "private_first";
 export declare const InfraPrivate: Infra;
 export declare const InfraCloud: Infra;
 export declare const InfraPrivateFirst: Infra;
@@ -5009,7 +5104,7 @@ export interface TaskAction {
 export interface TaskMetadata {
     action?: TaskAction;
 }
-export type TeamType = string;
+export type TeamType = "personal" | "team" | "system" | "org";
 export declare const TeamTypePersonal: TeamType;
 export declare const TeamTypeTeam: TeamType;
 export declare const TeamTypeSystem: TeamType;
@@ -5021,20 +5116,45 @@ export declare const TeamTypeSystem: TeamType;
  * teams exist.
  */
 export declare const TeamTypeOrg: TeamType;
-export type TeamStatus = string;
+export type TeamStatus = "active" | "suspended" | "terminated";
 export declare const TeamStatusActive: TeamStatus;
 export declare const TeamStatusSuspended: TeamStatus;
 export declare const TeamStatusTerminated: TeamStatus;
-export type TeamRole = string;
+export type TeamRole = "owner" | "admin" | "member";
 export declare const TeamRoleOwner: TeamRole;
 export declare const TeamRoleAdmin: TeamRole;
 export declare const TeamRoleMember: TeamRole;
-export type Role = string;
+/**
+ * TeamCapability is one thing a caller may do to a team's settings. The set is
+ * closed; team.Subject.Can is the only place that grants them.
+ */
+export type TeamCapability = "edit_profile" | "manage_members" | "view_members" | "manage_keys" | "manage_vault" | "view_billing" | "manage_billing" | "view_policy" | "manage_policy" | "manage_org" | "manage_sso" | "archive" | "create_team" | "create_org" | "connect_org_credential" | "connect_platform_credential";
+export declare const TeamCapabilityEditProfile: TeamCapability;
+export declare const TeamCapabilityManageMembers: TeamCapability;
+export declare const TeamCapabilityViewMembers: TeamCapability;
+export declare const TeamCapabilityManageKeys: TeamCapability;
+export declare const TeamCapabilityManageVault: TeamCapability;
+export declare const TeamCapabilityViewBilling: TeamCapability;
+export declare const TeamCapabilityManageBilling: TeamCapability;
+export declare const TeamCapabilityViewPolicy: TeamCapability;
+export declare const TeamCapabilityManagePolicy: TeamCapability;
+export declare const TeamCapabilityManageOrg: TeamCapability;
+export declare const TeamCapabilityManageSSO: TeamCapability;
+export declare const TeamCapabilityArchive: TeamCapability;
+export declare const TeamCapabilityCreateTeam: TeamCapability;
+export declare const TeamCapabilityCreateOrg: TeamCapability;
+/**
+ * Connecting a credential the whole org, or the whole platform, resolves.
+ * The workspace level is manage_vault.
+ */
+export declare const TeamCapabilityConnectOrgCredential: TeamCapability;
+export declare const TeamCapabilityConnectPlatformCredential: TeamCapability;
+export type Role = "guest" | "user" | "admin" | "system";
 export declare const RoleGuest: Role;
 export declare const RoleUser: Role;
 export declare const RoleAdmin: Role;
 export declare const RoleSystem: Role;
-export type UtilityPreset = string;
+export type UtilityPreset = "gate" | "selector" | "merge" | "constant";
 export declare const UtilityPresetGate: UtilityPreset;
 export declare const UtilityPresetSelector: UtilityPreset;
 export declare const UtilityPresetMerge: UtilityPreset;
@@ -5057,7 +5177,7 @@ export interface UtilityConfig {
  * These are the backbone protocol events — every consumer (A2A, SDK, frontend)
  * projects from this set.
  */
-export type AgentEventType = string;
+export type AgentEventType = "run.started" | "run.state_changed" | "turn.started" | "turn.completed" | "content.delta" | "tool.started" | "tool.completed" | "approval.required" | "approval.resolved" | "hook.executed" | "usage.updated" | "context.compacted" | "error";
 /**
  * Run lifecycle
  */
@@ -5136,7 +5256,7 @@ export interface ContentDeltaPayload {
     kind: ContentDeltaKind;
     delta: string;
 }
-export type ContentDeltaKind = string;
+export type ContentDeltaKind = "text" | "reasoning";
 export declare const ContentDeltaText: ContentDeltaKind;
 export declare const ContentDeltaReasoning: ContentDeltaKind;
 export interface ToolStartedPayload {
@@ -5190,7 +5310,7 @@ export interface ErrorPayload {
  * AgentRunState tracks the lifecycle of an agent run (one user→agent turn).
  * Maps to A2A TaskState and AG-UI Run outcome for protocol compliance.
  */
-export type AgentRunState = string;
+export type AgentRunState = "submitted" | "working" | "input_required" | "auth_required" | "completed" | "failed" | "canceled" | "rejected";
 export declare const AgentRunStateSubmitted: AgentRunState;
 export declare const AgentRunStateWorking: AgentRunState;
 export declare const AgentRunStateInputRequired: AgentRunState;
@@ -5203,7 +5323,7 @@ export declare const AgentRunStateRejected: AgentRunState;
  * InterruptReason describes why an agent run is in an interrupted state.
  * Aligns with AG-UI interrupt outcome reasons.
  */
-export type InterruptReason = string;
+export type InterruptReason = "tool_approval" | "client_tool" | "widget" | "auth" | "confirmation" | "hook_gate";
 export declare const InterruptReasonToolApproval: InterruptReason;
 export declare const InterruptReasonClientTool: InterruptReason;
 export declare const InterruptReasonWidget: InterruptReason;
@@ -5216,7 +5336,7 @@ export type StringEncodedMap = {
 /**
  * InterruptStatus tracks the lifecycle of an interrupt gate.
  */
-export type InterruptStatus = string;
+export type InterruptStatus = "pending" | "resolved" | "expired" | "cancelled";
 export declare const InterruptStatusPending: InterruptStatus;
 export declare const InterruptStatusResolved: InterruptStatus;
 export declare const InterruptStatusExpired: InterruptStatus;
@@ -5224,13 +5344,13 @@ export declare const InterruptStatusCancelled: InterruptStatus;
 /**
  * InterruptResolution records how a pending interrupt was resolved.
  */
-export type InterruptResolution = string;
+export type InterruptResolution = "allow" | "deny";
 export declare const InterruptResolutionAllow: InterruptResolution;
 export declare const InterruptResolutionDeny: InterruptResolution;
 /**
  * InterruptResourceType identifies the kind of resource an interrupt gates.
  */
-export type InterruptResourceType = string;
+export type InterruptResourceType = "tool_invocation" | "hook_event";
 export declare const InterruptResourceToolInvocation: InterruptResourceType;
 export declare const InterruptResourceHookEvent: InterruptResourceType;
 /**
@@ -5238,7 +5358,7 @@ export declare const InterruptResourceHookEvent: InterruptResourceType;
  * Events fire at well-defined points in the turn cycle, giving external
  * handlers the ability to observe, inject context, or halt execution.
  */
-export type HookEvent = string;
+export type HookEvent = "agent.start" | "agent.turn_start" | "agent.tool_call" | "agent.tool_result" | "agent.turn_complete" | "agent.error" | "agent.complete" | "agent.idle" | "agent.pre_compact" | "agent.post_compact";
 export declare const HookEventAgentStart: HookEvent;
 export declare const HookEventTurnStart: HookEvent;
 export declare const HookEventToolCall: HookEvent;
@@ -5260,7 +5380,7 @@ export interface HookEventDefinition {
 /**
  * HookDecision is the handler's verdict on whether execution should continue.
  */
-export type HookDecision = string;
+export type HookDecision = "allow" | "deny" | "stop" | "suspend";
 export declare const HookDecisionAllow: HookDecision;
 export declare const HookDecisionDeny: HookDecision;
 export declare const HookDecisionStop: HookDecision;
@@ -5268,10 +5388,36 @@ export declare const HookDecisionSuspend: HookDecision;
 /**
  * HookHandlerType distinguishes how a lifecycle hook is executed.
  */
-export type HookHandlerType = string;
+export type HookHandlerType = "webhook" | "task" | "gate" | "builtin";
 export declare const HookHandlerWebhook: HookHandlerType;
 export declare const HookHandlerTask: HookHandlerType;
 export declare const HookHandlerGate: HookHandlerType;
+export declare const HookHandlerBuiltin: HookHandlerType;
+/**
+ * BuiltinHook names a hook handler the platform implements itself. A builtin
+ * runs in-process on the turn that fired it: no URL to host, no round trip, no
+ * agent spawn. That is what lets it return an injection at all — a task hook
+ * spawns an agent and discards its answer, so only webhook, gate and builtin
+ * can put anything into context.
+ * This registry is the single source of truth. The runtime dispatches from it,
+ * 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";
+export declare const BuiltinHookBeltSuggest: BuiltinHook;
+/**
+ * BuiltinHookDefinition describes a builtin hook and where it may be used.
+ */
+export interface BuiltinHookDefinition {
+    name: BuiltinHook;
+    description: string;
+    /**
+     * Events the builtin may be attached to. A builtin that reads the turn's
+     * prompt is meaningless on agent.complete, so the set is part of its
+     * definition rather than a convention.
+     */
+    events: HookEvent[];
+}
 /**
  * LifecycleHookConfig registers a handler for an agent lifecycle event.
  * Stored on AgentVersion alongside Tools and Skills.
@@ -5319,6 +5465,14 @@ export interface ContextInjection {
     role?: string;
     ttl_turns?: number;
     dedup_key?: string;
+    /**
+     * Items names what this injection put in front of the model — resource
+     * refs, file paths, whatever the producer deals in. A hook that offers the
+     * same things every turn reads its own past Items back to see what it has
+     * already offered, instead of keeping a ledger somewhere else and hoping
+     * the two stay in step.
+     */
+    items?: string[];
 }
 /**
  * ToolCallEventData is the typed payload for agent.tool_call events.
@@ -5346,7 +5500,7 @@ export interface ErrorEventData {
 /**
  * ToolInvocationStatus represents the execution status of a tool invocation
  */
-export type ToolInvocationStatus = string;
+export type ToolInvocationStatus = "pending" | "in_progress" | "awaiting_input" | "awaiting_approval" | "completed" | "failed" | "cancelled";
 export declare const ToolInvocationStatusPending: ToolInvocationStatus;
 export declare const ToolInvocationStatusInProgress: ToolInvocationStatus;
 export declare const ToolInvocationStatusAwaitingInput: ToolInvocationStatus;
@@ -5357,7 +5511,7 @@ export declare const ToolInvocationStatusCancelled: ToolInvocationStatus;
 /**
  * ToolType represents the type of tool (used in both AgentTool definition and ToolInvocation)
  */
-export type ToolType = string;
+export type ToolType = "app" | "agent" | "hook" | "http" | "call" | "mcp" | "client" | "internal" | "harness";
 export declare const ToolTypeApp: ToolType;
 export declare const ToolTypeAgent: ToolType;
 export declare const ToolTypeHook: ToolType;
@@ -5366,14 +5520,15 @@ export declare const ToolTypeCall: ToolType;
 export declare const ToolTypeMCP: ToolType;
 export declare const ToolTypeClient: ToolType;
 export declare const ToolTypeInternal: ToolType;
+export declare const ToolTypeHarness: ToolType;
 /**
  * ToolCallType represents the type field on a tool call (wire format).
  */
-export type ToolCallType = string;
+export type ToolCallType = "function";
 /**
  * ToolParamType represents a JSON Schema parameter type for tool definitions.
  */
-export type ToolParamType = string;
+export type ToolParamType = "object" | "string" | "integer" | "number" | "boolean" | "array" | "null";
 /**
  * Tool call types
  */