@celestia-island/plana-types 0.1.8 → 0.1.10

package/bindings/evernightGateway.ts

@@ -0,0 +1,168 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Node-side acknowledgment pushed back up the relay.
+ */
+export type ConfigApplyAck = { applied_version: bigint, manifest_id: string, };
+
+/**
+ * The `Config.Apply` downlink payload: the manifest + its version for
+ * idempotent push (replayed old versions are refused by the node).
+ */
+export type ConfigApplyParams = { manifest: GatewayManifest, 
+/**
+ * Monotonically increasing version (refuse <= applied).
+ */
+config_version: bigint, };
+
+/**
+ * Route action, discriminated by the `type` field (serde internally-tagged).
+ */
+export type GatewayAction = { "type": "proxy", 
+/**
+ * Upstream URL(s); multiple = load-balanced (P1 feature).
+ */
+upstream: Array<string>, 
+/**
+ * Load-balancing strategy (default round_robin).
+ */
+lb: string, 
+/**
+ * **Critical for SigV4**: preserve the original Host header.
+ * rustfs presigned URLs verify the Host; changing it = 403.
+ */
+preserve_host: boolean, } | { "type": "static", status: number, body: string, } | { "type": "redirect", to: string, status: number, } | { "type": "reject", status: number, };
+
+/**
+ * Top-level manifest: identifies the document, pins the executing node,
+ * and carries the server blocks.
+ */
+export type GatewayManifest = { 
+/**
+ * Schema version (for forward-compatible evolution).
+ */
+version: number, 
+/**
+ * Unique manifest id (for idempotent push/pull and audit).
+ */
+id: string, 
+/**
+ * Who produced this manifest ("chest-admin" or "hand-written").
+ */
+generated_by: string, 
+/**
+ * The tier-3 node that must execute this manifest (I2 invariant).
+ */
+exit_node: string, 
+/**
+ * Server blocks: one per public hostname.
+ */
+servers: Array<GatewayServer>, };
+
+/**
+ * Structured route matcher. Fields AND across, arrays OR within.
+ * Rejects string-DSL patterns (traefik-style) — everything is
+ * structurally validated at parse time.
+ */
+export type GatewayMatch = { 
+/**
+ * Path prefixes to match (any of).
+ */
+path_prefix: Array<string>, 
+/**
+ * Exact paths (any of).
+ */
+path: Array<string>, 
+/**
+ * HTTP methods (any of).
+ */
+methods: Array<string>, 
+/**
+ * Header presence/value match.
+ */
+headers: { [key in string]: string }, };
+
+/**
+ * Per-route rate limit.
+ */
+export type GatewayRateLimit = { requests: number, per: string, key: string, };
+
+/**
+ * One route: a structured matcher + a discriminated action.
+ */
+export type GatewayRoute = { 
+/**
+ * Route id (for logs and mutation targeting).
+ */
+id: string, 
+/**
+ * Structured match table (fields are AND'd; arrays within a field are OR'd).
+ */
+match: GatewayMatch, 
+/**
+ * What to do when the route matches (discriminated by `type`).
+ */
+action: GatewayAction, 
+/**
+ * Named middleware to apply (references or inline). Serde renames to
+ * `use` so hand-written TOML (`use = [mw]`) round-trips — without
+ * the rename serde looks for `use_` and silently drops the field.
+ */
+use: Array<string>, 
+/**
+ * Rate limit for this route.
+ */
+ratelimit: GatewayRateLimit | null, 
+/**
+ * Request body size ceiling.
+ */
+body_max: string | null, 
+/**
+ * Request timeout.
+ */
+timeout: string | null, };
+
+/**
+ * One public hostname's routing tree.
+ */
+export type GatewayServer = { 
+/**
+ * Public hostname(s) this server block answers (SNI + Host match).
+ */
+host: Array<string>, 
+/**
+ * Listen address (default `0.0.0.0:443`).
+ */
+listen: string, 
+/**
+ * TLS termination config.
+ */
+tls: GatewayTls | null, 
+/**
+ * Redirect plain HTTP to HTTPS (adds a :80 listener).
+ */
+redirect_http: boolean, 
+/**
+ * Ordered routes (first match wins).
+ */
+routes: Array<GatewayRoute>, };
+
+/**
+ * TLS material reference: the cert/key live on the tier-3 node's local
+ * secure storage; the manifest only carries a **reference** (the door's
+ * host), never the private key bytes.
+ */
+export type GatewayTls = { 
+/**
+ * `static` (file-based, managed by acme.sh + install-cert) — ACME
+ * in-process is a future variant.
+ */
+type: string, 
+/**
+ * Reference to the door's certificate (e.g. "door:s3.celestia.world").
+ */
+cert: string, 
+/**
+ * Reference to the door's private key (same node-local storage).
+ */
+key: string, };

