@celestia-island/plana-types 0.1.0

package/bindings/model.ts

@@ -0,0 +1,240 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModelTier } from "./ws/core";
+
+/**
+ * Generation quality tier — applies to image / 3D generation models.
+ *
+ * Distinct from [`super::ModelTier`] (which ranks LLM reasoning depth),
+ * `GenerationTier` ranks output fidelity vs. speed for generative models.
+ */
+export type GenerationTier = "fast_preview" | "standard" | "production";
+
+/**
+ * Minimum hardware requirements for a local generative model.
+ *
+ * Populated for GPU-deployed models (TRELLIS, SDXL …). Remote-API models
+ * leave this as `None`.
+ */
+export type HardwareRequirements = { 
+/**
+ * Minimum VRAM in GB.
+ */
+min_vram_gb?: number, 
+/**
+ * Minimum system RAM in GB.
+ */
+min_ram_gb?: number, 
+/**
+ * Recommended GPU (e.g. `"NVIDIA RTX 4090"`).
+ */
+recommended_gpu?: string, };
+
+/**
+ * Where a model physically executes. evernight chooses the backend based on
+ * GPU availability — GPU-first, CPU-fallback.
+ */
+export type ModelBackend = "remote_api" | "gpu" | "cpu";
+
+/**
+ * Fine-grained model capability flags.
+ *
+ * Whereas [`ModelCategory`] answers "what kind of model is this?",
+ * `ModelCapability` answers "what specific things can this model do?".
+ * Skills declare their `required_capabilities`; the scepter router filters
+ * available models by capability intersection.
+ *
+ * This replaces the scattered boolean flags (`supports_vision`,
+ * `supports_function_calling` …) with a single extensible enum. The booleans
+ * remain for backward compatibility but are superseded by this enum when
+ * present.
+ */
+export type ModelCapability = "text_chat" | "text_streaming" | "function_calling" | "reasoning" | "code_generation" | "text_embedding" | "speech_to_text" | "text_to_speech" | "image_input" | "video_input" | "visual_critique" | "text_to_image" | "image_to_image" | "image_edit" | "image_upscale" | "text_to_3d" | "image_to_3d" | "three_d_edit" | "three_d_export" | "pbr_texturing" | "mesh_optimization";
+
+/**
+ * Top-level model category. Determines which subsystem consumes the model.
+ */
+export type ModelCategory = "llm" | "embedding" | "speech_to_text" | "text_to_speech" | "image_generation" | "three_d_generation" | "multi_modal";
+
+/**
+ * A unified description of an AI model, shared between scepter and chest.
+ *
+ * Both sides can enumerate available models, check their status, and request
+ * inference using this common vocabulary.
+ */
+export type ModelDescriptor = { 
+/**
+ * Unique id, e.g. `"bge-m3"`, `"whisper-tiny"`, `"claude-opus-4.8"`.
+ */
+id: string, 
+/**
+ * Human-readable display name.
+ */
+display_name: string, 
+/**
+ * What kind of model this is.
+ */
+category: ModelCategory, 
+/**
+ * Where it runs.
+ */
+backend: ModelBackend, 
+/**
+ * Size tier (LLM coding-plan concept; `None` for non-LLM models).
+ */
+tier?: ModelTier, 
+/**
+ * Output dimension (embedding models only).
+ */
+dimension?: number, 
+/**
+ * Approximate model size in bytes (local models).
+ */
+size_bytes?: bigint, 
+/**
+ * Provider index (`#N` convention; LLM models only).
+ */
+provider_index?: number, 
+/**
+ * Fine-grained capability flags. When non-empty, the scepter router uses
+ * these to match skills that declare `required_capabilities`. When empty,
+ * falls back to the legacy boolean flags on `ModelFsInfo`.
+ */
+capabilities: Array<ModelCapability>, 
+/**
+ * Generation quality tier (image / 3D generation models only).
+ */
+generation_tier?: GenerationTier, 
+/**
+ * Hardware requirements (local generative models only).
+ */
+hardware_requirements?: HardwareRequirements, };
+
+/**
+ * A model inference request, sent from the web UI to the upstream engine
+ * over the WS JSON-RPC channel. The engine routes it to the appropriate
+ * backend (local CPU / local GPU / remote GPU / remote API).
+ */
+export type ModelInferenceRequest = { 
+/**
+ * Which model to use (by id).
+ */
+model_id: string, 
+/**
+ * Input data (format depends on category: text for LLM/embedding,
+ * base64 audio for STT, base64 image for vision).
+ */
+input: string, 
+/**
+ * Optional parameters (temperature, max_tokens, language hint …).
+ */
+parameters?: Record<string, unknown>, };
+
+/**
+ * Inference result returned to the web UI.
+ */
+export type ModelInferenceResult = { 
+/**
+ * Model that produced the output.
+ */
+model_id: string, 
+/**
+ * Output data (text for LLM/embedding/TTS, text for STT, JSON for vision).
+ */
+output: string, 
+/**
+ * Time spent (milliseconds).
+ */
+elapsed_ms?: bigint, 
+/**
+ * Token/processing usage (if applicable).
+ */
+usage?: Record<string, unknown>, };
+
+/**
+ * `Sync.ModelInferenceResult` — inference result push.
+ */
+export type ModelInferenceResultParams = { result: ModelInferenceResult, };
+
+/**
+ * `Sync.ModelList` — model catalogue response.
+ */
+export type ModelListParams = { models: Array<ModelDescriptor>, servers: Array<ModelServerInfo>, };
+
+/**
+ * What to do with a model server.
+ */
+export type ModelServerAction = "start" | "stop" | "restart";
+
+/**
+ * `Sync.ModelServerActionResult` — action result.
+ */
+export type ModelServerActionResultParams = { kind: ModelServerKind, status: ModelServerStatus, };
+
+/**
+ * A managed model server instance, deployed and owned by **evernight**.
+ * Neither scepter nor chest starts/stops these directly — they issue
+ * `RequestModelServerAction` and evernight performs the lifecycle.
+ */
+export type ModelServerInfo = { 
+/**
+ * Server kind (determines the Docker image / launch command).
+ */
+kind: ModelServerKind, 
+/**
+ * HTTP endpoint (e.g. `http://localhost:8178`).
+ */
+endpoint: string, 
+/**
+ * Current lifecycle status.
+ */
+status: ModelServerStatus, 
+/**
+ * Which backend this server is running on (GPU or CPU).
+ */
+backend: ModelBackend, 
+/**
+ * Docker container id (managed by evernight's container runtime).
+ */
+container_id?: string, 
+/**
+ * Which models are loaded in this server.
+ */
+loaded_models: Array<string>, };
+
+/**
+ * The type of model server. evernight deploys and manages these; the choice
+ * of GPU vs CPU variant is made by evernight at deploy time (GPU-first).
+ */
+export type ModelServerKind = "ollama" | "whisper_cpp" | "vllm";
+
+/**
+ * Status of a local model server (ollama, whisper.cpp, …).
+ */
+export type ModelServerStatus = "running" | "starting" | "stopped" | "failed";
+
+/**
+ * `Sync.RequestModelInference` — ask the engine to run a model.
+ */
+export type RequestModelInferenceParams = { request: ModelInferenceRequest, };
+
+/**
+ * `Sync.RequestModelList` — enumerate available models.
+ */
+export type RequestModelListParams = { 
+/**
+ * Filter by category (omit for all).
+ */
+category?: ModelCategory, };
+
+/**
+ * `Sync.RequestModelServerAction` — ask evernight (via scepter) to start /
+ * stop / restart a model server. Neither chest nor scepter performs the
+ * deployment directly; the action is forwarded to evernight's model lifecycle
+ * manager.
+ */
+export type RequestModelServerActionParams = { kind: ModelServerKind, action: ModelServerAction, 
+/**
+ * Preferred backend. evernight will honour this if possible; falls back
+ * to CPU if the requested GPU is unavailable.
+ */
+preferred_backend?: ModelBackend, };

