@masons/agent-network 0.5.14 → 0.5.16

package/dist/config-fs.d.ts

@@ -0,0 +1,4 @@
+export declare function getOpenClawHome(): string;
+export declare function readConfig(): Promise<Record<string, unknown>>;
+export declare function persistConfig(config: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=config-fs.d.ts.map

package/dist/config-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-fs.d.ts","sourceRoot":"","sources":["../src/config-fs.ts"],"names":[],"mappings":"AAKA,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOnE;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/config-fs.js

@@ -0,0 +1,23 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export function getOpenClawHome() {
+    return process.env.OPENCLAW_HOME || join(homedir(), ".openclaw");
+}
+function getConfigPath() {
+    return join(getOpenClawHome(), "openclaw.json");
+}
+export async function readConfig() {
+    try {
+        const raw = await readFile(getConfigPath(), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+export async function persistConfig(config) {
+    const configPath = getConfigPath();
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+}

package/dist/config-schema.js

@@ -1,9 +1,9 @@
 import { Type } from "@sinclair/typebox";
 export const AgentNetworkAccountSchema = Type.Object({
     connectorUrl: Type.String({
-        description: "WebSocket URL of the Connector Plugin endpoint",
+        description: "WebSocket URL of the Connector Gateway endpoint",
     }),
     token: Type.String({
-        description: "Authentication token (API key)",
+        description: "Runtime authentication token",
     }),
 });

package/dist/config.d.ts

@@ -1,251 +1,43 @@
-/**
- * Config & runtime bridge — mediates shared state between channel.ts and tools.ts.
- *
- * Read/write separation architecture:
- * - **Reads**: `initToolConfig(ctx.cfg)` injects Host-provided config into
- *   module-level variables. Tools read from these vars via guard functions.
- * - **Writes**: 3 fs functions write to `openclaw.json`, signaling the Host
- *   (Gateway monitors file changes for hot-reload / restart).
- * - **Runtime**: `initConnectorClient(client)` injects the live WebSocket
- *   client after connection is established. Conversation tools read it via
- *   `requireConnectorClient()`.
- *
- * `ctx.cfg` is the Host's authoritative value for this process lifecycle.
- * Plugin does not re-parse the config file for reads.
- *
- */
 import type { ConnectorClient } from "./connector-client.js";
 import type { ConversationManager } from "./conversation-manager.js";
 import { type PlatformClientConfig } from "./platform-client.js";
-/**
- * Current state cache generation. Incremented by config-modifying functions.
- * Used by before_prompt_build to detect when cached state needs a refresh.
- */
+export { getOpenClawHome } from "./config-fs.js";
 export declare function getStateCacheGeneration(): number;
-/**
- * Extract the `channels.agent-network` section from the full OpenClaw config.
- *
- * OpenClaw Gateway passes the ENTIRE config (all of openclaw.json) to
- * channel adapter methods and startAccount(). This helper navigates to
- * the agent-network-specific section.
- *
- */
 export declare function extractNetworkConfig(cfg: Record<string, unknown>): Record<string, unknown> | null;
-/**
- * Inject Host-provided config into module-level variables.
- *
- * Called by `startAccount()` each time Gateway starts or hot-reloads.
- * Ensures tools always read the Host's current config values.
- */
 export declare function initToolConfig(cfg: Record<string, unknown>): void;
-/**
- * Whether `session.identityLinks` contains at least one entry with the
- * `agent-network:` channel prefix — indicating the owner's agent-network
- * identity is linked to another channel.
- */
 export declare function isIdentityLinksConfigured(): boolean;
-/**
- * Current dmScope mode from Gateway config (`cfg.session.dmScope`).
- *
- * Determines how the plugin handles cross-channel identity:
- * - "main" (default): all DMs share one session. Identity linking has no effect.
- * - "per-peer": identity linking merges sessions across channels.
- * - "per-channel-peer" / "per-account-channel-peer": identity linking normalizes
- *   peerId but sessions stay separate per channel.
- */
 export declare function getDmScope(): string;
-/**
- * Inject the live ConnectorClient after WebSocket connection is established.
- *
- * Called by `startAccount()` AFTER `client.connect()` resolves — ensures
- * tools never receive a client with a null WebSocket.
- *
- * Phase 1 supports a single account. The double-init guard makes this
- * assumption explicit: a second call without `clearConnectorClient()` throws.
- */
 export declare function initConnectorClient(client: ConnectorClient): void;
-/**
- * Clear the stored ConnectorClient reference.
- *
- * Called by `stopAccount()` and at `startAccount()` entry (defensive).
- * NOT called by the abort handler — see #935.
- */
 export declare function clearConnectorClient(): void;
-/**
- * Inject the live ConversationManager after WebSocket connection is established.
- *
- * Called by `startAccount()` AFTER `client.connect()` resolves — ensures
- * tools always get a manager backed by a connected client.
- */
 export declare function initConversationManager(manager: ConversationManager): void;
-/**
- * Clear the stored ConversationManager reference.
- *
- * Called by `stopAccount()` and at `startAccount()` entry (defensive).
- * NOT called by the abort handler — in-flight tools need the stale CM
- * to graceful-fail via disconnected WebSocket instead of throwing (#935).
- */
 export declare function clearConversationManager(): void;
-/**
- * Get the live ConversationManager. Throws if not initialized.
- */
 export declare function requireConversationManager(): ConversationManager;
-/**
- * Get the live ConversationManager, or null if not yet initialized.
- *
- * Non-throwing variant for use in before_prompt_build where the connection
- * may not be established yet (e.g., during setup flow). Callers must handle
- * the null case gracefully.
- */
 export declare function getConversationManager(): ConversationManager | null;
-/**
- * Store the OpenClaw PluginRuntime for inbound message dispatch.
- *
- * Called by `register(api)` in plugin.ts — captures `api.runtime` which
- * provides `runtime.channel.*` (routing, reply, session) used by the
- * 4-step inbound dispatch flow in channel.ts.
- *
- * Idempotent: overwrites on re-call. Gateway may hot-reload plugins,
- * calling `register()` again without a teardown counterpart.
- */
 export declare function initPluginRuntime(runtime: unknown): void;
-/**
- * Clear the stored PluginRuntime reference.
- */
 export declare function clearPluginRuntime(): void;
-/**
- * Get the stored PluginRuntime. Throws if not initialized.
- *
- * Callers cast the result to `PluginRuntime` (defined in channel.ts)
- * at the usage site. Typed as `unknown` here to avoid circular imports.
- */
 export declare function requirePluginRuntime(): unknown;
-/**
- * Get platform config. Always returns a valid config — defaults are set
- * at module load time, and overwritten by `initToolConfig()` when
- * `startAccount()` runs.
- *
- * This ensures setup tools work on first install (before credentials
- * exist and before `startAccount()` has run).
- */
 export declare function requirePlatformConfig(): PlatformClientConfig;
-/**
- * Get stored API key. Throws if no credentials are configured.
- */
 export declare function requireApiKey(): string;
-/**
- * Get pending connection target handle, or null if none.
- */
 export declare function getPendingTarget(): string | null;
-/**
- * Whether the agent needs profile completion before connecting.
- *
- * True after onboard (new agent creation), cleared after all required
- * profile fields are filled. Used by connection tools to gate requests
- * until the agent has a visible identity.
- */
 export declare function isProfileNeeded(): boolean;
-/**
- * Get the live ConnectorClient. Throws if not initialized.
- *
- * Note: The returned client may be in a reconnecting state (WebSocket
- * temporarily null after a drop). Callers must handle `false` returns
- * from send methods (`sendMessage`, `createSession`, `endSession`).
- */
 export declare function requireConnectorClient(): ConnectorClient;
-/** Resolve the OpenClaw home directory (`$OPENCLAW_HOME` or `~/.openclaw`). */
-export declare function getOpenClawHome(): string;
 export interface NetworkCredentials {
     connectorUrl: string;
     token: string;
 }
-/**
- * Write credentials + apiHost (+ optional idpBaseUrl) to `openclaw.json`.
- *
- * Atomic: all fields are written in a single persistConfig() call to avoid
- * partial-write race conditions.
- *
- * `idpBaseUrl` is written only when provided, mirroring `apiHost`'s pattern —
- * omitted values leave any existing field in place (useful when callers want
- * to refresh credentials without overriding IdP URL).
- */
+export declare function readExistingConnectorUrl(): Promise<string | undefined>;
 export declare function writeCredentials(creds: NetworkCredentials, apiHost?: string, idpBaseUrl?: string): Promise<void>;
-/**
- * Write pending connection target handle.
- *
- * Used in the invitation flow: when an agent visits another agent's page
- * and installs the plugin, the target handle is persisted here before
- * restart. After restart, Layer B (`detectPendingState`) reads it back
- * and injects continuity context so the agent knows who to connect to.
- */
 export declare function writeTargetHandle(handle: string): Promise<void>;
-/**
- * Clear pending connection target from config file AND module-level variable.
- *
- * This is a deliberate exception to the read/write separation pattern:
- * we also update `storedPendingTarget` in memory to avoid stale reads
- * within the same session (since `initToolConfig()` only runs at startup).
- */
 export declare function clearTargetHandle(): Promise<void>;
-/**
- * Mark that this agent needs profile completion.
- *
- * Called after onboard (new agent creation) — the agent has an empty profile.
- * The before_prompt_build hook reads this to inject profile generation context.
- */
 export declare function markProfileNeeded(): Promise<void>;
-/**
- * Mark that profile completion is done.
- *
- * Called after successful masons_update_profile — clears the needsProfile flag
- * so the before_prompt_build hook no longer injects profile context.
- * Also updates the in-memory `storedNeedsProfile` flag so tool-level gates
- * (connection request / accept) take effect immediately without a restart.
- */
 export declare function markProfileComplete(): Promise<void>;
-/**
- * Write cross-channel identity links to `config.session.identityLinks`.
- *
- * **Entry-level additive merge** (2026-03-26, #986 redesign):
- * New entries are merged INTO the existing canonical group, deduped,
- * lowercase-normalized. Never overwrites other canonical groups, and
- * never removes existing entries within the same group.
- *
- * This allows one-channel-at-a-time linking: first call adds Telegram,
- * second call adds Feishu — without losing the Telegram entry.
- *
- * This writes to `session.*` (Gateway-level), not `channels.agent-network.*`.
- * Justified because cross-channel identity is inherently a Gateway concern,
- * and the Gateway provides the full config to plugins via `ctx.cfg`.
- *
- * Follows the same readConfig → merge → persistConfig pattern as
- * writeCredentials() and writeTargetHandle().
- */
 export declare function writeIdentityLinks(canonical: string, entries: string[]): Promise<void>;
-/**
- * Remove a canonical identity group from `config.session.identityLinks`.
- *
- * Undo path for `writeIdentityLinks()`. Removes only the specified
- * canonical key; other groups are preserved.
- */
 export declare function removeIdentityLinks(canonical: string): Promise<void>;
-/** Pending state detected from config file — used for restart continuity. */
 export interface PendingState {
-    /** Whether valid credentials exist (connectorUrl + token) */
     hasCredentials: boolean;
-    /** Pending connection target handle, or null if none */
     pendingTarget: string | null;
-    /** Whether the agent needs profile completion (new agent, empty profile) */
     needsProfile: boolean;
 }
-/**
- * Detect pending state by reading config file directly.
- *
- * Unlike `initToolConfig()` which is called by `startAccount()`, this reads
- * from disk — available even when the channel hasn't started (no credentials).
- * Used by Layer B (before_prompt_build hook) for per-turn context injection.
- */
 export declare function detectPendingState(): Promise<PendingState>;
-/** @internal Reset module state for test isolation. */
 export declare function _resetForTesting(): void;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAoCjD,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAsBD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMhC;AAYD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAyCjE;AAuCD,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAWD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAeD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAOjE;AAQD,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAYD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAE1E;AASD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAKD,wBAAgB,0BAA0B,IAAI,mBAAmB,CAOhE;AASD,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,IAAI,CAEnE;AAgBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAKD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAQD,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C;AAcD,wBAAgB,qBAAqB,IAAI,oBAAoB,CAE5D;AAKD,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAKD,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AASD,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AASD,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD;AAyBD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW5E;AAYD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAUD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE;AASD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CASvD;AAYD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvD;AAUD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOzD;AAwCD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAQD,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B1E;AAOD,MAAM,WAAW,YAAY;IAE3B,cAAc,EAAE,OAAO,CAAC;IAExB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,YAAY,EAAE,OAAO,CAAC;CACvB;AASD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CA2BhE;AAOD,wBAAgB,gBAAgB,IAAI,IAAI,CAWvC"}