@vertesia/build-tools 0.80.1 → 1.0.0-dev.20260128.144200

package/lib/build-tools.js

@@ -697,23 +697,333 @@ const rawTransformer = {
 };
 
 /**
- * Prompt transformer preset for template files with frontmatter
- * Supports .jst, .hbs, and plain text files
+ * @module access-control
+ * @description
+ * Access control interfaces
  */
+var Permission;
+(function (Permission) {
+    Permission["int_read"] = "interaction:read";
+    Permission["int_write"] = "interaction:write";
+    Permission["int_delete"] = "interaction:delete";
+    Permission["int_execute"] = "interaction:execute";
+    Permission["run_read"] = "run:read";
+    Permission["run_write"] = "run:write";
+    Permission["env_admin"] = "environment:admin";
+    Permission["project_admin"] = "project:admin";
+    Permission["project_integration_read"] = "project:integration_read";
+    Permission["project_settings_write"] = "project:settings_write";
+    Permission["api_key_create"] = "api_key:create";
+    Permission["api_key_read"] = "api_key:read";
+    Permission["api_key_update"] = "api_key:update";
+    Permission["api_key_delete"] = "api_key:delete";
+    Permission["account_read"] = "account:read";
+    Permission["account_write"] = "account:write";
+    Permission["account_admin"] = "account:admin";
+    Permission["manage_billing"] = "account:billing";
+    Permission["account_member"] = "account:member";
+    Permission["content_read"] = "content:read";
+    Permission["content_write"] = "content:write";
+    Permission["content_delete"] = "content:delete";
+    Permission["content_admin"] = "content:admin";
+    Permission["content_superadmin"] = "content:superadmin";
+    Permission["workflow_run"] = "workflow:run";
+    Permission["workflow_admin"] = "workflow:admin";
+    Permission["workflow_superadmin"] = "workflow:superadmin";
+    Permission["iam_impersonate"] = "iam:impersonate";
+    /** whether the user has access to Sutdio App. */
+    Permission["studio_access"] = "studio:access";
+})(Permission || (Permission = {}));
+var AccessControlResourceType;
+(function (AccessControlResourceType) {
+    AccessControlResourceType["project"] = "project";
+    AccessControlResourceType["environment"] = "environment";
+    AccessControlResourceType["account"] = "account";
+    AccessControlResourceType["interaction"] = "interaction";
+    AccessControlResourceType["app"] = "application";
+})(AccessControlResourceType || (AccessControlResourceType = {}));
+var AccessControlPrincipalType;
+(function (AccessControlPrincipalType) {
+    AccessControlPrincipalType["user"] = "user";
+    AccessControlPrincipalType["group"] = "group";
+    AccessControlPrincipalType["apikey"] = "apikey";
+})(AccessControlPrincipalType || (AccessControlPrincipalType = {}));
+
+var ApiKeyTypes;
+(function (ApiKeyTypes) {
+    ApiKeyTypes["secret"] = "sk";
+})(ApiKeyTypes || (ApiKeyTypes = {}));
+var PrincipalType;
+(function (PrincipalType) {
+    PrincipalType["User"] = "user";
+    PrincipalType["Group"] = "group";
+    PrincipalType["ApiKey"] = "apikey";
+    PrincipalType["ServiceAccount"] = "service_account";
+    PrincipalType["Agent"] = "agent";
+})(PrincipalType || (PrincipalType = {}));
+
+var InteractionStatus;
+(function (InteractionStatus) {
+    InteractionStatus["draft"] = "draft";
+    InteractionStatus["published"] = "published";
+    InteractionStatus["archived"] = "archived";
+})(InteractionStatus || (InteractionStatus = {}));
+var ExecutionRunStatus;
+(function (ExecutionRunStatus) {
+    ExecutionRunStatus["created"] = "created";
+    ExecutionRunStatus["processing"] = "processing";
+    ExecutionRunStatus["completed"] = "completed";
+    ExecutionRunStatus["failed"] = "failed";
+})(ExecutionRunStatus || (ExecutionRunStatus = {}));
+var RunDataStorageLevel;
+(function (RunDataStorageLevel) {
+    RunDataStorageLevel["STANDARD"] = "STANDARD";
+    RunDataStorageLevel["RESTRICTED"] = "RESTRICTED";
+    RunDataStorageLevel["DEBUG"] = "DEBUG";
+})(RunDataStorageLevel || (RunDataStorageLevel = {}));
+var RunDataStorageDescription;
+(function (RunDataStorageDescription) {
+    RunDataStorageDescription["STANDARD"] = "Run data is stored for both the model inputs and output.";
+    RunDataStorageDescription["RESTRICTED"] = "No run data is stored for the model inputs \u2014 only the model output.";
+    RunDataStorageDescription["DEBUG"] = "Run data is stored for the model inputs and output, schema, and final prompt.";
+})(RunDataStorageDescription || (RunDataStorageDescription = {}));
+({
+    [RunDataStorageLevel.STANDARD]: RunDataStorageDescription.STANDARD,
+    [RunDataStorageLevel.RESTRICTED]: RunDataStorageDescription.RESTRICTED,
+    [RunDataStorageLevel.DEBUG]: RunDataStorageDescription.DEBUG,
+});
 /**
- * Template type for prompt content
- * MUST match TemplateType from @vertesia/common
+ * Defines the scope for agent search operations.
  */
