multiclaws 0.3.0

package/dist/service/agent-registry.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRegistry = void 0;
+const json_store_1 = require("../infra/json-store");
+function emptyStore() {
+    return { version: 1, agents: [] };
+}
+function normalizeStore(raw) {
+    if (raw.version !== 1 || !Array.isArray(raw.agents)) {
+        return emptyStore();
+    }
+    return {
+        version: 1,
+        agents: raw.agents.filter((a) => a &&
+            typeof a.url === "string" &&
+            typeof a.name === "string" &&
+            typeof a.addedAtMs === "number"),
+    };
+}
+class AgentRegistry {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async readStore() {
+        const store = await (0, json_store_1.readJsonWithFallback)(this.filePath, emptyStore());
+        return normalizeStore(store);
+    }
+    async add(params) {
+        return await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
+            const store = await this.readStore();
+            const normalizedUrl = params.url.replace(/\/+$/, "");
+            const existing = store.agents.findIndex((a) => a.url === normalizedUrl);
+            const now = Date.now();
+            const record = {
+                url: normalizedUrl,
+                name: params.name,
+                description: params.description ?? "",
+                skills: params.skills ?? [],
+                apiKey: params.apiKey,
+                addedAtMs: existing >= 0 ? store.agents[existing].addedAtMs : now,
+                lastSeenAtMs: now,
+            };
+            if (existing >= 0) {
+                store.agents[existing] = record;
+            }
+            else {
+                store.agents.push(record);
+            }
+            await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
+            return record;
+        });
+    }
+    async remove(url) {
+        return await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
+            const store = await this.readStore();
+            const normalizedUrl = url.replace(/\/+$/, "");
+            const before = store.agents.length;
+            store.agents = store.agents.filter((a) => a.url !== normalizedUrl);
+            if (store.agents.length === before) {
+                return false;
+            }
+            await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
+            return true;
+        });
+    }
+    async list() {
+        const store = await this.readStore();
+        return [...store.agents].sort((a, b) => b.lastSeenAtMs - a.lastSeenAtMs);
+    }
+    async get(url) {
+        const store = await this.readStore();
+        const normalizedUrl = url.replace(/\/+$/, "");
+        return store.agents.find((a) => a.url === normalizedUrl) ?? null;
+    }
+    async updateDescription(url, description) {
+        await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
+            const store = await this.readStore();
+            const normalizedUrl = url.replace(/\/+$/, "");
+            const agent = store.agents.find((a) => a.url === normalizedUrl);
+            if (agent) {
+                agent.description = description;
+                agent.lastSeenAtMs = Date.now();
+                await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
+            }
+        });
+    }
+    async updateLastSeen(url) {
+        await (0, json_store_1.withJsonLock)(this.filePath, emptyStore(), async () => {
+            const store = await this.readStore();
+            const normalizedUrl = url.replace(/\/+$/, "");
+            const agent = store.agents.find((a) => a.url === normalizedUrl);
+            if (agent) {
+                agent.lastSeenAtMs = Date.now();
+                await (0, json_store_1.writeJsonAtomically)(this.filePath, store);
+            }
+        });
+    }
+}
+exports.AgentRegistry = AgentRegistry;

package/dist/service/multiclaws-service.d.ts

@@ -0,0 +1,88 @@
+import { EventEmitter } from "node:events";
+import { type AgentRecord } from "./agent-registry";
+import { type AgentProfile } from "./agent-profile";
+import { type TeamRecord, type TeamMember } from "../team/team-store";
+import type { GatewayConfig } from "../infra/gateway-client";
+export type MulticlawsServiceOptions = {
+    stateDir: string;
+    port?: number;
+    displayName?: string;
+    selfUrl?: string;
+    gatewayConfig?: GatewayConfig;
+    logger?: {
+        info: (message: string) => void;
+        warn: (message: string) => void;
+        error: (message: string) => void;
+        debug?: (message: string) => void;
+    };
+};
+export type DelegateTaskResult = {
+    taskId?: string;
+    output?: string;
+    status: string;
+    error?: string;
+};
+export declare class MulticlawsService extends EventEmitter {
+    private readonly options;
+    private started;
+    private httpServer;
+    private readonly agentRegistry;
+    private readonly teamStore;
+    private readonly profileStore;
+    private readonly taskTracker;
+    private agentExecutor;
+    private a2aRequestHandler;
+    private agentCard;
+    private readonly clientFactory;
+    private readonly httpRateLimiter;
+    private selfUrl;
+    private profileDescription;
+    constructor(options: MulticlawsServiceOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    updateGatewayConfig(config: GatewayConfig): void;
+    listAgents(): Promise<AgentRecord[]>;
+    addAgent(params: {
+        url: string;
+        apiKey?: string;
+    }): Promise<AgentRecord>;
+    removeAgent(url: string): Promise<boolean>;
+    delegateTask(params: {
+        agentUrl: string;
+        task: string;
+    }): Promise<DelegateTaskResult>;
+    getTaskStatus(taskId: string): import("../task/tracker").TaskRecord | null;
+    getProfile(): Promise<AgentProfile>;
+    setProfile(patch: {
+        ownerName?: string;
+        bio?: string;
+    }): Promise<AgentProfile>;
+    private updateProfileDescription;
+    private getPendingReviewPath;
+    getPendingProfileReview(): Promise<{
+        pending: boolean;
+        profile?: AgentProfile;
+        message?: string;
+    }>;
+    setPendingProfileReview(): Promise<void>;
+    clearPendingProfileReview(): Promise<void>;
+    createTeam(name: string): Promise<TeamRecord>;
+    createInvite(teamId?: string): Promise<string>;
+    joinTeam(inviteCode: string): Promise<TeamRecord>;
+    leaveTeam(teamId?: string): Promise<void>;
+    listTeamMembers(teamId?: string): Promise<{
+        team: TeamRecord;
+        members: TeamMember[];
+    } | null>;
+    private mountTeamRoutes;
+    private broadcastProfileToTeams;
+    private fetchMemberDescriptions;
+    private syncTeamToRegistry;
+    private createA2AClient;
+    private processTaskResult;
+    private extractArtifactText;
+    private notifyTailscaleSetup;
+    /** Fetch with up to 2 retries and exponential backoff. */
+    private fetchWithRetry;
+    private log;
+}