@cotal-ai/core 0.133.13 → 0.134.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/dist/backup-config.d.ts +48 -5
  2. package/dist/backup-config.d.ts.map +1 -1
  3. package/dist/backup-config.js +72 -10
  4. package/dist/backup-config.js.map +1 -1
  5. package/dist/endpoint-caller.d.ts +4 -1
  6. package/dist/endpoint-caller.d.ts.map +1 -1
  7. package/dist/endpoint-caller.js +3 -1
  8. package/dist/endpoint-caller.js.map +1 -1
  9. package/dist/endpoint-contract-store.d.ts +14 -2
  10. package/dist/endpoint-contract-store.d.ts.map +1 -1
  11. package/dist/endpoint-contract-store.js +16 -3
  12. package/dist/endpoint-contract-store.js.map +1 -1
  13. package/dist/endpoint-coverage.d.ts +55 -0
  14. package/dist/endpoint-coverage.d.ts.map +1 -0
  15. package/dist/endpoint-coverage.js +206 -0
  16. package/dist/endpoint-coverage.js.map +1 -0
  17. package/dist/endpoint.d.ts +67 -20
  18. package/dist/endpoint.d.ts.map +1 -1
  19. package/dist/endpoint.js +111 -75
  20. package/dist/endpoint.js.map +1 -1
  21. package/dist/index.d.ts +3 -0
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index.js +3 -0
  24. package/dist/index.js.map +1 -1
  25. package/dist/issued-authority.d.ts +48 -0
  26. package/dist/issued-authority.d.ts.map +1 -1
  27. package/dist/issued-authority.js +78 -0
  28. package/dist/issued-authority.js.map +1 -1
  29. package/dist/provision.d.ts +27 -6
  30. package/dist/provision.d.ts.map +1 -1
  31. package/dist/provision.js +91 -10
  32. package/dist/provision.js.map +1 -1
  33. package/dist/registry-client.d.ts +39 -0
  34. package/dist/registry-client.d.ts.map +1 -0
  35. package/dist/registry-client.js +58 -0
  36. package/dist/registry-client.js.map +1 -0
  37. package/dist/registry-contract.d.ts +79 -0
  38. package/dist/registry-contract.d.ts.map +1 -0
  39. package/dist/registry-contract.js +105 -0
  40. package/dist/registry-contract.js.map +1 -0
  41. package/dist/space-schema-diff.d.ts +2 -2
  42. package/dist/space-schema-diff.d.ts.map +1 -1
  43. package/dist/space-schema-diff.js +29 -2
  44. package/dist/space-schema-diff.js.map +1 -1
  45. package/dist/streams.d.ts +46 -5
  46. package/dist/streams.d.ts.map +1 -1
  47. package/dist/streams.js +120 -8
  48. package/dist/streams.js.map +1 -1
  49. package/dist/types.d.ts +3 -2
  50. package/dist/types.d.ts.map +1 -1
  51. package/package.json +1 -1
