@vertesia/appgen-docs 1.6.0-dev.20260918.090710Z → 1.6.0-dev.20260923.085325Z

package/lib/docs/ui-interfaces.d.ts

@@ -910,6 +910,7 @@ export {};
 export * from './auth/composable';
 export { clearCentralAuthRoundTripMarker, isCentralAuthRedirectPending, redirectToCentralAuth, } from './auth/domainRouting';
 export * from './auth/firebase';
+export { isAppOAuthLoginPending, startAppOAuthLogin } from './auth/oauth';
 export * from './auth/useAuthState';
 export * from './auth/useCurrentTenant';
 export * from './DevSessionProvider';
@@ -925,9 +926,12 @@ import type { AuthTokenPayload } from '@vertesia/common';
 import { LastSelectedAccountId_KEY, LastSelectedProjectId_KEY } from './constants';
 export { LastSelectedAccountId_KEY, LastSelectedProjectId_KEY };
 export interface UserSessionLoginOptions {
+    /** Studio-only onboarding; custom apps leave this disabled. */
     loadOnboardingStatus?: boolean;
+    authMethod?: 'token' | 'oauth';
 }
 declare class UserSession {
+    private authMethod;
     isLoading: boolean;
     client: VertesiaClient;
     authError?: Error;

package/lib/docs/vertesia-client.d.ts

@@ -20,6 +20,7 @@ export { default as DelegationGrantsApi } from './DelegationGrantsApi.js';
 export type { GroupsQueryOptions } from './GroupsApi.js';
 export * from './InteractionBase.js';
 export * from './InteractionOutput.js';
+export { default as InternalAccountsApi } from './InternalAccountsApi.js';
 export { default as InternalSecretsApi } from './InternalSecretsApi.js';
 export * from './managed-sse.js';
 export { default as OAuthClientsApi } from './OAuthClientsApi.js';
@@ -39,6 +40,7 @@ export type { AsyncExecutionResult };
 // @vertesia/client: client.d.ts
 // -----------------------------------------------------------------------------
 import { AbstractFetchClient, type FETCH_FN, type IRequestRetryPolicy } from '@vertesia/api-fetch-client';
+import type { AppSessionTokenRequest, AppSessionTokenResponse } from '@vertesia/common';
 import { type AuthTokenPayload, type AuthTokenResponse } from '@vertesia/common';
 import AccountApi from './AccountApi.js';
 import AccountsApi from './AccountsApi.js';
@@ -199,6 +201,7 @@ export declare class VertesiaClient extends AbstractFetchClient<VertesiaClient>
      *
      * @returns AuthTokenResponse
      */
+    mintAppSessionToken(request: AppSessionTokenRequest): Promise<AppSessionTokenResponse>;
     getAuthToken(token?: string): Promise<AuthTokenResponse>;
     get initialHeaders(): {
         "x-api-version": string;
@@ -415,6 +418,11 @@ export default class AppsApi extends ApiTopic {
      */
     listInstallations(): Promise<AppInstallation[]>;
     updateInstallationSettings(settingsPayload: AppInstallationPayload): Promise<AppInstallationWithManifest>;
+    /**
+     * Set project-admin approval for an installation's OAuth scopes.
+     * Pass an empty list to revoke approval.
+     */
+    updateOAuthApproval(installId: string, approved_scopes: string[]): Promise<AppInstallationWithManifest>;
     /**
      * Update the tool allowlist for an app installation.
      * Pass null to remove all restrictions (all tools permitted).
@@ -3901,7 +3909,7 @@ export {};
 // @vertesia/common: apps.d.ts
 // -----------------------------------------------------------------------------
 import type { z } from 'zod';
-import type { AgentToolApprovalClassSchema, AgentToolDefinitionSchema, AppApiKeyCollectionParamsSchema, AppBuildProgressSchema, AppBuildProgressStatusSchema, AppBuildTriggerSchema, AppDeleteSummarySchema, AppDevelopmentTaskDetailsSchema, AppDevelopmentTaskListSchema, AppDevelopmentTaskSchema, AppInspectionCapabilityReportSchema, AppInspectionIssueSchema, AppInspectionResultSchema, AppInstallationKindSchema, AppInstallationOAuthBindingSchema, AppInstallationPayloadSchema, AppInstallationProjectsQuerySchema, AppInstallationProviderBindingSchema, AppInstallationsQuerySchema, AppListScopeSchema, AppOAuthCollectionParamsSchema, AppOAuthProviderParamsSchema, AppRepoBranchSchema, AppRepoCommitSchema, AppRepoCommitsSchema, AppRepoDocumentCommitSchema, AppRepoRefSchema, AppRepoRefsSchema, AppRepoTreeEntrySchema, AppRepoTreeSchema, AppScaffoldModuleSchema, AppScaffoldProgressSchema, AppScaffoldProgressStatusSchema, AppsQuerySchema, AppToolCollectionSchema, AppVersionGitRefTypeSchema, AppVersionGitSourceSchema, AppVersionKindSchema, AppVersionRecordSchema, AppVersionStateSchema, AppVersionStorageSchema, AppVersionTargetSchema, AppVersionUrlsSchema, DeleteAppVersionResponseSchema, McpApiKeyCredentialSchema, OAuthClientCredentialsSchema, StartAppBuildRequestSchema, StartAppBuildResponseSchema, StartAppDevelopmentTaskRequestSchema, StartAppScaffoldRequestSchema, StartAppScaffoldResponseSchema, UpdateAppInstallationToolAllowlistPayloadSchema, UpsertAppVersionRequestSchema, ValidateUrlRequestSchema, ValidateUrlResponseSchema } from './api-schemas/app-lifecycle.js';
+import type { AgentToolApprovalClassSchema, AgentToolDefinitionSchema, AppApiKeyCollectionParamsSchema, AppBuildProgressSchema, AppBuildProgressStatusSchema, AppBuildTriggerSchema, AppDeleteSummarySchema, AppDevelopmentTaskDetailsSchema, AppDevelopmentTaskListSchema, AppDevelopmentTaskSchema, AppInspectionCapabilityReportSchema, AppInspectionIssueSchema, AppInspectionResultSchema, AppInstallationKindSchema, AppInstallationOAuthBindingSchema, AppInstallationPayloadSchema, AppInstallationProjectsQuerySchema, AppInstallationProviderBindingSchema, AppInstallationsQuerySchema, AppListScopeSchema, AppOAuthCollectionParamsSchema, AppOAuthProviderParamsSchema, AppRepoBranchSchema, AppRepoCommitSchema, AppRepoCommitsSchema, AppRepoDocumentCommitSchema, AppRepoRefSchema, AppRepoRefsSchema, AppRepoTreeEntrySchema, AppRepoTreeSchema, AppScaffoldModuleSchema, AppScaffoldProgressSchema, AppScaffoldProgressStatusSchema, AppsQuerySchema, AppToolCollectionSchema, AppVersionGitRefTypeSchema, AppVersionGitSourceSchema, AppVersionKindSchema, AppVersionRecordSchema, AppVersionStateSchema, AppVersionStorageSchema, AppVersionTargetSchema, AppVersionUrlsSchema, DeleteAppVersionResponseSchema, McpApiKeyCredentialSchema, OAuthClientCredentialsSchema, StartAppBuildRequestSchema, StartAppBuildResponseSchema, StartAppDevelopmentTaskRequestSchema, StartAppScaffoldRequestSchema, StartAppScaffoldResponseSchema, UpdateAppInstallationOAuthApprovalPayloadSchema, UpdateAppInstallationToolAllowlistPayloadSchema, UpsertAppVersionRequestSchema, ValidateUrlRequestSchema, ValidateUrlResponseSchema } from './api-schemas/app-lifecycle.js';
 import type { AppEventHookDeliverySchema, AppEventHookPayloadSchema, AppEventSubscriptionDefinitionSchema, AppInstallationListEntrySchema, AppInstallationSchema, AppInstallationWithManifestSchema, AppManifestDataSchema, AppManifestSchema, AppPackageEventHookSchema, AppPackageHooksSchema, AppPackageSchema, AppWidgetInfoSchema, CompositeAppCardOverridesSchema, CompositeAppConfigPayloadSchema, CompositeAppConfigSchema, CompositeAppEntrySchema, CompositeAppHeaderItemKindSchema, CompositeAppHeaderItemSchema, CompositeAppHeaderItemTargetSchema, CompositeAppHeaderOverridesSchema, CompositeAppHomePluginSchema, CompositeAppLogoOverridesSchema, CompositeAppMenuSectionSchema, CompositeAppMessageOverridesSchema, CompositeAppMessageStyleSchema, CompositeAppNavItemPermissionsSchema, CompositeAppSidebarOverridesSchema, CompositeAppSwitchersOverridesSchema, CompositeAppThemeOverridesSchema, CompositeAppUserMenuOverridesSchema, PromoteAppVersionResponseSchema, UpdateAppPayloadSchema } from './api-schemas/app-runtime.js';
 import type { AppAccessControlSchema, AppAvailableInSchema, AppCapabilitiesSchema, AppGitSourceConfigSchema, AppManifestSourceSchema, AppSourceConfigSchema, AppUIConfigSchema, MCPApiKeyConfigSchema, MCPOAuthConfigSchema, MCPToolAnnotationsSchema, MCPToolCollectionObjectSchema, McpApiKeyStatusSchema, McpOAuthConnectResponseSchema, McpOAuthDisconnectResponseSchema, McpOAuthTokenRequestSchema, McpOAuthTokenResponseSchema, OAuthAuthorizeResponseSchema, OAuthAuthStatusSchema, OAuthMetadataResponseSchema, SetMcpApiKeyRequestSchema, ToolCollectionAuthTypeSchema, ToolCollectionObjectSchema, VertesiaSDKToolCollectionObjectSchema } from './api-schemas/apps.js';
 import type { RemoteActivityDefinitionSchema } from './api-schemas/integrations.js';
@@ -4313,6 +4321,7 @@ export type ValidateUrlResponse = z.infer<typeof ValidateUrlResponseSchema>;
  * already deleted. Deriving the type is what keeps the two from drifting again.
  */
 export type AppDeleteSummary = z.infer<typeof AppDeleteSummarySchema>;
+export type UpdateAppInstallationOAuthApprovalPayload = z.infer<typeof UpdateAppInstallationOAuthApprovalPayloadSchema>;
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: interaction.d.ts

package/lib/docs/vertesia-common.d.ts

@@ -10,7 +10,7 @@
 // -----------------------------------------------------------------------------
 // @vertesia/common: index.d.ts
 // -----------------------------------------------------------------------------
-export type { VertexAIGeminiOmniVideoOptions, VideoResult } from '@llumiverse/common';
+export type { AudioResult, OpenAiAudioOptions, OpenAiSpeechOptions, OpenAiTranscriptionOptions, VertexAIGeminiOmniVideoOptions, VideoResult, } from '@llumiverse/common';
 export * from './access-control.js';
 export * from './analytics.js';
 /**
@@ -19,7 +19,7 @@ export * from './analytics.js';
  * would ship zod to every UI user; see `./api-schemas/index.ts` for why.
  */
 export type { UserGroupArrayFromSchema } from './api-schemas/group.js';
-export type { PrincipalContextFromSchema, UserArrayFromSchema, UserRefArrayFromSchema, } from './api-schemas/user.js';
+export type { AbacPrincipalContextFromSchema, UserArrayFromSchema, UserRefArrayFromSchema, } from './api-schemas/user.js';
 export * from './apikey.js';
 export * from './appgen.js';
 export * from './apps.js';
@@ -60,6 +60,7 @@ export * from './schema-for-extraction.js';
 export * from './secrets.js';
 export * from './skill.js';
 export * from './store/index.js';
+export * from './store/rendering.js';
 export type { ContentObjectExportArtifact, ContentObjectExportArtifactFile, ContentObjectExportProgress, ContentObjectExportResult, ContentObjectExportStatusResponse, DeleteContentObjectExportResponse, ExportContentObjectsFilter, ExportContentObjectsIncludeOptions, ExportedContentObjectRecord, ListContentObjectExportsResponse, StartContentObjectExportRequest, StartContentObjectExportResponse, ZenoBulkContentObjectExportComposeRequest, ZenoBulkContentObjectExportPlanRequest, ZenoBulkContentObjectExportPlanResponse, ZenoBulkContentObjectExportRequest, ZenoBulkContentObjectExportShardRange, ZenoBulkContentObjectExportShardRequest, ZenoBulkContentObjectExportShardResult, ZenoBulkContentObjectExportSplitShardRequest, ZenoBulkContentObjectExportSplitShardResponse, } from './store/store.js';
 export * from './sts-errors.js';
 export * from './sts-token-types.js';
@@ -80,7 +81,7 @@ export * from './workflow-analytics.js';
 // @vertesia/common: apps.d.ts
 // -----------------------------------------------------------------------------
 import type { z } from 'zod';
-import type { AgentToolApprovalClassSchema, AgentToolDefinitionSchema, AppApiKeyCollectionParamsSchema, AppBuildProgressSchema, AppBuildProgressStatusSchema, AppBuildTriggerSchema, AppDeleteSummarySchema, AppDevelopmentTaskDetailsSchema, AppDevelopmentTaskListSchema, AppDevelopmentTaskSchema, AppInspectionCapabilityReportSchema, AppInspectionIssueSchema, AppInspectionResultSchema, AppInstallationKindSchema, AppInstallationOAuthBindingSchema, AppInstallationPayloadSchema, AppInstallationProjectsQuerySchema, AppInstallationProviderBindingSchema, AppInstallationsQuerySchema, AppListScopeSchema, AppOAuthCollectionParamsSchema, AppOAuthProviderParamsSchema, AppRepoBranchSchema, AppRepoCommitSchema, AppRepoCommitsSchema, AppRepoDocumentCommitSchema, AppRepoRefSchema, AppRepoRefsSchema, AppRepoTreeEntrySchema, AppRepoTreeSchema, AppScaffoldModuleSchema, AppScaffoldProgressSchema, AppScaffoldProgressStatusSchema, AppsQuerySchema, AppToolCollectionSchema, AppVersionGitRefTypeSchema, AppVersionGitSourceSchema, AppVersionKindSchema, AppVersionRecordSchema, AppVersionStateSchema, AppVersionStorageSchema, AppVersionTargetSchema, AppVersionUrlsSchema, DeleteAppVersionResponseSchema, McpApiKeyCredentialSchema, OAuthClientCredentialsSchema, StartAppBuildRequestSchema, StartAppBuildResponseSchema, StartAppDevelopmentTaskRequestSchema, StartAppScaffoldRequestSchema, StartAppScaffoldResponseSchema, UpdateAppInstallationToolAllowlistPayloadSchema, UpsertAppVersionRequestSchema, ValidateUrlRequestSchema, ValidateUrlResponseSchema } from './api-schemas/app-lifecycle.js';
+import type { AgentToolApprovalClassSchema, AgentToolDefinitionSchema, AppApiKeyCollectionParamsSchema, AppBuildProgressSchema, AppBuildProgressStatusSchema, AppBuildTriggerSchema, AppDeleteSummarySchema, AppDevelopmentTaskDetailsSchema, AppDevelopmentTaskListSchema, AppDevelopmentTaskSchema, AppInspectionCapabilityReportSchema, AppInspectionIssueSchema, AppInspectionResultSchema, AppInstallationKindSchema, AppInstallationOAuthBindingSchema, AppInstallationPayloadSchema, AppInstallationProjectsQuerySchema, AppInstallationProviderBindingSchema, AppInstallationsQuerySchema, AppListScopeSchema, AppOAuthCollectionParamsSchema, AppOAuthProviderParamsSchema, AppRepoBranchSchema, AppRepoCommitSchema, AppRepoCommitsSchema, AppRepoDocumentCommitSchema, AppRepoRefSchema, AppRepoRefsSchema, AppRepoTreeEntrySchema, AppRepoTreeSchema, AppScaffoldModuleSchema, AppScaffoldProgressSchema, AppScaffoldProgressStatusSchema, AppsQuerySchema, AppToolCollectionSchema, AppVersionGitRefTypeSchema, AppVersionGitSourceSchema, AppVersionKindSchema, AppVersionRecordSchema, AppVersionStateSchema, AppVersionStorageSchema, AppVersionTargetSchema, AppVersionUrlsSchema, DeleteAppVersionResponseSchema, McpApiKeyCredentialSchema, OAuthClientCredentialsSchema, StartAppBuildRequestSchema, StartAppBuildResponseSchema, StartAppDevelopmentTaskRequestSchema, StartAppScaffoldRequestSchema, StartAppScaffoldResponseSchema, UpdateAppInstallationOAuthApprovalPayloadSchema, UpdateAppInstallationToolAllowlistPayloadSchema, UpsertAppVersionRequestSchema, ValidateUrlRequestSchema, ValidateUrlResponseSchema } from './api-schemas/app-lifecycle.js';
 import type { AppEventHookDeliverySchema, AppEventHookPayloadSchema, AppEventSubscriptionDefinitionSchema, AppInstallationListEntrySchema, AppInstallationSchema, AppInstallationWithManifestSchema, AppManifestDataSchema, AppManifestSchema, AppPackageEventHookSchema, AppPackageHooksSchema, AppPackageSchema, AppWidgetInfoSchema, CompositeAppCardOverridesSchema, CompositeAppConfigPayloadSchema, CompositeAppConfigSchema, CompositeAppEntrySchema, CompositeAppHeaderItemKindSchema, CompositeAppHeaderItemSchema, CompositeAppHeaderItemTargetSchema, CompositeAppHeaderOverridesSchema, CompositeAppHomePluginSchema, CompositeAppLogoOverridesSchema, CompositeAppMenuSectionSchema, CompositeAppMessageOverridesSchema, CompositeAppMessageStyleSchema, CompositeAppNavItemPermissionsSchema, CompositeAppSidebarOverridesSchema, CompositeAppSwitchersOverridesSchema, CompositeAppThemeOverridesSchema, CompositeAppUserMenuOverridesSchema, PromoteAppVersionResponseSchema, UpdateAppPayloadSchema } from './api-schemas/app-runtime.js';
 import type { AppAccessControlSchema, AppAvailableInSchema, AppCapabilitiesSchema, AppGitSourceConfigSchema, AppManifestSourceSchema, AppSourceConfigSchema, AppUIConfigSchema, MCPApiKeyConfigSchema, MCPOAuthConfigSchema, MCPToolAnnotationsSchema, MCPToolCollectionObjectSchema, McpApiKeyStatusSchema, McpOAuthConnectResponseSchema, McpOAuthDisconnectResponseSchema, McpOAuthTokenRequestSchema, McpOAuthTokenResponseSchema, OAuthAuthorizeResponseSchema, OAuthAuthStatusSchema, OAuthMetadataResponseSchema, SetMcpApiKeyRequestSchema, ToolCollectionAuthTypeSchema, ToolCollectionObjectSchema, VertesiaSDKToolCollectionObjectSchema } from './api-schemas/apps.js';
 import type { RemoteActivityDefinitionSchema } from './api-schemas/integrations.js';
@@ -492,6 +493,7 @@ export type ValidateUrlResponse = z.infer<typeof ValidateUrlResponseSchema>;
  * already deleted. Deriving the type is what keeps the two from drifting again.
  */
 export type AppDeleteSummary = z.infer<typeof AppDeleteSummarySchema>;
+export type UpdateAppInstallationOAuthApprovalPayload = z.infer<typeof UpdateAppInstallationOAuthApprovalPayloadSchema>;
 
 // -----------------------------------------------------------------------------
 // @vertesia/common: data-platform.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/appgen-docs",
-  "version": "1.6.0-dev.20260918.090710Z",
+  "version": "1.6.0-dev.20260923.085325Z",
   "description": "Generated SDK references and development guidance for Vertesia app agents",
   "type": "module",
   "main": "./lib/index.js",
@@ -16,11 +16,11 @@
     }
   },
   "devDependencies": {
-    "@types/node": "^24.13.3",
-    "@vertesia/client": "1.6.0-dev.20260918.090710Z",
-    "@vertesia/common": "1.6.0-dev.20260918.090710Z",
+    "@types/node": "^24.13.5",
+    "@vertesia/client": "1.6.0-dev.20260923.085325Z",
+    "@vertesia/common": "1.6.0-dev.20260923.085325Z",
     "@vertesia/tsconfig": "0.1.0",
-    "@vertesia/ui": "1.6.0-dev.20260918.090710Z",
+    "@vertesia/ui": "1.6.0-dev.20260923.085325Z",
     "typescript": "7.0.2"
   },
   "repository": {
@@ -34,7 +34,7 @@
     "documentation",
     "app-development"
   ],
-  "gitHead": "10f35da1a210e1950f9c8b1368fea89328a23ea0",
+  "gitHead": "8732631fd8099bdcab4f5375da2309f3cff34e19",
   "scripts": {
     "build": "pnpm run clean && tsc -p tsconfig.json && node ./scripts/generate-docs.mjs",
     "clean": "rimraf ./lib ./docs ./tsconfig.tsbuildinfo",