maka-agent 0.2.0-dev.3.20260830 → 0.2.0-dev.4.20260830

package/node_modules/@maka/runtime-host/dist/protocol/peer-mesh.js

@@ -18,6 +18,7 @@
  */
 import { assertExactKeys, requireCount, requireExactRecord, requireRecord, requireString, } from './codec.js';
 import { defineOperation } from './operation-spec.js';
+import { canonicalPeerMeshDisplayName } from '../peer-mesh/display-name.js';
 import { PEER_MESH_MAX_MEMBERS, PEER_MESH_MAX_MESHES, PEER_MESH_MAX_ROUTE_HINTS, } from '../peer-mesh/limits.js';
 const PEER_ID_MAX_BYTES = 256;
 const MESH_ID_MAX_BYTES = 128;
@@ -93,6 +94,20 @@ export const PEER_MESH_OPERATION_SPECS = {
         decodeInput: decodePeerMeshTransitSetInput,
         decodeOutput: decodePeerMeshQueryResult,
     }),
+    'peer.mesh.display-name.set': defineOperation({
+        mode: 'command',
+        availability: 'ready',
+        errors: MUTATION_ERRORS,
+        decodeInput: decodePeerMeshDisplayNameSetInput,
+        decodeOutput: decodePeerMeshQueryResult,
+    }),
+    'peer.mesh.rename': defineOperation({
+        mode: 'command',
+        availability: 'ready',
+        errors: MUTATION_ERRORS,
+        decodeInput: decodePeerMeshRenameInput,
+        decodeOutput: decodePeerMeshQueryResult,
+    }),
 };
 function decodeEmptyInput(value) {
     requireExactRecord(value, 'Peer Mesh operation input', []);
@@ -104,6 +119,19 @@ function decodePeerMeshTargetInput(value) {
         meshId: requireString(record.meshId, 'Peer Mesh meshId', MESH_ID_MAX_BYTES),
     };
 }
+function decodePeerMeshDisplayNameSetInput(value) {
+    const record = requireExactRecord(value, 'Peer Mesh display name input', ['displayName']);
+    return {
+        displayName: record.displayName === null ? null : canonicalPeerMeshDisplayName(record.displayName),
+    };
+}
+function decodePeerMeshRenameInput(value) {
+    const record = requireExactRecord(value, 'Peer Mesh rename input', ['meshId', 'displayName']);
+    return {
+        meshId: requireString(record.meshId, 'Peer Mesh meshId', MESH_ID_MAX_BYTES),
+        displayName: record.displayName === null ? null : canonicalPeerMeshDisplayName(record.displayName),
+    };
+}
 function decodePeerMeshInviteInput(value) {
     return decodePeerMeshTargetInput(value);
 }
