@celestia-island/plana-types 0.1.0

package/Cargo.toml

@@ -0,0 +1,38 @@
+[package]
+name = "plana-types"
+version.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+authors.workspace = true
+license.workspace = true
+description = "Shared protocol types for celestia-island"
+repository = "https://github.com/celestia-island/plana"
+keywords = ["json-rpc", "protocol", "mcp", "typescript", "schema"]
+categories = ["api-bindings", "data-structures", "web-programming::websocket", "network-programming"]
+# Keep generated TS bindings, Python build scripts, and docs out of the published crate.
+exclude = ["bindings", "scripts", ".cargo", "justfile", "package.json", "pnpm-workspace.yaml", "PLAN.md", "res", "examples"]
+
+[features]
+default = []
+tracing-helpers = ["chrono", "tracing-subscriber"]
+
+[dependencies]
+
+kirino = { workspace = true }
+
+chrono = { workspace = true, optional = true }
+hex.workspace = true
+schemars = { workspace = true }
+serde = { workspace = true, features = ["derive"] }
+serde_json.workspace = true
+sha2.workspace = true
+thiserror.workspace = true
+tracing-subscriber = { workspace = true, optional = true }
+ts-rs = { workspace = true }
+uuid = { workspace = true }
+[dev-dependencies]
+
+anyhow.workspace = true
+toml.workspace = true
+[package.metadata.docs.rs]
+all-features = true

package/bindings/FileAnchor.ts

@@ -0,0 +1,3 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FileAnchor = { file_path: string, line_start?: number | null, line_end?: number | null, snapshot_hash?: string | null, };

package/bindings/engine.ts

