@celestia-island/plana-types 0.1.0 → 0.1.2

package/bindings/mdd.ts

@@ -0,0 +1,444 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Named parameter schema for one API endpoint.
+ */
+export type MddApiSchema = { 
+/**
+ * Endpoint / schema name, e.g. `"submit"`.
+ */
+name: string, 
+/**
+ * Accepted parameters.
+ */
+params: Array<MddParam>, };
+
+/**
+ * One node of the model component DAG.
+ */
+export type MddComponent = { 
+/**
+ * Unique component id within the descriptor.
+ */
+id: string, 
+/**
+ * What role the component plays.
+ */
+kind: MddComponentKind, 
+/**
+ * Architecture hint, e.g. `"transformer-encoder"`.
+ */
+arch?: string, 
+/**
+ * DAG edges: ids of components this one depends on (upstream).
+ */
+dependencies: Array<string>, 
+/**
+ * Input contracts accepted by this component.
+ */
+inputs: Array<MddIoContract>, 
+/**
+ * Output contracts produced by this component.
+ */
+outputs: Array<MddIoContract>, 
+/**
+ * Runtimes available for this component (best-effort ordering).
+ */
+runtimes: Array<MddRuntime>, };
+
+/**
+ * The role a component plays inside a generative pipeline.
+ */
+export type MddComponentKind = "encoder" | "dit" | "vae" | "decoder" | "tokenizer" | "other";
+
+/**
+ * Deployment plan: pipeline stages plus the exposed inference API.
+ */
+export type MddDeploy = { 
+/**
+ * Ordered pipeline stages.
+ */
+pipeline: Array<MddPipelineStage>, 
+/**
+ * Inference API wiring.
+ */
+api: MddDeployApi, };
+
+/**
+ * Inference API exposed by the deployment.
+ */
+export type MddDeployApi = { 
+/**
+ * Task the API implements.
+ */
+task: MddTaskKind, 
+/**
+ * Submit request schema.
+ */
+submit: MddApiSchema, 
+/**
+ * Result response schema.
+ */
+result: MddApiSchema, };
+
+/**
+ * One deployment tier — a hardware / placement strategy for the whole model.
+ */
+export type MddDeployTier = { 
+/**
+ * Tier id, e.g. `"cloud-api"`, `"48gb-native"`.
+ */
+id: string, 
+/**
+ * Engines used by this tier.
+ */
+engines: Array<MddEngine>, 
+/**
+ * Quantization ids this tier is known to fit.
+ */
+quantizations: Array<string>, 
+/**
+ * Where the tier runs.
+ */
+placement: MddPlacement, 
+/**
+ * Minimum total VRAM in GB.
+ */
+min_vram_gb?: number, 
+/**
+ * Minimum GPU count.
+ */
+min_gpus?: number, 
+/**
+ * Free-form notes.
+ */
+notes?: string, };
+
+/**
+ * Top-level model deployment descriptor — the root of an MDD v1 document.
+ */
+export type MddDescriptor = { 
+/**
+ * Schema version of this descriptor (currently `1`).
+ */
+schema_version: number, 
+/**
+ * Model identity and architecture summary.
+ */
+model: MddModel, 
+/**
+ * Components that make up the model, as a DAG (see `dependencies`).
+ */
+components: Array<MddComponent>, 
+/**
+ * Inference pipeline and API wiring.
+ */
+deploy: MddDeploy, 
+/**
+ * Scale / sizing estimation for capacity planning.
+ */
+scale: MddScale, };
+
+/**
+ * Data type of an IO contract.
+ */
+export type MddDtype = "f32" | "f16" | "bf16" | "i8" | "u8" | "token_ids" | "text" | "other";
+
+/**
+ * Serving engine for a runtime.
+ */
+export type MddEngine = "llama_cpp" | "vllm" | "sglang" | "candle" | "ollama" | "cloud" | "external_api" | "native";
+
+/**
+ * Entry kind for a runtime.
+ */
+export type MddEntryKind = "file" | "url" | "registry" | "gguf";
+
+/**
+ * Minimum hardware requirement for a local runtime.
+ */
+export type MddHardwareRequirement = { 
+/**
+ * Minimum VRAM in MB.
+ */
+min_vram_mb?: bigint, 
+/**
+ * Minimum system RAM in MB.
+ */
+min_ram_mb?: bigint, 
+/**
+ * Minimum GPU count.
+ */
+min_gpus?: number, 
+/**
+ * CUDA compute capability, e.g. `"8.0"`.
+ */
+compute_capability?: string, };
+
+/**
+ * An input or output contract of a component.
+ */
+export type MddIoContract = { 
+/**
+ * Contract name, e.g. `"prompt"`, `"latents"`.
+ */
+name: string, 
+/**
+ * Data type of the tensor / value.
+ */
+dtype: MddDtype, 
+/**
+ * Optional shape description, e.g. `"[1, 4096]"`, `"token_ids"`.
+ */
+shape?: string, };
+
+/**
+ * Model identity block of an MDD descriptor.
+ */
+export type MddModel = { 
+/**
+ * Unique model id, e.g. `"demo-h3-mini"`.
+ */
+id: string, 
+/**
+ * Human-readable display name.
+ */
+name: string, 
+/**
+ * Model family / lineage, e.g. `"demo-dit"`.
+ */
+family?: string, 
+/**
+ * Architecture identifier, e.g. `"dit"`, `"llama"`.
+ */
+architecture: string, 
+/**
+ * Free-form description.
+ */
+description?: string, };
+
+/**
+ * A single parameter of an API schema.
+ */
+export type MddParam = { 
+/**
+ * Parameter name.
+ */
+name: string, 
+/**
+ * Type descriptor, e.g. `"string"`, `"integer"`, `"float"`.
+ */
+dtype: string, 
+/**
+ * Whether the parameter must be supplied.
+ */
+required: boolean, 
+/**
+ * Default value when omitted.
+ */
+default?: unknown, 
+/**
+ * Free-form description.
+ */
+description?: string, };
+
+/**
+ * When a pipeline stage runs.
+ */
+export type MddPipelinePhase = "pre" | "iterative" | "post";
+
+/**
+ * One stage of the inference pipeline.
+ */
+export type MddPipelineStage = { 
+/**
+ * Unique stage id within the pipeline.
+ */
+id: string, 
+/**
+ * When the stage runs.
+ */
+phase: MddPipelinePhase, 
+/**
+ * Cache key template (deterministic stages only).
+ */
+cache_key?: string, 
+/**
+ * Free-form description.
+ */
+description?: string, };
+
+/**
+ * Where a deploy tier runs.
+ */
+export type MddPlacement = "single_card" | "multi_card" | "cloud" | "external";
+
+/**
+ * A quantization variant of a runtime.
+ */
+export type MddQuantization = { 
+/**
+ * Quantization id, e.g. `"q4_k_m"`.
+ */
+id: string, 
+/**
+ * Bit width per weight.
+ */
+bits: number, 
+/**
+ * Approximate size relative to the FP16 baseline (e.g. `0.25`).
+ */
+size_multiplier?: number, 
+/**
+ * Free-form notes.
+ */
+notes?: string, };
+
+/**
+ * One concrete way to serve a component.
+ */
+export type MddRuntime = { 
+/**
+ * Serving engine.
+ */
+engine: MddEngine, 
+/**
+ * Where the weights / entrypoint live.
+ */
+entry: MddRuntimeEntry, 
+/**
+ * Engine features this runtime relies on (e.g. `["cuda", "flash-attn"]`).
+ */
+features: Array<string>, 
+/**
+ * Quantization variants this runtime supports.
+ */
+quantizations: Array<MddQuantization>, 
+/**
+ * Hardware requirements (local runtimes only).
+ */
+hardware?: MddHardwareRequirement, 
+/**
+ * Lifecycle status of this runtime.
+ */
+status: MddRuntimeStatus, };
+
+/**
+ * Where a runtime's entrypoint (weights or endpoint) lives.
+ */
+export type MddRuntimeEntry = { 
+/**
+ * Entry kind.
+ */
+kind: MddEntryKind, 
+/**
+ * Path / URL / registry reference, depending on `kind`.
+ */
+path: string, 
+/**
+ * SHA-256 checksum of the artifact (file downloads only).
+ */
+sha256?: string, 
+/**
+ * Artifact size in bytes (file downloads only).
+ */
+size_bytes?: bigint, };
+
+/**
+ * Lifecycle status of a runtime.
+ */
+export type MddRuntimeStatus = "ready" | "planned" | "unavailable";
+
+/**
+ * Scale / sizing estimation for capacity planning.
+ */
+export type MddScale = { 
+/**
+ * Total parameter count in billions.
+ */
+total_parameters_b?: number, 
+/**
+ * Weight storage estimate.
+ */
+weights: MddScaleWeights, 
+/**
+ * Supported quantization variants.
+ */
+quantization: Array<MddQuantization>, 
+/**
+ * Activation memory estimate.
+ */
+activation: MddScaleActivation, 
+/**
+ * Context / KV-cache estimate.
+ */
+context: MddScaleContext, 
+/**
+ * Throughput estimate.
+ */
+throughput: MddScaleThroughput, 
+/**
+ * Deployment tiers (cheapest-first ordering is conventional).
+ */
+tiers: Array<MddDeployTier>, };
+
+/**
+ * Activation memory estimate.
+ */
+export type MddScaleActivation = { 
+/**
+ * Peak activation memory in GB.
+ */
+peak_gb?: number, 
+/**
+ * Activation bytes per token.
+ */
+bytes_per_token?: number, };
+
+/**
+ * Context / KV-cache estimate.
+ */
+export type MddScaleContext = { 
+/**
+ * Maximum context length in tokens.
+ */
+max_tokens?: number, 
+/**
+ * KV-cache bytes per token.
+ */
+kv_cache_bytes_per_token?: number, };
+
+/**
+ * Throughput estimate.
+ */
+export type MddScaleThroughput = { 
+/**
+ * Tokens per second.
+ */
+tokens_per_second?: number, 
+/**
+ * Requests per second.
+ */
+requests_per_second?: number, 
+/**
+ * End-to-end latency in milliseconds.
+ */
+latency_ms?: number, };
+
+/**
+ * Weight storage estimate.
+ */
+export type MddScaleWeights = { 
+/**
+ * Total weight size in GB.
+ */
+size_gb?: number, 
+/**
+ * Storage format, e.g. `"safetensors"`, `"gguf"`.
+ */
+format?: string, };
+
+/**
+ * Task kind implemented by the inference API.
+ */
+export type MddTaskKind = "text_generation" | "embedding" | "image_generation" | "video_generation" | "audio_generation" | "other";