package/bindings/ws/tasks.ts

@@ -6,6 +6,17 @@ export type TaskCreatedParams = { task_id: string, issue_id: string, title: stri
  * Topic correlation: the conversation this task was spawned for,
  * when the spawning chain knows one.
  */
-conversation_id?: string, };
+conversation_id?: string,
+/**
+ * Task Decompose estimate in degrees; absent = no estimate produced.
+ * Consumers MUST use `!= null` — 0 is a legitimate zero-cost estimate.
+ */
+estimated_degrees?: number, };
 
 export type TaskStatusUpdateParams = { task_id: string, status: TaskStatus, progress: number, };
+
+/**
+ * A task's estimate was updated after creation (S2c follow-up).
+ * Consumers MUST use `!= null` — 0 is a legitimate zero-cost estimate.
+ */
+export type TaskEstimateUpdatedParams = { task_id: string, estimated_degrees?: number, };

package/bindings/ws/viewTemplate.ts

@@ -0,0 +1,383 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * The base view a template is built on — the spec arm that must be set.
+ */
+export type BaseViewKind = "waterfall" | "node-canvas" | "data-grid" | "kanban" | "blank-canvas";
+
+/**
+ * The blank-canvas base's spec.
+ */
+export type BlankCanvasSpec = { 
+/**
+ * What mounts into the canvas (a renderer id the host resolves).
+ */
+mount: string, 
+/**
+ * Optional DOM overlay drawn above the canvas.
+ */
+overlay?: string, };
+
+/**
+ * Camera behaviour of a node canvas.
+ */
+export type CameraSpec = { 
+/**
+ * Smallest allowed zoom factor.
+ */
+min_zoom: number, 
+/**
+ * Largest allowed zoom factor.
+ */
+max_zoom: number, 
+/**
+ * Zoom step as a fraction (0.05 = 5%).
+ */
+zoom_step?: number, 
+/**
+ * Whether the camera fits the content on first paint.
+ */
+fit_on_load: boolean, };
+
+/**
+ * How a node canvas draws its layers.
+ */
+export type CanvasBackend = "svg" | "dom-overlay-svg" | "canvas-edges-dom" | "blank";
+
+/**
+ * The chrome a template asks the shell to draw around it.
+ */
+export type ChromeSpec = { 
+/**
+ * Docked widgets this view contributes.
+ */
+docks: Array<DockContribution>, 
+/**
+ * Whether the shell draws its breadcrumb bar.
+ */
+breadcrumb: boolean, };
+
+/**
+ * The data-grid base's spec.
+ */
+export type DataGridSpec = { 
+/**
+ * Field schema ids this grid binds to.
+ */
+fields: Array<string>, 
+/**
+ * Whether rows can be edited in place.
+ */
+editable: boolean, 
+/**
+ * Optional overlay widget drawn above the grid (trend, alarms).
+ */
+overlay?: string, };
+
+/**
+ * Drag-and-drop behaviour of a kanban.
+ */
+export type DndSpec = { 
+/**
+ * Whether cards can move between lanes.
+ */
+across_lanes: boolean, 
+/**
+ * Whether cards can be reordered inside a lane.
+ */
+reorder: boolean, };
+
+/**
+ * The plane a dock surface sits on.
+ */
+export type DockAnchor = "page" | "plane";
+
+/**
+ * One dock widget a template hangs.
+ */
+export type DockContribution = { 
+/**
+ * Widget id the host resolves.
+ */
+widget: string, 
+/**
+ * Where it hangs.
+ */
+placement: DockPlacement, 
+/**
+ * Which plane carries it.
+ */
+anchor: DockAnchor, 
+/**
+ * Surface finish.
+ */
+surface: DockSurface, 
+/**
+ * Stacking order among contributions sharing a placement.
+ */
+order: number, };
+
+/**
+ * Where a dock surface hangs.
+ */
+export type DockPlacement = "top" | "bottom" | "left" | "right" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+
+/**
+ * The finish of a dock surface.
+ */
+export type DockSurface = "glass" | "solid";
+
+/**
+ * How a waterfall groups its items into buckets (day sections, lanes, …).
+ */
+export type GroupingSpec = { 
+/**
+ * Field of the item the bucket key is read from.
+ */
+field: string, 
+/**
+ * Whether the buckets are ordered newest-first.
+ */
+newest_first: boolean, };
+
+/**
+ * The kanban base's spec.
+ */
+export type KanbanSpec = { 
+/**
+ * Scroll directions the board supports.
+ */
+axes: ScrollAxes, 
+/**
+ * Lane definition.
+ */
+lanes: LaneSpec, 
+/**
+ * Draggable card kinds, in picker order.
+ */
+card_kinds: Array<string>, 
+/**
+ * Drag-and-drop behaviour.
+ */
+dnd: DndSpec, 
+/**
+ * Optional windowing for long boards.
+ */
+windowing?: WindowingSpec, };
+
+/**
+ * One lane of a kanban.
+ */
+export type LaneSpec = { 
+/**
+ * Field of the item the lane key is read from.
+ */
+field: string, 
+/**
+ * Whether the lane header is drawn as a card of its own.
+ */
+header_is_card: boolean, };
+
+/**
+ * The built-in minimap, which is on by default for node canvases.
+ */
+export type MinimapSpec = { 
+/**
+ * Whether the minimap is drawn.
+ */
+enabled: boolean, 
+/**
+ * Where it is anchored.
+ */
+placement: DockPlacement, };
+
+/**
+ * The node-canvas base's spec.
+ */
+export type NodeCanvasSpec = { 
+/**
+ * Which rendering backend draws the layers.
+ */
+backend: CanvasBackend, 
+/**
+ * Camera bounds and first-paint behaviour.
+ */
+camera: CameraSpec, 
+/**
+ * The minimap, on by default.
+ */
+minimap?: MinimapSpec, 
+/**
+ * Node kinds this canvas may render.
+ */
+node_kinds: Array<string>, 
+/**
+ * Optional left rail (a node palette).
+ */
+palette?: string, 
+/**
+ * Optional right rail (an inspector).
+ */
+inspector?: string, 
+/**
+ * Optional auto-layout algorithm id.
+ */
+auto_layout?: string, };
+
+/**
+ * One panel template: identity, presentation and the base view's spec.
+ */
+export type PanelTemplate = { 
+/**
+ * Template id — kebab-case, stable across config layers.
+ */
+id: string, 
+/**
+ * Display title (the author's language).
+ */
+title: string, 
+/**
+ * Optional i18n key; when present the shell translates it instead of
+ * using `title`.
+ */
+title_key?: string, 
+/**
+ * Optional description.
+ */
+description?: string, 
+/**
+ * Optional description i18n key.
+ */
+description_key?: string, 
+/**
+ * Render-engine (plugin) id that draws this template.
+ */
+render_engine: string, 
+/**
+ * The base view and its configuration.
+ */
+spec: ViewTemplateSpec, };
+
+/**
+ * Which way a kanban scrolls.
+ */
+export type ScrollAxes = "horizontal" | "vertical" | "both";
+
+/**
+ * A template file — the TOML document a workspace or plugin ships.
+ */
+export type ViewTemplateFile = { 
+/**
+ * Format version. A reader that does not know the version must reject
+ * the file rather than guess — the same explicit stance the MDD
+ * descriptor takes for its `schema_version`.
+ */
+version: number, 
+/**
+ * The templates the file declares.
+ */
+template: Array<PanelTemplate>, };
+
+/**
+ * The spec arm matching a template's base view.
+ *
+ * Exactly one arm is set — the one named by [`ViewTemplateSpec::base`] —
+ * so a reader never has to guess which of the five it is looking at.
+ */
+export type ViewTemplateSpec = { 
+/**
+ * The base view this template is drawn on.
+ */
+base: BaseViewKind, 
+/**
+ * Set iff `base` is `waterfall`.
+ */
+waterfall?: WaterfallSpec, 
+/**
+ * Set iff `base` is `node-canvas`.
+ */
+node_canvas?: NodeCanvasSpec, 
+/**
+ * Set iff `base` is `data-grid`.
+ */
+data_grid?: DataGridSpec, 
+/**
+ * Set iff `base` is `kanban`.
+ */
+kanban?: KanbanSpec, 
+/**
+ * Set iff `base` is `blank-canvas`.
+ */
+blank_canvas?: BlankCanvasSpec, 
+/**
+ * Optional chrome (docks, breadcrumb).
+ */
+chrome?: ChromeSpec, };
+
+/**
+ * How a waterfall splits its item stream into columns.
+ */
+export type WaterfallColumns = { "kind": "single" } | { "kind": "fixed", 
+/**
+ * Number of columns (>= 1).
+ */
+count: number, } | { "kind": "adaptive", 
+/**
+ * Upper bound on the derived column count.
+ */
+max: number, 
+/**
+ * Minimum column width in pixels.
+ */
+min_width: number, };
+
+/**
+ * The waterfall base's spec.
+ */
+export type WaterfallSpec = { 
+/**
+ * Column layout.
+ */
+columns: WaterfallColumns, 
+/**
+ * Optional bucketing.
+ */
+grouping?: GroupingSpec, 
+/**
+ * Optional windowing (absent = render the whole list).
+ */
+windowing?: WindowingSpec, 
+/**
+ * Card kinds this view may render, in picker order.
+ */
+card_kinds: Array<string>, 
+/**
+ * Optional rail widget drawn beside the stream (a timeline).
+ */
+rail?: string, 
+/**
+ * Optional search affordance.
+ */
+search?: string, };
+
+/**
+ * Where the windowed rows come from.
+ */
+export type WindowingSource = "client" | "host";
+
+/**
+ * Windowing parameters for a scrolling base view.
+ */
+export type WindowingSpec = { 
+/**
+ * Which side owns the window.
+ */
+source: WindowingSource, 
+/**
+ * Estimated row height in pixels before measurement.
+ */
+estimated_item_height?: number, 
+/**
+ * Screens of overscan kept mounted on either side.
+ */
+overscan_screens?: number, };

