@vertesia/common 1.5.0-dev.20260804.124748Z → 1.5.0-dev.20260806.125520Z

package/src/platform-event.ts

@@ -5,6 +5,10 @@ import type {
     AgentDeliveryMatchModeSchema,
     AgentEventDeliveryTargetSchema,
     AgentSemanticEvaluatorSchema,
+    AppEventDeliveryTargetInputSchema,
+    AppEventDeliveryTargetSchema,
+    CancelEventDeliveryIntentsPayloadSchema,
+    CancelEventDeliveryIntentsResponseSchema,
     CreateEventIngestChannelPayloadSchema,
     EventDeliveryIntentStatusSchema,
     EventDeliveryIntentSummarySchema,
@@ -217,6 +221,8 @@ export type WorkflowEventDeliveryTarget = z.infer<typeof WorkflowEventDeliveryTa
 
 export type WebhookEventDeliveryTarget = z.infer<typeof WebhookEventDeliveryTargetSchema>;
 
+export type AppEventDeliveryTarget = z.infer<typeof AppEventDeliveryTargetSchema>;
+
 export const DEFAULT_EVENT_AGENT_INTERACTION_REF = 'sys:GeneralAgent';
 
 export type AgentDeliveryMatchMode = z.infer<typeof AgentDeliveryMatchModeSchema>;
@@ -242,6 +248,7 @@ export interface ProcessEventDeliveryTarget {
 export type EventDeliveryTarget =
     | WorkflowEventDeliveryTarget
     | WebhookEventDeliveryTarget
+    | AppEventDeliveryTarget
     | AgentEventDeliveryTarget
     | ProcessEventDeliveryTarget;
 
@@ -254,9 +261,12 @@ export type WorkflowEventDeliveryTargetInput = z.infer<typeof WorkflowEventDeliv
 
 export type WebhookEventDeliveryTargetInput = z.infer<typeof WebhookEventDeliveryTargetInputSchema>;
 
+export type AppEventDeliveryTargetInput = z.infer<typeof AppEventDeliveryTargetInputSchema>;
+
 export type EventDeliveryTargetInput =
     | WorkflowEventDeliveryTargetInput
     | WebhookEventDeliveryTargetInput
+    | AppEventDeliveryTargetInput
     | AgentEventDeliveryTarget
     | ProcessEventDeliveryTarget;
 
@@ -284,6 +294,9 @@ export interface EventSubscription {
     protected: boolean;
     enabled: boolean;
     priority?: EventPriority;
+    app_installation_id?: string;
+    app_id?: string;
+    app_subscription_id?: string;
     created_by?: string;
     updated_by?: string;
     created_at?: string;
@@ -387,6 +400,32 @@ export interface ListEventSubscriptionsQuery {
     scope?: ('account' | 'project')[];
     sort_by?: EventSubscriptionSortField;
     sort_order?: 'asc' | 'desc';
+    app_installation_id?: string;
+}
+
+/** Trusted Studio -> Zeno request used to provision subscriptions declared by an installed app. */
+export interface ProvisionAppEventSubscriptionsRequest {
+    account_id: string;
+    project_id: string;
+    subscriptions: Array<
+        CreateEventSubscriptionPayload & {
+            target: AppEventDeliveryTargetInput;
+            app_installation_id: string;
+            app_id: string;
+            app_subscription_id: string;
+        }
+    >;
+}
+
+/** Trusted Studio -> Zeno request used to remove every subscription owned by an app installation. */
+export interface RemoveAppEventSubscriptionsRequest {
+    account_id: string;
+    project_id: string;
+    app_installation_id: string;
+}
+
+export interface AppEventSubscriptionsMutationResponse {
+    subscription_ids: string[];
 }
 
 export type EventIngestChannelSortField = 'name' | 'source' | 'enabled' | 'updated_at';
@@ -410,6 +449,10 @@ export type EventDeliveryQueueSubscriptionSummary = z.infer<typeof EventDelivery
 
 export type EventDeliveryQueueSummaryResponse = z.infer<typeof EventDeliveryQueueSummaryResponseSchema>;
 
+export type CancelEventDeliveryIntentsPayload = z.infer<typeof CancelEventDeliveryIntentsPayloadSchema>;
+
+export type CancelEventDeliveryIntentsResponse = z.infer<typeof CancelEventDeliveryIntentsResponseSchema>;
+
 export interface PublishPlatformEventPayload {
     event: PlatformEvent;
     priority?: EventPriority;

package/src/store/workflow.ts

@@ -737,6 +737,15 @@ export enum FileProcessingStatus {
 
 export type ConversationFile = z.infer<typeof ConversationFileSchema>;
 
+/**
+ * A file is deliverable when it is ready and has not yet been delivered to the agent as part
+ * of a user message. Deliverable files get attached to the next message; consumed ones stay
+ * reachable to tools via artifact_path/md_path but are not re-attached.
+ */
+export function isDeliverableFile(file: ConversationFile): boolean {
+    return file.status === FileProcessingStatus.READY && !file.consumed_at;
+}
+
 /**
  * Details for file processing SYSTEM messages.
  * Used when type is AgentMessageType.SYSTEM with system_type: 'file_processing'.

package/src/sts-errors.ts

@@ -0,0 +1,13 @@
+export const REQUESTED_SCOPE_UNAVAILABLE_ERROR_CODE = 'requested_scope_unavailable';
+export const NO_ACCESSIBLE_ACCOUNT_ERROR_CODE = 'no_accessible_account';
+export const RESTRICTED_ENVIRONMENT_ERROR_CODE = 'restricted_environment';
+export const TOKEN_ISSUANCE_FORBIDDEN_ERROR_CODE = 'token_issuance_forbidden';
+
+export const ISSUE_TOKEN_FORBIDDEN_ERROR_CODES = [
+    REQUESTED_SCOPE_UNAVAILABLE_ERROR_CODE,
+    NO_ACCESSIBLE_ACCOUNT_ERROR_CODE,
+    RESTRICTED_ENVIRONMENT_ERROR_CODE,
+    TOKEN_ISSUANCE_FORBIDDEN_ERROR_CODE,
+] as const;
+
+export type IssueTokenForbiddenErrorCode = (typeof ISSUE_TOKEN_FORBIDDEN_ERROR_CODES)[number];

package/src/sts-token-types.ts

@@ -7,6 +7,7 @@ import type {
     AgentTokenRequestSchema,
     ApiKeyTokenRequestSchema,
     EnvironmentTokenRequestSchema,
+    IssueTokenForbiddenResponseSchema,
     IssueTokenRequestSchema,
     IssueTokenResponseSchema,
     ProjectTokenRequestSchema,
@@ -91,6 +92,7 @@ export interface TokenResponse {
 }
 
 export type IssueTokenResponse = z.infer<typeof IssueTokenResponseSchema>;
+export type IssueTokenForbiddenResponse = z.infer<typeof IssueTokenForbiddenResponseSchema>;
 
 export interface ValidateTokenResponse {
     valid: boolean;

package/src/user.ts

@@ -59,7 +59,7 @@ export const EARLY_ACCESS_ANNOTATION = 'early-access';
  * restricted (`preview`/`preprod`) environment because they lack the {@link EARLY_ACCESS_ANNOTATION}
  * annotation. The UI keys its dedicated rejection screen off this code.
  */
-export const RESTRICTED_ENVIRONMENT_ERROR_CODE = 'restricted_environment';
+export { RESTRICTED_ENVIRONMENT_ERROR_CODE } from './sts-errors.js';
 
 /**
  * The account as it crosses the wire.

package/src/versions.test.ts

@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest';
+import { ApiVersions, CURRENT_API_VERSION, CURRENT_API_VERSION_HEADER_VALUE } from './versions.js';
+
+describe('API versions', () => {
+    it('keeps the current API version aligned with the latest milestone', () => {
+        const milestones = Object.values(ApiVersions).filter(
+            (version): version is number => typeof version === 'number',
+        );
+
+        expect(CURRENT_API_VERSION).toBe(Math.max(...milestones));
+        expect(CURRENT_API_VERSION_HEADER_VALUE).toBe(String(CURRENT_API_VERSION));
+    });
+});

package/src/versions.ts

@@ -27,3 +27,15 @@ export enum ApiVersions {
      */
     REQUEST_CONTRACT_ENFORCEMENT_V1 = 20260803,
 }
+
+/**
+ * The API version used by current clients and published as the current OpenAPI shape.
+ *
+ * Keep this explicit rather than deriving it at runtime: promoting a milestone to the client
+ * default is a deliberate compatibility decision. The versions test ensures this alias is
+ * reconsidered whenever a newer milestone is added.
+ */
+export const CURRENT_API_VERSION = ApiVersions.REQUEST_CONTRACT_ENFORCEMENT_V1;
+
+/** The current API version formatted for the {@link VERSION_HEADER} wire value. */
+export const CURRENT_API_VERSION_HEADER_VALUE = String(CURRENT_API_VERSION);

package/src/workflow-analytics.ts

@@ -114,11 +114,18 @@ export interface AgentRunCompletedEvent extends BaseAgentEvent {
     totalToolCalls: number;
     /** Total LLM calls made */
     totalLlmCalls: number;
-    /** Cumulative token usage */
-    totalTokens?: {
+    /**
+     * Cumulative token usage breakdown for the run.
+     *
+     * No `totalTokens` (and no `total` here): an input+output sum mixes
+     * differently-priced quantities and nothing consumes it — token analytics
+     * aggregate the per-call LlmCallEvent fields. This also keeps
+     * `$.totalTokens` scalar-only in the telemetry `event_data` column
+     * (LlmCallEvent is the only current producer of that path).
+     */
+    tokenUsage?: {
         input: number;
         output: number;
-        total: number;
     };
     /** If conversation was ended via end_conversation tool */
     endConversation?: {