@archastro/sdk 0.4.0 → 0.5.0

package/dist/types/common.js

@@ -1,9 +1,41 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 0bbab3d3f31f
+// Content hash: 4303c5c9f783
 import { z } from "zod";
 import { imageSourceSchema } from "./image.js";
 import { userSchema } from "./users.js";
+/** API schema for a single ACL grant entry. */
+export const aclGrantSchema = z.object({
+    actions: z.array(z.string()), // List of allowed actions (e.g. read, write)
+    principal: z.string().optional(), // Principal identifier (UUID for user/team/org/agent_user, role name for org_role, omit for everyone)
+    principal_type: z.string(), // Principal type: user, team, org, org_role, agent, or everyone
+});
+/** API schema for identifying a principal to remove from an ACL. */
+export const aclRemoveTargetSchema = z.object({
+    principal: z.string().optional(), // Principal identifier to remove (omit for everyone)
+    principal_type: z.string(), // Principal type to remove
+});
+/** Reusable API schema for access control lists.
+
+Supports two modes (mutually exclusive):
+
+**Replace mode** — send `grants` to replace all entries:
+
+    {"grants": [{"principal_type": "user", "principal": "...", "actions": ["read"]}]}
+
+Use `{"grants": []}` to clear all entries.
+
+**Patch mode** — send `add` and/or `remove`:
+
+    {"add": [...grants...], "remove": [{"principal_type": "user", "principal": "..."}]}
+
+Cannot mix `grants` with `add`/`remove`.
+ */
+export const aclSchema = z.object({
+    add: z.array(aclGrantSchema).optional(), // Patch mode: grants to add or merge into existing
+    grants: z.array(aclGrantSchema).optional(), // Replace mode: full list of grants (replaces all existing). Use [] to clear.
+    remove: z.array(aclRemoveTargetSchema).optional(), // Patch mode: principals to remove from existing
+});
 /** Schema for a message actor (user or agent).
 
 Actors represent the entity that sent a message.
@@ -15,6 +47,38 @@ export const actorSchema = z.object({
     name: z.string().optional(), // Actor display name
     profile_picture: imageSourceSchema.optional(), // Profile picture
 });
+/** API schema for per-routine LLM invocation settings.
+
+Mirrors `ArchAstro.Agents.Routines.LLMConfig`. When `model` is present,
+it overrides the agent's `default_model` for the routine (or step).
+ */
+export const lLMConfigSchema = z.object({
+    model: z.string().optional(), // Model identifier. When set, overrides the agent's default_model.
+});
+/** API schema for preset handler configuration.
+
+Mirrors `ArchAstro.Agents.Routines.PresetConfig`. Used wherever a request
+or response carries a preset config — routine-level and chain-step-level.
+
+Server-side validation (length/format rules on `instructions`, enum checks
+on `session_mode`/`session_scope`, model lookup against
+`ChatCompletion.models/0`) is authoritative. This schema defines the
+request shape and typed response shape so OpenAPI consumers see real
+types instead of an opaque object.
+ */
+export const presetConfigSchema = z.object({
+    instructions: z.string().optional(), // Custom task or behavior instructions for the preset (max 10,000 chars).
+    llm: lLMConfigSchema.optional(), // LLM invocation settings (e.g. a `model` override for this routine/step).
+    session_mode: z.string().optional(), // Session mode: `stateless` (default, new session per trigger) or `session` (find-or-create a persistent session scoped by `session_scope`).
+    session_scope: z.string().optional(), // When `session_mode` is `session`, controls session scoping: `per_user` (default), `per_key`, `per_org`, or `global`.
+    structured_message_template_ids: z.array(z.string()).optional(), // Config IDs of AgentMessageSchema templates that constrain the agent's responses to predefined structured formats.
+});
+/** API schema for background worker status on a routine run. */
+export const workerStatusSchema = z.object({
+    attempt: z.number().int(), // Current attempt number (0 = not yet attempted)
+    max_attempts: z.number().int(), // Maximum allowed attempts
+    status: z.string(), // Worker state: queued, executing, retrying, completed, discarded, or cancelled
+});
 /** API schema for a media variant. */
 export const mediaVariantSchema = z.object({
     content_type: z.string().optional(), // File content type
@@ -55,6 +119,156 @@ export const attachmentSchema = z.object({
     version: z.number().int().optional(), // Artifact version number (artifact type)
     width: z.number().int().optional(), // Media width (media type)
 });
+/** API schema for authentication token responses. */
+export const authTokensSchema = z.object({
+    expires_in: z.number().int(), // Token TTL in seconds
+    metadata: z.record(z.unknown()).optional(), // Additional metadata (e.g., onboarding_job_id)
+    refresh_token: z.string(), // Refresh token
+    token: z.string(), // Access token (JWT)
+    token_type: z.string(), // Token type (Bearer)
+    user: userSchema, // Authenticated user
+});
+/** An individual tool within a builtin tool catalog entry. */
+export const builtinToolSchema = z.object({
+    description: z.string().optional(), // Tool description
+    name: z.string(), // Tool name
+});
+/** A builtin tool catalog entry describing an available tool category. */
+export const builtinToolCatalogEntrySchema = z.object({
+    config_schema: z.record(z.unknown()).optional(), // JSON schema for tool configuration
+    description: z.string().optional(), // Tool description
+    instruction: z.string().optional(), // Tool instruction
+    key: z.string(), // Unique tool key
+    label: z.string().optional(), // Display label
+    providers: z.array(z.string()).optional(), // Supported providers
+    requires_integration: z.boolean().optional(), // Whether an integration is required
+    server_tool_type: z.string().optional(), // Server tool type identifier
+    tools: z.array(builtinToolSchema).optional(), // List of individual tools
+});
+/** Result of executing a command on an agent computer. */
+export const computerExecResultSchema = z.object({
+    exit_code: z.number().int().optional(), // Process exit code
+    output: z.string().optional(), // Command output
+});
+/** API schema for a custom object. */
+export const customObjectSchema = z.object({
+    created_at: z.string().optional(), // Created timestamp
+    fields: z.record(z.unknown()).optional(), // Object field values
+    id: z.string(), // Public ID (cobj_...)
+    org: z.string().optional(), // Organization
+    row_key: z.string().optional(), // Row key
+    sandbox: z.string().optional(), // Sandbox identifier
+    schema_type: z.string().optional(), // Schema type (lookup_key)
+    team: z.string().optional(), // Owning team
+    updated_at: z.string().optional(), // Updated timestamp
+    user: z.string().optional(), // Owning user
+    version: z.number().int().optional(), // Aggregate version for OCC
+});
+/** API schema for OAuth device authorization responses. */
+export const deviceAuthorizationResponseSchema = z.object({
+    device_code: z.string(), // Device verification code
+    expires_in: z.number().int(), // TTL in seconds
+    interval: z.number().int(), // Polling interval in seconds
+    user_code: z.string(), // User-facing verification code
+    verification_uri: z.string(), // Base verification URI
+    verification_uri_complete: z.string(), // Full verification URI with code
+});
+/** API schema for OAuth device authorization approval and denial responses. */
+export const deviceAuthorizationStatusResponseSchema = z.object({
+    status: z.string(), // Authorization status (approved or denied)
+});
+/** API schema for an installation. */
+export const installationSchema = z.object({
+    agent: z.string().optional(), // Owning agent
+    config: z.record(z.unknown()).optional(), // Configuration
+    created_at: z.string().optional(), // Creation timestamp
+    id: z.string(), // Installation ID (cin_...)
+    kind: z.string().optional(), // Installation kind
+    shared_integration: z.string().optional(), // Bound shared integration
+    state: z.string().optional(), // Installation state
+    status_payload: z.record(z.unknown()).optional(), // Status payload
+    updated_at: z.string().optional(), // Last update timestamp
+});
+/** API schema for an installation kind. */
+export const installationKindSchema = z.object({
+    accepts_sources: z.boolean().optional(), // Whether this kind accepts sources
+    category: z.string().optional(), // Category
+    config_schema: z.record(z.unknown()).optional(), // JSON schema for configuration
+    description: z.string().optional(), // Description
+    kind: z.string(), // Installation kind identifier
+    label: z.string().optional(), // Display label
+    provider: z.string().optional(), // Integration provider
+    requires_integration: z.boolean().optional(), // Whether this kind requires an integration
+});
+/** List response for installation kinds. */
+export const installationKindListResponseSchema = z.object({
+    data: z.array(installationKindSchema), // List of installation kinds
+});
+/** List response for installations. */
+export const installationListResponseSchema = z.object({
+    data: z.array(installationSchema), // List of installations
+});
+/** API schema for an installation source. */
+export const installationSourceSchema = z.object({
+    agent: z.string().optional(), // Owning agent
+    context_installation: z.string().optional(), // Installation ID
+    created_at: z.string().optional(), // Creation timestamp
+    id: z.string(), // Source ID (cso_...)
+    metadata: z.record(z.unknown()).optional(), // Arbitrary metadata
+    parent_source: z.string().optional(), // Parent source ID
+    payload: z.record(z.unknown()).optional(), // Source payload
+    state: z.string().optional(), // Source state
+    team: z.string().optional(), // Team ID
+    thread: z.string().optional(), // Thread ID
+    type: z.string().optional(), // Source type
+    updated_at: z.string().optional(), // Last update timestamp
+    user: z.string().optional(), // User ID
+});
+/** List response for installation sources. */
+export const installationSourceListResponseSchema = z.object({
+    data: z.array(installationSourceSchema), // List of installation sources
+});
+/** Schema for a key-value storage entry.
+
+Maps exactly to render_entry/1 output in ApiStorageController.
+ */
+export const keyValueStorageEntrySchema = z.object({
+    created_at: z.string().optional(), // Creation timestamp
+    key: z.string(), // Storage key
+    updated_at: z.string().optional(), // Last update timestamp
+    user: z.string(), // User
+    value: z.string(), // Stored value
+});
+/** Schema for a key-value storage entry, optionally enriched with a summary of
+the owning user.
+
+Used by the dual-mode list endpoint: user-JWT callers omit the user_email /
+user_name fields (they know who they are); developer / S2S callers populate
+them so the portal can render an owner column without a per-row lookup.
+ */
+export const keyValueStorageEntryWithUserSchema = z.object({
+    created_at: z.string(), // Creation timestamp
+    key: z.string(), // Storage key
+    updated_at: z.string(), // Last update timestamp
+    user: z.string(), // User ID
+    user_email: z.string().optional(), // User email (developer / S2S only)
+    user_name: z.string().optional(), // User display name (developer / S2S only)
+    value: z.string(), // Stored value
+});
+/** Response envelope for the dual-mode key-value list endpoint.
+
+User-JWT callers receive `%{data: [...]}` (no pagination fields).
+Developer / S2S callers receive `%{data: [...]}` plus pagination metadata.
+ */
+export const keyValueStorageEntryPageSchema = z.object({
+    data: z.array(keyValueStorageEntryWithUserSchema), // Storage entries on this page
+    has_next: z.boolean().optional(), // Whether a next page exists (developer / S2S only)
+    has_prev: z.boolean().optional(), // Whether a previous page exists (developer / S2S only)
+    page: z.number().int().optional(), // Current page number (developer / S2S only)
+    page_size: z.number().int().optional(), // Results per page (developer / S2S only)
+    total_entries: z.number().int().optional(), // Total entries matching the filters (developer / S2S only)
+    total_pages: z.number().int().optional(), // Total number of pages (developer / S2S only)
+});
 /** Schema for inline message reactions.
 
 This is the compact format used in Message.reactions[], which differs from
@@ -92,76 +306,45 @@ export const messageSchema = z.object({
     thread: z.string().optional(), // Parent thread
     user: z.string().optional(), // Author user (public ID or expanded object when loaded)
 });
-/** API schema for a single ACL grant entry. */
-export const aclGrantSchema = z.object({
-    actions: z.array(z.string()), // List of allowed actions (e.g. read, write)
-    principal: z.string().optional(), // Principal identifier (UUID for user/team/org/agent_user, role name for org_role, omit for everyone)
-    principal_type: z.string(), // Principal type: user, team, org, org_role, agent, or everyone
-});
-/** API schema for identifying a principal to remove from an ACL. */
-export const aclRemoveTargetSchema = z.object({
-    principal: z.string().optional(), // Principal identifier to remove (omit for everyone)
-    principal_type: z.string(), // Principal type to remove
+/** API schema for OAuth token endpoint responses. */
+export const oAuthTokenResponseSchema = z.object({
+    access_token: z.string(), // OAuth access token
+    expires_in: z.number().int(), // Token TTL in seconds
+    refresh_token: z.string().optional(), // OAuth refresh token
+    scope: z.string().optional(), // Granted scopes (space-separated)
+    token_type: z.string(), // Token type (Bearer)
+    user: userSchema.optional(), // Authenticated user
 });
-/** Reusable API schema for access control lists.
-
-Supports two modes (mutually exclusive):
-
-**Replace mode** — send `grants` to replace all entries:
-
-    {"grants": [{"principal_type": "user", "principal": "...", "actions": ["read"]}]}
-
-Use `{"grants": []}` to clear all entries.
-
-**Patch mode** — send `add` and/or `remove`:
-
-    {"add": [...grants...], "remove": [{"principal_type": "user", "principal": "..."}]}
+/** Schema for paginated message replies response.
 
-Cannot mix `grants` with `add`/`remove`.
+Used by message replies list endpoints.
+Note: This response is NOT wrapped in a "data" field.
  */
-export const aclSchema = z.object({
-    add: z.array(aclGrantSchema).optional(), // Patch mode: grants to add or merge into existing
-    grants: z.array(aclGrantSchema).optional(), // Replace mode: full list of grants (replaces all existing). Use [] to clear.
-    remove: z.array(aclRemoveTargetSchema).optional(), // Patch mode: principals to remove from existing
+export const paginatedRepliesSchema = z.object({
+    after_cursor: z.string().optional(), // Cursor for fetching items after this point
+    before_cursor: z.string().optional(), // Cursor for fetching items before this point
+    has_more: z.boolean().optional(), // Whether more replies exist beyond the current page
+    replies: z.array(messageSchema), // List of reply message objects
+    total_count: z.number().int().optional(), // Total number of replies
 });
-/** Schema for a thread in the developer portal.
-
-Maps to serialized thread output from developer portal API.
+/** A routine preset entry in the preset listing endpoint. Describes *what*
+a preset is, not a per-routine configuration — that's `PresetConfig`.
  */
-export const developerThreadSchema = z.object({
-    app_name: z.string().optional(), // Associated app name
-    created_at: z.string().optional(), // Created timestamp
-    id: z.string(), // Public ID (thr_...)
-    is_channel: z.boolean().optional(), // Whether this is a channel thread
-    is_default: z.boolean().optional(), // Whether this is the default thread
-    is_unlisted: z.boolean().optional(), // Whether thread is hidden from listings
-    key: z.string().optional(), // Unique key within owner scope
-    org: z.string().optional(), // Organization (nullable)
-    owner: z.string().optional(), // Owner public
-    owner_name: z.string().optional(), // Owner display name
-    owner_type: z.string().optional(), // Owner type: team, user, agent, or nil
-    sandbox: z.string().optional(), // Sandbox identifier (nullable)
-    slug: z.string().optional(), // URL-friendly slug
-    title: z.string(), // Thread title
-    updated_at: z.string().optional(), // Updated timestamp
+export const routinePresetSchema = z.object({
+    applicable_events: z.array(z.string()), // Event types this preset accepts. `["*"]` means any event. Other event types are rejected at routine validation time.
+    chainable: z.boolean(), // Whether this preset may appear as a step inside a `:chain` routine. Presets with session or async execution models are not chainable.
+    description: z.string(), // Preset description
+    label: z.string(), // Display label
+    name: z.string(), // Preset name (e.g. do_task)
+    sessionable: z.boolean(), // Whether this preset maintains a persistent chatroom session across turns (e.g. `participate`). Sessionable presets don't expose instructions or session-mode fields at the routine level.
+    unique: z.boolean(), // Whether only one routine with this preset may exist per agent. Enforced at the AgentRoutine unique-index layer.
 });
-/** Schema for a context ingestion.
-
-Maps to serialized context ingestion output from developer portal API.
+/** Schema for config validation result.
  */
-export const contextIngestionSchema = z.object({
-    agent: z.string().optional(), // Agent
-    completed_at: z.string().optional(), // Completed timestamp
-    created_at: z.string().optional(), // Created timestamp
-    error: z.record(z.unknown()).optional(), // Error details (if failed)
-    id: z.string(), // Public ID (cig_...)
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    source: z.string().optional(), // Source ID
-    started_at: z.string().optional(), // Started timestamp
-    status: z.string(), // Status (pending, running, awaiting_callback, succeeded, failed)
-    team: z.string().optional(), // Owning team ID
-    updated_at: z.string().optional(), // Updated timestamp
-    user: z.string().optional(), // Owning user ID
+export const validationResultSchema = z.object({
+    errors: z.array(z.string()).optional(), // List of validation errors
+    valid: z.boolean(), // Whether the config is valid
+    warnings: z.array(z.string()).optional(), // Optional warnings emitted during validation
 });
 /** API schema for a working memory entry. */
 export const workingMemoryEntrySchema = z.object({
@@ -173,803 +356,6 @@ export const workingMemoryEntrySchema = z.object({
     updated_at: z.string().optional(), // Last update timestamp
     value: z.string().optional(), // Memory value
 });
-/** Schema for a sandbox-captured email.
- */
-export const sandboxEmailSchema = z.object({
-    bcc: z.array(z.record(z.unknown())).optional(), // BCC recipients
-    cc: z.array(z.record(z.unknown())).optional(), // CC recipients
-    created_at: z.string().optional(), // When the email was captured
-    from_address: z.string(), // Sender email address
-    from_name: z.string().optional(), // Sender display name
-    headers: z.record(z.unknown()).optional(), // Custom email headers
-    html_body: z.string().optional(), // HTML body
-    id: z.string(), // Public ID (sem_...)
-    reply_to: z.record(z.unknown()).optional(), // Reply-to address
-    subject: z.string().optional(), // Email subject
-    text_body: z.string().optional(), // Plain text body
-    to: z.array(z.record(z.unknown())), // Recipients [{name, address}]
-});
-/** Schema for an LLM session call.
-
-Maps to serialized LLM call output from developer portal API.
- */
-export const llmCallSchema = z.object({
-    call_id: z.string(), // Unique call UUID
-    completion_tokens: z.number().int(), // Number of completion tokens
-    created_at: z.string().optional(), // Created timestamp
-    error_message: z.string().optional(), // Error message if call failed
-    id: z.string(), // Public ID (alc_...)
-    latency_ms: z.number().int(), // Latency in milliseconds
-    message_count: z.number().int().optional(), // Number of messages included in the call metadata
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    model: z.string().optional(), // LLM model name
-    prompt_tokens: z.number().int(), // Number of prompt tokens
-    session_id: z.string(), // Session UUID grouping related calls
-    source: z.string().optional(), // Machine-readable call source key
-    status: z.string().optional(), // Call status (success or error)
-    team: z.string().optional(), // Team if team-scoped
-    total_tokens: z.number().int(), // Total tokens (prompt + completion)
-    trajectory: z.string().optional(), // Trajectory identifier
-    user: z.string().optional(), // User if user-scoped
-});
-/** Schema for a registered domain.
-
-Maps to serialized domain output from developer portal API.
- */
-export const domainSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    domain: z.string(), // Domain name
-    id: z.string(), // Public ID (dad_...)
-    updated_at: z.string().optional(), // Updated timestamp
-    verified: z.boolean().optional(), // Whether domain is verified
-});
-/** Schema for a webhook event.
-
-Maps to serialized webhook event output from developer portal API.
- */
-export const webhookEventSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    error: z.string().optional(), // Error message if failed
-    event_type: z.string().optional(), // Event type from the provider
-    headers: z.record(z.unknown()).optional(), // Request headers
-    id: z.string(), // Public ID (whe_...)
-    payload: z.record(z.unknown()).optional(), // Event payload
-    processed_at: z.string().optional(), // When the event was processed
-    status: z.string(), // Processing status (pending, processed, failed)
-});
-/** Schema for an eval result. */
-export const evalResultSchema = z.object({
-    agent_response: z.string().optional(), // Agent response
-    created_at: z.string().optional(), // Created timestamp
-    duration_ms: z.number().int().optional(), // Execution duration
-    grader_details: z.record(z.unknown()).optional(), // Grader details
-    id: z.string(), // Eval result ID
-    run: z.string(), // Parent eval run identifier
-    score: z.number().optional(), // Result score
-    status: z.string(), // Result status
-    task: z.string().optional(), // Eval task identifier
-    task_input: z.string().optional(), // Task input summary
-    transcript: z.record(z.unknown()).optional(), // Execution transcript
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** Schema for an eval run. */
-export const evalRunSchema = z.object({
-    agent: z.string().optional(), // Agent identifier
-    agent_name: z.string().optional(), // Agent name
-    completed_at: z.string().optional(), // Completion timestamp
-    created_at: z.string().optional(), // Created timestamp
-    id: z.string(), // Eval run ID
-    results: z.array(evalResultSchema).optional(), // Eval results for this run
-    started_at: z.string().optional(), // Start timestamp
-    status: z.string(), // Run status
-    suite: z.string(), // Eval suite identifier
-    summary: z.record(z.unknown()).optional(), // Aggregate run summary
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** API schema for a context entry. */
-export const contextEntrySchema = z.object({
-    after_cursor: z.string().optional(), // Pagination cursor (after)
-    agent_user: z.string().optional(), // Agent user
-    before_cursor: z.string().optional(), // Pagination cursor (before)
-    created_at: z.string().optional(), // Creation timestamp
-    files: z.array(z.record(z.unknown())).optional(), // Loaded file objects
-    id: z.string(), // Context entry ID
-    links: z.array(z.record(z.unknown())).optional(), // Loaded link objects
-    media: z.array(z.record(z.unknown())).optional(), // Loaded media objects
-    metadata: z.record(z.unknown()).optional(), // Entry metadata
-    org: z.string().optional(), // Organization
-    sandbox: z.string().optional(), // Sandbox identifier
-    team: z.string().optional(), // Team
-    text: z.string().optional(), // Entry text
-    updated_at: z.string().optional(), // Last update timestamp
-    user: z.string().optional(), // User
-});
-/** Schema for a developer webhook.
-
-Maps to serialized webhook output from developer portal API.
- */
-export const webhookSchema = z.object({
-    context_installation: z.string().optional(), // Bound context installation
-    context_sources: z.array(z.string()).optional(), // Bound context sources
-    created_at: z.string().optional(), // Created timestamp
-    enabled: z.boolean(), // Whether the webhook is enabled
-    id: z.string(), // Public ID (whk_...)
-    lookup_key: z.string().optional(), // Lookup key for generic webhooks
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    provider: z.string().optional(), // Provider type for known providers (github, slack), nil for generic webhooks
-    updated_at: z.string().optional(), // Updated timestamp
-    webhook_url: z.string(), // URL to send webhooks to
-});
-/** API schema for a secret (user, team, or user-team). */
-export const secretSchema = z.object({
-    created_at: z.string().optional(), // Creation timestamp
-    description: z.string().optional(), // Secret description
-    id: z.string(), // Secret ID
-    last_accessed_at: z.string().optional(), // Last accessed timestamp
-    name: z.string().optional(), // Secret name
-    org: z.string().optional(), // Organization
-    sandbox: z.string().optional(), // Sandbox
-    secret_group: z.string().optional(), // Secret group
-    team: z.string().optional(), // Team
-    updated_at: z.string().optional(), // Last update timestamp
-});
-/** API schema for OAuth device authorization responses. */
-export const deviceAuthorizationResponseSchema = z.object({
-    device_code: z.string(), // Device verification code
-    expires_in: z.number().int(), // TTL in seconds
-    interval: z.number().int(), // Polling interval in seconds
-    user_code: z.string(), // User-facing verification code
-    verification_uri: z.string(), // Base verification URI
-    verification_uri_complete: z.string(), // Full verification URI with code
-});
-/** API schema for OAuth token endpoint responses. */
-export const oAuthTokenResponseSchema = z.object({
-    access_token: z.string(), // OAuth access token
-    expires_in: z.number().int(), // Token TTL in seconds
-    refresh_token: z.string().optional(), // OAuth refresh token
-    scope: z.string().optional(), // Granted scopes (space-separated)
-    token_type: z.string(), // Token type (Bearer)
-    user: userSchema.optional(), // Authenticated user
-});
-/** Result of executing a command on an agent computer. */
-export const computerExecResultSchema = z.object({
-    exit_code: z.number().int().optional(), // Process exit code
-    output: z.string().optional(), // Command output
-});
-/** Schema for runtime environment variable metadata. */
-export const runtimeEnvVarSchema = z.object({
-    description: z.string().optional(), // Optional description
-    key: z.string(), // Environment variable key
-    source: z.string(), // Source of the env var (app or org)
-});
-/** Schema for runtime environment variable metadata list responses. */
-export const runtimeEnvVarListSchema = z.object({
-    data: z.array(runtimeEnvVarSchema), // Runtime environment variables available to the current script context
-});
-/** Source option metadata for LLM call filtering.
- */
-export const llmCallSourceOptionSchema = z.object({
-    label: z.string(), // Human-friendly source label
-    source: z.string(), // Machine-readable LLM source key
-});
-/** Schema for an app environment variable response that includes the plaintext value. */
-export const appEnvVarPlaintextSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    description: z.string().optional(), // Optional description
-    id: z.string(), // Environment variable ID
-    key: z.string(), // Environment variable key
-    updated_at: z.string().optional(), // Updated timestamp
-    value: z.string(), // Plaintext environment variable value
-});
-/** Schema for integration records with connector state. */
-export const integrationSchema = z.object({
-    id: z.string(), // Integration ID
-    org: z.string().optional(), // Organization (nullable)
-    provider: z.string(), // Provider identifier
-    sandbox: z.string().optional(), // Sandbox identifier (nullable)
-    secret_group: z.string().optional(), // Secret group
-    state: z.record(z.unknown()), // Connector state information
-    team: z.string().optional(), // Team (if team-scoped)
-    user: z.string().optional(), // User (if user-scoped)
-    workspace_key: z.string().optional(), // Provider workspace identifier
-});
-/** Schema for a single notification setting update entry.
- */
-export const notificationSettingUpdateSchema = z.object({
-    level: z.string(), // Notification level (global, team, thread)
-    muted: z.boolean(), // Whether notifications are muted
-    team: z.string().optional(), // Team (required for team-level settings)
-    thread: z.string().optional(), // Thread (required for thread-level settings)
-});
-/** Schema for a key-value storage entry.
-
-Maps exactly to render_entry/1 output in ApiStorageController.
- */
-export const keyValueStorageEntrySchema = z.object({
-    created_at: z.string().optional(), // Creation timestamp
-    key: z.string(), // Storage key
-    updated_at: z.string().optional(), // Last update timestamp
-    user: z.string(), // User
-    value: z.string(), // Stored value
-});
-/** API schema for an installation kind. */
-export const installationKindSchema = z.object({
-    accepts_sources: z.boolean().optional(), // Whether this kind accepts sources
-    category: z.string().optional(), // Category
-    config_schema: z.record(z.unknown()).optional(), // JSON schema for configuration
-    description: z.string().optional(), // Description
-    kind: z.string(), // Installation kind identifier
-    label: z.string().optional(), // Display label
-    provider: z.string().optional(), // Integration provider
-    requires_integration: z.boolean().optional(), // Whether this kind requires an integration
-});
-/** List response for installation kinds. */
-export const installationKindListResponseSchema = z.object({
-    data: z.array(installationKindSchema), // List of installation kinds
-});
-/** Schema for a billing plan. */
-export const billingPlanSchema = z.object({
-    description: z.string().optional(), // Plan description
-    id: z.string().optional(), // Plan identifier (e.g. paygo)
-    name: z.string().optional(), // Human-readable plan name
-    target: z.string().optional(), // Entity type this plan applies to (developer or org)
-});
-/** Schema for an eval task. */
-export const evalTaskSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    expected_outcome: z.string(), // Expected outcome
-    grading_criteria: z.array(z.record(z.unknown())).optional(), // Grading criteria
-    id: z.string(), // Eval task ID
-    input_message: z.string(), // Task input message
-    mock_agent_memory: z.record(z.unknown()).optional(), // Mock agent memory
-    mock_context_items: z.array(z.record(z.unknown())).optional(), // Mock context items
-    mock_datetime: z.string().optional(), // Mock datetime
-    mock_participants: z.array(z.record(z.unknown())).optional(), // Mock participants
-    mock_tools: z.array(z.record(z.unknown())).optional(), // Mock tool definitions
-    status: z.string(), // Task status
-    suite: z.string(), // Parent eval suite identifier
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** API schema for a task comment. */
-export const taskCommentSchema = z.object({
-    author: z.string().optional(), // Legacy author
-    author_actor: z.record(z.unknown()).optional(), // Author actor details
-    author_persona: z.string().optional(), // Author persona
-    author_user: z.string().optional(), // Author user
-    body: z.string(), // Comment body text
-    created_at: z.string().optional(), // Creation timestamp
-    id: z.string(), // Comment ID
-    org: z.string().optional(), // Organization
-    sandbox: z.string().optional(), // Sandbox identifier
-    task: z.string().optional(), // Task
-    team: z.string().optional(), // Team
-    updated_at: z.string().optional(), // Last update timestamp
-});
-/** Schema for eval result list responses. */
-export const evalResultListSchema = z.object({
-    data: z.array(evalResultSchema), // Eval results
-});
-/** Schema for delete operations that return a deleted count. */
-export const deletionConfirmationSchema = z.object({
-    deleted_count: z.number().int(), // Number of deleted records
-});
-/** An individual tool within a builtin tool catalog entry. */
-export const builtinToolSchema = z.object({
-    description: z.string().optional(), // Tool description
-    name: z.string(), // Tool name
-});
-/** Schema for an eval suite. */
-export const evalSuiteSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    description: z.string().optional(), // Suite description
-    id: z.string(), // Eval suite ID
-    name: z.string(), // Suite name
-    org: z.string().optional(), // Owner organization identifier
-    status: z.string(), // Suite status
-    tasks: z.array(evalTaskSchema).optional(), // Eval tasks included in the suite
-    updated_at: z.string().optional(), // Updated timestamp
-    user: z.string().optional(), // Owner user identifier
-});
-/** Schema for eval suite list responses. */
-export const evalSuiteListSchema = z.object({
-    data: z.array(evalSuiteSchema), // Eval suites
-});
-/** Schema for a sandbox API key.
- */
-export const sandboxKeySchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    expires_at: z.string().optional(), // Expiry timestamp
-    full_key: z.string().optional(), // Full key shown only once at creation
-    id: z.string(), // Public ID (dsk_...)
-    key_hint: z.string().optional(), // Last 4 chars hint
-    key_value: z.string().optional(), // Full key (publishable only)
-    last_used_at: z.string().optional(), // Last used timestamp
-    status: z.string(), // Status (active, revoked)
-    type: z.string(), // Key type (publishable, secret)
-});
-/** Schema for a developer sandbox.
- */
-export const sandboxSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    id: z.string(), // Public ID (dsb_...)
-    keys: z.array(sandboxKeySchema).optional(), // Sandbox API keys
-    name: z.string(), // Sandbox name
-    slug: z.string(), // Sandbox slug (unique per app)
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** API schema for an AI trajectory. */
-export const trajectorySchema = z.object({
-    created_at: z.string().optional(), // Creation timestamp
-    file: z.string().optional(), // Storage file
-    id: z.string(), // Trajectory ID (trj_...)
-    messages: z.record(z.unknown()).optional(), // Trajectory messages
-    org: z.string().optional(), // Organization
-    sandbox: z.string().optional(), // Sandbox
-    team: z.string().optional(), // Team
-    updated_at: z.string().optional(), // Last update timestamp
-});
-/** Schema for an event type available for automation triggers.
-
-Represents events from the workflow event catalog.
- */
-export const eventTypeSchema = z.object({
-    description: z.string(), // Human-readable description
-    name: z.string(), // Event name (e.g., thread.created)
-});
-/** Schema for paginated message replies response.
-
-Used by message replies list endpoints.
-Note: This response is NOT wrapped in a "data" field.
- */
-export const paginatedRepliesSchema = z.object({
-    after_cursor: z.string().optional(), // Cursor for fetching items after this point
-    before_cursor: z.string().optional(), // Cursor for fetching items before this point
-    has_more: z.boolean().optional(), // Whether more replies exist beyond the current page
-    replies: z.array(messageSchema), // List of reply message objects
-    total_count: z.number().int().optional(), // Total number of replies
-});
-/** A routine preset with its metadata. */
-export const routinePresetSchema = z.object({
-    config: z.record(z.unknown()).optional(), // Default configuration
-    description: z.string().optional(), // Preset description
-    event_type: z.string().optional(), // Event type
-    label: z.string().optional(), // Display label
-    name: z.string(), // Preset name
-});
-/** API schema for a persona. */
-export const personaSchema = z.object({
-    activated: z.boolean().optional(), // Whether persona is activated
-    agent: z.string().optional(), // Associated agent (always nil)
-    created_at: z.string().optional(), // Creation timestamp
-    id: z.string(), // Persona ID
-    is_active: z.boolean().optional(), // Whether persona is active
-    is_enabled_for_thread: z.boolean().optional(), // Whether persona is enabled for thread
-    metadata: z.record(z.unknown()).optional(), // Persona metadata
-    name: z.string().optional(), // Persona display name
-    org: z.string().optional(), // Organization
-    personality: z.string().optional(), // Persona personality description
-    sandbox: z.string().optional(), // Sandbox
-    team: z.string().optional(), // Owning team
-    updated_at: z.string().optional(), // Last update timestamp
-    user: z.string().optional(), // Owning user
-});
-/** API schema for an installation. */
-export const installationSchema = z.object({
-    agent: z.string().optional(), // Owning agent
-    config: z.record(z.unknown()).optional(), // Configuration
-    created_at: z.string().optional(), // Creation timestamp
-    id: z.string(), // Installation ID (cin_...)
-    kind: z.string().optional(), // Installation kind
-    shared_integration: z.string().optional(), // Bound shared integration
-    state: z.string().optional(), // Installation state
-    status_payload: z.record(z.unknown()).optional(), // Status payload
-    updated_at: z.string().optional(), // Last update timestamp
-});
-/** Schema for persona update parameters.
- */
-export const personaUpdateParamsSchema = z.object({
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    name: z.string().optional(), // Persona display name
-    personality: z.string().optional(), // Persona personality description
-});
-/** Schema for a dataset dimension field.
- */
-export const datasetDimensionSchema = z.object({
-    label: z.string(), // Human-readable label
-    name: z.string(), // Dimension identifier
-    type: z.string(), // Data type (string, integer, boolean, datetime, date)
-});
-/** Schema for an app environment variable response with a masked value. */
-export const appEnvVarMaskedSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    description: z.string().optional(), // Optional description
-    id: z.string(), // Environment variable ID
-    key: z.string(), // Environment variable key
-    masked_value: z.string(), // Masked environment variable value
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** Schema for masked app environment variable list responses. */
-export const appEnvVarMaskedListSchema = z.object({
-    data: z.array(appEnvVarMaskedSchema), // Environment variables
-});
-/** Schema for eval run list responses. */
-export const evalRunListSchema = z.object({
-    data: z.array(evalRunSchema), // Eval runs
-});
-/** Schema for LLM call trajectory contents. */
-export const llmCallTrajectorySchema = z.object({
-    download_url: z.string().optional(), // Signed transcript download URL
-    messages: z.array(z.record(z.unknown())), // Trajectory messages
-});
-/** API schema for a user credential. */
-export const credentialSchema = z.object({
-    alt_domains: z.record(z.unknown()).optional(), // Alternative domains
-    created_at: z.string().optional(), // Creation timestamp
-    description: z.string().optional(), // Description
-    domain: z.string().optional(), // Primary domain
-    id: z.string(), // Credential ID (ucr_...)
-    last_accessed_at: z.string().optional(), // Last accessed timestamp
-    org: z.string().optional(), // Organization
-    sandbox: z.string().optional(), // Sandbox
-    secret_group: z.string().optional(), // Secret group ID
-    updated_at: z.string().optional(), // Last update timestamp
-});
-/** API schema for an activity feed entry. */
-export const activityFeedEntrySchema = z.object({
-    agent: z.union([z.string(), z.object({ acl: z.object({ add: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), grants: z.array(z.object({ actions: z.array(z.string()), principal: z.string().optional(), principal_type: z.string() })).optional(), remove: z.array(z.object({ principal: z.string().optional(), principal_type: z.string() })).optional() }).optional(), app: z.string().optional(), created_at: z.string().optional(), default_model: z.string().optional(), email: z.string().optional(), id: z.string(), identity: z.string().optional(), lookup_key: z.string().optional(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), phone_number: z.string().optional(), sandbox: z.string().optional(), team: z.string().optional(), updated_at: z.string().optional(), user: z.string().optional() })]).optional(), // Agent (public ID or expanded object when loaded)
-    app: z.string().optional(), // Application
-    attachments: z.array(z.record(z.unknown())).optional(), // Entry attachments
-    automation_run: z.string().optional(), // Automation run
-    content: z.string().optional(), // Longer explanation (markdown)
-    correlation_id: z.string().optional(), // Correlation ID for grouped entries
-    created_at: z.string().optional(), // Creation timestamp
-    id: z.string(), // Entry ID (afe_...)
-    kind: z.string().optional(), // Entry kind
-    level: z.string().optional(), // Severity level
-    metadata: z.record(z.unknown()).optional(), // Entry metadata
-    org: z.string().optional(), // Organization
-    routine_run: z.string().optional(), // Routine run
-    sandbox: z.string().optional(), // Sandbox identifier
-    session_record: z.string().optional(), // Agent session
-    team: z.string().optional(), // Team
-    thread: z.string().optional(), // Thread
-    title: z.string().optional(), // One-line summary
-    updated_at: z.string().optional(), // Last update timestamp
-    user: z.union([z.string(), z.object({ alias: z.string().optional(), email: z.string().optional(), id: z.string(), metadata: z.record(z.unknown()).optional(), name: z.string().optional(), org: z.string().optional(), sandbox: z.string().optional() })]).optional(), // User (public ID or expanded object when loaded)
-});
-/** Schema for a dataset metric field.
- */
-export const datasetMetricSchema = z.object({
-    aggregation: z.string(), // Aggregation function (sum, count, avg, min, max, count_distinct)
-    label: z.string(), // Human-readable label
-    name: z.string(), // Metric identifier
-    type: z.string(), // Output type (integer, float)
-});
-/** Schema for an analytics dataset definition.
- */
-export const datasetSchema = z.object({
-    dimensions: z.array(datasetDimensionSchema), // Available dimensions
-    metrics: z.array(datasetMetricSchema), // Available metrics
-    name: z.string(), // Dataset identifier
-    time_dimension: datasetDimensionSchema.optional(), // Time dimension for time series queries
-});
-/** Schema for paginated messages response.
-
-Used by thread messages list endpoints.
- */
-export const paginatedMessagesSchema = z.object({
-    after_cursor: z.string().optional(), // Cursor for fetching items after this point
-    before_cursor: z.string().optional(), // Cursor for fetching items before this point
-    messages: z.array(messageSchema), // List of message objects
-});
-/** Schema for an event catalog entry with full payload schema and sample.
- */
-export const eventCatalogEntrySchema = z.object({
-    description: z.string(), // Human-readable description
-    name: z.string(), // Event name (e.g., thread.created)
-    parent: z.string().optional(), // Parent envelope name (only present for sub_event entries)
-    sample: z.record(z.unknown()), // Sample payload for this event
-    schema: z.record(z.unknown()), // JSON Schema describing the event payload
-    sub_events: z.array(z.string()).optional(), // Known sub-event types (only present for envelope entries)
-    type: z.string().optional(), // Entry type: "event" for exact events, "envelope" for wildcard families
-});
-/** Schema for a developer portal domain event. */
-export const domainEventSchema = z.object({
-    agent: z.string().optional(), // Agent identifier
-    created_at: z.string().optional(), // Created timestamp
-    event_name: z.string(), // Event name
-    id: z.string(), // Domain event ID
-    idempotency_key: z.string().optional(), // Idempotency key for the event
-    payload: z.record(z.unknown()), // Event payload
-    team: z.string().optional(), // Team identifier
-    user: z.string().optional(), // User identifier
-});
-/** Filter object for matching thread metadata. */
-export const metadataFilterSchema = z.object({
-    key: z.string(), // Metadata key to match
-    type: z.string(), // Filter type (must be "metadata")
-    value: z.string(), // Metadata value to match
-});
-/** List response for installations. */
-export const installationListResponseSchema = z.object({
-    data: z.array(installationSchema), // List of installations
-});
-/** Public org schema for authenticated endpoints.
-
-Only exposes fields safe for any authenticated user: id, name, domain,
-and logo. Does NOT expose sandbox, status, industry, description, or
-other internal fields that the Developer.Org schema includes.
- */
-export const publicOrgSchema = z.object({
-    domain: z.string(), // Primary domain
-    id: z.string(), // Public ID (org_...)
-    name: z.string(), // Organization name
-});
-/** API schema for background worker status on a routine run. */
-export const workerStatusSchema = z.object({
-    attempt: z.number().int(), // Current attempt number (0 = not yet attempted)
-    max_attempts: z.number().int(), // Maximum allowed attempts
-    status: z.string(), // Worker state: queued, executing, retrying, completed, discarded, or cancelled
-});
-/** API schema for authentication token responses. */
-export const authTokensSchema = z.object({
-    expires_in: z.number().int(), // Token TTL in seconds
-    metadata: z.record(z.unknown()).optional(), // Additional metadata (e.g., onboarding_job_id)
-    refresh_token: z.string(), // Refresh token
-    token: z.string(), // Access token (JWT)
-    token_type: z.string(), // Token type (Bearer)
-    user: userSchema, // Authenticated user
-});
-/** Filter object for matching personas by template ID. */
-export const templateFilterSchema = z.object({
-    id: z.string(), // Persona template ID to match
-    type: z.string(), // Filter type (must be "template")
-});
-/** API schema for a decrypted secret value response. */
-export const secretValueSchema = z.object({
-    name: z.string(), // Secret name
-    value: z.string(), // Decrypted secret value
-});
-/** A builtin tool catalog entry describing an available tool category. */
-export const builtinToolCatalogEntrySchema = z.object({
-    config_schema: z.record(z.unknown()).optional(), // JSON schema for tool configuration
-    description: z.string().optional(), // Tool description
-    instruction: z.string().optional(), // Tool instruction
-    key: z.string(), // Unique tool key
-    label: z.string().optional(), // Display label
-    providers: z.array(z.string()).optional(), // Supported providers
-    requires_integration: z.boolean().optional(), // Whether an integration is required
-    server_tool_type: z.string().optional(), // Server tool type identifier
-    tools: z.array(builtinToolSchema).optional(), // List of individual tools
-});
-/** Schema for developer account billing settings. */
-export const developerSchema = z.object({
-    billing_provider_environment: z.string().optional(), // Stripe environment (live or test)
-    billing_provider_id: z.string().optional(), // Stripe customer ID
-    plan: z.string().optional(), // Billing plan (e.g. paygo)
-});
-/** Schema for a task activity entry.
-
-Maps exactly to the activity entries produced by TaskActivitySentenceGenerator.
- */
-export const taskActivityEntrySchema = z.object({
-    event_id: z.string().optional(), // Event ID
-    event_type: z.string().optional(), // Type of event
-    sentence: z.string().optional(), // Human-readable description of the activity
-    timestamp: z.string().optional(), // When the event occurred
-});
-/** API schema for file URL refresh responses. */
-export const fileRefreshResultSchema = z.object({
-    image_source: imageSourceSchema, // Updated image source with fresh URL
-    success: z.boolean(), // Whether the refresh succeeded
-});
-/** Schema for a dataset query result.
- */
-export const datasetQueryResultSchema = z.object({
-    columns: z.array(z.record(z.unknown())), // Column definitions with name, type, and label
-    meta: z.record(z.unknown()), // Query metadata (total_rows, query_time_ms)
-    rows: z.array(z.record(z.unknown())), // Result rows as maps of column_name → value
-});
-/** Schema for an API call record.
-
-Maps to serialized API call output from developer portal API.
- */
-export const apiCallSchema = z.object({
-    api_key_type: z.string().optional(), // API key type (publishable or secret)
-    created_at: z.string().optional(), // Created timestamp
-    error_message: z.string().optional(), // Error message if request failed
-    event_type: z.string().optional(), // Webhook event type (e.g. push, pull_request)
-    full_url: z.string(), // Full request URL with query string
-    handler_module: z.string().optional(), // ApiDsl action module
-    id: z.string(), // Public ID (aac_...)
-    ip_address: z.string().optional(), // Client IP address
-    latency_ms: z.number().int(), // Latency in milliseconds
-    metadata: z.record(z.unknown()).optional(), // Additional metadata (e.g. integration_ids for webhooks)
-    method: z.string(), // HTTP method
-    org: z.string().optional(), // Org if org-scoped
-    path: z.string(), // Sanitized path with param placeholders
-    query_string: z.string().optional(), // Query string
-    request_body: z.record(z.unknown()).optional(), // Request body payload (webhooks only)
-    request_headers: z.record(z.unknown()).optional(), // Request headers (webhooks only)
-    request_id: z.string().optional(), // Request ID from Plug.RequestId
-    status_code: z.number().int(), // HTTP status code
-    team: z.string().optional(), // Team if team-scoped
-    thread: z.string().optional(), // Thread if thread-scoped
-    user: z.string().optional(), // User if user-scoped
-});
-/** Schema for paginated domain event responses. */
-export const domainEventPageSchema = z.object({
-    data: z.array(domainEventSchema), // Domain events
-    has_next: z.boolean(), // Whether a next page exists
-    has_prev: z.boolean(), // Whether a previous page exists
-    page: z.number().int(), // Current page number
-    page_size: z.number().int(), // Page size
-    total_entries: z.number().int(), // Total entries
-    total_pages: z.number().int(), // Total pages
-});
-/** Schema for a documented API endpoint in the developer API explorer. */
-export const apiExplorerEndpointSchema = z.object({
-    deprecated: z.boolean(), // Whether the route is deprecated
-    description: z.string().optional(), // Endpoint description
-    errors: z.array(z.record(z.unknown())), // Documented error responses
-    method: z.string(), // HTTP method
-    params: z.array(z.record(z.unknown())), // Documented params
-    path: z.string(), // Route path
-    returns: z.record(z.unknown()).optional(), // Return schema description
-    scope: z.string(), // Endpoint scope
-    tags: z.array(z.string()), // Route tags
-});
-export const resolvedToolSchema = z.object({
-    description: z.string().optional(), // What this tool does
-    name: z.string(), // Callable tool function name
-    parameters: z.record(z.unknown()).optional(), // JSON Schema describing the expected input
-});
-/** Schema for an encrypted secret payload. */
-export const encryptedSecretSchema = z.object({
-    encrypted_value: z.string(), // Encrypted ciphertext value
-});
-/** API schema for a custom object. */
-export const customObjectSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    fields: z.record(z.unknown()).optional(), // Object field values
-    id: z.string(), // Public ID (cobj_...)
-    org: z.string().optional(), // Organization
-    row_key: z.string().optional(), // Row key
-    sandbox: z.string().optional(), // Sandbox identifier
-    schema_type: z.string().optional(), // Schema type (lookup_key)
-    team: z.string().optional(), // Owning team
-    updated_at: z.string().optional(), // Updated timestamp
-    user: z.string().optional(), // Owning user
-    version: z.number().int().optional(), // Aggregate version for OCC
-});
-/** Schema for task creation parameters.
-
-Used by both Users.Tasks.Create and Teams.Tasks.Create actions.
- */
-export const taskCreateParamsSchema = z.object({
-    description: z.string().optional(), // Task description
-    due_date: z.string().optional(), // Due date
-    links: z.record(z.unknown()).optional(), // Related links
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    name: z.string(), // Task name
-    owner_persona: z.string().optional(), // Owner persona if assigned to agent
-    owner_user: z.string().optional(), // Owner user if assigned to user
-    priority: z.number().int().optional(), // Priority level (0-4)
-    status: z.string().optional(), // Task status (open, in_progress, done)
-    task: z.string().optional(), // Custom task ID (optional, auto-generated if not provided)
-});
-/** Schema for message update request parameters.
-
-Used as the body wrapper when updating a message.
- */
-export const messageUpdateParamsSchema = z.object({
-    content: z.string().optional(), // New message content
-});
-/** API schema for an installation source. */
-export const installationSourceSchema = z.object({
-    agent: z.string().optional(), // Owning agent
-    context_installation: z.string().optional(), // Installation ID
-    created_at: z.string().optional(), // Creation timestamp
-    id: z.string(), // Source ID (cso_...)
-    metadata: z.record(z.unknown()).optional(), // Arbitrary metadata
-    parent_source: z.string().optional(), // Parent source ID
-    payload: z.record(z.unknown()).optional(), // Source payload
-    state: z.string().optional(), // Source state
-    team: z.string().optional(), // Team ID
-    thread: z.string().optional(), // Thread ID
-    type: z.string().optional(), // Source type
-    updated_at: z.string().optional(), // Last update timestamp
-    user: z.string().optional(), // User ID
-});
-/** Schema for persona creation parameters.
- */
-export const personaCreateParamsSchema = z.object({
-    name: z.string(), // Persona display name
-    personality: z.string(), // Persona personality description
-    profile_picture_style: z.string().optional(), // Profile picture generation style
-});
-/** API schema for a task. */
-export const taskSchema = z.object({
-    closed_at: z.string().optional(), // When the task was closed
-    comments_count: z.number().int().optional(), // Number of comments
-    created_at: z.string().optional(), // Creation timestamp
-    created_by: z.string().optional(), // Legacy creator
-    created_by_actor: z.record(z.unknown()).optional(), // Creator actor details
-    created_by_persona: z.string().optional(), // Creator persona
-    created_by_type: z.string().optional(), // Creator type (user, agent)
-    created_by_user: z.string().optional(), // Creator user
-    description: z.string().optional(), // Task description
-    due_date: z.string().optional(), // Due date
-    id: z.string(), // Task ID (tsk_...)
-    links: z.record(z.unknown()).optional(), // Related links
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    name: z.string(), // Task name
-    org: z.string().optional(), // Organization
-    owner: z.string().optional(), // Legacy owner
-    owner_actor: z.record(z.unknown()).optional(), // Owner actor details
-    owner_persona: z.string().optional(), // Owner persona
-    owner_user: z.string().optional(), // Owner user
-    priority: z.number().int().optional(), // Priority level (0-4)
-    sandbox: z.string().optional(), // Sandbox identifier
-    status: z.string(), // Task status
-    team: z.string().optional(), // Team
-    updated_at: z.string().optional(), // Last update timestamp
-});
-/** Schema for a developer app.
-
-Maps to serialized app output from developer portal API.
- */
-export const appSchema = z.object({
-    app_slug: z.string().optional(), // Workspace slug (if set)
-    app_url: z.string().optional(), // App URL
-    brand_name: z.string().optional(), // Brand name for emails
-    created_at: z.string().optional(), // Created timestamp
-    description: z.string().optional(), // App description
-    from_name: z.string().optional(), // From name for emails
-    id: z.string(), // Public ID (dap_...)
-    marketing_url: z.string().optional(), // Marketing URL
-    muted_color: z.string().optional(), // Muted hex color
-    name: z.string(), // App name
-    primary_color: z.string().optional(), // Primary hex color
-    sandboxes: z.array(sandboxSchema).optional(), // App sandboxes with keys
-    status: z.string(), // Status (active, suspended)
-    support_email: z.string().optional(), // Support email address
-    third_party_oauth_enabled: z.boolean().optional(), // Third-party OAuth enabled
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** Schema for a system access token (developer admin view).
-
-Maps to serialized system access token output from developer portal API.
- */
-export const developerSystemAccessTokenSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    id: z.string(), // Public ID (sat_...)
-    last_used_at: z.string().optional(), // Last used timestamp
-    name: z.string().optional(), // Optional label for the token
-    revoked_at: z.string().optional(), // Revoked timestamp
-    token: z.string().optional(), // Raw JWT (only present on creation)
-});
-/** Schema for a context source.
-
-Maps to serialized context source output from developer portal API.
- */
-export const contextSourceSchema = z.object({
-    agent: z.string().optional(), // Owning agent
-    context_installation: z.string().optional(), // Associated installation
-    created_at: z.string().optional(), // Created timestamp
-    id: z.string(), // Public ID (cso_...)
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    org: z.string().optional(), // Owning organization
-    parent_source: z.string().optional(), // Parent source
-    payload: z.record(z.unknown()).optional(), // Type-specific configuration
-    sandbox: z.string().optional(), // Owning sandbox
-    state: z.string(), // State: active or paused
-    team: z.string().optional(), // Owning team
-    thread: z.string().optional(), // Associated thread
-    type: z.string(), // Source type (e.g., gmail, github_activity)
-    updated_at: z.string().optional(), // Updated timestamp
-    user: z.string().optional(), // Owning user
-});
 /** Paginated list response for working memory entries. */
 export const workingMemoryEntryListResponseSchema = z.object({
     data: z.array(workingMemoryEntrySchema), // List of working memory entries
@@ -980,345 +366,4 @@ export const workingMemoryEntryListResponseSchema = z.object({
     total_entries: z.number().int().optional(), // Total number of entries
     total_pages: z.number().int().optional(), // Total number of pages
 });
-/** API schema for OAuth device authorization approval and denial responses. */
-export const deviceAuthorizationStatusResponseSchema = z.object({
-    status: z.string(), // Authorization status (approved or denied)
-});
-/** Integration fields for auto-creating the underlying integration.
-
-When creating an agent installation for an `integration/*` kind, callers
-can pass this object to auto-create the underlying Integration record.
-Required fields depend on the kind's auth type:
-
-- `app_installation` kinds (slack_bot, github_app): requires `installation_id`
-- `oauth` kinds (gmail, outlook, slack): requires `access_token`
- */
-export const integrationCreateParamsSchema = z.object({
-    access_token: z.string().optional(), // OAuth access token or API key
-    installation_id: z.string().optional(), // External installation ID (e.g. GitHub App installation ID, Slack team_id)
-    metadata: z.record(z.unknown()).optional(), // Provider-specific metadata (e.g. bot_user_id)
-    refresh_token: z.string().optional(), // OAuth refresh token
-    workspace_key: z.string().optional(), // Workspace name or identifier
-});
-/** Schema for a user credential.
-
-Maps to serialized credential output from developer portal API.
- */
-export const contextCredentialSchema = z.object({
-    alt_domains: z.array(z.string()).optional(), // Alternative domains
-    created_at: z.string().optional(), // Created timestamp
-    description: z.string().optional(), // Human-readable description
-    domain: z.string(), // Domain (e.g., app.schoology.com)
-    id: z.string(), // Public ID (ucr_...)
-    last_accessed_at: z.string().optional(), // Last accessed timestamp
-    updated_at: z.string().optional(), // Updated timestamp
-    user: z.string().optional(), // Owning user
-});
-/** API schema for the status/ping health check response. */
-export const statusPingSchema = z.object({
-    success: z.boolean(), // Whether the ping succeeded
-    token: z.record(z.unknown()), // Token status details
-    user: userSchema.optional(), // Authenticated user (if token is valid)
-});
-/** Schema for an OAuth provider configuration.
-
-Maps to serialized OAuth provider output from developer portal API.
- */
-export const oAuthProviderSchema = z.object({
-    callback_urls: z.array(z.string()).optional(), // Allowed callback URLs
-    client_id: z.string(), // OAuth client ID
-    created_at: z.string().optional(), // Created timestamp
-    display_name: z.string().optional(), // Display name
-    enabled: z.boolean().optional(), // Whether provider is enabled
-    id: z.string(), // Public ID (dop_...)
-    provider: z.string(), // Provider type (github, google)
-    scopes: z.array(z.string()).optional(), // OAuth scopes
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** Schema for config validation result.
- */
-export const validationResultSchema = z.object({
-    errors: z.array(z.string()).optional(), // List of validation errors
-    valid: z.boolean(), // Whether the config is valid
-    warnings: z.array(z.string()).optional(), // Optional warnings emitted during validation
-});
-/** OAuth error response per RFC 6749 */
-export const oAuthErrorSchema = z.object({
-    error: z.string(), // Error code (e.g. slow_down, invalid_grant)
-    error_description: z.string().optional(), // Human-readable error description
-});
-/** Schema for the current developer account. */
-export const accountSchema = z.object({
-    alias: z.string().optional(), // Developer alias
-    created_at: z.string(), // Account creation date
-    email: z.string(), // Email address
-    email_verified: z.boolean(), // Whether email is verified
-    full_name: z.string().optional(), // Full name
-    id: z.string(), // Account ID
-    system_role: z.string(), // System role
-    timezone: z.string().optional(), // IANA timezone
-});
-/** Schema for eval task list responses. */
-export const evalTaskListSchema = z.object({
-    data: z.array(evalTaskSchema), // Eval tasks
-});
-/** API schema for a knowledge search result item. */
-export const knowledgeSearchResultSchema = z.object({
-    content: z.string().optional(), // Normalized content text
-    content_type: z.string().optional(), // Content MIME type
-    created_at: z.string().optional(), // Creation timestamp
-    id: z.string(), // Item ID (cim_...)
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    raw_content: z.record(z.unknown()).optional(), // Raw content data
-    type: z.string().optional(), // Source type (requires preloaded :source association)
-});
-/** Schema for org billing settings. */
-export const billingSettingsOrgSchema = z.object({
-    billing_provider_environment: z.string().optional(), // Stripe environment (live or test)
-    billing_provider_id: z.string().optional(), // Stripe customer ID
-    plan: z.string().optional(), // Billing plan (e.g. enterprise-pilot)
-    primary_user: z.string().optional(), // Org admin user who is the billing contact (public ID)
-});
-/** API schema for a media item. */
-export const mediaSchema = z.object({
-    content_type: z.string().optional(), // Original variant content type
-    created_at: z.string().optional(), // Creation timestamp
-    filename: z.string().optional(), // Original variant filename
-    height: z.number().int().optional(), // Original variant height
-    id: z.string(), // Media ID
-    media_type: z.string().optional(), // Media type
-    name: z.string().optional(), // Media name
-    org: z.string().optional(), // Organization
-    sandbox: z.string().optional(), // Sandbox
-    updated_at: z.string().optional(), // Last update timestamp
-    url: z.string().optional(), // Original variant URL
-    variants: z.array(mediaVariantSchema).optional(), // Media variants
-    width: z.number().int().optional(), // Original variant width
-});
-/** Schema for an integration provider entry.
-
-Represents an available integration provider (OAuth or MCP) that can be
-used with `create integration --provider <provider>`.
- */
-export const integrationProviderSchema = z.object({
-    auth_type: z.string(), // Auth mechanism: oauth, bearer, or app_installation
-    description: z.string().optional(), // Short description of the provider
-    display_name: z.string(), // Human-readable display name
-    provider: z.string(), // Provider key (e.g., google, mcp:system:mcp-github)
-    type: z.string(), // Provider type: oauth, mcp, or app_installation
-});
-/** Schema for an organization.
-
-Maps to serialized org output from developer portal API.
- */
-export const developerOrgSchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    description: z.string().optional(), // Organization description
-    domain: z.string(), // Primary domain
-    id: z.string(), // Public ID (org_...)
-    industry: z.string().optional(), // Industry category
-    name: z.string(), // Organization name
-    sandbox: z.string().optional(), // Sandbox identifier (nullable)
-    slug: z.string(), // URL-safe slug
-    status: z.string().optional(), // Status (active, suspended, trialing)
-    updated_at: z.string().optional(), // Updated timestamp
-    website: z.string().optional(), // Website URL
-});
-/** API schema for a credential with decrypted secret values. */
-export const credentialWithSecretsSchema = z.object({
-    credential: z.record(z.unknown()), // The credential with decrypted values
-});
-/** API schema for a storage file. */
-export const storageFileSchema = z.object({
-    content_type: z.string().optional(), // MIME content type
-    created_at: z.string().optional(), // Creation timestamp
-    filename: z.string().optional(), // Original filename
-    id: z.string(), // File ID
-    image_source: imageSourceSchema.optional(), // Image source metadata
-    org: z.string().optional(), // Organization
-    sandbox: z.string().optional(), // Sandbox
-    size: z.number().int().optional(), // File size in bytes
-    updated_at: z.string().optional(), // Last update timestamp
-    url: z.string().optional(), // Signed download URL
-});
-/** Schema for picture upload parameters.
-
-Used for uploading profile pictures via base64 encoded data.
- */
-export const pictureParamsSchema = z.object({
-    data: z.string(), // Base64 encoded image data
-    filename: z.string(), // Original filename
-    mime_type: z.string(), // MIME type of the image
-});
-/** Schema for the API explorer response. */
-export const apiExplorerIndexSchema = z.object({
-    data: z.array(apiExplorerEndpointSchema), // Documented API endpoints
-    schemas: z.record(z.unknown()).optional(), // Collected schema definitions
-});
-/** Schema for an app slug mapping. */
-export const appSlugSchema = z.object({
-    app: z.string(), // App identifier
-    created_at: z.string().optional(), // Created timestamp
-    creator: z.string().optional(), // Creator identifier
-    id: z.string(), // Slug record ID
-    slug: z.string(), // Globally unique slug
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** Schema for a context item.
-
-Maps to serialized context item output from developer portal API.
- */
-export const contextItemSchema = z.object({
-    agent: z.string().optional(), // Agent
-    content_type: z.string().optional(), // Content type
-    created_at: z.string().optional(), // Created timestamp
-    id: z.string(), // Public ID (cim_...)
-    item_group: z.string().optional(), // Item group if part of a group
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    normalized_content: z.string().optional(), // Normalized content text
-    raw_content: z.record(z.unknown()).optional(), // Raw content data
-    source: z.string().optional(), // Source
-    team: z.string().optional(), // Owning team
-    updated_at: z.string().optional(), // Updated timestamp
-    user: z.string().optional(), // Owning user
-});
-/** API schema for push notification test results. */
-export const pushNotificationResultSchema = z.object({
-    results: z.array(z.record(z.unknown())).optional(), // Per-device results
-    success: z.boolean(), // Whether the notification was sent
-    total_sent: z.number().int().optional(), // Number of notifications sent
-});
-/** Schema for an OAuth client registration. */
-export const oAuthClientSchema = z.object({
-    client_id: z.string(), // Public OAuth client ID
-    client_name: z.string(), // Display name for the client
-    client_secret: z.string().optional(), // Client secret shown only at creation
-    created_at: z.string().optional(), // Created timestamp
-    enabled: z.boolean(), // Whether the client is enabled
-    id: z.string(), // OAuth client registration ID
-    redirect_uris: z.array(z.string()), // Allowed redirect URIs
-    scopes: z.array(z.string()), // Allowed OAuth scopes
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** Schema for integration action metadata. */
-export const integrationActionSchema = z.object({
-    description: z.string().optional(), // Action description
-    json_schema: z.record(z.unknown()), // JSON Schema for action parameters
-    key: z.string(), // Action key (e.g., gmail.list_messages)
-    scopes_any_of: z.record(z.unknown()).optional(), // Required scope sets for this action
-});
-/** Schema for app billing settings. */
-export const billingSettingsAppSchema = z.object({
-    billing_account: z.string().optional(), // Developer account that owns billing (public ID)
-    org_billing_enabled: z.boolean().optional(), // Whether orgs get their own Stripe customers
-});
-/** Schema for an API key.
-
-Maps to serialized app key output from developer portal API.
- */
-export const appKeySchema = z.object({
-    created_at: z.string().optional(), // Created timestamp
-    full_key: z.string().optional(), // Full key shown only once at creation
-    id: z.string(), // Public ID (dak_...)
-    key_hint: z.string().optional(), // Last 4 chars hint
-    key_value: z.string().optional(), // Full key (publishable only)
-    last_used_at: z.string().optional(), // Last used timestamp
-    status: z.string(), // Status (active, revoked)
-    type: z.string(), // Key type (publishable, secret)
-});
-/** Schema for task update parameters.
-
-Used by both Users.Tasks.Update and Teams.Tasks.Update actions.
-All fields are optional since updates only modify provided fields.
- */
-export const taskUpdateParamsSchema = z.object({
-    description: z.string().optional(), // Task description
-    due_date: z.string().optional(), // Due date
-    links: z.record(z.unknown()).optional(), // Related links
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    name: z.string().optional(), // Task name
-    owner_persona: z.string().optional(), // Owner persona if assigned to agent
-    owner_user: z.string().optional(), // Owner user if assigned to user
-    priority: z.number().int().optional(), // Priority level (0-4)
-    status: z.string().optional(), // Task status (open, in_progress, done)
-});
-/** Schema for a context integration.
-
-Maps to serialized integration output from developer portal API.
- */
-export const contextIntegrationSchema = z.object({
-    agent: z.string().optional(), // Owning agent
-    auth_type: z.string(), // Auth type: oauth or app_installation
-    connected_at: z.string().optional(), // Connection timestamp
-    created_at: z.string().optional(), // Created timestamp
-    expires_at: z.string().optional(), // Token expiration timestamp
-    id: z.string(), // Public ID (int_...)
-    installation: z.string().optional(), // External installation (e.g. GitHub App installation)
-    last_refreshed_at: z.string().optional(), // Last token refresh timestamp
-    metadata: z.record(z.unknown()).optional(), // Additional metadata
-    org: z.string().optional(), // Owning org
-    provider: z.string(), // Provider name (e.g., google, github)
-    scopes: z.array(z.string()).optional(), // OAuth scopes
-    status: z.string(), // Connection status: connected, disconnected, or token_expired
-    team: z.string().optional(), // Owning team
-    updated_at: z.string().optional(), // Updated timestamp
-    user: z.string().optional(), // Owning user
-    workspace_key: z.string().optional(), // Workspace key
-});
-/** API schema for a scrape result. */
-export const scrapeSchema = z.object({
-    created_at: z.string().optional(), // Creation timestamp
-    description: z.string().optional(), // Page description
-    id: z.string(), // Scrape ID (scp_...)
-    image_height: z.number().int().optional(), // Image height in pixels
-    image_url: z.string().optional(), // Image URL
-    image_width: z.number().int().optional(), // Image width in pixels
-    last_scraped_at: z.string().optional(), // Last scraped timestamp
-    metadata: z.record(z.unknown()).optional(), // Scrape metadata
-    status: z.string().optional(), // Scrape status
-    title: z.string().optional(), // Page title
-    updated_at: z.string().optional(), // Last update timestamp
-    url: z.string().optional(), // Scraped URL
-    version: z.number().int().optional(), // Scrape version
-});
-/** Schema for comment creation parameters.
-
-Used by both Users.Tasks.CreateComment and Teams.Tasks.CreateComment actions.
- */
-export const commentCreateParamsSchema = z.object({
-    body: z.string(), // Comment body text
-});
-/** List response for installation sources. */
-export const installationSourceListResponseSchema = z.object({
-    data: z.array(installationSourceSchema), // List of installation sources
-});
-/** Schema for a user (developer admin view).
-
-Maps to serialized user output from developer portal API.
- */
-export const developerUserSchema = z.object({
-    alias: z.string().optional(), // User alias
-    confirmed_at: z.string().optional(), // Email confirmed timestamp
-    created_at: z.string().optional(), // Created timestamp
-    email: z.string(), // Email address
-    full_name: z.string().optional(), // Full name
-    id: z.string(), // Public ID (usr_...)
-    is_system_user: z.boolean().optional(), // Whether this is a system user
-    org: z.string().optional(), // Organization (nullable)
-    org_name: z.string().optional(), // Organization display name (nullable)
-    org_role: z.string().optional(), // Organization role (admin, member, viewer; nullable)
-    password: z.string().optional(), // Temporary plaintext password returned on reset
-    sandbox: z.string().optional(), // Sandbox identifier (nullable)
-    updated_at: z.string().optional(), // Updated timestamp
-});
-/** Schema for password update parameters.
- */
-export const passwordUpdateParamsSchema = z.object({
-    password: z.string(), // New password
-    password_confirmation: z.string(), // New password confirmation
-});
-/** Schema for OAuth client list responses. */
-export const oAuthClientListSchema = z.object({
-    data: z.array(oAuthClientSchema), // OAuth clients
-});
 //# sourceMappingURL=common.js.map