Expand description
§acosmi-sdk
Acosmi Rust SDK — 模型网关(双格式 Anthropic + OpenAI)、Agent Run Gateway 与 Compliance(电子证据、时间章、报告、签署 envelope)统一客户端。
端口自 acosmi-sdk-ts v2.8.0(事实标准主实现)。
跨语言契约(snake_case wire-format / 符号名对齐 / bug-for-bug 行为)见
docs/开发与发布手册.md §5。
§双格式红线
AnthropicAdapter + OpenAIAdapter 等地位(对应两个不同下游产品),恒编译、不可降级。
§运行时
仅原生 tokio + reqwest(rustls TLS)。流式走 impl Stream,取消走
tokio_util::CancellationToken。
§模块(随分阶段端口逐步填充)
各业务域 module 是该域对外切片的单一真相源;lib.rs 经 pub use 对齐
index.ts 的逐域 re-export。
Re-exports§
pub use crate::auth::all_scopes;pub use crate::auth::chat_bridge_scopes;pub use crate::auth::code_challenge;pub use crate::auth::commerce_scopes;pub use crate::auth::generate_code_verifier;pub use crate::auth::generate_state;pub use crate::auth::is_invalid_grant_error;pub use crate::auth::is_ssl_error;pub use crate::auth::is_valid_token_set;pub use crate::auth::model_scopes;pub use crate::auth::new_token_set;pub use crate::auth::remote_control_scopes;pub use crate::auth::resolve_success_redirect;pub use crate::auth::skill_scopes;pub use crate::auth::token_set_is_expired;pub use crate::auth::AuthorizeResult;pub use crate::auth::ClientRegistration;pub use crate::auth::CreateWebAuthorizationRequestOptions;pub use crate::auth::LoginEvent;pub use crate::auth::LoginOptions;pub use crate::auth::OAuthTokenEndpointError;pub use crate::auth::RegisterWebOAuthClientOptions;pub use crate::auth::ServerMetadata;pub use crate::auth::TokenResponse;pub use crate::auth::TokenSet;pub use crate::auth::WebAuthorizationCallbackParams;pub use crate::auth::WebAuthorizationPending;pub use crate::auth::WebAuthorizationRequest;pub use crate::core::read_gateway_request_id;pub use crate::core::AuthorityResult;pub use crate::core::AuthorityState;pub use crate::core::ChatOptions;pub use crate::core::ChatUsageEvent;pub use crate::core::Client;pub use crate::core::Config;pub use crate::core::FileTokenStore;pub use crate::core::FilterStatus;pub use crate::core::GatewayRequestIDCallback;pub use crate::core::HttpBody;pub use crate::core::HttpClient;pub use crate::core::HttpContext;pub use crate::core::HttpPurpose;pub use crate::core::HttpRequest;pub use crate::core::HttpResponse;pub use crate::core::HttpResponseMode;pub use crate::core::HttpTransport;pub use crate::core::InMemoryTokenStore;pub use crate::core::StrictTokenAuthority;pub use crate::core::TokenAuthorityError;pub use crate::core::TokenStore;pub use crate::core::TransportError;pub use crate::core::UpstreamActivityCallback;pub use crate::core::DEFAULT_GATEWAY_BASE_URL;pub use crate::core::GATEWAY_REQUEST_ID_HEADER;pub use crate::models::anthropic_response_text_content;pub use crate::models::anthropic_response_thinking_content;pub use crate::models::anthropic_response_tool_use_blocks;pub use crate::models::bucket_info_is_commercial;pub use crate::models::bucket_row_is_commercial;pub use crate::models::build_betas;pub use crate::models::classify_sources_event;pub use crate::models::extract_anthropic_block_meta;pub use crate::models::find_desktop_visual_understanding_model;pub use crate::models::find_first_model_by_input_modality;pub use crate::models::get_adapter;pub use crate::models::get_adapter_for_model;pub use crate::models::is_sse_comment_line;pub use crate::models::model_supports_image_input;pub use crate::models::model_supports_input_modality;pub use crate::models::new_openai_stream_converter;pub use crate::models::new_thinking_config;pub use crate::models::new_web_search_tool;pub use crate::models::parse_settlement;pub use crate::models::parse_sources_event;pub use crate::models::unique_merge;pub use crate::models::validate_end_user_id;pub use crate::models::zero_model_capabilities;pub use crate::models::Adapter;pub use crate::models::AnthropicContentBlock;pub use crate::models::AnthropicResponse;pub use crate::models::AnthropicUsage;pub use crate::models::BlockMeta;pub use crate::models::BucketInfo;pub use crate::models::BucketRow;pub use crate::models::ChatContentBlock;pub use crate::models::ChatMessage;pub use crate::models::ChatRequest;pub use crate::models::ChatResponse;pub use crate::models::ChatUsage;pub use crate::models::EffortConfig;pub use crate::models::EmbeddingData;pub use crate::models::EmbeddingInput;pub use crate::models::EmbeddingRequest;pub use crate::models::EmbeddingResponse;pub use crate::models::EmbeddingUsage;pub use crate::models::GeoLoc;pub use crate::models::ImageGenerationRequest;pub use crate::models::ImageGenerationResponse;pub use crate::models::InputModality;pub use crate::models::ManagedModel;pub use crate::models::ModelCapabilities;pub use crate::models::MultimodalContent;pub use crate::models::OpenAIChatChoice;pub use crate::models::OpenAIChatMessage;pub use crate::models::OpenAIChatResponse;pub use crate::models::OpenAIFunctionCall;pub use crate::models::OpenAIStreamChoice;pub use crate::models::OpenAIStreamChunk;pub use crate::models::OpenAIStreamConverter;pub use crate::models::OpenAIStreamDelta;pub use crate::models::OpenAIStreamToolCall;pub use crate::models::OpenAIStreamUsage;pub use crate::models::OpenAIStreamUsageCompletionDetails;pub use crate::models::OpenAIStreamUsagePromptDetails;pub use crate::models::OpenAIToolCall;pub use crate::models::OpenAIUsage;pub use crate::models::OutputConfig;pub use crate::models::ProviderFormat;pub use crate::models::QuotaSummary;pub use crate::models::QuotaSummaryFreePool;pub use crate::models::QuotaSummarySubscriptionPool;pub use crate::models::RerankDocument;pub use crate::models::RerankQuery;pub use crate::models::RerankRequest;pub use crate::models::RerankResponse;pub use crate::models::RerankResult;pub use crate::models::ServerTool;pub use crate::models::SourcesEvent;pub use crate::models::SourcesEventIssueCode;pub use crate::models::SourcesEventParseResult;pub use crate::models::StreamEvent;pub use crate::models::StreamSettlement;pub use crate::models::ThinkingConfig;pub use crate::models::VideoGenerationRequest;pub use crate::models::VideoTaskResponse;pub use crate::models::WebSearchConfig;pub use crate::models::WebSearchSource;pub use crate::models::WindowLimitStatus;pub use crate::models::CREDIT_UNIT_COST_CNY;pub use crate::models::CREDIT_UNIT_OFFICIAL_CNY;pub use crate::models::MAX_END_USER_ID_LENGTH;pub use crate::models::QUOTA_UNIT_MICRO_CREDIT;pub use crate::models::SERVER_TOOL_TYPE_WEB_SEARCH;pub use crate::models::THINKING_HIGH;pub use crate::models::THINKING_MAX;pub use crate::models::THINKING_OFF;pub use crate::billing::BalanceDetail;pub use crate::billing::BalanceDetailEntitlement;pub use crate::billing::BuyResponse;pub use crate::billing::ConsumeRecord;pub use crate::billing::ConsumeRecordPage;pub use crate::billing::EntitlementBalance;pub use crate::billing::EntitlementItem;pub use crate::billing::ModelBucket;pub use crate::billing::ModelByQuotaResponse;pub use crate::billing::ModelCoefficient;pub use crate::billing::Order;pub use crate::billing::OrderListItem;pub use crate::billing::OrderStatus;pub use crate::billing::PayPayload;pub use crate::billing::PaymentMethod;pub use crate::billing::TokenPackage;pub use crate::billing::Transaction;pub use crate::billing::WalletStats;pub use crate::skills::CertificationStatus;pub use crate::skills::GenerateSkillRequest;pub use crate::skills::GenerateSkillResult;pub use crate::skills::OptimizeSkillRequest;pub use crate::skills::OptimizeSkillResult;pub use crate::skills::SkillBrowseListResponse;pub use crate::skills::SkillBrowseResponse;pub use crate::skills::SkillDownload;pub use crate::skills::SkillStoreItem;pub use crate::skills::SkillStoreListItem;pub use crate::skills::SkillStoreQuery;pub use crate::skills::SkillSummary;pub use crate::skills::ToolListResponse;pub use crate::skills::ToolProvider;pub use crate::skills::ToolView;pub use crate::notifications::parse_notification_event;pub use crate::notifications::DeviceRegistration;pub use crate::notifications::Notification;pub use crate::notifications::NotificationList;pub use crate::notifications::NotificationPreference;pub use crate::notifications::NotificationUnreadCount;pub use crate::notifications::WSEvent;pub use crate::agent_runs::is_terminal_remote_event;pub use crate::agent_runs::parse_remote_control_event;pub use crate::agent_runs::AdapterKind;pub use crate::agent_runs::AgentRun;pub use crate::agent_runs::AgentRunArtifact;pub use crate::agent_runs::AgentRunArtifactPolicy;pub use crate::agent_runs::AgentRunCreateRequest;pub use crate::agent_runs::AgentRunCreateResponse;pub use crate::agent_runs::AgentRunDownload;pub use crate::agent_runs::AgentRunErrorPayload;pub use crate::agent_runs::AgentRunListOptions;pub use crate::agent_runs::AgentRunListResult;pub use crate::agent_runs::AgentRunLocalContextPolicy;pub use crate::agent_runs::AgentRunLocalToolResult;pub use crate::agent_runs::AgentRunRunOptions;pub use crate::agent_runs::AgentRunSettlement;pub use crate::agent_runs::AgentRunStatus;pub use crate::agent_runs::AgentRunStreamEvent;pub use crate::agent_runs::AgentRunStreamOptions;pub use crate::agent_runs::AgentRunUsage;pub use crate::agent_runs::AgentRunWithLocalToolsOptions;pub use crate::agent_runs::AgentRunsClient;pub use crate::agent_runs::ByokCreateRequest;pub use crate::agent_runs::ByokCredential;pub use crate::agent_runs::CrabCodeByokClient;pub use crate::agent_runs::LocalToolContext;pub use crate::agent_runs::PermissionPolicy;pub use crate::agent_runs::RemoteControlEvent;pub use crate::agent_runs::RemotePermissionResultRequest;pub use crate::agent_runs::RemoteSessionTokenGrant;pub use crate::agent_runs::RemoteUserMessageAck;pub use crate::agent_runs::RemoteUserMessageRequest;pub use crate::agent_runs::RunnerKind;pub use crate::agent_runs::WorkspacePolicy;pub use crate::compliance::classify_compliance_error;pub use crate::compliance::compliance_scopes;pub use crate::compliance::is_billing_confirmable;pub use crate::compliance::is_compliance_business_error;pub use crate::compliance::is_compliance_terminal_error;pub use crate::compliance::ApproveSealApprovalQuery;pub use crate::compliance::CancelSealApprovalQuery;pub use crate::compliance::ComplianceBillingDisplayStatus;pub use crate::compliance::ComplianceCapability;pub use crate::compliance::ComplianceClient;pub use crate::compliance::ComplianceEnvelopeStatus;pub use crate::compliance::ComplianceErrorInfo;pub use crate::compliance::ComplianceErrorKey;pub use crate::compliance::CompliancePollError;pub use crate::compliance::CompliancePollErrorKind;pub use crate::compliance::CompliancePollOptions;pub use crate::compliance::ComplianceProviderRequestStatus;pub use crate::compliance::ComplianceProviderStatus;pub use crate::compliance::ComplianceReport;pub use crate::compliance::ComplianceSealApprovalStatus;pub use crate::compliance::ComplianceWriteOptions;pub use crate::compliance::ContractTemplateField;pub use crate::compliance::ContractTemplateFieldType;pub use crate::compliance::ContractTemplatePageItem;pub use crate::compliance::ContractTemplateResp;pub use crate::compliance::ContractTemplateStatus;pub use crate::compliance::ContractTemplateVersion;pub use crate::compliance::CreateContractTemplateRequest;pub use crate::compliance::CreateEvidenceAssetRequest;pub use crate::compliance::CreateH5SigningUrlRequest;pub use crate::compliance::CreateReportRequest;pub use crate::compliance::CreateSigningEnvelopeRequest;pub use crate::compliance::EnvelopeContractItem;pub use crate::compliance::EvidenceAsset;pub use crate::compliance::EvidenceAssetPageItem;pub use crate::compliance::EvidencePackage;pub use crate::compliance::EvidencePackagePageItem;pub use crate::compliance::IssueTimestampRequest;pub use crate::compliance::ListContractTemplatesRequest;pub use crate::compliance::ListEvidenceAssetsRequest;pub use crate::compliance::ListEvidencePackagesRequest;pub use crate::compliance::ListOperationsRequest;pub use crate::compliance::ListReportsRequest;pub use crate::compliance::ListSealApprovalsRequest;pub use crate::compliance::ListSealUsesRequest;pub use crate::compliance::ListSigningEnvelopesRequest;pub use crate::compliance::ListTimestampsRequest;pub use crate::compliance::OperationBase;pub use crate::compliance::OperationDetail;pub use crate::compliance::OperationPageItem;pub use crate::compliance::ProviderRequestStatusView;pub use crate::compliance::PublicEvidenceVerifyResult;pub use crate::compliance::RejectSealApprovalQuery;pub use crate::compliance::ReportDownload;pub use crate::compliance::ReportPageItem;pub use crate::compliance::SealApproval;pub use crate::compliance::SealApprovalPageItem;pub use crate::compliance::SealUsePageItem;pub use crate::compliance::SignEnvelopeRequest;pub use crate::compliance::SigningEnvelope;pub use crate::compliance::SigningEnvelopePageItem;pub use crate::compliance::SubmitSealApprovalRequest;pub use crate::compliance::TimestampPageItem;pub use crate::compliance::TimestampToken;pub use crate::compliance::TimestampVerifyResult;pub use crate::compliance::TsaProvider;pub use crate::compliance::TsaStats;pub use crate::compliance::UpdateContractTemplateRequest;pub use crate::compliance::UploadContractTemplatePdfRequest;pub use crate::compliance::VerifyTimestampRequest;pub use crate::compliance::VoidEnvelopeRequest;pub use crate::support::BugReportResult;pub use crate::support::BugView;pub use crate::subscription::Membership;pub use crate::subscription::RolloverPolicy;pub use crate::subscription::SubscriptionAudience;pub use crate::subscription::SubscriptionPlan;pub use crate::subscription::SubscriptionPrecheckResult;pub use crate::subscription::SubscriptionTier;pub use crate::subscription::UserSubscription;pub use crate::pricing::ComplianceBenefitType;pub use crate::pricing::ComplianceQuoteResponse;pub use crate::pricing::ComplianceSku;pub use crate::pricing::PricingConfig;pub use crate::pricing::PublicModelSummary;pub use crate::products::Audience;pub use crate::products::BillingMode;pub use crate::products::Product;pub use crate::products::ProductFamily;pub use crate::products::RegionScope;pub use crate::casehall::BookConsultationRequest;pub use crate::casehall::BookConsultationResult;pub use crate::casehall::CaseLead;pub use crate::casehall::CaseLeadIdResult;pub use crate::casehall::CaseMatter;pub use crate::casehall::LawyerCredentialMyView;pub use crate::casehall::LawyerSummary;pub use crate::casehall::LegalBenefitType;pub use crate::casehall::LegalConsultation;pub use crate::casehall::LegalServiceOrder;pub use crate::casehall::LegalServiceSku;pub use crate::casehall::LegalSkuCode;pub use crate::casehall::ListLawyersParams;pub use crate::casehall::SubmitCaseLeadRequest;pub use crate::enterprise::AssignSeatRequest;pub use crate::enterprise::EnterpriseKycMyStatusView;pub use crate::enterprise::EnterpriseMember;pub use crate::enterprise::EnterpriseSummary;pub use crate::enterprise::InviteMemberRequest;pub use crate::enterprise::MemberRole;pub use crate::enterprise::OrgConsumeReport;pub use crate::enterprise::OrgSeat;pub use crate::enterprise::OrgSubscription;pub use crate::finance::CorporateTransfer;pub use crate::finance::InitiateCorporateTransferInput;pub use crate::finance::InitiateCorporateTransferResult;pub use crate::finance::Invoice;pub use crate::finance::InvoiceType;pub use crate::finance::RefundPolicy;pub use crate::finance::RefundProductFamily;pub use crate::finance::RefundRecord;pub use crate::finance::RequestInvoiceInput;pub use crate::finance::RequestRefundInput;pub use crate::chatbridge::as_credential_ref;pub use crate::chatbridge::is_channel_inbound_event;pub use crate::chatbridge::is_integration_status;pub use crate::chatbridge::is_platform;pub use crate::chatbridge::is_region;pub use crate::chatbridge::BridgeThreadRef;pub use crate::chatbridge::ChannelAttachment;pub use crate::chatbridge::ChannelCard;pub use crate::chatbridge::ChannelCardAction;pub use crate::chatbridge::ChannelInboundEvent;pub use crate::chatbridge::ChannelOutboundEvent;pub use crate::chatbridge::ChatBridgeClient;pub use crate::chatbridge::ChatBridgeSession;pub use crate::chatbridge::ChatCredentialPublic;pub use crate::chatbridge::ChatIntegration;pub use crate::chatbridge::ChatThread;pub use crate::chatbridge::CreateIntegrationRequest;pub use crate::chatbridge::CredentialRef;pub use crate::chatbridge::IntegrationStatus;pub use crate::chatbridge::Platform;pub use crate::chatbridge::Region;pub use crate::chatbridge::StoreCredentialRequest;pub use crate::chatbridge::ALL_INTEGRATION_STATUS;pub use crate::chatbridge::ALL_PLATFORMS;pub use crate::chatbridge::ALL_REGIONS;pub use shared::Error;pub use shared::Result;pub use crate::auth::auth::discover_web_oauth_metadata_with_transport;pub use crate::auth::auth::discover_with_profile_with_transport;pub use crate::auth::auth::exchange_code_with_expiry_with_transport;pub use crate::auth::auth::exchange_code_with_transport;pub use crate::auth::auth::refresh_token_with_transport;pub use crate::auth::auth::register_web_oauth_client_with_transport;pub use crate::auth::auth::register_with_transport;pub use crate::auth::auth::revoke_token_with_transport;pub use crate::auth::auth::discover_with_transport;pub use crate::auth::auth::discover;pub use crate::auth::auth::discover_web_oauth_metadata;pub use crate::auth::auth::discover_with_profile;pub use crate::auth::auth::exchange_code;pub use crate::auth::auth::exchange_code_with_expiry;pub use crate::auth::auth::refresh_token;pub use crate::auth::auth::register;pub use crate::auth::auth::register_web_oauth_client;pub use crate::auth::auth::revoke_token;pub use crate::notifications::WSConfig;
Modules§
- agent_
runs - Agent Run Gateway 域:agent runs(create/list/get/cancel/stream/run + 本地工具编排)
- auth
- 鉴权 / 身份域。端口自
auth/。 - billing
- 计费域:entitlements / metering / wallet / 商城(token packages)。
- casehall
- 法律案件咨询 namespace:律师库 / 案件线索 / 咨询 / 法律服务订单 & SKU / 律师执业证自查。
- chatbridge
- Chat Bridge 域(Phase 7B):第三方聊天平台集成 + 凭证 vault 控制面。
- compliance
- Compliance 域(电子证据 / 时间章 / 报告 / 签署 envelope / 用印审批 / 模板)。
- core
- 运行时基座域:主 Client、TokenStore、Retry、HTTP 辅助。
- enterprise
- 企业席位(P6a)namespace:企业组织 / 成员 / 订阅 + 席位 / 用量报表 / KYC 自查。
- finance
- 财务(P7)namespace:退款 / 发票 / 对公转账。
- models
- 模型网关域:ManagedModel / Chat / wire-format DTO / 双格式 adapter / 选模型 helper。
- notifications
- 通知 / WebSocket 推送域。
- pricing
- 定价域:公开业务参数 + 公开模型摘要 + csign 电子认证 SKU(匿名可读)。
- products
- 商品中心域:公开在售商品(按族 / 按 slug)。
- sanitize
- Provider 无关的历史消息清洗子包(feature
sanitize,默认开;对齐 npm 子路径./sanitize, index.tsexport * as sanitize)。经core::sanitize_bridge与Client接通。 sanitize 子包 — 端口自acosmi-sdk-ts/src/sanitize/(其本身端口自acosmi-sdk-go/sanitize/)。 - shared
- 跨域基础设施:错误体系、APIResponse / 分页结构、跨域共享 DTO (分页 / operation / retryAdvice / principal / gate)。
- skills
- 技能商店 / 技能生产器 / 统一工具域。
- subscription
- 订阅域:公开订阅计划 + C 端会员中心概览。
- support
- 支持 / 反馈域。对齐
support/index.ts。
Constants§
- VERSION
- SDK 版本(对齐 npm
@acosmi/sdk-ts主线 /Cargo.tomlpackage.version)。