@vertesia/appgen-docs 1.6.0-dev.20261019.172735Z → 1.7.0-dev.20261120.100641Z

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.
@@ -10,7 +10,7 @@
10
10
  // -----------------------------------------------------------------------------
11
11
  // @vertesia/common: index.d.ts
12
12
  // -----------------------------------------------------------------------------
13
- export type { AudioResult, OpenAiAudioOptions, OpenAiImageGenerationMask, OpenAiImageGenerationOptions, OpenAiSpeechOptions, OpenAiTranscriptionOptions, VertexAIGeminiOmniVideoOptions, VideoResult, } from '@llumiverse/common';
13
+ export type { AudioResult, OpenAiAudioOptions, OpenAiImageGenerationMask, OpenAiImageGenerationOptions, OpenAiImageSvgOptions, OpenAiSpeechOptions, OpenAiTranscriptionOptions, VertexAIGeminiOmniVideoOptions, VideoResult, } from '@llumiverse/common';
14
14
  export * from './access-control.js';
15
15
  export * from './analytics.js';
16
16
  /**
@@ -28,7 +28,9 @@ export * from './audit-trail.js';
28
28
  export * from './browser-credentials.js';
29
29
  export * from './common.js';
30
30
  export * from './content-query.js';
31
+ export * from './content-sources.js';
31
32
  export * from './cost-analytics.js';
33
+ export * from './custom-roles.js';
32
34
  export * from './data-platform.js';
33
35
  export type { CreateDelegationGrantPayload, DelegationGrant, DelegationGrantArray, DelegationTokenClaim, } from './delegation.js';
34
36
  export * from './email.js';
@@ -36,13 +38,14 @@ export * from './embeddings.js';
36
38
  export * from './environment.js';
37
39
  export * from './facets.js';
38
40
  export * from './group.js';
39
- export type { CreateInferenceProfilePayload, InferenceProfile, InferenceProfileId, InferenceProfileName, InferenceProfileRecord, InferenceProfileRecordArray, InferenceProfileSnapshot, InferenceProfileUsage, InferenceProfileUsageEntry, InferenceProfileUsageQuery, InteractionConfigurationRecord, InteractionConfigurationResult, ProjectInferenceProfiles, UpdateInferenceProfilePayload, UpdateInteractionConfigurationPayload, } from './inference-profile.js';
41
+ export type { CreateInferenceProfilePayload, InferenceProfile, InferenceProfileId, InferenceProfileInvocation, InferenceProfileName, InferenceProfileRecord, InferenceProfileRecordArray, InferenceProfileSnapshot, InferenceProfileUsage, InferenceProfileUsageEntry, InferenceProfileUsageQuery, InteractionConfigurationRecord, InteractionConfigurationResult, ProjectInferenceProfiles, UpdateInferenceProfilePayload, UpdateInteractionConfigurationPayload, } from './inference-profile.js';
40
42
  export * from './integrations.js';
41
43
  export * from './interaction.js';
42
44
  export * from './json.js';
43
45
  export * from './json-schema.js';
44
46
  export * from './meters.js';
45
47
  export * from './model_utility.js';
48
+ export * from './notifications.js';
46
49
  export * from './oauth.js';
47
50
  export * from './oauth-scopes.js';
48
51
  export * from './oauth-server.js';
@@ -78,6 +81,7 @@ export type * from './utils/type-helpers.js';
78
81
  export * from './versions.js';
79
82
  export * from './views.js';
80
83
  export * from './workflow-analytics.js';
84
+ export type { WorkflowUsageClass, WorkflowUsageQuery, WorkflowUsageStanding } from './workflow-usage.js';
81
85
 
82
86
  // -----------------------------------------------------------------------------
83
87
  // @vertesia/common: apps.d.ts
@@ -120,6 +124,8 @@ export type AppInstallationProjectsQuery = Wire.AppInstallationProjectsQuery;
120
124
  export type AppInstallationsQuery = Wire.AppInstallationsQuery;
121
125
  export type AppListScope = Wire.AppListScope;
122
126
  export type AppsQuery = Wire.AppsQuery;
127
+ export type AppDeleteQuery = Wire.AppDeleteQuery;
128
+ export type AppRepoCommitsQuery = Wire.AppRepoCommitsQuery;
123
129
  export type ToolCollectionAuthType = Wire.ToolCollectionAuthType;
124
130
  export type MCPOAuthConfig = Wire.MCPOAuthConfig;
125
131
  /** Install-time provisioning blueprint for an `auth: 'api_key'` MCP collection. Never holds the key. */