-var TemplateType;
-(function (TemplateType) {
-    TemplateType["jst"] = "jst";
-    TemplateType["handlebars"] = "handlebars";
-    TemplateType["text"] = "text";
-})(TemplateType || (TemplateType = {}));
+var AgentSearchScope;
+(function (AgentSearchScope) {
+    /**
+     * Search is scoped to a specific collection.
+     */
+    AgentSearchScope["Collection"] = "collection";
+})(AgentSearchScope || (AgentSearchScope = {}));
+// ================= end async execution payloads ====================
+var RunSourceTypes;
+(function (RunSourceTypes) {
+    RunSourceTypes["api"] = "api";
+    RunSourceTypes["cli"] = "cli";
+    RunSourceTypes["ui"] = "ui";
+    RunSourceTypes["webhook"] = "webhook";
+    RunSourceTypes["test"] = "test-data";
+    RunSourceTypes["system"] = "system";
+})(RunSourceTypes || (RunSourceTypes = {}));
+var ConfigModes;
+(function (ConfigModes) {
+    ConfigModes["RUN_AND_INTERACTION_CONFIG"] = "RUN_AND_INTERACTION_CONFIG";
+    ConfigModes["RUN_CONFIG_ONLY"] = "RUN_CONFIG_ONLY";
+    ConfigModes["INTERACTION_CONFIG_ONLY"] = "INTERACTION_CONFIG_ONLY";
+})(ConfigModes || (ConfigModes = {}));
+var ConfigModesDescription;
+(function (ConfigModesDescription) {
+    ConfigModesDescription["RUN_AND_INTERACTION_CONFIG"] = "This run configuration is used. Undefined options are filled with interaction configuration.";
+    ConfigModesDescription["RUN_CONFIG_ONLY"] = "Only this run configuration is used. Undefined options remain undefined.";
+    ConfigModesDescription["INTERACTION_CONFIG_ONLY"] = "Only interaction configuration is used.";
+})(ConfigModesDescription || (ConfigModesDescription = {}));
+({
+    [ConfigModes.RUN_AND_INTERACTION_CONFIG]: ConfigModesDescription.RUN_AND_INTERACTION_CONFIG,
+    [ConfigModes.RUN_CONFIG_ONLY]: ConfigModesDescription.RUN_CONFIG_ONLY,
+    [ConfigModes.INTERACTION_CONFIG_ONLY]: ConfigModesDescription.INTERACTION_CONFIG_ONLY,
+});
+/**
+ * Source of the resolved model configuration
+ */
+var ModelSource;
+(function (ModelSource) {
+    /** Model was explicitly provided in the execution config */
+    ModelSource["config"] = "config";
+    /** Model comes from the interaction definition */
+    ModelSource["interaction"] = "interaction";
+    /** Model comes from environment's default_model */
+    ModelSource["environmentDefault"] = "environmentDefault";
+    /** Model comes from project system interaction defaults */
+    ModelSource["projectSystemDefault"] = "projectSystemDefault";
+    /** Model comes from project base defaults */
+    ModelSource["projectBaseDefault"] = "projectBaseDefault";
+    /** Model comes from project modality-specific defaults */
+    ModelSource["projectModalityDefault"] = "projectModalityDefault";
+    /** Model comes from legacy project defaults */
+    ModelSource["projectLegacyDefault"] = "projectLegacyDefault";
+})(ModelSource || (ModelSource = {}));
+
+/**
+ * Data Platform Types
+ *
+ * Types for managing versioned analytical data stores with DuckDB + GCS storage.
+ * Supports AI-manageable schemas and multi-table atomic operations.
+ */
+// ============================================================================
+// Column Types
+// ============================================================================
+/**
+ * Supported column data types for DuckDB tables.
+ */
+var DataColumnType;
+(function (DataColumnType) {
+    DataColumnType["STRING"] = "STRING";
+    DataColumnType["INTEGER"] = "INTEGER";
+    DataColumnType["BIGINT"] = "BIGINT";
+    DataColumnType["FLOAT"] = "FLOAT";
+    DataColumnType["DOUBLE"] = "DOUBLE";
+    DataColumnType["DECIMAL"] = "DECIMAL";
+    DataColumnType["BOOLEAN"] = "BOOLEAN";
+    DataColumnType["DATE"] = "DATE";
+    DataColumnType["TIMESTAMP"] = "TIMESTAMP";
+    DataColumnType["JSON"] = "JSON";
+})(DataColumnType || (DataColumnType = {}));
+/**
+ * Semantic types that provide AI agents with context about column meaning.
+ */
+var SemanticColumnType;
+(function (SemanticColumnType) {
+    SemanticColumnType["EMAIL"] = "email";
+    SemanticColumnType["PHONE"] = "phone";
+    SemanticColumnType["URL"] = "url";
+    SemanticColumnType["CURRENCY"] = "currency";
+    SemanticColumnType["PERCENTAGE"] = "percentage";
+    SemanticColumnType["PERSON_NAME"] = "person_name";
+    SemanticColumnType["ADDRESS"] = "address";
+    SemanticColumnType["COUNTRY"] = "country";
+    SemanticColumnType["DATE_ISO"] = "date_iso";
+    SemanticColumnType["IDENTIFIER"] = "identifier";
+})(SemanticColumnType || (SemanticColumnType = {}));
+/**
+ * Mapping from DataColumnType to DuckDB SQL types.
+ */
+({
+    [DataColumnType.STRING]: 'VARCHAR',
+    [DataColumnType.INTEGER]: 'INTEGER',
+    [DataColumnType.BIGINT]: 'BIGINT',
+    [DataColumnType.FLOAT]: 'FLOAT',
+    [DataColumnType.DOUBLE]: 'DOUBLE',
+    [DataColumnType.DECIMAL]: 'DECIMAL(18,4)',
+    [DataColumnType.BOOLEAN]: 'BOOLEAN',
+    [DataColumnType.DATE]: 'DATE',
+    [DataColumnType.TIMESTAMP]: 'TIMESTAMP',
+    [DataColumnType.JSON]: 'JSON',
+});
+// ============================================================================
+// Data Store Types
+// ============================================================================
 /**
- * Prompt role enum
- * MUST match PromptRole from @llumiverse/common
+ * Data store lifecycle status.
  */