package/bindings/ws/views.ts

@@ -1,31 +1,5 @@
 // This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 
-/**
- * Dashboard layout — a collection of views arranged in a grid.
- */
-export type DashboardLayout = { 
-/**
- * Workspace ID this dashboard belongs to.
- */
-workspace_id: string, 
-/**
- * Dashboard name.
- */
-name: string, 
-/**
- * All view instances in this dashboard.
- */
-views: Array<ViewInstance>, 
-/**
- * Grid columns count (0 = auto).
- */
-grid_columns: number, };
-
-/**
- * Push a dashboard layout update to connected clients.
- */
-export type DashboardLayoutPushParams = { layout: DashboardLayout, };
-
 /**
  * A widget inside a webui dashboard descriptor (P3#A4).
  *
@@ -63,54 +37,6 @@ config?: Record<string, unknown>,
  */
 data?: Record<string, unknown>, };
 
-/**
- * View data update — incremental data push for a specific view.
- */
-export type ViewDataPushParams = { 
-/**
- * Target view ID.
- */
-view_id: string, 
-/**
- * Data payload (format depends on ViewKind).
- */
-data: Record<string, unknown>, 
-/**
- * Whether this is a full replacement or incremental update.
- */
-full_replace: boolean, };
-
-/**
- * A view instance — one panel in the dashboard.
- */
-export type ViewInstance = { 
-/**
- * Unique view ID within the workspace.
- */
-view_id: string, 
-/**
- * What kind of renderer to use.
- */
-kind: ViewKind, 
-/**
- * Display title.
- */
-title: string, 
-/**
- * Data source identifier — what the view is bound to.
- * Examples: "industrial:station:19", "chat:conversation:abc",
- * "kanban:project:xyz", "media:flow:comfyui"
- */
-data_source: string, 
-/**
- * View-specific configuration (JSON, interpreted by the renderer).
- */
-config: Record<string, unknown>, 
-/**
- * Layout position (grid area, tab order, etc.).
- */
-layout?: ViewLayout, };
-
 /**
  * Widget create/update/delete on an existing layout (P3#A4).
  */