package/bindings/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@celestia-island/plana-types",
+  "version": "0.1.0",
+  "private": true,
+  "description": "TypeScript type bindings for the plana protocol crate (auto-generated by ts-rs)",
+  "main": "index.ts",
+  "types": "index.ts",
+  "files": [
+    "index.ts",
+    "ws/",
+    "httpTypes.ts",
+    "model.ts",
+    "enums.ts",
+    "mcp/"
+  ]
+}

package/bindings/region.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 RegionPolicy = { "china": { icp_number: string | null, data_residency_required: boolean, payment_domestic_only: boolean, pipi_consent_required: boolean, } } | { "european_union": { gdpr_consent_required: boolean, right_to_deletion: boolean, right_to_export: boolean, dpo_contact: string | null, cookie_consent_required: boolean, } } | { "russia": { data_localization_required: boolean, payment_mir_supported: boolean, } } | "free_market";

package/bindings/serde_json/JsonValue.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 JsonValue = number | string | boolean | Array<JsonValue> | { [key in string]: JsonValue } | null;

package/bindings/ws/agentLifecycle.ts

@@ -0,0 +1,41 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Agent, AgentStatus, CompletionOutcome, LlmStream, ModelTier, ReportSelection, ReportType, RequestState, RouteInfo, SkillStage, StreamChunkKind, StructuredAgentError, WorkStatus } from "./core";
+
+export type AgentListResponseParams = { agents: Array<TuiAgentInfo>, };
+
+export type AgentReportParams = { report_type: ReportType, agent_type: Agent, agent_id: string, agent_number?: string, title: string, content: string, summary?: string, timestamp: string, preset_options: Array<string>, 
+/**
+ * For `report_type: "query"`: whether `preset_options` are mutually
+ * exclusive (single) or pick-any (multiple). Omit ⇒ single.
+ */
+selection_mode?: ReportSelection, 
+/**
+ * For `report_type: "query"`: whether the recipient may type a free-form
+ * answer in addition to (or instead of) picking presets. Omit ⇒ true
+ * when `report_type == Query`, false otherwise.
+ */
+allow_custom_reply?: boolean, 
+/**
+ * Subset of `preset_options` the agent suggests. Empty when no
+ * recommendation is offered.
+ */
+recommended_options: Array<string>, model_name?: string, token_usage?: [number, number], skill_count?: number, mcp_count?: number, next_route?: RouteInfo, stream?: LlmStream, error?: StructuredAgentError, };
+
+/**
+ * Reply payload for an inquiry (`report_type: "query"`) report.
+ *
+ * Wire method: `Sync.AgentReportReply` (server-bound). `report_id` mirrors
+ * the `agent_id` of the originating `AgentReportParams` so the upstream can
+ * correlate without keeping a separate consultation registry.
+ */
+export type AgentReportReplyParams = { report_id: string, selected_options: Array<string>, custom_answer?: string, timestamp: string, };
+
+export type AgentResponseParams = { agent_type: Agent, agent_id: string, agent_number?: string, content: string, timestamp: string, parent_id?: string, };
+
+export type AgentStreamingChunkParams = { agent_type: Agent, agent_id: string, agent_number?: string, chunk: string, is_done: boolean, timestamp: string, task_id?: string, chunk_kind?: StreamChunkKind, };
+
+export type McpToolResultParams = { tool_name: string, call_id: string, parameters_summary?: string, result: string, agent_type: Agent, agent_id: string, agent_number?: string, success: boolean, duration_ms?: bigint, };
+
+export type OrchestrationStatusParams = { stage: SkillStage, agent: string, agent_type?: Agent, tool_name?: string, call_id?: string, parent_agent?: string, parameters_summary?: string, };
+
+export type TuiAgentInfo = { agent_type: Agent, agent_number?: string, agent_uuid?: string, agent_id: string, status: AgentStatus, llm_working: boolean, cpu_usage: number, memory_mb: bigint, parent_id?: string, work_status?: WorkStatus, current_model?: string, model_tier?: ModelTier, llm_handle?: string, token_usage?: [number, number], mcp_tool_calls: number, request_state: RequestState, completion_outcome: CompletionOutcome, retry_count: number, max_retries: number, };

