@archastro/sdk 0.1.0

package/dist/types/common.js

@@ -0,0 +1,1209 @@
+// Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
+// This file is auto-generated by @archastro/sdk-generator. Do not edit.
+// Content hash: 52d854ce8966
+import { z } from "zod";
+import { imageSourceSchema } from "./image.js";
+import { messageSchema } from "./messages.js";
+import { userSchema } from "./users.js";
+/** Schema for a thread in the developer portal.
+
+Maps to serialized thread output from developer portal API.
+ */
+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
+});
+/** Schema for a context ingestion.
+
+Maps to serialized context ingestion output from developer portal API.
+ */
+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.unknown().optional(), // Error details (if failed)
+    id: z.string(), // Public ID (cig_...)
+    metadata: 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
+});
+/** API schema for a working memory entry. */
+export const workingMemoryEntrySchema = z.object({
+    agent: z.string().optional(), // Owning agent
+    created_at: z.string().optional(), // Creation timestamp
+    expires_at: z.string().optional(), // Expiration timestamp
+    id: z.string(), // Memory entry ID (amm_...)
+    key: z.string().optional(), // Memory key
+    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.unknown()).optional(), // BCC recipients
+    cc: z.array(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.unknown().optional(), // Custom email headers
+    html_body: z.string().optional(), // HTML body
+    id: z.string(), // Public ID (sem_...)
+    reply_to: z.unknown().optional(), // Reply-to address
+    subject: z.string().optional(), // Email subject
+    text_body: z.string().optional(), // Plain text body
+    to: z.array(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.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.unknown().optional(), // Request headers
+    id: z.string(), // Public ID (whe_...)
+    payload: 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 a message actor (user or agent).
+
+Actors represent the entity that sent a message.
+Maps to the actor format from MessageActorHelper.build_actor/1.
+ */
+export const actorSchema = z.object({
+    alias: z.string().optional(), // Actor alias/handle
+    id: z.string().optional(), // Actor ID (format: user-xxx or agent-xxx)
+    name: z.string().optional(), // Actor display name
+    profile_picture: imageSourceSchema.optional(), // Profile picture
+});
+/** 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(z.unknown()).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.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.unknown()).optional(), // Loaded file objects
+    id: z.string(), // Context entry ID
+    links: z.array(z.unknown()).optional(), // Loaded link objects
+    media: z.array(z.unknown()).optional(), // Loaded media objects
+    metadata: 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.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 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 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
+});
+/** 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
+});
+/** 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 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.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.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 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.unknown()).optional(), // Grading criteria
+    id: z.string(), // Eval task ID
+    input_message: z.string(), // Task input message
+    mock_agent_memory: z.unknown().optional(), // Mock agent memory
+    mock_context_items: z.array(z.unknown()).optional(), // Mock context items
+    mock_datetime: z.string().optional(), // Mock datetime
+    mock_participants: z.array(z.unknown()).optional(), // Mock participants
+    mock_tools: z.array(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.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 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.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.unknown().optional(), // Execution transcript
+    updated_at: z.string().optional(), // Updated 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(z.unknown()).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.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.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.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
+});
+/** Schema for a message attachment.
+
+Attachments can be of various types (file, scraped_link, artifact, task, media, action).
+Fields present depend on the attachment type.
+Maps to format_attachments_for_client/1 output.
+ */
+export const attachmentSchema = z.object({
+    content_type: z.string().optional(), // MIME content type (file, artifact, media types)
+    description: z.string().optional(), // Description (scraped_link, artifact, task types)
+    filename: z.string().optional(), // File name (file, artifact, media types)
+    height: z.number().int().optional(), // Media height (media type)
+    id: z.string(), // Attachment ID
+    image_height: z.number().int().optional(), // Preview image height (scraped_link type)
+    image_source: imageSourceSchema.optional(), // Image metadata (file, scraped_link, artifact, media types)
+    image_url: z.string().optional(), // Preview image URL (scraped_link type)
+    image_width: z.number().int().optional(), // Preview image width (scraped_link type)
+    media_type: z.string().optional(), // Media type (media type)
+    name: z.string().optional(), // Media name (media type)
+    object: z.unknown().optional(), // Embedded object (task, action types)
+    title: z.string().optional(), // Title (scraped_link, artifact, task types)
+    type: z.string(), // Attachment type: file, scraped_link, artifact, task, media, action
+    url: z.string().optional(), // URL to the resource (file, scraped_link, artifact, media types)
+    variants: z.array(z.unknown()).optional(), // Media variants (media type)
+    version: z.number().int().optional(), // Artifact version number (artifact type)
+    width: z.number().int().optional(), // Media width (media type)
+});
+/** API schema for an installation. */
+export const installationSchema = z.object({
+    agent: z.string().optional(), // Owning agent
+    config: 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.unknown().optional(), // Status payload
+    updated_at: z.string().optional(), // Last update timestamp
+});
+/** Schema for persona update parameters.
+ */
+export const personaUpdateParamsSchema = z.object({
+    metadata: 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.unknown()), // Trajectory messages
+});
+/** API schema for a user credential. */
+export const credentialSchema = z.object({
+    alt_domains: 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.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.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.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.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(z.unknown()), // 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.unknown(), // Sample payload for this event
+    schema: 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.unknown(), // Event payload
+    team: z.string().optional(), // Team identifier
+    user: z.string().optional(), // User identifier
+});
+/** 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.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.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
+});
+/** 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.unknown()), // Column definitions with name, type, and label
+    meta: z.unknown(), // Query metadata (total_rows, query_time_ms)
+    rows: z.array(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.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.unknown().optional(), // Request body payload (webhooks only)
+    request_headers: 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.unknown()), // Documented error responses
+    method: z.string(), // HTTP method
+    params: z.array(z.unknown()), // Documented params
+    path: z.string(), // Route path
+    returns: 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.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.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.unknown().optional(), // Related links
+    metadata: 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)
+});
+/** 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.unknown().optional(), // Arbitrary metadata
+    parent_source: z.string().optional(), // Parent source ID
+    payload: 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.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.unknown().optional(), // Related links
+    metadata: z.unknown().optional(), // Additional metadata
+    name: z.string(), // Task name
+    org: z.string().optional(), // Organization
+    owner: z.string().optional(), // Legacy owner
+    owner_actor: 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.unknown().optional(), // Additional metadata
+    org: z.string().optional(), // Owning organization
+    parent_source: z.string().optional(), // Parent source
+    payload: 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
+    has_next: z.boolean().optional(), // Whether a next page exists
+    has_prev: z.boolean().optional(), // Whether a previous page exists
+    page: z.number().int().optional(), // Current page number
+    page_size: z.number().int().optional(), // Results per page
+    total_entries: z.number().int().optional(), // Total number of entries
+    total_pages: z.number().int().optional(), // Total number of pages
+});
+/** 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.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.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.unknown().optional(), // Additional metadata
+    raw_content: 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
+    primary_user: z.string().optional(), // Org admin user who is the billing contact (public ID)
+});
+/** 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.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: z.unknown().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 the API explorer response. */
+export const apiExplorerIndexSchema = z.object({
+    data: z.array(apiExplorerEndpointSchema), // Documented API endpoints
+    schemas: 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.unknown().optional(), // Additional metadata
+    normalized_content: z.string().optional(), // Normalized content text
+    raw_content: 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.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.unknown(), // JSON Schema for action parameters
+    key: z.string(), // Action key (e.g., gmail.list_messages)
+    scopes_any_of: 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.unknown().optional(), // Related links
+    metadata: 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.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.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
+});
+/** 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