package/bindings/protocol-core-httpTypes.ts

@@ -0,0 +1,69 @@
+// Vendored snapshot of packages/protocol-core/bindings/httpTypes.ts (ts-rs
+// generated) so the published npm tarball is self-contained: npm `files`
+// cannot reach parent directories, and index.ts previously imported
+// `../protocol-core/bindings/httpTypes`, which is absent from the tarball and
+// breaks registry installs. Distinct filename to avoid colliding with this
+// crate's own ts-rs-generated bindings/httpTypes.ts. Re-sync when
+// protocol-core's HttpTypes bindings change.
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Backend build profile.
+ */
+export type BackendKind = "dev" | "nightly" | "prod" | "mock";
+
+/**
+ * Connection status of a dependency, as reported in health payloads.
+ */
+export type ConnectionStatus = { connected: boolean, latency: bigint, lastCheck: string, };
+
+export type CreatedResponse = { created: Array<string>, };
+
+export type DeletedResponse = { deleted: bigint, };
+
+export type ErrorResponse = { error: string, message?: string, };
+
+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>, };
+
+/**
+ * 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 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 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, };
+
+/**
+ * Service health status. Serde uses lowercase so JSON returns "ok" etc.
+ */
+export type ServiceStatus = "ok" | "degraded" | "unhealthy";
+
+export type StatusResponse = { status: string, agent_id?: string, platform?: string, id?: string, plugin_id?: string, };