package/bindings/ws/auth.ts

@@ -0,0 +1,15 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AuthChangePasswordResponseParams = { ok: boolean, error?: string, };
+
+export type AuthDeleteUserResponseParams = { ok: boolean, error?: string, };
+
+export type AuthGetUserResponseParams = { ok: boolean, user?: UserProfileSummary, error?: string, };
+
+export type AuthListUsersResponseParams = { ok: boolean, users?: Array<UserProfileSummary>, error?: string, };
+
+export type AuthLoginResponseParams = { ok: boolean, token?: string, session_id?: string, user_id?: string, username?: string, display_name?: string, role?: string, error?: string, };
+
+export type AuthRegisterResponseParams = { ok: boolean, user_id?: string, username?: string, error?: string, };
+
+export type UserProfileSummary = { id: string, username: string, email: string, display_name: string, role: string, is_active: boolean, };

package/bindings/ws/baseMessages.ts

@@ -0,0 +1,7 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type BaseAckParams = { message_id: string, };
+
+export type BaseErrorParams = { code: string, message: string, };
+
+export type BaseHeartbeatParams = { timestamp: bigint, };

package/bindings/ws/bridgeNetwork.ts

@@ -0,0 +1,71 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * `Sync.BridgeNetwork` — the host/workspace roster response/push.
+ */
+export type BridgeNetworkParams = { hosts: Array<HostMetrics>, workspaces: Array<WorkspaceNode>, };
+
+/**
+ * Live performance snapshot for one host machine.
+ */
+export type HostMetrics = { 
+/**
+ * Stable host id ("localhost" for self, or a polemos device id).
+ */
+host_id: string, hostname: string, os: string, 
+/**
+ * CPU utilisation, 0..100.
+ */
+cpu_usage_percent: number, 
+/**
+ * Logical CPU core count (shown with an i18n "cores" unit).
+ */
+cpu_cores: number, mem_used_bytes: bigint, mem_total_bytes: bigint, 
+/**
+ * Outbound network rate (bytes/sec). Omitted when unknown.
+ */
+net_up_bps?: bigint, 
+/**
+ * Inbound network rate (bytes/sec). Omitted when unknown.
+ */
+net_down_bps?: bigint, };
+
+/**
+ * `Sync.RequestBridgeNetwork` — request the host/workspace roster.
+ */
+export type RequestBridgeNetworkParams = Record<symbol, never>;
+
+/**
+ * noa-git status for a workspace checkout (branch / dirty / ahead / behind).
+ */
+export type WorkspaceGitStatus = { branch: string, 
+/**
+ * Modified/untracked file count.
+ */
+modified: number, 
+/**
+ * Commits ahead of upstream.
+ */
+ahead: number, 
+/**
+ * Commits behind upstream.
+ */
+behind: number, 
+/**
+ * `true` when there are uncommitted changes.
+ */
+dirty: boolean, };
+
+/**
+ * A workspace attached to a host, with its git + token-usage summary.
+ */
+export type WorkspaceNode = { workspace_id: string, host_id: string, path: string, alias?: string, git?: WorkspaceGitStatus, 
+/**
+ * Top token consumers in this workspace (max 3).
+ */
+token_usage: Array<WorkspaceTokenUsage>, };
+
+/**
+ * One agent's token usage within a workspace (top-N entries).
+ */
+export type WorkspaceTokenUsage = { agent: string, input: bigint, output: bigint, };

