@cotal-ai/core 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/agent-file.d.ts

@@ -0,0 +1,24 @@
+import type { EndpointKind } from "./types.js";
+export interface AgentDef {
+    name: string;
+    role?: string;
+    kind?: EndpointKind;
+    description?: string;
+    tags?: string[];
+    channels?: string[];
+    /** Channels this agent is allowed to publish to (auth mode → minted into pub-allow ACLs).
+     *  Entries may be wildcard subtrees (`team.>`), symmetric with `channels`. Omitted means
+     *  no explicit restriction beyond identity (the provisioner falls back to `channels`). */
+    publish?: string[];
+    /** Model override handed to the agent CLI (e.g. `claude --model`). */
+    model?: string;
+    /** Markdown body — the agent's persona / appended system prompt. */
+    persona?: string;
+}
+/** Load and parse an agent definition file (Markdown + `---` frontmatter). */
+export declare function loadAgentFile(path: string): AgentDef;
+/** Resolve a name-or-path to an agent file. A path (absolute, contains a slash,
+ *  or ends in `.md`) is used as given; a bare name maps to the directory
+ *  convention `<root>/.cotal/agents/<name>.md`. */
+export declare function agentFilePath(root: string, nameOrPath: string): string;
+//# sourceMappingURL=agent-file.d.ts.map

package/dist/agent-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-file.d.ts","sourceRoot":"","sources":["../src/agent-file.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;8FAE0F;IAC1F,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAmCD,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAmCpD;AAED;;mDAEmD;AACnD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAItE"}

package/dist/agent-file.js

@@ -0,0 +1,106 @@
+/**
+ * Agent definition files — the persisted form of an agent's identity + persona.
+ *
+ *   .cotal/agents/<name>.md
+ *   ---
+ *   name: builder          # AgentCard-shaped identity in the frontmatter
+ *   role: builder
+ *   description: …
+ *   tags: [edit, test]
+ *   channels: [general]    # channels this agent subscribes to (read)
+ *   publish: [general]     # channels this agent may post to (write); omit = same as channels
+ *   model: opus            # optional CLI/model override
+ *   ---
+ *   <the Markdown body is the persona — an appended system prompt>
+ *
+ * A launcher resolves a name (or path) to one of these, hands the persona/model
+ * to the agent process at spawn, and passes the file through so the joined
+ * session reads its own card from it. Part of the wire contract's onboarding
+ * half, alongside the join link.
+ */
+import { readFileSync } from "node:fs";
+import { isAbsolute, join, resolve } from "node:path";
+/** Strip wrapping quotes from a scalar value. */
+function unquote(v) {
+    if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'")))
+        return v.slice(1, -1);
+    return v;
+}
+/** Parse the frontmatter subset we support: `key: value` scalars and inline
+ *  `key: [a, b]` string lists. Throws on anything fancier — block lists, nested
+ *  maps and multi-doc YAML are deliberately unsupported (no silent fallback). */
+function parseFrontmatter(src) {
+    const out = {};
+    for (const raw of src.split("\n")) {
+        const line = raw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const colon = line.indexOf(":");
+        if (colon < 1)
+            throw new Error(`agent file: unparseable frontmatter line "${raw}"`);
+        const key = line.slice(0, colon).trim();
+        const val = line.slice(colon + 1).trim();
+        if (val.startsWith("[")) {
+            if (!val.endsWith("]"))
+                throw new Error(`agent file: unterminated list for "${key}"`);
+            out[key] = val
+                .slice(1, -1)
+                .split(",")
+                .map((s) => unquote(s.trim()))
+                .filter(Boolean);
+        }
+        else {
+            out[key] = unquote(val);
+        }
+    }
+    return out;
+}
+/** Load and parse an agent definition file (Markdown + `---` frontmatter). */
+export function loadAgentFile(path) {
+    const src = readFileSync(path, "utf8");
+    const m = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/.exec(src);
+    if (!m)
+        throw new Error(`agent file ${path}: missing "---" frontmatter block`);
+    const fm = parseFrontmatter(m[1]);
+    const persona = m[2].trim();
+    const str = (k) => {
+        const v = fm[k];
+        if (Array.isArray(v))
+            throw new Error(`agent file ${path}: "${k}" must be a scalar`);
+        return v;
+    };
+    const list = (k) => {
+        const v = fm[k];
+        if (v === undefined)
+            return undefined;
+        return Array.isArray(v) ? v : [v];
+    };
+    const name = str("name");
+    if (!name)
+        throw new Error(`agent file ${path}: "name" is required`);
+    const kind = str("kind");
+    if (kind && kind !== "agent" && kind !== "endpoint")
+        throw new Error(`agent file ${path}: "kind" must be "agent" or "endpoint"`);
+    return {
+        name,
+        role: str("role"),
+        kind: kind,
+        description: str("description"),
+        tags: list("tags"),
+        channels: list("channels"),
+        publish: list("publish"),
+        model: str("model"),
+        persona: persona || undefined,
+    };
+}
+/** Resolve a name-or-path to an agent file. A path (absolute, contains a slash,
+ *  or ends in `.md`) is used as given; a bare name maps to the directory
+ *  convention `<root>/.cotal/agents/<name>.md`. */
+export function agentFilePath(root, nameOrPath) {
+    if (isAbsolute(nameOrPath))
+        return nameOrPath;
+    if (nameOrPath.includes("/") || nameOrPath.endsWith(".md"))
+        return resolve(root, nameOrPath);
+    return join(root, ".cotal", "agents", `${nameOrPath}.md`);
+}
+//# sourceMappingURL=agent-file.js.map

