@agents24/node 0.4.0 → 0.5.1

package/dist/types/types.d.ts

@@ -52,11 +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;
@@ -65,6 +65,7 @@ export type AttachRunRequest = {
     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";
@@ -86,6 +87,7 @@ export type EmbeddedResponseFeedbackInput = {
     reason?: FeedbackReason | null;
     comment?: string | null;
     runtime_target?: "draft" | "published";
+    integration_id: string;
 };
 export type HitlAction = "approve" | "reject" | "connect" | "skip" | "respond";
 export type HitlAnswer = {
@@ -111,17 +113,28 @@ 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;
 };
@@ -129,6 +142,7 @@ export type ThreadListOptions = {
     externalUserId: string;
     externalSessionId?: string;
     runtimeTarget?: "draft" | "published";
+    integrationId: string;
     skip?: number;
     limit?: number;
 };
@@ -142,11 +156,13 @@ export type ThreadDetailOptions = {
     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;
@@ -157,11 +173,13 @@ 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;
@@ -169,10 +187,47 @@ export type ThreadSummaryEventOptions = {
     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;
@@ -186,11 +241,13 @@ 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";
@@ -318,6 +375,7 @@ export type AgentValidationResult = {
 };
 export type AgentCreateRequest = {
     name: string;
+    aliases?: string[];
     description?: string | null;
     tags?: string[];
     graph_definition: GraphDefinition;
@@ -329,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";
@@ -640,10 +699,38 @@ export type ResourcePackageUpload = {
     data: Uint8Array;
     filename?: string;
 };
+export type ResourcePackageImportUpload = ResourcePackageUpload & {
+    mappings?: Record<string, string>;
+};
 export type ResourceInstallationPlanUpload = ResourcePackageUpload & {
-    installationId?: string;
     prune?: boolean;
-    development?: 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";
@@ -651,38 +738,42 @@ export type ResourcePackageDiagnostic = {
     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: "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;
@@ -694,45 +785,88 @@ 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";
+export type ResourcePackageExportPlan = {
+    format: "agents24.resource_package";
     schema_version: "2.0";
-    exported_at?: string;
-    resources: ResourceBundleResource[];
-    dependencies: ResourceBundleDependency[];
+    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>>;
-    content_sets?: Array<{
+    blockers: Array<{
+        code: string;
+        message: string;
+    }>;
+    can_export: boolean;
+};
+export type ResourcePackageImportPreview = {
+    format: "agents24.resource_package";
+    schema_version: "2.0";
+    package: Record<string, unknown>;
+    package_hash: string;
+    resources: Array<{
         resource_key: string;
-        files: Array<{
-            path: string;
-            sha256: string;
+        kind: PortableResourceKind;
+        name: string;
+        status: "ready" | "incomplete";
+        incomplete_reasons: Array<{
+            dependency_id: string;
+            kind: string;
+            message: string;
         }>;
     }>;
-};
-export type ResourceBundlePlan = Omit<ResourceBundle, "resources"> & {
-    resources: Array<Omit<ResourceBundleResource, "document">>;
+    dependencies: ResourcePackageDependency[];
+    suggested_mappings: Array<{
+        dependency_id: string;
+        id: string;
+        name: string;
+    }>;
+    warnings: string[];
     blockers: Array<{
         code: string;
         message: string;
     }>;
-    can_export: boolean;
-    external_references: ResourceBundleDependency[];
+    can_import: boolean;
 };
-export type ResourceBundleExportRequest = {
-    selectors: ResourceSelector[];
-    included_resource_keys?: string[];
+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;
@@ -746,9 +880,25 @@ export type ResourceInstallationBinding = {
     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>;
@@ -756,17 +906,22 @@ export type ResourceInstallationOperation = {
 };
 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;
-    last_package_hash?: string | null;
+    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;
@@ -776,24 +931,32 @@ export type ResourceInstallation = {
         manifest_hash: string;
         base_url?: string | null;
     }>;
-    latest_operation?: ResourceInstallationOperation | 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>;
@@ -816,7 +979,6 @@ export type ResourceInstallationApplyRequest = {
     secrets?: Record<string, string>;
     primary_resource_key?: string;
     integration_mode?: "bff" | "client-deployment" | "publish-only";
-    development_sessions?: Record<string, string>;
 };
 export type ResourceInstallationPublishRequest = {
     package_hash: string;
@@ -838,10 +1000,13 @@ export type ArtifactDevelopmentSession = {
     installation_id: string;
     resource_key: string;
     artifact_id?: string | null;
-    status: "prepared" | "connecting" | "verified_provisional" | "connected" | "disconnected" | "expired" | "superseded" | "revoked";
+    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 & {
@@ -868,15 +1033,49 @@ 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";
 };
@@ -906,6 +1105,7 @@ export type ClearCustomerResourcePolicyAssignmentResult = {
     cleared: boolean;
 };
 export type EffectiveResourcePolicy = {
+    agent_access_allowed?: boolean;
     customer_principal_ref: string | null;
     model_selection: {
         selectable: boolean;
@@ -944,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