@inferencesh/sdk 0.6.50 → 0.6.52

package/dist/types.d.ts

@@ -188,6 +188,10 @@ export interface CoreAppConfigDTO {
 export interface AgentDTO extends BaseModelDTO, PermissionModelDTO, ProjectModelDTO {
     namespace: string;
     name: string;
+    /**
+     * Title is the human-readable name; empty falls back to Name.
+     */
+    title: string;
     images: AgentImages;
     version_id: string;
     version?: AgentVersionDTO;
@@ -212,6 +216,7 @@ export interface AgentVersionDTO extends BaseModelDTO, PermissionModelDTO {
 export interface CreateAgentRequest {
     id?: string;
     name: string;
+    title?: string;
     namespace?: string;
     images?: AgentImages;
     /**
@@ -333,7 +338,7 @@ export interface CreateAgentMessageRequest {
     agent?: string;
     tool_call_id?: string;
     input: LLMInput;
-    integration_context?: IntegrationContext;
+    channel_context?: ChannelContext;
     agent_config?: AgentConfigInput;
     agent_name?: string;
     context?: {
@@ -387,7 +392,7 @@ export interface AppVersionInput {
     };
     kernel?: string;
     required_secrets?: SecretRequirement[];
-    required_integrations?: IntegrationRequirement[];
+    required_integrations?: CredentialRequirement[];
     resources?: AppResources;
 }
 /**
@@ -397,6 +402,7 @@ export interface CreateAppRequest {
     id?: string;
     namespace?: string;
     name: string;
+    title?: string;
     description?: string;
     agent_description?: string;
     category?: AppCategory;
@@ -498,12 +504,30 @@ export interface SecretCreateRequest {
      * provider's default (team). Requires the matching admin role.
      */
     connection_scope?: CredentialScope;
+    /**
+     * ProviderName and ProviderWebsite describe a provider the platform does
+     * not list: the name the credential is shown under, and the site its
+     * logo is looked up from. Ignored for a provider the platform knows.
+     */
+    provider_name?: string;
+    provider_website?: string;
+}
+/**
+ * SecretProviderRequest attaches an existing secret to a provider's
+ * credential — the link a secret gets when it is created against a provider.
+ * An empty Provider detaches it back to a plain secret.
+ */
+export interface SecretProviderRequest {
+    provider: string;
+    connection_scope?: CredentialScope;
+    provider_name?: string;
+    provider_website?: string;
 }
 export interface SecretUpdateRequest {
     value: string;
     description?: string;
 }
-export interface IntegrationConnectRequest {
+export interface CredentialConnectRequest {
     provider: string;
     type: string;
     scopes?: string[];
@@ -519,15 +543,15 @@ export interface IntegrationConnectRequest {
      */
     connection_scope?: CredentialScope;
 }
-export interface IntegrationCompleteOAuthRequest {
+export interface CredentialCompleteOAuthRequest {
     provider: string;
     type: string;
     code: string;
     state: string;
     code_verifier?: string;
 }
-export interface IntegrationConnectResponse {
-    integration?: IntegrationDTO;
+export interface CredentialConnectResponse {
+    integration?: CredentialDTO;
     auth_url?: string;
     state?: string;
     code_verifier?: string;
@@ -972,6 +996,11 @@ export interface AppFunction {
      * metadata by AppVersion.DeriveCapabilities.
      */
     capabilities?: string[];
+    /**
+     * Kind is how the function talks to its caller, from engine discovery:
+     * a stream function declares a socket parameter. Empty means run.
+     */
+    kind?: FunctionKind;
 }
 /**
  * AppImages holds developer-provided images for the app.
@@ -1017,12 +1046,12 @@ export interface SecretRequirement {
     optional?: boolean;
 }
 /**
- * IntegrationRequirement defines an integration that an app requires.
+ * CredentialRequirement defines an integration that an app requires.
  * Key is the provider slug (e.g. "bytedance", "google").
  * Secrets lists the specific env var names to inject from this integration.
  * Scopes lists OAuth scopes needed (for OAuth integrations).
  */
-export interface IntegrationRequirement {
+export interface CredentialRequirement {
     key: string;
     description?: string;
     optional?: boolean;
@@ -1035,6 +1064,13 @@ export interface IntegrationRequirement {
 export interface AppDTO extends BaseModelDTO, PermissionModelDTO {
     namespace: string;
     name: string;
+    /**
+     * Title is the human-readable name shown wherever this resource is presented:
+     * "Veo 3.1" for the app named veo-3-1. Name stays the immutable slug that
+     * addresses it. Empty means the surface falls back to the name, so nothing
+     * breaks for a resource that never sets one.
+     */
+    title: string;
     description: string;
     agent_description: string;
     category: AppCategory;
@@ -1070,7 +1106,7 @@ export interface AppVersionDTO extends BaseModelDTO {
     };
     kernel: string;
     required_secrets?: SecretRequirement[];
-    required_integrations?: IntegrationRequirement[];
+    required_integrations?: CredentialRequirement[];
     resources: AppResources;
     checksum?: string;
 }
@@ -1128,6 +1164,10 @@ export interface PublicAppStoreDTO {
     tags?: string[];
     namespace: string;
     name: string;
+    /**
+     * Title is the human-readable name; empty falls back to Name.
+     */
+    title: string;
     description: string;
     images: AppImages;
     is_featured: boolean;
@@ -1605,6 +1645,63 @@ export interface ChatMessageDTO extends BaseModelDTO, PermissionModelDTO {
     tool_call_id?: string;
     tool_invocations?: ToolInvocationDTO[];
 }
+/**
+ * CredentialDTO is the API response for a credential (never exposes secrets).
+ */
+export interface CredentialDTO extends BaseModelDTO, PermissionModelDTO {
+    provider: string;
+    type: CredentialType;
+    grant?: CredentialGrant;
+    scope: CredentialScope;
+    status: CredentialStatus;
+    display_name: string;
+    icon_url?: string;
+    account_identifier?: string;
+    account_name?: string;
+    scopes: StringSlice;
+    expires_at?: string;
+    vault_id?: string;
+    metadata?: {
+        [key: string]: any;
+    };
+    is_primary: boolean;
+    error_message?: string;
+}
+/**
+ * CredentialConfigDTO is the merged view: provider catalog + credential state.
+ */
+export interface CredentialConfigDTO {
+    slug: string;
+    provider: string;
+    type: string;
+    name: string;
+    short_name: string;
+    description: string;
+    icon_url?: string;
+    how_it_works?: string[];
+    docs_url?: string;
+    secret_fields?: SecretFieldConfig[];
+    allows_byok: boolean;
+    available: boolean;
+    has_managed: boolean;
+    grant?: CredentialGrant;
+    /**
+     * CustomProviderID is set when the provider is one the team defined
+     * itself (models.CustomProvider), so the UI can offer edit and remove.
+     */
+    custom_provider_id?: string;
+    credential?: CredentialDTO;
+}
+/**
+ * SecretFieldConfig defines a secret field for the UI
+ */
+export interface SecretFieldConfig {
+    key: string;
+    label: string;
+    placeholder: string;
+    sensitive: boolean;
+    optional: boolean;
+}
 /**
  * SearchRequest represents a search request.
  * Each model declares its own SearchFields() on the repository.
@@ -1889,6 +1986,10 @@ export type FlowNodeDataMap = {
 export interface FlowDTO extends BaseModelDTO, PermissionModelDTO {
     namespace: string;
     name: string;
+    /**
+     * Title is the human-readable name; empty falls back to Name.
+     */
+    title: string;
     description: string;
     card_image: string;
     thumbnail: string;
@@ -2232,60 +2333,6 @@ export interface InstanceTypeBootTime {
     updated_at: string;
     sample_size: number;
 }
-/**
- * IntegrationDTO for API responses (never exposes tokens)
- */
-export interface IntegrationDTO extends BaseModelDTO, PermissionModelDTO {
-    scope: IntegrationScope;
-    grant?: IntegrationGrant;
-    provider: IntegrationProvider;
-    type: IntegrationAuthType;
-    auth: IntegrationAuthType;
-    status: IntegrationStatus;
-    display_name: string;
-    icon_url?: string;
-    scopes: StringSlice;
-    expires_at?: string;
-    service_account_email?: string;
-    metadata?: {
-        [key: string]: any;
-    };
-    account_identifier?: string;
-    account_name?: string;
-    is_primary: boolean;
-    error_message?: string;
-}
-/**
- * IntegrationConfigDTO is the API response for integration configuration
- */
-export interface IntegrationConfigDTO {
-    slug: string;
-    provider: string;
-    type: string;
-    auth: string;
-    name: string;
-    short_name: string;
-    description: string;
-    icon_url?: string;
-    how_it_works?: string[];
-    docs_url?: string;
-    secret_fields?: SecretFieldConfig[];
-    allows_byok: boolean;
-    available: boolean;
-    has_managed: boolean;
-    grant?: IntegrationGrant;
-    integration?: IntegrationDTO;
-}
-/**
- * SecretFieldConfig defines a secret field for the UI
- */
-export interface SecretFieldConfig {
-    key: string;
-    label: string;
-    placeholder: string;
-    sensitive: boolean;
-    optional: boolean;
-}
 export interface InterruptDTO extends BaseModelDTO, PermissionModelDTO {
     run_id: string;
     chat_id: string;
@@ -2349,6 +2396,10 @@ export interface SkillVersionDTO extends BaseModelDTO {
 export interface KnowledgeDTO extends BaseModelDTO, PermissionModelDTO {
     namespace: string;
     name: string;
+    /**
+     * Title is the human-readable name; empty falls back to Name.
+     */
+    title: string;
     description: string;
     type: KnowledgeType;
     lifecycle: KnowledgeLifecycle;
@@ -2618,6 +2669,10 @@ export interface MCPServerDTO {
     visibility: Visibility;
     slug: string;
     name: string;
+    /**
+     * Title is the human-readable name; empty falls back to Name.
+     */
+    title: string;
     description: string;
     icon_url: string;
     server_url: string;
@@ -2709,6 +2764,11 @@ export interface MenuItem {
     id: string;
     label: string;
     slug?: string;
+    /**
+     * Path is the linked page's path, filled in when a menu is read so a client
+     * can build the link without fetching each page. Never stored.
+     */
+    path?: string;
     page_id?: string;
     url?: string;
     icon?: string;
@@ -2729,6 +2789,7 @@ export interface PageDTO extends BaseModelDTO, PermissionModelDTO {
     type: PageType;
     metadata: PageMetadata;
     slug: string;
+    path: string;
     /**
      * PublishAt mirrors Metadata.PublishAt, which remains the field clients write.
      * Surfaced here so a reader does not have to reach into the metadata blob.
@@ -2876,6 +2937,7 @@ export interface RefRouteDTO extends BaseModelDTO {
  */
 export interface KnowledgeCreateRequest {
     name: string;
+    title?: string;
     description?: string;
     repo_url?: string;
     type?: KnowledgeType;
@@ -2907,6 +2969,7 @@ export interface KnowledgeVersionInput {
  * KnowledgeUpdateRequest is the request body for PUT /knowledge/{id}.
  */
 export interface KnowledgeUpdateRequest {
+    title?: string;
     description?: string;
     version?: KnowledgeVersionInput;
 }
@@ -3075,7 +3138,7 @@ export interface SetupAction {
  */
 export interface CheckRequirementsRequest {
     secrets?: SecretRequirement[];
-    integrations?: IntegrationRequirement[];
+    integrations?: CredentialRequirement[];
 }
 /**
  * CheckRequirementsResponse is the API response for checking requirements
@@ -3111,6 +3174,43 @@ export interface SecretDTO extends BaseModelDTO, PermissionModelDTO {
     masked_value: string;
     description?: string;
     scope?: SecretScope;
+    /**
+     * CredentialID is the credential this secret is attached to; empty for
+     * a plain secret.
+     */
+    credential_id?: string;
+}
+/**
+ * SocketAccess is where one end of a socket dials and the credential it
+ * presents. The task's caller gets one in the run response; the worker gets
+ * its own with the dispatch.
+ * Browsers cannot set headers on a WebSocket: they append
+ * `?access_token=<token>` to the URL. Everything else sends
+ * `Authorization: Bearer <token>`.
+ */
+export interface SocketAccess {
+    id: string;
+    url: string;
+    token: string;
+    expires_at: string;
+}
+/**
+ * SocketDTO is a socket and what is known of its life. The traffic figures
+ * come from the relay once the socket has closed.
+ */
+export interface SocketDTO extends BaseModelDTO, PermissionModelDTO {
+    task_id: string;
+    relay: string;
+    status: SocketStatus;
+    paired_at?: string;
+    ended_at?: string;
+    outcome?: SocketOutcome;
+    close_code?: number;
+    close_reason?: string;
+    client_frames: number;
+    client_bytes: number;
+    worker_frames: number;
+    worker_bytes: number;
 }
 /**
  * MeStatsResponse is returned by GET /me/stats.
@@ -3358,6 +3458,11 @@ export interface TaskResultDTO {
     created_at: string;
     updated_at: string;
     run_at?: string;
+    /**
+     * Socket is set when the function is a stream function: the caller dials
+     * it to talk to the app. POST /sockets/{id}/access issues a fresh one.
+     */
+    socket?: SocketAccess;
 }
 /**
  * TaskLogsDTO is a lightweight response for task logs endpoint.
@@ -3864,11 +3969,11 @@ export declare const ChatMessageContentTypeReasoning: ChatMessageContentType;
 export declare const ChatMessageContentTypeImage: ChatMessageContentType;
 export declare const ChatMessageContentTypeFile: ChatMessageContentType;
 export declare const ChatMessageContentTypeTool: ChatMessageContentType;
-export type IntegrationType = string;
-export declare const IntegrationTypeSlack: IntegrationType;
-export declare const IntegrationTypeDiscord: IntegrationType;
-export declare const IntegrationTypeTeams: IntegrationType;
-export declare const IntegrationTypeTelegram: IntegrationType;
+export type ChannelType = string;
+export declare const ChannelTypeSlack: ChannelType;
+export declare const ChannelTypeDiscord: ChannelType;
+export declare const ChannelTypeTeams: ChannelType;
+export declare const ChannelTypeTelegram: ChannelType;
 /**
  * ChatData contains agent-specific data for a chat session
  */
@@ -3899,11 +4004,13 @@ export interface ChatMessageContent {
     tool_calls?: ToolCall[];
 }
 /**
- * IntegrationContext holds integration-specific metadata for a chat
+ * ChannelContext records which channel a chat or message came through
+ * (slack, telegram, an OpenAI-dialect tag, ...) and the transport metadata
+ * needed to route a reply back to it.
  */
-export interface IntegrationContext {
-    integration_type?: IntegrationType;
-    integration_metadata?: any;
+export interface ChannelContext {
+    channel_type?: ChannelType;
+    channel_metadata?: any;
 }
 /**
  * EngineStatus represents the status of an engine.
@@ -4135,18 +4242,6 @@ export declare const ToolCallDelta_fieldTags: {
         readonly merge: "nested";
     };
 };
-/**
- * DeltaEvent is the generic streaming envelope on the NDJSON wire.
- * Delta is raw bytes — consumers parse based on context.
- */
-export interface DeltaEvent {
-    delta: any;
-    seq: number;
-}
-/**
- * LLMDeltaEvent is a typed alias for backward compatibility.
- */
-export type LLMDeltaEvent = DeltaEvent;
 /**
  * ToolCallFunctionDelta carries partial tool call function data.
  * Arguments is a raw JSON string fragment — concatenate by index, parse on completion.
@@ -4381,6 +4476,11 @@ export type RefRouteType = string;
 export declare const RefRouteTypeApp: RefRouteType;
 export declare const RefRouteTypeAgent: RefRouteType;
 export declare const RefRouteTypeSkill: RefRouteType;
+/**
+ * RefRouteTypeURL routes a site path to another (/docs/api-files →
+ * /docs/api/sdk/files). Alias and target are literal paths, not refs.
+ */
+export declare const RefRouteTypeURL: RefRouteType;
 export type RefRouteMode = string;
 export declare const RefRouteModeRewrite: RefRouteMode;
 export declare const RefRouteModeRedirect: RefRouteMode;
@@ -4484,59 +4584,75 @@ export declare const ContentViolenceGraphic: ContentRating;
 export declare const ContentGore: ContentRating;
 export declare const ContentUnrated: ContentRating;
 /**
- * IntegrationProvider represents an external integration provider.
+ * CredentialProvider names the external service a credential is for.
+ */
+export type CredentialProvider = string;
+/**
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
+ */
+export declare const CredentialProviderGoogle: CredentialProvider;
+/**
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
  */
-export type IntegrationProvider = string;
-export declare const IntegrationProviderGoogle: IntegrationProvider;
-export declare const IntegrationProviderGoogleSA: IntegrationProvider;
-export declare const IntegrationProviderSlack: IntegrationProvider;
-export declare const IntegrationProviderNotion: IntegrationProvider;
-export declare const IntegrationProviderGitHub: IntegrationProvider;
-export declare const IntegrationProviderX: IntegrationProvider;
-export declare const IntegrationProviderMicrosoft: IntegrationProvider;
-export declare const IntegrationProviderSalesforce: IntegrationProvider;
-export declare const IntegrationProviderDiscord: IntegrationProvider;
-export declare const IntegrationProviderGCP: IntegrationProvider;
-export declare const IntegrationProviderMCP: IntegrationProvider;
-export declare const IntegrationProviderReddit: IntegrationProvider;
+export declare const CredentialProviderGoogleSA: CredentialProvider;
 /**
- * IntegrationAuthType describes the authentication mechanism of an integration.
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
  */
-export type IntegrationAuthType = string;
-export declare const IntegrationAuthTypeServiceAccount: IntegrationAuthType;
-export declare const IntegrationAuthTypeOAuth: IntegrationAuthType;
-export declare const IntegrationAuthTypeAPIKey: IntegrationAuthType;
-export declare const IntegrationAuthTypeWIF: IntegrationAuthType;
-export declare const IntegrationAuthTypeMCP: IntegrationAuthType;
+export declare const CredentialProviderSlack: CredentialProvider;
 /**
- * IntegrationStatus represents the status of an integration connection.
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
  */
-export type IntegrationStatus = string;
-export declare const IntegrationStatusPending: IntegrationStatus;
-export declare const IntegrationStatusConnected: IntegrationStatus;
-export declare const IntegrationStatusDisconnected: IntegrationStatus;
-export declare const IntegrationStatusExpired: IntegrationStatus;
-export declare const IntegrationStatusError: IntegrationStatus;
+export declare const CredentialProviderNotion: CredentialProvider;
 /**
- * IntegrationScope controls credential resolution priority and ownership.
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
  */
-export type IntegrationScope = string;
-export declare const IntegrationScopeTeam: IntegrationScope;
-export declare const IntegrationScopePlatform: IntegrationScope;
-export declare const IntegrationScopeUser: IntegrationScope;
+export declare const CredentialProviderGitHub: CredentialProvider;
 /**
- * IntegrationGrant describes what an integration provides.
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
  */
-export type IntegrationGrant = string;
+export declare const CredentialProviderX: CredentialProvider;
 /**
- * IntegrationGrantCredentials provides OAuth app credentials (client_id/secret).
- * Users connect their own accounts against it. Only valid for type=oauth.
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
  */
-export declare const IntegrationGrantCredentials: IntegrationGrant;
+export declare const CredentialProviderMicrosoft: CredentialProvider;
 /**
- * IntegrationGrantToken provides ready-to-use access (token, API key, etc.).
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
  */
-export declare const IntegrationGrantToken: IntegrationGrant;
+export declare const CredentialProviderSalesforce: CredentialProvider;
+/**
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
+ */
+export declare const CredentialProviderDiscord: CredentialProvider;
+/**
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
+ */
+export declare const CredentialProviderGCP: CredentialProvider;
+/**
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
+ */
+export declare const CredentialProviderMCP: CredentialProvider;
+/**
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
+ */
+export declare const CredentialProviderReddit: CredentialProvider;
+/**
+ * CredentialType describes the credential category.
+ */
+export type CredentialType = string;
+export declare const CredentialTypeOAuth: CredentialType;
+export declare const CredentialTypeAPIKey: CredentialType;
+export declare const CredentialTypeMCP: CredentialType;
+export declare const CredentialTypeServiceAccount: CredentialType;
+export declare const CredentialTypeWIF: CredentialType;
+/**
+ * CredentialStatus represents the lifecycle state of a credential.
+ */
+export type CredentialStatus = string;
+export declare const CredentialStatusPending: CredentialStatus;
+export declare const CredentialStatusConnected: CredentialStatus;
+export declare const CredentialStatusDisconnected: CredentialStatus;
+export declare const CredentialStatusExpired: CredentialStatus;
+export declare const CredentialStatusError: CredentialStatus;
 /**
  * CredentialScope controls resolution priority and ownership.
  */
@@ -4552,6 +4668,12 @@ export declare const CredentialScopeOrg: CredentialScope;
 export declare const CredentialScopeTeam: CredentialScope;
 export declare const CredentialScopeUser: CredentialScope;
 export declare const CredentialScopeAgent: CredentialScope;
+/**
+ * CredentialGrant describes what a credential provides.
+ */
+export type CredentialGrant = string;
+export declare const CredentialGrantCredentials: CredentialGrant;
+export declare const CredentialGrantToken: CredentialGrant;
 /**
  * NotificationChannel represents a delivery channel
  */
@@ -4629,6 +4751,85 @@ export declare const NotificationStatusDelivered: NotificationStatus;
 export declare const NotificationStatusFailed: NotificationStatus;
 export declare const NotificationStatusBounced: NotificationStatus;
 export declare const NotificationStatusCancelled: NotificationStatus;
+/**
+ * FunctionKind is how an app function talks to its caller.
+ */
+export type FunctionKind = string;
+/**
+ * FunctionKindRun takes an input and returns an output (optionally
+ * yielding progress on the way). The zero value means this.
+ */
+export declare const FunctionKindRun: FunctionKind;
+/**
+ * FunctionKindStream holds a socket with the caller for the life of the
+ * task: frames both ways, no input/output exchange.
+ */
+export declare const FunctionKindStream: FunctionKind;
+/**
+ * SocketStatus is where a socket is in its life.
+ */
+export type SocketStatus = string;
+/**
+ * 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
+ * the socket; the task ending does.
+ */
+export declare const SocketStatusPending: SocketStatus;
+/**
+ * SocketStatusOpen: both ends are connected through the relay.
+ */
+export declare const SocketStatusOpen: SocketStatus;
+/**
+ * SocketStatusClosed: over. Outcome says why.
+ */
+export declare const SocketStatusClosed: SocketStatus;
+/**
+ * SocketOutcome is why a socket closed.
+ */
+export type SocketOutcome = string;
+export declare const SocketOutcomeClientClosed: SocketOutcome;
+export declare const SocketOutcomeWorkerClosed: SocketOutcome;
+/**
+ * SocketOutcomeDrained: the relay restarted under a live socket.
+ */
+export declare const SocketOutcomeDrained: SocketOutcome;
+/**
+ * SocketOutcomeNeverPaired: the task ended before the two ends met.
+ */
+export declare const SocketOutcomeNeverPaired: SocketOutcome;
+/**
+ * SocketOutcomeTaskEnded: the task ended and the relay's own account of
+ * the socket has not arrived (yet).
+ */
+export declare const SocketOutcomeTaskEnded: SocketOutcome;
+/**
+ * DeltaEvent is the generic streaming envelope on the NDJSON wire.
+ * Delta is raw bytes — consumers parse based on context.
+ * It is deliberately not LLM-specific: agent lifecycle events and any future
+ * delta producer share this envelope, which is why the identity field below is
+ * a bare resource id rather than anything named after chat.
+ */
+export interface DeltaEvent {
+    delta: any;
+    seq: number;
+    /**
+     * ResourceID names what this delta belongs to — for an LLM task, the
+     * assistant chat message being generated.
+     * Without it a consumer can only assume deltas belong to whatever it is
+     * currently building, which breaks the moment a message carries no text
+     * (a tool-call-only turn) and the previous message's state is still live.
+     * The producer copies this from the graph and never interprets it: ids come
+     * from one idgen space, so a consumer matches against the ids it already
+     * tracks and buffers anything it does not recognise yet. A resource_type
+     * companion is deliberately absent — nothing needs to route before matching.
+     * Empty when the task has no execution edge (a plain app run).
+     */
+    resource_id?: string;
+}
+/**
+ * LLMDeltaEvent is a typed alias for backward compatibility.
+ */
+export type LLMDeltaEvent = DeltaEvent;
 /**
  * TaskStatus represents the state of a task in its lifecycle.
  */
@@ -4701,15 +4902,23 @@ 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 declare const UtilityPresetGate: UtilityPreset;
+export declare const UtilityPresetSelector: UtilityPreset;
+export declare const UtilityPresetMerge: UtilityPreset;
+export declare const UtilityPresetConstant: UtilityPreset;
 /**
  * UtilityConfig defines a flow utility node — gate, selector, merge, or custom CEL.
  */
 export interface UtilityConfig {
-    preset: string;
+    preset: UtilityPreset;
     expression?: string;
     gate?: GateCondition;
     selector?: SelectorConfig;
     constant?: any;
+    random?: boolean;
+    random_min?: number;
+    random_max?: number;
 }
 /**
  * AgentEventType identifies what happened in an agent run.