@vertesia/common 1.6.0-dev.20261004.085740Z → 1.6.0-dev.20261008.064737Z

package/src/api-contract/components.generated.json

@@ -1,115 +1,4 @@
 {
-  "RunBudgetOwner": {
-    "type": "object",
-    "properties": {
-      "workflow_id": {
-        "type": "string",
-        "minLength": 1
-      },
-      "first_run_id": {
-        "type": "string",
-        "minLength": 1
-      }
-    },
-    "required": [
-      "workflow_id",
-      "first_run_id"
-    ],
-    "additionalProperties": false
-  },
-  "RunBudgetUsage": {
-    "type": "object",
-    "properties": {
-      "input": {
-        "type": "number",
-        "minimum": 0
-      },
-      "cached_input": {
-        "type": "number",
-        "minimum": 0
-      },
-      "output": {
-        "type": "number",
-        "minimum": 0
-      }
-    },
-    "required": [
-      "input",
-      "cached_input",
-      "output"
-    ],
-    "additionalProperties": false
-  },
-  "ReadRunBudgetUsagePayload": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string",
-        "minLength": 1
-      },
-      "project_id": {
-        "type": "string",
-        "minLength": 1
-      },
-      "agent_run_id": {
-        "type": "string",
-        "minLength": 1
-      },
-      "owner": {
-        "$ref": "#/components/schemas/RunBudgetOwner"
-      },
-      "require_estimates": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "account_id",
-      "project_id",
-      "agent_run_id",
-      "owner"
-    ],
-    "additionalProperties": false
-  },
-  "RunBudgetTotals": {
-    "type": "object",
-    "properties": {
-      "measured": {
-        "$ref": "#/components/schemas/RunBudgetUsage"
-      },
-      "unpriced": {
-        "$ref": "#/components/schemas/RunBudgetUsage"
-      },
-      "reported_nano_usd": {
-        "type": "integer",
-        "minimum": 0,
-        "maximum": 9007199254740991
-      },
-      "estimated_nano_usd": {
-        "type": "integer",
-        "minimum": 0,
-        "maximum": 9007199254740991
-      },
-      "unmeasured_calls": {
-        "type": "integer",
-        "minimum": 0,
-        "maximum": 9007199254740991
-      },
-      "missing_usage_calls": {
-        "type": "integer",
-        "minimum": 0,
-        "maximum": 9007199254740991
-      }
-    },
-    "required": [
-      "measured",
-      "unpriced",
-      "reported_nano_usd",
-      "estimated_nano_usd",
-      "unmeasured_calls",
-      "missing_usage_calls"
-    ],
-    "additionalProperties": false
-  },
   "RunBudgetCapability": {
     "type": "object",
     "properties": {
@@ -282,20 +171,6 @@
       "$ref": "#/components/schemas/DelegationGrant"
     }
   },
