@cotal-ai/core 0.3.2 → 0.5.0

package/dist/types.d.ts

@@ -40,15 +40,47 @@ export interface AgentCard {
  * - `offline`: disconnected or heartbeat lapsed (derived by observers, not self-set while live)
  */
 export type PresenceStatus = "idle" | "waiting" | "working" | "offline";
+/**
+ * How aggressively peer traffic interrupts an agent — chosen by the agent, orthogonal to
+ * {@link PresenceStatus}. Defined here (the wire layer) because it is now published in
+ * {@link Presence}; the connector imports it. Advisory observability, not a security boundary.
+ */
+export type AttentionMode = "open" | "dnd" | "focus";
+/**
+ * Per-channel attention override (more specific than the global {@link AttentionMode}).
+ * - `quiet` — still delivered + buffered, but never wakes; an `@`-mention still wakes (per-channel `dnd`).
+ * - `muted` — channel messages dropped on receive, incl. `@`-mentions ("don't receive this channel").
+ */
+export type ChannelMode = "quiet" | "muted";
 /** Live presence record. Stored in the space's KV bucket under key = card.id. */
 export interface Presence {
     card: AgentCard;
     status: PresenceStatus;
     /** Freeform "what I'm doing right now". */
     activity?: string;
+    /** This instance's current global attention mode. Advisory, within-space observability — a peer
+     *  can see "they're in focus" and choose to DM. Published from the connector's authoritative state
+     *  (presence is a mirror, never the source of truth for delivery). `open`/absent ⇒ receives all. */
+    attention?: AttentionMode;
+    /** Per-channel attention overrides this instance currently has (runtime, reset on restart). Keys are
+     *  concrete channel names. Advisory: lets a peer see "locally muted #deploys → DM to reach me". NOT
+     *  access control — the broker still authorizes and delivers; this is a receive-side presentation. */
+    channelModes?: Record<string, ChannelMode>;
     /** Epoch ms of the last heartbeat. */
     ts: number;
 }
+/**
+ * A channel's delivery class (SPEC §4). Fixed per channel, wire-observable.
+ * - `live` — native broker-subscription delivery; **at-most-once** (only instances subscribed at
+ *   publish time receive it; a disconnected/busy/not-yet-joined instance has no claim to it later).
+ * - `durable` — `live` plus a per-subscriber durable backstop; **at-least-once for current members**
+ *   (also retained per member and redelivered on the member's next connection/turn until acked).
+ *
+ * Effective class is {@link effectiveDeliveryClass}: `channel ?? space default ?? "durable"`. The
+ * space default is set at space creation from the deployment profile (local/self-hosted ⇒ `durable`,
+ * public/web-scale ⇒ `live`) so it is always discoverable on the wire, never inferred per-component.
+ */
+export type DeliveryClass = "live" | "durable";
 /**
  * Channel registry entry — channel-global config, stored in the per-space channels KV
  * (one entry per channel; the space-wide default lives under {@link CHANNEL_DEFAULTS_KEY}).
@@ -60,9 +92,11 @@ export interface ChannelConfig {
     /** Override the space default for history replay-on-join. */
     replay?: boolean;
     /** How far back a joiner's backfill reaches — a duration like `"24h"`, `"30m"`, `"7d"`.
-     *  Maps to a native Direct-Get `start_time` (now − window). Unset + `replay` ⇒ the full
-     *  retained window; ignored when replay is off. */
+     *  Bounds the join-backfill read horizon (now − window) on the pinned single-filter `chathist`
+     *  history consumer. Unset + `replay` ⇒ the full retained window; ignored when replay is off. */
     replayWindow?: string;
+    /** Override the space default delivery class (SPEC §4, §7). See {@link DeliveryClass}. */
+    deliveryClass?: DeliveryClass;
     /** One-line "what this channel is for". */
     description?: string;
     /** Longer "how to use it" — surfaced to joiners as advisory, attributed data. */
@@ -72,6 +106,71 @@ export interface ChannelConfig {
 export interface ChannelDefaults {
     replay?: boolean;
     replayWindow?: string;
+    /** Default delivery class for channels without an explicit one. Written at space creation from
+     *  the deployment profile (local ⇒ `durable`, web ⇒ `live`); see {@link DeliveryClass}. */
+    deliveryClass?: DeliveryClass;
+}
+/**
+ * Durable-membership state (Plane-3, SPEC §7). One {@link MembershipRecord} per (concrete channel,
+ * owner) in the privileged members registry KV.
+ * - `live-confirmed` — the owner is live-subscribed (core-sub / boot durable); no Plane-3 backstop.
+ *   Fan-out does NOT target these (their durability, if any, is the legacy tail until Stage 5).
+ * - `durable-active` — a Plane-3 durable backstop is established for this (channel, owner). Fan-out
+ *   targets these; the trusted reader re-authorizes each entry against the interval below.
+ */
+export type MembershipState = "live-confirmed" | "durable-active";
+/**
+ * A durable-membership record (privileged write only; agent-authored membership is forbidden —
+ * it would self-authorize delivery + reads). Eligibility is by **CHAT stream sequence**, never
+ * wall-clock: a `durable-channel` entry is deliverable to this owner iff
+ * `joinCursor < seq <= leaveCursor` (open leave ⇒ no upper bound) — SPEC §7 L355-356. `leaveCursor`
+ * present ⇒ this is a tombstone (kept through the retention horizon so late entries are denied
+ * deterministically); a rejoin bumps {@link generation} and takes a fresh {@link joinCursor}.
+ */
+export interface MembershipRecord {
+    /** Concrete channel (never a wildcard — wildcard ACLs grant live breadth, durable is per-channel). */
+    channel: string;
+    /** Owner agent id (nkey). */
+    owner: string;
+    state: MembershipState;
+    /** CHAT stream seq captured at join — durable eligibility is `seq > joinCursor`. */
+    joinCursor: number;
+    /** True only once activation catch-up has COMPLETED. A **completeness/reporting** flag, NOT a delivery
+     *  gate: {@link durableEligible} is pure membership-interval, so a `durable-active` record routes
+     *  in-interval immediately (no live message is lost during catch-up). `activated` instead gates what is
+     *  REPORTED — `durableJoin` returns `durable:true` and `channelMembers()` lists the owner only once
+     *  catch-up confirms; a join whose catch-up never completes reports `durable:false`, stays hidden, and
+     *  is tombstoned on eviction so it does not route. A tombstone preserves the `activated` it had at leave. */
+    activated?: boolean;
+    /** CHAT stream seq captured at leave — eligibility upper bound `seq <= leaveCursor`. Present ⇒
+     *  tombstone. Absent ⇒ open membership (no upper bound). */
+    leaveCursor?: number;
+    /** Bumped each (re)join. Stale-write guard (with the KV revision CAS) + idempotency-key component
+     *  for fan-out/catch-up (`<msgId>:<owner>:<generation>`). */
+    generation: number;
+    /** The privileged writer's id (audit; never an agent). */
+    writerIdentity: string;
+    /** Epoch ms of the last write (diagnostics only — eligibility is seq, never this). */
+    updatedAt: number;
+}
+/**
+ * A fan-out entry in an owner's mixed pre-auth inbox (`dinbox.<owner>`, Plane-3). The fan-out writer
+ * copies one of these per eligible owner; the trusted reader re-authorizes it (`channel`+`seq` against
+ * the membership interval for `durable-channel`, ACL-only for `live-mention`) before transferring the
+ * embedded `msg` to the owner's DELIVER store. `seq`/`reason`/`generation` are the re-auth metadata;
+ * the agent never sees this envelope (it receives only `msg` on `dlv.<owner>`).
+ */
+export interface Plane3Entry {
+    msg: CotalMessage;
+    /** Concrete channel the message was published on (the re-auth subject). */
+    channel: string;
+    /** The message's CHAT stream sequence (membership-interval re-auth). */
+    seq: number;
+    /** Why this owner was fanned to: a `durable` channel's member (interval-gated) vs a `live` channel
+     *  `@mention` to an authorized target (ACL-only, no membership). */
+    reason: "durable-channel" | "live-mention";
+    /** The owner's membership generation at fan-out (idempotency-key component + diagnostics). */
+    generation: number;
 }
 /** Reverse-DNS extension part kind, e.g. `com.acme.snapshot`.
  * @pattern ^[A-Za-z0-9-]+(\.[A-Za-z0-9-]+)+$ */
@@ -98,9 +197,11 @@ interface CotalMessageBase {
     ts: number;
     space: string;
     from: EndpointRef;
-    /** Lowercased peer names called out within a `channel` message — a priority/wake hint,
-     *  not a routing target: the message still multicasts to the whole channel. Omitted when
-     *  empty. */
+    /** Lowercased peer names called out within a `channel` message — a wake hint that also, on a
+     *  `live` channel, routes a durable copy to each mentioned target **authorized to read that
+     *  channel** (SPEC §4/§5). It never carries content outside the target's read ACL and is not a
+     *  routing substitute for `channel`/`to`; the message still multicasts to the whole channel.
+     *  Omitted when empty. */
     mentions?: string[];
     parts: Part[];
     /** Id of the message being replied to. */
@@ -159,6 +260,11 @@ export interface Delivery {
     ack(): void;
     /** Decline for now; the message redelivers (e.g. couldn't surface it yet). */
     nak(): void;
+    /** Whether {@link ack} actually COMMITS this copy (durable backstop / JetStream, at-least-once)
+     *  or is a no-op (live core-sub / history backfill, at-most-once). A receiver coalescing a
+     *  cross-path duplicate must NOT downgrade a durable ack to a live no-op — else the durable copy
+     *  is never committed, JetStream redelivers it, and it double-surfaces. See {@link DeliveryClass}. */
+    durable: boolean;
 }
 /** Control-plane request/reply (e.g. CLI → manager). */
 export interface ControlRequest {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,YAAY,CAAC;IACnB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;wEAEoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAExE,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;uDAEmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;gDACgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAEtD,MAAM,MAAM,IAAI,GACZ;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,gBAAgB;IACxB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB;;iBAEa;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GACpB,CAAC,gBAAgB,GAAG;IAClB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,CAAC,GACF,CAAC,gBAAgB,GAAG;IAClB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,CAAC,GACF,CAAC,gBAAgB,GAAG;IAClB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,EAAE,CAAC,EAAE,KAAK,CAAC;CACZ,CAAC,CAAC;AAEP,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE5C;;kFAEkF;AAClF,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;6BAKyB;IACzB,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,uFAAuF;IACvF,GAAG,IAAI,IAAI,CAAC;IACZ,8EAA8E;IAC9E,GAAG,IAAI,IAAI,CAAC;CACb;AAED,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAEvF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@cotal-ai/core",
-  "version": "0.3.2",
+  "description": "The Cotal protocol: endpoint, subjects, message types, the NATS client layer, and the extension contracts.",
+  "version": "0.5.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -31,6 +32,7 @@
   },
   "scripts": {
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "build": "tsc -p tsconfig.json"
+    "build": "tsc -p tsconfig.json",
+    "test": "tsx smoke/resolve.smoke.ts"
   }
 }