@archastro/sdk 0.10.0 → 0.11.0

package/dist/types/common.d.ts

@@ -6648,6 +6648,41 @@ export declare const contextIngestionSchema: z.ZodObject<{
     completed_at?: string | undefined;
     started_at?: string | undefined;
 }>;
+/**
+ * Creation-only private service enrollment response. The raw token is shown
+ * once and is omitted from every read schema.
+ */
+export interface CreatedPrivateServiceEnrollment {
+    /** One-time connector enrollment token. Store it immediately. */
+    enrollment_token: string;
+    /** When the one-time enrollment token expires. */
+    enrollment_token_expires_at: string;
+    generation: number;
+    id: string;
+    private_service: string;
+}
+/** Runtime validator for {@link CreatedPrivateServiceEnrollment}. */
+export declare const createdPrivateServiceEnrollmentSchema: z.ZodObject<{
+    /** One-time connector enrollment token. Store it immediately. */
+    enrollment_token: z.ZodString;
+    /** When the one-time enrollment token expires. */
+    enrollment_token_expires_at: z.ZodString;
+    generation: z.ZodNumber;
+    id: z.ZodString;
+    private_service: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    enrollment_token: string;
+    enrollment_token_expires_at: string;
+    generation: number;
+    private_service: string;
+}, {
+    id: string;
+    enrollment_token: string;
+    enrollment_token_expires_at: string;
+    generation: number;
+    private_service: string;
+}>;
 /** A custom object belonging to an organization. Custom objects store arbitrary structured data defined by a schema type and are scoped to an org, team, or user. */
 export interface CustomObject {
     /** Access control list governing read and write access to this custom object. Only returned to resource owners and privileged or organization-admin viewers; `null` for everyone else. */
@@ -7193,8 +7228,30 @@ export declare const customObjectUpdateFieldsResponseSchema: z.ZodObject<{
     fields: Record<string, unknown>;
     operation_id: string;
 }>;
+/** Deployment metadata. */
+export interface Deployment {
+    /** Deployment environment, or `null` when it is not configured. */
+    environment?: string | null | undefined;
+    /** Opaque SHA-256 fingerprint of the image reference, or `null` in local development. */
+    release?: string | null | undefined;
+}
+/** Runtime validator for {@link Deployment}. */
+export declare const deploymentSchema: z.ZodObject<{
+    /** Deployment environment, or `null` when it is not configured. */
+    environment: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Opaque SHA-256 fingerprint of the image reference, or `null` in local development. */
+    release: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    environment?: string | null | undefined;
+    release?: string | null | undefined;
+}, {
+    environment?: string | null | undefined;
+    release?: string | null | undefined;
+}>;
 /** A file stored in the platform's object storage, with metadata and a signed URL for downloading its contents. */
 export interface StorageFile {
+    /** ID of the app this file belongs to (`app_...`). */
+    app?: string | undefined;
     /** MIME type of the file, e.g. `"image/png"` or `"application/pdf"`. */
     content_type?: string | undefined;
     /** When the file was uploaded (ISO 8601). */
@@ -7213,13 +7270,19 @@ export interface StorageFile {
     share_url?: string | undefined;
     /** Size of the file in bytes. */
     size?: number | undefined;
+    /** ID of the team that owns this file (`team_...`). `null` if not team-owned. */
+    team?: string | undefined;
     /** When the file record was last modified (ISO 8601). */
     updated_at?: string | undefined;
     /** Short-lived signed URL for downloading the file. `null` if a URL could not be generated. */
     url?: string | undefined;
+    /** ID of the user that owns this file (`user_...`). `null` if not user-owned. */
+    user?: string | undefined;
 }
 /** Runtime validator for {@link StorageFile}. */
 export declare const storageFileSchema: z.ZodObject<{
+    /** ID of the app this file belongs to (`app_...`). */
+    app: z.ZodOptional<z.ZodString>;
     /** MIME type of the file, e.g. `"image/png"` or `"application/pdf"`. */
     content_type: z.ZodOptional<z.ZodString>;
     /** When the file was uploaded (ISO 8601). */
@@ -7262,15 +7325,22 @@ export declare const storageFileSchema: z.ZodObject<{
     share_url: z.ZodOptional<z.ZodString>;
     /** Size of the file in bytes. */
     size: z.ZodOptional<z.ZodNumber>;
+    /** ID of the team that owns this file (`team_...`). `null` if not team-owned. */
+    team: z.ZodOptional<z.ZodString>;
     /** When the file record was last modified (ISO 8601). */
     updated_at: z.ZodOptional<z.ZodString>;
     /** Short-lived signed URL for downloading the file. `null` if a URL could not be generated. */
     url: z.ZodOptional<z.ZodString>;
+    /** ID of the user that owns this file (`user_...`). `null` if not user-owned. */
+    user: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
+    team?: string | undefined;
     org?: string | undefined;
+    app?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    user?: string | undefined;
     sandbox?: string | undefined;
     url?: string | undefined;
     content_type?: string | undefined;
@@ -7288,9 +7358,12 @@ export declare const storageFileSchema: z.ZodObject<{
     size?: number | undefined;
 }, {
     id: string;
+    team?: string | undefined;
     org?: string | undefined;
+    app?: string | undefined;
     created_at?: string | undefined;
     updated_at?: string | undefined;
+    user?: string | undefined;
     sandbox?: string | undefined;
     url?: string | undefined;
     content_type?: string | undefined;
@@ -9276,6 +9349,267 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
     has_more?: boolean | undefined;
     total_count?: number | undefined;
 }>;
+/** A documented callable operation exposed by a private service. */
+export interface PrivateServiceFunction {
+    /** Human-readable guidance describing when and why to call the operation. */
+    description: string;
+    /** JSON Schema Draft 7 object describing the operation's argument object. */
+    input_schema: Record<string, unknown>;
+    /** Stable operation name used when invoking the private service. */
+    name: string;
+    /** Optional JSON Schema Draft 7 object describing the successful result. */
+    output_schema?: Record<string, unknown> | undefined;
+}
+/** Runtime validator for {@link PrivateServiceFunction}. */
+export declare const privateServiceFunctionSchema: z.ZodObject<{
+    /** Human-readable guidance describing when and why to call the operation. */
+    description: z.ZodString;
+    /** JSON Schema Draft 7 object describing the operation's argument object. */
+    input_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /** Stable operation name used when invoking the private service. */
+    name: z.ZodString;
+    /** Optional JSON Schema Draft 7 object describing the successful result. */
+    output_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    name: string;
+    input_schema: Record<string, unknown>;
+    output_schema?: Record<string, unknown> | undefined;
+}, {
+    description: string;
+    name: string;
+    input_schema: Record<string, unknown>;
+    output_schema?: Record<string, unknown> | undefined;
+}>;
+/** An immutable private service with complete callable operation contracts. */
+export interface PrivateService {
+    /** Sorted callable definitions exposed by this private service. */
+    functions: PrivateServiceFunction[];
+    /** Private service ID (`pvs_...`). */
+    id: string;
+}
+/** Runtime validator for {@link PrivateService}. */
+export declare const privateServiceSchema: z.ZodObject<{
+    /** Sorted callable definitions exposed by this private service. */
+    functions: z.ZodArray<z.ZodObject<{
+        /** Human-readable guidance describing when and why to call the operation. */
+        description: z.ZodString;
+        /** JSON Schema Draft 7 object describing the operation's argument object. */
+        input_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        /** Stable operation name used when invoking the private service. */
+        name: z.ZodString;
+        /** Optional JSON Schema Draft 7 object describing the successful result. */
+        output_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        name: string;
+        input_schema: Record<string, unknown>;
+        output_schema?: Record<string, unknown> | undefined;
+    }, {
+        description: string;
+        name: string;
+        input_schema: Record<string, unknown>;
+        output_schema?: Record<string, unknown> | undefined;
+    }>, "many">;
+    /** Private service ID (`pvs_...`). */
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    functions: {
+        description: string;
+        name: string;
+        input_schema: Record<string, unknown>;
+        output_schema?: Record<string, unknown> | undefined;
+    }[];
+}, {
+    id: string;
+    functions: {
+        description: string;
+        name: string;
+        input_schema: Record<string, unknown>;
+        output_schema?: Record<string, unknown> | undefined;
+    }[];
+}>;
+/**
+ * A private service's durable connector identity. Read responses never contain
+ * an enrollment token or certificate.
+ */
+export interface PrivateServiceEnrollment {
+    /** Latest committed connector certificate generation, or zero before enrollment. */
+    generation: number;
+    /** Canonical certificate-bound service identity. */
+    id: string;
+    /** Immutable private service ID (`pvs_...`). */
+    private_service: string;
+}
+/** Runtime validator for {@link PrivateServiceEnrollment}. */
+export declare const privateServiceEnrollmentSchema: z.ZodObject<{
+    /** Latest committed connector certificate generation, or zero before enrollment. */
+    generation: z.ZodNumber;
+    /** Canonical certificate-bound service identity. */
+    id: z.ZodString;
+    /** Immutable private service ID (`pvs_...`). */
+    private_service: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    generation: number;
+    private_service: string;
+}, {
+    id: string;
+    generation: number;
+    private_service: string;
+}>;
+/** A secret-free page of private service enrollments. */
+export interface PrivateServiceEnrollmentPage {
+    data: PrivateServiceEnrollment[];
+    has_next: boolean;
+    has_prev: boolean;
+    page: number;
+    page_size: number;
+    total_entries: number;
+    total_pages: number;
+}
+/** Runtime validator for {@link PrivateServiceEnrollmentPage}. */
+export declare const privateServiceEnrollmentPageSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        /** Latest committed connector certificate generation, or zero before enrollment. */
+        generation: z.ZodNumber;
+        /** Canonical certificate-bound service identity. */
+        id: z.ZodString;
+        /** Immutable private service ID (`pvs_...`). */
+        private_service: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        generation: number;
+        private_service: string;
+    }, {
+        id: string;
+        generation: number;
+        private_service: string;
+    }>, "many">;
+    has_next: z.ZodBoolean;
+    has_prev: z.ZodBoolean;
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    total_entries: z.ZodNumber;
+    total_pages: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        id: string;
+        generation: number;
+        private_service: string;
+    }[];
+    has_next: boolean;
+    has_prev: boolean;
+    page: number;
+    page_size: number;
+    total_entries: number;
+    total_pages: number;
+}, {
+    data: {
+        id: string;
+        generation: number;
+        private_service: string;
+    }[];
+    has_next: boolean;
+    has_prev: boolean;
+    page: number;
+    page_size: number;
+    total_entries: number;
+    total_pages: number;
+}>;
+/** A page of private services. */
+export interface PrivateServicePage {
+    data: PrivateService[];
+    has_next: boolean;
+    has_prev: boolean;
+    page: number;
+    page_size: number;
+    total_entries: number;
+    total_pages: number;
+}
+/** Runtime validator for {@link PrivateServicePage}. */
+export declare const privateServicePageSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        /** Sorted callable definitions exposed by this private service. */
+        functions: z.ZodArray<z.ZodObject<{
+            /** Human-readable guidance describing when and why to call the operation. */
+            description: z.ZodString;
+            /** JSON Schema Draft 7 object describing the operation's argument object. */
+            input_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            /** Stable operation name used when invoking the private service. */
+            name: z.ZodString;
+            /** Optional JSON Schema Draft 7 object describing the successful result. */
+            output_schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            name: string;
+            input_schema: Record<string, unknown>;
+            output_schema?: Record<string, unknown> | undefined;
+        }, {
+            description: string;
+            name: string;
+            input_schema: Record<string, unknown>;
+            output_schema?: Record<string, unknown> | undefined;
+        }>, "many">;
+        /** Private service ID (`pvs_...`). */
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        functions: {
+            description: string;
+            name: string;
+            input_schema: Record<string, unknown>;
+            output_schema?: Record<string, unknown> | undefined;
+        }[];
+    }, {
+        id: string;
+        functions: {
+            description: string;
+            name: string;
+            input_schema: Record<string, unknown>;
+            output_schema?: Record<string, unknown> | undefined;
+        }[];
+    }>, "many">;
+    has_next: z.ZodBoolean;
+    has_prev: z.ZodBoolean;
+    page: z.ZodNumber;
+    page_size: z.ZodNumber;
+    total_entries: z.ZodNumber;
+    total_pages: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        id: string;
+        functions: {
+            description: string;
+            name: string;
+            input_schema: Record<string, unknown>;
+            output_schema?: Record<string, unknown> | undefined;
+        }[];
+    }[];
+    has_next: boolean;
+    has_prev: boolean;
+    page: number;
+    page_size: number;
+    total_entries: number;
+    total_pages: number;
+}, {
+    data: {
+        id: string;
+        functions: {
+            description: string;
+            name: string;
+            input_schema: Record<string, unknown>;
+            output_schema?: Record<string, unknown> | undefined;
+        }[];
+    }[];
+    has_next: boolean;
+    has_prev: boolean;
+    page: number;
+    page_size: number;
+    total_entries: number;
+    total_pages: number;
+}>;
 /** A named preset that defines the execution model and constraints for a routine. Presets are shared definitions; individual routines reference a preset by name. */
 export interface RoutinePreset {
     /** Event types that routines using this preset may be triggered by. `["*"]` means the preset accepts any event type. Routines assigned to this preset will be rejected at creation time if their trigger event is not in this list. */
@@ -9570,6 +9904,241 @@ export declare const runJournalPageSchema: z.ZodObject<{
         started_at?: string | undefined;
     } | undefined;
 }>;