@@ -127,37 +53,3 @@ op: string,
  * Widget descriptor to create/update (ignored for delete).
  */
 widget: DashboardWidget, };
-
-/**
- * View type identifier — determines which frontend renderer handles the view.
- */
-export type ViewKind = "industrial_scada" | "chat" | "kanban" | "gantt" | "data_table" | "media_flow" | "file_explorer" | "custom";
-
-/**
- * Layout descriptor for a view within the dashboard grid.
- */
-export type ViewLayout = { 
-/**
- * Grid column start (1-based).
- */
-col: number, 
-/**
- * Grid row start (1-based).
- */
-row: number, 
-/**
- * Column span.
- */
-col_span: number, 
-/**
- * Row span.
- */
-row_span: number, 
-/**
- * Minimum width in pixels.
- */
-min_width?: number, 
-/**
- * Minimum height in pixels.
- */
-min_height?: number, };

package/index.ts

@@ -59,6 +59,7 @@ export * from "./bindings/ws/stateSync";
 export * from "./bindings/ws/systemUi";
 export * from "./bindings/ws/tasks";
 export * from "./bindings/ws/views";
+export * from "./bindings/ws/viewTemplate";
 export * from "./bindings/ws/workspace";
 export * from "./bindings/ws/yolo";
 export type { AnomalyDetectParams, AnomalyInfo, AnomalyResult, CausalReasonParams, CausalReasonResult, CorrelationInfo, Hypothesis, LlmChatParams, LlmChatResult, MediaAssetItem, MediaAssetRegisterResult, MediaAssetRetrieveResult, RagDbDeleteParams, RagDbDeleteResult, RagDbReadParams, RagDbReadResult, RagDbStatsParams, RagDbStatsResult, RagDbWriteParams, RagDbWriteResult, RagDocResult, TranslateReportParams, TranslateReportResult, WorkspaceIndexParams, WorkspaceIndexResult, WorkspaceSearchDoc, WorkspaceSearchParams, WorkspaceSearchResult, WorkspaceStatusResult } from "./bindings/tools/aporia";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celestia-island/plana-types",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "repository": {
     "type": "git",
     "url": "https://github.com/celestia-island/plana"