@@ -0,0 +1,277 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "./serde_json/JsonValue";
+
+/**
+ * `Engine.BinaryAbort` notification params — cancels an in-flight
+ * transfer; the receiver discards buffered bytes and returns to normal
+ * RPC operation.
+ */
+export type EngineBinaryAbortParams = { transfer_id: string, reason: string, };
+
+/**
+ * `Engine.BinaryEnd` notification params — sent after the final binary
+ * frame; the receiver validates and returns to normal RPC operation.
+ */
+export type EngineBinaryEndParams = { transfer_id: string, 
+/**
+ * Bytes actually received across all frames.
+ */
+bytes_received: bigint, 
+/**
+ * Whether the checksum matched (None when no checksum was announced).
+ */
+checksum_ok?: boolean, };
+
+/**
+ * `Engine.BinaryStart` notification params — the announce packet sent
+ * BEFORE any binary frame. Every payload is labelled with a MIME type.
+ */
+export type EngineBinaryStartParams = { 
+/**
+ * Correlation id shared by announce / frames / finish.
+ */
+transfer_id: string, 
+/**
+ * MIME type of the whole payload (e.g. "audio/wav",
+ * "application/octet-stream"). Empty means unspecified binary.
+ */
+mime: string, total_bytes: bigint, 
+/**
+ * Expected number of binary frames (for early truncation checks).
+ */
+chunk_count: number, 
+/**
+ * Optional SHA-256 hex digest of the payload.
+ */
+checksum?: string, 
+/**
+ * Optional association with a stream (generic streaming).
+ */
+stream_id?: string, };
+
+/**
+ * Static capability declaration supplied at handshake time.
+ */
+export type EngineCapabilities = { streaming: boolean, embeddings: boolean, max_context_length: number, hardware: Array<EngineGpuInfo>, 
+/**
+ * Modalities the engine can consume as input (empty = text only).
+ */
+input_modalities: Array<EngineModality>, 
+/**
+ * Modalities the engine can produce as output.
+ */
+output_modalities: Array<EngineModality>, 
+/**
+ * MIME content types accepted as input (e.g. "audio/wav",
+ * "application/octet-stream", "application/json").
+ */
+content_types: Array<string>, 
+/**
+ * Engine-defined `Engine.Invoke` method names beyond the standard
+ * convenience methods (e.g. "audio.generate", "signal.filter").
+ * Any engine-specific operation is reachable via `Engine.Invoke`
+ * even when absent from this list.
+ */
+methods: Array<string>, };
+
+/**
+ * `Engine.ChatChunk` notification — streamed token delta.
+ */
+export type EngineChatChunk = { stream_id: string, token: string, 
+/**
+ * Set on the final chunk.
+ */
+is_complete: boolean, usage?: EngineUsage, };
+
+/**
+ * `Engine.Chat` (non-streaming) / `Engine.ChatStart` (streaming) params.
+ */
+export type EngineChatParams = { model: string, messages: Array<EngineMessage>, temperature?: number, max_tokens?: number, 
+/**
+ * Present for streaming requests — chunks are tagged with this id.
+ */
+stream_id?: string, 
+/**
+ * Free-form passthrough merged into the upstream payload (same
+ * semantics as the gateway's `extra` field).
+ */
+extra?: JsonValue, };
+
+/**
+ * `Engine.Chat` result for a non-streaming completion.
+ */
+export type EngineChatResult = { model: string, content: string, usage?: EngineUsage, };
+
+/**
+ * `Engine.ChatStart` acceptance result. `ok: false` rejects the stream
+ * before any chunk is sent.
+ */
+export type EngineChatStartResult = { ok: boolean, error?: string, stream_id: string, };
+
+/**
+ * One content unit inside a message. Text is a plain string; everything
+ * else is a data block described by mime + encoding so consumers can
+ * decode without prior agreement:
+ * - `data`: base64 bytes (standard `encoding: "base64"`)
+ * - `encoding: "binary-frame"`: bytes arrive in the immediately following
+ *   WebSocket binary frame (JSON notification is the announcer/trailer)
+ * - `encoding: "json"`: `data` is inline JSON (structured sensor readings,
+ *   tensors, feature vectors…)
+ */
+export type EngineContentPart = { 
+/**
+ * MIME type — "text/plain" for plain text parts.
+ */
+mime: string, 
+/**
+ * Encoding of `data` ("base64" | "binary-frame" | "json" | "utf-8").
+ */
+encoding: string, 
+/**
+ * Payload: base64 text, inline JSON, or raw text depending on
+ * `encoding`. Empty for binary-frame parts (bytes follow as a WS
+ * binary frame).
+ */
+data?: JsonValue, 
+/**
+ * Optional shape hint for tensor/sensor parts, e.g. [1, 16000]
+ * (channels × samples) or the sensor schema id.
+ */
+shape?: Array<number>, };
+
+export type EngineEmbeddingsParams = { model: string, input: Array<string>, };
+
+export type EngineEmbeddingsResult = { model: string, embeddings: Array<Array<number>>, };
+
+/**
+ * One GPU the engine can drive — used by capacity-aware placement.
+ */
+export type EngineGpuInfo = { name: string, vram_gb: bigint, };
+
+/**
+ * `Engine.Handshake` params — the engine's first message on connect.
+ */
+export type EngineHandshakeParams = { 
+/**
+ * Optional shared token; the gateway rejects mismatches.
+ */
+token?: string, engine: EngineIdentity, capabilities: EngineCapabilities, };
+
+/**
+ * `Engine.Handshake` result. `ok: false` closes the connection.
+ *
+ * Handshake direction: when the gateway connects to an engine (engine is
+ * the server), the gateway sends `Engine.Handshake` and the engine answers
+ * with this result carrying its **own** declared capabilities, so the
+ * gateway learns modalities/content types before any request. When the
+ * engine connects to the gateway (engine is the client), the engine sends
+ * `Engine.Handshake` with its capabilities in the params and the gateway
+ * answers with `ok` only — the `capabilities` field is then ignored.
+ */
+export type EngineHandshakeResult = { ok: boolean, error?: string, protocol_version: number, 
+/**
+ * The engine's own capability declaration (server-mode handshake).
+ */
+capabilities?: EngineCapabilities, };
+
+/**
+ * Engine implementation identity (any language is fine — this is the
+ * interchange contract).
+ */
+export type EngineIdentity = { name: string, version: string, 
+/**
+ * Implementation language, e.g. "rust", "cpp".
+ */
+language?: string, 
+/**
+ * Optional vendor URL.
+ */
+vendor?: string, };
+
+/**
+ * `Engine.Invoke` / `Engine.InvokeStart` params — the generic extension
+ * channel. `method` is engine-defined (e.g. "audio.generate",
+ * "signal.filter", "train.step"); `params` is any JSON the engine
+ * understands. `messages` is optional and reuses the multimodal content
+ * model for engines that mix free-form payloads with content parts.
+ */
+export type EngineInvokeParams = { method: string, params: JsonValue, messages?: Array<EngineMessage>, 
+/**
+ * Present for streaming invocations — chunks are tagged with this id.
+ */
+stream_id?: string, };
+
+/**
+ * `Engine.Invoke` result — any JSON the engine returns.
+ */
+export type EngineInvokeResult = { method: string, result: JsonValue, };
+
+/**
+ * `Engine.InvokeStart` acceptance result (same shape as ChatStart).
+ */
+export type EngineInvokeStartResult = { ok: boolean, error?: string, stream_id: string, };
+
+/**
+ * A message in an `Engine.Chat` / `Engine.ChatStart` / `Engine.Invoke`
+ * payload. Content is a list of parts so mixed-modality inputs (text +
+ * audio + sensor…) are representable. `role` is advisory; specialised
+ * engines may ignore it.
+ */
+export type EngineMessage = { role: string, content: Array<EngineContentPart>, };
+
+/**
+ * Input/output modalities an engine can handle. The gateway does NOT
+ * assume text — it routes and passes payloads through based on this
+ * declaration.
+ */
+export type EngineModality = "Text" | "Audio" | "Image" | "Video" | "Sensor" | "Tensor" | "Generic";
+
+export type EngineModelInfo = { id: string, context_length?: number, embedding: boolean, };
+
+/**
+ * `Engine.Models` result.
+ */
+export type EngineModelsResult = { models: Array<EngineModelInfo>, };
+
+/**
+ * `Engine.Shutdown` params — graceful stop requested by the gateway.
+ */
+export type EngineShutdownParams = { reason?: string, };
+
+/**
+ * `Engine.Stats` result — live telemetry for capacity-aware placement.
+ */
+export type EngineStatsResult = { 
+/**
+ * Per-GPU utilisation percentages (0-100), same shape as the agent
+ * control-plane heartbeats.
+ */
+gpu_utilization: Array<number>, uptime_secs: bigint, 
+/**
+ * Model id currently loaded, when the engine pins a single model.
+ */
+model_loaded?: string, };
+
+/**
+ * `Engine.StreamChunk` notification — a generic streamed data block for
+ * any output modality (audio frame, sensor sample batch, tensor slice…).
+ */
+export type EngineStreamChunk = { stream_id: string, 
+/**
+ * MIME type of this block (e.g. "audio/wav", "application/json").
+ */
+mime: string, 
+/**
+ * "base64" | "binary-frame" | "json" | "utf-8".
+ */
+encoding: string, data?: JsonValue, 
+/**
+ * Optional shape hint for tensor/sensor blocks.
+ */
+shape?: Array<number>, 
+/**
+ * Set on the final block.
+ */
+is_complete: boolean, usage?: EngineUsage, };
+
+export type EngineUsage = { prompt_tokens: number, completion_tokens: number, };