+var DataStoreStatus;
+(function (DataStoreStatus) {
+    /** Store is being created */
+    DataStoreStatus["CREATING"] = "creating";
+    /** Store is active and usable */
+    DataStoreStatus["ACTIVE"] = "active";
+    /** Store encountered an error */
+    DataStoreStatus["ERROR"] = "error";
+    /** Store has been archived (soft deleted) */
+    DataStoreStatus["ARCHIVED"] = "archived";
+})(DataStoreStatus || (DataStoreStatus = {}));
+// ============================================================================
+// Import Types
+// ============================================================================
+/**
+ * Import job status.
+ */
+var ImportStatus;
+(function (ImportStatus) {
+    /** Job is queued */
+    ImportStatus["PENDING"] = "pending";
+    /** Job is running */
+    ImportStatus["PROCESSING"] = "processing";
+    /** Job completed successfully */
+    ImportStatus["COMPLETED"] = "completed";
+    /** Job failed */
+    ImportStatus["FAILED"] = "failed";
+    /** Job was rolled back */
+    ImportStatus["ROLLED_BACK"] = "rolled_back";
+})(ImportStatus || (ImportStatus = {}));
+// ============================================================================
+// Dashboard Types
+// ============================================================================
+/**
+ * Dashboard lifecycle status.
+ */
+var DashboardStatus;
+(function (DashboardStatus) {
+    /** Dashboard is active and usable */
+    DashboardStatus["ACTIVE"] = "active";
+    /** Dashboard has been archived (soft deleted) */
+    DashboardStatus["ARCHIVED"] = "archived";
+})(DashboardStatus || (DashboardStatus = {}));
+
+// ============== Provider details ===============
+var Providers;
+(function (Providers) {
+    Providers["openai"] = "openai";
+    Providers["openai_compatible"] = "openai_compatible";
+    Providers["azure_openai"] = "azure_openai";
+    Providers["azure_foundry"] = "azure_foundry";
+    Providers["huggingface_ie"] = "huggingface_ie";
+    Providers["replicate"] = "replicate";
+    Providers["bedrock"] = "bedrock";
+    Providers["vertexai"] = "vertexai";
+    Providers["togetherai"] = "togetherai";
+    Providers["mistralai"] = "mistralai";
+    Providers["groq"] = "groq";
+    Providers["watsonx"] = "watsonx";
+    Providers["xai"] = "xai";
+})(Providers || (Providers = {}));
+({
+    openai: {
+        id: Providers.openai},
+    azure_openai: {
+        id: Providers.azure_openai},
+    azure_foundry: {
+        id: Providers.azure_foundry},
+    huggingface_ie: {
+        id: Providers.huggingface_ie},
+    replicate: {
+        id: Providers.replicate},
+    bedrock: {
+        id: Providers.bedrock},
+    vertexai: {
+        id: Providers.vertexai},
+    togetherai: {
+        id: Providers.togetherai},
+    mistralai: {
+        id: Providers.mistralai},
+    groq: {
+        id: Providers.groq},
+    watsonx: {
+        id: Providers.watsonx},
+    xai: {
+        id: Providers.xai},
+    openai_compatible: {
+        id: Providers.openai_compatible},
+});
+//Common names to share between different models
+var SharedOptions;
+(function (SharedOptions) {
+    //Text
+    SharedOptions["max_tokens"] = "max_tokens";
+    SharedOptions["temperature"] = "temperature";
+    SharedOptions["top_p"] = "top_p";
+    SharedOptions["top_k"] = "top_k";
+    SharedOptions["presence_penalty"] = "presence_penalty";
+    SharedOptions["frequency_penalty"] = "frequency_penalty";
+    SharedOptions["stop_sequence"] = "stop_sequence";
+    //Image
+    SharedOptions["seed"] = "seed";
+    SharedOptions["number_of_images"] = "number_of_images";
+})(SharedOptions || (SharedOptions = {}));
+var OptionType;
+(function (OptionType) {
+    OptionType["numeric"] = "numeric";
+    OptionType["enum"] = "enum";
+    OptionType["boolean"] = "boolean";
+    OptionType["string_list"] = "string_list";
+})(OptionType || (OptionType = {}));
+// ============== Prompts ===============
 var PromptRole;
 (function (PromptRole) {
     PromptRole["safety"] = "safety";
@@ -721,7 +1031,553 @@ var PromptRole;
     PromptRole["user"] = "user";
     PromptRole["assistant"] = "assistant";
     PromptRole["negative"] = "negative";
+    PromptRole["mask"] = "mask";
+    /**
+     * Used to send the response of a tool
+     */
+    PromptRole["tool"] = "tool";
 })(PromptRole || (PromptRole = {}));