@@ -0,0 +1,105 @@
1
+ /**
2
+ * The registry's wire contract (SPEC 13.20). `registry` is a registered endpoint that answers
3
+ * discovery questions: one untargeted, ephemeral, read-only command per question, each behind its
4
+ * own capability so the broker checks a grant per question. Every answer is `{ rows, next?, source }`,
5
+ * paged by `{ limit?, after? }`. This revision has one question, `endpoints`: the registered
6
+ * endpoints the caller holds a command on, and the request forms its recorded ceiling covers.
7
+ */
8
+ import { buildClusterArtifacts, buildClusterDocument } from "./endpoint-cluster.js";
9
+ import { serviceContractTable } from "./schema-profile.js";
10
+ export const REGISTRY_ENDPOINT = "registry";
11
+ export const REGISTRY_CLUSTER_URN = "ai.cotal.registry";
12
+ export const REGISTRY_ENDPOINTS_COMMAND = "endpoints";
13
+ export const REGISTRY_ENDPOINTS_CAPABILITY = "registry.endpoints";
14
+ /** The most rows one `endpoints` page carries. A page is also cut short to fit a broker message. */
15
+ export const REGISTRY_PAGE_LIMIT = 100;
16
+ /** The one grant a listing needs: the `endpoints` request on the class route. */
17
+ export const REGISTRY_ENDPOINTS_GRANT = Object.freeze({ endpoint: REGISTRY_ENDPOINT, command: REGISTRY_ENDPOINTS_COMMAND });
18
+ const NAME = { type: "string", minLength: 1, maxLength: 128 };
19
+ const TOKEN = { type: "string", minLength: 1, maxLength: 64 };
20
+ const ENDPOINTS_INPUT = {
21
+ type: "object",
22
+ additionalProperties: false,
23
+ properties: {
24
+ limit: { type: "integer", minimum: 1, maximum: REGISTRY_PAGE_LIMIT },
25
+ after: NAME,
26
+ },
27
+ };
28
+ const FORM = {
29
+ type: "object",
30
+ additionalProperties: false,
31
+ required: ["rail", "literals", "covered"],
32
+ properties: {
33
+ rail: { enum: ["ep", "ep.v1", "epj"] },
34
+ route: { enum: ["one", "all", "inst"] },
35
+ mode: TOKEN,
36
+ literals: { type: "object", additionalProperties: { type: "array", items: TOKEN } },
37
+ covered: { type: "array", items: { type: "object", additionalProperties: { type: ["string", "null"], maxLength: 64 } } },
38
+ },
39
+ };
40
+ const ENDPOINTS_OUTPUT = {
41
+ type: "object",
42
+ additionalProperties: false,
43
+ required: ["rows", "source"],
44
+ properties: {
45
+ rows: {
46
+ type: "array",
47
+ maxItems: REGISTRY_PAGE_LIMIT,
48
+ items: {
49
+ type: "object",
50
+ additionalProperties: false,
51
+ required: ["endpoint", "instances", "commands"],
52
+ properties: {
53
+ endpoint: NAME,
54
+ instances: {
55
+ type: "array",
56
+ items: {
57
+ type: "object",
58
+ additionalProperties: false,
59
+ required: ["instanceId", "state", "artifacts"],
60
+ properties: {
61
+ instanceId: TOKEN,
62
+ state: { type: ["string", "null"], maxLength: 64 },
63
+ artifacts: { enum: ["verified", "missing", "invalid"] },
64
+ },
65
+ },
66
+ },
67
+ commands: {
68
+ type: "array",
69
+ items: {
70
+ type: "object",
71
+ additionalProperties: false,
72
+ required: ["name", "class", "forms"],
73
+ properties: {
74
+ name: TOKEN,
75
+ class: { enum: ["ephemeral", "journal"] },
76
+ forms: { type: "array", items: FORM },
77
+ instances: { type: "array", items: TOKEN },
78
+ },
79
+ },
80
+ },
81
+ unprojected: { type: "array", items: TOKEN },
82
+ },
83
+ },
84
+ },
85
+ next: NAME,
86
+ source: { enum: ["recorded-ceiling", "no-permission-system"] },
87
+ },
88
+ };
89
+ const ROWS = [
90
+ { name: REGISTRY_ENDPOINTS_COMMAND, capability: REGISTRY_ENDPOINTS_CAPABILITY, input: ENDPOINTS_INPUT, output: ENDPOINTS_OUTPUT, targeted: false },
91
+ ];
92
+ const TABLE = serviceContractTable(ROWS);
93
+ /** The compiled input/output pair per command, compiled on first access. */
94
+ export const REGISTRY_CONTRACTS = TABLE.contracts;
95
+ /** Every contract artifact the registry publishes to the contract store at registration. */
96
+ export const registryContractArtifactValues = TABLE.artifactValues;
97
+ /** The cluster document for the registry's served commands. Revision 1: `endpoints`. */
98
+ export function registryClusterDocument() {
99
+ return buildClusterDocument(REGISTRY_CLUSTER_URN, 1, ROWS);
100
+ }
101
+ /** The document's two digests: the root artifact and the closure manifest the service spec names. */
102
+ export function registryClusterArtifacts() {
103
+ return buildClusterArtifacts(registryClusterDocument());
104
+ }
105
+ //# sourceMappingURL=registry-contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry-contract.js","sourceRoot":"","sources":["../src/registry-contract.ts"],"names":[],"mappings":"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"}
@@ -4,7 +4,7 @@ import type { SpaceSchemaObservation } from "./space-schema-observation.js";
4
4
  import { type StreamSchemaRow } from "./stream-schema-diff.js";