package/bindings/ws/core.ts

@@ -0,0 +1,51 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type Agent = "HapLotes" | "SkoPeo" | "HubRis" | "KaLos" | "NeiKos" | "SkeMma" | "ApoRia" | "EleOs" | "EpieiKeia" | "OreXis" | "PhiLia" | "PoleMos" | "WebAutomation";
+
+export type AgentBadge = string;
+
+export type AgentErrorCode = "model_no_providers" | "model_no_models" | "model_tier_mismatch" | "model_all_excluded" | "model_env_incomplete" | "model_selection_retry_exhausted" | "llm_call_failed" | "llm_empty_response" | "llm_rate_limited" | "llm_auth_failed" | "llm_timeout" | "cosmos_no_connection" | "cosmos_tool_failed" | "cosmos_local_unavailable" | "chain_max_depth" | "chain_cycle" | "chain_failed" | "skill_failed" | "skill_empty_output" | "skill_missing_report";
+
+export type AgentStatus = "Initializing" | "Online" | "Busy" | "Offline" | "Error";
+
+export type CompletionOutcome = "None" | "Reported" | "Failed";
+
+export type ContainerStatus = "created" | "running" | "paused" | "restarting" | "removing" | "exited" | "dead" | "unknown";
+
+export type EmbeddingModel = "OpenAiSmall" | "OpenAiLarge" | "OpenAiAda" | "Custom";
+
+export type KnowledgeBaseStatus = "Uninitialized" | "Indexing" | "Ready" | "Error";
+
+export type LlmStream = { segments: Array<StreamSegment>, };
+
+export type ModelTier = "Deep" | "Normal" | "Basic";
+
+export type PeriodType = "Hour5" | "Day7" | "Month1";
+
+/**
+ * Selection semantics for an inquiry (`report_type: "query"`) report's
+ * `preset_options`. Defaults to `Single` when omitted.
+ */
+export type ReportSelection = "single" | "multiple";
+
+export type ReportType = "query" | "human" | "reply" | "skill_terminal" | "skill_step" | "next_action_fallback" | "chain_max_depth" | "chain_cycle" | "skill_failed" | "skill_empty_output" | "skill_missing_report" | "error" | "system" | "pending";
+
+export type RequestState = "Idle" | "Waiting" | "Streaming" | "Retrying" | "WaitingTool";
+
+export type RetryReason = "EmptyOutput" | "ReportNotCaptured" | { "LlmError": { message: string, } };
+
+export type RouteInfo = { direction: string, target: string, target_token?: string, };
+
+export type SkillStage = { "Started": string } | { "Done": string } | { "Complete": string } | { "Failed": string } | { "ToolCall": string } | { "Retrying": [string, number, number, RetryReason | null] } | { "TryingModel": [string, string] } | { "ModelFailed": [string, string, string] } | { "Nudging": string };
+
+export type StreamChunkKind = "Text" | "Thinking" | "DeepThinking";
+
+export type StreamSegment = { "Text": { text: string, message_id?: string, } } | { "Thinking": { text: string, message_id?: string, } } | { "DeepThinking": { text: string, message_id?: string, } } | { "McpCall": { tool_name: string, call_id: string, params: unknown, agent_type?: string, message_id?: string, } } | { "McpResult": { tool_name: string, call_id: string, success: boolean, data: unknown, duration_ms?: bigint, agent_type?: string, message_id?: string, } };
+
+export type StructuredAgentError = { code: AgentErrorCode, detail?: string, context: { [key in string]: string }, };
+
+export type TaskStatus = "not_started" | "in_progress" | "paused" | "completed" | "failed" | "warning" | { "waiting": { deadline: string, handle: string, } };
+
+export type WorkStatus = "Thinking" | "StreamingResponse" | { "Executing": { skill_name: string, } } | { "Retrying": { retry_count: number, max_retries: number, } } | "Nudging" | "Completed" | "RequestFailed" | "Failed" | "ToolLoopTerminated" | "CallingTool";
+
+export type YoloTaskTier = "realtime" | "periodic" | "daily" | "strategic";