package/bindings/enums.ts

@@ -0,0 +1,31 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AnnotationType = "Note" | "Warning" | "Todo" | "Suggestion" | "Conflict";
+
+export type ConnectionType = "Local" | "RemoteLan" | "RemoteInternet";
+
+export type ConsultationStatus = "WaitingHuman" | "Pending" | "Answered" | "Delivered" | "Scheduled" | "Triggered" | "Cancelled" | "Replied";
+
+export type ContainerOpStatus = "Created" | "Running" | "Stopped" | "Removed" | "Forked";
+
+export type ConversationMessageType = "Question" | "Answer" | "Clarification" | "Objection" | "CounterProposal" | "Resolution";
+
+export type ConversationStatus = "Active" | "Resolved" | "Deadlocked" | "Escalated";
+
+export type FileOpStatus = "Created" | "Deleted" | "Edited" | "Written";
+
+export type FileOperationType = "Reading" | "Editing" | "Deleting";
+
+export type FileType = "File" | "Directory";
+
+export type GoalStatus = "Active" | "Completed" | "Abandoned";
+
+export type GoalTaskStatus = "Pending" | "InProgress" | "Completed" | "Failed" | "Cancelled";
+
+export type ObservationType = "Reading" | "Editing" | "Deleting" | "Watching";
+
+export type ScriptLanguage = "Bash" | "Sh" | "Python" | "Python3" | "Javascript" | "Typescript" | "Node" | "Zsh" | "Layer2";
+
+export type TrackStatus = "Active" | "Completed" | "Abandoned";
+
+export type WebSearchEngine = "Duckduckgo";