+/**
+ * @deprecated This is deprecated. Use CompletionResult.type information instead.
+ */
+var Modalities;
+(function (Modalities) {
+    Modalities["text"] = "text";
+    Modalities["image"] = "image";
+})(Modalities || (Modalities = {}));
+var AIModelStatus;
+(function (AIModelStatus) {
+    AIModelStatus["Available"] = "available";
+    AIModelStatus["Pending"] = "pending";
+    AIModelStatus["Stopped"] = "stopped";
+    AIModelStatus["Unavailable"] = "unavailable";
+    AIModelStatus["Unknown"] = "unknown";
+    AIModelStatus["Legacy"] = "legacy";
+})(AIModelStatus || (AIModelStatus = {}));
+var ModelType;
+(function (ModelType) {
+    ModelType["Classifier"] = "classifier";
+    ModelType["Regressor"] = "regressor";
+    ModelType["Clustering"] = "clustering";
+    ModelType["AnomalyDetection"] = "anomaly-detection";
+    ModelType["TimeSeries"] = "time-series";
+    ModelType["Text"] = "text";
+    ModelType["Image"] = "image";
+    ModelType["Audio"] = "audio";
+    ModelType["Video"] = "video";
+    ModelType["Embedding"] = "embedding";
+    ModelType["Chat"] = "chat";
+    ModelType["Code"] = "code";
+    ModelType["NLP"] = "nlp";
+    ModelType["MultiModal"] = "multi-modal";
+    ModelType["Test"] = "test";
+    ModelType["Other"] = "other";
+    ModelType["Unknown"] = "unknown";
+})(ModelType || (ModelType = {}));
+var TrainingJobStatus;
+(function (TrainingJobStatus) {
+    TrainingJobStatus["running"] = "running";
+    TrainingJobStatus["succeeded"] = "succeeded";
+    TrainingJobStatus["failed"] = "failed";
+    TrainingJobStatus["cancelled"] = "cancelled";
+})(TrainingJobStatus || (TrainingJobStatus = {}));
+
+({
+    options: [
+        {
+            name: SharedOptions.max_tokens, type: OptionType.numeric, min: 1,
+            integer: true, step: 200, description: "The maximum number of tokens to generate"
+        },
+        {
+            name: SharedOptions.temperature, type: OptionType.numeric, min: 0.0, default: 0.7,
+            integer: false, step: 0.1, description: "A higher temperature biases toward less likely tokens, making the model more creative"
+        },
+        {
+            name: SharedOptions.top_p, type: OptionType.numeric, min: 0, max: 1,
+            integer: false, step: 0.1, description: "Limits token sampling to the cumulative probability of the top p tokens"
+        },
+        {
+            name: SharedOptions.top_k, type: OptionType.numeric, min: 1,
+            integer: true, step: 1, description: "Limits token sampling to the top k tokens"
+        },
+        {
+            name: SharedOptions.presence_penalty, type: OptionType.numeric, min: -2, max: 2.0,
+            integer: false, step: 0.1, description: "Penalise tokens if they appear at least once in the text"
+        },
+        {
+            name: SharedOptions.frequency_penalty, type: OptionType.numeric, min: -2, max: 2.0,
+            integer: false, step: 0.1, description: "Penalise tokens based on their frequency in the text"
+        },
+        { name: SharedOptions.stop_sequence, type: OptionType.string_list, value: [], description: "The generation will halt if one of the stop sequences is output" },
+    ]
+});
+
+var ImagenTaskType;
+(function (ImagenTaskType) {
+    ImagenTaskType["TEXT_IMAGE"] = "TEXT_IMAGE";
+    ImagenTaskType["EDIT_MODE_INPAINT_REMOVAL"] = "EDIT_MODE_INPAINT_REMOVAL";
+    ImagenTaskType["EDIT_MODE_INPAINT_INSERTION"] = "EDIT_MODE_INPAINT_INSERTION";
+    ImagenTaskType["EDIT_MODE_BGSWAP"] = "EDIT_MODE_BGSWAP";
+    ImagenTaskType["EDIT_MODE_OUTPAINT"] = "EDIT_MODE_OUTPAINT";
+    ImagenTaskType["CUSTOMIZATION_SUBJECT"] = "CUSTOMIZATION_SUBJECT";
+    ImagenTaskType["CUSTOMIZATION_STYLE"] = "CUSTOMIZATION_STYLE";
+    ImagenTaskType["CUSTOMIZATION_CONTROLLED"] = "CUSTOMIZATION_CONTROLLED";
+    ImagenTaskType["CUSTOMIZATION_INSTRUCT"] = "CUSTOMIZATION_INSTRUCT";
+})(ImagenTaskType || (ImagenTaskType = {}));
+var ImagenMaskMode;
+(function (ImagenMaskMode) {
+    ImagenMaskMode["MASK_MODE_USER_PROVIDED"] = "MASK_MODE_USER_PROVIDED";
+    ImagenMaskMode["MASK_MODE_BACKGROUND"] = "MASK_MODE_BACKGROUND";
+    ImagenMaskMode["MASK_MODE_FOREGROUND"] = "MASK_MODE_FOREGROUND";
+    ImagenMaskMode["MASK_MODE_SEMANTIC"] = "MASK_MODE_SEMANTIC";
+})(ImagenMaskMode || (ImagenMaskMode = {}));
+var ThinkingLevel;
+(function (ThinkingLevel) {
+    ThinkingLevel["HIGH"] = "HIGH";
+    ThinkingLevel["LOW"] = "LOW";
+    ThinkingLevel["THINKING_LEVEL_UNSPECIFIED"] = "THINKING_LEVEL_UNSPECIFIED";
+})(ThinkingLevel || (ThinkingLevel = {}));
+
+// Virtual providers from studio
+var CustomProviders;
+(function (CustomProviders) {
+    CustomProviders["virtual_lb"] = "virtual_lb";
+    CustomProviders["virtual_mediator"] = "virtual_mediator";
+    CustomProviders["test"] = "test";
+})(CustomProviders || (CustomProviders = {}));
+({
+    ...Providers,
+    ...CustomProviders
+});
+({
+    virtual_lb: {
+        id: CustomProviders.virtual_lb},
+    virtual_mediator: {
+        id: CustomProviders.virtual_mediator},
+    test: {
+        id: CustomProviders.test},
+});
+
+var SupportedIntegrations;
+(function (SupportedIntegrations) {
+    SupportedIntegrations["gladia"] = "gladia";
+    SupportedIntegrations["github"] = "github";
+    SupportedIntegrations["aws"] = "aws";
+    SupportedIntegrations["magic_pdf"] = "magic_pdf";
+    SupportedIntegrations["serper"] = "serper";
+    SupportedIntegrations["resend"] = "resend";
+    SupportedIntegrations["ask_user_webhook"] = "ask_user_webhook";
+})(SupportedIntegrations || (SupportedIntegrations = {}));
+
+var MeterNames;
+(function (MeterNames) {
+    MeterNames["analyzed_pages"] = "analyzed_pages";
+    MeterNames["extracted_tables"] = "extracted_tables";
+    MeterNames["analyzed_images"] = "analyzed_images";
+    MeterNames["input_token_used"] = "input_token_used";
+    MeterNames["output_token_used"] = "output_token_used";
+    MeterNames["task_run"] = "task_run";
+})(MeterNames || (MeterNames = {}));
+
+var ProjectRoles;
+(function (ProjectRoles) {
+    ProjectRoles["owner"] = "owner";
+    ProjectRoles["admin"] = "admin";
+    ProjectRoles["manager"] = "manager";
+    ProjectRoles["developer"] = "developer";
+    ProjectRoles["application"] = "application";
+    ProjectRoles["consumer"] = "consumer";
+    ProjectRoles["executor"] = "executor";
+    ProjectRoles["reader"] = "reader";
+    ProjectRoles["billing"] = "billing";
+    ProjectRoles["member"] = "member";
+    ProjectRoles["app_member"] = "app_member";
+    ProjectRoles["content_superadmin"] = "content_superadmin";
+})(ProjectRoles || (ProjectRoles = {}));
+var ResourceVisibility;
+(function (ResourceVisibility) {
+    ResourceVisibility["public"] = "public";
+    ResourceVisibility["account"] = "account";
+    ResourceVisibility["project"] = "project";
+})(ResourceVisibility || (ResourceVisibility = {}));
+/**
+ * System interaction category enum.
+ * Categories group one or more system interactions for default model assignment.
+ */
+var SystemInteractionCategory;
+(function (SystemInteractionCategory) {
+    SystemInteractionCategory["content_type"] = "content_type";
+    SystemInteractionCategory["intake"] = "intake";
+    SystemInteractionCategory["analysis"] = "analysis";
+    SystemInteractionCategory["non_applicable"] = "non_applicable";
+})(SystemInteractionCategory || (SystemInteractionCategory = {}));
+/**
+ * Map system interaction endpoints to categories.
+ */
+({
+    "ExtractInformation": SystemInteractionCategory.intake,
+    "SelectDocumentType": SystemInteractionCategory.intake,
+    "GenerateMetadataModel": SystemInteractionCategory.content_type,
+    "ChunkDocument": SystemInteractionCategory.intake,
+    "IdentifyTextSections": SystemInteractionCategory.intake,
+    "AnalyzeDocument": SystemInteractionCategory.analysis,
+    "ReduceTextSections": SystemInteractionCategory.analysis,
+    "GenericAgent": SystemInteractionCategory.non_applicable,
+    "AdhocTaskAgent": SystemInteractionCategory.non_applicable,
+    "Mediator": SystemInteractionCategory.non_applicable,
+    "AnalyzeConversation": SystemInteractionCategory.analysis,
+    "GetAgentConversationTopic": SystemInteractionCategory.analysis,
+});
+// export interface ProjectConfigurationEmbeddings {
+//     environment: string;
+//     max_tokens: number;
+//     dimensions: number;
+//     model?: string;
+// }
+var SupportedEmbeddingTypes;
+(function (SupportedEmbeddingTypes) {
+    SupportedEmbeddingTypes["text"] = "text";
+    SupportedEmbeddingTypes["image"] = "image";
+    SupportedEmbeddingTypes["properties"] = "properties";
+})(SupportedEmbeddingTypes || (SupportedEmbeddingTypes = {}));
+var FullTextType;
+(function (FullTextType) {
+    FullTextType["full_text"] = "full_text";
+})(FullTextType || (FullTextType = {}));
+({
+    ...SupportedEmbeddingTypes,
+    ...FullTextType
+});
+
+var PromptStatus;
+(function (PromptStatus) {
+    PromptStatus["draft"] = "draft";
+    PromptStatus["published"] = "published";
+    PromptStatus["archived"] = "archived";
+})(PromptStatus || (PromptStatus = {}));
+var PromptSegmentDefType;
+(function (PromptSegmentDefType) {
+    PromptSegmentDefType["chat"] = "chat";
+    PromptSegmentDefType["template"] = "template";
+})(PromptSegmentDefType || (PromptSegmentDefType = {}));
+var TemplateType;
+(function (TemplateType) {
+    TemplateType["jst"] = "jst";
+    TemplateType["handlebars"] = "handlebars";
+    TemplateType["text"] = "text";
+})(TemplateType || (TemplateType = {}));
+
+var ResolvableRefType;
+(function (ResolvableRefType) {
+    ResolvableRefType["project"] = "Project";
+    ResolvableRefType["projects"] = "Projects";
+    ResolvableRefType["environment"] = "Environment";
+    ResolvableRefType["user"] = "User";
+    ResolvableRefType["account"] = "Account";
+    ResolvableRefType["interaction"] = "Interaction";
+    ResolvableRefType["userGroup"] = "UserGroup";
+})(ResolvableRefType || (ResolvableRefType = {}));
+
+var CollectionStatus;
+(function (CollectionStatus) {
+    CollectionStatus["active"] = "active";
+    CollectionStatus["archived"] = "archived";
+})(CollectionStatus || (CollectionStatus = {}));
+
+var ContentObjectApiHeaders;
+(function (ContentObjectApiHeaders) {
+    ContentObjectApiHeaders["COLLECTION_ID"] = "x-collection-id";
+    ContentObjectApiHeaders["PROCESSING_PRIORITY"] = "x-processing-priority";
+    ContentObjectApiHeaders["CREATE_REVISION"] = "x-create-revision";
+    ContentObjectApiHeaders["REVISION_LABEL"] = "x-revision-label";
+    /** When set to 'true', prevents this update from triggering workflow rules */
+    ContentObjectApiHeaders["SUPPRESS_WORKFLOWS"] = "x-suppress-workflows";
+})(ContentObjectApiHeaders || (ContentObjectApiHeaders = {}));
+/**
+ * Headers for Data Store API calls.
+ * Used for Cloud Run session affinity to route requests to the same instance.
+ */
+var DataStoreApiHeaders;
+(function (DataStoreApiHeaders) {
+    /** Data store ID for session affinity - routes requests for same store to same instance */
+    DataStoreApiHeaders["DATA_STORE_ID"] = "x-data-store-id";
+})(DataStoreApiHeaders || (DataStoreApiHeaders = {}));
+var ContentObjectStatus;
+(function (ContentObjectStatus) {
+    ContentObjectStatus["created"] = "created";
+    ContentObjectStatus["processing"] = "processing";
+    ContentObjectStatus["ready"] = "ready";
+    ContentObjectStatus["completed"] = "completed";
+    ContentObjectStatus["failed"] = "failed";
+    ContentObjectStatus["archived"] = "archived";
+})(ContentObjectStatus || (ContentObjectStatus = {}));
+var ContentNature;
+(function (ContentNature) {
+    ContentNature["Video"] = "video";
+    ContentNature["Image"] = "image";
+    ContentNature["Audio"] = "audio";
+    ContentNature["Document"] = "document";
+    ContentNature["Code"] = "code";
+    ContentNature["Other"] = "other";
+})(ContentNature || (ContentNature = {}));
+var WorkflowRuleInputType;
+(function (WorkflowRuleInputType) {
+    WorkflowRuleInputType["single"] = "single";
+    WorkflowRuleInputType["multiple"] = "multiple";
+    WorkflowRuleInputType["none"] = "none";
+})(WorkflowRuleInputType || (WorkflowRuleInputType = {}));
+var ImageRenditionFormat;
+(function (ImageRenditionFormat) {
+    ImageRenditionFormat["jpeg"] = "jpeg";
+    ImageRenditionFormat["png"] = "png";
+    ImageRenditionFormat["webp"] = "webp";
+})(ImageRenditionFormat || (ImageRenditionFormat = {}));
+var MarkdownRenditionFormat;
+(function (MarkdownRenditionFormat) {
+    MarkdownRenditionFormat["docx"] = "docx";
+    MarkdownRenditionFormat["pdf"] = "pdf";
+})(MarkdownRenditionFormat || (MarkdownRenditionFormat = {}));
+/**
+ * Matrix of supported content type → format conversions.
+ * This is the authoritative source of truth for what renditions can be generated.
+ *
+ * Key patterns:
+ * - Exact MIME types (e.g., 'application/pdf')
+ * - Wildcard patterns (e.g., 'image/*', 'video/*')
+ */
+({
+    // Image formats can generate: jpeg, png, webp
+    'image/*': [ImageRenditionFormat.jpeg, ImageRenditionFormat.png, ImageRenditionFormat.webp],
+    // Video formats can generate: jpeg, png (thumbnails)
+    'video/*': [ImageRenditionFormat.jpeg, ImageRenditionFormat.png],
+    // PDF can generate: jpeg, png, webp (page images)
+    'application/pdf': [ImageRenditionFormat.jpeg, ImageRenditionFormat.png, ImageRenditionFormat.webp],
+    // Markdown can generate: pdf, docx (NOT jpeg/png)
+    'text/markdown': [MarkdownRenditionFormat.pdf, MarkdownRenditionFormat.docx],
+    // Plain text can generate: docx
+    'text/plain': [MarkdownRenditionFormat.docx],
+    // Office documents can generate: pdf
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': [MarkdownRenditionFormat.pdf],
+    'application/msword': [MarkdownRenditionFormat.pdf],
+    'application/vnd.openxmlformats-officedocument.presentationml.presentation': [MarkdownRenditionFormat.pdf],
+    'application/vnd.ms-powerpoint': [MarkdownRenditionFormat.pdf],
+});
+var ContentObjectProcessingPriority;
+(function (ContentObjectProcessingPriority) {
+    ContentObjectProcessingPriority["normal"] = "normal";
+    ContentObjectProcessingPriority["low"] = "low";
+})(ContentObjectProcessingPriority || (ContentObjectProcessingPriority = {}));
+
+var ContentEventName;
+(function (ContentEventName) {
+    ContentEventName["create"] = "create";
+    ContentEventName["change_type"] = "change_type";
+    ContentEventName["update"] = "update";
+    ContentEventName["revision_created"] = "revision_created";
+    ContentEventName["delete"] = "delete";
+    ContentEventName["workflow_finished"] = "workflow_finished";
+    ContentEventName["workflow_execution_request"] = "workflow_execution_request";
+    ContentEventName["api_request"] = "api_request";
+})(ContentEventName || (ContentEventName = {}));
+// Task status enum for processed history
+var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["SCHEDULED"] = "scheduled";
+    TaskStatus["RUNNING"] = "running";
+    TaskStatus["COMPLETED"] = "completed";
+    TaskStatus["FAILED"] = "failed";
+    TaskStatus["CANCELED"] = "canceled";
+    TaskStatus["TIMED_OUT"] = "timed_out";
+    TaskStatus["TERMINATED"] = "terminated";
+    TaskStatus["SENT"] = "sent";
+    TaskStatus["RECEIVED"] = "received";
+})(TaskStatus || (TaskStatus = {}));
+// Task type enum
+var TaskType;
+(function (TaskType) {
+    TaskType["ACTIVITY"] = "activity";
+    TaskType["CHILD_WORKFLOW"] = "childWorkflow";
+    TaskType["SIGNAL"] = "signal";
+})(TaskType || (TaskType = {}));
+var WorkflowExecutionStatus;
+(function (WorkflowExecutionStatus) {
+    WorkflowExecutionStatus[WorkflowExecutionStatus["UNKNOWN"] = 0] = "UNKNOWN";
+    WorkflowExecutionStatus[WorkflowExecutionStatus["RUNNING"] = 1] = "RUNNING";
+    WorkflowExecutionStatus[WorkflowExecutionStatus["COMPLETED"] = 2] = "COMPLETED";
+    WorkflowExecutionStatus[WorkflowExecutionStatus["FAILED"] = 3] = "FAILED";
+    WorkflowExecutionStatus[WorkflowExecutionStatus["CANCELED"] = 4] = "CANCELED";
+    WorkflowExecutionStatus[WorkflowExecutionStatus["TERMINATED"] = 5] = "TERMINATED";
+    WorkflowExecutionStatus[WorkflowExecutionStatus["CONTINUED_AS_NEW"] = 6] = "CONTINUED_AS_NEW";
+    WorkflowExecutionStatus[WorkflowExecutionStatus["TIMED_OUT"] = 7] = "TIMED_OUT";
+})(WorkflowExecutionStatus || (WorkflowExecutionStatus = {}));
+var AgentMessageType;
+(function (AgentMessageType) {
+    AgentMessageType[AgentMessageType["SYSTEM"] = 0] = "SYSTEM";
+    AgentMessageType[AgentMessageType["THOUGHT"] = 1] = "THOUGHT";
+    AgentMessageType[AgentMessageType["PLAN"] = 2] = "PLAN";
+    AgentMessageType[AgentMessageType["UPDATE"] = 3] = "UPDATE";
+    AgentMessageType[AgentMessageType["COMPLETE"] = 4] = "COMPLETE";
+    AgentMessageType[AgentMessageType["WARNING"] = 5] = "WARNING";
+    AgentMessageType[AgentMessageType["ERROR"] = 6] = "ERROR";
+    AgentMessageType[AgentMessageType["ANSWER"] = 7] = "ANSWER";
+    AgentMessageType[AgentMessageType["QUESTION"] = 8] = "QUESTION";
+    AgentMessageType[AgentMessageType["REQUEST_INPUT"] = 9] = "REQUEST_INPUT";
+    AgentMessageType[AgentMessageType["IDLE"] = 10] = "IDLE";
+    AgentMessageType[AgentMessageType["TERMINATED"] = 11] = "TERMINATED";
+    AgentMessageType[AgentMessageType["STREAMING_CHUNK"] = 12] = "STREAMING_CHUNK";
+    AgentMessageType[AgentMessageType["BATCH_PROGRESS"] = 13] = "BATCH_PROGRESS";
+})(AgentMessageType || (AgentMessageType = {}));
+// ============================================
+// CONVERTERS
+// ============================================
+/**
+ * Map old string enum values to AgentMessageType
+ */
+({
+    'system': AgentMessageType.SYSTEM,
+    'thought': AgentMessageType.THOUGHT,
+    'plan': AgentMessageType.PLAN,
+    'update': AgentMessageType.UPDATE,
+    'complete': AgentMessageType.COMPLETE,
+    'warning': AgentMessageType.WARNING,
+    'error': AgentMessageType.ERROR,
+    'answer': AgentMessageType.ANSWER,
+    'question': AgentMessageType.QUESTION,
+    'request_input': AgentMessageType.REQUEST_INPUT,
+    'idle': AgentMessageType.IDLE,
+    'terminated': AgentMessageType.TERMINATED,
+    'streaming_chunk': AgentMessageType.STREAMING_CHUNK,
+    'batch_progress': AgentMessageType.BATCH_PROGRESS,
+});
+/**
+ * Map integer values to AgentMessageType (primary format)
+ */
+({
+    0: AgentMessageType.SYSTEM,
+    1: AgentMessageType.THOUGHT,
+    2: AgentMessageType.PLAN,
+    3: AgentMessageType.UPDATE,
+    4: AgentMessageType.COMPLETE,
+    5: AgentMessageType.WARNING,
+    6: AgentMessageType.ERROR,
+    7: AgentMessageType.ANSWER,
+    8: AgentMessageType.QUESTION,
+    9: AgentMessageType.REQUEST_INPUT,
+    10: AgentMessageType.IDLE,
+    11: AgentMessageType.TERMINATED,
+    12: AgentMessageType.STREAMING_CHUNK,
+    13: AgentMessageType.BATCH_PROGRESS,
+});
+/**
+ * Status of a file being processed for conversation use.
+ */
+var FileProcessingStatus;
+(function (FileProcessingStatus) {
+    /** File is being uploaded to artifact storage */
+    FileProcessingStatus["UPLOADING"] = "uploading";
+    /** File uploaded, text extraction in progress */
+    FileProcessingStatus["PROCESSING"] = "processing";
+    /** File is ready for use in conversation */
+    FileProcessingStatus["READY"] = "ready";
+    /** File processing failed */
+    FileProcessingStatus["ERROR"] = "error";
+})(FileProcessingStatus || (FileProcessingStatus = {}));
+
+var TrainingSessionStatus;
+(function (TrainingSessionStatus) {
+    TrainingSessionStatus["created"] = "created";
+    TrainingSessionStatus["building"] = "building";
+    TrainingSessionStatus["prepared"] = "prepared";
+    TrainingSessionStatus["processing"] = "processing";
+    TrainingSessionStatus["completed"] = "completed";
+    TrainingSessionStatus["cancelled"] = "cancelled";
+    TrainingSessionStatus["failed"] = "failed";
+})(TrainingSessionStatus || (TrainingSessionStatus = {}));
+
+var TransientTokenType;
+(function (TransientTokenType) {
+    TransientTokenType["userInvite"] = "user-invite";
+    TransientTokenType["migration"] = "migration";
+})(TransientTokenType || (TransientTokenType = {}));
+
+var Datacenters;
+(function (Datacenters) {
+    Datacenters["aws"] = "aws";
+    Datacenters["gcp"] = "gcp";
+    Datacenters["azure"] = "azure";
+})(Datacenters || (Datacenters = {}));
+var BillingMethod;
+(function (BillingMethod) {
+    BillingMethod["stripe"] = "stripe";
+    BillingMethod["invoice"] = "invoice";
+})(BillingMethod || (BillingMethod = {}));
+var AccountType;
+(function (AccountType) {
+    AccountType["vertesia"] = "vertesia";
+    AccountType["partner"] = "partner";
+    AccountType["free"] = "free";
+    AccountType["customer"] = "customer";
+    AccountType["unknown"] = "unknown";
+})(AccountType || (AccountType = {}));
+
+var ApiVersions;
+(function (ApiVersions) {
+    ApiVersions[ApiVersions["COMPLETION_RESULT_V1"] = 20250925] = "COMPLETION_RESULT_V1";
+})(ApiVersions || (ApiVersions = {}));
+
+/**
+ * Agent Observability Telemetry Types
+ *
+ * These types define the event-based model for agent observability.
+ */
+// ============================================================================
+// Enums
+// ============================================================================
+/**
+ * Types of telemetry events
+ */
+var AgentEventType;
+(function (AgentEventType) {
+    AgentEventType["AgentRunStarted"] = "agent_run_started";
+    AgentEventType["AgentRunCompleted"] = "agent_run_completed";
+    AgentEventType["LlmCall"] = "llm_call";
+    AgentEventType["ToolCall"] = "tool_call";
+})(AgentEventType || (AgentEventType = {}));
+/**
+ * Types of LLM calls in a conversation
+ */
+var LlmCallType;
+(function (LlmCallType) {
+    /** Initial conversation start */
+    LlmCallType["Start"] = "start";
+    /** Resuming with tool results */
+    LlmCallType["ResumeTools"] = "resume_tools";
+    /** Resuming with user message */
+    LlmCallType["ResumeUser"] = "resume_user";
+    /** Checkpoint resume (after conversation summarization) */
+    LlmCallType["Checkpoint"] = "checkpoint";
+    /** Nested interaction call from within tools */
+    LlmCallType["NestedInteraction"] = "nested_interaction";
+})(LlmCallType || (LlmCallType = {}));
+/**
+ * Types of tools that can be called
+ */
+var TelemetryToolType;
+(function (TelemetryToolType) {
+    /** Built-in tools (e.g., plan, search) */
+    TelemetryToolType["Builtin"] = "builtin";
+    /** Interaction-based tools */
+    TelemetryToolType["Interaction"] = "interaction";
+    /** Remote/MCP tools */
+    TelemetryToolType["Remote"] = "remote";
+    /** Skill tools */
+    TelemetryToolType["Skill"] = "skill";
+})(TelemetryToolType || (TelemetryToolType = {}));
+
+/**
+ * Prompt transformer preset for template files with frontmatter
+ * Supports .jst, .hbs, and plain text files
+ */
 /**
  * Zod schema for prompt frontmatter validation
  */