package/bindings/ws/fileBrowsing.ts

@@ -0,0 +1,57 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * `Sync.FileRead` — file-content response.
+ */
+export type FileReadParams = { target: FileTarget, path: string, content: string, size: bigint, 
+/**
+ * `true` when content was truncated to the server read cap.
+ */
+truncated: boolean, };
+
+/**
+ * A file-operation target — a (kind, id) pair plus optional workspace
+ * context (container slots are per-workspace).
+ */
+export type FileTarget = { kind: FileTargetKind, 
+/**
+ * Container badge (`#demiurge` / `#001`), host id, or workspace id.
+ */
+id: string, 
+/**
+ * Owning workspace id (container slots are workspace-scoped).
+ */
+workspace_id?: string, };
+
+/**
+ * Which filesystem a file operation targets.
+ */
+export type FileTargetKind = "container" | "host" | "workspace";
+
+/**
+ * One entry in a directory listing.
+ */
+export type FileTreeEntry = { name: string, 
+/**
+ * `"file"` | `"dir"` | `"symlink"`.
+ */
+kind: string, size: bigint, };
+
+/**
+ * `Sync.FileTree` — directory listing response.
+ */
+export type FileTreeParams = { target: FileTarget, path: string, entries: Array<FileTreeEntry>, };
+
+/**
+ * `Sync.RequestFileRead` — read a single (text) file, capped server-side.
+ */
+export type RequestFileReadParams = { target: FileTarget, path: string, };
+
+/**
+ * `Sync.RequestFileTree` — list one level of a directory.
+ */
+export type RequestFileTreeParams = { target: FileTarget, 
+/**
+ * Sub-path under the target root (empty/`""` = root).
+ */
+path: string, };

