@archastro/sdk 0.1.0 → 0.4.0

package/dist/types/common.js

@@ -1,10 +1,129 @@
 // Copyright (c) 2026 ArchAstro Inc. All Rights Reserved.
 // This file is auto-generated by @archastro/sdk-generator. Do not edit.
-// Content hash: 52d854ce8966
+// Content hash: 0bbab3d3f31f
 import { z } from "zod";
 import { imageSourceSchema } from "./image.js";
-import { messageSchema } from "./messages.js";
 import { userSchema } from "./users.js";
+/** 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
+});
+/** API schema for a media variant. */
+export const mediaVariantSchema = z.object({
+    content_type: z.string().optional(), // File content type
+    created_at: z.string().optional(), // Creation timestamp
+    file: z.string().optional(), // Storage file
+    filename: z.string().optional(), // Original filename
+    height: z.number().int().optional(), // Height in pixels
+    id: z.string(), // Variant ID
+    image_source: imageSourceSchema.optional(), // Image source metadata
+    updated_at: z.string().optional(), // Last update timestamp
+    url: z.string().optional(), // Signed download URL
+    variant_key: z.string().optional(), // Variant key (original, thumbnail, etc)
+    width: z.number().int().optional(), // Width in pixels
+});
+/** 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.record(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(mediaVariantSchema).optional(), // Media variants (media type)
+    version: z.number().int().optional(), // Artifact version number (artifact type)
+    width: z.number().int().optional(), // Media width (media type)
+});
+/** Schema for inline message reactions.
+
+This is the compact format used in Message.reactions[], which differs from
+the full Reaction schema used in standalone reaction endpoints.
+Maps to format_reactions_for_client/1 output.
+ */
+export const messageReactionSchema = z.object({
+    payload: z.record(z.unknown()).optional(), // Reaction payload (e.g., {emoji: '👍'})
+    type: z.string(), // Reaction type (e.g., emoji_reaction)
+    user: z.string().optional(), // User who added the reaction
+});
+/** API schema for a chat message. */
+export const messageSchema = z.object({
+    actors: z.array(actorSchema).optional(), // Message actors
+    agent: z.string().optional(), // Agent if sent by an agent user
+    attachments: z.array(attachmentSchema).optional(), // Message attachments
+    branched_thread: z.string().optional(), // Branched thread (if message spawned a thread)
+    content: z.string().optional(), // Message content
+    created_at: z.string().optional(), // Creation timestamp
+    has_replies: z.boolean().optional(), // Whether message has replies
+    id: z.string(), // Message ID (msg_...)
+    idempotency_key: z.string().optional(), // Client-provided idempotency key
+    legacy_agent: z.string().optional(), // Legacy agent if sent by legacy chat agent
+    metadata: z.record(z.unknown()).optional(), // Message metadata
+    org: z.string().optional(), // Organization
+    reactions: z.array(messageReactionSchema).optional(), // Message reactions
+    rendering_mode: z.string().optional(), // Rendering mode hint
+    replies: z.array(z.record(z.unknown())).optional(), // Inline replies (if loaded)
+    replies_after_cursor: z.string().optional(), // Cursor for replies pagination
+    replies_before_cursor: z.string().optional(), // Cursor for replies pagination
+    reply_count: z.number().int().optional(), // Number of replies
+    reply_to: z.record(z.unknown()).optional(), // Parent message object (if loaded)
+    sandbox: z.string().optional(), // Sandbox identifier
+    team: z.string().optional(), // Team
+    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
+});
+/** 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 thread in the developer portal.
 
 Maps to serialized thread output from developer portal API.
@@ -34,9 +153,9 @@ 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)
+    error: z.record(z.unknown()).optional(), // Error details (if failed)
     id: z.string(), // Public ID (cig_...)
-    metadata: z.unknown().optional(), // Additional metadata
+    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)
@@ -57,18 +176,18 @@ export const workingMemoryEntrySchema = z.object({
 /** 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
+    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.unknown().optional(), // Custom email headers
+    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.unknown().optional(), // Reply-to address
+    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.unknown()), // Recipients [{name, address}]
+    to: z.array(z.record(z.unknown())), // Recipients [{name, address}]
 });
 /** Schema for an LLM session call.
 
@@ -82,7 +201,7 @@ export const llmCallSchema = z.object({
     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
+    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
@@ -112,22 +231,26 @@ 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
+    headers: z.record(z.unknown()).optional(), // Request headers
     id: z.string(), // Public ID (whe_...)
-    payload: z.unknown().optional(), // Event payload
+    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 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 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({
@@ -136,11 +259,11 @@ export const evalRunSchema = z.object({
     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
+    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.unknown().optional(), // Aggregate run summary
+    summary: z.record(z.unknown()).optional(), // Aggregate run summary
     updated_at: z.string().optional(), // Updated timestamp
 });
 /** API schema for a context entry. */
