@zooid/core 0.7.0 → 0.7.2

package/src/types.ts

@@ -29,9 +29,26 @@ export interface Transport {
   reply(thread: ThreadRef, message: string): Promise<void> | void
 }
 
+/**
+ * One bind mount. `id` is the handle used by `disable_mounts` to subtract
+ * a zooid- or preset-declared entry; user-declared entries that omit `id`
+ * are auto-assigned `user-N`. The reserved id `workspace` is rejected on
+ * user entries.
+ */
+export interface MountConfig {
+  id?: string
+  host: string
+  target: string
+  mode: 'ro' | 'rw'
+  /** mkdir -p the host path before bind-mounting. Default false. */
+  create?: boolean
+}
+
 /**
  * Per-agent container configuration. Holds runtime-neutral container
- * concerns — image, env. Rejected at parse time when `runtime: local`.
+ * concerns — image, env, mounts. `image` / `env` are rejected at parse time
+ * when `runtime: local`; `mounts` / `disable_mounts` are accepted under
+ * `runtime: local` but ignored at compose time.
  */
 export interface ContainerConfig {
   image?: string
@@ -42,6 +59,13 @@ export interface ContainerConfig {
    * `ZOOID_*` references and `ZOOID_*` keys are rejected.
    */
   env?: Record<string, string>
+  /** User-declared mounts, layered on top of workspace + preset. */
+  mounts?: MountConfig[]
+  /**
+   * Subtractive override by mount id. Built-in ids: `workspace` plus
+   * whatever each preset declares (canonical: `memory`, `history`, `config`).
+   */
+  disable_mounts?: string[]
 }
 
 /**
@@ -52,6 +76,28 @@ export interface ZooidContainerConfig {
   image?: string
 }
 
+/**
+ * A room binding for an agent. Either a bare alias (default PL) or
+ * an alias with a declared power level applied at room creation.
+ *
+ * `alias` may be an alias (`#room:server`) or a room ID (`!id:server`).
+ * Resolved to a canonical room ID by `bot-pool` at bootstrap. The
+ * declared `powerLevel` (when set) seeds the agent's entry in
+ * `m.room.power_levels.users` at room creation; the daemon never reads
+ * or modifies power levels after that — promote/demote in the UI is
+ * canonical.
+ */
+export interface RoomBinding {
+  /** Room alias (typical) or room ID. */
+  alias: string
+  /**
+   * Power level the agent should hold in this room at the moment it is
+   * created. Omitted = `users_default` (effectively 0). Not reconciled
+   * after creation.
+   */
+  powerLevel?: number
+}
+
 /**
  * Matrix transport binding. Lives under `agents.<name>.matrix:` in
  * zooid.yaml. The block name (`matrix`) is the transport-kind
@@ -74,8 +120,8 @@ export interface MatrixBinding {
    * profile on bootstrap. Falls back to the user_id localpart when absent.
    */
   display_name?: string
-  /** Room IDs / aliases this agent watches. */
-  rooms: string[]
+  /** Rooms this agent watches. Each entry carries the alias/ID and an optional declared PL. */
+  rooms: RoomBinding[]
   /**
    * Routing rule. `mention` requires the bot to be tagged; `any` triggers
    * on every message.
@@ -135,7 +181,9 @@ export interface AgentConfig {
 
 /**
  * Matrix application-service transport. The CLI binds the AS HTTP listener
- * to `port` (defaults to 8080).
+ * to `port` (defaults to 9000 — the most common Matrix AS convention; see
+ * Synapse / mautrix / matrix-appservice-* projects). Must match the port in
+ * the registration YAML's `url` (read by the homeserver, not by Zooid).
  */
 export interface MatrixTransportConfig {
   type: 'matrix'
@@ -161,8 +209,11 @@ export interface MatrixTransportConfig {
    */
   user_namespace: string
   /**
-   * AS HTTP listener port.
-   * @default 8080
+   * AS HTTP listener port. Must match the registration YAML's `url` port —
+   * Zooid never reads the registration, so a mismatch silently sinks every
+   * transaction (the homeserver gets connection refused; you see no error
+   * in Zooid's logs).
+   * @default 9000
    */
   port?: number
   /**

package/src/zooid-yaml-sweep.test.ts

@@ -215,7 +215,7 @@ agents:
     expect(cfg.agents.alice!.matrix).toEqual({
       transport: 'm1',
       user_id: '@alice:localhost',
-      rooms: ['!r:localhost'],
+      rooms: [{ alias: '!r:localhost' }],
       trigger: 'any',
     })
     expect(cfg.agents.alice!.http).toBeUndefined()