@laserdata/laser-sdk 0.0.1-rc.21 → 0.0.1-rc.22

package/dist/agent/registry.d.ts

@@ -0,0 +1,76 @@
+import { type LaserTransport } from "../iggy/apache-iggy.js";
+import type { Cursor } from "../stream/cursor.js";
+import { AgentId, PrincipalId } from "../types/ids.js";
+import { type AgentCard, type AgentEnvelope, type AgentPresence } from "../wire/agent.js";
+import { type ClientMetadata } from "../wire/clients.js";
+import { type KeyRegistry } from "../signing.js";
+export interface RegistryCache {
+    cards: Map<string, RegisteredCard>;
+    quarantined: Set<string>;
+    offsets: Map<number, bigint>;
+    presence: Map<string, PresenceEntry>;
+    presenceReadAtMicros?: bigint;
+    appliedFacts: Set<string>;
+}
+export declare function newRegistryCache(): RegistryCache;
+export interface RegisteredCard {
+    readonly agent: AgentId;
+    readonly card: AgentCard;
+    readonly observedAtMicros: bigint;
+}
+export declare function cardIsFresh(card: RegisteredCard, nowMicros: bigint): boolean;
+export declare function cardServes(card: RegisteredCard, skillId: string): boolean;
+export declare function cardAvailableFor(card: RegisteredCard, skillId: string): boolean;
+export interface PresenceEntry {
+    readonly presence: AgentPresence;
+    readonly principal?: PrincipalId;
+}
+export declare function applyCard(cards: Map<string, RegisteredCard>, envelope: AgentEnvelope, observedAtMicros: bigint): boolean;
+export declare function applyQuarantine(quarantined: Set<string>, envelope: AgentEnvelope): boolean;
+export declare function liftQuarantine(quarantined: Set<string>, envelope: AgentEnvelope): boolean;
+export declare function applyPresence(presence: Map<string, PresenceEntry>, metadata: Uint8Array, userId: number | undefined): boolean;
+export interface AgentPresenceInput {
+    readonly agent: AgentId;
+    readonly inbox?: string;
+}
+export declare function encodePresenceInput(input: AgentPresenceInput): Uint8Array;
+export interface ClientMetadataPage {
+    readonly clients: readonly ClientMetadata[];
+    readonly nextCursor?: number;
+}
+export declare class ClientMetadataRequest {
+    private readonly transport;
+    private query;
+    constructor(transport: Pick<LaserTransport, "sendManaged">);
+    withMetadataOnly(value: boolean): this;
+    principal(principal: PrincipalId): this;
+    limit(limit: number): this;
+    after(clientId: number): this;
+    page(): Promise<ClientMetadataPage>;
+    all(): Promise<readonly ClientMetadata[]>;
+}
+export declare class AgentRegistry {
+    private readonly cursor;
+    private readonly cache;
+    private readonly clientMetadata;
+    private readonly nowMicros;
+    private readonly verifier?;
+    private cards;
+    private presence;
+    private quarantined;
+    private appliedFacts;
+    private presenceReadAtMicros;
+    constructor(cursor: Cursor, cache: RegistryCache, clientMetadata: () => ClientMetadataRequest, nowMicros?: () => bigint, verifier?: KeyRegistry | undefined);
+    refresh(nowMicros?: bigint): Promise<number>;
+    private factAuthorized;
+    agents(): readonly RegisteredCard[];
+    lookup(agent: AgentId): RegisteredCard | undefined;
+    resolve(skillId: string, nowMicros?: bigint): readonly RegisteredCard[];
+    isQuarantined(agent: AgentId): boolean;
+    inboxFor(agent: AgentId): string | undefined;
+    inboxForPrincipal(agent: AgentId, principal: PrincipalId): string | undefined;
+    principalFor(agent: AgentId): PrincipalId | undefined;
+    refreshPresence(): Promise<number>;
+    private persist;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/agent/registry.d.ts.map

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

package/dist/agent/registry.js

@@ -0,0 +1,286 @@
+import {} from "../iggy/apache-iggy.js";
+import { InvalidError } from "../client/errors.js";
+import { AgentId, PrincipalId } from "../types/ids.js";
+import { OPERATION_CARD, OPERATION_QUARANTINE, OPERATION_UNQUARANTINE, decodeAgentCard, decodeAgentPresence, decodeAgentEnvelope, encodeAgentPresence, parseAgentId, validateAgentPresence } from "../wire/agent.js";
+import { decodeOne, encodeNamed, expectMap } from "../wire/cbor.js";
+import { decodeClientMetadataList, encodeClientMetadataQuery } from "../wire/clients.js";
+import { AGDX_GET_CLIENTS_METADATA_CODE, CLIENT_METADATA_OP_VERSION } from "../wire/codes.js";
+import { MAX_PAGE_SIZE } from "../wire/limits.js";
+import { KeyKind } from "../signing.js";
+const PRESENCE_TTL_MICROS = 2000000n;
+function u32(value, field) {
+    if (!Number.isSafeInteger(value) || value < 0 || value > 0xffff_ffff) {
+        throw new InvalidError(`${field} must be an unsigned 32-bit integer`, { field, value });
+    }
+    return value;
+}
+export function newRegistryCache() {
+    return {
+        cards: new Map(),
+        quarantined: new Set(),
+        offsets: new Map(),
+        presence: new Map(),
+        appliedFacts: new Set()
+    };
+}
+function tryAgentId(value) {
+    try {
+        return AgentId.new(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function tryUtf8(bytes) {
+    try {
+        return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function cardIsFresh(card, nowMicros) {
+    const ttl = card.card.ttlMicros;
+    return ttl === undefined || card.observedAtMicros + ttl >= nowMicros;
+}
+export function cardServes(card, skillId) {
+    return card.card.capabilities.some((capability) => capability.skillId === skillId);
+}
+export function cardAvailableFor(card, skillId) {
+    const capability = card.card.capabilities.find((entry) => entry.skillId === skillId);
+    if (capability === undefined)
+        return false;
+    const health = capability.health;
+    return !(health?.kind === "known" && health.name === "Unavailable");
+}
+export function applyCard(cards, envelope, observedAtMicros) {
+    if (envelope.operation !== OPERATION_CARD)
+        return false;
+    const agent = tryAgentId(envelope.source);
+    if (agent === undefined)
+        return false;
+    let card;
+    try {
+        card = decodeAgentCard(expectMap(decodeOne(envelope.body, "agent card"), "agent card"), "agent card");
+    }
+    catch {
+        return false;
+    }
+    cards.set(agent.asString(), { agent, card, observedAtMicros });
+    return true;
+}
+export function applyQuarantine(quarantined, envelope) {
+    const text = tryUtf8(envelope.body);
+    const agent = text !== undefined ? tryAgentId(text) : undefined;
+    if (agent === undefined || quarantined.has(agent.asString()))
+        return false;
+    quarantined.add(agent.asString());
+    return true;
+}
+export function liftQuarantine(quarantined, envelope) {
+    const text = tryUtf8(envelope.body);
+    const agent = text !== undefined ? tryAgentId(text) : undefined;
+    return agent !== undefined && quarantined.delete(agent.asString());
+}
+export function applyPresence(presence, metadata, userId) {
+    let body;
+    try {
+        body = decodeAgentPresence(expectMap(decodeOne(metadata, "agent presence"), "agent presence"), "agent presence");
+    }
+    catch {
+        return false;
+    }
+    const agent = tryAgentId(body.agent);
+    if (agent === undefined)
+        return false;
+    presence.set(agent.asString(), {
+        presence: body,
+        ...(userId !== undefined ? { principal: PrincipalId.new(userId) } : {})
+    });
+    return true;
+}
+export function encodePresenceInput(input) {
+    const presence = {
+        v: 1,
+        agent: parseAgentId(input.agent.asString()),
+        ...(input.inbox !== undefined ? { inbox: input.inbox } : {})
+    };
+    validateAgentPresence(presence);
+    return encodeNamed(encodeAgentPresence(presence));
+}
+export class ClientMetadataRequest {
+    transport;
+    query = {
+        v: CLIENT_METADATA_OP_VERSION,
+        withMetadataOnly: false,
+        limit: MAX_PAGE_SIZE
+    };
+    constructor(transport) {
+        this.transport = transport;
+    }
+    withMetadataOnly(value) {
+        this.query = { ...this.query, withMetadataOnly: value };
+        return this;
+    }
+    principal(principal) {
+        this.query = { ...this.query, userId: principal.get() };
+        return this;
+    }
+    limit(limit) {
+        this.query = { ...this.query, limit: u32(limit, "limit") };
+        return this;
+    }
+    after(clientId) {
+        this.query = { ...this.query, afterClientId: u32(clientId, "clientId") };
+        return this;
+    }
+    async page() {
+        const payload = encodeNamed(encodeClientMetadataQuery(this.query));
+        const reply = await this.transport.sendManaged(AGDX_GET_CLIENTS_METADATA_CODE, payload);
+        const context = "client metadata reply";
+        return decodeClientMetadataList(expectMap(decodeOne(reply, context), context), context);
+    }
+    async all() {
+        const clients = [];
+        let cursor = this.query.afterClientId;
+        do {
+            const request = new ClientMetadataRequest(this.transport);
+            request.query = {
+                ...this.query,
+                ...(cursor !== undefined ? { afterClientId: cursor } : {})
+            };
+            const page = await request.page();
+            clients.push(...page.clients);
+            cursor = page.nextCursor;
+        } while (cursor !== undefined);
+        return clients;
+    }
+}
+export class AgentRegistry {
+    cursor;
+    cache;
+    clientMetadata;
+    nowMicros;
+    verifier;
+    cards;
+    presence;
+    quarantined;
+    appliedFacts;
+    presenceReadAtMicros;
+    constructor(cursor, cache, clientMetadata, nowMicros = () => BigInt(Date.now()) * 1000n, verifier) {
+        this.cursor = cursor;
+        this.cache = cache;
+        this.clientMetadata = clientMetadata;
+        this.nowMicros = nowMicros;
+        this.verifier = verifier;
+        this.cards = new Map(cache.cards);
+        this.presence = new Map(cache.presence);
+        this.quarantined = new Set(cache.quarantined);
+        this.appliedFacts = new Set(cache.appliedFacts);
+        this.presenceReadAtMicros = cache.presenceReadAtMicros;
+        this.cursor.fromOffsets(cache.offsets);
+    }
+    async refresh(nowMicros = this.nowMicros()) {
+        const messages = await this.cursor.poll();
+        let folded = 0;
+        for (const message of messages) {
+            let envelope;
+            try {
+                const context = "agent registry record";
+                envelope = decodeAgentEnvelope(expectMap(decodeOne(message.payload, context), context), context);
+            }
+            catch {
+                continue;
+            }
+            const operation = envelope.operation;
+            let applied;
+            if (operation === OPERATION_QUARANTINE || operation === OPERATION_UNQUARANTINE) {
+                const record = envelope.record?.toString();
+                if (record !== undefined && this.appliedFacts.has(record))
+                    continue;
+                if (!this.factAuthorized(envelope, nowMicros))
+                    continue;
+                if (record !== undefined)
+                    this.appliedFacts.add(record);
+                applied =
+                    operation === OPERATION_QUARANTINE
+                        ? applyQuarantine(this.quarantined, envelope)
+                        : liftQuarantine(this.quarantined, envelope);
+            }
+            else {
+                applied = applyCard(this.cards, envelope, nowMicros);
+            }
+            if (applied)
+                folded += 1;
+        }
+        for (const [agent, card] of this.cards) {
+            if (!cardIsFresh(card, nowMicros))
+                this.cards.delete(agent);
+        }
+        this.persist();
+        return folded;
+    }
+    factAuthorized(envelope, nowMicros) {
+        if (this.verifier === undefined)
+            return true;
+        try {
+            return this.verifier.verifyAt(envelope, nowMicros).kind === KeyKind.Operator;
+        }
+        catch {
+            return false;
+        }
+    }
+    agents() {
+        return [...this.cards.values()];
+    }
+    lookup(agent) {
+        return this.cards.get(agent.asString());
+    }
+    resolve(skillId, nowMicros = this.nowMicros()) {
+        return [...this.cards.values()].filter((card) => cardAvailableFor(card, skillId) &&
+            cardIsFresh(card, nowMicros) &&
+            !this.quarantined.has(card.agent.asString()));
+    }
+    isQuarantined(agent) {
+        return this.quarantined.has(agent.asString());
+    }
+    inboxFor(agent) {
+        return this.presence.get(agent.asString())?.presence.inbox;
+    }
+    inboxForPrincipal(agent, principal) {
+        const entry = this.presence.get(agent.asString());
+        return entry?.principal?.get() === principal.get() ? entry.presence.inbox : undefined;
+    }
+    principalFor(agent) {
+        return this.presence.get(agent.asString())?.principal;
+    }
+    async refreshPresence() {
+        const now = this.nowMicros();
+        if (this.presenceReadAtMicros !== undefined &&
+            now - this.presenceReadAtMicros < PRESENCE_TTL_MICROS) {
+            return this.presence.size;
+        }
+        const connections = await this.clientMetadata().withMetadataOnly(true).all();
+        const fresh = new Map();
+        for (const connection of connections) {
+            if (connection.metadata !== undefined) {
+                applyPresence(fresh, connection.metadata, connection.userId);
+            }
+        }
+        this.presence = fresh;
+        this.presenceReadAtMicros = now;
+        this.persist();
+        return fresh.size;
+    }
+    persist() {
+        this.cache.cards = new Map(this.cards);
+        this.cache.presence = new Map(this.presence);
+        this.cache.quarantined = new Set(this.quarantined);
+        this.cache.appliedFacts = new Set(this.appliedFacts);
+        this.cache.offsets = new Map(this.cursor.offsets);
+        if (this.presenceReadAtMicros !== undefined) {
+            this.cache.presenceReadAtMicros = this.presenceReadAtMicros;
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/agent/registry.js.map

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

package/dist/agent/reliable-consumer.d.ts

@@ -0,0 +1,126 @@
+import { CodecError, LaserError } from "../client/errors.js";
+import type { Laser } from "../client/laser.js";
+import type { IggyHeaderValue } from "../iggy/apache-iggy.js";
+import { type Provenance } from "../provenance/provenance.js";
+import { type Clock } from "../runtime/clock.js";
+import type { KeyRegistry, SigningKey } from "../signing.js";
+import { AgentId, type ConsumerGroupName, type MessageId } from "../types/ids.js";
+import { type AgentDeadLetter, type AgentEnvelope } from "../wire/agent.js";
+import { type ContentType } from "../wire/content.js";
+import { AgentContext } from "./context.js";
+import { type InboxRoute } from "./router.js";
+export declare function provenanceFromEnvelope(envelope: AgentEnvelope): Provenance;
+export interface ReceivedAgentMessage {
+    readonly payload: Uint8Array;
+    readonly partitionId: number;
+    readonly offset: bigint;
+    readonly headers: ReadonlyMap<string, IggyHeaderValue>;
+}
+export interface ProvenanceAndEnvelope {
+    readonly provenance: Provenance;
+    readonly envelope?: AgentEnvelope;
+}
+export declare function provenanceAndEnvelope(message: ReceivedAgentMessage): ProvenanceAndEnvelope;
+export declare function contentTypeOf(message: ReceivedAgentMessage): ContentType | undefined;
+export interface AgentMessage {
+    readonly provenance: Provenance;
+    readonly payload: Uint8Array;
+    readonly id: MessageId;
+    readonly envelope?: AgentEnvelope;
+    readonly contentType?: ContentType;
+    readonly verifiedPrincipal?: string;
+}
+export declare function agentMessageBody(message: AgentMessage): Uint8Array;
+export type DecodedAgentMessage = {
+    readonly kind: "message";
+    readonly message: AgentMessage;
+} | {
+    readonly kind: "error";
+    readonly error: CodecError;
+    readonly payload: Uint8Array;
+};
+export declare function decodeAgentMessage(received: ReceivedAgentMessage): DecodedAgentMessage;
+export interface RetryPolicy {
+    readonly maxAttempts: number;
+    readonly baseDelayMs: number;
+}
+export declare function retryBackoff(maxAttempts: number, baseDelayMs: number): RetryPolicy;
+export declare const DEFAULT_RETRY_POLICY: RetryPolicy;
+export declare function retryDelayMs(policy: RetryPolicy, attempt: number): number;
+export type ConcurrencyPolicy = {
+    readonly kind: "serial";
+} | {
+    readonly kind: "serial-per-partition";
+    readonly maxPartitions: number;
+};
+export declare const SERIAL_CONCURRENCY: ConcurrencyPolicy;
+export interface Deduplicator {
+    observe(key: string): Promise<boolean>;
+}
+export declare class SlidingWindow implements Deduplicator {
+    private readonly capacity;
+    private readonly seen;
+    private readonly order;
+    constructor(capacity: number);
+    observe(key: string): Promise<boolean>;
+}
+export declare function dedupKey(provenance: Provenance): string | undefined;
+export interface FenceEntry {
+    readonly fence: bigint;
+    readonly touchedMicros: bigint;
+}
+export interface FenceSweepState {
+    lastSweepMicros: bigint;
+}
+export declare function acceptFence(highWater: Map<string, FenceEntry>, sweepState: FenceSweepState, taskKey: string, fence: bigint, nowMicros: bigint): boolean;
+export interface AgentHandler {
+    handle(message: AgentMessage, context: AgentContext): Promise<void>;
+}
+export type HandlerResult = {
+    readonly kind: "ok";
+} | {
+    readonly kind: "error";
+    readonly error: LaserError;
+};
+export interface AgentMiddleware {
+    beforeHandle?(message: AgentMessage): Promise<void>;
+    afterHandle?(message: AgentMessage, result: HandlerResult, attempt: number): Promise<void>;
+}
+export interface DeadLetterSink {
+    onDeadLetter(message: AgentMessage | undefined, capsule: AgentDeadLetter, publishError: LaserError | undefined): Promise<void>;
+}
+export interface ReliableConsumerOptions {
+    readonly group: ConsumerGroupName;
+    readonly topic: string;
+    readonly agent?: AgentId;
+    readonly dedupWindow?: number;
+    readonly retry?: RetryPolicy;
+    readonly pollIntervalMs?: number;
+    readonly concurrency?: ConcurrencyPolicy;
+    readonly respondOn?: string;
+    readonly inboxRoute?: InboxRoute;
+    readonly ackOnPickup?: boolean;
+    readonly deduplicator?: Deduplicator;
+    readonly warmDedup?: boolean;
+    readonly middleware?: readonly AgentMiddleware[];
+    readonly deadLetterSink?: DeadLetterSink;
+    readonly clock?: Clock;
+    readonly verifier?: KeyRegistry;
+    readonly signingKey?: SigningKey;
+}
+export interface ReliableConsumerControl {
+    readonly signal?: AbortSignal;
+    readonly hardSignal?: AbortSignal;
+    readonly ready?: () => void;
+    readonly hardAborted?: () => boolean;
+}
+export declare function isRetryable(error: LaserError): boolean;
+export declare class ReliableConsumer {
+    readonly options: ReliableConsumerOptions;
+    constructor(options: ReliableConsumerOptions);
+    run(laser: Laser, handler: AgentHandler, control?: ReliableConsumerControl): Promise<void>;
+    private runSerial;
+    private runPerPartition;
+    private warmDedup;
+}
+//# sourceMappingURL=reliable-consumer.d.ts.map

package/dist/agent/reliable-consumer.d.ts.map

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