@@ -174,6 +180,8 @@ export type AppCapabilities = Wire.AppCapabilities;
174
180
  export declare const APP_VERSION_HEADER = "x-vertesia-app-version";
175
181
  export type AppAvailableIn = Wire.AppAvailableIn;
176
182
  export type AppVersionKind = Wire.AppVersionKind;
183
+ export type AppDeploymentAlias = Wire.AppDeploymentAlias;
184
+ export type AppDeploymentAliasTarget = Wire.AppDeploymentAliasTarget;
177
185
  export type AppVersionState = Wire.AppVersionState;
178
186
  export type AppVersionTarget = Wire.AppVersionTarget;
179
187
  export type AppVersionGitRefType = Wire.AppVersionGitRefType;
@@ -181,7 +189,29 @@ export type AppBuildTrigger = Wire.AppBuildTrigger;
181
189
  export type AppVersionStorage = Wire.AppVersionStorage;
182
190
  export type AppVersionGitSource = Wire.AppVersionGitSource;
183
191
  export type AppVersionUrls = Wire.AppVersionUrls;
192
+ /**
193
+ * Stable, user-defined deployment alias (for example `production` or `customer-preview`).
194
+ *
195
+ * Aliases are deliberately DNS-label compatible so the app gateway can expose each alias through
196
+ * both a shared-origin path and a dedicated application hostname without a second naming rule.
197
+ */
198
+ export declare const APP_DEPLOYMENT_ALIAS_PATTERN: RegExp;
184
199
  export type AppVersionRecord = Wire.AppVersionRecord;
200
+ export interface AppGenTemplateMetadata {
201
+ name: string;
202
+ version: number;
203
+ runtime_features: Record<string, number>;
204
+ }
205
+ export declare const ADVANCED_APP_VERSION_LAUNCH_FEATURE = "advanced_launch";
206
+ export declare const ADVANCED_APP_VERSION_LAUNCH_PROTOCOL_VERSION = 1;
207
+ /** Read template provenance captured in an immutable AppGen version manifest. */
208
+ export declare function getAppGenTemplateMetadata(manifest: unknown): AppGenTemplateMetadata | undefined;
209
+ /** Return the protocol version implemented by one generated-app runtime feature. */
210
+ export declare function getAppVersionRuntimeFeatureVersion(manifest: unknown, feature: string): number | undefined;
211
+ export declare function supportsAdvancedAppVersionLaunch(manifest: unknown): boolean;
212
+ export type AppVersionLaunchTarget = Wire.AppVersionLaunchTarget;
213
+ export type CreateAppVersionLaunchRequest = Wire.CreateAppVersionLaunchRequest;
214
+ export type CreateAppVersionLaunchResponse = Wire.CreateAppVersionLaunchResponse;
185
215
  export type DeleteAppVersionResponse = Wire.DeleteAppVersionResponse;
186
216
  export type UpsertAppVersionRequest = Wire.UpsertAppVersionRequest;
