@essentialai/cogent 3.6.1 → 3.7.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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,16 @@
1
1
  # Changelog
2
2
 
3
+ ## [3.7.0] - 2026-08-08
4
+
5
+ ### Added — Cogent Mail A2A card + PeerInfo mailbox (M2.6)
6
+ - `PeerInfo` gains an optional `mailboxAddress` (+ `PeerInfoSchema`) — the peer's auto-provisioned
7
+ Cogent Mail address (non-secret; present on Team peers once a mailbox exists). The mailbox
8
+ password is NOT a field on `PeerInfo` and can never reach a card.
9
+ - `peerInfoToAgentCard` emits the mailbox as a `capabilities.extensions[]` entry
10
+ (`uri: https://cogent.tools/a2a/ext/mailbox`, `params: { address }`) in both the v1.0.1 and
11
+ v0.3.0 card shapes when present. Chosen over a `supportedInterfaces[]` `mailto:` (which would
12
+ falsely advertise an email task-interaction interface). Builder stays pure.
13
+
3
14
  ## [3.6.1] - 2026-08-06
4
15
 
5
16
  ### Added — multi-tenant surface platforms
@@ -22,6 +22,16 @@ import type { PeerInfo } from "../types/peer.js";
22
22
  export declare const COGENT_PROTOCOL_BINDING = "COGENT-RELAY";
23
23
  /** The A2A protocol major.minor this card's interface exposes. */
24
24
  export declare const A2A_PROTOCOL_VERSION = "1.0";
25
+ /**
26
+ * URI identifying the Cogent Mail capability EXTENSION on an Agent Card. When a peer has an
27
+ * auto-provisioned mailbox we advertise its ADDRESS here (see toMailboxExtensions). We use an
28
+ * `AgentExtension` (capabilities.extensions[]) — NOT a supportedInterfaces[] entry — because the
29
+ * A2A spec reserves `supportedInterfaces` for task-interaction transports (an absolute HTTPS URL
30
+ * + protocol binding); a `mailto:` there would falsely advertise an EMAIL task interface. The
31
+ * extension mechanism is the SDK's intended, least-abusive place for agent-specific protocol
32
+ * metadata with typed `params`, and it validates against @a2a-js/sdk's AgentExtension with no cast.
33
+ */
34
+ export declare const COGENT_MAILBOX_EXTENSION_URI = "https://cogent.tools/a2a/ext/mailbox";
25
35
  export interface AgentCardContext {
26
36
  /** Base relay endpoint (e.g. https://cogent.tools) — the peer is addressed inside a session under it. */
27
37
  endpoint: string;
@@ -1 +1 @@
1
- {"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAEtD,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,yGAAyG;IACzG,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACjC;AAED;;;;GAIG;AACH,KAAK,WAAW,GAAG,QAAQ,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAuCF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAiDvF"}
1
+ {"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AAEtD,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,yCAAyC,CAAC;AAEnF,MAAM,WAAW,gBAAgB;IAC/B,yGAAyG;IACzG,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACjC;AAED;;;;GAIG;AACH,KAAK,WAAW,GAAG,QAAQ,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAyDF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAuDvF"}
@@ -7,6 +7,16 @@
7
7
  export const COGENT_PROTOCOL_BINDING = "COGENT-RELAY";
8
8
  /** The A2A protocol major.minor this card's interface exposes. */
9
9
  export const A2A_PROTOCOL_VERSION = "1.0";
10
+ /**
11
+ * URI identifying the Cogent Mail capability EXTENSION on an Agent Card. When a peer has an
12
+ * auto-provisioned mailbox we advertise its ADDRESS here (see toMailboxExtensions). We use an
13
+ * `AgentExtension` (capabilities.extensions[]) — NOT a supportedInterfaces[] entry — because the
14
+ * A2A spec reserves `supportedInterfaces` for task-interaction transports (an absolute HTTPS URL
15
+ * + protocol binding); a `mailto:` there would falsely advertise an EMAIL task interface. The
16
+ * extension mechanism is the SDK's intended, least-abusive place for agent-specific protocol
17
+ * metadata with typed `params`, and it validates against @a2a-js/sdk's AgentExtension with no cast.
18
+ */
19
+ export const COGENT_MAILBOX_EXTENSION_URI = "https://cogent.tools/a2a/ext/mailbox";
10
20
  /** "role:reviewer" / "auto-resume" → "Reviewer" / "Auto Resume". */
11
21
  function titleCase(s) {
12
22
  return s
@@ -36,6 +46,24 @@ function toSkills(peer) {
36
46
  };
37
47
  });
38
48
  }