package/bindings/httpTypes.ts

@@ -0,0 +1,197 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentConfig = { max_concurrent_tasks: number, timeout_secs: number, retry_on_failure: boolean, model: string, system_prompt: string, };
+
+export type AgentContainer = { id: string, image: string, status: string, uptime_secs: bigint, };
+
+export type AgentItem = { id: string, name: string, description: string, agent_type: string, layer: number, status: string, enabled: boolean, tools: Array<AgentTool>, toolsCount: number, subscribed: boolean, installed: boolean, version: string, config: AgentConfig, container: AgentContainer | null, skills: Array<string>, createdAt: string, updatedAt: string, };
+
+export type AgentTool = { id: string, name: string, description: string, enabled: boolean, };
+
+export type AliasRegistryEntry = { workspace_uuid: string, alias: string, short_id: string, };
+
+export type AvatarPlatformResponse = { id: string, slug: string, label: string, url_template: string, hint: string | null, enabled: boolean, sort_order: number, };
+
+export type AvatarUpdateResponse = { avatar_url: string | null, };
+
+/**
+ * Backend build profile.
+ */
+export type BackendKind = "dev" | "nightly" | "prod" | "mock";
+
+export type ChannelConfigDetail = { id: string, platform: string, enabled: boolean, name: string, description?: string, bot_token?: string, app_id?: string, app_secret?: string, verify_token?: string, api_base?: string, extra_config?: Record<string, unknown>, webhook_path: string, last_error?: string, last_tested_at?: string, created_at: string, updated_at: string, };
+
+export type ChannelConfigResponse = { config: ChannelConfigDetail, active: boolean, };
+
+export type ChannelConfigsResponse = { configs: Array<ChannelConfigResponse>, };
+
+export type ChannelListItem = { platform: string, enabled: boolean, bot_name: string, webhook_path: string, };
+
+export type ChannelListResponse = { channels: Array<ChannelListItem>, };
+
+export type ChannelMessageItem = { id: string, platform: string, direction: string, message_id: string, chat_id: string, sender_id: string | null, text: string, is_group: boolean, group_id: string | null, error: string | null, created_at: string, };
+
+export type ChannelMessageListResponse = { messages: Array<ChannelMessageItem>, count: number, };
+
+export type ConnectionStatus = { connected: boolean, latency: bigint, lastCheck: string, };
+
+export type CreatedResponse = { created: Array<string>, };
+
+export type CursorState = { workspace_id?: string, file?: string, line: number, column: number, total_lines?: number, language?: string, visible_range?: CursorVisibleRange, };
+
+export type CursorVisibleRange = { start: number, end: number, };
+
+export type DeletedResponse = { deleted: bigint, };
+
+export type DeliveryListResponse = { deliveries: Array<Record<string, unknown>>, count: number, };
+
+export type DeviceResponse = { id: string, device_id: string, name: string, device_type: string, status: string, last_seen_at: string | null, metadata?: Record<string, unknown>, created_at: string, };
+
+export type ErrorResponse = { error: string, message?: string, };
+
+export type FileEntry = { name: string, type: string, size: bigint | null, };
+
+export type FileListingResponse = { path: string, entries: Array<FileEntry>, };
+
+export type GrantItem = { id: string, scope: string, user_id: string | null, group_id: string | null, permission: string, resource_id: string | null, granted: boolean, created_at: string, };
+
+export type GrantListResponse = { grants: Array<GrantItem>, };
+
+export type HealthDetailed = { shittimChest: ConnectionStatus, scepter: ConnectionStatus, database: ConnectionStatus, activeSessions: number, uptime: bigint, version: string, };
+
+/**
+ * Standard /api/health response for all plana backends.
+ */
+export type HealthResponse = { status: ServiceStatus, version: string, kind: BackendKind, uptime: bigint, network: NetworkInfo, build_hash: string | null, engine_version: string | null, };
+
+export type IdResponse = { id: string, };
+
+export type IpWhitelistResponse = { enabled: boolean, whitelist: Array<Record<string, unknown>>, };
+
+export type ModelInfo = { id: string, provider_name: string, provider_id: string, category: string, };
+
+export type MyPermissions = { role: string, permissions: Array<string>, };
+
+/**
+ * Network context from the incoming request.
+ */
+export type NetworkInfo = { transport: string, region: string, asn: number | null, };
+
+export type OAuthProvider = { provider: string, client_id: string, client_secret_masked: string, public_domain: string, enabled: boolean, };
+
+export type OkIdResponse = { ok: boolean, id: string, };
+
+export type OkMessageResponse = { ok: boolean, message: string, };
+
+export type OkResponse = { ok: boolean, };
+
+export type PermissionsResponse = { role: string, permissions: Array<string>, };
+
+export type ProjectItem = { id: string, name: string, description: string | null, sort_order: number, created_at: string, updated_at: string, };
+
+export type ProviderPublic = { id: string, name: string, endpoint: string, api_key_masked: string, models: Array<string>, category: string, is_default: boolean, enabled: boolean, priority: number, };
+
+export type ProxySystemInfo = { version: string, nodeVersion: string, platform: string, cpuUsage: number, memoryUsage: number, diskUsage: number, };
+
+export type RbacGroup = { id: string, name: string, description: string, member_count: number, created_at: string, updated_at: string, };
+
+export type RbacGroupsResponse = { groups: Array<RbacGroup>, };
+
+export type RbacUser = { id: string, username: string, email: string, display_name: string, avatar_url: string | null, is_active: boolean, is_admin: boolean, role: string, tier: string, created_at: string, };
+
+export type RbacUsersResponse = { users: Array<RbacUser>, };
+
+export type ReadinessResponse = { status: string, database: boolean, };
+
+export type ResourceQuota = { id: string, name: string, resource_type: string, limit_value: number, limit_unit: string, used_value: number, period: string, tier: string, enabled: boolean, };
+
+export type ResourceQuotaListResponse = { quotas: Array<ResourceQuota>, };
+
+export type ResourceUsageResponse = { summary: Array<ResourceUsageSummary>, };
+
+export type ResourceUsageSummary = { resource_type: string, current_usage: number, unit: string, limit: number, period: string, utilization_pct: number, };
+
+export type SceneBloom = { strength: number, radius: number, threshold: number, };
+
+export type SceneCamera = { position: SceneVec3, target: SceneVec3, bookmarks?: { [key in string]: SceneCameraBookmark } | null, };
+
+export type SceneCameraBookmark = { position: SceneVec3, target: SceneVec3, };
+
+export type SceneConfigItem = { project_id: string, background_color: string, ground: SceneGround | null, lighting: SceneLighting | null, grid: SceneGrid, camera: SceneCamera, bloom: SceneBloom, ambient_light_intensity: number, };
+
+export type SceneGrid = { visible: boolean, size: number, divisions: number, };
+
+export type SceneGround = { enabled: boolean, size_x: number, size_z: number, color: string, y: number, grid_visible: boolean, grid_size: number, grid_divisions: number, grid_color: string, grid_opacity: number, };
+
+export type SceneLighting = { ambient_color: [number, number, number], ambient_intensity: number, directional_color: [number, number, number], directional_intensity: number, directional_position: [number, number, number], };
+
+export type SceneVec3 = { x: number, y: number, z: number, };
+
+/**
+ * Service health status. Serde uses lowercase so JSON returns "ok" etc.
+ */
+export type ServiceStatus = "ok" | "degraded" | "unhealthy";
+
+export type SessionCreateResponse = { session_id: string, status: string, signaling?: Record<string, unknown>, };
+
+export type SetupCheckResponse = { needs_setup: boolean, locale?: string, registration_enabled: boolean, };
+
+export type SkillItem = { skill_id: string, name: string, description: string, category: string, agent: string, agent_types: Array<string>, parameters: Array<SkillParameterItem>, estimated_duration_secs: bigint, };
+
+export type SkillParameterItem = { name: string, type: string, default?: unknown, description: string | null, required: boolean, };
+
+export type StatusResponse = { status: string, agent_id?: string, platform?: string, id?: string, plugin_id?: string, };
+
+export type SystemInfoAgents = { total: number, running: number, idle: number, stopped: number, };
+
+export type SystemInfoConnections = { active_ws: number, active_http: number, };
+
+export type SystemInfoDatabase = { engine: string, size_mb: number, connections: number, };
+
+export type SystemInfoResources = { cpu_usage_pct: number, memory_used_gb: number, memory_total_gb: number, disk_used_gb: number, disk_total_gb: number, };
+
+export type SystemInfoResponse = { version: string, uptime_secs: bigint, agents: SystemInfoAgents, resources: SystemInfoResources, connections: SystemInfoConnections, database: SystemInfoDatabase, };
+
+export type TierDefinition = { tier: string, daily_request_limit: number, monthly_token_limit: number, max_sessions: number, price: string, };
+
+export type TierListResponse = { tiers: Array<TierDefinition>, };
+
+export type TokenUsageResponse = { usage: Array<UsageEntry>, total_tokens: bigint, };
+
+export type ToolItem = { tool_id: string, name: string, description: string, category: string, agent: string, input_schema: Record<string, unknown>, output_schema?: Record<string, unknown>, };
+
+export type UpdateUserTierPayload = { user_id: string, tier: string, };
+
+export type UsageDataResponse = { period: string, total_tokens: bigint, total_cost_usd: number, by_model: Array<UsageModelEntry>, by_day: Array<UsageDayEntry>, };
+
+export type UsageDayEntry = { date: string, tokens: bigint, requests: number, };
+
+export type UsageEntry = { model: string, token_count: bigint, };
+
+export type UsageModelEntry = { model: string, tokens: bigint, cost_usd: number, requests: number, };
+
+export type UserPreferences = { theme?: string, themeMode?: string, chatMode?: string, locale?: string, };
+
+export type UserProfileResponse = { id: string, username: string, email: string, display_name: string, avatar_url: string | null, is_active: boolean, is_admin: boolean, role: string, groups: Array<RbacGroup>, preferences?: UserPreferences, created_at: string, };
+
+export type UserTierInfo = { user_id: string, tier: string, tier_expires_at?: string, daily_quota_used: number, monthly_token_used: number, last_quota_reset_at?: string, };
+
+export type ValidateKeyResponse = { valid: boolean, models: Array<string>, recommended_models: Array<string>, error: string | null, };
+
+export type VendorInfo = { id: string, name: string, endpoint: string, category: string, description: string, recommended_models: Array<string>, plan_models: { [key in string]: Array<string> }, };
+
+export type WebhookDeliveryGenItem = { id: string, webhook_id: string, event: string, status: number, duration_ms: bigint, timestamp: string, request_headers: { [key in string]: string }, response_body?: Record<string, unknown>, };
+
+export type WebhookDeliveryItem = { id: string, webhookId: string, event: string, statusCode: number, requestHeaders: { [key in string]: string }, requestBody?: Record<string, unknown>, responseHeaders?: { [key in string]: string }, responseBody: string, duration: bigint, success: boolean, deliveredAt: string, };
+
+export type WebhookInfoItem = { name: string, url: string, events: Array<string>, };
+
+export type WebhookItem = { id: string, name: string, url: string, platform: string, secret: string, events: Array<string>, status: string, lastDeliveryAt?: string, createdAt: string, updatedAt: string, };
+
+export type WebhookListResponse = { webhooks: Array<WebhookInfoItem>, };
+
+export type WorkspaceItem = { id: string, path: string, editor: string, git_branch: string, status: string, connected: boolean, short_id: string, alias?: string, connection_kind: string, };
+
+export type WorkspaceResolveResponse = { workspace_uuid: string, short_id: string, alias?: string, path: string, };
+
+export type WorkspaceSessionResponse = { workspace_id: string, workspace_path: string, editor_name: string, editor_version: string, git_branch: string, cursor?: CursorState, connected_at: string, last_heartbeat: string, };