package/bindings/{mcp → tools}/philia.ts

@@ -1,8 +1,8 @@
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
-export type AgentRegistryEntry = { agent_type: string, status: string, mcp_tool_count: number, skill_count: number, mcp_tools: Array<string>, skills: Array<string>, };
+export type AgentRegistryEntry = { agent_type: string, status: string, tool_count: number, skill_count: number, tools: Array<string>, skills: Array<string>, };
 
-export type AgentRegistryGetResult = { agent_type: string, mcp_tools: Array<McpToolDetail>, skills: Array<SkillDetail>, };
+export type AgentRegistryGetResult = { agent_type: string, tools: Array<ToolDetail>, skills: Array<SkillDetail>, };
 
 export type AgentRegistryListResult = { agents: Array<AgentRegistryEntry>, };
 
@@ -18,8 +18,6 @@ export type DataStoreSaveResult = { key: string, namespace: string, store_key: s
 
 export type GapInfo = { start_time: bigint, end_time: bigint, estimated_missing: number, };
 
-export type McpToolDetail = { name: string, description: string, parameters: Record<string, unknown>, };
-
 export type MemoryConsolidateParams = { episode_focus: string, node_ids: Array<string>, };
 
 export type MemoryConsolidateResult = { episode_id: string, linked_count: number, };
@@ -52,6 +50,8 @@ export type TimeseriesQueryParams = { metric: string, start_time: bigint | null,
 
 export type TimeseriesQueryResult = { metric: string, points: Array<TimeseriesPointResult>, stats: QueryStats | null, count: number, };
 
+export type ToolDetail = { name: string, description: string, parameters: Record<string, unknown>, };
+
 export type ToolSchemaGetParams = { agent_type: string, tool_name: string, };
 
 export type ToolSchemaGetResult = { agent_type: string, tool_name: string, declaration: string, };

package/bindings/ws/agentLifecycle.ts

@@ -19,7 +19,20 @@ 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, };
+recommended_options: Array<string>, model_name?: string, token_usage?: [number, number], skill_count?: number, tool_count?: number, next_route?: RouteInfo, stream?: LlmStream, error?: StructuredAgentError, 
+/**
+ * Topic correlation: the conversation this report belongs to (one
+ * conversation per user turn). Absent on legacy senders.
+ */
+conversation_id?: string, 
+/**
+ * The task (skill-chain run) that produced this report.
+ */
+task_id?: string, 
+/**
+ * Workspace scope of the originating chain, when known.
+ */
+workspace_id?: string, };
 
 /**
  * Reply payload for an inquiry (`report_type: "query"`) report.
@@ -34,8 +47,8 @@ export type AgentResponseParams = { agent_type: Agent, agent_id: string, agent_n
 
 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, };
+export type ToolResultParams = { 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 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], tool_calls: number, request_state: RequestState, completion_outcome: CompletionOutcome, retry_count: number, max_retries: number, };

package/bindings/ws/core.ts

@@ -1,10 +1,10 @@
 // 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 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 AgentErrorCode = "model_no_providers" | "model_no_models" | "model_tier_mismatch" | "model_all_excluded" | "model_env_incomplete" | "model_selection_retry_exhausted" | "model_no_capable_model" | "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";
 
@@ -40,7 +40,7 @@ export type SkillStage = { "Started": string } | { "Done": string } | { "Complet
 
 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 StreamSegment = { "Text": { text: string, message_id?: string, } } | { "Thinking": { text: string, message_id?: string, } } | { "DeepThinking": { text: string, message_id?: string, } } | { "ToolCall": { tool_name: string, call_id: string, params: unknown, agent_type?: string, message_id?: string, } } | { "ToolResult": { 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 }, };
 

package/bindings/ws/handshake.ts

@@ -16,8 +16,4 @@ protocol_version: number, token: string, session_id?: string, capabilities: Arra
  */
 workspace_id?: string, };
 
-export type HandshakeAckParams = { ok: boolean, error?: string, };
-
-export type PingParams = { timestamp: bigint, };
-
 export type ScepterIdentityParams = { device_id: string, };

package/bindings/ws/layer2.ts

@@ -4,22 +4,22 @@ export type CustomAgentInfo = { name: string, display_name: string, description:
 
 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 Layer2AgentInfo = { name: string, description: string, tool_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 Layer2AgentToolResponseParams = { agent_name: string, tools: Array<Layer2ToolInfo>, };
 
 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 Layer2ToolInfo = { 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 Layer2ToolPromptResponseParams = { agent_name: string, tool: 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, };