package/dist/agent-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-file.js","sourceRoot":"","sources":["../src/agent-file.ts"],"names":[],"mappings":"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"}

package/dist/command.d.ts

@@ -0,0 +1,15 @@
+import type { Extension } from "./registry.js";
+/**
+ * The contract for a composable CLI command — an {@link Extension} of kind
+ * `"command"`. An implementation (the mesh CLI, the manager …) self-registers its
+ * commands on import; the `cotal` binary resolves them from the registry.
+ */
+export interface Command extends Extension {
+    readonly kind: "command";
+    readonly name: string;
+    readonly summary: string;
+    /** Help grouping header (e.g. "Mesh", "Control plane"). Defaults to "Commands". */
+    readonly group?: string;
+    run(argv: string[]): Promise<void>;
+}
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,OAAQ,SAAQ,SAAS;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}

package/dist/command.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":""}

package/dist/connector.d.ts

@@ -0,0 +1,43 @@
+import type { Extension } from "./registry.js";
+/** Identity + mesh coordinates the manager hands a connector to launch an agent. */
+export interface LaunchOpts {
+    space: string;
+    name: string;
+    role?: string;
+    /** Stable agent id (the nkey public key). When set, the launched session adopts it
+     *  as its `card.id` instead of generating a random one — so the id the launcher
+     *  provisioned is the id the agent presents, and later ACLs key on it. */
+    id?: string;
+    /** Path to a minted creds file (auth mode). Passed to the session so it authenticates
+     *  as `id`; absent when the mesh runs open. */
+    creds?: string;
+    servers?: string;
+    /** Path to an agent definition file (`.cotal/agents/<name>.md`). The connector
+     *  passes it through (`COTAL_AGENT_FILE`) so the joined session reads its own
+     *  card from it, and applies the file's persona/model at launch. */
+    configPath?: string;
+}
+/** A recipe for starting an agent as a mesh node — command, args, and extra env. */
+export interface LaunchSpec {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    /** Auto-clear a one-time spawn prompt: when this text appears in the agent's
+     *  early output, the runtime presses Enter once so a supervised launch stays
+     *  non-interactive. Matched after stripping ANSI + whitespace (TUIs position
+     *  text with cursor moves, not spaces). */
+    confirm?: string;
+}
+/**
+ * A bridge that knows how to launch one agent type (Claude Code, Codex, the CLI
+ * peer …) as a Cotal mesh node — an {@link Extension} of kind `"connector"`.
+ * `name` is the agent type it handles — the key the manager resolves by.
+ * Connectors self-register on import; the manager resolves them from the registry,
+ * and core stays ignorant of which ones exist.
+ */
+export interface Connector extends Extension {
+    readonly kind: "connector";
+    readonly name: string;
+    buildLaunch(opts: LaunchOpts): LaunchSpec;
+}
+//# sourceMappingURL=connector.d.ts.map

package/dist/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;8EAE0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;mDAC+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;wEAEoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oFAAoF;AACpF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;+CAG2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;CAC3C"}

package/dist/connector.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connector.js.map

package/dist/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":""}

package/dist/endpoint.d.ts