package/bindings/ws/handshake.ts

@@ -0,0 +1,23 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ClientCapability = "file_relay" | "terminal" | "screen_capture" | "noa_workspace";
+
+export type ClientNodeInfo = { hostname: string, os: string, workspace_root?: string, user_id?: string, };
+
+export type ConnectHandshakeParams = { 
+/**
+ * Handshake wire-protocol version advertised by the client. Defaults to
+ * [`HANDSHAKE_VERSION`] when absent (backward-compatible with old clients).
+ */
+protocol_version: number, token: string, session_id?: string, capabilities: Array<ClientCapability>, node_info?: ClientNodeInfo, 
+/**
+ * Stringified UUID — kept as a string on the wire so consumers
+ * don't need a UUID parser to round-trip the JSON-RPC payload.
+ */
+workspace_id?: string, };
+
+export type HandshakeAckParams = { ok: boolean, error?: string, };
+
+export type PingParams = { timestamp: bigint, };
+
+export type ScepterIdentityParams = { device_id: string, };

package/bindings/ws/industrial.ts

@@ -0,0 +1,72 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type IndustrialAlarmAckParams = { station_id: string, address: string, acknowledged_by: string, };
+
+/**
+ * Fired on threshold breach (breached=true) or clear (breached=false).
+ */
+export type IndustrialAlarmEvent = { station_id: string, protocol: string, address: string, field_name: string, level: IndustrialAlarmLevel, value: number, threshold: number, unit: string, breached: boolean, timestamp: string, };
+
+export type IndustrialAlarmHistory = { entries: Array<IndustrialAlarmHistoryEntry>, total: bigint, };
+
+/**
+ * One entry in the historical alarm log (last N days).
+ */
+export type IndustrialAlarmHistoryEntry = { station_id: string, protocol: string, address: string, field_name: string, level: IndustrialAlarmLevel, value: number, threshold: number, unit: string, breached: boolean, timestamp: string, 
+/**
+ * Whether an operator acknowledged the alarm, and when.
+ */
+acknowledged: boolean, acknowledged_at?: string, acknowledged_by?: string, };
+
+/**
+ * Severity ordering matches ISA-18.2 alarm severity.
+ */
+export type IndustrialAlarmLevel = "Log" | "LowLow" | "Low" | "High" | "HighHigh" | "RateOfChange" | "Emergency";
+
+export type IndustrialAlarmPushParams = { alarm: IndustrialAlarmEvent, };
+
+export type IndustrialAlarmThresholds = { ll?: number, l?: number, h?: number, hh?: number, };
+
+/**
+ * Phases of an evernight discovery scan. Ordered by typical progress.
+ */
+export type IndustrialDiscoveryPhase = "TransportScan" | "ProtocolIdentify" | "DataModelScan" | "SemanticInference" | "ManifestGeneration" | "ManifestValidation" | "Complete";
+
+export type IndustrialDiscoveryProgress = { session_id: string, phase: IndustrialDiscoveryPhase, message: string, found_devices: bigint, progress_percent: number, raw_findings?: Record<string, unknown> | null, };
+
+export type IndustrialDiscoveryProgressPushParams = { event: IndustrialDiscoveryProgress, };
+
+/**
+ * A single live reading from an industrial field (e.g. pressure cell on a
+ * Modbus register, S7 DBX bit). Pushed by scepter at the scan cycle of the
+ * underlying transport.
+ */
+export type IndustrialSensorReading = { station_id: string, protocol: string, address: string, name: string, raw_value: number, scaled_value: number, unit: string, quality: string, timestamp: string, };
+
+export type IndustrialStationField = { address: string, name: string, data_type: string, unit?: string, alarm?: IndustrialAlarmThresholds, current_value?: number, };
+
+export type IndustrialStationInfo = { station_id: string, protocol: string, connection: string, device_class: string, vendor?: string, model?: string, firmware?: string, status: string, fields: Array<IndustrialStationField>, };
+
+export type IndustrialTelemetryBatch = { readings: Array<IndustrialSensorReading>, station_id: string, timestamp: string, };
+
+export type IndustrialTelemetryPushParams = { batch: IndustrialTelemetryBatch, };
+
+export type IndustrialTopologyParams = { stations: Array<IndustrialStationInfo>, };
+
+export type WriteApprovalRequest = { 
+/**
+ * Unique id assigned by the producer (orexis). The operator UI echoes it
+ * back in `industrial.approveWrite` so scepter's resolver can match the
+ * response to the pending oneshot. `#[serde(default)]` keeps the wire
+ * format backward-compatible with older push events that predate it.
+ */
+request_id: string, station_id: string, protocol: string, address: string, field_name: string, current_value: number, proposed_value: number, unit: string, reason: string, agent: string, risk_level: WriteApprovalRisk, };
+
+export type WriteApprovalRequestParams = { request: WriteApprovalRequest, };
+
+export type WriteApprovalResponseParams = { request_id: string, approved: boolean, approved_by: string, modified_value?: number, };
+
+/**
+ * Operator confirmation gate for safety-critical PLC writes.
+ */
+export type WriteApprovalRisk = "safe" | "caution" | "critical";