@@ -149,11 +272,11 @@ export const contextEntrySchema = z.object({
     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
+    files: z.array(z.record(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
+    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
@@ -172,7 +295,7 @@ export const webhookSchema = z.object({
     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
+    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
@@ -199,12 +322,6 @@ export const deviceAuthorizationResponseSchema = z.object({
     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
@@ -219,38 +336,22 @@ 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
 });
-/** 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
@@ -267,7 +368,7 @@ export const integrationSchema = z.object({
     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
+    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
@@ -295,7 +396,7 @@ export const keyValueStorageEntrySchema = z.object({
 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
+    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
@@ -306,18 +407,25 @@ export const installationKindSchema = z.object({
 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.unknown()).optional(), // Grading criteria
+    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.unknown().optional(), // Mock agent memory
-    mock_context_items: z.array(z.unknown()).optional(), // Mock context items
+    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.unknown()).optional(), // Mock participants
-    mock_tools: z.array(z.unknown()).optional(), // Mock tool definitions
+    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
@@ -325,7 +433,7 @@ export const evalTaskSchema = z.object({
 /** 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_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
@@ -337,21 +445,6 @@ export const taskCommentSchema = z.object({
     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
@@ -373,7 +466,7 @@ export const evalSuiteSchema = z.object({
     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
+    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
 });
@@ -409,7 +502,7 @@ 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
+    messages: z.record(z.unknown()).optional(), // Trajectory messages
     org: z.string().optional(), // Organization
     sandbox: z.string().optional(), // Sandbox
     team: z.string().optional(), // Team
@@ -437,7 +530,7 @@ export const paginatedRepliesSchema = z.object({
 });
 /** A routine preset with its metadata. */
 export const routinePresetSchema = z.object({
-    config: z.unknown().optional(), // Default configuration
+    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
@@ -451,7 +544,7 @@ export const personaSchema = z.object({
     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
+    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
@@ -460,48 +553,22 @@ export const personaSchema = z.object({
     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
+    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.unknown().optional(), // Status payload
+    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.unknown().optional(), // Additional metadata
+    metadata: z.record(z.unknown()).optional(), // Additional metadata
     name: z.string().optional(), // Persona display name
     personality: z.string().optional(), // Persona personality description
 });
@@ -532,11 +599,11 @@ export const evalRunListSchema = z.object({
 /** 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
+    messages: z.array(z.record(z.unknown())), // Trajectory messages
 });
 /** API schema for a user credential. */
 export const credentialSchema = z.object({
-    alt_domains: z.unknown().optional(), // Alternative domains
+    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
@@ -549,9 +616,9 @@ export const credentialSchema = z.object({
 });
 /** 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)
+    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.unknown()).optional(), // Entry attachments
+    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
@@ -559,7 +626,7 @@ export const activityFeedEntrySchema = z.object({
     id: z.string(), // Entry ID (afe_...)
     kind: z.string().optional(), // Entry kind
     level: z.string().optional(), // Severity level
-    metadata: z.unknown().optional(), // Entry metadata
+    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
@@ -568,7 +635,7 @@ export const activityFeedEntrySchema = z.object({
     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)
+    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.
  */
@@ -593,7 +660,7 @@ 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
+    messages: z.array(messageSchema), // List of message objects
 });
 /** Schema for an event catalog entry with full payload schema and sample.
  */
@@ -601,8 +668,8 @@ 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
+    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
 });
@@ -613,10 +680,16 @@ export const domainEventSchema = z.object({
     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
+    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
@@ -641,7 +714,7 @@ export const workerStatusSchema = z.object({
 /** 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)
+    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)
@@ -659,7 +732,7 @@ export const secretValueSchema = z.object({
 });
 /** 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
+    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
@@ -673,6 +746,7 @@ export const builtinToolCatalogEntrySchema = z.object({
 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.
 
@@ -692,9 +766,9 @@ export const fileRefreshResultSchema = z.object({
 /** 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
+    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.
 
@@ -710,13 +784,13 @@ export const apiCallSchema = z.object({
     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)
+    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.unknown().optional(), // Request body payload (webhooks only)
-    request_headers: z.unknown().optional(), // Request headers (webhooks only)
+    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
@@ -737,18 +811,18 @@ export const domainEventPageSchema = z.object({
 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
+    errors: z.array(z.record(z.unknown())), // Documented error responses
     method: z.string(), // HTTP method
-    params: z.array(z.unknown()), // Documented params
+    params: z.array(z.record(z.unknown())), // Documented params
     path: z.string(), // Route path
-    returns: z.unknown().optional(), // Return schema description
+    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.unknown().optional(), // JSON Schema describing the expected input
+    parameters: z.record(z.unknown()).optional(), // JSON Schema describing the expected input
 });
 /** Schema for an encrypted secret payload. */
 export const encryptedSecretSchema = z.object({
@@ -757,7 +831,7 @@ export const encryptedSecretSchema = z.object({
 /** 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
+    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
@@ -775,8 +849,8 @@ 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
+    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
@@ -784,15 +858,22 @@ export const taskCreateParamsSchema = z.object({
     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.unknown().optional(), // Arbitrary metadata
+    metadata: z.record(z.unknown()).optional(), // Arbitrary metadata
     parent_source: z.string().optional(), // Parent source ID
-    payload: z.unknown().optional(), // Source payload
+    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
@@ -813,19 +894,19 @@ export const taskSchema = z.object({
     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_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.unknown().optional(), // Related links
-    metadata: z.unknown().optional(), // Additional metadata
+    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.unknown().optional(), // Owner actor details
+    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)
@@ -877,10 +958,10 @@ export const contextSourceSchema = z.object({
     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
+    metadata: z.record(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
+    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
@@ -899,6 +980,10 @@ 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
@@ -911,7 +996,7 @@ Required fields depend on the kind's auth type:
 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)
+    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
 });
@@ -932,7 +1017,7 @@ export const contextCredentialSchema = z.object({
 /** 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
+    token: z.record(z.unknown()), // Token status details
     user: userSchema.optional(), // Authenticated user (if token is valid)
 });
 /** Schema for an OAuth provider configuration.
@@ -983,16 +1068,33 @@ export const knowledgeSearchResultSchema = z.object({
     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
+    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
@@ -1024,7 +1126,7 @@ export const developerOrgSchema = z.object({
 });
 /** API schema for a credential with decrypted secret values. */
 export const credentialWithSecretsSchema = z.object({
-    credential: z.unknown(), // The credential with decrypted values
+    credential: z.record(z.unknown()), // The credential with decrypted values
 });
 /** API schema for a storage file. */
 export const storageFileSchema = z.object({
@@ -1032,17 +1134,26 @@ export const storageFileSchema = z.object({
     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
+    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.unknown().optional(), // Collected schema definitions
+    schemas: z.record(z.unknown()).optional(), // Collected schema definitions
 });
 /** Schema for an app slug mapping. */
 export const appSlugSchema = z.object({
@@ -1063,9 +1174,9 @@ export const contextItemSchema = z.object({
     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
+    metadata: z.record(z.unknown()).optional(), // Additional metadata
     normalized_content: z.string().optional(), // Normalized content text
-    raw_content: z.unknown().optional(), // Raw content data
+    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
@@ -1073,7 +1184,7 @@ export const contextItemSchema = z.object({
 });
 /** API schema for push notification test results. */
 export const pushNotificationResultSchema = z.object({
-    results: z.array(z.unknown()).optional(), // Per-device results
+    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
 });
@@ -1092,9 +1203,9 @@ export const oAuthClientSchema = z.object({
 /** 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
+    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.unknown().optional(), // Required scope sets for this action
+    scopes_any_of: z.record(z.unknown()).optional(), // Required scope sets for this action
 });
 /** Schema for app billing settings. */
 export const billingSettingsAppSchema = z.object({
@@ -1123,8 +1234,8 @@ 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
+    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
@@ -1144,7 +1255,7 @@ export const contextIntegrationSchema = z.object({
     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
+    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
@@ -1163,7 +1274,7 @@ export const scrapeSchema = z.object({
     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
+    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
@@ -1177,6 +1288,10 @@ 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.