@agents24/node 0.3.0 → 0.5.0

package/dist/types/types.d.ts

@@ -52,10 +52,11 @@ export type EmbedStreamRequest = {
     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>;
+    runtime_target?: "draft" | "published";
+    integration_id: string;
 };
 export type AttachRunRequest = {
     external_user_id: string;
@@ -63,6 +64,8 @@ export type AttachRunRequest = {
     metadata?: Record<string, unknown>;
     client?: Record<string, unknown>;
     cursor?: number;
+    runtime_target?: "draft" | "published";
+    integration_id: string;
 };
 export type FeedbackRating = "like" | "dislike";
 export type FeedbackReason = "incorrect" | "irrelevant" | "incomplete" | "unsafe" | "citation_issue" | "other";
@@ -83,6 +86,8 @@ export type EmbeddedResponseFeedbackInput = {
     rating: FeedbackRating | null;
     reason?: FeedbackReason | null;
     comment?: string | null;
+    runtime_target?: "draft" | "published";
+    integration_id: string;
 };
 export type HitlAction = "approve" | "reject" | "connect" | "skip" | "respond";
 export type HitlAnswer = {
@@ -108,39 +113,56 @@ export type McpAuthStartResult = {
 };
 export type EmbedRuntimeBootstrap = {
     version: string;
-    agent_name?: string;
+    agent_id: string;
+    agent_name: string;
+    agent_alias: string;
+    agent_aliases: string[];
     agent_version_id?: string;
     agent_version_number?: number;
     features: Record<string, unknown>;
     thread_events_path?: string | null;
     thread_events_url?: string | null;
 };
+export type EmbedAgentAliasResolution = {
+    agent_id: string;
+    agent_name: string;
+    agent_alias: string;
+    agent_aliases: string[];
+};
 export type MultiAgentThreadListRequest = {
     agent_ids: string[];
     external_user_id: string;
     external_session_id?: string | null;
+    runtime_target?: "draft" | "published";
+    integration_id: string;
     skip?: number;
     limit?: number;
 };
 export type ThreadListOptions = {
     externalUserId: string;
     externalSessionId?: string;
+    runtimeTarget?: "draft" | "published";
+    integrationId: string;
     skip?: number;
     limit?: number;
 };
 export type ThreadDetailOptions = {
     externalUserId: string;
     externalSessionId?: string;
+    runtimeTarget?: "draft" | "published";
     beforeTurnIndex?: number;
     limit?: number;
     includeSubthreads?: boolean;
     subthreadDepth?: number;
     subthreadTurnLimit?: number;
     subthreadChildLimit?: number;
+    integrationId: string;
 };
 export type RunContextOptions = {
     externalUserId: string;
     externalSessionId?: string;
+    runtimeTarget?: "draft" | "published";
+    integrationId: string;
 };
 export type RunCancelOptions = {
     externalUserId?: string;
@@ -150,20 +172,62 @@ export type RunCancelOptions = {
 export type EmbedRunCancelOptions = {
     externalUserId?: string;
     externalSessionId?: string;
+    runtimeTarget?: "draft" | "published";
+    integrationId: string;
 };
 export type ThreadDeleteOptions = {
     externalUserId: string;
     externalSessionId?: string;
+    runtimeTarget?: "draft" | "published";
+    integrationId: string;
 };
 export type ThreadSummaryEventOptions = {
     externalUserId: string;
     externalSessionId?: string | null;
     cursor?: number | null;
     signal?: AbortSignal;
+    runtimeTarget?: "draft" | "published";
+    integrationId: string;
 };
 export type MultiAgentThreadSummaryEventOptions = ThreadSummaryEventOptions & {
     agentIds: string[];
 };
+export type ConversationThreadOptions = ThreadDetailOptions & {
+    agentIds: string[];
+    integrationId: string;
+};
+export type ConversationRuntimeSelectionRequest = {
+    agent_ids: string[];
+    preferred_agent_id: string;
+    preferred_model_id?: string | null;
+    external_user_id: string;
+    external_session_id?: string | null;
+    integration_id: string;
+    runtime_target?: "draft" | "published";
+};
+export type ConversationRuntimeSelectionResult = {
+    runtime_selection: {
+        agent_id: string;
+        model_id: string | null;
+    };
+    models: {
+        default_id: string | null;
+        options: Array<{
+            id: string;
+            label: string;
+        }>;
+    };
+};
+export type ConversationRunRequest = {
+    agent_ids: string[];
+    external_user_id: string;
+    external_session_id?: string | null;
+    integration_id: string;
+    runtime_target?: "draft" | "published";
+};
+export type ConversationRunResult = {
+    agent_id: string;
+};
 export type ServerAttachmentUploadOptions = {
     threadId?: string;
     agentVersionId?: string;
@@ -176,10 +240,14 @@ export type AttachmentContentAccessRequest = {
 export type EmbedAttachmentContentAccessRequest = AttachmentContentAccessRequest & {
     external_user_id: string;
     external_session_id?: string | null;
+    runtime_target?: "draft" | "published";
+    integration_id: string;
 };
 export type ServerEmbedAttachmentUploadOptions = ServerAttachmentUploadOptions & {
     externalUserId: string;
     externalSessionId?: string;
+    runtimeTarget?: "draft" | "published";
+    integrationId: string;
 };
 export type GraphValueRef = {
     namespace: "workflow_input" | "state" | "node_output";
@@ -307,6 +375,7 @@ export type AgentValidationResult = {
 };
 export type AgentCreateRequest = {
     name: string;
+    aliases?: string[];
     description?: string | null;
     tags?: string[];
     graph_definition: GraphDefinition;
@@ -318,6 +387,7 @@ export type AgentSummary = {
     id: string;
     organization_id: string;
     name: string;
+    aliases: string[];
     description?: string | null;
     tags: string[];
     lifecycle_status: "active" | "deprecated" | "archived" | "disabled";
@@ -611,7 +681,7 @@ export type ClientSessionCredentials = {
     refresh_expires_at: string | null;
     dpop_nonce: string | null;
 };
-export type PortableResourceKind = "agent" | "rag_pipeline" | "instruction" | "knowledge_store";
+export type PortableResourceKind = "agent" | "rag_pipeline" | "instruction" | "knowledge_store" | "artifact";
 export type ResourceSelector = {
     kind: PortableResourceKind;
     id: string;
@@ -629,44 +699,81 @@ export type ResourcePackageUpload = {
     data: Uint8Array;
     filename?: string;
 };
+export type ResourcePackageImportUpload = ResourcePackageUpload & {
+    mappings?: Record<string, string>;
+};
+export type ResourceInstallationPlanUpload = ResourcePackageUpload & {
+    prune?: boolean;
+};
+export type ResourceInstallationPullChange = {
+    status: "A" | "M" | "D";
+    path: string;
+};
+export type ResourceInstallationPullPlan = {
+    pull_id: string;
+    installation_id: string;
+    status: "planned" | "completed";
+    platform_snapshot_hash: string;
+    package_hash: string;
+    plan: {
+        summary: Record<string, number>;
+        files: ResourceInstallationPullChange[];
+        resources: Array<Record<string, unknown>>;
+    };
+    completed_at?: string | null;
+};
+export type ResourceInstallationPullPayload = {
+    pull_id: string;
+    platform_snapshot_hash: string;
+    package_hash: string;
+    files: Record<string, string>;
+};
+export type ResourceInstallationPullAcceptRequest = {
+    platform_snapshot_hash: string;
+    package_hash: string;
+};
 export type ResourcePackageDiagnostic = {
     severity: "error" | "warning";
     code: string;
     path: string;
     message: string;
 };
-export type ResourcePackageCompileResult = {
+export type ResourceToolExport = {
+    source_resource_key: string;
+    source_kind: "agent" | "rag_pipeline";
+    key?: string;
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+    output_schema: Record<string, unknown>;
+    session?: "fresh" | "persistent" | "shared";
+};
+export type ResourceCallableBinding = {
+    consumer_resource_key: string;
+    consumer_node_id: string;
+    source_resource_key: string;
+    source_kind: "agent" | "rag_pipeline" | "artifact";
+    tool_title?: string;
+    description?: string;
+    source_tool_id?: string;
+    export_key?: string;
+    loading_mode?: "static" | "dynamic";
+};
+export type ResourcePackageValidationResult = {
     valid: boolean;
+    package_hash?: string;
     format: "agents24.resource_package";
-    schema_version: "1.0";
+    schema_version: "2.0";
     package: Record<string, unknown>;
     resources: Array<Record<string, unknown>>;
     requirements: string[];
-    tool_exports: Array<Record<string, unknown>>;
-    callable_bindings: Array<Record<string, unknown>>;
+    tool_exports: ResourceToolExport[];
+    callable_bindings: ResourceCallableBinding[];
     diagnostics: ResourcePackageDiagnostic[];
-    bundle?: ResourceBundle | null;
-};
-export type ResourceBundleImportRequest = {
-    bundle: ResourceBundle;
-    selected_resource_keys?: string[];
-    mappings?: Record<string, string>;
-};
-export type ResourceBundleOrigin = {
-    source_id: string;
-    target: "draft" | "version";
-    version_id?: string | null;
-    label: string;
-};
-export type ResourceBundleResource = {
-    resource_key: string;
-    kind: PortableResourceKind;
-    name: string;
-    document: Record<string, unknown>;
-    origin?: ResourceBundleOrigin;
 };
-export type ResourceBundleDependency = {
+export type ResourcePackageDependency = {
     id: string;
+    requirement_key?: string | null;
     from_resource_key: string;
     to_resource_key?: string | null;
     kind: string;
@@ -678,44 +785,243 @@ export type ResourceBundleDependency = {
     bundled: boolean;
     included?: boolean;
     required_capability?: "chat" | "embedding";
+    status?: "bundled" | "mapped" | "unresolved";
+    mapped_id?: string | null;
+    suggested_mapping?: {
+        id: string;
+        name: string;
+    } | null;
 };
-export type ResourceBundle = {
-    format: "agents24.resource_bundle";
-    schema_version: "1.0";
-    exported_at?: string;
-    resources: ResourceBundleResource[];
-    dependencies: ResourceBundleDependency[];
+export type ResourcePackageExportPlan = {
+    format: "agents24.resource_package";
+    schema_version: "2.0";
+    selected_roots: ResourceSelector[];
+    resources: Array<{
+        resource_key: string;
+        kind: PortableResourceKind;
+        name: string;
+    }>;
+    external_requirements: Array<{
+        requirement_key: string | null;
+        kind: string;
+        name?: string | null;
+        required: boolean;
+        required_capability?: "chat" | "embedding";
+    }>;
     warnings: string[];
-    tool_exports?: Array<Record<string, unknown>>;
-    callable_bindings?: Array<Record<string, unknown>>;
-};
-export type ResourceBundlePlan = Omit<ResourceBundle, "resources"> & {
-    resources: Array<Omit<ResourceBundleResource, "document">>;
     blockers: Array<{
         code: string;
         message: string;
     }>;
     can_export: boolean;
-    external_references: ResourceBundleDependency[];
 };
-export type ResourceBundleExportRequest = {
-    selectors: ResourceSelector[];
-    included_resource_keys?: string[];
+export type ResourcePackageImportPreview = {
+    format: "agents24.resource_package";
+    schema_version: "2.0";
+    package: Record<string, unknown>;
+    package_hash: string;
+    resources: Array<{
+        resource_key: string;
+        kind: PortableResourceKind;
+        name: string;
+        status: "ready" | "incomplete";
+        incomplete_reasons: Array<{
+            dependency_id: string;
+            kind: string;
+            message: string;
+        }>;
+    }>;
+    dependencies: ResourcePackageDependency[];
+    suggested_mappings: Array<{
+        dependency_id: string;
+        id: string;
+        name: string;
+    }>;
+    warnings: string[];
+    blockers: Array<{
+        code: string;
+        message: string;
+    }>;
+    can_import: boolean;
+};
+export type ResourcePackageImportResult = {
+    format: "agents24.resource_package";
+    schema_version: "2.0";
+    package_hash: string;
+    status: "created";
+    resources: Array<{
+        resource_key: string;
+        kind: PortableResourceKind;
+        id: string;
+        name: string;
+        status: "ready" | "incomplete";
+    }>;
+    id_map: Record<string, string>;
+    warnings: string[];
 };
-export type ResourceBundleCandidateList = {
+export type ResourceCandidateList = {
     items: Array<{
         id: string;
         name: string;
     }>;
     total: number;
 };
-export type ResourceBundleCandidateOptions = {
+export type ResourcePackageCandidateOptions = {
     kind: string;
     query?: string;
     limit?: number;
     offset?: number;
     requiredCapability?: "chat" | "embedding";
 };
+export type ResourceInstallationBinding = {
+    resource_key: string;
+    kind: string;
+    resource_id: string;
+    source_hash?: string | null;
+    retained_orphan?: boolean;
+};
+export type ResourceCallableBindingStatus = {
+    consumer_resource_key: string;
+    consumer_node_id: string;
+    source_resource_key: string;
+    source_kind: "agent" | "rag_pipeline" | "artifact";
+    registry_kind: "tool" | "toolset" | null;
+    tool_id: string | null;
+    tool_key: string | null;
+    toolset_id: string | null;
+    toolset_key: string | null;
+    draft_status: "attached" | "unavailable" | "missing" | "stale" | "blocked";
+    published_status: "attached" | "unavailable" | "missing" | "stale" | "not_published";
+    published_version_id: string | null;
+    blocker_code: string | null;
+};
+export type ResourceInstallationOperation = {
+    operation_id: string;
+    installation_id: string;
+    package_id: string;
+    status: "planned" | "applying" | "waiting" | "completed" | "failed";
+    phase: string;
+    result: Record<string, unknown>;
+    failure_id?: string | null;
+};
+export type ResourceInstallation = {
+    id: string;
+    package_id: string | null;
+    package_name: string;
+    primary_resource_key?: string | null;
+    integration_mode: "bff" | "client-deployment" | "publish-only";
+    client_deployment_id?: string | null;
+    status: string;
+    synchronized_package_hash?: string | null;
+    last_applied_at?: string | null;
+    last_sync_direction?: "apply" | "pull" | null;
+    last_synchronized_at?: string | null;
+    last_pull_summary?: Record<string, unknown>;
+    last_published_package_hash?: string | null;
+    last_published_at?: string | null;
+    publication_state?: "never_published" | "current" | "draft_changes";
+    bindings?: ResourceInstallationBinding[];
+    callable_bindings?: ResourceCallableBindingStatus[];
+    development_connections?: ArtifactDevelopmentSession[];
+    remote_artifact_stages?: Array<{
+        resource_key: string;
+        artifact_id: string;
+        target: "development" | "production";
+        status: string;
+        manifest_hash: string;
+        base_url?: string | null;
+    }>;
+    latest_apply?: ResourceInstallationOperation | null;
+    latest_pull?: ResourceInstallationPullPlan | null;
+};
+export type ResourceInstallationList = {
+    items: ResourceInstallation[];
+};
+export type ResourceInstallationCreateRequest = {
+    package_id: string;
+    package_name: string;
+    operation_id: string;
+};
+export type ResourceInstallationPlan = {
+    installation_id: string | null;
+    operation_id: string;
+    package_id: string;
+    package_name: string;
+    package_hash: string;
+    actions: Array<Record<string, unknown>>;
+    content: Array<Record<string, unknown>>;
+    external_requirements: Array<Record<string, unknown>>;
+    artifact_actions: Array<Record<string, unknown>>;
+    artifact_readiness: Array<{
+        resource_key: string;
+        status: string;
+        blocking: false;
+    }>;
+    generated_tool_changes: Array<Record<string, unknown>>;
+    publication_order: string[];
+    deployment: Record<string, unknown>;
+    blockers: Array<Record<string, unknown>>;
+    can_apply: boolean;
+    prune: boolean;
+};
+export type ResourceInstallationLinkRequest = {
+    resource_key: string;
+    resource_id: string;
+};
+export type ResourceInstallationSecretsRequest = {
+    secrets: Record<string, string>;
+};
+export type ResourceInstallationSecretStatus = {
+    installation_id: string;
+    configured: string[];
+};
+export type ResourceInstallationApplyRequest = {
+    secrets?: Record<string, string>;
+    primary_resource_key?: string;
+    integration_mode?: "bff" | "client-deployment" | "publish-only";
+};
+export type ResourceInstallationPublishRequest = {
+    package_hash: string;
+};
+export type ResourceInstallationPublication = {
+    installation_id: string;
+    operation_id: string;
+    package_hash: string;
+    status: "published" | "already_published";
+    published_at?: string | null;
+    client_deployment_id?: string | null;
+};
+export type ArtifactDevelopmentSessionPrepareRequest = {
+    resource_key: string;
+    machine_label: string;
+};
+export type ArtifactDevelopmentSession = {
+    id?: string;
+    installation_id: string;
+    resource_key: string;
+    artifact_id?: string | null;
+    status: "prepared" | "connecting" | "connected" | "disconnected" | "expired" | "superseded" | "revoked";
+    contract_status: "unverified" | "verifying" | "healthy" | "stale";
+    machine_label?: string;
+    manifest_hash?: string | null;
+    last_heartbeat_at?: string | null;
+    contract_checked_at?: string | null;
+    failure_id?: string | null;
+    expires_at?: string | null;
+};
+export type ArtifactDevelopmentSessionAdmission = ArtifactDevelopmentSession & {
+    id: string;
+    relay_token: string;
+    relay_path: string;
+};
+export type ResourceInstallationDeploymentRequest = {
+    client_deployment_id?: string | null;
+};
+export type ResourceInstallationResourceListOptions = {
+    kind: string;
+    query?: string;
+    limit?: number;
+};
 export type ResourcePolicySummary = {
     id: string;
     name: string;
@@ -727,16 +1033,51 @@ export type CustomerIdentityRequest = {
     issuer: string;
     subject: string;
 };
-export type SetCustomerResourcePolicyAssignmentRequest = CustomerIdentityRequest & {
+export type CustomerProfilePatch = {
+    display_name?: string | null;
+    email?: string | null;
+    avatar_url?: string | null;
+};
+export type EmbedCustomerPrincipalResolveRequest = {
+    integration_id: string;
+    integration_name?: string;
+    issuer?: string;
+    subject: string;
+    profile?: CustomerProfilePatch;
+};
+export type EmbedCustomerPrincipalResolveResponse = {
+    customer_principal_ref: string;
+};
+export type CustomerProfile = {
+    customer_principal_ref: string;
+    display_name: string | null;
+    email: string | null;
+    avatar_url: string | null;
+    integration_id: string | null;
+    integration_name: string | null;
+};
+export type CustomerProfileList = {
+    items: CustomerProfile[];
+};
+export type CustomerProfileSearchOptions = {
+    query?: string;
+    integrationId?: string;
+    limit?: number;
+};
+export type CustomerPrincipalRefRequest = {
+    customer_principal_ref: string;
+};
+export type SetCustomerResourcePolicyAssignmentRequest = CustomerPrincipalRefRequest & {
     policy_set_id: string;
 };
-export type EffectiveCustomerResourcePolicyRequest = CustomerIdentityRequest & {
+export type EffectiveCustomerResourcePolicyRequest = CustomerPrincipalRefRequest & {
     deployment_id: string;
 };
 export type EmbedResourcePolicyRequest = {
     external_user_id: string;
-    external_user_issuer?: string;
+    integration_id: string;
     agent_version_id?: string;
+    runtime_target?: "draft" | "published";
 };
 export type ResourcePolicySubjectRef = {
     kind: "agent" | "client_deployment" | "organization_user" | "customer_principal";
@@ -764,6 +1105,7 @@ export type ClearCustomerResourcePolicyAssignmentResult = {
     cleared: boolean;
 };
 export type EffectiveResourcePolicy = {
+    agent_access_allowed?: boolean;
     customer_principal_ref: string | null;
     model_selection: {
         selectable: boolean;
@@ -802,18 +1144,4 @@ export type ResourcePolicyQuotaScheduleResult = {
     subject_ref: ResourcePolicySubjectRef;
     quota_schedule: ResourcePolicyQuotaSchedule;
 };
-export type ResourceBundleImportPreview = {
-    resources: Array<Record<string, unknown>>;
-    dependencies: Array<Record<string, unknown>>;
-    warnings: unknown[];
-    blockers: unknown[];
-    can_import: boolean;
-    [key: string]: unknown;
-};
-export type ResourceBundleImportResult = {
-    status: "created";
-    resources: Array<Record<string, unknown>>;
-    id_map: Record<string, string>;
-    warnings: unknown[];
-};
 //# sourceMappingURL=types.d.ts.map