@agentunion/fastaun 0.5.31 → 0.5.33

package/dist/tools/pubsub-actor.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { CrossSdkTsAgent } from './cross-sdk-agent.js';
+import { type EventService, type EventServiceStartOptions } from '../pubsub/index.js';
+import type { JsonMap } from '../pubsub/types.js';
+export declare function pubsubErrorCode(error: unknown): string;
+export declare class PubSubActor {
+    readonly agent: CrossSdkTsAgent;
+    readonly role: string;
+    readonly serviceAid: string;
+    events?: EventService;
+    boundRole: string;
+    startupError: string;
+    ready: boolean;
+    readonly instances: Map<string, PubSubActor>;
+    readonly observations: JsonMap[];
+    readonly observationSubscriptions: Array<{
+        unsubscribe(): void;
+    }>;
+    busOptions: EventServiceStartOptions;
+    constructor(agent?: CrossSdkTsAgent, role?: string);
+    start(): Promise<void>;
+    close(): Promise<void>;
+    observeTransport(): void;
+    private openDevice;
+    identity(): JsonMap;
+    call(op: string, body: JsonMap): Promise<unknown>;
+}

package/dist/tools/pubsub-actor.js

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+import * as http from 'node:http';
+import * as fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import * as path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { CrossSdkTsAgent } from './cross-sdk-agent.js';
+import { AID } from '../aid.js';
+import { AUNClient } from '../client.js';
+import { PubSubError } from '../pubsub/index.js';
+const eventName = String(process.env.AUN_PUBSUB_EVENT ?? 'task.completed');
+const catalog = {
+    [eventName]: {
+        description: 'cross-sdk event', schema_version: 1,
+        content_schema: { task_id: 'string', status: 'string' },
+        default_ttl_seconds: 30, max_ttl_seconds: 120,
+    },
+};
+const listEnv = (name) => String(process.env[name] ?? '').split(',').map(v => v.trim()).filter(Boolean);
+const flag = (name) => ['1', 'true', 'yes', 'on'].includes(String(process.env[name] ?? '').trim().toLowerCase());
+function stateFile(filename) {
+    let saving = Promise.resolve();
+    return {
+        async load() { try {
+            return JSON.parse(await fs.promises.readFile(filename, 'utf8'));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        } },
+        save(value) { const text = JSON.stringify(value); saving = saving.then(async () => { await fs.promises.mkdir(path.dirname(filename), { recursive: true }); await fs.promises.writeFile(`${filename}.tmp`, text, { mode: 0o600 }); await fs.promises.rename(`${filename}.tmp`, filename); }); return saving; },
+    };
+}
+const safe = (value) => {
+    try {
+        JSON.stringify(value);
+        return value;
+    }
+    catch {
+        return String(value);
+    }
+};
+export function pubsubErrorCode(error) {
+    const value = error;
+    return String(value?.data?.code || value?.stringCode || (typeof value?.code === 'string' ? value.code : '') || value?.name || 'Error');
+}
+export class PubSubActor {
+    agent;
+    role;
+    serviceAid = String(process.env.AUN_PUBSUB_SERVICE_AID ?? '').trim();
+    events;
+    boundRole = '';
+    startupError = '';
+    ready = false;
+    instances = new Map();
+    observations = [];
+    observationSubscriptions = [];
+    busOptions = {};
+    constructor(agent = new CrossSdkTsAgent(), role = String(process.env.AUN_PUBSUB_ROLE ?? 'client').trim() || 'client') {
+        this.agent = agent;
+        this.role = role;
+    }
+    async start() {
+        await this.agent.start();
+        const serviceAid = this.serviceAid || this.agent.aid;
+        this.events = this.agent.client.EventService;
+        this.observeTransport();
+        if (this.role === 'service') {
+            const allowAll = flag('AUN_PUBSUB_ALLOW_ALL');
+            const publishers = allowAll ? ['*'] : listEnv('AUN_PUBSUB_PUBLISHER_AIDS');
+            const subscribers = allowAll ? ['*'] : listEnv('AUN_PUBSUB_SUBSCRIBER_AIDS');
+            const statePath = String(process.env.AUN_PUBSUB_STATE_PATH ?? path.join(this.agent.aunPath, 'pubsub-service'));
+            this.busOptions = { catalog,
+                allowlist: { [eventName]: { publish_aids: publishers, subscribe_aids: subscribers } },
+                state: stateFile(path.join(statePath, 'event-service.json')),
+                credentialOptions: { state: stateFile(path.join(statePath, 'credential-state.json')) } };
+            await this.events.start(serviceAid, this.busOptions);
+            this.boundRole = 'bus';
+        }
+        this.ready = true;
+    }
+    async close() {
+        for (const child of this.instances.values())
+            await child.close();
+        this.instances.clear();
+        if (this.boundRole)
+            await this.events?.close(this.serviceAid || this.agent.aid);
+        for (const subscription of this.observationSubscriptions.splice(0))
+            subscription.unsubscribe();
+        await this.agent.close();
+        this.ready = false;
+    }
+    observeTransport() {
+        const receive = (value) => {
+            if (!value || typeof value !== 'object')
+                return;
+            const data = value, row = (data.inline_message ?? data);
+            this.observations.push(Object.fromEntries(['message_id', 'from_aid', 'sender_device_id', 'sender_slot_id', 'device_id', 'to_slot_id', 'volatile_cursor', 'message_class'].filter(key => key in row).map(key => [key, row[key]])));
+            if (this.observations.length > 256)
+                this.observations.splice(0, this.observations.length - 256);
+        };
+        for (const event of ['_raw.message.received', '_raw.peer.v2.message_received'])
+            this.observationSubscriptions.push(this.agent.client.on(event, receive));
+    }
+    async openDevice(instance, body) {
+        if (!instance || this.instances.has(instance) || this.instances.size >= 4)
+            throw new PubSubError('DEVICE_INSTANCE_INVALID');
+        const source = this.agent.client.currentAid;
+        const identity = AID._create({ aid: source.aid, aunPath: source.aunPath, certPem: source.certPem, privateKeyPem: source.privateKeyPem,
+            certValid: source.isCertValid(), privateKeyValid: source.isPrivateKeyValid(), deviceId: body.same_device ? source.deviceId : `pubsub-device-${randomUUID()}`,
+            slotId: `pubsub-slot-${randomUUID()}`, verifySsl: source.verifySsl, rootCaPath: source.rootCaPath, debug: source.debug });
+        const client = new AUNClient(identity);
+        client._configModel.requireForwardSecrecy = false;
+        const agent = { aid: source.aid, client, close: () => client.close(), identity: () => ({ aid: source.aid, device_id: identity.deviceId, slot_id: identity.slotId }) };
+        const child = new PubSubActor(agent, 'client');
+        child.busOptions = { catalog: this.busOptions.catalog, allowlist: this.busOptions.allowlist };
+        child.events = client.EventService;
+        child.observeTransport();
+        try {
+            await client.connect({ auto_reconnect: false, background_sync: body.background_sync !== false });
+        }
+        catch (error) {
+            await child.close();
+            throw error;
+        }
+        child.ready = true;
+        this.instances.set(instance, child);
+        return child.identity();
+    }
+    identity() {
+        return { ok: !this.startupError, ...this.agent.identity(), role: this.role,
+            service_aid: this.serviceAid || this.agent.aid, event: eventName, client_role: this.boundRole, facade: 'EventService', agent_ready: this.ready,
+            startup_error: this.startupError };
+    }
+    async call(op, body) {
+        if (!this.events)
+            throw new Error('PUBSUB_CLIENT_UNAVAILABLE');
+        body = { ...body };
+        const instance = String(body.instance ?? '');
+        delete body.instance;
+        if (op === 'device_open')
+            return this.openDevice(instance, body);
+        if (instance) {
+            const child = this.instances.get(instance);
+            if (!child)
+                throw new PubSubError('DEVICE_INSTANCE_INVALID');
+            if (op === 'device_close') {
+                await child.close();
+                this.instances.delete(instance);
+                return { closed: true };
+            }
+            return child.call(op, body);
+        }
+        const bus_aid = String(body.bus_aid ?? (this.serviceAid || this.agent.aid));
+        delete body.bus_aid;
+        switch (op) {
+            case 'bus_start': {
+                const options = { ...this.busOptions };
+                for (const key of ['catalog', 'allowlist'])
+                    if (body[key] !== undefined)
+                        Object.assign(options, { [key]: body[key] });
+                await this.events.start(bus_aid, options);
+                this.boundRole = 'bus';
+                return { started: true };
+            }
+            case 'bus_stop':
+                await this.events.close(bus_aid);
+                return { stopped: true };
+            case 'update_config':
+                await this.events.updateConfig(bus_aid, Object.fromEntries(Object.entries(body).filter(([key]) => key === 'catalog' || key === 'allowlist')));
+                return { updated: true };
+            case 'transport': {
+                const method = String(body.method);
+                if (!['message.peers', 'message.pull', 'message.ack'].includes(method))
+                    throw new PubSubError('TRANSPORT_METHOD_INVALID');
+                return this.agent.client.call(method, body.params ?? {});
+            }
+            case 'observations': {
+                const messages = [...this.observations];
+                if (body.clear)
+                    this.observations.length = 0;
+                return { messages };
+            }
+            case 'catalog': return this.events.catalog(bus_aid, body);
+            case 'authorize': {
+                const role = String(body.role ?? '');
+                if (role !== 'pub' && role !== 'sub')
+                    throw new PubSubError('INVALID_ROLE');
+                this.boundRole ||= role;
+                return this.events.authorize(bus_aid, role, String(body.auth_mode ?? 'allowlist'), body.events ?? [eventName], body.credential);
+            }
+            case 'subscribe': return this.events.subscribe(bus_aid, body.events ?? [eventName]);
+            case 'unsubscribe': return this.events.unsubscribe(bus_aid, body.events ?? [eventName]);
+            case 'renew': return this.events.renew(bus_aid);
+            case 'publish': return { event_id: await this.events.publish(bus_aid, String(body.event_name ?? eventName), body.data, { schemaVersion: Number(body.schema_version ?? 1), ttlSeconds: Number(body.ttl_seconds ?? 30), replyMode: String(body.reply_mode ?? 'none'), eventId: body.event_id }) };
+            case 'wait_published': return this.events.waitPublished(bus_aid, String(body.event_id));
+            case 'next': return this.events.nextEvent(bus_aid, Number(body.timeout_seconds ?? 10));
+            case 'stats': return this.events.stats(bus_aid, body);
+            case 'issue_grant': return this.events.issueGrant(bus_aid, body);
+            case 'revoke_grant': return this.events.revokeGrant(bus_aid, body);
+            default: throw new PubSubError('INVALID_OPERATION');
+        }
+    }
+}
+async function readJson(req) {
+    const chunks = [];
+    for await (const chunk of req)
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    if (!chunks.length)
+        return {};
+    try {
+        const value = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+    }
+    catch {
+        return {};
+    }
+}
+function send(res, status, body) {
+    const text = JSON.stringify(safe(body));
+    res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'content-length': Buffer.byteLength(text) });
+    res.end(text);
+}
+async function main() {
+    const actor = new PubSubActor();
+    void actor.start().catch(error => { actor.startupError = `${error instanceof Error ? error.name : 'Error'}: ${error instanceof Error ? error.message : String(error)}`; });
+    const server = http.createServer(async (req, res) => {
+        try {
+            const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);
+            if (req.method === 'GET' && url.pathname === '/identity') {
+                send(res, 200, actor.identity());
+                return;
+            }
+            if (req.method === 'GET' && url.pathname === '/health') {
+                send(res, actor.startupError ? 503 : 200, actor.identity());
+                return;
+            }
+            if (req.method === 'POST' && url.pathname.startsWith('/pubsub/')) {
+                const result = await actor.call(url.pathname.slice('/pubsub/'.length), await readJson(req));
+                send(res, 200, { ok: true, result: safe(result) });
+                return;
+            }
+            send(res, 404, { ok: false, error_code: 'not_found' });
+        }
+        catch (error) {
+            const code = pubsubErrorCode(error);
+            send(res, 400, { ok: false, error_code: code, error_message: error instanceof Error ? error.message : String(error) });
+        }
+    });
+    const host = String(process.env.AUN_CONTROL_HOST ?? '0.0.0.0');
+    const port = Number(process.env.AUN_CONTROL_PORT ?? 9001) || 9001;
+    server.listen(port, host, () => console.log(`pubsub ts actor listening on ${host}:${port}`));
+    const stop = async () => { server.close(); await actor.close(); process.exit(0); };
+    process.on('SIGINT', () => { void stop(); });
+    process.on('SIGTERM', () => { void stop(); });
+}
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url))
+    void main();
+//# sourceMappingURL=pubsub-actor.js.map