49
+ /**
50
+ * A2A capability extensions for a peer. Emits the Cogent Mail extension (address only) when the
51
+ * peer has an auto-provisioned mailbox; otherwise []. The mailbox ADDRESS is non-secret; the
52
+ * mailbox PASSWORD is never part of PeerInfo, so it can never reach the card. PURE.
53
+ */
54
+ function toMailboxExtensions(peer) {
55
+ const address = peer.mailboxAddress;
56
+ if (!address)
57
+ return [];
58
+ return [
59
+ {
60
+ uri: COGENT_MAILBOX_EXTENSION_URI,
61
+ description: "Cogent Mail mailbox address (non-secret) for this peer.",
62
+ required: false,
63
+ params: { address },
64
+ },
65
+ ];
66
+ }
39
67
  function synthDescription(peer) {
40
68
  const parts = [`Cogent fabric peer on ${peer.platform ?? "cc"}`];
41
69
  if (peer.role)
@@ -60,9 +88,15 @@ export function peerInfoToAgentCard(peer, ctx) {
60
88
  const version = ctx.clientVersion ?? peer.clientVersion ?? "0.0.0";
61
89
  const provider = { organization: `Cogent · ${peer.platform ?? "cc"}`, url: "https://cogent.tools" };
62
90
  const skills = toSkills(peer);
91
+ // Cogent Mail M2.6: advertise the peer's mailbox ADDRESS as an A2A capability extension (see
92
+ // COGENT_MAILBOX_EXTENSION_URI). Empty when the peer has no mailbox. Password can never appear
93
+ // here — it is not on PeerInfo. Same array feeds both card shapes below.
94
+ const extensions = toMailboxExtensions(peer);
63
95
  if (ctx.cardVersion === "0.3.0") {
64
96
  // Opt-in legacy scaffold (top-level url + protocolVersion). Different shape than the v1.0.1 type,
65
97
  // hence the deliberate cast — this branch exists only for backward interop, not as the primary card.
98
+ // A2A 0.3.0 also carries capabilities.extensions[]; only surface it when non-empty so a peer
99
+ // WITHOUT a mailbox keeps this branch's original `capabilities: {}` shape byte-for-byte.
66
100
  return {
67
101
  protocolVersion: "0.3.0",
68
102
  name,
@@ -70,7 +104,7 @@ export function peerInfoToAgentCard(peer, ctx) {
70
104
  url,
71
105
  version,
72
106
  provider,
73
- capabilities: {},
107
+ capabilities: extensions.length ? { extensions } : {},
74
108
  defaultInputModes: ["text/plain"],
75
109
  defaultOutputModes: ["text/plain"],
76
110
  skills,
@@ -92,7 +126,7 @@ export function peerInfoToAgentCard(peer, ctx) {
92
126
  tenant: ctx.sessionId,
93
127
  },
94
128
  ],
95
- capabilities: { extensions: [] },
129
+ capabilities: { extensions },
96
130
  defaultInputModes: ["text/plain"],
97
131
  defaultOutputModes: ["text/plain"],
98
132
  skills,
@@ -1 +1 @@
1
- {"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"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"}
@@ -39,6 +39,12 @@ export interface PeerInfo {
39
39
  * the peer's A2A Agent Card skills[]. Optional; back-compat.
40
40
  */
41
41
  capabilities?: string[];
42
+ /**
43
+ * Auto-provisioned Cogent Mail address (non-secret); present on Team peers once a
44
+ * mailbox exists. Form `[peer]-[channel]@mail.cogent.tools`. Fed onto the peer's A2A
45
+ * Agent Card so other agents can discover it. NEVER carries the password.
46
+ */
47
+ mailboxAddress?: string;
42
48
  }
43
49
  /**
44
50
  * PeerInfo schema -- describes a registered peer in a bridge session.
@@ -1 +1 @@
1
- {"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../../src/types/peer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uFAAuF;AACvF,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACvG,yCAAyC;IACzC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,yCAAyC;IACzC,SAAS,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,GAAG,aAAa,CAAC;IAC/G,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAe7C,CAAC"}
1
+ {"version":3,"file":"peer.d.ts","sourceRoot":"","sources":["../../src/types/peer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uFAAuF;AACvF,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACvG,yCAAyC;IACzC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,yCAAyC;IACzC,SAAS,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,gBAAgB,GAAG,cAAc,GAAG,aAAa,CAAC;IAC/G,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAgB7C,CAAC"}
@@ -18,5 +18,6 @@ export const PeerInfoSchema = z.object({
18
18
  threadId: z.string().optional().describe("Durable thread/conversation identifier (Slice 5)"),
19
19
  role: z.string().max(64).optional().describe("A2A role advertised by this peer (Agent Card)"),
20
20
  capabilities: z.array(z.string().max(64)).max(16).optional().describe("Capability strings → A2A Agent Card skills[]"),
21
+ mailboxAddress: z.string().max(320).optional().describe("Auto-provisioned Cogent Mail address (non-secret); NEVER the password"),
21
22
  });
22
23
  //# sourceMappingURL=peer.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"peer.js","sourceRoot":"","sources":["../../src/types/peer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4CxB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACrE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAClD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC9E,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC5J,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACzF,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC1K,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;IAC/I,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC;IAClI,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC5F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC7F,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACtH,CAAC,CAAC"}
1
+ {"version":3,"file":"peer.js","sourceRoot":"","sources":["../../src/types/peer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkDxB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACrE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAClD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC9E,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC5J,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACzF,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC1K,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;IAC/I,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qFAAqF,CAAC;IAClI,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC5F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC7F,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IACrH,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;CACjI,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@essentialai/cogent",
3
- "version": "3.6.1",
3
+ "version": "3.7.0",
4
4
  "description": "Shared types, schemas, and contracts for Cogent Bridge",
5
5
  "type": "module",
6
6
  "exports": {