package/bindings/ws/knowledgeBase.ts

@@ -0,0 +1,10 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { EmbeddingModel, KnowledgeBaseStatus } from "./core";
+
+export type GetKnowledgeBaseResponseParams = { knowledge_base?: KnowledgeBaseInfo, };
+
+export type KbGenericResponseParams = { ok: boolean, error?: string, id?: string, };
+
+export type KnowledgeBaseInfo = { id: string, name: string, description?: string, status: KnowledgeBaseStatus, embedding_model?: EmbeddingModel, custom_embedding_endpoint?: string, document_count: number, subscription_count: number, tags: Array<string>, created_at: string, updated_at: string, };
+
+export type ListKnowledgeBasesResponseParams = { knowledge_bases: Array<KnowledgeBaseInfo>, };

package/bindings/ws/layer2.ts

@@ -0,0 +1,25 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CustomAgentInfo = { name: string, display_name: string, description: string, skills_count: number, source: string, version?: string, last_updated?: string, };
+
+export type CustomAgentListResponseParams = { agents: Array<CustomAgentInfo>, };
+
+export type Layer2AgentInfo = { name: string, description: string, mcp_count: number, skills_count: number, languages: Array<string>, enabled: boolean, };
+
+export type Layer2AgentListResponseParams = { agents: Array<Layer2AgentInfo>, };
+
+export type Layer2AgentMcpResponseParams = { agent_name: string, tools: Array<Layer2McpToolInfo>, };
+
+export type Layer2AgentSkillsResponseParams = { agent_name: string, skills: Array<Layer2SkillInfo>, };
+
+export type Layer2McpPromptResponseParams = { agent_name: string, tool: string, lang: string, content: string, name: string, };
+
+export type Layer2McpToolInfo = { name: string, description: string, languages: Array<string>, references_layer1: Array<string>, references_layer2: Array<string>, related_items: Array<string>, referenced_by_items: Array<string>, };
+
+export type Layer2SkillInfo = { name: string, description: string, languages: Array<string>, references_layer1: Array<string>, references_layer2: Array<string>, related_items: Array<string>, referenced_by_items: Array<string>, };
+
+export type Layer2SkillPromptResponseParams = { agent_name: string, skill: string, lang: string, content: string, name: string, };
+
+export type SubscribeCustomAgentResponseParams = { success: boolean, error?: string, agent?: CustomAgentInfo, skills: Array<string>, permissions: Array<string>, };
+
+export type UnsubscribeCustomAgentResponseParams = { success: boolean, error?: string, };