5
5
  export interface SpaceSchemaDiffRow extends Omit<StreamSchemaRow, "state" | "uninspectedFields"> {
6
6
  kind: SpaceResourceDefinition["kind"];
7
- state: StreamSchemaRow["state"] | "native-store-verification-required" | "native-store-invariants-match" | "native-store-verification-unconfirmed" | "unclassified-stream-settings" | "creation-options-policy-required";
7
+ state: StreamSchemaRow["state"] | "native-store-verification-required" | "native-store-invariants-match" | "native-store-verification-unconfirmed" | "unclassified-stream-settings" | "creation-options-policy-required" | "operator-set-history-limit";
8
8
  /** Outside the declarative field comparison; a separate native check can inspect more fields. */
9
9
  uncomparedFields: string[];
10
10
  /** A match covers that native check, not complete effective schema or connection authority. */
@@ -13,7 +13,7 @@ export interface SpaceSchemaDiffRow extends Omit<StreamSchemaRow, "state" | "uni
13
13
  unexpandedCreationOptions: readonly string[];
14
14
  reconciliation: {
15
15
  state: "not-evaluated" | "no-declared-change" | "native-guard-required" | "migration-required";
16
- nativeGuard: "ttl-enforcement" | "artifact-legacy-cap" | "contract-shadow" | null;
16
+ nativeGuard: "ttl-enforcement" | "artifact-legacy-cap" | "contract-shadow" | "chat-legacy-history" | null;
17
17
  fields: readonly string[];
18
18
  nonAllowlistedFields: readonly string[];
19
19
  };
@@ -1 +1 @@
1
- {"version":3,"file":"space-schema-diff.d.ts","sourceRoot":"","sources":["../src/space-schema-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsF,KAAK,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AACnK,OAAO,EAAyG,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAQ1K,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAA2D,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAExH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAC9F,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,oCAAoC,GAAG,+BAA+B,GAAG,uCAAuC,GAAG,8BAA8B,GAAG,kCAAkC,CAAC;IACzN,iGAAiG;IACjG,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+FAA+F;IAC/F,kBAAkB,EAAE,aAAa,GAAG,kBAAkB,GAAG,eAAe,CAAC;IACzE,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,cAAc,EAAE;QACd,KAAK,EAAE,eAAe,GAAG,oBAAoB,GAAG,uBAAuB,GAAG,oBAAoB,CAAC;QAC/F,WAAW,EAAE,iBAAiB,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,IAAI,CAAC;QAClF,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1B,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;KACzC,CAAC;IACF,mBAAmB,EAAE;QACnB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;QAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAkGD;;;gFAGgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,sBAAsB,EAAE,EAAE,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;EAgDrI"}
1
+ {"version":3,"file":"space-schema-diff.d.ts","sourceRoot":"","sources":["../src/space-schema-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsF,KAAK,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AACnK,OAAO,EAAyG,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAS1K,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAA2D,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAExH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAC9F,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,oCAAoC,GAAG,+BAA+B,GAAG,uCAAuC,GAAG,8BAA8B,GAAG,kCAAkC,GAAG,4BAA4B,CAAC;IACxP,iGAAiG;IACjG,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,+FAA+F;IAC/F,kBAAkB,EAAE,aAAa,GAAG,kBAAkB,GAAG,eAAe,CAAC;IACzE,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,yBAAyB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,cAAc,EAAE;QACd,KAAK,EAAE,eAAe,GAAG,oBAAoB,GAAG,uBAAuB,GAAG,oBAAoB,CAAC;QAC/F,WAAW,EAAE,iBAAiB,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,IAAI,CAAC;QAC1G,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1B,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;KACzC,CAAC;IACF,mBAAmB,EAAE;QACnB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;QAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAqHD;;;gFAGgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,sBAAsB,EAAE,EAAE,OAAO,GAAE,qBAA0B;;;;;;;;;;;;;EAkDrI"}
@@ -4,7 +4,8 @@ import { assertIssuedStoreConfig, WRITE_ONCE_PER_KEY } from "./issued-authority.
4
4
  import { assertAdmissionStoreConfig } from "./run-admission.js";
5
5
  import { authorityStreamShapeIssue } from "./authority-store-config.js";
6
6
  import { assertArtifactStoreConfig, LEGACY_ARTIFACT_STORE_MAX_BYTES } from "./streams.js";
7
- import { streamReadPolicyBaseline, validateCanonicalBackupStreamConfig } from "./backup-config.js";
7
+ import { chatHistoryLimitOf, isLegacyChatHistory, streamReadPolicyBaseline, validateCanonicalBackupStreamConfig } from "./backup-config.js";
8
+ import { chatStream } from "./subjects.js";
8
9
  import { canonicalJson } from "./canonical.js";
9
10
  import { DiscardPolicy } from "@nats-io/jetstream";
10
11
  import { diffDeclaredStreamConfigs } from "./stream-schema-diff.js";
@@ -106,6 +107,24 @@ function nativeVerification(resource, config, space) {
106
107
  return { status: "not-confirmed", fields: [] };
107
108
  }
108
109
  }
110
+ /** The chat stream's history limit, which an operator sets (`cotal history limit`) and `cotal up`
111
+ * migrates only from the legacy pair. */
112
+ const CHAT_HISTORY_FIELDS = new Set(["max_age", "max_msgs_per_subject"]);
113
+ /** How a chat row whose only differences are its history limit stands, or undefined when the row is
114
+ * not one. The whole observed config must pass the canonical check; the observed limit is never
115
+ * copied into the desired config. */
116
+ function chatHistoryLimitStanding(resource, observation, fields, space) {
117
+ if (resource.stream !== chatStream(space) || observation?.state !== "present" || fields.length === 0 || !fields.every((field) => CHAT_HISTORY_FIELDS.has(field)))
118
+ return undefined;
119
+ const config = observation.config;
120
+ try {
121
+ validateCanonicalBackupStreamConfig(space, resource.stream, config);
122
+ }
123
+ catch {
124
+ return undefined;
125
+ }
126
+ return isLegacyChatHistory(chatHistoryLimitOf(config)) ? "legacy" : "operator-set";
127
+ }
109
128
  /** This allowlist names existing native guard families, never accepted actions. It does not
110
129
  * call creators/migrations, prove a shadow-free stream or inspect a leftover TTL canary. */
111
130
  function reconciliationPolicy(resource, observation, row, extras, unexpanded, space) {
@@ -123,6 +142,12 @@ function reconciliationPolicy(resource, observation, row, extras, unexpanded, sp
123
142
  }
124
143
  if (fields.length === 0)
125
144
  return { state: "no-declared-change", nativeGuard: null, fields, nonAllowlistedFields: [] };
145
+ const chat = chatHistoryLimitStanding(resource, observation, fields, space);
146
+ if (chat === "legacy")
147
+ return { state: "native-guard-required", nativeGuard: "chat-legacy-history", fields, nonAllowlistedFields: [] };
148
+ // `cotal up` leaves an operator's limit as it is.
149
+ if (chat === "operator-set")
150
+ return { state: "no-declared-change", nativeGuard: null, fields: [], nonAllowlistedFields: [] };
126
151
  if (resource.kind === "object-store" && fields.length === 1 && fields[0] === "max_bytes" && observation.config.max_bytes === LEGACY_ARTIFACT_STORE_MAX_BYTES) {
127
152
  try {
128
153
  assertArtifactStoreConfig({ ...observation.config, max_bytes: -1 }, space);
@@ -181,7 +206,9 @@ export function diffSpaceResources(space, observations, options = {}) {
181
206
  : verification === "not-confirmed" ? "native-store-verification-unconfirmed"
182
207
  : resource.kind !== "stream" ? verification === "invariants-match" ? "native-store-invariants-match" : "native-store-verification-required"
183
208
  : row.state
184
- : row.state;
209
+ : row.state === "incompatible-or-drifted" && !fields.unexpanded.length && extras.status === "checked" && !extras.nondefaultUndeclared.length && !extras.unmodeled.length
210
+ && chatHistoryLimitStanding(resource, observation, row.differences.map((difference) => difference.field), space) === "operator-set" ? "operator-set-history-limit"
211
+ : row.state;
185
212
  const reconciliation = reconciliationPolicy(resource, observation, row, extras, fields.unexpanded, space);
186
213
  const { uninspectedFields, ...comparison } = row;
187
214
  return { ...comparison, kind: resource.kind, state, uncomparedFields: uninspectedFields, nativeVerification: verification, nativeInvariantFields: checked.fields, unexpandedCreationOptions: fields.unexpanded, observedExtraFields: extras, reconciliation };
@@ -1 +1 @@
1
- {"version":3,"file":"space-schema-diff.js","sourceRoot":"","sources":["../src/space-schema-diff.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"space-schema-diff.js","sourceRoot":"","sources":["../src/space-schema-diff.ts"],"names":[],"mappings":"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"}
package/dist/streams.d.ts CHANGED
@@ -1,16 +1,13 @@
1
1
  import { StorageType, type ConsumerConfig, type JetStreamClient, type JetStreamManager, type StreamConfig } from "@nats-io/jetstream";
2
2
  import { type NatsConnection } from "@nats-io/transport-node";
3
3
  import { Kvm } from "@nats-io/kv";
4
+ import { type ChatHistoryLimit } from "./backup-config.js";
4
5
  /** #1356: the presence bucket is memory-backed. Its records are pure liveness that every endpoint
5
6
  * rewrites every heartbeat and republishes after a broker restart, so durability buys nothing, while
6
7
  * a file-backed store can latch a permanent write error that refuses every later write (and so every
7
8
  * registering bind) until the broker restarts. Storage class is fixed at stream creation, so a bucket
8
9
  * created file-backed by an older cotal stays file-backed until it is recreated. */
9
10
  export declare const PRESENCE_STORAGE: "memory";
10
- /** Per-(sender,channel)-subject retention cap on the chat stream — the bound past which the
11
- * oldest message on a subject is discarded (`DiscardPolicy.Old`). Also the horizon of focus
12
- * recall: only the last {@link MAX_MSGS_PER_SUBJECT} per sender-subject are recallable. */
13
- export declare const MAX_MSGS_PER_SUBJECT = 1000;
14
11
  /** JetStream message-dedup window on the Plane-3 streams: a `Nats-Msg-Id`
15
12
  * (`<msgId>:<owner>:<generation>`) repeated within this window is collapsed. Sized generous (2h) so
16
13
  * an activation-catch-up copy and a racing fan-out copy of the same message dedup even for a slow/
@@ -150,6 +147,48 @@ export declare function ensureMembershipStore(jsm: JetStreamManager, kvm: Kvm, s
150
147
  * definitions, shared by the endpoint and the setup path so they can't diverge.
151
148
  */
152
149
  export declare function createSpaceStreams(jsm: JetStreamManager, space: string): Promise<void>;
150
+ /** A chat history limit change the broker acknowledged and reported back. */
151
+ export interface ChatHistoryChange {
152
+ stream: string;
153
+ from: ChatHistoryLimit;
154
+ to: ChatHistoryLimit;
155
+ }
156
+ /** The STREAM.UPDATE was submitted and neither its reply nor the read back confirmed the requested
157
+ * limit, so it may or may not have changed. Not retried. */
158
+ export declare class ChatHistoryUpdateUnknown extends Error {
159
+ readonly stream: string;
160
+ readonly requested: ChatHistoryLimit;
161
+ constructor(stream: string, requested: ChatHistoryLimit, cause: unknown);
162
+ }
163
+ /** The chat stream's limit moved between the caller's read and this write. */
164
+ export declare class ChatHistoryChanged extends Error {
165
+ readonly stream: string;
166
+ readonly expected: ChatHistoryLimit;
167
+ readonly found: ChatHistoryLimit;
168
+ constructor(stream: string, expected: ChatHistoryLimit, found: ChatHistoryLimit);
169
+ }
170
+ /** `30d, 1000 per sender`, or `no age limit, 1000 per sender`. */
171
+ export declare function describeChatHistory(limit: ChatHistoryLimit): string;
172
+ /** An age in the largest whole unit of `d`, `h`, `m` or `s`, the form `--max-age` takes. */
173
+ export declare function formatChatAge(ms: number): string;
174
+ /**
175
+ * Set the chat stream's history limit to `limit`. Only `max_age` and `max_msgs_per_subject` change,
176
+ * over the config read for this write, after the whole of that config was checked. Both are read
177
+ * back. `expected` is the limit the caller showed the operator: a stream found holding another one
178
+ * is refused with {@link ChatHistoryChanged}. That read and the update are not one atomic step, so
179
+ * two writers racing past the read can still overwrite each other.
180
+ *
181
+ * A lower limit takes effect at once: the broker expires every post older than the age and each
182
+ * sender's posts past the count. Returns undefined when the stream already holds `limit`.
183
+ */
184
+ export declare function setChatHistoryLimit(jsm: JetStreamManager, space: string, limit: ChatHistoryLimit, expected?: ChatHistoryLimit): Promise<ChatHistoryChange | undefined>;
185
+ /**
186
+ * `cotal up`'s chat history step: a chat stream still on {@link LEGACY_CHAT_HISTORY}, the limit
187
+ * every stream had before it was configurable, moves to {@link CHAT_HISTORY_DEFAULT}, and the
188
+ * broker then expires its posts older than the default age. Any other limit a stream may hold is
189
+ * the operator's and is left alone. A stream that is not canonical apart from its limit refuses.
190
+ */
191
+ export declare function reconcileChatHistory(jsm: JetStreamManager, space: string): Promise<ChatHistoryChange | undefined>;
153
192
  /**
154
193
  * The DM inbox durable for an instance — ONE definition, used both by the privileged
155
194
  * pre-create (manager/provisioner, auth mode) and the endpoint's open-mode self-create, so
@@ -324,7 +363,9 @@ export declare function setupSpaceStreams(opts: {
324
363
  space: string;
325
364
  /** Privileged creds for an authed mesh; omit on an open mesh (a bare connection has the rights). */
326
365
  creds?: string;
327
- }): Promise<void>;
366
+ }): Promise<{
367
+ chatHistory?: ChatHistoryChange;
368
+ }>;
328
369
  /** Purge retained message history for a running space. This intentionally leaves TASK alone:
329
370
  * anycast is queued work, not replay history. */
330
371
  export declare function clearSpaceHistory(opts: {
@@ -1 +1 @@
1
- {"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"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"}
package/dist/streams.js CHANGED
@@ -1,7 +1,7 @@
1
- import { jetstream, jetstreamManager, AckPolicy, DeliverPolicy, StorageType, } from "@nats-io/jetstream";
1
+ import { jetstream, jetstreamManager, AckPolicy, DeliverPolicy, JetStreamApiError, StorageType, } from "@nats-io/jetstream";
2
2
  import { randomUUID } from "node:crypto";
3
3
  import { tokenAuthenticator, nanos } from "@nats-io/transport-node";
4
- import { dialerFor } from "./endpoint.js";
4
+ import { dialerFor, isPublishPermissionDenied } from "./endpoint.js";
5
5
  import { Kvm } from "@nats-io/kv";
6
6
  import { Objm } from "@nats-io/obj";
7
7
  import { spacePrefix, artifactBucket, objectStoreStream, chatStream, chatSubject, chatWildcard, isConcreteChannel, dmStream, dmDurable, unicastRecvFilter, taskStream, taskDurable, anycastServeFilter, presenceBucket, channelBucket, membersBucket, aclBucket, aclKey, membershipBucket, deliveryBucket, managerBucket, inboxStream, dlvStream, dlvSubject, dlvDurable, fanoutDurable, readerDurable, DEV_OWNER, principalKey, memberKey, deprovisionTargetPrincipal, } from "./subjects.js";
@@ -13,7 +13,7 @@ import { isCasLoss } from "./endpoint-records.js";
13
13
  import { createEndpointStreams } from "./endpoint-binding.js";
14
14
  import { openAclRegistry, deleteAcl, fenceAcl } from "./acls.js";
15
15
  import { openMembersRegistry, deleteMember } from "./members.js";
16
- import { BACKUP_MAX_MSGS_PER_SUBJECT, BACKUP_PLANE3_DEDUP_WINDOW_MS, canonicalBackupStreamConfig, } from "./backup-config.js";
16
+ import { BACKUP_PLANE3_DEDUP_WINDOW_MS, CHAT_HISTORY_DEFAULT, canonicalBackupStreamConfig, chatHistoryLimitOf, chatHistoryLimitProblem, isLegacyChatHistory, validateCanonicalBackupStreamConfig, } from "./backup-config.js";
17
17
  /** Default presence-bucket entry TTL (ms) — matches the endpoint's default liveness window. */
18
18
  const PRESENCE_TTL_MS = 6_000;
19
19
  /** #1356: the presence bucket is memory-backed. Its records are pure liveness that every endpoint
@@ -22,10 +22,6 @@ const PRESENCE_TTL_MS = 6_000;
22
22
  * registering bind) until the broker restarts. Storage class is fixed at stream creation, so a bucket
23
23
  * created file-backed by an older cotal stays file-backed until it is recreated. */
24
24
  export const PRESENCE_STORAGE = StorageType.Memory;
25
- /** Per-(sender,channel)-subject retention cap on the chat stream — the bound past which the
26
- * oldest message on a subject is discarded (`DiscardPolicy.Old`). Also the horizon of focus
27
- * recall: only the last {@link MAX_MSGS_PER_SUBJECT} per sender-subject are recallable. */
28
- export const MAX_MSGS_PER_SUBJECT = BACKUP_MAX_MSGS_PER_SUBJECT;
29
25
  /** JetStream message-dedup window on the Plane-3 streams: a `Nats-Msg-Id`
30
26
  * (`<msgId>:<owner>:<generation>`) repeated within this window is collapsed. Sized generous (2h) so
31
27
  * an activation-catch-up copy and a racing fan-out copy of the same message dedup even for a slow/
@@ -194,8 +190,119 @@ export async function ensureMembershipStore(jsm, kvm, space) {
194
190
  * definitions, shared by the endpoint and the setup path so they can't diverge.
195
191
  */
196
192
  export async function createSpaceStreams(jsm, space) {
197
- for (const definition of spaceMessageStreamConfigs(space))
193
+ for (const definition of spaceMessageStreamConfigs(space)) {
194
+ // The chat stream's history limit is the operator's (`cotal history limit`), so an existing
195
+ // stream is left as it is: an add over a different limit would refuse, and this also runs on
196
+ // every open-mode connect. Only `cotal up` reconciles it ({@link reconcileChatHistory}).
197
+ if (definition.name === chatStream(space)) {
198
+ try {
199
+ await jsm.streams.info(definition.name);
200
+ continue;
201
+ }
202
+ catch (e) {
203
+ if (!isStreamNotFound(e))
204
+ throw e;
205
+ }
206
+ }
198
207
  await jsm.streams.add(definition);
208
+ }
209
+ }
210
+ /** The STREAM.UPDATE was submitted and neither its reply nor the read back confirmed the requested
211
+ * limit, so it may or may not have changed. Not retried. */
212
+ export class ChatHistoryUpdateUnknown extends Error {
213
+ stream;
214
+ requested;
215
+ constructor(stream, requested, cause) {
216
+ super(`the history limit update of ${stream} was submitted without a confirmed outcome, so it may or may not have taken effect`, { cause });
217
+ this.stream = stream;
218
+ this.requested = requested;
219
+ }
220
+ }
221
+ /** The chat stream's limit moved between the caller's read and this write. */
222
+ export class ChatHistoryChanged extends Error {
223
+ stream;
224
+ expected;
225
+ found;
226
+ constructor(stream, expected, found) {
227
+ super(`the history limit of ${stream} changed since it was read: expected ${describeChatHistory(expected)}, found ${describeChatHistory(found)}`);
228
+ this.stream = stream;
229
+ this.expected = expected;
230
+ this.found = found;
231
+ }
232
+ }
233
+ /** `30d, 1000 per sender`, or `no age limit, 1000 per sender`. */
234
+ export function describeChatHistory(limit) {
235
+ return `${limit.maxAgeMs === 0 ? "no age limit" : formatChatAge(limit.maxAgeMs)}, ${limit.perSender} per sender`;
236
+ }
237
+ /** An age in the largest whole unit of `d`, `h`, `m` or `s`, the form `--max-age` takes. */
238
+ export function formatChatAge(ms) {
239
+ for (const [unit, size] of [["d", 86_400_000], ["h", 3_600_000], ["m", 60_000]])
240
+ if (ms % size === 0)
241
+ return `${ms / size}${unit}`;
242
+ return `${Math.round(ms / 1000)}s`;
243
+ }
244
+ /** The chat stream's config, refused unless every field but the history limit is canonical and the
245
+ * limit is one a stream may hold. */
246
+ async function readChatStreamConfig(jsm, space) {
247
+ const { config } = await jsm.streams.info(chatStream(space));
248
+ validateCanonicalBackupStreamConfig(space, chatStream(space), config);
249
+ return config;
250
+ }
251
+ /**
252
+ * Set the chat stream's history limit to `limit`. Only `max_age` and `max_msgs_per_subject` change,
253
+ * over the config read for this write, after the whole of that config was checked. Both are read
254
+ * back. `expected` is the limit the caller showed the operator: a stream found holding another one
255
+ * is refused with {@link ChatHistoryChanged}. That read and the update are not one atomic step, so
256
+ * two writers racing past the read can still overwrite each other.
257
+ *
258
+ * A lower limit takes effect at once: the broker expires every post older than the age and each
259
+ * sender's posts past the count. Returns undefined when the stream already holds `limit`.
260
+ */
261
+ export async function setChatHistoryLimit(jsm, space, limit, expected) {
262
+ const problem = chatHistoryLimitProblem(limit);
263
+ if (problem)
264
+ throw new Error(`invalid chat history limit: ${problem}`);
265
+ return applyChatHistoryLimit(jsm, space, limit, expected);
266
+ }
267
+ async function applyChatHistoryLimit(jsm, space, limit, expected) {
268
+ const stream = chatStream(space);
269
+ const config = await readChatStreamConfig(jsm, space);
270
+ const from = chatHistoryLimitOf(config);
271
+ if (expected && (from.maxAgeMs !== expected.maxAgeMs || from.perSender !== expected.perSender))
272
+ throw new ChatHistoryChanged(stream, expected, from);
273
+ if (from.maxAgeMs === limit.maxAgeMs && from.perSender === limit.perSender)
274
+ return undefined;
275
+ try {
276
+ await jsm.streams.update(stream, { ...config, max_age: nanos(limit.maxAgeMs), max_msgs_per_subject: limit.perSender });
277
+ }
278
+ catch (e) {
279
+ // A refusal the broker answered, or a publish it denied, changed nothing; anything else may have.
280
+ if (e instanceof JetStreamApiError || isPublishPermissionDenied(e))
281
+ throw e;
282
+ throw new ChatHistoryUpdateUnknown(stream, limit, e);
283
+ }
284
+ let after;
285
+ try {
286
+ after = chatHistoryLimitOf((await readChatStreamConfig(jsm, space)));
287
+ }
288
+ catch (e) {
289
+ throw new ChatHistoryUpdateUnknown(stream, limit, e);
290
+ }
291
+ if (after.maxAgeMs !== limit.maxAgeMs || after.perSender !== limit.perSender)
292
+ throw new ChatHistoryUpdateUnknown(stream, limit, new Error(`${stream} read back ${describeChatHistory(after)}`));
293
+ return { stream, from, to: limit };
294
+ }
295
+ /**
296
+ * `cotal up`'s chat history step: a chat stream still on {@link LEGACY_CHAT_HISTORY}, the limit
297
+ * every stream had before it was configurable, moves to {@link CHAT_HISTORY_DEFAULT}, and the
298
+ * broker then expires its posts older than the default age. Any other limit a stream may hold is
299
+ * the operator's and is left alone. A stream that is not canonical apart from its limit refuses.
300
+ */
301
+ export async function reconcileChatHistory(jsm, space) {
302
+ const config = await readChatStreamConfig(jsm, space);
303
+ if (!isLegacyChatHistory(chatHistoryLimitOf(config)))
304
+ return undefined;
305
+ return applyChatHistoryLimit(jsm, space, CHAT_HISTORY_DEFAULT, chatHistoryLimitOf(config));
199
306
  }
200
307
  /**
201
308
  * The DM inbox durable for an instance — ONE definition, used both by the privileged
@@ -615,6 +722,11 @@ export async function setupSpaceStreams(opts) {
615
722
  // Artifact Object Store (SPEC section 5): the bytes an `artifact` reference part points at.
616
723
  // Create-or-VERIFY, drift fails loud - see ensureArtifactStore for why create alone is not enough.
617
724
  await ensureArtifactStore(nc, opts.space);
725
+ // A chat stream from before the history limit was configurable moves to the default, and the
726
+ // broker then expires its posts older than the default age (SPEC §8). It runs last because it
727
+ // deletes posts, so a setup that a check above refuses deletes nothing.
728
+ const chatHistory = await reconcileChatHistory(jsm, opts.space);
729
+ return chatHistory ? { chatHistory } : {};
618
730
  }
619
731
  finally {
620
732
  await nc.drain();