wicked-crew-api-types 0.115.0 → 0.117.0

package/index.d.ts

@@ -1017,6 +1017,8 @@ export interface RosterSeat {
    * an engine predating the field (serde omits `None`) and on seats with no known login flow.
    */
   login_invocation?: string;
+  /** Container seats sign in through the daemon's disposable login terminal. */
+  sign_in?: 'container';
   /**
    * The shell invocation that signs this seat OUT of its own configuration root (crew#615;
    * wicked-core#807 `AgenticCli.logout_invocation`, core-ts >= 0.7.43): the CLI's own documented
@@ -5180,7 +5182,8 @@ export interface DomainCoverage {
 
 /**
  * `POST /seats/:cli/logout` (crew#615): the PTY size for the terminal the daemon opens running the
- * seat's own `logout_invocation`. Both optional (default 100 x 30). `POST /seats/:cli/login` is
+ * seat's own `logout_invocation`, also used by `POST /seats/:cli/container-login` for the disposable
+ * login container. Both optional (default 100 x 30). `POST /seats/:cli/login` is
  * GONE from api-types 0.115.0 (DES-seats-page Q3): sign-in is a command the operator runs in their
  * own terminal (`RosterSeat.login_invocation`).
  */
@@ -5202,6 +5205,27 @@ export interface SeatSessionResponse {
   action: 'login' | 'logout';
 }
 
+export interface SeatContainerLoginResponse {
+  terminalId: string;
+  cli: string;
+  action: 'sign_in';
+}
+
+export interface SeatContainerLoginOutcome {
+  cli: string;
+  ok: boolean;
+  files?: string[];
+  expires_at?: number | null;
+  error?: string;
+  /** ISO-8601 time of ingestion. */
+  at: string;
+}
+
+export interface SeatContainerLogoutResponse {
+  cli: string;
+  action: 'sign_out';
+}
+
 /** The open-terminal request body (`POST /terminals`, DES-TERMINAL-001 §6). */
 export interface OpenTerminalBody {
   /** Working directory the PTY opens in. */
@@ -10392,7 +10416,51 @@ export type EditorPermission =
   | 'network.media'
   /** Talk, through studio's host, to an MCP server the operator connected (DES-MCP-INSPECTOR-001).
    *  No posture rule allows it: the editor's install consent writes its per-build grant. */
-  | 'mcp.session';
+  | 'mcp.session'
+  /** Protocol 2 `theme.set` (DES-EDITOR-PLUGIN-CONTRACT-001 §7.2): change this artifact's theme, as a new version. */
+  | 'artifact.theme';
+
+/**
+ * A protocol-2 editor's surfaces (DES-EDITOR-PLUGIN-CONTRACT-001 §5.2), as the registry parsed them from its
+ * manifest: defaults filled (`interactive:false`, `aspect:'16:9'`, `actions:[]`, `primary:false`, `maxChars:200`,
+ * `full.default:'simple'`), `options`/`full` null when not declared. The host renders the card, the options tabs
+ * and full screen from this copy (and requires the bundle's `plugin.ready` copy to be the same).
+ */
+export interface EditorSurfaces {
+  card: {
+    /** The frame takes pointer and keys inside the card (a protocol-1 inline card never did). */
+    interactive: boolean;
+    /** `auto`: the plugin reports its height (`ui.height`, clamped to 120-560 px). */
+    aspect: '16:9' | '4:3' | 'auto';
+    /** At most 4, drawn by the HOST in the card footer. `plugin` → `host.action {id}`; the others are host verbs. */
+    actions: Array<{ id: string; label: string; primary: boolean; verb: 'plugin' | 'host:export' | 'host:ask' }>;
+  };
+  /** At most 5 tabs, added to the host panel on Options; null = no Options button. */
+  options: { tabs: EditorOptionsTab[] } | null;
+  /** Null = no Full screen button. `modes` null = one mode (no Simple/Advanced toggle). */
+  full: { modes: Array<'simple' | 'advanced'> | null; default: 'simple' | 'advanced' } | null;
+}
+
+/** One options tab: a frame of the plugin's (`plugin`) or host-drawn controls (`controls`, at most 12). */
+export interface EditorOptionsTab {
+  id: string;
+  label: string;
+  render: 'plugin' | 'controls';
+  controls?: EditorControl[];
+}
+
+/** A host-drawn control (§5.3, a closed vocabulary). `options` for select/segmented (2-8); `min`/`max`/`step`
+ *  for range; `maxChars` for text. */
+export interface EditorControl {
+  id: string;
+  label: string;
+  type: 'toggle' | 'segmented' | 'select' | 'color' | 'text' | 'range';
+  options?: Array<{ id: string; label: string }>;
+  min?: number;
+  max?: number;
+  step?: number;
+  maxChars?: number;
+}
 
 /**
  * One registered editor, as Settings → Editors renders it. No path is on the wire: the bundle is
@@ -10412,6 +10480,10 @@ export interface EditorView {
   kinds: string[];
   sizes: Array<'inline' | 'pane' | 'full'>;
   panels?: Array<'checks'>;
+  /** Protocol 2 (an editor whose `protocol` lists 2): its declared surfaces, parsed. Absent for a protocol-1
+   *  editor, and from a daemon that predates the field (added with api-types 0.117.0; the host then reads
+   *  the bundle's `plugin.ready` copy). */
+  surfaces?: EditorSurfaces;
   /** Each with the reason shown at install. The GRANTED set is `GET /editors/:id/grants`. */
   permissions: Array<{ id: EditorPermission; why: string }>;
   /** The full sha256 of the entry file, pinned when the registry read it. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicked-crew-api-types",
-  "version": "0.115.0",
+  "version": "0.117.0",
   "description": "The wire contract of the wicked-crew daemon's /api/v1 REST surface and /ws CoreEvent frames \u2014 types only, zero runtime",
   "type": "module",
   "types": "./index.d.ts",