+/** An API key scoped to a developer sandbox, used to authenticate requests against sandbox resources. */
+export interface SandboxKey {
+    /** When this key was created (ISO 8601). */
+    created_at?: string | undefined;
+    /** When this key expires and becomes invalid. `null` if the key does not expire. */
+    expires_at?: string | undefined;
+    /** The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals. */
+    full_key?: string | undefined;
+    /** Sandbox key ID (`dsk_...`). */
+    id: string;
+    /** A short hint showing the last four characters of the key, used for identification. `null` if no hint is available. */
+    key_hint?: string | undefined;
+    /** The full key value for `"publishable"` keys. `null` for `"secret"` keys; use `full_key` instead, which is returned only at creation time. */
+    key_value?: string | undefined;
+    /** When this key was last used to authenticate a request. `null` if the key has never been used. */
+    last_used_at?: string | undefined;
+    /** Current lifecycle status of the key. One of `"active"` (usable) or `"revoked"` (permanently disabled). */
+    status: string;
+    /** The kind of key. One of `"publishable"` (safe for client-side use) or `"secret"` (server-side only). */
+    type: string;
+}
+/** Runtime validator for {@link SandboxKey}. */
+export declare const sandboxKeySchema: z.ZodObject<{
+    /** When this key was created (ISO 8601). */
+    created_at: z.ZodOptional<z.ZodString>;
+    /** When this key expires and becomes invalid. `null` if the key does not expire. */
+    expires_at: z.ZodOptional<z.ZodString>;
+    /** The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals. */
+    full_key: z.ZodOptional<z.ZodString>;
+    /** Sandbox key ID (`dsk_...`). */
+    id: z.ZodString;
+    /** A short hint showing the last four characters of the key, used for identification. `null` if no hint is available. */
+    key_hint: z.ZodOptional<z.ZodString>;
+    /** The full key value for `"publishable"` keys. `null` for `"secret"` keys; use `full_key` instead, which is returned only at creation time. */
+    key_value: z.ZodOptional<z.ZodString>;
+    /** When this key was last used to authenticate a request. `null` if the key has never been used. */
+    last_used_at: z.ZodOptional<z.ZodString>;
+    /** Current lifecycle status of the key. One of `"active"` (usable) or `"revoked"` (permanently disabled). */
+    status: z.ZodString;
+    /** The kind of key. One of `"publishable"` (safe for client-side use) or `"secret"` (server-side only). */
+    type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    status: string;
+    id: string;
+    created_at?: string | undefined;
+    expires_at?: string | undefined;
+    full_key?: string | undefined;
+    key_hint?: string | undefined;
+    key_value?: string | undefined;
+    last_used_at?: string | undefined;
+}, {
+    type: string;
+    status: string;
+    id: string;
+    created_at?: string | undefined;
+    expires_at?: string | undefined;
+    full_key?: string | undefined;
+    key_hint?: string | undefined;
+    key_value?: string | undefined;
+    last_used_at?: string | undefined;
+}>;
+/** An isolated developer sandbox environment used for testing integrations without affecting production data or sending real emails. */
+export interface Sandbox {
+    /** When this sandbox was created (ISO 8601). */
+    created_at?: string | undefined;
+    /** When an eval sandbox expires and becomes eligible for platform cleanup. `null` for ordinary developer sandboxes. */
+    expires_at?: string | undefined;
+    /** Sandbox ID (`dsb_...`). */
+    id: string;
+    /** API keys associated with this sandbox. `null` if keys were not loaded with this response. */
+    keys?: SandboxKey[] | undefined;
+    /** Human-readable display name for the sandbox. */
+    name: string;
+    /** Organization ID this sandbox is scoped to, or `null` for an app-level sandbox. */
+    org?: string | undefined;
+    /** Logo of the owning organization, when present. */
+    org_logo?: ImageSource | undefined;
+    /** Display name of the owning organization, when org-scoped. */
+    org_name?: string | undefined;
+    /** Sandbox purpose marker. `"eval"` marks a remote-eval sandbox; `null` for ordinary developer sandboxes. */
+    purpose?: string | undefined;
+    /** URL-safe identifier for the sandbox, unique within the application (e.g. `"my-sandbox"`). */
+    slug: string;
+    /** When this sandbox was last modified (ISO 8601). */
+    updated_at?: string | undefined;
+}
+/** Runtime validator for {@link Sandbox}. */
+export declare const sandboxSchema: z.ZodObject<{
+    /** When this sandbox was created (ISO 8601). */
+    created_at: z.ZodOptional<z.ZodString>;
+    /** When an eval sandbox expires and becomes eligible for platform cleanup. `null` for ordinary developer sandboxes. */
+    expires_at: z.ZodOptional<z.ZodString>;
+    /** Sandbox ID (`dsb_...`). */
+    id: z.ZodString;
+    /** API keys associated with this sandbox. `null` if keys were not loaded with this response. */
+    keys: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** When this key was created (ISO 8601). */
+        created_at: z.ZodOptional<z.ZodString>;
+        /** When this key expires and becomes invalid. `null` if the key does not expire. */
+        expires_at: z.ZodOptional<z.ZodString>;
+        /** The complete secret key value, returned only once when the key is first created. `null` on subsequent retrievals. */
+        full_key: z.ZodOptional<z.ZodString>;
+        /** Sandbox key ID (`dsk_...`). */
+        id: z.ZodString;
+        /** A short hint showing the last four characters of the key, used for identification. `null` if no hint is available. */
+        key_hint: z.ZodOptional<z.ZodString>;
+        /** The full key value for `"publishable"` keys. `null` for `"secret"` keys; use `full_key` instead, which is returned only at creation time. */
+        key_value: z.ZodOptional<z.ZodString>;
+        /** When this key was last used to authenticate a request. `null` if the key has never been used. */
+        last_used_at: z.ZodOptional<z.ZodString>;
+        /** Current lifecycle status of the key. One of `"active"` (usable) or `"revoked"` (permanently disabled). */
+        status: z.ZodString;
+        /** The kind of key. One of `"publishable"` (safe for client-side use) or `"secret"` (server-side only). */
+        type: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        status: string;
+        id: string;
+        created_at?: string | undefined;
+        expires_at?: string | undefined;
+        full_key?: string | undefined;
+        key_hint?: string | undefined;
+        key_value?: string | undefined;
+        last_used_at?: string | undefined;
+    }, {
+        type: string;
+        status: string;
+        id: string;
+        created_at?: string | undefined;
+        expires_at?: string | undefined;
+        full_key?: string | undefined;
+        key_hint?: string | undefined;
+        key_value?: string | undefined;
+        last_used_at?: string | undefined;
+    }>, "many">>;
+    /** Human-readable display name for the sandbox. */
+    name: z.ZodString;
+    /** Organization ID this sandbox is scoped to, or `null` for an app-level sandbox. */
+    org: z.ZodOptional<z.ZodString>;
+    /** Logo of the owning organization, when present. */
+    org_logo: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        height: z.ZodOptional<z.ZodNumber>;
+        media: z.ZodOptional<z.ZodString>;
+        mime_type: z.ZodOptional<z.ZodString>;
+        refresh_url: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        mime_type?: string | undefined;
+        file?: string | undefined;
+        height?: number | undefined;
+        media?: string | undefined;
+        refresh_url?: string | undefined;
+        url?: string | undefined;
+        width?: number | undefined;
+    }, {
+        mime_type?: string | undefined;
+        file?: string | undefined;
+        height?: number | undefined;
+        media?: string | undefined;
+        refresh_url?: string | undefined;
+        url?: string | undefined;
+        width?: number | undefined;
+    }>>;
+    /** Display name of the owning organization, when org-scoped. */
+    org_name: z.ZodOptional<z.ZodString>;
+    /** Sandbox purpose marker. `"eval"` marks a remote-eval sandbox; `null` for ordinary developer sandboxes. */
+    purpose: z.ZodOptional<z.ZodString>;
+    /** URL-safe identifier for the sandbox, unique within the application (e.g. `"my-sandbox"`). */
+    slug: z.ZodString;
+    /** When this sandbox was last modified (ISO 8601). */
+    updated_at: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    slug: string;
+    org?: string | undefined;
+    keys?: {
+        type: string;
+        status: string;
+        id: string;
+        created_at?: string | undefined;
+        expires_at?: string | undefined;
+        full_key?: string | undefined;
+        key_hint?: string | undefined;
+        key_value?: string | undefined;
+        last_used_at?: string | undefined;
+    }[] | undefined;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    org_name?: string | undefined;
+    org_logo?: {
+        mime_type?: string | undefined;
+        file?: string | undefined;
+        height?: number | undefined;
+        media?: string | undefined;
+        refresh_url?: string | undefined;
+        url?: string | undefined;
+        width?: number | undefined;
+    } | undefined;
+    expires_at?: string | undefined;
+    purpose?: string | undefined;
+}, {
+    name: string;
+    id: string;
+    slug: string;
+    org?: string | undefined;
+    keys?: {
+        type: string;
+        status: string;
+        id: string;
+        created_at?: string | undefined;
+        expires_at?: string | undefined;
+        full_key?: string | undefined;
+        key_hint?: string | undefined;
+        key_value?: string | undefined;
+        last_used_at?: string | undefined;
+    }[] | undefined;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    org_name?: string | undefined;
+    org_logo?: {
+        mime_type?: string | undefined;
+        file?: string | undefined;
+        height?: number | undefined;
+        media?: string | undefined;
+        refresh_url?: string | undefined;
+        url?: string | undefined;
+        width?: number | undefined;
+    } | undefined;
+    expires_at?: string | undefined;
+    purpose?: string | undefined;
+}>;
 /** A binding that connects a Slack channel to an ArchAstro team and one or more agents, enabling those agents to receive and respond to messages in that channel. */
 export interface SlackChannelBinding {
     /** IDs of every agent attached to this binding, including legacy concierge attachments. Use `resident_agent` and `route_kind` for the effective runtime route. */
@@ -9837,6 +10406,62 @@ export declare const slackChannelBindingListResponseSchema: z.ZodObject<{
     total_count: number;
     per_page: number;
 }>;
+/** A recorded sequence of AI messages and tool interactions representing a single AI reasoning session. Trajectories are stored as structured message logs and can be replayed or inspected after execution. */
+export interface Trajectory {
+    /** When the trajectory was recorded (ISO 8601). */
+    created_at?: string | undefined;
+    /** ID of the storage file that persists the raw trajectory data (`fil_...`). `null` if the trajectory has not been written to a file. */
+    file?: string | undefined;
+    /** Trajectory ID (`trj_...`). */
+    id: string;
+    /** Serialized message log for this trajectory. Contains the ordered sequence of AI and tool messages produced during the session. */
+    messages?: Record<string, unknown> | undefined;
+    /** ID of the organization this trajectory belongs to (`org_...`). `null` for trajectories outside an org context. */
+    org?: string | undefined;
+    /** ID of the developer sandbox this trajectory is scoped to (`sbx_...`). `null` for production trajectories. */
+    sandbox?: string | undefined;
+    /** ID of the team this trajectory is scoped to (`team_...`). `null` for trajectories not associated with a team. */
+    team?: string | undefined;
+    /** When the trajectory record was last updated (ISO 8601). */
+    updated_at?: string | undefined;
+}
+/** Runtime validator for {@link Trajectory}. */
+export declare const trajectorySchema: z.ZodObject<{
+    /** When the trajectory was recorded (ISO 8601). */
+    created_at: z.ZodOptional<z.ZodString>;
+    /** ID of the storage file that persists the raw trajectory data (`fil_...`). `null` if the trajectory has not been written to a file. */
+    file: z.ZodOptional<z.ZodString>;
+    /** Trajectory ID (`trj_...`). */
+    id: z.ZodString;
+    /** Serialized message log for this trajectory. Contains the ordered sequence of AI and tool messages produced during the session. */
+    messages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** ID of the organization this trajectory belongs to (`org_...`). `null` for trajectories outside an org context. */
+    org: z.ZodOptional<z.ZodString>;
+    /** ID of the developer sandbox this trajectory is scoped to (`sbx_...`). `null` for production trajectories. */
+    sandbox: z.ZodOptional<z.ZodString>;
+    /** ID of the team this trajectory is scoped to (`team_...`). `null` for trajectories not associated with a team. */
+    team: z.ZodOptional<z.ZodString>;
+    /** When the trajectory record was last updated (ISO 8601). */
+    updated_at: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    team?: string | undefined;
+    org?: string | undefined;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    sandbox?: string | undefined;
+    file?: string | undefined;
+    messages?: Record<string, unknown> | undefined;
+}, {
+    id: string;
+    team?: string | undefined;
+    org?: string | undefined;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+    sandbox?: string | undefined;
+    file?: string | undefined;
+    messages?: Record<string, unknown> | undefined;
+}>;
 /** The result of a configuration validation check, indicating whether the config is valid and listing any errors or warnings. */
 export interface ValidationResult {
     /** List of human-readable error messages describing why validation failed. Empty or absent when `valid` is `true`. */