-  "AccountApiVersionPolicy": {
-    "type": "object",
-    "properties": {
-      "default_api_version": {
-        "type": "number",
-        "enum": [
-          20250925,
-          20260210,
-          20260319,
-          20260803
-        ]
-      }
-    }
-  },
   "AccountType": {
     "type": "string",
     "enum": [
@@ -16246,6 +16121,554 @@
     "additionalProperties": false,
     "description": "Whether an API key is configured for an MCP tool collection"
   },
+  "AuditAdoptionActiveDays": {
+    "type": "object",
+    "properties": {
+      "days": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 367
+      },
+      "users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "required": [
+      "days",
+      "users"
+    ],
+    "additionalProperties": false
+  },
+  "AuditAdoptionBucket": {
+    "type": "object",
+    "properties": {
+      "from": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "to": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "partial": {
+        "type": "boolean"
+      },
+      "active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "required": [
+      "from",
+      "to",
+      "partial",
+      "active_users"
+    ],
+    "additionalProperties": false
+  },
+  "KnownAuditAction": {
+    "type": "string",
+    "enum": [
+      "create",
+      "update",
+      "delete",
+      "bulk_create",
+      "bulk_change_type",
+      "bulk_update",
+      "bulk_delete",
+      "attach",
+      "detach",
+      "credentials_fill",
+      "credentials_totp_generation",
+      "publish",
+      "unpublish",
+      "search",
+      "read",
+      "inference",
+      "embedding",
+      "image_generation",
+      "document_processed"
+    ]
+  },
+  "EventCategory": {
+    "type": "string",
+    "enum": [
+      "content",
+      "workflow",
+      "security",
+      "billing",
+      "system",
+      "external"
+    ]
+  },
+  "AuditAction": {
+    "anyOf": [
+      {
+        "$ref": "#/components/schemas/KnownAuditAction"
+      },
+      {
+        "type": "string"
+      }
+    ]
+  },
+  "AuditAdoptionFilter": {
+    "type": "object",
+    "properties": {
+      "actions": {
+        "maxItems": 32,
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditAction"
+        }
+      },
+      "resourceTypes": {
+        "maxItems": 16,
+        "type": "array",
+        "items": {
+          "type": "string",
+          "maxLength": 128
+        }
+      },
+      "eventCategories": {
+        "maxItems": 6,
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/EventCategory"
+        }
+      }
+    },
+    "additionalProperties": false
+  },
+  "AuditAdoptionHistory": {
+    "type": "object",
+    "properties": {
+      "earliest_observed_at": {
+        "anyOf": [
+          {
+            "type": "string",
+            "format": "date-time"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "coverage_from": {
+        "anyOf": [
+          {
+            "type": "string",
+            "format": "date-time",
+            "description": "Authoritative complete-history boundary, if known. Earliest observation is not a coverage boundary."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "completeness": {
+        "type": "string",
+        "enum": [
+          "unknown",
+          "insufficient",
+          "verified"
+        ]
+      },
+      "retention_unavailable_reason": {
+        "anyOf": [
+          {
+            "type": "string",
+            "enum": [
+              "no_previous_users",
+              "insufficient_history"
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "earliest_observed_at",
+      "coverage_from",
+      "completeness",
+      "retention_unavailable_reason"
+    ],
+    "additionalProperties": false
+  },
+  "AuditAdoptionPeriod": {
+    "type": "object",
+    "properties": {
+      "from": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "to": {
+        "type": "string",
+        "format": "date-time"
+      }
+    },
+    "required": [
+      "from",
+      "to"
+    ],
+    "additionalProperties": false
+  },
+  "AuditAdoptionProject": {
+    "type": "object",
+    "properties": {
+      "project_id": {
+        "type": "string"
+      },
+      "project_name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "active_user_days": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "required": [
+      "project_id",
+      "project_name",
+      "active_users",
+      "active_user_days"
+    ],
+    "additionalProperties": false
+  },
+  "AuditAdoptionQuery": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string"
+      },
+      "from": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Inclusive start; defaults to 30 days before to."
+      },
+      "to": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Exclusive end; defaults to now. Maximum duration: 366 days."
+      },
+      "filter": {
+        "$ref": "#/components/schemas/AuditAdoptionFilter"
+      }
+    },
+    "additionalProperties": false,
+    "description": "Productive direct authenticated user activity, including user OAuth/MCP calls. Scope is enforced by the server."
+  },
+  "AuditAdoptionResponse": {
+    "type": "object",
+    "properties": {
+      "period": {
+        "$ref": "#/components/schemas/AuditAdoptionPeriod"
+      },
+      "previous_period": {
+        "$ref": "#/components/schemas/AuditAdoptionPeriod"
+      },
+      "resolution": {
+        "type": "string",
+        "enum": [
+          "day",
+          "week"
+        ]
+      },
+      "active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "previous_active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "retained_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "observed_retention": {
+        "anyOf": [
+          {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "returning_user_share": {
+        "anyOf": [
+          {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "repeat_user_share": {
+        "anyOf": [
+          {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "median_active_days": {
+        "anyOf": [
+          {
+            "type": "number",
+            "minimum": 0
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "active_projects": {
+        "anyOf": [
+          {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "timeline": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditAdoptionBucket"
+        }
+      },
+      "active_day_distribution": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditAdoptionActiveDays"
+        }
+      },
+      "top_projects": {
+        "maxItems": 10,
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditAdoptionProject"
+        }
+      },
+      "history": {
+        "$ref": "#/components/schemas/AuditAdoptionHistory"
+      }
+    },
+    "required": [
+      "period",
+      "previous_period",
+      "resolution",
+      "active_users",
+      "previous_active_users",
+      "retained_users",
+      "observed_retention",
+      "returning_user_share",
+      "repeat_user_share",
+      "median_active_days",
+      "active_projects",
+      "timeline",
+      "active_day_distribution",
+      "top_projects",
+      "history"
+    ],
+    "additionalProperties": false,
+    "description": "Distinct user adoption sets over two equal-duration half-open periods. Ratios use available audit history, not guaranteed historical coverage. No user identities are returned."
+  },
+  "AuditUsageQuery": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string"
+      },
+      "from": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Inclusive start; defaults to 30 days before to."
+      },
+      "to": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Exclusive end; defaults to now. Maximum duration: 366 days."
+      },
+      "resolution": {
+        "type": "string",
+        "enum": [
+          "day",
+          "week",
+          "month"
+        ],
+        "description": "UTC calendar buckets. Weeks start Monday. Omitted: daily up to 200 dates, otherwise weekly."
+      }
+    },
+    "additionalProperties": false,
+    "description": "Usage trends for an authorized account or project over a half-open interval of at most 366 days."
+  },
+  "AuditUsageCounts": {
+    "type": "object",
+    "properties": {
+      "active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "agent_runs": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991,
+        "description": "All audited run creations and marked restarts, including automated runs."
+      },
+      "user_agent_runs": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991,
+        "description": "Run operations initiated directly by authenticated users, including OAuth/MCP."
+      },
+      "automated_agent_runs": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991,
+        "description": "Other run operations, including schedules, delegated agents, services and API keys."
+      },
+      "agent_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991,
+        "description": "Distinct identifiable user initiators or owners of run operations, including scheduled and delegated runs."
+      },
+      "direct_calls": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "direct_call_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "content_objects": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "user_content_objects": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "other_content_objects": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "required": [
+      "active_users",
+      "agent_runs",
+      "user_agent_runs",
+      "automated_agent_runs",
+      "agent_users",
+      "direct_calls",
+      "direct_call_users",
+      "content_objects",
+      "user_content_objects",
+      "other_content_objects"
+    ],
+    "additionalProperties": false,
+    "description": "Direct productive users, run initiators/owners, all run operations and standalone inference audit events."
+  },
+  "AuditUsageBucket": {
+    "type": "object",
+    "properties": {
+      "from": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "to": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "partial": {
+        "type": "boolean"
+      },
+      "counts": {
+        "$ref": "#/components/schemas/AuditUsageCounts"
+      }
+    },
+    "required": [
+      "from",
+      "to",
+      "partial",
+      "counts"
+    ],
+    "additionalProperties": false
+  },
+  "AuditUsageResponse": {
+    "type": "object",
+    "properties": {
+      "period": {
+        "$ref": "#/components/schemas/AuditAdoptionPeriod"
+      },
+      "resolution": {
+        "type": "string",
+        "enum": [
+          "day",
+          "week",
+          "month"
+        ]
+      },
+      "totals": {
+        "$ref": "#/components/schemas/AuditUsageCounts"
+      },
+      "timeline": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditUsageBucket"
+        }
+      }
+    },
+    "required": [
+      "period",
+      "resolution",
+      "totals",
+      "timeline"
+    ],
+    "additionalProperties": false,
+    "description": "UTC usage trends. Period-wide distinct users are not sums of bucket populations. No user identities are returned."
+  },
   "AuditMeter": {
     "type": "object",
     "properties": {
@@ -16267,39 +16690,6 @@
     "additionalProperties": false,
     "description": "Generic metering entry attached to audit events. Used for cost attribution, usage tracking, and billing.\n\nExamples:   { category: \"tokens\", type: \"input\", quantity: 1234 }   { category: \"tokens\", type: \"output\", quantity: 567 }   { category: \"compute\", type: \"duration_ms\", quantity: 2100 }   { category: \"processing\", type: \"pages\", quantity: 12 }"
   },
-  "KnownAuditAction": {
-    "type": "string",
-    "enum": [
-      "create",
-      "update",
-      "delete",
-      "bulk_create",
-      "bulk_change_type",
-      "bulk_update",
-      "bulk_delete",
-      "attach",
-      "detach",
-      "credentials_fill",
-      "credentials_totp_generation",
-      "publish",
-      "unpublish",
-      "inference",
-      "embedding",
-      "image_generation",
-      "document_processed"
-    ]
-  },
-  "EventCategory": {
-    "type": "string",
-    "enum": [
-      "content",
-      "workflow",
-      "security",
-      "billing",
-      "system",
-      "external"
-    ]
-  },
   "AuditAggregationDimensionMap": {
     "type": "object",
     "properties": {
@@ -16383,6 +16773,17 @@
           }
         ]
       },
+      "user_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Originating user identity, including delegated and scheduled activity with a recorded user owner. Non-user principals without a user origin are excluded."
+      },
       "details.pipeline": {
         "anyOf": [
           {
@@ -16442,7 +16843,8 @@
       "resource_id",
       "request_id",
       "principal_id",
-      "actor_id"
+      "actor_id",
+      "user_id"
     ]
   },
   "AuditAggregationOperation": {
@@ -16474,6 +16876,7 @@
       "project_id",
       "principal_id",
       "actor_id",
+      "user_id",
       "details.pipeline",
       "details.verdict",
       "details.workflow_type",
@@ -16490,16 +16893,6 @@
       "rule_id"
     ]
   },
-  "AuditAction": {
-    "anyOf": [
-      {
-        "$ref": "#/components/schemas/KnownAuditAction"
-      },
-      {
-        "type": "string"
-      }
-    ]
-  },
   "AuditAggregationRow": {
     "type": "object",
     "properties": {
@@ -20893,240 +21286,6 @@
       }
     }
   },
-  "EventWebhookSigningSecretRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "project_id"
-    ],
-    "additionalProperties": false
-  },
-  "EventWebhookSigningSecretResponse": {
-    "type": "object",
-    "properties": {
-      "subscription_id": {
-        "type": "string"
-      },
-      "secret": {
-        "type": "string"
-      },
-      "secret_label": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "subscription_id",
-      "secret",
-      "secret_label"
-    ],
-    "additionalProperties": false
-  },
-  "SignEventWebhookRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      },
-      "delivery_id": {
-        "type": "string"
-      },
-      "body": {
-        "type": "string"
-      },
-      "event_id": {
-        "type": "string"
-      },
-      "event_category": {
-        "$ref": "#/components/schemas/EventCategory"
-      },
-      "action": {
-        "type": "string"
-      },
-      "timestamp": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "project_id",
-      "delivery_id",
-      "body",
-      "event_id",
-      "event_category",
-      "action"
-    ],
-    "additionalProperties": false
-  },
-  "SignEventWebhookResponse": {
-    "type": "object",
-    "properties": {
-      "headers": {
-        "type": "object",
-        "additionalProperties": {
-          "type": "string"
-        }
-      },
-      "timestamp": {
-        "type": "number"
-      },
-      "signature": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "headers",
-      "timestamp",
-      "signature"
-    ],
-    "additionalProperties": false
-  },
-  "EventIngestSigningSecretRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "project_id"
-    ],
-    "additionalProperties": false
-  },
-  "EventIngestSigningSecretResponse": {
-    "type": "object",
-    "properties": {
-      "channel_id": {
-        "type": "string"
-      },
-      "secret": {
-        "type": "string"
-      },
-      "secret_label": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "channel_id",
-      "secret",
-      "secret_label"
-    ],
-    "additionalProperties": false
-  },
-  "VerifyEventIngestSignatureRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      },
-      "body": {
-        "type": "string"
-      },
-      "signature_header": {
-        "type": "string"
-      },
-      "algorithm": {
-        "type": "string",
-        "enum": [
-          "sha256",
-          "sha1"
-        ]
-      },
-      "encoding": {
-        "type": "string",
-        "enum": [
-          "hex",
-          "base64"
-        ]
-      },
-      "prefix": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "project_id",
-      "body",
-      "signature_header"
-    ],
-    "additionalProperties": false
-  },
-  "VerifyEventIngestSignatureResponse": {
-    "type": "object",
-    "properties": {
-      "valid": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "valid"
-    ],
-    "additionalProperties": false
-  },
-  "GithubInstallationTokenRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      },
-      "installation_id": {
-        "type": "string"
-      },
-      "repo": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "project_id",
-      "installation_id",
-      "repo"
-    ],
-    "additionalProperties": false
-  },
-  "GithubInstallationTokenResponse": {
-    "type": "object",
-    "properties": {
-      "token": {
-        "type": "string"
-      },
-      "expires_at": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "token"
-    ],
-    "additionalProperties": false
-  },
-  "InternalSecretDeleteResponse": {
-    "type": "object",
-    "properties": {
-      "deleted": {
-        "type": "boolean",
-        "const": true
-      }
-    },
-    "required": [
-      "deleted"
-    ],
-    "additionalProperties": false
-  },
   "SupportedIntegrations_ask_user_webhook": {
     "type": "string",
     "const": "ask_user_webhook"
@@ -42560,6 +42719,10 @@
         "type": "string",
         "description": "Filter by agent run ID"
       },
+      "agent_only": {
+        "type": "boolean",
+        "description": "Restrict usage to agent runs and their attributed nested/background inference. Excludes standalone interactions and non-agent workflows. Defaults to false."
+      },
       "interaction_id": {
         "type": "string",
         "description": "Filter by interaction id: stored ObjectId or namespaced in-code id"