Skip to main content

Crate sylphx_apps_sdk

Crate sylphx_apps_sdk 

Source
Expand description

Sylphx Platform SDK — Product Contract projection.

Sole public schema: project, Binding, Service spec, optional suite door. Default client is the Platform proto (https://api.sylphx.com/v1), not runtime BaaS (kv/email/schedules) and not the cluster SDK.

Discovery is Binding api_base. This crate does not compile sibling product schemas, predecessor product-API peels, or customer Schedule as Platform proto. Customer Schedule is Compute, not this SDK.

use sylphx_apps_sdk::Client;
let client = Client::new(std::env::var("SYLPHX_TOKEN").unwrap())?;
let _projects = client.list_projects(None, None).await?;

Modules§

types
Product Contract wire types (Protobuf -> buffa/connectrpc).

Structs§

AgentComputerControlClient
Descriptor-generated client for AgentComputerControlService.
AgentComputerDataClient
Descriptor-generated client for AgentComputerDataService.
AgentComputerMediaClient
Descriptor-generated client for AgentComputerMediaService.
ArtifactIngestClient
Descriptor-generated client for ArtifactIngestService.
BuildConnectionUrlInput
Connection URL SSOT (ADR-123 dual-oracle of @sylphx/sdk connection-url). Input for build_connection_url.
Client
Management-plane client.
ClientBuilder
Builder for ManagementClient.
DeliveryClient
Descriptor-generated client for DeliveryService.
ListOptions
Pagination options mapped 1:1 onto wire PageRequest.
ParsedConnectionUrl
Connection URL SSOT (ADR-123 dual-oracle of @sylphx/sdk connection-url). Parsed Sylphx connection URL components (dual-oracle of ParsedConnectionUrl).
RetryConfig
Retry policy for transient failures.
Transport
Production HTTP transport.
TransportConfig
Shared HTTP client configuration for one plane endpoint.
VerifiedBindingContext
Re-export contract identity for consumers and CLI evidence. Immutable identity and scope proved by Platform binding admission.

Enums§

ConnectionCredentialType
Connection URL SSOT (ADR-123 dual-oracle of @sylphx/sdk connection-url). Credential kind — publishable (pk) or secret (sk).
ConnectionEnv
Connection URL SSOT (ADR-123 dual-oracle of @sylphx/sdk connection-url). Target environment encoded in the credential.
Credential
Credential material for a plane.
SdkError
SDK-level errors.
VerifiedBindingContextError
Re-export contract identity for consumers and CLI evidence. Failure to construct a verified-binding context from incomplete claims.

Constants§

AGENT_COMPUTER_DESCRIPTOR_GRAPH_SHA256
SHA-256 identity of the allowlisted management-rooted descriptor graph.
AGENT_COMPUTER_DESCRIPTOR_ROOT_FILE
Canonical aggregate descriptor root for the public management wire.
AGENT_COMPUTER_DESCRIPTOR_ROOT_SHA256
SHA-256 identity of the canonical management root file descriptor.
API_TYPES_CONTRACT_PACKAGE
Re-export contract identity for consumers and CLI evidence. Schema identity for publish/admission evidence.
API_TYPES_CONTRACT_REVISION
Re-export contract identity for consumers and CLI evidence. Human-readable contract revision for this crate release.
DEFAULT_MANAGEMENT_BASE_URL
Default Management API base URL (includes /v1).
VERIFIED_BINDING_CONTEXT_REVISION
Re-export contract identity for consumers and CLI evidence. Canonical revision of the verified-binding request context contract.
WIRE_CONTRACT_PACKAGE
Deprecated aliases — prefer API_TYPES_CONTRACT_*. Schema identity for publish/admission evidence.
WIRE_CONTRACT_REVISION
Deprecated aliases — prefer API_TYPES_CONTRACT_*. Human-readable contract revision for this crate release.

Functions§

auth_header_pair
Build Authorization / x-app-secret header pair for inspection/tests.
build_connection_url
Connection URL SSOT (ADR-123 dual-oracle of @sylphx/sdk connection-url). Build a canonical Sylphx connection URL (dual-oracle of buildConnectionUrl).
client_from_api_base
Build a client from a caller-discovered product API base.
normalize_management_base_url
Normalize a Management API base URL so callers always hit /v1.
parse_connection_url
Connection URL SSOT (ADR-123 dual-oracle of @sylphx/sdk connection-url). Parse a Sylphx connection URL (dual-oracle of parseConnectionUrl).
register_wire_types
Add Apps and well-known Protobuf types to the application’s registry.