@@ -0,0 +1,193 @@
+import { EventEmitter } from "node:events";
+import type { AgentCard, ControlReply, ControlRequest, EndpointRef, Part, Presence, PresenceStatus, CotalMessage } from "./types.js";
+export declare const DEFAULT_SERVER = "nats://127.0.0.1:4222";
+export interface EndpointOptions {
+    /** The collaboration to join. */
+    space: string;
+    /** Identity. `id` is generated if omitted. */
+    card: Omit<AgentCard, "id"> & {
+        id?: string;
+    };
+    servers?: string;
+    /** Connection token (soft-shared auth). Mutually exclusive with user/pass. */
+    token?: string;
+    /** Username/password auth (both required together). */
+    user?: string;
+    pass?: string;
+    /** NATS user creds file *content* (JWT + nkey seed). When set, the endpoint
+     *  authenticates as that user and adopts the creds' identity as its card.id. */
+    creds?: string;
+    /** Require a TLS connection to the server. */
+    tls?: boolean;
+    /** Channels to subscribe to; the first is the default broadcast target. */
+    channels?: string[];
+    /** Presence heartbeat interval (ms). */
+    heartbeatMs?: number;
+    /** Presence liveness window (ms); a peer is considered gone after this. */
+    ttlMs?: number;
+    /** Publish our own presence (default true). */
+    registerPresence?: boolean;
+    /** Track the roster of peers (default true). */
+    watchPresence?: boolean;
+    /** Create inbound stream consumers (DM / chat / anycast). Default true; a pure observer sets false. */
+    consume?: boolean;
+    /** How long an unacked (un-surfaced) message waits before redelivery (ms). */
+    ackWaitMs?: number;
+    /** Retire this instance's durable consumers after it's been gone this long (ms). */
+    inactiveThresholdMs?: number;
+}
+/**
+ * Events: "message" (CotalMessage), "presence" (PresenceEvent), "roster" (Presence[]), "error" (Error).
+ *
+ * Callers MUST attach an "error" listener before `start()`: async faults (incl. NATS
+ * permission denials, surfaced via `watchStatus`) are emitted as "error", and Node throws
+ * synchronously on an unhandled "error" — a missing listener turns any such fault into a
+ * process crash instead of a logged denial.
+ */
+export declare class CotalEndpoint extends EventEmitter {
+    readonly card: AgentCard;
+    readonly space: string;
+    readonly channels: string[];
+    private readonly servers;
+    private readonly token?;
+    private readonly user?;
+    private readonly pass?;
+    private readonly creds?;
+    private readonly tls;
+    private readonly heartbeatMs;
+    private readonly ttlMs;
+    private readonly doRegister;
+    private readonly doWatch;
+    private readonly doConsume;
+    private readonly ackWaitMs;
+    private readonly inactiveThresholdMs;
+    private nc?;
+    private js?;
+    private jsm?;
+    private kv?;
+    private readonly subs;
+    private readonly streamMsgs;
+    private heartbeatTimer?;
+    private sweepTimer?;
+    private readonly roster;
+    private status;
+    private activity?;
+    private stopped;
+    constructor(opts: EndpointOptions);
+    ref(): EndpointRef;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Multicast: broadcast to everyone on a channel. */
+    multicast(text: string, opts?: {
+        channel?: string;
+        parts?: Part[];
+        replyTo?: string;
+        contextId?: string;
+        mentions?: string[];
+    }): Promise<CotalMessage>;
+    /** Unicast: direct message to one specific instance. */
+    unicast(instanceId: string, text: string, opts?: {
+        parts?: Part[];
+        replyTo?: string;
+        contextId?: string;
+    }): Promise<CotalMessage>;
+    /** Anycast: deliver to ANY one instance of a service (role) — queue-group load balancing. */
+    anycast(service: string, text: string, opts?: {
+        parts?: Part[];
+        replyTo?: string;
+        contextId?: string;
+    }): Promise<CotalMessage>;
+    /** Subscribe to a read-only observer feed. Defaults to the whole space; an observer under
+     *  auth must pass `chatWildcard(space)` since its `sub.allow` only covers chat (DM/anycast
+     *  stay confidential), otherwise the space-wildcard subscribe is denied and the feed dies. */
+    tap(handler: (subject: string, msg: CotalMessage | undefined) => void, opts?: {
+        subject?: string;
+    }): void;
+    /** Serve control requests for a service (manager side). */
+    serveControl(service: string, handler: (req: ControlRequest) => Promise<ControlReply> | ControlReply): void;
+    /** Send a control request to a service and await its reply (client side). */
+    requestControl(service: string, req: ControlRequest, timeoutMs?: number): Promise<ControlReply>;
+    getRoster(): Presence[];
+    setActivity(activity: string): Promise<void>;
+    setStatus(status: PresenceStatus): Promise<void>;
+    /** List channels that have messages in the chat stream, with message counts.
+     *  Works even on observer endpoints (no consumers needed). */
+    listChannels(): Promise<{
+        channel: string;
+        messages: number;
+    }[]>;
+    /** Fetch recent messages from a channel's JetStream backlog. */
+    channelHistory(channel: string, opts?: {
+        limit?: number;
+    }): Promise<CotalMessage[]>;
+    /** Fetch recent DMs (any sender→any recipient) from the space's DM backlog. God-view only:
+     *  a normal agent/observer's ACL denies CONSUMER.CREATE on DM_<space>, so this throws-and-
+     *  skips for them — only an `admin`-profile cred can read it. */
+    dmHistory(opts?: {
+        limit?: number;
+    }): Promise<CotalMessage[]>;
+    /** Drain up to `limit` recent messages matching `subject` from a stream's backlog via a
+     *  throwaway consumer. Fetches exactly the pending count (from consumer info) so it returns
+     *  the moment the backlog is delivered — a plain `fetch({max_messages: limit})` would instead
+     *  block for the pull's full expiry (~30s) whenever the backlog is smaller than `limit`. */
+    private streamHistory;
+    /**
+     * Surface the connection's async status errors on our `error` event. NATS reports
+     * publish permission violations *only* here (subscription/request ones too), never on
+     * the failing call — so without this an over-tight ACL silently drops the agent's
+     * traffic and it just looks "absent". We annotate permission denials explicitly so a
+     * denial is never mistaken for absence (which already has a benign cause: MCP reconnect).
+     */
+    private watchStatus;
+    private publishMsg;
+    /** Create the three backing streams for this space (idempotent). Open-mode lazy create;
+     *  the same definitions are used by `cotal up` at privileged setup. */
+    private ensureStreams;
+    /**
+     * Privileged: pre-create an agent's DM inbox durable (auth mode), so the agent can BIND
+     * it without holding CONSUMER.CREATE on DM_<space>. The creator sets the filter to
+     * inst.<targetId>.* — the agent never gets to choose it, which is what stops a peer from
+     * creating a durable filtered to someone else's inbox. Idempotent (byte-identical config),
+     * safe to call again on manager restart. The caller must be permissive on DM_<space>.
+     */
+    provisionDmInbox(targetId: string): Promise<void>;
+    /**
+     * Privileged: pre-create a role's shared TASK work-queue durable (auth mode), so agents
+     * of that role can BIND it without holding CONSUMER.CREATE on TASK_<space>. The creator
+     * sets the filter to svc.<role>.* — agents never choose it, which stops cross-role drain.
+     * Idempotent per role. The caller must be permissive on TASK_<space>.
+     */
+    provisionTaskQueue(role: string): Promise<void>;
+    /** Lazily obtain a JetStream manager — so a non-consuming endpoint (e.g. the supervisor,
+     *  consume:false) can still pre-create others' durables. */
+    private manager;
+    /** Bind this endpoint's durable consumers: DM inbox, chat, and (if a role) the task queue. */
+    private startConsumers;
+    /** Drive one consumer: decode, drop our own echo, and hand each message to listeners with ack control. */
+    private pump;
+    private publishPresence;
+    private startPresenceWatch;
+    private handleKvEntry;
+    private applyPresence;
+    /** Mark a known peer offline (on KV delete/purge), keeping it in the roster. */
+    private markOffline;
+    private sweep;
+}
+/** Auth subset of connect() options, shared by the endpoint and isReachable. */
+interface AuthOpts {
+    token?: string;
+    user?: string;
+    pass?: string;
+    creds?: string;
+    tls?: boolean;
+}
+/** Whether a NATS server is *running* at `servers`. True on a successful connect AND on an
+ *  auth rejection — an auth error means a server is there, just refusing these creds (so the
+ *  caller should surface the real auth failure, not a misleading "server down", and `up`
+ *  must not try to start a duplicate on the bound port). Only a genuine connection failure
+ *  (refused / timeout / no server) returns false. */
+export declare function isReachable(servers?: string, opts?: AuthOpts & {
+    timeoutMs?: number;
+}): Promise<boolean>;
+export {};
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"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"}