187
217
  export interface AppVersionListQuery {
@@ -228,6 +258,8 @@ export type AppScaffoldProgress = Wire.AppScaffoldProgress;
228
258
  * Declared on the manifest as the app's default. May be overridden per-installation.
229
259
  */
230
260
  export type AppAccessControl = Wire.AppAccessControl;
261
+ /** The set of tools an app exposes to an external integration through the platform MCP server. */
262
+ export type AppMcpProfile = Wire.AppMcpProfile;
231
263
  export type AppManifestData = Wire.AppManifestData;
232
264
  export type UpdateAppPayload = Wire.UpdateAppPayload;
233
265
  export type AppGitSourceConfig = Wire.AppGitSourceConfig;
@@ -274,10 +306,7 @@ export type AppDevelopmentTaskList = Wire.AppDevelopmentTaskList;
274
306
  /** Development task details, including the latest parent assistant run when one exists. */
275
307
  export type AppDevelopmentTaskDetails = Wire.AppDevelopmentTaskDetails;
276
308
  /** Request to create a branch from an existing branch, tag, or commit. */
277
- export interface CreateAppRepoBranchRequest {
278
- name: string;
279
- source_ref: string;
280
- }
309
+ export type CreateAppRepoBranchRequest = Wire.CreateAppRepoBranchRequest;
281
310
  /** A newly created app repository branch. */
282
311
  export type AppRepoBranch = Wire.AppRepoBranch;
283
312
  /**
@@ -342,6 +371,7 @@ export type AppApiKeyCollectionParams = Wire.AppApiKeyCollectionParams;
342
371
  export type AppOAuthProviderParams = Wire.AppOAuthProviderParams;
343
372
  export type AppInstallationPayload = Wire.AppInstallationPayload;
344
373
  export type UpdateAppInstallationToolAllowlistPayload = Wire.UpdateAppInstallationToolAllowlistPayload;
374
+ export type UpdateAppInstallationToolPermissionsPayload = Wire.UpdateAppInstallationToolPermissionsPayload;
345
375
  export type AppInstallationKind = Wire.AppInstallationKind;
346
376
  /**
347
377
  * A description of the tools provided by an app
@@ -370,6 +400,7 @@ export type McpApiKeyStatus = Wire.McpApiKeyStatus;
370
400
  export type McpOAuthTokenRequest = Wire.McpOAuthTokenRequest;
371
401
  export type McpOAuthTokenResponse = Wire.McpOAuthTokenResponse;
372
402
  export type McpOAuthConnectResponse = Wire.McpOAuthConnectResponse;
403
+ export type McpOAuthExchangePayload = Wire.McpOAuthExchangePayload;
373
404
  export type McpOAuthDisconnectResponse = Wire.McpOAuthDisconnectResponse;
374
405
  /**
375
406
  * Response from OAuth metadata endpoint
@@ -459,6 +490,12 @@ export interface CompositeAppMenuNavItem {
459
490
  description?: string | null;
460
491
  /** When true, this item is excluded from the Composite App dashboard cards */
461
492
  hideFromDashboard?: boolean;
493
+ /**
494
+ * When true, this item navigates to the App Portal form of the URL
495
+ * (`/apps/<appName><route>`) instead of the Composite App form (`/app/<appName><route>`),
496
+ * so the app is opened standalone rather than inside the Composite App shell.
497
+ */
498
+ openInAppPortal?: boolean;
462
499
  /** Optional access control settings for this nav item */
463
500
  permissions?: CompositeAppNavItemPermissions;
464
501
  /** Ordered child nav-items */
@@ -633,6 +670,11 @@ export type DataStoreVersionTableState = Wire.DataStoreVersionTableState;
633
670
  export type DataStoreVersion = Wire.DataStoreVersion;
634
671
  export type ListDataStoreVersionsQuery = Wire.ListDataStoreVersionsQuery;
635
672
  export type GetDataStoreTableQuery = Wire.GetDataStoreTableQuery;
673
+ export type GetDataStoreSchemaQuery = Wire.GetDataStoreSchemaQuery;
674
+ export type ListDataStoreSchemaHistoryQuery = Wire.ListDataStoreSchemaHistoryQuery;
675
+ export type CreateDataStoreDownloadUrlQuery = Wire.CreateDataStoreDownloadUrlQuery;
676
+ export type ListDashboardsQuery = Wire.ListDashboardsQuery;
677
+ export type ListDashboardVersionsQuery = Wire.ListDashboardVersionsQuery;
636
678
  /**
637
679
  * Import job status.
638
680
  */
@@ -662,6 +704,12 @@ export type CreateTablePayload = Wire.CreateTablePayload;
662
704
  export type CreateTablesPayload = Wire.CreateTablesPayload;
663
705
  export type QueryValidationPayload = Wire.QueryValidationPayload;
664
706
  export type BatchQueryPayload = Wire.BatchQueryPayload;
707
+ export type AlterTableAddColumnOperation = Wire.AlterTableAddColumnOperation;
708
+ export type AlterTableDropColumnOperation = Wire.AlterTableDropColumnOperation;
709
+ export type AlterTableRenameColumnOperation = Wire.AlterTableRenameColumnOperation;
710
+ export type AlterTableModifyColumnOperation = Wire.AlterTableModifyColumnOperation;
711
+ export type AlterTableAddForeignKeyOperation = Wire.AlterTableAddForeignKeyOperation;
712
+ export type AlterTableDropForeignKeyOperation = Wire.AlterTableDropForeignKeyOperation;
665
713
  /**
666
714
  * Schema change operation types.
667
715
  */
@@ -734,6 +782,7 @@ export type DataStoreSchemaResponse = Wire.DataStoreSchemaResponse;
734
782
  export type DataStoreTableDetail = Wire.DataStoreTableDetail;
735
783
  export type DataStoreTableDropResult = Wire.DataStoreTableDropResult;
736
784
  export type DashboardArchiveResult = Wire.DashboardArchiveResult;
785
+ export type DashboardBulkIdsPayload = Wire.DashboardBulkIdsPayload;
737
786
  export type DashboardBulkArchiveResult = Wire.DashboardBulkArchiveResult;
738
787
  export type DashboardBulkDeleteResult = Wire.DashboardBulkDeleteResult;
739
788
  export type DashboardVersioningStatusResponse = Wire.DashboardVersioningStatusResponse;
@@ -820,6 +869,8 @@ export declare const DEFAULT_DASHBOARD_LAYOUT: DashboardLayout;
820
869
  * Queries execute through Vertesia Store, so project/security filtering remains server-side.
821
870
  */
822
871
  export type DashboardElasticsearchDsl = Wire.DashboardElasticsearchDsl;
872
+ export type DashboardElasticsearchHitsMapping = Wire.DashboardElasticsearchHitsMapping;
873
+ export type DashboardElasticsearchAggregationBucketsMapping = Wire.DashboardElasticsearchAggregationBucketsMapping;
823
874
  /**
824
875
  * How an Elasticsearch DSL result should be converted into Vega rows.
825
876
  */
@@ -872,6 +923,34 @@ export type CreateDashboardPayload = Wire.CreateDashboardPayload;
872
923
  * Payload for updating a dashboard.
873
924
  */
874
925
  export type UpdateDashboardPayload = Wire.UpdateDashboardPayload;
926
+ /**
927
+ * Options for exporting a saved dashboard as an image.
928
+ */
929
+ export type ExportDashboardPayload = Wire.ExportDashboardPayload;
930
+ /**
931
+ * An unsaved dashboard (SQL query and Vega-Lite spec) to render as an image.
932
+ */
933
+ export type ExportDashboardPreviewPayload = Wire.ExportDashboardPreviewPayload;
934
+ /**
935
+ * Status of a dashboard export.
936
+ */
937
+ export declare const DashboardExportStatus: {
938
+ /** The image is being rendered */
939
+ readonly RUNNING: 'running';
940
+ /** The image is ready to download */
941
+ readonly COMPLETED: 'completed';
942
+ /** The export failed; its `error` says why */
943
+ readonly FAILED: 'failed';
944
+ };
945
+ export type DashboardExportStatus = Wire.DashboardExportStatus;
946
+ /**
947
+ * Why a dashboard export failed.
948
+ */
949
+ export type DashboardExportError = Wire.DashboardExportError;
950
+ /**
951
+ * A dashboard export: `running` until it is `completed`, with a signed download URL, or `failed`.
952
+ */
953
+ export type DashboardExport = Wire.DashboardExport;
875
954
  /**
876
955
  * Options for rendering a dashboard.
877
956
  */
@@ -926,6 +1005,8 @@ export type InteractionExecutionError = Wire.InteractionExecutionError;
926
1005
  * to prevent JSON serialization issues and reduce storage bloat.
927
1006
  */
928
1007
  export type ConversationStripOptions = Wire.ConversationStripOptions;
1008
+ /** On-demand compaction of a resumed conversation (`UserMessagePayload.compact_conversation`). */
1009
+ export type CompactConversationOptions = Wire.CompactConversationOptions;
929
1010
  /**
930
1011
  * Reference to an interaction in the catalog.
931
1012
  * Used in catalog listing. The id is composed of the namespace and the interaction name.
@@ -933,6 +1014,13 @@ export type ConversationStripOptions = Wire.ConversationStripOptions;
933
1014
  * If no prefix is used it fallback on `oid:`.
934
1015
  */
935
1016
  export type CatalogInteractionRef = Wire.CatalogInteractionRef;
1017
+ export type CatalogAgentSearchQuery = Wire.CatalogAgentSearchQuery;
1018
+ export type CatalogCallSearchQuery = Wire.CatalogCallSearchQuery;
1019
+ /** An interaction found by a catalog search: a system or app interaction, or a stored one with its model, prompts and update time. */
1020
+ export type CatalogSearchInteractionRef = Wire.CatalogSearchInteractionRef;
1021
+ export type CatalogTagCount = Wire.CatalogTagCount;
1022
+ /** A catalog search result: the matching interactions, their tag counts and the total. */
1023
+ export type CatalogSearchResult = Wire.CatalogSearchResult;
936
1024
  export interface CatalogTagQuery {
937
1025
  tag?: string;
938
1026
  }
@@ -940,13 +1028,14 @@ export interface StoredCatalogInteractionsQuery extends CatalogTagQuery {
940
1028
  status?: string;
941
1029
  published?: boolean;
942
1030
  }
943
- export interface ExecuteInteractionByEndpointQuery {
944
- tag?: string;
945
- }
1031
+ export type ExecuteNamedInteractionQuery = Wire.ExecuteNamedInteractionQuery;
1032
+ export type GetRunQuery = Wire.GetRunQuery;
1033
+ export type ExecuteInteractionByEndpointQuery = Wire.ExecuteInteractionByEndpointQuery;
946
1034
  export interface ExecuteInteractionByEndpointHeaders {
947
1035
  'x-interaction-tag'?: string;
948
1036
  }
949
1037
  export type ResolveInteractionQuery = Wire.ResolveInteractionQuery;
1038
+ export type DeleteInteractionQuery = Wire.DeleteInteractionQuery;
950
1039
  export type InCodePrompt = Wire.InCodePrompt;
951
1040
  export type InCodeInteraction = Wire.InCodeInteraction;
952
1041
  export type ResolvedCatalogInteraction = Wire.ResolvedCatalogInteraction;
@@ -1199,15 +1288,8 @@ export interface InteractionExecutionResult<P = unknown> extends Omit<ExecutionR
1199
1288
  }
