@agents24/node 0.1.0 → 0.2.1

package/dist/client-CnOaaCVH.d.cts

@@ -0,0 +1,1018 @@
+import { ToolInputOverrides, ContextWindow, RuntimeEvent, RunCancelResult, AttachmentUploadResult, AttachmentContentAccess, RunResumeResult, ThreadsResponse, ThreadSummaryEvent, ThreadDetail, ThreadDeleteResult, RunContext } from '@agents24/client/protocol';
+
+type Agents24SDKErrorKind = "protocol" | "network" | "http";
+type Agents24NodeErrorKind = Agents24SDKErrorKind;
+
+declare class Agents24SDKError extends Error {
+    readonly kind: Agents24SDKErrorKind;
+    readonly status?: number;
+    readonly failure?: FailureView;
+    readonly responseHeaders?: Readonly<Record<string, string>>;
+    constructor(message: string, options: {
+        kind: Agents24SDKErrorKind;
+        status?: number;
+        failure?: FailureView;
+        responseHeaders?: Readonly<Record<string, string>>;
+        cause?: unknown;
+    });
+    get code(): string | undefined;
+    get category(): string | undefined;
+    get failureId(): string | undefined;
+    get requestId(): string | undefined;
+    get retryable(): boolean;
+    get retryAfterMs(): number | undefined;
+    get details(): Readonly<Record<string, unknown>>;
+}
+
+type Agents24NodeOptions = {
+    baseUrl: string;
+    apiKey: string;
+    fetchImpl?: typeof fetch;
+};
+/** @deprecated Use Agents24NodeOptions. */
+type Agents24Options = Agents24NodeOptions;
+type RequestOptions = {
+    idempotencyKey?: string;
+    dryRun?: boolean;
+    validateOnly?: boolean;
+    requestMetadata?: Record<string, unknown>;
+};
+type BackendSessionRequestOptions = RequestOptions & {
+    dpopProof?: string;
+};
+type StreamRequestOptions = RequestOptions & {
+    signal?: AbortSignal;
+};
+type AgentStreamRequest = {
+    input?: string;
+    messages?: Array<Record<string, unknown>>;
+    attachment_ids?: string[];
+    thread_id?: string;
+    runtime_context?: Record<string, unknown>;
+    tool_inputs?: ToolInputOverrides;
+    requested_model_id?: string;
+    requested_model_node_id?: string;
+    external_user_id?: string;
+    external_session_id?: string;
+    metadata?: Record<string, unknown>;
+    client?: Record<string, unknown>;
+    node_state?: Record<string, unknown>;
+    runtime_target?: "draft" | "published";
+    agent_version_id?: string;
+};
+type StreamResult = {
+    threadId: string | null;
+    runId: string | null;
+};
+type EmbedStreamRequest = {
+    agent_version_id?: string;
+    input?: string;
+    messages?: Array<Record<string, unknown>>;
+    attachment_ids?: string[];
+    thread_id?: string;
+    runtime_context?: Record<string, unknown>;
+    tool_inputs?: ToolInputOverrides;
+    requested_model_id?: string;
+    requested_model_node_id?: string;
+    external_user_id: string;
+    external_user_issuer?: string;
+    external_session_id?: string;
+    metadata?: Record<string, unknown>;
+    client?: Record<string, unknown>;
+};
+type AttachRunRequest = {
+    external_user_id: string;
+    external_session_id?: string;
+    metadata?: Record<string, unknown>;
+    client?: Record<string, unknown>;
+    cursor?: number;
+};
+type FeedbackRating = "like" | "dislike";
+type FeedbackReason = "incorrect" | "irrelevant" | "incomplete" | "unsafe" | "citation_issue" | "other";
+type ResponseFeedback = {
+    rating: FeedbackRating;
+    reason: FeedbackReason | null;
+    comment: string | null;
+    created_at: string;
+    updated_at: string;
+};
+type ResponseFeedbackResult = {
+    run_id: string;
+    feedback: ResponseFeedback | null;
+};
+type EmbeddedResponseFeedbackInput = {
+    external_user_id: string;
+    external_session_id?: string;
+    rating: FeedbackRating | null;
+    reason?: FeedbackReason | null;
+    comment?: string | null;
+};
+type HitlAction = "approve" | "reject" | "connect" | "skip" | "respond";
+type HitlAnswer = {
+    question_id: string;
+    selected_option_ids: string[];
+    custom_text?: string;
+};
+type ResumeRunRequest = AttachRunRequest & {
+    schema_version: "agents24.hitl.resume.v2";
+    interrupt_id: string;
+    action: HitlAction;
+    comment?: string;
+    answers?: HitlAnswer[];
+};
+type McpAuthStartRequest = AttachRunRequest & {
+    interrupt_id: string;
+    callback_origin: string;
+    popup_nonce: string;
+};
+type McpAuthStartResult = {
+    authorization_url: string;
+    callback_origin: string;
+};
+type EmbedRuntimeBootstrap = {
+    version: string;
+    agent_name?: string;
+    agent_version_id?: string;
+    agent_version_number?: number;
+    features: Record<string, unknown>;
+    thread_events_path?: string | null;
+    thread_events_url?: string | null;
+};
+type MultiAgentThreadListRequest = {
+    agent_ids: string[];
+    external_user_id: string;
+    external_session_id?: string | null;
+    skip?: number;
+    limit?: number;
+};
+type ThreadListOptions = {
+    externalUserId: string;
+    externalSessionId?: string;
+    skip?: number;
+    limit?: number;
+};
+type ThreadDetailOptions = {
+    externalUserId: string;
+    externalSessionId?: string;
+    beforeTurnIndex?: number;
+    limit?: number;
+    includeSubthreads?: boolean;
+    subthreadDepth?: number;
+    subthreadTurnLimit?: number;
+    subthreadChildLimit?: number;
+};
+type RunContextOptions = {
+    externalUserId: string;
+    externalSessionId?: string;
+};
+type RunCancelOptions = {
+    externalUserId?: string;
+    externalSessionId?: string;
+    assistantOutputText?: string;
+};
+type EmbedRunCancelOptions = {
+    externalUserId?: string;
+    externalSessionId?: string;
+};
+type ThreadDeleteOptions = {
+    externalUserId: string;
+    externalSessionId?: string;
+};
+type ThreadSummaryEventOptions = {
+    externalUserId: string;
+    externalSessionId?: string | null;
+    cursor?: number | null;
+    signal?: AbortSignal;
+};
+type MultiAgentThreadSummaryEventOptions = ThreadSummaryEventOptions & {
+    agentIds: string[];
+};
+type ServerAttachmentUploadOptions = {
+    threadId?: string;
+    agentVersionId?: string;
+    files: File[];
+    idempotencyKey?: string;
+};
+type AttachmentContentAccessRequest = {
+    disposition: "inline" | "attachment";
+};
+type EmbedAttachmentContentAccessRequest = AttachmentContentAccessRequest & {
+    external_user_id: string;
+    external_session_id?: string | null;
+};
+type ServerEmbedAttachmentUploadOptions = ServerAttachmentUploadOptions & {
+    externalUserId: string;
+    externalSessionId?: string;
+};
+type GraphValueRef = {
+    namespace: "workflow_input" | "state" | "node_output";
+    key: string;
+    node_id?: string;
+    expected_type?: "string" | "number" | "boolean" | "object" | "list" | "unknown";
+    label?: string;
+};
+type WorkflowInputDefinition = {
+    key: string;
+    type: "string" | "number" | "boolean" | "object" | "list";
+    required?: boolean;
+    enabled?: boolean;
+    label?: string;
+    description?: string;
+    semantic_type?: string;
+    readonly?: boolean;
+    derived?: boolean;
+};
+type StateVariableDefinition = {
+    key: string;
+    type: "string" | "number" | "boolean" | "object" | "list";
+    description?: string;
+    schema?: Record<string, unknown>;
+    default_value?: unknown;
+};
+type GraphNode = {
+    id: string;
+    type: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    config: Record<string, unknown>;
+    label?: string;
+    data?: Record<string, unknown>;
+    input_mappings?: Record<string, string>;
+};
+type GraphEdge = {
+    id: string;
+    source: string;
+    target: string;
+    type?: "control" | "data";
+    source_handle?: string;
+    target_handle?: string;
+    label?: string;
+    condition?: string;
+};
+type GraphDefinition = {
+    spec_version: "4.0";
+    graph_type: "agent";
+    workflow_contract: {
+        inputs: WorkflowInputDefinition[];
+    };
+    state_contract: {
+        variables: StateVariableDefinition[];
+    };
+    prompt_version_policies?: Record<string, unknown>;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    metadata?: Record<string, unknown>;
+};
+type NodeCatalogItem = {
+    type: string;
+    title: string;
+    description?: string | null;
+    category: string;
+    input_type: string;
+    output_type: string;
+    required_config_fields: string[];
+    icon?: string | null;
+    color?: string | null;
+    editor?: string | null;
+};
+type BranchingHint = {
+    kind: string;
+    field?: string | null;
+    id_key?: string | null;
+    label_key?: string | null;
+    static_handles: string[];
+    default_handles: string[];
+};
+type GraphHints = {
+    editor: string;
+    branching?: BranchingHint | null;
+};
+type NodeAuthoringSpec = {
+    type: string;
+    title: string;
+    description?: string | null;
+    category: string;
+    input_type: string;
+    output_type: string;
+    config_schema: Record<string, unknown>;
+    input_schema?: Record<string, unknown> | null;
+    output_schema?: Record<string, unknown> | null;
+    field_contracts?: Record<string, unknown> | null;
+    graph_hints?: GraphHints | null;
+    node_template?: GraphNode | null;
+    normalization_defaults: Record<string, unknown>;
+};
+type NodeCatalogResponse = {
+    nodes: NodeCatalogItem[];
+};
+type NodeSchemaResponse = {
+    specs: Record<string, NodeAuthoringSpec>;
+    unknown: string[];
+    instance_contract: Record<string, unknown>;
+};
+type AgentValidationIssue = {
+    code: string;
+    message: string;
+    severity: "error" | "warning";
+    node_id?: string | null;
+    edge_id?: string | null;
+    path?: string | null;
+    expected?: unknown;
+    actual?: unknown;
+    repair_hint?: string | null;
+};
+type AgentValidationResult = {
+    valid: boolean;
+    errors: AgentValidationIssue[];
+    warnings: AgentValidationIssue[];
+};
+type AgentCreateRequest = {
+    name: string;
+    description?: string | null;
+    tags?: string[];
+    graph_definition: GraphDefinition;
+    memory_config?: Record<string, unknown>;
+    execution_constraints?: Record<string, unknown>;
+};
+type AgentUpdateRequest = Partial<AgentCreateRequest>;
+type AgentSummary = {
+    id: string;
+    organization_id: string;
+    name: string;
+    description?: string | null;
+    tags: string[];
+    lifecycle_status: "active" | "deprecated" | "archived" | "disabled";
+    publication_state: "never_published" | "published";
+    draft_revision_number: number;
+    is_public: boolean;
+    show_in_playground: boolean;
+    share_enabled: boolean;
+    share_handle?: string | null;
+    share_url?: string | null;
+    share_theme: "soft" | "sharp";
+    share_client_deployment_id?: string | null;
+    resource_policy_set_id?: string | null;
+    tool_binding_status?: string | null;
+    is_tool_enabled: boolean;
+    created_at: string;
+    updated_at: string;
+    published_at?: string | null;
+    latest_published_version_id?: string | null;
+    has_unpublished_changes: boolean;
+};
+type AgentResponse = AgentSummary & {
+    graph_definition: GraphDefinition;
+    memory_config: Record<string, unknown>;
+    execution_constraints: Record<string, unknown>;
+    attached_tools: Array<Record<string, unknown>>;
+};
+type AgentListResponse = {
+    items: Array<AgentSummary | AgentResponse>;
+    total: number;
+    has_more: boolean;
+    skip: number;
+    limit: number;
+    view: "summary" | "full";
+};
+type StartRunResult = {
+    run_id: string;
+    thread_id?: string | null;
+};
+type FailureCategory = "validation" | "authentication" | "authorization" | "not_found" | "policy" | "conflict" | "billing" | "quota" | "rate_limit" | "capacity" | "dependency" | "protocol" | "timeout" | "internal";
+type FailureView = {
+    schema_version: "agents24.failure.v1";
+    failure_id: string;
+    code: string;
+    category: FailureCategory;
+    message: string;
+    retryable: boolean;
+    request_id: string | null;
+    retry_after_ms: number | null;
+    details: Record<string, unknown>;
+};
+type RunStatus = {
+    id: string;
+    status: string;
+    result?: unknown;
+    failure?: FailureView | null;
+    checkpoint?: Record<string, unknown> | null;
+    run_usage?: Record<string, unknown>;
+    context_window?: ContextWindow | null;
+    lineage?: Record<string, unknown>;
+    pending_interrupts?: Array<Record<string, unknown>>;
+    run_tree?: Record<string, unknown>;
+};
+type ControlPlaneRunEventsResponse = {
+    events: RuntimeEvent[];
+    [key: string]: unknown;
+};
+type TraceSpanKind = "run" | "workflow_node" | "agent" | "model" | "tool";
+type TraceSpanStatus = "running" | "waiting" | "succeeded" | "failed" | "cancelled" | "skipped";
+type TraceContent = {
+    type: "messages" | "message" | "text" | "json";
+    value: unknown;
+    redacted: boolean;
+    truncated: boolean;
+};
+type TraceError = FailureView;
+type TraceSpan = {
+    id: string;
+    span_id: string;
+    parent_id?: string | null;
+    run_id: string;
+    node_id?: string | null;
+    model_invocation_id?: string | null;
+    name: string;
+    kind: TraceSpanKind;
+    status: TraceSpanStatus;
+    sequence: number;
+    input?: TraceContent | null;
+    output?: TraceContent | null;
+    attributes: Record<string, unknown>;
+    diagnostics?: Record<string, unknown> | null;
+    failure?: TraceError | null;
+    started_at: string;
+    ended_at?: string | null;
+    duration_ms?: number | null;
+};
+type TraceView = {
+    schema_version?: string | null;
+    trace_id: string;
+    root_run_id: string;
+    focus_run_id: string;
+    status: string;
+    legacy: boolean;
+    raw_events_available: boolean;
+    spans: TraceSpan[];
+    content_protection: {
+        redacted_fields: number;
+        truncated_fields: number;
+        diagnostics_included: boolean;
+    };
+};
+type RunTrace = TraceView;
+type AgentRef = string | {
+    id: string;
+};
+type LatestOrPinnedPolicy = {
+    mode: "latest_published";
+} | {
+    mode: "pinned";
+    versionId: string;
+};
+type AgentToolsetAttachment = {
+    toolset: AgentRef;
+    loadingMode?: "static" | "dynamic";
+    versionPolicy?: LatestOrPinnedPolicy;
+};
+type AgentDefinitionOptions = {
+    name: string;
+    description?: string;
+    instructions?: string;
+    model?: AgentRef;
+    tools?: AgentRef[];
+    toolsetAttachments?: AgentToolsetAttachment[];
+    knowledge?: AgentRef[];
+    memory?: Record<string, unknown>;
+    execution?: Record<string, unknown>;
+};
+type Agents24SDKSerializedError = {
+    message: string;
+    kind: Agents24SDKErrorKind;
+    status?: number;
+    details?: unknown;
+};
+type ClientAuthMode = "anonymous" | "backend_exchange" | "external_oidc";
+type NativePlatform = "react_native" | "electron" | "tauri";
+type ClientRuntimeNativeProfileInput = {
+    name: string;
+    platform: NativePlatform;
+    application_id: string;
+    redirect_uris: string[];
+    attestation_required?: boolean;
+};
+type ClientRuntimeOidcConfig = {
+    issuer: string;
+    client_id: string;
+    audience: string;
+    authorization_endpoint?: string | null;
+    token_endpoint?: string | null;
+    jwks_uri?: string | null;
+    redirect_uris?: string[];
+    algorithms?: ["RS256"];
+    max_authentication_age_seconds?: number;
+};
+type ClientRuntimePolicyInput = {
+    capabilities?: string[];
+    model_selection?: "auto" | "enabled" | "disabled" | null;
+    attachments?: {
+        enabled?: boolean;
+        max_attachments_per_turn?: number;
+        max_file_bytes?: number;
+        max_total_bytes?: number;
+        allowed_mime_types?: string[];
+        max_image_pixels?: number;
+        max_pdf_pages?: number;
+        max_extracted_characters?: number;
+    };
+    hitl?: {
+        enabled?: boolean;
+        allowed_actions?: HitlAction[];
+    };
+    mcp?: {
+        enabled?: boolean;
+        allow_anonymous?: boolean;
+    };
+    quotas?: {
+        session_mints_per_minute?: number;
+        refreshes_per_minute?: number;
+        chat_starts_per_minute?: number;
+        active_runs?: number;
+        concurrent_streams?: number;
+        upload_count_per_hour?: number;
+        upload_bytes_per_hour?: number;
+        hitl_resumes_per_minute?: number;
+        mcp_starts_per_minute?: number;
+        token_reservation_per_run?: number;
+    };
+};
+type CreateClientDeploymentRequest = {
+    agent_id: string;
+    resource_policy_set_id: string;
+    version_policy?: {
+        mode: "latest_published";
+    } | {
+        mode: "pinned";
+        version_id: string;
+    };
+    name: string;
+    description?: string | null;
+    auth_modes: ClientAuthMode[];
+    allowed_origins?: string[];
+    native_profiles?: ClientRuntimeNativeProfileInput[];
+    oidc?: ClientRuntimeOidcConfig | null;
+    policy?: ClientRuntimePolicyInput;
+};
+type UpdateClientDeploymentRequest = Partial<Omit<CreateClientDeploymentRequest, "agent_id" | "resource_policy_set_id">> & {
+    resource_policy_set_id?: string | null;
+    lifecycle_status?: "active" | "inactive";
+};
+type ClientDeploymentListQuery = {
+    agentId: string;
+    lifecycleStatus?: "active" | "inactive";
+    cursor?: string;
+    limit?: number;
+};
+type ClientNativeProfile = {
+    id: string;
+    profile_id: string;
+    name: string;
+    platform: NativePlatform;
+    application_id: string;
+    redirect_uris: string[];
+    dpop_required: boolean;
+    attestation_policy: Record<string, unknown>;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    revoked_at: string | null;
+};
+type ClientDeployment = {
+    id: string;
+    client_id: string;
+    organization_id: string;
+    agent_id: string;
+    resource_policy_set_id: string | null;
+    purpose: "client_integration" | "hosted_share";
+    version_policy: {
+        mode: "latest_published";
+    } | {
+        mode: "pinned";
+        version_id: string;
+    };
+    resolved_version: {
+        version_id: string;
+        version_number: number;
+    };
+    name: string;
+    description: string | null;
+    lifecycle_status: "active" | "inactive" | "deleted";
+    policy_epoch: number;
+    revocation_epoch: number;
+    auth_modes: ClientAuthMode[];
+    allowed_origins: string[];
+    scopes: string[];
+    capabilities: string[];
+    policy: Record<string, Record<string, unknown>>;
+    oidc: ClientRuntimeOidcConfig | null;
+    native_profiles: ClientNativeProfile[];
+    created_at: string;
+    updated_at: string;
+    deleted_at: string | null;
+};
+type ClientDeploymentListResponse = {
+    items: ClientDeployment[];
+    next_cursor: string | null;
+};
+type CreateBackendClientSessionRequest = {
+    subject: string;
+    subject_issuer?: string;
+    browser_origin?: string;
+    native_profile_id?: string;
+    requested_capabilities?: string[];
+    persistent?: boolean;
+    dpop_public_jwk?: Record<string, unknown>;
+};
+type ClientSessionCredentials = {
+    session_id: string;
+    access_token: string;
+    token_type: "Bearer" | "DPoP";
+    expires_at: string;
+    refresh_grant: string | null;
+    refresh_expires_at: string | null;
+    dpop_nonce: string | null;
+};
+type PortableResourceKind = "agent" | "rag_pipeline" | "instruction" | "knowledge_store";
+type ResourceSelector = {
+    kind: PortableResourceKind;
+    id: string;
+    target: "draft" | "version";
+    version_id?: string;
+};
+type ResourcePackageExportRequest = {
+    selectors: ResourceSelector[];
+};
+type ResourcePackageArchive = {
+    data: Uint8Array;
+    filename: string;
+};
+type ResourcePackageUpload = {
+    data: Uint8Array;
+    filename?: string;
+};
+type ResourcePackageDiagnostic = {
+    severity: "error" | "warning";
+    code: string;
+    path: string;
+    message: string;
+};
+type ResourcePackageCompileResult = {
+    valid: boolean;
+    format: "agents24.resource_package";
+    schema_version: "1.0";
+    package: Record<string, unknown>;
+    resources: Array<Record<string, unknown>>;
+    requirements: string[];
+    tool_exports: Array<Record<string, unknown>>;
+    callable_bindings: Array<Record<string, unknown>>;
+    diagnostics: ResourcePackageDiagnostic[];
+    bundle?: ResourceBundle | null;
+};
+type ResourceBundleImportRequest = {
+    bundle: ResourceBundle;
+    selected_resource_keys?: string[];
+    mappings?: Record<string, string>;
+};
+type ResourceBundleOrigin = {
+    source_id: string;
+    target: "draft" | "version";
+    version_id?: string | null;
+    label: string;
+};
+type ResourceBundleResource = {
+    resource_key: string;
+    kind: PortableResourceKind;
+    name: string;
+    document: Record<string, unknown>;
+    origin?: ResourceBundleOrigin;
+};
+type ResourceBundleDependency = {
+    id: string;
+    from_resource_key: string;
+    to_resource_key?: string | null;
+    kind: string;
+    source_id: string;
+    source_name?: string | null;
+    document_path: string;
+    reference_type: string;
+    required: boolean;
+    bundled: boolean;
+    included?: boolean;
+    required_capability?: "chat" | "embedding";
+};
+type ResourceBundle = {
+    format: "agents24.resource_bundle";
+    schema_version: "1.0";
+    exported_at?: string;
+    resources: ResourceBundleResource[];
+    dependencies: ResourceBundleDependency[];
+    warnings: string[];
+    tool_exports?: Array<Record<string, unknown>>;
+    callable_bindings?: Array<Record<string, unknown>>;
+};
+type ResourceBundlePlan = Omit<ResourceBundle, "resources"> & {
+    resources: Array<Omit<ResourceBundleResource, "document">>;
+    blockers: Array<{
+        code: string;
+        message: string;
+    }>;
+    can_export: boolean;
+    external_references: ResourceBundleDependency[];
+};
+type ResourceBundleExportRequest = {
+    selectors: ResourceSelector[];
+    included_resource_keys?: string[];
+};
+type ResourceBundleCandidateList = {
+    items: Array<{
+        id: string;
+        name: string;
+    }>;
+    total: number;
+};
+type ResourceBundleCandidateOptions = {
+    kind: string;
+    query?: string;
+    limit?: number;
+    offset?: number;
+    requiredCapability?: "chat" | "embedding";
+};
+type ResourcePolicySummary = {
+    id: string;
+    name: string;
+    is_active: boolean;
+    [key: string]: unknown;
+};
+type ResourcePolicyList = ResourcePolicySummary[];
+type CustomerIdentityRequest = {
+    issuer: string;
+    subject: string;
+};
+type SetCustomerResourcePolicyAssignmentRequest = CustomerIdentityRequest & {
+    policy_set_id: string;
+};
+type EffectiveCustomerResourcePolicyRequest = CustomerIdentityRequest & {
+    deployment_id: string;
+};
+type ResourcePolicySubjectRef = {
+    kind: "agent" | "client_deployment" | "organization_user" | "customer_principal";
+    id: string;
+};
+type ResourcePolicyQuotaSchedule = {
+    reset_anchor_at: string | null;
+    period_start: string;
+    next_reset_at: string;
+};
+type CustomerResourcePolicyAssignment = {
+    customer_principal_ref: string;
+    subject_ref: ResourcePolicySubjectRef;
+    assignment: {
+        id: string;
+        policy_set: {
+            id: string;
+            name: string;
+        };
+    } | null;
+    quota_schedule: ResourcePolicyQuotaSchedule | null;
+};
+type ClearCustomerResourcePolicyAssignmentResult = {
+    customer_principal_ref: string | null;
+    cleared: boolean;
+};
+type EffectiveResourcePolicy = {
+    customer_principal_ref: string | null;
+    model_selection: {
+        selectable: boolean;
+        node_id: string | null;
+        default_id: string | null;
+        options: Array<{
+            id: string;
+            label: string;
+        }>;
+    };
+    quota_constraints: Array<{
+        model: {
+            id: string;
+            name: string;
+        };
+        boundary_kind: ResourcePolicySubjectRef["kind"];
+        boundary_ref: string;
+        used: number;
+        reserved: number;
+        limit: number;
+        remaining: number;
+        period_start: string;
+        reset_at: string;
+        blocked: boolean;
+    }>;
+    customer_assignment?: CustomerResourcePolicyAssignment;
+};
+type SetResourcePolicyQuotaScheduleRequest = {
+    subject_ref: ResourcePolicySubjectRef;
+    reset_anchor_at: string | null;
+};
+type ResetResourcePolicyQuotaRequest = {
+    subject_ref: ResourcePolicySubjectRef;
+};
+type ResourcePolicyQuotaScheduleResult = {
+    subject_ref: ResourcePolicySubjectRef;
+    quota_schedule: ResourcePolicyQuotaSchedule;
+};
+type ResourceBundleImportPreview = {
+    resources: Array<Record<string, unknown>>;
+    dependencies: Array<Record<string, unknown>>;
+    warnings: unknown[];
+    blockers: unknown[];
+    can_import: boolean;
+    [key: string]: unknown;
+};
+type ResourceBundleImportResult = {
+    status: "created";
+    resources: Array<Record<string, unknown>>;
+    id_map: Record<string, string>;
+    warnings: unknown[];
+};
+
+type RequestConfig = {
+    method?: string;
+    query?: Record<string, unknown>;
+    body?: unknown;
+    headers?: HeadersInit;
+    options?: RequestOptions;
+    mutation?: boolean;
+};
+declare class Agents24HttpClient {
+    private readonly base;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    constructor(options: Agents24NodeOptions);
+    url(requestPath: string, query?: Record<string, unknown>): string;
+    jsonHeaders(extra?: HeadersInit, options?: RequestOptions, mutation?: boolean): HeadersInit;
+    streamHeaders(extra?: HeadersInit, options?: RequestOptions, mutation?: boolean): HeadersInit;
+    multipartHeaders(extra?: HeadersInit, options?: RequestOptions, mutation?: boolean): HeadersInit;
+    requestJson<T>(requestPath: string, config?: RequestConfig): Promise<T>;
+    fetchOrThrow(url: string, init: RequestInit, message: string): Promise<Response>;
+}
+
+type ListAgentsOptions = {
+    status?: string;
+    skip?: number;
+    limit?: number;
+    view?: "summary" | "full" | string;
+};
+declare class AgentsNamespace {
+    private readonly http;
+    constructor(http: Agents24HttpClient);
+    list(options?: ListAgentsOptions): Promise<AgentListResponse>;
+    get(agentId: string): Promise<AgentResponse>;
+    create(request: AgentCreateRequest, options?: RequestOptions): Promise<AgentResponse>;
+    update(agentId: string, request: AgentUpdateRequest, options?: RequestOptions): Promise<AgentResponse>;
+    updateGraph(agentId: string, graph: GraphDefinition, options?: RequestOptions): Promise<AgentResponse>;
+    delete(agentId: string, options?: RequestOptions): Promise<unknown>;
+    catalog(): Promise<NodeCatalogResponse>;
+    schema(nodeTypes: string[]): Promise<NodeSchemaResponse>;
+    validate(agentId: string): Promise<AgentValidationResult>;
+    publish(agentId: string, options?: RequestOptions): Promise<AgentResponse>;
+    startRun(agentId: string, payload: AgentStreamRequest, options?: RequestOptions): Promise<StartRunResult>;
+    stream(agentId: string, payload: AgentStreamRequest, onEvent?: (event: RuntimeEvent) => void | Promise<void>, mode?: "debug" | "production" | string, options?: StreamRequestOptions): Promise<StreamResult>;
+    resumeRun(runId: string, payload: Record<string, unknown>, options?: RequestOptions): Promise<Record<string, unknown>>;
+    cancelRun(runId: string, options?: RunCancelOptions): Promise<RunCancelResult>;
+    uploadAttachments(agentId: string, options: ServerAttachmentUploadOptions): Promise<AttachmentUploadResult>;
+    createAttachmentContentAccess(agentId: string, attachmentId: string, request: AttachmentContentAccessRequest, options?: RequestOptions): Promise<AttachmentContentAccess>;
+}
+
+declare class AgentDefinitionBuilder {
+    private readonly agents;
+    private readonly options;
+    constructor(agents: AgentsNamespace, options: AgentDefinitionOptions);
+    toGraph(): GraphDefinition;
+    toCreateRequest(): AgentCreateRequest;
+    create(options?: RequestOptions): Promise<AgentResponse>;
+}
+declare class GraphBuilder {
+    private readonly nodes;
+    private readonly edges;
+    node(type: string, config?: Record<string, unknown>, options?: {
+        id?: string;
+        x?: number;
+        y?: number;
+        label?: string;
+    }): GraphNode;
+    connect(source: GraphNode | string, target: GraphNode | string, options?: {
+        id?: string;
+        sourceHandle?: string;
+        targetHandle?: string;
+        type?: "control" | "data";
+        condition?: string;
+    }): this;
+    toGraph(): GraphDefinition;
+}
+
+declare class ClientDeploymentsNamespace {
+    private readonly http;
+    constructor(http: Agents24HttpClient);
+    create(request: CreateClientDeploymentRequest, options?: RequestOptions): Promise<ClientDeployment>;
+    list(query: ClientDeploymentListQuery): Promise<ClientDeploymentListResponse>;
+    get(deploymentId: string): Promise<ClientDeployment>;
+    update(deploymentId: string, request: UpdateClientDeploymentRequest, options?: RequestOptions): Promise<ClientDeployment>;
+    delete(deploymentId: string, options?: RequestOptions): Promise<ClientDeployment>;
+}
+declare class ClientSessionsNamespace {
+    private readonly http;
+    constructor(http: Agents24HttpClient);
+    createBackendSession(deploymentId: string, request: CreateBackendClientSessionRequest, options?: BackendSessionRequestOptions): Promise<ClientSessionCredentials>;
+}
+
+declare class EmbedNamespace {
+    private readonly http;
+    constructor(http: Agents24HttpClient);
+    streamAgent(agentId: string, payload: EmbedStreamRequest, onEvent?: (event: RuntimeEvent) => void | Promise<void>, options?: StreamRequestOptions): Promise<StreamResult>;
+    attachAgentRun(agentId: string, runId: string, payload: AttachRunRequest, onEvent?: (event: RuntimeEvent) => void | Promise<void>, options?: StreamRequestOptions): Promise<StreamResult>;
+    private stream;
+    resumeAgentRun(agentId: string, runId: string, payload: ResumeRunRequest, options?: RequestOptions): Promise<RunResumeResult>;
+    startAgentRunMcpAuth(agentId: string, runId: string, serverId: string, payload: McpAuthStartRequest, options?: RequestOptions): Promise<McpAuthStartResult>;
+    getRuntimeBootstrap(agentId: string, agentVersionId?: string): Promise<EmbedRuntimeBootstrap>;
+    listAgentThreads(agentId: string, options: ThreadListOptions): Promise<ThreadsResponse>;
+    listAgentThreadsMulti(options: MultiAgentThreadListRequest): Promise<ThreadsResponse>;
+    subscribeAgentThreadEvents(agentId: string, options: ThreadSummaryEventOptions, onEvent: (event: ThreadSummaryEvent) => void | Promise<void>): Promise<void>;
+    subscribeAgentThreadEventsMulti(options: MultiAgentThreadSummaryEventOptions, onEvent: (event: ThreadSummaryEvent) => void | Promise<void>): Promise<void>;
+    getAgentThread(agentId: string, threadId: string, options: ThreadDetailOptions): Promise<ThreadDetail>;
+    deleteAgentThread(agentId: string, threadId: string, options: ThreadDeleteOptions, requestOptions?: RequestOptions): Promise<ThreadDeleteResult>;
+    getAgentRunContext(agentId: string, runId: string, options: RunContextOptions): Promise<RunContext>;
+    cancelAgentRun(agentId: string, runId: string, options: EmbedRunCancelOptions, requestOptions?: RequestOptions): Promise<RunCancelResult>;
+    setAgentRunFeedback(agentId: string, runId: string, payload: EmbeddedResponseFeedbackInput): Promise<ResponseFeedbackResult>;
+    uploadAgentAttachments(agentId: string, options: ServerEmbedAttachmentUploadOptions): Promise<AttachmentUploadResult>;
+    createAttachmentContentAccess(agentId: string, attachmentId: string, request: EmbedAttachmentContentAccessRequest, options?: RequestOptions): Promise<AttachmentContentAccess>;
+}
+
+declare class ResourceBundlesNamespace {
+    protected readonly http: Agents24HttpClient;
+    constructor(http: Agents24HttpClient);
+    exportPlan(request: ResourceBundleExportRequest): Promise<ResourceBundlePlan>;
+    exportBundle(request: ResourceBundleExportRequest): Promise<ResourceBundle>;
+    candidates(options: ResourceBundleCandidateOptions): Promise<ResourceBundleCandidateList>;
+    importPreview(request: ResourceBundleImportRequest): Promise<ResourceBundleImportPreview>;
+    importBundle(request: ResourceBundleImportRequest, options?: RequestOptions): Promise<ResourceBundleImportResult>;
+}
+
+declare class ResourcePackagesNamespace {
+    protected readonly http: Agents24HttpClient;
+    constructor(http: Agents24HttpClient);
+    exportPackage(request: ResourcePackageExportRequest): Promise<ResourcePackageArchive>;
+    validatePackage(upload: ResourcePackageUpload): Promise<ResourcePackageCompileResult>;
+    compilePackage(upload: ResourcePackageUpload): Promise<ResourcePackageCompileResult>;
+}
+
+declare class RunsNamespace {
+    private readonly http;
+    constructor(http: Agents24HttpClient);
+    get(runId: string, options?: {
+        includeTree?: boolean;
+    }): Promise<RunStatus>;
+    getTree(runId: string): Promise<Record<string, unknown>>;
+    getEvents(runId: string, options?: {
+        afterSequence?: number;
+        limit?: number;
+    }): Promise<ControlPlaneRunEventsResponse>;
+    getContext(runId: string): Promise<RunContext>;
+    getTrace(runId: string, options?: {
+        includeDiagnostics?: boolean;
+    }): Promise<TraceView>;
+}
+
+declare class InstructionsNamespace {
+    protected readonly http: Agents24HttpClient;
+    constructor(http: Agents24HttpClient);
+    publish(instructionId: string, options?: RequestOptions): Promise<Record<string, unknown>>;
+}
+
+declare class ResourcePoliciesNamespace {
+    protected readonly http: Agents24HttpClient;
+    constructor(http: Agents24HttpClient);
+    list(): Promise<ResourcePolicyList>;
+    setCustomerAssignment(request: SetCustomerResourcePolicyAssignmentRequest, options?: RequestOptions): Promise<CustomerResourcePolicyAssignment>;
+    getCustomerAssignment(request: CustomerIdentityRequest): Promise<CustomerResourcePolicyAssignment>;
+    clearCustomerAssignment(request: CustomerIdentityRequest, options?: RequestOptions): Promise<ClearCustomerResourcePolicyAssignmentResult>;
+    getEffectiveCustomerPolicy(request: EffectiveCustomerResourcePolicyRequest): Promise<EffectiveResourcePolicy>;
+    setQuotaSchedule(request: SetResourcePolicyQuotaScheduleRequest, options?: RequestOptions): Promise<ResourcePolicyQuotaScheduleResult>;
+    resetQuotaNow(request: ResetResourcePolicyQuotaRequest, options?: RequestOptions): Promise<ResourcePolicyQuotaScheduleResult>;
+}
+
+declare class Agents24 {
+    readonly agents: AgentsNamespace;
+    readonly embed: EmbedNamespace;
+    readonly runs: RunsNamespace;
+    readonly resourceBundles: ResourceBundlesNamespace;
+    readonly resourcePackages: ResourcePackagesNamespace;
+    readonly clientDeployments: ClientDeploymentsNamespace;
+    readonly clientSessions: ClientSessionsNamespace;
+    readonly instructions: InstructionsNamespace;
+    readonly resourcePolicies: ResourcePoliciesNamespace;
+    constructor(options: Agents24NodeOptions);
+    agent(options: AgentDefinitionOptions): AgentDefinitionBuilder;
+    graph(): GraphBuilder;
+}
+
+export { type GraphNode as $, Agents24 as A, type BackendSessionRequestOptions as B, type ClearCustomerResourcePolicyAssignmentResult as C, type ClientRuntimeNativeProfileInput as D, type ClientRuntimeOidcConfig as E, type ClientRuntimePolicyInput as F, type ClientSessionCredentials as G, type ControlPlaneRunEventsResponse as H, type CreateBackendClientSessionRequest as I, type CreateClientDeploymentRequest as J, type CustomerIdentityRequest as K, type CustomerResourcePolicyAssignment as L, type EffectiveCustomerResourcePolicyRequest as M, type EffectiveResourcePolicy as N, type EmbedAttachmentContentAccessRequest as O, type EmbedRunCancelOptions as P, type EmbedRuntimeBootstrap as Q, type EmbedStreamRequest as R, type EmbeddedResponseFeedbackInput as S, type FailureCategory as T, type FailureView as U, type FeedbackRating as V, type FeedbackReason as W, GraphBuilder as X, type GraphDefinition as Y, type GraphEdge as Z, type GraphHints as _, type AgentCreateRequest as a, type UpdateClientDeploymentRequest as a$, type GraphValueRef as a0, type HitlAction as a1, type HitlAnswer as a2, type LatestOrPinnedPolicy as a3, type McpAuthStartRequest as a4, type McpAuthStartResult as a5, type MultiAgentThreadListRequest as a6, type MultiAgentThreadSummaryEventOptions as a7, type NativePlatform as a8, type NodeAuthoringSpec as a9, type ResourcePolicySummary as aA, type ResourceSelector as aB, type ResponseFeedback as aC, type ResponseFeedbackResult as aD, type ResumeRunRequest as aE, type RunCancelOptions as aF, type RunContextOptions as aG, type RunStatus as aH, type RunTrace as aI, type ServerAttachmentUploadOptions as aJ, type ServerEmbedAttachmentUploadOptions as aK, type SetCustomerResourcePolicyAssignmentRequest as aL, type SetResourcePolicyQuotaScheduleRequest as aM, type StartRunResult as aN, type StateVariableDefinition as aO, type StreamRequestOptions as aP, type StreamResult as aQ, type ThreadDeleteOptions as aR, type ThreadDetailOptions as aS, type ThreadListOptions as aT, type ThreadSummaryEventOptions as aU, type TraceContent as aV, type TraceError as aW, type TraceSpan as aX, type TraceSpanKind as aY, type TraceSpanStatus as aZ, type TraceView as a_, type NodeCatalogItem as aa, type NodeCatalogResponse as ab, type NodeSchemaResponse as ac, type PortableResourceKind as ad, type RequestOptions as ae, type ResetResourcePolicyQuotaRequest as af, type ResourceBundle as ag, type ResourceBundleCandidateList as ah, type ResourceBundleCandidateOptions as ai, type ResourceBundleDependency as aj, type ResourceBundleExportRequest as ak, type ResourceBundleImportPreview as al, type ResourceBundleImportRequest as am, type ResourceBundleImportResult as an, type ResourceBundleOrigin as ao, type ResourceBundlePlan as ap, type ResourceBundleResource as aq, type ResourcePackageArchive as ar, type ResourcePackageCompileResult as as, type ResourcePackageDiagnostic as at, type ResourcePackageExportRequest as au, type ResourcePackageUpload as av, type ResourcePolicyList as aw, type ResourcePolicyQuotaSchedule as ax, type ResourcePolicyQuotaScheduleResult as ay, type ResourcePolicySubjectRef as az, AgentDefinitionBuilder as b, type WorkflowInputDefinition as b0, type AgentDefinitionOptions as c, type AgentListResponse as d, type AgentRef as e, type AgentResponse as f, type AgentStreamRequest as g, type AgentSummary as h, type AgentToolsetAttachment as i, type AgentUpdateRequest as j, type AgentValidationIssue as k, type AgentValidationResult as l, Agents24SDKError as m, type Agents24NodeErrorKind as n, type Agents24NodeOptions as o, type Agents24Options as p, type Agents24SDKErrorKind as q, type Agents24SDKSerializedError as r, type AttachRunRequest as s, type AttachmentContentAccessRequest as t, type BranchingHint as u, type ClientAuthMode as v, type ClientDeployment as w, type ClientDeploymentListQuery as x, type ClientDeploymentListResponse as y, type ClientNativeProfile as z };