@inferencesh/sdk 0.6.51 → 0.6.53

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/types.d.ts CHANGED
@@ -188,6 +188,10 @@ export interface CoreAppConfigDTO {
188
188
  export interface AgentDTO extends BaseModelDTO, PermissionModelDTO, ProjectModelDTO {
189
189
  namespace: string;
190
190
  name: string;
191
+ /**
192
+ * Title is the human-readable name; empty falls back to Name.
193
+ */
194
+ title: string;
191
195
  images: AgentImages;
192
196
  version_id: string;
193
197
  version?: AgentVersionDTO;
@@ -212,6 +216,7 @@ export interface AgentVersionDTO extends BaseModelDTO, PermissionModelDTO {
212
216
  export interface CreateAgentRequest {
213
217
  id?: string;
214
218
  name: string;
219
+ title?: string;
215
220
  namespace?: string;
216
221
  images?: AgentImages;
217
222
  /**
@@ -333,7 +338,7 @@ export interface CreateAgentMessageRequest {
333
338
  agent?: string;
334
339
  tool_call_id?: string;
335
340
  input: LLMInput;
336
- integration_context?: IntegrationContext;
341
+ channel_context?: ChannelContext;
337
342
  agent_config?: AgentConfigInput;
338
343
  agent_name?: string;
339
344
  context?: {
@@ -387,7 +392,7 @@ export interface AppVersionInput {
387
392
  };
388
393
  kernel?: string;
389
394
  required_secrets?: SecretRequirement[];
390
- required_integrations?: IntegrationRequirement[];
395
+ required_integrations?: CredentialRequirement[];
391
396
  resources?: AppResources;
392
397
  }
393
398
  /**
@@ -397,6 +402,7 @@ export interface CreateAppRequest {
397
402
  id?: string;
398
403
  namespace?: string;
399
404
  name: string;
405
+ title?: string;
400
406
  description?: string;
401
407
  agent_description?: string;
402
408
  category?: AppCategory;
@@ -498,12 +504,30 @@ export interface SecretCreateRequest {
498
504
  * provider's default (team). Requires the matching admin role.
499
505
  */
500
506
  connection_scope?: CredentialScope;
507
+ /**
508
+ * ProviderName and ProviderWebsite describe a provider the platform does
509
+ * not list: the name the credential is shown under, and the site its
510
+ * logo is looked up from. Ignored for a provider the platform knows.
511
+ */
512
+ provider_name?: string;
513
+ provider_website?: string;
514
+ }
515
+ /**
516
+ * SecretProviderRequest attaches an existing secret to a provider's
517
+ * credential — the link a secret gets when it is created against a provider.
518
+ * An empty Provider detaches it back to a plain secret.
519
+ */
520
+ export interface SecretProviderRequest {
521
+ provider: string;
522
+ connection_scope?: CredentialScope;
523
+ provider_name?: string;
524
+ provider_website?: string;
501
525
  }
502
526
  export interface SecretUpdateRequest {
503
527
  value: string;
504
528
  description?: string;
505
529
  }
506
- export interface IntegrationConnectRequest {
530
+ export interface CredentialConnectRequest {
507
531
  provider: string;
508
532
  type: string;
509
533
  scopes?: string[];
@@ -519,15 +543,15 @@ export interface IntegrationConnectRequest {
519
543
  */
520
544
  connection_scope?: CredentialScope;
521
545
  }
522
- export interface IntegrationCompleteOAuthRequest {
546
+ export interface CredentialCompleteOAuthRequest {
523
547
  provider: string;
524
548
  type: string;
525
549
  code: string;
526
550
  state: string;
527
551
  code_verifier?: string;
528
552
  }
529
- export interface IntegrationConnectResponse {
530
- integration?: IntegrationDTO;
553
+ export interface CredentialConnectResponse {
554
+ integration?: CredentialDTO;
531
555
  auth_url?: string;
532
556
  state?: string;
533
557
  code_verifier?: string;
@@ -972,6 +996,11 @@ export interface AppFunction {
972
996
  * metadata by AppVersion.DeriveCapabilities.
973
997
  */
974
998
  capabilities?: string[];
999
+ /**
1000
+ * Kind is how the function talks to its caller, from engine discovery:
1001
+ * a stream function declares a socket parameter. Empty means run.
1002
+ */
1003
+ kind?: FunctionKind;
975
1004
  }
976
1005
  /**
977
1006
  * AppImages holds developer-provided images for the app.
@@ -1017,12 +1046,12 @@ export interface SecretRequirement {
1017
1046
  optional?: boolean;
1018
1047
  }
1019
1048
  /**
1020
- * IntegrationRequirement defines an integration that an app requires.
1049
+ * CredentialRequirement defines an integration that an app requires.
1021
1050
  * Key is the provider slug (e.g. "bytedance", "google").
1022
1051
  * Secrets lists the specific env var names to inject from this integration.
1023
1052
  * Scopes lists OAuth scopes needed (for OAuth integrations).
1024
1053
  */
1025
- export interface IntegrationRequirement {
1054
+ export interface CredentialRequirement {
1026
1055
  key: string;
1027
1056
  description?: string;
1028
1057
  optional?: boolean;
@@ -1035,6 +1064,13 @@ export interface IntegrationRequirement {
1035
1064
  export interface AppDTO extends BaseModelDTO, PermissionModelDTO {
1036
1065
  namespace: string;
1037
1066
  name: string;
1067
+ /**
1068
+ * Title is the human-readable name shown wherever this resource is presented:
1069
+ * "Veo 3.1" for the app named veo-3-1. Name stays the immutable slug that
1070
+ * addresses it. Empty means the surface falls back to the name, so nothing
1071
+ * breaks for a resource that never sets one.
1072
+ */
1073
+ title: string;
1038
1074
  description: string;
1039
1075
  agent_description: string;
1040
1076
  category: AppCategory;
@@ -1070,7 +1106,7 @@ export interface AppVersionDTO extends BaseModelDTO {
1070
1106
  };
1071
1107
  kernel: string;
1072
1108
  required_secrets?: SecretRequirement[];
1073
- required_integrations?: IntegrationRequirement[];
1109
+ required_integrations?: CredentialRequirement[];
1074
1110
  resources: AppResources;
1075
1111
  checksum?: string;
1076
1112
  }
@@ -1128,6 +1164,10 @@ export interface PublicAppStoreDTO {
1128
1164
  tags?: string[];
1129
1165
  namespace: string;
1130
1166
  name: string;
1167
+ /**
1168
+ * Title is the human-readable name; empty falls back to Name.
1169
+ */
1170
+ title: string;
1131
1171
  description: string;
1132
1172
  images: AppImages;
1133
1173
  is_featured: boolean;
@@ -1605,6 +1645,63 @@ export interface ChatMessageDTO extends BaseModelDTO, PermissionModelDTO {
1605
1645
  tool_call_id?: string;
1606
1646
  tool_invocations?: ToolInvocationDTO[];
1607
1647
  }
1648
+ /**
1649
+ * CredentialDTO is the API response for a credential (never exposes secrets).
1650
+ */
1651
+ export interface CredentialDTO extends BaseModelDTO, PermissionModelDTO {
1652
+ provider: string;
1653
+ type: CredentialType;
1654
+ grant?: CredentialGrant;
1655
+ scope: CredentialScope;
1656
+ status: CredentialStatus;
1657
+ display_name: string;
1658
+ icon_url?: string;
1659
+ account_identifier?: string;
1660
+ account_name?: string;
1661
+ scopes: StringSlice;
1662
+ expires_at?: string;
1663
+ vault_id?: string;
1664
+ metadata?: {
1665
+ [key: string]: any;
1666
+ };
1667
+ is_primary: boolean;
1668
+ error_message?: string;
1669
+ }
1670
+ /**
1671
+ * CredentialConfigDTO is the merged view: provider catalog + credential state.
1672
+ */
1673
+ export interface CredentialConfigDTO {
1674
+ slug: string;
1675
+ provider: string;
1676
+ type: string;
1677
+ name: string;
1678
+ short_name: string;
1679
+ description: string;
1680
+ icon_url?: string;
1681
+ how_it_works?: string[];
1682
+ docs_url?: string;
1683
+ secret_fields?: SecretFieldConfig[];
1684
+ allows_byok: boolean;
1685
+ available: boolean;
1686
+ has_managed: boolean;
1687
+ grant?: CredentialGrant;
1688
+ /**
1689
+ * CustomProviderID is set when the provider is one the team defined
1690
+ * itself (models.CustomProvider), so the UI can offer edit and remove.
1691
+ */
1692
+ custom_provider_id?: string;
1693
+ credential?: CredentialDTO;
1694
+ }
1695
+ /**
1696
+ * SecretFieldConfig defines a secret field for the UI
1697
+ */
1698
+ export interface SecretFieldConfig {
1699
+ key: string;
1700
+ label: string;
1701
+ placeholder: string;
1702
+ sensitive: boolean;
1703
+ optional: boolean;
1704
+ }
1608
1705
  /**
1609
1706
  * SearchRequest represents a search request.
1610
1707
  * Each model declares its own SearchFields() on the repository.
@@ -1889,6 +1986,10 @@ export type FlowNodeDataMap = {
1889
1986
  export interface FlowDTO extends BaseModelDTO, PermissionModelDTO {
1890
1987
  namespace: string;
1891
1988
  name: string;
1989
+ /**
1990
+ * Title is the human-readable name; empty falls back to Name.
1991
+ */
1992
+ title: string;
1892
1993
  description: string;
1893
1994
  card_image: string;
1894
1995
  thumbnail: string;
@@ -2232,60 +2333,6 @@ export interface InstanceTypeBootTime {
2232
2333
  updated_at: string;
2233
2334
  sample_size: number;
2234
2335
  }
2235
- /**
2236
- * IntegrationDTO for API responses (never exposes tokens)
2237
- */
2238
- export interface IntegrationDTO extends BaseModelDTO, PermissionModelDTO {
2239
- scope: IntegrationScope;
2240
- grant?: IntegrationGrant;
2241
- provider: IntegrationProvider;
2242
- type: IntegrationAuthType;
2243
- auth: IntegrationAuthType;
2244
- status: IntegrationStatus;
2245
- display_name: string;
2246
- icon_url?: string;
2247
- scopes: StringSlice;
2248
- expires_at?: string;
2249
- service_account_email?: string;
2250
- metadata?: {
2251
- [key: string]: any;
2252
- };
2253
- account_identifier?: string;
2254
- account_name?: string;
2255
- is_primary: boolean;
2256
- error_message?: string;
2257
- }
2258
- /**
2259
- * IntegrationConfigDTO is the API response for integration configuration
2260
- */
2261
- export interface IntegrationConfigDTO {
2262
- slug: string;
2263
- provider: string;
2264
- type: string;
2265
- auth: string;
2266
- name: string;
2267
- short_name: string;
2268
- description: string;
2269
- icon_url?: string;
2270
- how_it_works?: string[];
2271
- docs_url?: string;
2272
- secret_fields?: SecretFieldConfig[];
2273
- allows_byok: boolean;
2274
- available: boolean;
2275
- has_managed: boolean;
2276
- grant?: IntegrationGrant;
2277
- integration?: IntegrationDTO;
2278
- }
2279
- /**
2280
- * SecretFieldConfig defines a secret field for the UI
2281
- */
2282
- export interface SecretFieldConfig {
2283
- key: string;
2284
- label: string;
2285
- placeholder: string;
2286
- sensitive: boolean;
2287
- optional: boolean;
2288
- }
2289
2336
  export interface InterruptDTO extends BaseModelDTO, PermissionModelDTO {
2290
2337
  run_id: string;
2291
2338
  chat_id: string;
@@ -2349,6 +2396,10 @@ export interface SkillVersionDTO extends BaseModelDTO {
2349
2396
  export interface KnowledgeDTO extends BaseModelDTO, PermissionModelDTO {
2350
2397
  namespace: string;
2351
2398
  name: string;
2399
+ /**
2400
+ * Title is the human-readable name; empty falls back to Name.
2401
+ */
2402
+ title: string;
2352
2403
  description: string;
2353
2404
  type: KnowledgeType;
2354
2405
  lifecycle: KnowledgeLifecycle;
@@ -2618,6 +2669,10 @@ export interface MCPServerDTO {
2618
2669
  visibility: Visibility;
2619
2670
  slug: string;
2620
2671
  name: string;
2672
+ /**
2673
+ * Title is the human-readable name; empty falls back to Name.
2674
+ */
2675
+ title: string;
2621
2676
  description: string;
2622
2677
  icon_url: string;
2623
2678
  server_url: string;
@@ -2882,6 +2937,7 @@ export interface RefRouteDTO extends BaseModelDTO {
2882
2937
  */
2883
2938
  export interface KnowledgeCreateRequest {
2884
2939
  name: string;
2940
+ title?: string;
2885
2941
  description?: string;
2886
2942
  repo_url?: string;
2887
2943
  type?: KnowledgeType;
@@ -2913,6 +2969,7 @@ export interface KnowledgeVersionInput {
2913
2969
  * KnowledgeUpdateRequest is the request body for PUT /knowledge/{id}.
2914
2970
  */
2915
2971
  export interface KnowledgeUpdateRequest {
2972
+ title?: string;
2916
2973
  description?: string;
2917
2974
  version?: KnowledgeVersionInput;
2918
2975
  }
@@ -3081,7 +3138,7 @@ export interface SetupAction {
3081
3138
  */
3082
3139
  export interface CheckRequirementsRequest {
3083
3140
  secrets?: SecretRequirement[];
3084
- integrations?: IntegrationRequirement[];
3141
+ integrations?: CredentialRequirement[];
3085
3142
  }
3086
3143
  /**
3087
3144
  * CheckRequirementsResponse is the API response for checking requirements
@@ -3117,6 +3174,43 @@ export interface SecretDTO extends BaseModelDTO, PermissionModelDTO {
3117
3174
  masked_value: string;
3118
3175
  description?: string;
3119
3176
  scope?: SecretScope;
3177
+ /**
3178
+ * CredentialID is the credential this secret is attached to; empty for
3179
+ * a plain secret.
3180
+ */
3181
+ credential_id?: string;
3182
+ }
3183
+ /**
3184
+ * SocketAccess is where one end of a socket dials and the credential it
3185
+ * presents. The task's caller gets one in the run response; the worker gets
3186
+ * its own with the dispatch.
3187
+ * Browsers cannot set headers on a WebSocket: they append
3188
+ * `?access_token=<token>` to the URL. Everything else sends
3189
+ * `Authorization: Bearer <token>`.
3190
+ */
3191
+ export interface SocketAccess {
3192
+ id: string;
3193
+ url: string;
3194
+ token: string;
3195
+ expires_at: string;
3196
+ }
3197
+ /**
3198
+ * SocketDTO is a socket and what is known of its life. The traffic figures
3199
+ * come from the relay once the socket has closed.
3200
+ */
3201
+ export interface SocketDTO extends BaseModelDTO, PermissionModelDTO {
3202
+ task_id: string;
3203
+ relay: string;
3204
+ status: SocketStatus;
3205
+ paired_at?: string;
3206
+ ended_at?: string;
3207
+ outcome?: SocketOutcome;
3208
+ close_code?: number;
3209
+ close_reason?: string;
3210
+ client_frames: number;
3211
+ client_bytes: number;
3212
+ worker_frames: number;
3213
+ worker_bytes: number;
3120
3214
  }
3121
3215
  /**
3122
3216
  * MeStatsResponse is returned by GET /me/stats.
@@ -3364,6 +3458,11 @@ export interface TaskResultDTO {
3364
3458
  created_at: string;
3365
3459
  updated_at: string;
3366
3460
  run_at?: string;
3461
+ /**
3462
+ * Socket is set when the function is a stream function: the caller dials
3463
+ * it to talk to the app. POST /sockets/{id}/access issues a fresh one.
3464
+ */
3465
+ socket?: SocketAccess;
3367
3466
  }
3368
3467
  /**
3369
3468
  * TaskLogsDTO is a lightweight response for task logs endpoint.
@@ -3870,11 +3969,11 @@ export declare const ChatMessageContentTypeReasoning: ChatMessageContentType;
3870
3969
  export declare const ChatMessageContentTypeImage: ChatMessageContentType;
3871
3970
  export declare const ChatMessageContentTypeFile: ChatMessageContentType;
3872
3971
  export declare const ChatMessageContentTypeTool: ChatMessageContentType;
3873
- export type IntegrationType = string;
3874
- export declare const IntegrationTypeSlack: IntegrationType;
3875
- export declare const IntegrationTypeDiscord: IntegrationType;
3876
- export declare const IntegrationTypeTeams: IntegrationType;
3877
- export declare const IntegrationTypeTelegram: IntegrationType;
3972
+ export type ChannelType = string;
3973
+ export declare const ChannelTypeSlack: ChannelType;
3974
+ export declare const ChannelTypeDiscord: ChannelType;
3975
+ export declare const ChannelTypeTeams: ChannelType;
3976
+ export declare const ChannelTypeTelegram: ChannelType;
3878
3977
  /**
3879
3978
  * ChatData contains agent-specific data for a chat session
3880
3979
  */
@@ -3905,11 +4004,13 @@ export interface ChatMessageContent {
3905
4004
  tool_calls?: ToolCall[];
3906
4005
  }
3907
4006
  /**
3908
- * IntegrationContext holds integration-specific metadata for a chat
4007
+ * ChannelContext records which channel a chat or message came through
4008
+ * (slack, telegram, an OpenAI-dialect tag, ...) and the transport metadata
4009
+ * needed to route a reply back to it.
3909
4010
  */
3910
- export interface IntegrationContext {
3911
- integration_type?: IntegrationType;
3912
- integration_metadata?: any;
4011
+ export interface ChannelContext {
4012
+ channel_type?: ChannelType;
4013
+ channel_metadata?: any;
3913
4014
  }
3914
4015
  /**
3915
4016
  * EngineStatus represents the status of an engine.
@@ -4141,18 +4242,6 @@ export declare const ToolCallDelta_fieldTags: {
4141
4242
  readonly merge: "nested";
4142
4243
  };
4143
4244
  };
4144
- /**
4145
- * DeltaEvent is the generic streaming envelope on the NDJSON wire.
4146
- * Delta is raw bytes — consumers parse based on context.
4147
- */
4148
- export interface DeltaEvent {
4149
- delta: any;
4150
- seq: number;
4151
- }
4152
- /**
4153
- * LLMDeltaEvent is a typed alias for backward compatibility.
4154
- */
4155
- export type LLMDeltaEvent = DeltaEvent;
4156
4245
  /**
4157
4246
  * ToolCallFunctionDelta carries partial tool call function data.
4158
4247
  * Arguments is a raw JSON string fragment — concatenate by index, parse on completion.
@@ -4495,59 +4584,75 @@ export declare const ContentViolenceGraphic: ContentRating;
4495
4584
  export declare const ContentGore: ContentRating;
4496
4585
  export declare const ContentUnrated: ContentRating;
4497
4586
  /**
4498
- * IntegrationProvider represents an external integration provider.
4587
+ * CredentialProvider names the external service a credential is for.
4588
+ */
4589
+ export type CredentialProvider = string;
4590
+ /**
4591
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4592
+ */
4593
+ export declare const CredentialProviderGoogle: CredentialProvider;
4594
+ /**
4595
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4596
+ */
4597
+ export declare const CredentialProviderGoogleSA: CredentialProvider;
4598
+ /**
4599
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4499
4600
  */
4500
- export type IntegrationProvider = string;
4501
- export declare const IntegrationProviderGoogle: IntegrationProvider;
4502
- export declare const IntegrationProviderGoogleSA: IntegrationProvider;
4503
- export declare const IntegrationProviderSlack: IntegrationProvider;
4504
- export declare const IntegrationProviderNotion: IntegrationProvider;
4505
- export declare const IntegrationProviderGitHub: IntegrationProvider;
4506
- export declare const IntegrationProviderX: IntegrationProvider;
4507
- export declare const IntegrationProviderMicrosoft: IntegrationProvider;
4508
- export declare const IntegrationProviderSalesforce: IntegrationProvider;
4509
- export declare const IntegrationProviderDiscord: IntegrationProvider;
4510
- export declare const IntegrationProviderGCP: IntegrationProvider;
4511
- export declare const IntegrationProviderMCP: IntegrationProvider;
4512
- export declare const IntegrationProviderReddit: IntegrationProvider;
4601
+ export declare const CredentialProviderSlack: CredentialProvider;
4513
4602
  /**
4514
- * IntegrationAuthType describes the authentication mechanism of an integration.
4603
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4515
4604
  */
4516
- export type IntegrationAuthType = string;
4517
- export declare const IntegrationAuthTypeServiceAccount: IntegrationAuthType;
4518
- export declare const IntegrationAuthTypeOAuth: IntegrationAuthType;
4519
- export declare const IntegrationAuthTypeAPIKey: IntegrationAuthType;
4520
- export declare const IntegrationAuthTypeWIF: IntegrationAuthType;
4521
- export declare const IntegrationAuthTypeMCP: IntegrationAuthType;
4605
+ export declare const CredentialProviderNotion: CredentialProvider;
4522
4606
  /**
4523
- * IntegrationStatus represents the status of an integration connection.
4607
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4524
4608
  */
4525
- export type IntegrationStatus = string;
4526
- export declare const IntegrationStatusPending: IntegrationStatus;
4527
- export declare const IntegrationStatusConnected: IntegrationStatus;
4528
- export declare const IntegrationStatusDisconnected: IntegrationStatus;
4529
- export declare const IntegrationStatusExpired: IntegrationStatus;
4530
- export declare const IntegrationStatusError: IntegrationStatus;
4609
+ export declare const CredentialProviderGitHub: CredentialProvider;
4531
4610
  /**
4532
- * IntegrationScope controls credential resolution priority and ownership.
4611
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4533
4612
  */
4534
- export type IntegrationScope = string;
4535
- export declare const IntegrationScopeTeam: IntegrationScope;
4536
- export declare const IntegrationScopePlatform: IntegrationScope;
4537
- export declare const IntegrationScopeUser: IntegrationScope;
4613
+ export declare const CredentialProviderX: CredentialProvider;
4538
4614
  /**
4539
- * IntegrationGrant describes what an integration provides.
4615
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4540
4616
  */
4541
- export type IntegrationGrant = string;
4617
+ export declare const CredentialProviderMicrosoft: CredentialProvider;
4542
4618
  /**
4543
- * IntegrationGrantCredentials provides OAuth app credentials (client_id/secret).
4544
- * Users connect their own accounts against it. Only valid for type=oauth.
4619
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4545
4620
  */
4546
- export declare const IntegrationGrantCredentials: IntegrationGrant;
4621
+ export declare const CredentialProviderSalesforce: CredentialProvider;
4547
4622
  /**
4548
- * IntegrationGrantToken provides ready-to-use access (token, API key, etc.).
4623
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4549
4624
  */
4550
- export declare const IntegrationGrantToken: IntegrationGrant;
4625
+ export declare const CredentialProviderDiscord: CredentialProvider;
4626
+ /**
4627
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4628
+ */
4629
+ export declare const CredentialProviderGCP: CredentialProvider;
4630
+ /**
4631
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4632
+ */
4633
+ export declare const CredentialProviderMCP: CredentialProvider;
4634
+ /**
4635
+ * Credential.Provider is a plain string; cast with string(...) when assigning.
4636
+ */
4637
+ export declare const CredentialProviderReddit: CredentialProvider;
4638
+ /**
4639
+ * CredentialType describes the credential category.
4640
+ */
4641
+ export type CredentialType = string;
4642
+ export declare const CredentialTypeOAuth: CredentialType;
4643
+ export declare const CredentialTypeAPIKey: CredentialType;
4644
+ export declare const CredentialTypeMCP: CredentialType;
4645
+ export declare const CredentialTypeServiceAccount: CredentialType;
4646
+ export declare const CredentialTypeWIF: CredentialType;
4647
+ /**
4648
+ * CredentialStatus represents the lifecycle state of a credential.
4649
+ */
4650
+ export type CredentialStatus = string;
4651
+ export declare const CredentialStatusPending: CredentialStatus;
4652
+ export declare const CredentialStatusConnected: CredentialStatus;
4653
+ export declare const CredentialStatusDisconnected: CredentialStatus;
4654
+ export declare const CredentialStatusExpired: CredentialStatus;
4655
+ export declare const CredentialStatusError: CredentialStatus;
4551
4656
  /**
4552
4657
  * CredentialScope controls resolution priority and ownership.
4553
4658
  */
@@ -4563,6 +4668,12 @@ export declare const CredentialScopeOrg: CredentialScope;
4563
4668
  export declare const CredentialScopeTeam: CredentialScope;
4564
4669
  export declare const CredentialScopeUser: CredentialScope;
4565
4670
  export declare const CredentialScopeAgent: CredentialScope;
4671
+ /**
4672
+ * CredentialGrant describes what a credential provides.
4673
+ */
4674
+ export type CredentialGrant = string;
4675
+ export declare const CredentialGrantCredentials: CredentialGrant;
4676
+ export declare const CredentialGrantToken: CredentialGrant;
4566
4677
  /**
4567
4678
  * NotificationChannel represents a delivery channel
4568
4679
  */
@@ -4640,6 +4751,85 @@ export declare const NotificationStatusDelivered: NotificationStatus;
4640
4751
  export declare const NotificationStatusFailed: NotificationStatus;
4641
4752
  export declare const NotificationStatusBounced: NotificationStatus;
4642
4753
  export declare const NotificationStatusCancelled: NotificationStatus;
4754
+ /**
4755
+ * FunctionKind is how an app function talks to its caller.
4756
+ */
4757
+ export type FunctionKind = string;
4758
+ /**
4759
+ * FunctionKindRun takes an input and returns an output (optionally
4760
+ * yielding progress on the way). The zero value means this.
4761
+ */
4762
+ export declare const FunctionKindRun: FunctionKind;
4763
+ /**
4764
+ * FunctionKindStream holds a socket with the caller for the life of the
4765
+ * task: frames both ways, no input/output exchange.
4766
+ */
4767
+ export declare const FunctionKindStream: FunctionKind;
4768
+ /**
4769
+ * SocketStatus is where a socket is in its life.
4770
+ */
4771
+ export type SocketStatus = string;
4772
+ /**
4773
+ * SocketStatusPending: opened, and the two ends have not met yet. An end
4774
+ * that gave up waiting may dial again, so an unpaired end does not close
4775
+ * the socket; the task ending does.
4776
+ */
4777
+ export declare const SocketStatusPending: SocketStatus;
4778
+ /**
4779
+ * SocketStatusOpen: both ends are connected through the relay.
4780
+ */
4781
+ export declare const SocketStatusOpen: SocketStatus;
4782
+ /**
4783
+ * SocketStatusClosed: over. Outcome says why.
4784
+ */
4785
+ export declare const SocketStatusClosed: SocketStatus;
4786
+ /**
4787
+ * SocketOutcome is why a socket closed.
4788
+ */
4789
+ export type SocketOutcome = string;
4790
+ export declare const SocketOutcomeClientClosed: SocketOutcome;
4791
+ export declare const SocketOutcomeWorkerClosed: SocketOutcome;
4792
+ /**
4793
+ * SocketOutcomeDrained: the relay restarted under a live socket.
4794
+ */
4795
+ export declare const SocketOutcomeDrained: SocketOutcome;
4796
+ /**
4797
+ * SocketOutcomeNeverPaired: the task ended before the two ends met.
4798
+ */
4799
+ export declare const SocketOutcomeNeverPaired: SocketOutcome;
4800
+ /**
4801
+ * SocketOutcomeTaskEnded: the task ended and the relay's own account of
4802
+ * the socket has not arrived (yet).
4803
+ */
4804
+ export declare const SocketOutcomeTaskEnded: SocketOutcome;
4805
+ /**
4806
+ * DeltaEvent is the generic streaming envelope on the NDJSON wire.
4807
+ * Delta is raw bytes — consumers parse based on context.
4808
+ * It is deliberately not LLM-specific: agent lifecycle events and any future
4809
+ * delta producer share this envelope, which is why the identity field below is
4810
+ * a bare resource id rather than anything named after chat.
4811
+ */
4812
+ export interface DeltaEvent {
4813
+ delta: any;
4814
+ seq: number;
4815
+ /**
4816
+ * ResourceID names what this delta belongs to — for an LLM task, the
4817
+ * assistant chat message being generated.
4818
+ * Without it a consumer can only assume deltas belong to whatever it is
4819
+ * currently building, which breaks the moment a message carries no text
4820
+ * (a tool-call-only turn) and the previous message's state is still live.
4821
+ * The producer copies this from the graph and never interprets it: ids come
4822
+ * from one idgen space, so a consumer matches against the ids it already
4823
+ * tracks and buffers anything it does not recognise yet. A resource_type
4824
+ * companion is deliberately absent — nothing needs to route before matching.
4825
+ * Empty when the task has no execution edge (a plain app run).
4826
+ */
4827
+ resource_id?: string;
4828
+ }
4829
+ /**
4830
+ * LLMDeltaEvent is a typed alias for backward compatibility.
4831
+ */
4832
+ export type LLMDeltaEvent = DeltaEvent;
4643
4833
  /**
4644
4834
  * TaskStatus represents the state of a task in its lifecycle.
4645
4835
  */
@@ -4712,15 +4902,23 @@ export declare const RoleGuest: Role;
4712
4902
  export declare const RoleUser: Role;
4713
4903
  export declare const RoleAdmin: Role;
4714
4904
  export declare const RoleSystem: Role;
4905
+ export type UtilityPreset = string;
4906
+ export declare const UtilityPresetGate: UtilityPreset;
4907
+ export declare const UtilityPresetSelector: UtilityPreset;
4908
+ export declare const UtilityPresetMerge: UtilityPreset;
4909
+ export declare const UtilityPresetConstant: UtilityPreset;
4715
4910
  /**
4716
4911
  * UtilityConfig defines a flow utility node — gate, selector, merge, or custom CEL.
4717
4912
  */
4718
4913
  export interface UtilityConfig {
4719
- preset: string;
4914
+ preset: UtilityPreset;
4720
4915
  expression?: string;
4721
4916
  gate?: GateCondition;
4722
4917
  selector?: SelectorConfig;
4723
4918
  constant?: any;
4919
+ random?: boolean;
4920
+ random_min?: number;
4921
+ random_max?: number;
4724
4922
  }
4725
4923
  /**
4726
4924
  * AgentEventType identifies what happened in an agent run.