package/dist/tools/pubsub-actor.js.map

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

package/dist/transport.d.ts

@@ -11,6 +11,7 @@ import type { EventDispatcher } from './events.js';
 import { type ModuleLogger } from './logger.js';
 import { type JsonObject, type RpcMessage, type RpcParams, type RpcResult } from './types.js';
 import { type ServiceEventVerificationResult } from './org-protocol.js';
+export type RpcBackground = false | true | 'event' | 'pull';
 /** 断线回调，closeCode 为 WebSocket close code（1006 = 网络异常断开，其他 = 服务端主动关闭） */
 export type DisconnectCallback = (error: Error | null, closeCode?: number) => void | Promise<void>;
 /** RPC envelope 的 _meta 字段观察者；observer 抛错被吞掉，不影响业务。 */
@@ -51,9 +52,14 @@ export declare class RPCTransport {
     private _pending;
     private _pendingMeta;
     private _pendingBackground;
+    private _pendingEvent;
+    private _pendingPull;
     private _rpcQueue;
     private _backgroundRpcQueue;
     private _drainingRpcQueue;
+    private _rateLimitUntil;
+    private _rateLimitTimer;
+    private _rateLimitWaiters;
     _onForegroundDrained?: () => void;
     _onRpcResponse?: () => void;
     private _sendQueue;
@@ -82,6 +88,16 @@ export declare class RPCTransport {
     private _workerConnectAttempt;
     private _workerBufferedEvents;
     private _workerOptions;
+    get inflightCounts(): {
+        total: number;
+        background: number;
+        event: number;
+        pull: number;
+    };
+    get foregroundWaiting(): number;
+    _eventBackpressure(timeout?: number): Promise<boolean> & {
+        cancel?: () => void;
+    };
     constructor(opts: {
         eventDispatcher: EventDispatcher;
         timeout?: number;
@@ -158,7 +174,7 @@ export declare class RPCTransport {
     /**
      * 发送 JSON-RPC 2.0 请求并等待响应。
      */
-    call(method: string, params?: RpcParams, timeout?: number, trace?: string, background?: boolean): Promise<RpcResult>;
+    call(method: string, params?: RpcParams, timeout?: number, trace?: string, background?: RpcBackground): Promise<RpcResult>;
     private _callWithSent;
     private _call;
     private _callAdmitted;
@@ -169,6 +185,14 @@ export declare class RPCTransport {
     private _notifyLocal;
     private _messagePriority;
     private _isRiskControlMethod;
+    _rateLimitRemainingMs(): number;
+    private _rateLimitError;
+    _waitRateLimit(timeout?: number, signal?: AbortSignal): Promise<void>;
+    _observeRateLimit(error: {
+        code?: unknown;
+        data?: unknown;
+    }): void;
+    private _canDispatch;
     private _enqueueSend;
     private _startSendQueue;
     private _sendText;