package/bindings/index.ts

@@ -0,0 +1,47 @@
+// WS protocol — foundational shared enums (Agent, AgentStatus, TaskStatus, …).
+export * from "./ws/core";
+// WS protocol — per-domain message param structs.
+export * from "./ws/handshake";
+export * from "./ws/noa";
+export * from "./ws/logs";
+export * from "./ws/agentLifecycle";
+export * from "./ws/tasks";
+export * from "./ws/llmProvider";
+export * from "./ws/stateSync";
+export * from "./ws/knowledgeBase";
+export * from "./ws/layer2";
+export * from "./ws/workspace";
+export * from "./ws/systemUi";
+export * from "./ws/auth";
+export * from "./ws/yolo";
+export * from "./ws/baseMessages";
+export * from "./ws/industrial";
+export * from "./ws/views";
+export * from "./ws/fileBrowsing";
+export * from "./ws/bridgeNetwork";
+// Malkuth supervision protocol types (restart authorization gate).
+// HealthResponse is re-exported under a distinct name because the HTTP REST
+// types below export a same-named type; TS forbids two `export *` collisions.
+export {
+  type GateDecision,
+  type RestartRisk,
+  type RestartGateDecision,
+  type RestartProposal,
+  type ConnectionProtocol,
+  type WorkerState,
+  type ConnectionEndpoint,
+  type DrainRequest,
+  type HealthResponse as MalkuthHealthResponse,
+  type WorkerRegistration,
+  type WorkerStatus,
+} from "./ws/malkuth";
+// HTTP REST API types.
+export * from "./httpTypes";
+// Unified model management types.
+export * from "./model";
+// Shared domain vocabulary enums.
+export * from "./enums";
+// Celestia Engine Protocol (CEP) — model-runtime interchange types.
+export * from "./engine";
+// Per-agent MCP tool request/result types (namespaced).
+export * as mcp from "./mcp";

