@mebular/fleet 0.0.0-stage → 0.1.0

package/dist/agentdir.d.ts

@@ -0,0 +1,43 @@
+import type { Mebular } from '@mebular/core';
+import { MebularMessageStore } from './store/message-store.js';
+export declare const AGENT_DIRECTORY_MESSAGE_TYPE = "agent_directory";
+export interface AgentDirectoryAgent {
+    name: string;
+    /** 执行器 kind（与 `FleetAgentConfig.kind` 对齐：echo/command/hermes/openchamber） */
+    kind: string;
+    capabilities?: string[];
+    concurrency?: number;
+    /** 建议性容量提示（**不参与授权/一致性**） */
+    capacity?: number;
+}
+export interface AgentDirectoryEntry {
+    v: number;
+    device: string;
+    agents: AgentDirectoryAgent[];
+    /** 本机墙钟（**advisory**；不参与一致性判定） */
+    updatedAt: number;
+    /** 单调版本：同设备取最大者（R-c 式确定序，无墙钟） */
+    version: number;
+}
+export interface AgentDirectoryValidation {
+    ok: boolean;
+    errors: string[];
+}
+export declare function validateAgentDirectory(input: unknown): AgentDirectoryValidation;
+/** 构造目录存储（校验 + 幂等键 `device@version`）。 */
+export declare function agentDirectoryStore(mebular: Mebular, namespace?: string): MebularMessageStore<AgentDirectoryEntry>;
+/** 每设备最新目录（同设备取 `version` 最大；平局取稳定序列化较大者，确定性）。 */
+export declare function latestDirectories(entries: readonly AgentDirectoryEntry[]): AgentDirectoryEntry[];
+export interface TaskTarget {
+    device: string;
+    agent: string;
+    kind: string;
+    concurrency?: number;
+    capacity?: number;
+}
+/**
+ * `task_targets` = **L1 授权过的对端** ∩ 其目录里的 `(device, agent)`。
+ * 授权集合外的设备记录一律忽略（默认拒绝；授权是前提）。确定序（device, agent）。
+ */
+export declare function expandTargets(entries: readonly AgentDirectoryEntry[], authorizedDevices: readonly string[]): TaskTarget[];
+//# sourceMappingURL=agentdir.d.ts.map

package/dist/agentdir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentdir.d.ts","sourceRoot":"","sources":["../src/agentdir.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,eAAO,MAAM,4BAA4B,oBAAoB,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CA0B/E;AAED,yCAAyC;AACzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,SAAW,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,CAOpH;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAehG;AAUD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GACnC,UAAU,EAAE,CAiBd"}

package/dist/agentdir.js

@@ -0,0 +1,107 @@
+// W1 每设备 Agent 目录（普通记忆域，默认 `agents`）。
+//
+// 每设备一条**签名**记录（作者=设备；随已有记忆同步，证书链由 core 校验）：
+//   { device, agents:[{name,kind,capabilities?,concurrency,capacity?}], updatedAt, version }
+// `task_targets` = **我 L1 授权过的对端** ∩ 其目录里的 `(device, agent)`。
+// `capacity`/`load` 为**建议性**（不参与授权与一致性判定）。
+import { MebularMessageStore } from './store/message-store.js';
+export const AGENT_DIRECTORY_MESSAGE_TYPE = 'agent_directory';
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+export function validateAgentDirectory(input) {
+    const errors = [];
+    if (typeof input !== 'object' || input === null || Array.isArray(input))
+        return { ok: false, errors: ['目录必须是对象'] };
+    const e = input;
+    if (e.v !== 1)
+        errors.push('v 必须为 1');
+    if (!isNonEmptyString(e.device))
+        errors.push('device 必须为非空字符串');
+    if (typeof e.updatedAt !== 'number' || !Number.isFinite(e.updatedAt))
+        errors.push('updatedAt 必须为有限数字');
+    if (typeof e.version !== 'number' || !Number.isInteger(e.version) || e.version < 0)
+        errors.push('version 必须为非负整数');
+    if (!Array.isArray(e.agents)) {
+        errors.push('agents 必须为数组');
+    }
+    else {
+        for (const a of e.agents) {
+            if (!isNonEmptyString(a?.name))
+                errors.push('agent.name 必须为非空字符串');
+            if (!isNonEmptyString(a?.kind))
+                errors.push('agent.kind 必须为非空字符串');
+            if (a?.capabilities !== undefined && (!Array.isArray(a.capabilities) || a.capabilities.some((c) => typeof c !== 'string'))) {
+                errors.push('agent.capabilities 若存在须为字符串数组');
+            }
+            if (a?.concurrency !== undefined && (typeof a.concurrency !== 'number' || !Number.isInteger(a.concurrency) || a.concurrency < 1)) {
+                errors.push('agent.concurrency 若存在须为正整数');
+            }
+            if (a?.capacity !== undefined && (typeof a.capacity !== 'number' || !Number.isFinite(a.capacity) || a.capacity < 0)) {
+                errors.push('agent.capacity 若存在须为非负数字（advisory）');
+            }
+        }
+    }
+    return { ok: errors.length === 0, errors };
+}
+/** 构造目录存储（校验 + 幂等键 `device@version`）。 */
+export function agentDirectoryStore(mebular, namespace = 'agents') {
+    return new MebularMessageStore(mebular, {
+        type: AGENT_DIRECTORY_MESSAGE_TYPE,
+        namespace,
+        validate: validateAgentDirectory,
+        idOf: (e) => `${e.device}@${e.version}`,
+    });
+}
+/** 每设备最新目录（同设备取 `version` 最大；平局取稳定序列化较大者，确定性）。 */
+export function latestDirectories(entries) {
+    const byDevice = new Map();
+    for (const e of entries) {
+        const prev = byDevice.get(e.device);
+        if (prev === undefined) {
+            byDevice.set(e.device, e);
+            continue;
+        }
+        const stronger = e.version !== prev.version
+            ? e.version > prev.version
+            : stable(e) > stable(prev);
+        if (stronger)
+            byDevice.set(e.device, e);
+    }
+    return [...byDevice.values()].sort((a, b) => (a.device < b.device ? -1 : a.device > b.device ? 1 : 0));
+}
+function stable(value) {
+    if (value === undefined)
+        return 'null';
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stable).join(',')}]`;
+    const rec = value;
+    return `{${Object.keys(rec).sort().map((k) => `${JSON.stringify(k)}:${stable(rec[k])}`).join(',')}}`;
+}
+/**
+ * `task_targets` = **L1 授权过的对端** ∩ 其目录里的 `(device, agent)`。
+ * 授权集合外的设备记录一律忽略（默认拒绝；授权是前提）。确定序（device, agent）。
+ */
+export function expandTargets(entries, authorizedDevices) {
+    const allowed = new Set(authorizedDevices);
+    const targets = [];
+    for (const entry of latestDirectories(entries)) {
+        if (!allowed.has(entry.device))
+            continue;
+        for (const agent of [...entry.agents].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))) {
+            if (!isNonEmptyString(agent.name) || !isNonEmptyString(agent.kind))
+                continue;
+            targets.push({
+                device: entry.device,
+                agent: agent.name,
+                kind: agent.kind,
+                ...(agent.concurrency !== undefined ? { concurrency: agent.concurrency } : {}),
+                ...(agent.capacity !== undefined ? { capacity: agent.capacity } : {}),
+            });
+        }
+    }
+    return targets;
+}
+//# sourceMappingURL=agentdir.js.map

package/dist/agentdir.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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