@@ -171,7 +199,13 @@ export function decodePeerMeshQueryResult(value) {
     const record = requireRecord(value, 'Peer Mesh query result');
     assertExactKeys(record, 'Peer Mesh query result', record.localPeerId === undefined
         ? ['available', 'meshes']
-        : ['available', 'localPeerId', 'meshes', 'transit']);
+        : [
+            'available',
+            'localPeerId',
+            ...(record.localDisplayName === undefined ? [] : ['localDisplayName']),
+            'meshes',
+            'transit',
+        ]);
     if (typeof record.available !== 'boolean' ||
         !Array.isArray(record.meshes) ||
         record.meshes.length > PEER_MESH_MAX_MESHES) {
@@ -187,14 +221,19 @@ export function decodePeerMeshQueryResult(value) {
             ? {}
             : {
                 localPeerId: requireString(localPeerId, 'Peer Mesh localPeerId', PEER_ID_MAX_BYTES),
+                ...(record.localDisplayName === undefined
+                    ? {}
+                    : { localDisplayName: canonicalPeerMeshDisplayName(record.localDisplayName) }),
                 transit: decodePeerMeshTransitProjection(record.transit),
             }),
         meshes: Object.freeze(record.meshes.map(decodePeerMeshProjection)),
     };
 }
 export function decodePeerMeshProjection(value) {
+    const valueRecord = requireRecord(value, 'Peer Mesh projection');
     const record = requireExactRecord(value, 'Peer Mesh projection', [
         'meshId',
+        ...(valueRecord.displayName === undefined ? [] : ['displayName']),
         'role',
         'authorityPeerId',
         'revision',
@@ -214,6 +253,9 @@ export function decodePeerMeshProjection(value) {
     }
     return {
         meshId: requireString(record.meshId, 'Peer Mesh meshId', MESH_ID_MAX_BYTES),
+        ...(record.displayName === undefined
+            ? {}
+            : { displayName: canonicalPeerMeshDisplayName(record.displayName) }),
         role: record.role,
         authorityPeerId: requireString(record.authorityPeerId, 'Peer Mesh authorityPeerId', PEER_ID_MAX_BYTES),
         revision: requireCount(record.revision, 'Peer Mesh revision'),
@@ -250,7 +292,13 @@ function decodePeerMeshTransitProjection(value) {
 }
 function decodePeerMeshMemberProjection(value) {
     const record = requireRecord(value, 'Peer Mesh member route');
-    assertExactKeys(record, 'Peer Mesh member route', record.expiresAt === undefined ? ['peerId', 'state'] : ['peerId', 'state', 'expiresAt']);
+    assertExactKeys(record, 'Peer Mesh member route', [
+        'peerId',
+        'state',
+        ...(record.endpointKind === undefined ? [] : ['endpointKind']),
+        ...(record.displayName === undefined ? [] : ['displayName']),
+        ...(record.expiresAt === undefined ? [] : ['expiresAt']),
+    ]);
     if (record.state !== 'local' &&
         record.state !== 'route_available' &&
         record.state !== 'coordination_only' &&
@@ -258,8 +306,17 @@ function decodePeerMeshMemberProjection(value) {
         record.state !== 'unknown') {
         throw new Error('Invalid Peer Mesh member route state');
     }
+    if (record.endpointKind !== undefined &&
+        record.endpointKind !== 'client' &&
+        record.endpointKind !== 'host') {
+        throw new Error('Invalid Peer Mesh member endpoint kind');
+    }
     return {
         peerId: requireString(record.peerId, 'Peer Mesh member route peerId', PEER_ID_MAX_BYTES),
+        ...(record.endpointKind === undefined ? {} : { endpointKind: record.endpointKind }),
+        ...(record.displayName === undefined
+            ? {}
+            : { displayName: canonicalPeerMeshDisplayName(record.displayName) }),
         state: record.state,
         ...(record.expiresAt === undefined
             ? {}

package/node_modules/@maka/runtime-host/dist/server/access-authority.js

@@ -78,7 +78,9 @@ class FileRuntimeHostAccessAuthority {
                 credentialId: match.credentialId,
                 operationGrants: match.bindClientInstanceOnFinalize
                     ? ['host.status', 'access.credential.finalize']
-                    : match.operationGrants,
+                    : match.clientInstanceId
+                        ? [...match.operationGrants, 'access.credential.finalize']
+                        : match.operationGrants,
                 canPublishClientCapabilities: !match.bindClientInstanceOnFinalize && match.canPublishClientCapabilities,
                 canUseHostPaths: !match.bindClientInstanceOnFinalize && match.canUseHostPaths,
                 ...(match.clientInstanceId ? { clientInstanceId: match.clientInstanceId } : {}),
@@ -476,21 +478,23 @@ class FileRuntimeHostAccessAuthority {
         await this.#commit(createNextAccessCredentialFile(this.#file, credentials, this.#file.sessionGrants), [current, ...pendingForPrincipal].map((credential) => credential.credentialId));
         return { credentialId, revoked: true };
     }
-    finalize(credentialId, clientInstanceId) {
+    finalize(credentialId, clientInstanceId, connectionAlreadyFinalized) {
         return this.#mutate(async () => {
             const retained = this.#file.credentials.find((credential) => credential.credentialId === credentialId);
             if (!retained || retained.status === 'revoked') {
                 throw new RuntimeHostAccessInputError('The current access credential is no longer active');
             }
-            return this.#finalize(retained, clientInstanceId);
+            return this.#finalize(retained, clientInstanceId, connectionAlreadyFinalized);
         });
     }
-    async #finalize(retained, clientInstanceId) {
+    async #finalize(retained, clientInstanceId, connectionAlreadyFinalized) {
         if (retained.status === 'active') {
             if (retained.clientInstanceId && retained.clientInstanceId !== clientInstanceId) {
                 throw new RuntimeHostAccessInputError('The pairing candidate was claimed by another Client');
             }
-            return { reconnectRequired: retained.clientInstanceId !== undefined };
+            return {
+                reconnectRequired: retained.clientInstanceId !== undefined && !connectionAlreadyFinalized,
+            };
         }
         if (Date.parse(retained.expiresAt) <= Date.now()) {
             await this.#expirePending();
@@ -776,7 +780,7 @@ export async function revokeAccessCredentialRotation(authority, input) {
         return accessPersistenceFailure(error, 'Access credential rotation revocation outcome is unknown', 'Access credential could not be revoked');
     }
 }
-export async function finalizeAccessCredential(authority, credentialId, clientInstanceId) {
+export async function finalizeAccessCredential(authority, credentialId, clientInstanceId, credentialClientInstanceId) {
     if (!authority)
         return unavailable('finalize');
     if (!credentialId) {
@@ -800,7 +804,7 @@ export async function finalizeAccessCredential(authority, credentialId, clientIn
     try {
         return {
             ok: true,
-            result: await authority.finalize(credentialId, clientInstanceId),
+            result: await authority.finalize(credentialId, clientInstanceId, credentialClientInstanceId === clientInstanceId),
         };
     }
     catch (error) {

package/node_modules/@maka/runtime-host/dist/server/connection-session.js

@@ -164,6 +164,9 @@ export class RuntimeHostConnectionSession {
                 ...(this.#options.connection.authority.credentialId
                     ? { credentialId: this.#options.connection.authority.credentialId }
                     : {}),
+                ...(this.#options.connection.authority.clientInstanceId
+                    ? { credentialClientInstanceId: this.#options.connection.authority.clientInstanceId }
+                    : {}),
                 acquireResidency: () => admission.acquireResidency(),
             });
             admission.seal();

package/node_modules/@maka/runtime-host/dist/server/execution-service.js

@@ -54,6 +54,7 @@ export async function startExecutionRuntimeHostService(options, dependencies = {
                 peerOwner = await openRuntimeHostPeerMeshOwner({
                     ...options.peer,
                     dataRoot: options.peer.meshDataRoot,
+                    endpointKind: 'host',
                 });
             }
             catch (error) {

package/node_modules/@maka/runtime-host/dist/server/host-kernel.js

@@ -524,7 +524,7 @@ export class RuntimeHostKernel {
             'access.principal.revoke': async (input) => this.#settleAccessCredentialMutation(revokeAccessPrincipal(this.#options.accessAuthority, input)),
             'access.credential.rotation.prepare': async (input) => this.#settleAccessCredentialMutation(prepareAccessCredentialRotation(this.#options.accessAuthority, input)),
             'access.credential.rotation.revoke': async (input) => this.#settleAccessCredentialMutation(revokeAccessCredentialRotation(this.#options.accessAuthority, input)),
-            'access.credential.finalize': async (_input, context) => this.#settleAccessCredentialMutation(finalizeAccessCredential(this.#options.accessAuthority, context.credentialId, context.clientInstanceId)),
+            'access.credential.finalize': async (_input, context) => this.#settleAccessCredentialMutation(finalizeAccessCredential(this.#options.accessAuthority, context.credentialId, context.clientInstanceId, context.credentialClientInstanceId)),
             'collaboration.invitation.prepare': async (input) => this.#settleAccessCredentialMutation(prepareCollaborationInvitation(this.#options.accessAuthority, this.rootId, input)),
             'collaboration.access.query': async (input) => this.#options.accessAuthority
                 ? {

package/node_modules/@maka/runtime-host/dist/server/peer-mesh-authority.js

@@ -128,11 +128,28 @@ export function createPeerMeshOperationHandlers(mesh, options = {}) {
                 return { ok: true, result: query() };
             });
         },
+        'peer.mesh.display-name.set': async (input) => {
+            if (!mesh)
+                return unavailable();
+            return mutate(async () => {
+                await mesh.setDisplayName(input.displayName);
+                return { ok: true, result: query() };
+            });
+        },
+        'peer.mesh.rename': async (input) => {
+            if (!mesh)
+                return unavailable();
+            return mutate(async () => {
+                await mesh.setMeshDisplayName(input.meshId, input.displayName);
+                return { ok: true, result: query() };
+            });
+        },
     };
 }
 export function projectPeerMeshStatus(status) {
     return Object.freeze({
         meshId: status.roster.roster.meshId,
+        ...(status.roster.roster.displayName ? { displayName: status.roster.roster.displayName } : {}),
         role: status.role,
         authorityPeerId: status.authority.peerId,
         revision: status.roster.roster.revision,
@@ -144,9 +161,11 @@ export function projectPeerMeshStatus(status) {
 export function projectPeerMeshQuery(mesh) {
     if (!mesh)
         return { available: false, meshes: [] };
+    const displayName = mesh.displayName();
     return Object.freeze({
         available: true,
         localPeerId: mesh.localPeerId(),
+        ...(displayName ? { localDisplayName: displayName } : {}),
         meshes: Object.freeze(mesh.status().map(projectPeerMeshStatus)),
         transit: projectTransitSnapshot(mesh.transitMeshId(), mesh.transitSnapshot()),
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maka-agent",
-  "version": "0.2.0-dev.3.20260830",
+  "version": "0.2.0-dev.4.20260830",
   "description": "Apache Maka (Incubating) developer snapshot; not an Apache release.",
   "license": "Apache-2.0",
   "type": "module",