package/bindings/mcp/aporia.ts

@@ -0,0 +1,61 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AnomalyDetectParams = { values: Array<number>, method: string | null, threshold: number | null, timestamps: Array<bigint> | null, window_size: number | null, };
+
+export type AnomalyInfo = { index: number, value: number, expected: number, deviation: number, timestamp: bigint | null, severity: string, };
+
+export type AnomalyResult = { anomalies: Array<AnomalyInfo>, total_points: number, anomaly_count: number, anomaly_ratio: number, method: string, threshold: number, };
+
+export type CausalReasonParams = { target: string, target_values: Array<number>, candidates: { [key in string]: Array<number> } | null, max_lag: number | null, };
+
+export type CausalReasonResult = { correlations: Array<CorrelationInfo>, hypotheses: Array<Hypothesis>, recommended_actions: Array<string>, confidence: number, };
+
+export type CorrelationInfo = { variable: string, correlation: number, lag: number, direction: string, };
+
+export type Hypothesis = { cause: string, effect: string, strength: number, reasoning: string, };
+
+export type LlmChatParams = { prompt: string, model: string | null, system_prompt: string | null, };
+
+export type LlmChatResult = { model: string, tokens: string, response: string, };
+
+export type MediaAssetItem = { asset_id: string, asset_type: string, source_url: string, metadata: Record<string, unknown>, tags: Array<string>, created_at: string, };
+
+export type MediaAssetRegisterResult = { asset_id: string, asset_type: string, source_url: string, tags: Array<string>, };
+
+export type MediaAssetRetrieveResult = { count: number, assets: Array<MediaAssetItem>, };
+
+export type RagDbDeleteParams = { id: string, };
+
+export type RagDbDeleteResult = { doc_id: string, };
+
+export type RagDbReadParams = { query_embedding: Array<number>, limit: number | null, };
+
+export type RagDbReadResult = { count: number, results: Array<RagDocResult>, };
+
+export type RagDbStatsParams = Record<symbol, never>;
+
+export type RagDbStatsResult = { total_documents: number, total_media_assets: number, embedding_dimensions: number | null, storage_backend: string, };
+
+export type RagDbWriteParams = { content: string, embedding: Array<number> | null, metadata: Record<string, unknown> | null, source: string | null, };
+
+export type RagDbWriteResult = { doc_id: string, embedding_dim: number, content: string, };
+
+export type RagDocResult = { doc_id: string, similarity: number, content: string, source: string | null, metadata: Record<string, unknown> | null, };
+
+export type TranslateReportParams = { content: string, target_language: string | null, };
+
+export type TranslateReportResult = { target_language: string, original_length: number, translated_length: number, translation: string, };
+
+export type WorkspaceIndexParams = { workspace_root: string, full_rebuild: boolean | null, };
+
+export type WorkspaceIndexResult = { total_files: number, total_chunks: number, total_bytes: number, duration_ms: bigint, };
+
+export type WorkspaceSearchDoc = { doc_id: string, file_path: string, start_line: number, end_line: number, language: string, similarity: number, snippet: string, };
+
+export type WorkspaceSearchParams = { query: string, limit: number | null, };
+
+export type WorkspaceSearchResult = { count: number, results: Array<WorkspaceSearchDoc>, };
+
+export type WorkspaceStatusParams = Record<symbol, never>;
+
+export type WorkspaceStatusResult = { total_files: number, total_chunks: number, total_bytes: number, last_indexed: string | null, is_indexing: boolean, };