1200
1289
  export type ExecutionRunRef = Wire.ExecutionRunRef;
1201
1290
  export type InteractionExecutionConfiguration = Wire.InteractionExecutionConfiguration;
1202
- export type GenerateInteractionPayload = Wire.GenerateInteractionPayload;
1203
1291
  export type GenerateTestDataPayload = Wire.GenerateTestDataPayload;
1204
1292
  export type GeneratedTestDataRecord = Wire.GeneratedTestDataRecord;
1205
- export type ImprovePromptPayloadConfig = Wire.ImprovePromptPayloadConfig;
1206
- export type ImprovePromptPayload = Wire.ImprovePromptPayload;
1207
- export type GeneratedInteractionPromptTemplate = Wire.GeneratedInteractionPromptTemplate;
1208
- export type GeneratedInteractionPromptSegment = Wire.GeneratedInteractionPromptSegment;
1209
- export type GeneratedInteractionDefinition = Wire.GeneratedInteractionDefinition;
1210
- export type PromptImprovementResponse = Wire.PromptImprovementResponse;
1211
1293
  export type RateLimitRequestPayload = Wire.RateLimitRequestPayload;
1212
1294
  export type RateLimitRequestResponse = Wire.RateLimitRequestResponse;
1213
1295
  /**
@@ -2016,6 +2098,12 @@ export declare enum ContentNature {
2016
2098
  Code = "code",
2017
2099
  Other = "other"
2018
2100
  }
2101
+ /**
2102
+ * Whether a MIME type is a video: any `video/*` type, or a video container registered under `application/*`.
2103
+ * Types that may hold audio only, such as `application/mp4` and `application/ogg`, are not counted. MIME types are
2104
+ * case-insensitive and may carry parameters (`application/MXF; foo=bar`), so both are ignored.
2105
+ */
2106
+ export declare function isVideoContentType(contentType: string | undefined): boolean;
2019
2107
  export interface Dimensions {
2020
2108
  width: number;
2021
2109
  height: number;
@@ -2036,6 +2124,61 @@ export declare const POSTER_RENDITION_NAME = "Poster";
2036
2124
  export declare const AUDIO_RENDITION_NAME = "Audio";
2037
2125
  export declare const WEB_VIDEO_RENDITION_NAME = "Web";
2038
2126
  export declare const PDF_RENDITION_NAME = "PDF";
2127
+ /**
2128
+ * Request header sent by a workflow that can wait for media renditions still being generated. With it,
2129
+ * the execute endpoint answers 412 and lists the pending objects instead of rendering a media input from
2130
+ * its original source.
2131
+ */
2132
+ export declare const RENDITION_WAIT_HEADER = "x-vertesia-rendition-wait";
2133
+ /**
2134
+ * Renditions that intake has started but not stored yet. `etag` is the key the renditions are stored under (the
2135
+ * content etag, or the object id when the content has none), so a marker left from earlier content does not apply to
2136
+ * the current content.
2137
+ */
2138
+ export interface PendingRenditionNames {
2139
+ etag: string;
2140
+ names: string[];
2141
+ }
2142
+ /** A media input whose rendition is still being generated. */
2143
+ export interface PendingRendition {
2144
+ object_id: string;
2145
+ kind: 'video' | 'image';
2146
+ }
2147
+ /** A user of the external system a content source reads, as that system reports them. */
2148
+ export interface ContentSourcePerson {
2149
+ /** The system's own ID for the user. */
2150
+ id?: string;
2151
+ name?: string;
2152
+ email?: string;
2153
+ }
2154
+ /**
2155
+ * The widest audience a file's sharing links reach: anyone with the link, everyone in the organization, or specific
2156
+ * people. `none` when the file has no sharing link. Permissions granted without a link are not reflected.
2157
+ */
2158
+ export type ContentSourceSharing = 'none' | 'anonymous' | 'organization' | 'users';
2159
+ /** What the external system reports about a synced file, kept at `metadata.source`. */
2160
+ export interface ContentSourceItemMetadata {
2161
+ /** The system the file is in, such as `sharepoint` or `box`. */
2162
+ provider: string;
2163
+ /** The file's ID in that system, stable across renames and moves. */
2164
+ item_id: string;
2165
+ /** The ID of the folder that holds the file. */
2166
+ folder_id?: string;
2167
+ /** Opens the file in the system. */
2168
+ web_url?: string;
2169
+ /** Bytes, as the system reports them. */
2170
+ size?: number;
2171
+ /** ISO 8601. */
2172
+ created_at?: string;
2173
+ /** ISO 8601: the last change the system recorded, to the bytes or to the file's metadata. */
2174
+ modified_at?: string;
2175
+ created_by?: ContentSourcePerson;
2176
+ modified_by?: ContentSourcePerson;
2177
+ /** Absent when the system did not report it. */
2178
+ sharing?: ContentSourceSharing;
2179
+ /** Changes whenever another field changes: the sync rewrites the block only then. */
2180
+ digest: string;
2181
+ }
2039
2182
  export interface ContentMetadata {
2040
2183
  type?: ContentNature;
2041
2184
  size?: number;
@@ -2046,11 +2189,18 @@ export interface ContentMetadata {
2046
2189
  /** ETag of text materialized from object properties by intake rendering. */
2047
2190
  rendered_text_etag?: string;
2048
2191
  renditions?: Rendition[];
2192
+ /** Renditions still being generated for the current content. Each name is removed once it is stored or abandoned. */
2193
+ pending_renditions?: PendingRenditionNames;
2049
2194
  /**
2050
2195
  * Embedded/technical metadata harvested from the source file by intake
2051
2196
  * (office docProps, PDF docinfo). Free-form, nature-appropriate keys.
2052
2197
  */
2053
2198
  embedded?: Record<string, unknown>;
2199
+ /**
2200
+ * What the external system a content source synced the object from reports about the file. Written only by the
2201
+ * sync; an update through the objects API keeps the stored value.
2202
+ */
2203
+ source?: ContentSourceItemMetadata;
2054
2204
  /** Type-detection provenance recorded by the intake sniff pipeline. */
2055
2205
  type_detection?: TypeDetectionMetadata;
2056
2206
  /** Locate-pass provenance: which pages the document map found relevant. */
@@ -2342,6 +2492,19 @@ export type SetFileMetadataPayload = Wire.SetFileMetadataPayload;
2342
2492
  export type FileMetadataUpdateResult = Wire.FileMetadataUpdateResult;
2343
2493
  export type BulkUploadUrlsPayload = Wire.BulkUploadUrlsPayload;
2344
2494
  export type BulkUploadUrlsResponse = Wire.BulkUploadUrlsResponse;
2495
+ export type CreateUploadSessionPayload = Wire.CreateUploadSessionPayload;
2496
+ export type GcsResumableUploadSession = Wire.GcsResumableUploadSession;
2497
+ export type AzureBlockBlobUploadSession = Wire.AzureBlockBlobUploadSession;
2498
+ export type S3MultipartUploadSession = Wire.S3MultipartUploadSession;
2499
+ export type UploadSession = Wire.UploadSession;
2500
+ export type GetUploadPartUrlsPayload = Wire.GetUploadPartUrlsPayload;
2501
+ export type UploadPartUrl = Wire.UploadPartUrl;
2502
+ export type UploadPartUrlsResponse = Wire.UploadPartUrlsResponse;
2503
+ export type CompletedUploadPart = Wire.CompletedUploadPart;
2504
+ export type CompleteUploadSessionPayload = Wire.CompleteUploadSessionPayload;
2505
+ export type CompleteUploadSessionResponse = Wire.CompleteUploadSessionResponse;
2506
+ export type AbortUploadSessionPayload = Wire.AbortUploadSessionPayload;
2507
+ export type AbortUploadSessionResponse = Wire.AbortUploadSessionResponse;
2345
2508
  export type FileBucketResponse = Wire.FileBucketResponse;
2346
2509
  export type FileListResponse = Wire.FileListResponse;
2347
2510
  export type FileMetadataQuery = Wire.FileMetadataQuery;
@@ -2483,6 +2646,7 @@ export type CollectionSecuritySettingsResponse = Wire.CollectionSecuritySettings
2483
2646
  export type CollectionPropagationResponse = Wire.CollectionPropagationResponse;
2484
2647
  export type CollectionChildrenUpdateResult = Wire.CollectionChildrenUpdateResult;
2485
2648
  export type CollectionMembersUpdatePayload = Wire.CollectionMembersUpdatePayload;
2649
+ export type CollectionPermissionsPayload = Wire.CollectionPermissionsPayload;
2486
2650
  export type CollectionChildrenUpdatePayload = Wire.CollectionChildrenUpdatePayload;
2487
2651
  export type CollectionMembersQuery = Wire.CollectionMembersQuery;
2488
2652
  export type UpdateCollectionPayload = Wire.UpdateCollectionPayload;
@@ -2490,6 +2654,7 @@ export type UpdateCollectionPayload = Wire.UpdateCollectionPayload;
2490
2654
  // -----------------------------------------------------------------------------
2491
2655
  // @vertesia/common: store/process.d.ts
2492
2656
  // -----------------------------------------------------------------------------
2657
+ import type { ModelOptions } from '@llumiverse/common';
2493
2658
  import type { JSONSchema } from '../json-schema.js';
2494
2659
  import type * as Wire from '../wire-types.generated.js';
2495
2660
  export type JsonLogicRule = Wire.JsonLogicRule;
@@ -2527,7 +2692,26 @@ export interface BranchNodeBranchDefinition {
2527
2692
  export type HumanTaskDefinition = Wire.HumanTaskDefinition;
2528
2693
  export type ProcessNodeReturnsDefinition = Wire.ProcessNodeReturnsDefinition;
2529
2694
  export type ParallelCollectDefinition = Wire.ParallelCollectDefinition;
2530
- export interface NodeDefinition {
2695
+ /**
2696
+ * How a process, or one of its LLM nodes, chooses its model: an inference profile, or an environment with an
2697
+ * optional model and model options, the same choice an interaction offers. Each level is one whole choice: a node
2698
+ * that selects anything ignores the run config and definition selections, and a run config selection ignores the
2699
+ * definition's. A level that selects nothing falls through to the next, then to the interaction or agent defaults.
2700
+ */
2701
+ export interface ProcessModelSelection {
2702
+ /** Inference profile supplying the environment, model and model options. Excludes the other fields. */
2703
+ inference_profile?: string;
2704
+ /** Environment id, with `model` or alone to use the environment default model. */
2705
+ environment?: string;
2706
+ /**
2707
+ * Model id in `environment`. A model without an environment is accepted only in definitions saved before
2708
+ * environments were required; saving one is rejected.
2709
+ */
2710
+ model?: string;
2711
+ /** Model options for `environment` and `model`. */
2712
+ model_options?: ModelOptions;
2713
+ }
2714
+ export interface NodeDefinition extends ProcessModelSelection {
2531
2715
  type: ProcessNodeType;
2532
2716
  tool?: string;
2533
2717
  /** Named entry in process resources.scripts for script nodes. */
@@ -2576,13 +2760,6 @@ export interface NodeDefinition {
2576
2760
  excluded_tools?: string[];
2577
2761
  /** Process-owned successful-tool phases and completion behavior for this agent node. */
2578
2762
  agent_policy?: ProcessAgentExecutionPolicy;
2579
- /**
2580
- * Model id override for this node. If unset, falls back to the process
2581
- * run's `config.model`, then to the project's default. Useful when a
2582
- * specific node needs heavier reasoning (e.g. Opus for legal flagging)
2583
- * while the rest of the process uses a cheaper default.
2584
- */
2585
- model?: string;
2586
2763
  task?: HumanTaskDefinition;
2587
2764
  foreach?: string;
2588
2765
  as?: string;
@@ -2596,12 +2773,11 @@ export interface NodeDefinition {
2596
2773
  metadata?: ProcessDefinitionMetadata;
2597
2774
  }
2598
2775
  export type ProcessContextDefinition = Wire.ProcessContextDefinition;
2599
- export interface ProcessDefinitionBody {
2776
+ export interface ProcessDefinitionBody extends ProcessModelSelection {
2600
2777
  format_version: ProcessDefinitionFormatVersion;
2601
2778
  process: string;
2602
2779
  description?: string;
2603
2780
  initial: string;
2604
- model?: string;
2605
2781
  resources?: ProcessResourcesDefinition;
2606
2782
  context: ProcessContextDefinition;
2607
2783
  nodes: Record<string, NodeDefinition>;
@@ -2657,26 +2833,19 @@ export interface CreateProcessDefinitionPayload {
2657
2833
  * @deprecated Process definitions are created as drafts. Use the publish endpoint
2658
2834
  * to create immutable published versions.
2659
2835
  */
2660
- status?: ProcessDefinitionStatus;
2836
+ status?: 'draft';
2661
2837
  /**
2662
2838
  * @deprecated Version is server-owned. Use the publish endpoint to create the next version.
2663
2839
  */
2664
- version?: number;
2840
+ version?: 1;
2665
2841
  tags?: string[];
2666
2842
  definition: ProcessDefinitionBody;
2667
2843
  }
2844
+ /** A draft edit. `status` and `version` are server-owned: use the publish, archive and revert endpoints. */
2668
2845
  export interface UpdateProcessDefinitionPayload {
2669
2846
  expected_edit_revision?: number;
2670
2847
  name?: string;
2671
2848
  description?: string;
2672
- /**
2673
- * @deprecated Status is server-owned. Use publish/archive endpoints instead of updating it directly.
2674
- */
2675
- status?: ProcessDefinitionStatus;
2676
- /**
2677
- * @deprecated Version is server-owned. Use the publish endpoint to create the next version.
2678
- */
2679
- version?: number;
2680
2849
  tags?: string[];
2681
2850
  definition?: ProcessDefinitionBody;
2682
2851
  }
@@ -2889,6 +3058,9 @@ export type ChildWorkflowTask = Wire.ChildWorkflowTask;
2889
3058
  export type SignalTask = Wire.SignalTask;
2890
3059
  export type TimerTask = Wire.TimerTask;
2891
3060
  export type WorkflowTask = Wire.WorkflowTask;
3061
+ export type WorkflowEventsHistory = Wire.WorkflowEventsHistory;
3062
+ export type WorkflowTasksHistory = Wire.WorkflowTasksHistory;
3063
+ export type WorkflowAgentHistory = Wire.WorkflowAgentHistory;
2892
3064
  export type WorkflowHistory = Wire.WorkflowHistory;
2893
3065
  export type AgentTask = Wire.AgentTask;
2894
3066
  export type WorkflowRun = Wire.WorkflowRun;
@@ -3159,6 +3331,8 @@ export interface ConversationFileRemovedRef {
3159
3331
  }
3160
3332
  export type PlanTask = Wire.PlanTask;
3161
3333
  export type Plan = Wire.Plan;
3334
+ /** Route explicitly to the environment's regular worker pool. */
3335
+ export declare const NORMAL_PRIORITY_TASK_QUEUE = "normal_priority";
3162
3336
  export declare const LOW_PRIORITY_TASK_QUEUE = "low_priority";
3163
3337
  /**
3164
3338
  * WebSocket message types for bidirectional communication
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vertesia/appgen-docs",
3
- "version": "1.6.0-dev.20261019.172735Z",
3
+ "version": "1.7.0-dev.20261120.100641Z",
4
4
  "description": "Generated SDK references and development guidance for Vertesia app agents",
5
5
  "type": "module",
6
6
  "main": "./lib/index.js",
@@ -16,11 +16,11 @@
16
16
  }
17
17
  },
18
18
  "devDependencies": {
19
- "@types/node": "^24.19.1",
20
- "@vertesia/client": "1.6.0-dev.20261019.172735Z",
21
- "@vertesia/common": "1.6.0-dev.20261019.172735Z",
19
+ "@types/node": "^24.19.2",
20
+ "@vertesia/client": "1.7.0-dev.20261120.100641Z",
21
+ "@vertesia/common": "1.7.0-dev.20261120.100641Z",
22
22
  "@vertesia/tsconfig": "0.1.0",
23
- "@vertesia/ui": "1.6.0-dev.20261019.172735Z",
23
+ "@vertesia/ui": "1.7.0-dev.20261120.100641Z",
24
24
  "typescript": "7.0.2"
25
25
  },
26
26
  "repository": {
@@ -34,9 +34,15 @@
34
34
  "documentation",
35
35
  "app-development"
36
36
  ],
37
- "gitHead": "85a3010750ab97192d236928b1fca55015a18000",
37
+ "gitHead": "0b4dcc5c9e17a0fdb8771fee841f98efac7e2a2c",
38
+ "releaseIdentity": {
39
+ "source_sha": "0b4dcc5c9e17a0fdb8771fee841f98efac7e2a2c",
40
+ "dependency_sha": "03036cb597143f5875280772be09363dd03a815b",
41
+ "lock_sha256": "cb02511f3cf2336c054ce40df0fded2a938cf3f192df24b3f73586f0050a4ea0"
42
+ },
38
43
  "scripts": {
39
- "build": "pnpm run clean && tsc --checkers 1 -p tsconfig.json && node ./scripts/generate-docs.mjs",
44
+ "build": "pnpm run clean && tsc --checkers 1 -p tsconfig.json",
45
+ "build:docs": "node ./scripts/generate-docs.mjs",
40
46
  "clean": "rimraf ./lib ./docs ./tsconfig.tsbuildinfo",
41
47
  "lint": "biome lint src scripts",
42
48
  "test": "node --test ./scripts/*.test.mjs"