@masons/agent-network 0.6.27 → 0.7.0

package/dist/platform-client.js

@@ -136,18 +136,65 @@ function resolveVerb(verb) {
 export const acceptRequest = resolveVerb("accept");
 export const ignoreRequest = resolveVerb("ignore");
 export const withdrawRequest = resolveVerb("withdraw");
-export async function updateProfile(cfg, runtimeKey, params) {
-    const res = await apiFetch(`${baseUrl(cfg)}/me/profile`, {
+const ICM_CARD_PATH = "/runtime/icm-profile";
+export async function getIcmCard(cfg, runtimeKey) {
+    const res = await apiFetch(`${baseUrl(cfg)}${ICM_CARD_PATH}`, {
+        headers: { Authorization: `Bearer ${runtimeKey}` },
+    });
+    if (!res.ok)
+        return handleError(res);
+    return parseVersionedCard(res, await res.json().catch(() => null));
+}
+export async function updateIcmCard(cfg, runtimeKey, draft) {
+    const body = {
+        profileRevision: draft.profileRevision,
+        displayName: draft.displayName,
+        update: draft.update,
+    };
+    if (draft.removeAvatar)
+        body.avatarUrl = null;
+    const res = await apiFetch(`${baseUrl(cfg)}${ICM_CARD_PATH}`, {
         method: "PATCH",
         headers: {
             "Content-Type": "application/json",
             Authorization: `Bearer ${runtimeKey}`,
         },
-        body: JSON.stringify(params),
+        body: JSON.stringify(body),
     });
+    if (res.status === 409) {
+        const conflict = (await res.json().catch(() => null));
+        if (conflict?.error === "profile_revision_conflict") {
+            return {
+                outcome: "revision_conflict",
+                current: parseVersionedCard(res, conflict),
+            };
+        }
+        throw new PlatformApiError(res.status, typeof conflict?.error === "string" ? conflict.error : "unknown", res.statusText);
+    }
     if (!res.ok)
         return handleError(res);
-    return (await res.json());
+    return {
+        outcome: "updated",
+        current: parseVersionedCard(res, await res.json().catch(() => null)),
+    };
+}
+function parseVersionedCard(res, body) {
+    const parsed = body;
+    if (!parsed ||
+        typeof parsed.profileRevision !== "string" ||
+        parsed.profileRevision.length === 0 ||
+        !isIcmCard(parsed.profile)) {
+        throw new PlatformApiError(res.status, "malformed_response", "icm-profile response carried no card and revision");
+    }
+    return { card: parsed.profile, profileRevision: parsed.profileRevision };
+}
+function isIcmCard(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const card = value;
+    return (typeof card.canonicalAddress === "string" &&
+        card.canonicalAddress.length > 0 &&
+        typeof card.displayName === "string");
 }
 export async function listConnections(cfg, runtimeKey) {
     const res = await apiFetch(`${baseUrl(cfg)}/me/connections`, {

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAUrE,OAAO,EACL,kCAAkC,EAEnC,MAAM,oCAAoC,CAAC;AA8D5C,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,mBAAmB,GAAE,mBAAmB,GAAG,IAA+B,GACzE,MAAM,GAAG,SAAS,CA6EpB;AAKD,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CACV,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;IACR,yBAAyB,CAAC,MAAM,EAAE;QAChC,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,kCAAkC,CAAC;KACrD,GAAG,IAAI,CAAC;IACT,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAqCD,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaI,iBAAiB;CAsahC,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAUrE,OAAO,EACL,kCAAkC,EAEnC,MAAM,oCAAoC,CAAC;AA8D5C,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,mBAAmB,GAAE,mBAAmB,GAAG,IAA+B,GACzE,MAAM,GAAG,SAAS,CA6EpB;AAKD,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CACV,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;IACR,yBAAyB,CAAC,MAAM,EAAE;QAChC,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,kCAAkC,CAAC;KACrD,GAAG,IAAI,CAAC;IACT,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAqCD,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaI,iBAAiB;CAsZhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -206,24 +206,10 @@ const plugin = {
                     dynamicContext += ` After the Link completes, send a connection request to ${state.pendingTarget} — they invited your user to join.`;
                 }
             }
-            else if (state.needsProfile) {
-                dynamicContext =
-                    "[Context: Agent Network] You are linked to the agent network, but your agent's profile is empty. " +
-                        "Generate a profile based on what you know about the user and their agent, then show it to the user for confirmation. " +
-                        "Once confirmed, call masons_update_profile with all four fields (name, scope, about, audience). " +
-                        "Without a profile, other agents can't see who you are — " +
-                        "connection requests from agents without a profile are rarely accepted.";
-                if (state.pendingTarget) {
-                    dynamicContext += ` After completing the profile, send a connection request to ${state.pendingTarget} — they'll be able to see who you are and why connecting makes sense.`;
-                }
-            }
             else if (state.pendingTarget) {
                 dynamicContext = `[Context: Agent Network] You are linked to the agent network. You have a pending connection — call the masons_send_connection_request tool with targetHandle "${state.pendingTarget}" to send a connection request.`;
             }
-            if (!dynamicContext &&
-                state.hasCredentials &&
-                !state.needsProfile &&
-                !state.pendingTarget) {
+            if (!dynamicContext && state.hasCredentials && !state.pendingTarget) {
                 if (messageProvider === "agent-network") {
                     if (turnIsOwner) {
                         dynamicContext =
@@ -290,7 +276,7 @@ const plugin = {
                     }
                 }
             }
-            if (state.hasCredentials && !state.needsProfile && !state.pendingTarget) {
+            if (state.hasCredentials && !state.pendingTarget) {
                 const dmScope = getDmScope();
                 if (dmScope !== "main") {
                     const linkingKnowledge = "[Cross-Channel Identity] When your owner visits your Passport page, " +

package/dist/tools.d.ts

@@ -27,6 +27,7 @@ interface ToolApi {
 }
 export declare function _resetToolsForTesting(): void;
 export declare function ownerRefusalText(reason: "known-non-owner" | "ambiguous"): string;
+export declare function cardWriteRefusalText(reason: "known-non-owner" | "ambiguous"): string;
 export declare function formatChannelSetupResult(result: ChannelSetupResult): string;
 export declare function registerTools(api: ToolApi): void;
 export {};

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,oBAAoB,CAAC;AA2D5B,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,UAAU,WAAW;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3E,UAAU,OAAO;IACf,YAAY,CACV,IAAI,EAAE,cAAc,GAAG,WAAW,EAWlC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7D,IAAI,CAAC;CACT;AAqED,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAkYD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,GAAG,WAAW,GACtC,MAAM,CAqBR;AAGD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAyC3E;AA+CD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAqoChD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,oBAAoB,CAAC;AA2D5B,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,UAAU,WAAW;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3E,UAAU,OAAO;IACf,YAAY,CACV,IAAI,EAAE,cAAc,GAAG,WAAW,EAWlC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7D,IAAI,CAAC;CACT;AAwED,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AA0YD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,GAAG,WAAW,GACtC,MAAM,CAqBR;AAsCD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,GAAG,WAAW,GACtC,MAAM,CAsBR;AAkID,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAyC3E;AA+CD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAioChD"}

package/dist/tools.js

@@ -2,15 +2,14 @@ import { Type } from "@sinclair/typebox";
 import pluginManifest from "../openclaw.plugin.json" with { type: "json" };
 import { getOwnerPassportAddress } from "./channel.js";
 import { _resetChannelSetupForTesting, getDefaultChannelSetupOptions, startOrGetChannelSetup, } from "./channel-setup.js";
-import { clearTargetHandle, extractNetworkConfig, getConnectorClient, getDmScope, getPendingTarget, hasApiKey, isProfileNeeded, markProfileComplete, removeIdentityLinks, requireApiKey, requireConversationManager, requirePlatformConfig, writeIdentityLinks, } from "./config.js";
+import { clearTargetHandle, extractNetworkConfig, getConnectorClient, getDmScope, getPendingTarget, hasApiKey, removeIdentityLinks, requireApiKey, requireConversationManager, requirePlatformConfig, writeIdentityLinks, } from "./config.js";
 import { getOwnerHandle } from "./environment-context.js";
 import { classifyIdentityError, formatCanonicalNode, formatKindLabel, } from "./identity-format.js";
 import { ownerNotesQueue } from "./owner-notes.js";
-import { acceptRequest, getIdentity, ignoreRequest, isPackagedTombstone, listConnections, listRequests, PlatformApiError, PlatformNetworkError, requestConnection, updateProfile, withdrawRequest, } from "./platform-client.js";
+import { acceptRequest, getIcmCard, getIdentity, ignoreRequest, isPackagedTombstone, listConnections, listRequests, PlatformApiError, PlatformNetworkError, requestConnection, updateIcmCard, withdrawRequest, } from "./platform-client.js";
 import { isServicesRetainedReplyContext } from "./services-retained-reply-context.js";
 import { getCurrentTurnChannelId, getCurrentTurnIsOwnerNonConsuming, getCurrentTurnOwnerSignal, } from "./turn-context.js";
 import { getLatestPublishedVersion, getPluginVersion, getUpdateInfo, NPM_PACKAGE_NAME, } from "./update-check.js";
-const PROFILE_FIELDS = new Set(["name", "scope", "about", "audience"]);
 const GATEWAY_RESTART_CMD = "openclaw gateway restart";
 const PACKAGED_TOOL_ROSTER = pluginManifest.contracts.tools;
 const ROSTER_HEADER = "This version ships these tools:";
@@ -245,6 +244,121 @@ export function ownerRefusalText(reason) {
         "  openclaw channels login --channel agent-network",
     ].join("\n");
 }
+function formatIcmCard(versioned) {
+    const { card, profileRevision } = versioned;
+    const handlePart = card.handle ? `@${card.handle} — ` : "";
+    return [
+        `Card: ${formatKindLabel(card.kind)}${handlePart}${card.canonicalAddress}`,
+        `Display name: ${card.displayName}`,
+        `Status line (update): ${card.update ?? "(none)"}`,
+        `Avatar: ${card.avatarUrl ? "present" : "none"}`,
+        `Revision (needed to update): ${profileRevision}`,
+    ].join("\n");
+}
+export function cardWriteRefusalText(reason) {
+    if (reason === "known-non-owner") {
+        return [
+            "Editing the card is owner-only. You are reaching this agent through",
+            "the MASONS network as a visitor or as a peer agent. The card is the",
+            "owner's own portrayal of this Node, so only they may change it.",
+            "",
+            "You can still read it with masons_view_card — the card scope is what",
+            "counterparties see anyway.",
+        ].join("\n");
+    }
+    return [
+        "Editing the card is owner-only, and this turn carried no owner signal,",
+        "so I cannot verify that you are this agent's owner. An unverified turn",
+        "is refused rather than assumed to be the owner.",
+        "",
+        "Ask from a channel the owner operates directly (e.g. Telegram or the",
+        "terminal) — card editing is available there.",
+        "",
+        "Reading the card is unaffected: call masons_view_card.",
+    ].join("\n");
+}
+function formatCardConflict(current) {
+    return [
+        "Not updated — the card changed since you read it, so the confirmed draft",
+        "was based on a card that no longer exists. Nothing was written.",
+        "",
+        "This is the card as it stands now:",
+        "",
+        formatIcmCard(current),
+        "",
+        "Do NOT retry the rejected draft, and do not merge it with the above.",
+        "Rebuild the COMPLETE card on this current state, show it to the owner,",
+        "get a fresh confirmation, then call masons_update_card again with the",
+        "revision printed above.",
+    ].join("\n");
+}
+function cardWriteOutcomeUnknownText(detail) {
+    return [
+        "The network request's outcome is unknown — it may or may not have",
+        "landed. Do not resubmit blindly: read the card with masons_view_card",
+        "first; if the change is already there, you are done; if not, rebuild",
+        "and reconfirm with the owner.",
+        "",
+        detail,
+    ].join("\n");
+}
+function icmCardErrorText(err, surface) {
+    if (err instanceof PlatformNetworkError) {
+        if (surface === "read")
+            return networkErrorText(err);
+        return cardWriteOutcomeUnknownText(`Transport detail: ${err.detail}.`);
+    }
+    if (!(err instanceof PlatformApiError))
+        return null;
+    if (err.status === 401) {
+        return "Authentication failed. The runtime key may be invalid. Ask the owner to re-link here: call masons_link.";
+    }
+    if (err.code === "profile_access_not_authorized") {
+        return [
+            "This Runtime's credential is not authorized to reach this card. The",
+            "Runtime Authorization Grant behind the key is not active for it — it",
+            "may have been revoked, disabled, or expired. Nothing was read or",
+            "changed.",
+        ].join("\n");
+    }
+    if (err.code === "profile_not_enrolled") {
+        return [
+            "This Node has no ICM card. It is reachable and conversable on the",
+            "network, but it is not enrolled in In-Context Messaging, so there is",
+            "no card to read or edit.",
+            "",
+            "Enrollment is what creates the card, and it happens on the owner's",
+            "authenticated management surface for this deployment — a Runtime",
+            "cannot create one.",
+        ].join("\n");
+    }
+    if (err.status === 404) {
+        if (err.code === "node_not_found") {
+            return [
+                "This Runtime's principal holds no active Node, so there is no card.",
+                "Ask the owner to link a Node here: call masons_link.",
+            ].join("\n");
+        }
+        return [
+            "This deployment does not serve the canonical card endpoint, so the",
+            "card is unavailable here — this says nothing about whether the Node",
+            "has one. A self-hosted or older MASONS API may predate it.",
+        ].join("\n");
+    }
+    if (err.status === 422) {
+        return [
+            "The network rejected the card as invalid; nothing was changed. The",
+            "display name must be 1–40 characters after trimming, and the status",
+            "line at most 80 characters on a single line. Fix the draft, show the",
+            "owner the corrected card, and call again with the same revision.",
+        ].join("\n");
+    }
+    const unmapped = `HTTP ${err.status}${err.code === "unknown" ? "" : `, ${err.code}`}`;
+    if (surface === "write") {
+        return cardWriteOutcomeUnknownText(`Provider detail: ${unmapped}.`);
+    }
+    return `The network could not answer for the card (${unmapped}). Nothing was changed.`;
+}
 export function formatChannelSetupResult(result) {
     if (result.status === "pending" && result.handoffUrl) {
         return [
@@ -375,103 +489,114 @@ export function registerTools(api) {
         },
     }), { name: "masons_link" });
     api.registerTool({
-        name: "masons_update_profile",
+        name: "masons_view_card",
+        description: [
+            "Read this Runtime's canonical card on the MASONS network — the portrayal other Nodes see: display name, status line, and avatar.",
+            "Use when the owner asks what their card says, before proposing any change to it, and whenever masons_update_card needs a current revision.",
+            "The result reports a revision token. masons_update_card requires the revision from a read like this one — read first, then update.",
+        ].join("\n"),
+        parameters: Type.Object({}),
+        execute: withUpdateNotice(async () => {
+            const cfg = requirePlatformConfig();
+            const apiKey = requireApiKey();
+            try {
+                return textResult(formatIcmCard(await getIcmCard(cfg, apiKey)));
+            }
+            catch (err) {
+                const text = icmCardErrorText(err, "read");
+                if (text === null)
+                    throw err;
+                return textResult(text);
+            }
+        }),
+    });
+    api.registerTool({
+        name: "masons_update_card",
         description: [
-            "Update this agent's profile on the network. Use this after creating a new agent to establish its identity.",
-            "Generate all four fields based on what you know about the user and their agent, using the guidance below:",
+            "Update this Runtime's canonical card on the MASONS network — display name, status line, and removal of the avatar. The write is owner-only on the MASONS network channel, where a visitor or an unverified turn is refused; on the channels your host operates, the host's own owner rules apply.",
+            "This is the only portrayal this Runtime writes: the card IS the profile other Nodes see. Route any request to change the display name, the status line, or the description of what this Node is here for through this tool.",
             "",
-            "• name (max 40 chars): A recognizable name. Examples: TravelPlanner, MarketAnalyzer, ContentStudio",
-            "• scope (max 800 chars): What does the Agent do? What capabilities or services does it provide? What problems does it solve? Be specific about boundaries.",
-            "• about (max 1000 chars): Anything else relevant to partnerships? Brand affiliation, service restrictions, languages, user channels, input modes, access requirements.",
-            "• audience (max 300 chars): Who are the typical users? What do they want to accomplish?",
+            "How to use it:",
+            "1. Read the card first with masons_view_card.",
+            "2. Compose the COMPLETE card. This tool always sends the display name and status line — pass their complete confirmed values (changed and unchanged). The avatar is untouched unless you pass remove_avatar: true.",
+            "3. Show that complete card to the owner and get their confirmation in this conversation BEFORE calling.",
+            "4. Pass the profile_revision from the read in step 1.",
             "",
-            "Show the generated profile to the user for confirmation before calling this tool. If the user requests changes, apply them and call again.",
+            "Setting a new avatar image is not available to any Runtime — the image is supplied on an owner-authenticated surface that can show the owner the picture they are confirming. This tool can only remove the current one, with remove_avatar: true.",
+            "If the card changed since your read, the call returns a conflict together with the current card. Rebuild the complete draft on THAT card, show the owner again, get fresh confirmation, and call again with the new revision. Never retry a rejected draft on your own.",
         ].join("\n"),
         parameters: Type.Object({
-            name: Type.Optional(Type.String({
-                description: "Agent display name (max 40 characters)",
-            })),
-            scope: Type.Optional(Type.String({
-                description: "Agent's functional scope: what the agent does, its capabilities, services, and boundaries. This is a free-text description, NOT an OAuth or permission scope. (max 800 characters)",
-            })),
-            about: Type.Optional(Type.String({
-                description: "Additional context: brand affiliation, restrictions, languages, channels (max 1000 characters)",
-            })),
-            audience: Type.Optional(Type.String({
-                description: "Target users and what they want to accomplish (max 300 characters)",
+            display_name: Type.String({
+                description: "The complete proposed display name, 1-40 characters. Required on every call: carry the current one forward unchanged when the owner is not changing it.",
+            }),
+            update: Type.Union([Type.String(), Type.Null()], {
+                description: "The complete proposed status line — one line, at most 80 characters: what this Node is doing, seeking, or offering now. Required on every call: carry the current one forward unchanged when the owner is not changing it. Pass null or an empty string to clear it.",
+            }),
+            profile_revision: Type.String({
+                description: "The revision token reported by the masons_view_card read this draft was built on. The network rejects a draft built on a card that has since changed.",
+            }),
+            remove_avatar: Type.Optional(Type.Boolean({
+                description: "Pass true to remove the current avatar. Omit it to keep the current avatar. A new image cannot be set by any Runtime — the owner supplies one on an owner-authenticated surface.",
             })),
         }),
         execute: withUpdateNotice(async (_id, params) => {
-            const unknownFields = Object.keys(params).filter((k) => !PROFILE_FIELDS.has(k));
-            if (unknownFields.length > 0) {
-                return textResult(`Unknown field(s): ${unknownFields.join(", ")}. ` +
-                    `The allowed profile fields are: name, scope, about, audience. ` +
-                    `Please retry with the correct field names.`);
+            const authority = resolveSetupAuthority();
+            if (!authority.allowed) {
+                return textResult(cardWriteRefusalText(authority.reason ?? "ambiguous"));
             }
-            const cfg = requirePlatformConfig();
-            const apiKey = requireApiKey();
-            const profileFields = {};
-            if (typeof params.name === "string")
-                profileFields.name = params.name;
-            if (typeof params.scope === "string")
-                profileFields.scope = params.scope;
-            if (typeof params.about === "string")
-                profileFields.about = params.about;
-            if (typeof params.audience === "string")
-                profileFields.audience = params.audience;
-            if (Object.keys(profileFields).length === 0) {
-                return textResult("No profile fields provided. Include at least one of: name, scope, about, audience.");
+            const profileRevision = typeof params.profile_revision === "string"
+                ? params.profile_revision.trim()
+                : "";
+            if (profileRevision.length === 0) {
+                return textResult([
+                    "No profile_revision was provided, so nothing was sent. A card",
+                    "write must be based on a card that was actually read: call",
+                    "masons_view_card, build the complete draft on what it reports,",
+                    "confirm it with the owner, then call again with the revision from",
+                    "that read.",
+                ].join("\n"));
             }
-            let result;
-            try {
-                result = await updateProfile(cfg, apiKey, profileFields);
+            const displayName = typeof params.display_name === "string"
+                ? params.display_name.trim()
+                : "";
+            if (displayName.length === 0) {
+                return textResult([
+                    "No display_name was provided, so nothing was sent. This tool",
+                    "submits the COMPLETE card, not the fields that changed — carry",
+                    "the current display name forward when the owner is not changing",
+                    "it. Read it with masons_view_card if you do not have it.",
+                ].join("\n"));
             }
-            catch (err) {
-                if (err instanceof PlatformApiError) {
-                    if (err.status === 401) {
-                        return textResult("Authentication failed. The runtime key may be invalid. Ask the owner to re-link here: call masons_link.");
-                    }
-                    if (err.status === 422) {
-                        return textResult(`Validation error: ${err.message}`);
-                    }
-                }
-                if (err instanceof PlatformNetworkError) {
-                    return textResult(networkErrorText(err));
-                }
-                throw err;
+            const rawUpdate = params.update;
+            if (rawUpdate !== null && typeof rawUpdate !== "string") {
+                return textResult([
+                    "No update was provided, so nothing was sent. This tool submits",
+                    "the status line on every call, not only when it changes — pass",
+                    "the current value, a new value, or null to clear it. Read the",
+                    "current one with masons_view_card if you do not have it.",
+                ].join("\n"));
             }
-            if (result.profile) {
-                const { scope, about, audience } = result.profile;
-                const profileComplete = scope.length > 0 && about.length > 0 && audience.length > 0;
-                if (profileComplete) {
-                    await markProfileComplete();
-                }
-                const lines = [
-                    "Profile updated successfully. Current profile:",
-                    `• name: ${result.profile.name}`,
-                    `• scope: ${scope || "(empty)"}`,
-                    `• about: ${about || "(empty)"}`,
-                    `• audience: ${audience || "(empty)"}`,
-                ];
-                if (profileComplete) {
-                    lines.push("", "Profile complete — all fields filled. Proceed to the next phase.");
-                }
-                else {
-                    const missing = [];
-                    if (scope.length === 0)
-                        missing.push("scope");
-                    if (about.length === 0)
-                        missing.push("about");
-                    if (audience.length === 0)
-                        missing.push("audience");
-                    lines.push("", `Profile incomplete — still need: ${missing.join(", ")}. Continue with the next profile step.`);
+            const update = rawUpdate?.trim() ? rawUpdate.trim() : null;
+            const cfg = requirePlatformConfig();
+            const apiKey = requireApiKey();
+            try {
+                const result = await updateIcmCard(cfg, apiKey, {
+                    profileRevision,
+                    displayName,
+                    update,
+                    ...(params.remove_avatar === true ? { removeAvatar: true } : {}),
+                });
+                if (result.outcome === "revision_conflict") {
+                    return textResult(formatCardConflict(result.current));
                 }
-                return textResult(lines.join("\n"));
+                return textResult(`Card updated. This is what the network now serves:\n\n${formatIcmCard(result.current)}`);
             }
-            if (profileFields.scope && profileFields.scope.length > 0) {
-                await markProfileComplete();
+            catch (err) {
+                const text = icmCardErrorText(err, "write");
+                if (text === null)
+                    throw err;
+                return textResult(text);
             }
-            return textResult("Profile updated successfully. The agent's identity is now visible on the network.");
         }),
     });
     api.registerTool({
@@ -485,12 +610,6 @@ export function registerTools(api) {
         execute: withUpdateNotice(async (_id, params) => {
             const cfg = requirePlatformConfig();
             const apiKey = requireApiKey();
-            if (isProfileNeeded()) {
-                return textResult("Your agent's profile is not complete yet. Without a profile, " +
-                    "the other agent can't see who you are — connection requests from " +
-                    "unknown agents are much less likely to be accepted. " +
-                    "Use masons_update_profile to complete your profile first (scope, about, audience).");
-            }
             const targetHandle = params.targetHandle;
             let result;
             try {
@@ -662,11 +781,6 @@ export function registerTools(api) {
         execute: withUpdateNotice(async (_id, params) => {
             const cfg = requirePlatformConfig();
             const apiKey = requireApiKey();
-            if (isProfileNeeded()) {
-                return textResult("Your agent's profile is not complete yet. Without a profile, " +
-                    "the other agent won't know who you are when the connection is established. " +
-                    "Use masons_update_profile to complete your profile first (scope, about, audience).");
-            }
             const requestId = params.requestId;
             try {
                 const result = await acceptRequest(cfg, apiKey, requestId);

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PLUGIN_VERSION = "0.6.27";
+export declare const PLUGIN_VERSION = "0.7.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,UAAU,CAAC"}

package/dist/version.js

@@ -1 +1 @@
-export const PLUGIN_VERSION = "0.6.27";
+export const PLUGIN_VERSION = "0.7.0";

package/openclaw.plugin.json

@@ -6,7 +6,8 @@
     "trustedToolPolicies": ["agent-network-services-retained-turn-v1"],
     "tools": [
       "masons_link",
-      "masons_update_profile",
+      "masons_view_card",
+      "masons_update_card",
       "masons_send_connection_request",
       "masons_list_requests",
       "masons_accept_request",
@@ -111,7 +112,7 @@
           },
           "needsProfile": {
             "type": "boolean",
-            "description": "Whether profile completion is required before connection tools run."
+            "description": "Retired. The plugin no longer reads or writes this flag; it stays declared so a config written by an earlier version still validates under additionalProperties: false."
           }
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.6.27",
+  "version": "0.7.0",
   "description": "MASONS Agent Network — OpenClaw channel plugin for connecting agent runtimes to the Agent Network over MSTP.",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",