@laserdata/laser-sdk 0.0.1-rc.1 → 0.0.1-rc.3

package/dist/agent/builder.d.ts

@@ -0,0 +1,114 @@
+import type { Laser } from "../client/laser.js";
+import { ConsumerGroupName, type AgentId } from "../types/ids.js";
+import type { ActionGovernor, GovernorMode } from "../govern.js";
+import type { KeyRegistry, SigningKey } from "../signing.js";
+import type { CapabilityDescriptor } from "../wire/agent.js";
+import type { MemoryScope } from "../memory/types.js";
+import { type AgentHandler, type AgentMiddleware, type ConcurrencyPolicy, type DeadLetterSink, type Deduplicator, type RetryPolicy } from "./reliable-consumer.js";
+import type { InboxRoute } from "./router.js";
+interface AgentDefinition {
+    readonly id: AgentId;
+    readonly consumerGroup?: ConsumerGroupName;
+    readonly listenOn: string;
+    readonly handler: AgentHandler;
+    readonly respondOn?: string;
+    readonly inboxRoute?: InboxRoute;
+    readonly pollIntervalMs?: number;
+    readonly shutdownGraceMs: number;
+    readonly concurrency?: ConcurrencyPolicy;
+    readonly warmDedup: boolean;
+    readonly middleware: readonly AgentMiddleware[];
+    readonly deadLetterSink?: DeadLetterSink;
+    readonly dedupWindow?: number;
+    readonly retry?: RetryPolicy;
+    readonly deduplicator?: Deduplicator;
+    readonly capabilities: readonly CapabilityDescriptor[];
+    readonly ackOnPickup: boolean;
+    readonly verifier?: KeyRegistry;
+    readonly signingKey?: SigningKey;
+    readonly governor?: ActionGovernor;
+    readonly governorMode?: GovernorMode;
+    readonly consolidateEveryMs?: number;
+    readonly consolidator?: AgentConsolidator;
+}
+export interface AgentConsolidator {
+    consolidate(scope: MemoryScope): Promise<unknown>;
+}
+/** Controls one running agent and drains it on async disposal. */
+export declare class AgentHandle implements AsyncDisposable {
+    private readonly shutdownController;
+    private readonly hardStopController;
+    private hardStopped;
+    private readySettled;
+    private readonly readyPromise;
+    private readonly resolveReady;
+    private readonly rejectReady;
+    private readonly task;
+    private readonly shutdownGraceMs;
+    private readonly consolidationController;
+    private readonly consolidationTask;
+    constructor(definition: AgentDefinition, laser: Laser);
+    ready(): Promise<void>;
+    /** Stops intake, drains active handlers, and joins background work. */
+    shutdown(): Promise<void>;
+    /** Delegates async disposal to `shutdown()`. */
+    [Symbol.asyncDispose](): Promise<void>;
+    join(): Promise<void>;
+    abort(): void;
+    private runConsolidation;
+    private waitForConsolidationInterval;
+    private run;
+}
+export declare class AgentBuilder {
+    private agentId;
+    private group;
+    private listenTopic;
+    private replyTopic;
+    private agentHandler;
+    private route;
+    private pollMs;
+    private graceMs;
+    private concurrencyPolicy;
+    private shouldWarmDedup;
+    private readonly middlewareList;
+    private sink;
+    private window;
+    private retryPolicy;
+    private dedup;
+    private advertisedCapabilities;
+    private pickupAck;
+    private signatureVerifier;
+    private signer;
+    private actionGovernor;
+    private mode;
+    private consolidationIntervalMs;
+    private memoryConsolidator;
+    id(id: AgentId): this;
+    consumerGroup(group: ConsumerGroupName): this;
+    listenOn(topic: string): this;
+    respondOn(topic: string): this;
+    handler(handler: AgentHandler): this;
+    inboxRoute(route: InboxRoute): this;
+    pollInterval(ms: number): this;
+    shutdownGrace(ms: number): this;
+    concurrency(policy: ConcurrencyPolicy): this;
+    warmDedup(value?: boolean): this;
+    middleware(middleware: AgentMiddleware): this;
+    deadLetterSink(sink: DeadLetterSink): this;
+    dedupWindow(size: number): this;
+    retry(retry: RetryPolicy): this;
+    deduplicator(deduplicator: Deduplicator): this;
+    capabilities(capabilities: readonly CapabilityDescriptor[]): this;
+    ackOnPickup(value?: boolean): this;
+    verifier(verifier: KeyRegistry): this;
+    signingKey(signingKey: SigningKey): this;
+    governor(governor: ActionGovernor, mode: GovernorMode): this;
+    consolidateEvery(milliseconds: number): this;
+    consolidator(consolidator: AgentConsolidator): this;
+    spawn(laser: Laser): AgentHandle;
+}
+export declare const Agent: {
+    readonly builder: () => AgentBuilder;
+};
+export {};
+//# sourceMappingURL=builder.d.ts.map

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

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

package/dist/agent/builder.js

@@ -0,0 +1,334 @@
+import { HandlerConfigError, TimeoutError } from "../client/errors.js";
+import { ConsumerGroupName } from "../types/ids.js";
+import { ReliableConsumer } from "./reliable-consumer.js";
+/** Controls one running agent and drains it on async disposal. */
+export class AgentHandle {
+    shutdownController = new AbortController();
+    hardStopController = new AbortController();
+    hardStopped = false;
+    readySettled = false;
+    readyPromise;
+    resolveReady;
+    rejectReady;
+    task;
+    shutdownGraceMs;
+    consolidationController = new AbortController();
+    consolidationTask;
+    constructor(definition, laser) {
+        this.shutdownGraceMs = definition.shutdownGraceMs;
+        let resolveReady;
+        let rejectReady;
+        this.readyPromise = new Promise((resolve, reject) => {
+            resolveReady = resolve;
+            rejectReady = reject;
+        });
+        this.resolveReady = resolveReady;
+        this.rejectReady = rejectReady;
+        this.task = this.run(definition, laser);
+        this.consolidationTask =
+            definition.consolidateEveryMs !== undefined && definition.consolidator !== undefined
+                ? this.runConsolidation(definition.consolidateEveryMs, definition.consolidator, this.consolidationController.signal)
+                : undefined;
+    }
+    ready() {
+        return this.readyPromise;
+    }
+    /** Stops intake, drains active handlers, and joins background work. */
+    async shutdown() {
+        this.shutdownController.abort("agent shutdown");
+        this.consolidationController.abort("agent shutdown");
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => {
+                resolve("timeout");
+            }, this.shutdownGraceMs);
+        });
+        const outcome = await Promise.race([this.task, timeout]);
+        if (timer !== undefined)
+            clearTimeout(timer);
+        if (outcome === "timeout") {
+            this.hardStopped = true;
+            throw new TimeoutError("agent shutdown drain");
+        }
+        if (outcome.kind === "error")
+            throw outcome.error;
+        await this.consolidationTask;
+    }
+    /** Delegates async disposal to `shutdown()`. */
+    [Symbol.asyncDispose]() {
+        return this.shutdown();
+    }
+    async join() {
+        const outcome = await this.task;
+        this.consolidationController.abort("agent stopped");
+        await this.consolidationTask;
+        if (outcome.kind === "error")
+            throw outcome.error;
+    }
+    abort() {
+        this.hardStopped = true;
+        this.hardStopController.abort("agent abort");
+        this.shutdownController.abort("agent abort");
+        this.consolidationController.abort("agent abort");
+    }
+    async runConsolidation(everyMs, consolidator, signal) {
+        while (!signal.aborted) {
+            try {
+                await consolidator.consolidate({});
+            }
+            catch {
+                // Consolidation is best effort and must not stop message handling.
+            }
+            await this.waitForConsolidationInterval(everyMs, signal);
+        }
+    }
+    waitForConsolidationInterval(everyMs, signal) {
+        if (signal.aborted)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const onAbort = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            const timer = setTimeout(() => {
+                signal.removeEventListener("abort", onAbort);
+                resolve();
+            }, everyMs);
+            signal.addEventListener("abort", onAbort, { once: true });
+        });
+    }
+    async run(definition, laser) {
+        try {
+            const scoped = definition.governor !== undefined && definition.governorMode !== undefined
+                ? laser.withGovernor(definition.governor, definition.governorMode)
+                : laser;
+            if (definition.capabilities.length > 0) {
+                await scoped.agent(definition.id).advertise(definition.listenOn, definition.capabilities);
+            }
+            const consumer = new ReliableConsumer({
+                group: definition.consumerGroup ?? ConsumerGroupName.forAgent(definition.id),
+                topic: definition.listenOn,
+                agent: definition.id,
+                ...(definition.respondOn !== undefined ? { respondOn: definition.respondOn } : {}),
+                ...(definition.inboxRoute !== undefined ? { inboxRoute: definition.inboxRoute } : {}),
+                ...(definition.pollIntervalMs !== undefined
+                    ? { pollIntervalMs: definition.pollIntervalMs }
+                    : {}),
+                ...(definition.concurrency !== undefined ? { concurrency: definition.concurrency } : {}),
+                ...(definition.deadLetterSink !== undefined
+                    ? { deadLetterSink: definition.deadLetterSink }
+                    : {}),
+                ...(definition.dedupWindow !== undefined ? { dedupWindow: definition.dedupWindow } : {}),
+                ...(definition.retry !== undefined ? { retry: definition.retry } : {}),
+                ...(definition.deduplicator !== undefined ? { deduplicator: definition.deduplicator } : {}),
+                warmDedup: definition.warmDedup,
+                middleware: definition.middleware,
+                ackOnPickup: definition.ackOnPickup,
+                ...(definition.verifier !== undefined ? { verifier: definition.verifier } : {}),
+                ...(definition.signingKey !== undefined ? { signingKey: definition.signingKey } : {})
+            });
+            await consumer.run(scoped, definition.handler, {
+                signal: this.shutdownController.signal,
+                hardSignal: this.hardStopController.signal,
+                hardAborted: () => this.hardStopped,
+                ready: () => {
+                    this.readySettled = true;
+                    this.resolveReady();
+                }
+            });
+            if (!this.readySettled)
+                this.resolveReady();
+            return { kind: "ok" };
+        }
+        catch (error) {
+            if (!this.readySettled) {
+                this.readySettled = true;
+                this.rejectReady(error);
+            }
+            return { kind: "error", error };
+        }
+    }
+}
+export class AgentBuilder {
+    agentId;
+    group;
+    listenTopic;
+    replyTopic;
+    agentHandler;
+    route;
+    pollMs;
+    graceMs = 30_000;
+    concurrencyPolicy;
+    shouldWarmDedup = false;
+    middlewareList = [];
+    sink;
+    window;
+    retryPolicy;
+    dedup;
+    advertisedCapabilities = [];
+    pickupAck = false;
+    signatureVerifier;
+    signer;
+    actionGovernor;
+    mode;
+    consolidationIntervalMs;
+    memoryConsolidator;
+    id(id) {
+        this.agentId = id;
+        return this;
+    }
+    consumerGroup(group) {
+        this.group = group;
+        return this;
+    }
+    listenOn(topic) {
+        this.listenTopic = topic;
+        return this;
+    }
+    respondOn(topic) {
+        this.replyTopic = topic;
+        return this;
+    }
+    handler(handler) {
+        this.agentHandler = handler;
+        return this;
+    }
+    inboxRoute(route) {
+        this.route = route;
+        return this;
+    }
+    pollInterval(ms) {
+        this.pollMs = ms;
+        return this;
+    }
+    shutdownGrace(ms) {
+        this.graceMs = ms;
+        return this;
+    }
+    concurrency(policy) {
+        this.concurrencyPolicy = policy;
+        return this;
+    }
+    warmDedup(value = true) {
+        this.shouldWarmDedup = value;
+        return this;
+    }
+    middleware(middleware) {
+        this.middlewareList.push(middleware);
+        return this;
+    }
+    deadLetterSink(sink) {
+        this.sink = sink;
+        return this;
+    }
+    dedupWindow(size) {
+        this.window = size;
+        return this;
+    }
+    retry(retry) {
+        this.retryPolicy = retry;
+        return this;
+    }
+    deduplicator(deduplicator) {
+        this.dedup = deduplicator;
+        return this;
+    }
+    capabilities(capabilities) {
+        this.advertisedCapabilities = capabilities;
+        return this;
+    }
+    ackOnPickup(value = true) {
+        this.pickupAck = value;
+        return this;
+    }
+    verifier(verifier) {
+        this.signatureVerifier = verifier;
+        return this;
+    }
+    signingKey(signingKey) {
+        this.signer = signingKey;
+        return this;
+    }
+    governor(governor, mode) {
+        this.actionGovernor = governor;
+        this.mode = mode;
+        return this;
+    }
+    consolidateEvery(milliseconds) {
+        this.consolidationIntervalMs = milliseconds;
+        return this;
+    }
+    consolidator(consolidator) {
+        this.memoryConsolidator = consolidator;
+        return this;
+    }
+    spawn(laser) {
+        if (this.agentId === undefined)
+            throw new HandlerConfigError("Agent.builder().id() is required");
+        if (this.listenTopic === undefined) {
+            throw new HandlerConfigError("Agent.builder().listenOn() is required");
+        }
+        if (this.agentHandler === undefined) {
+            throw new HandlerConfigError("Agent.builder().handler() is required");
+        }
+        if (!Number.isFinite(this.graceMs) || this.graceMs < 0) {
+            throw new HandlerConfigError("shutdownGrace must be a non-negative finite number");
+        }
+        if (this.pollMs !== undefined && (!Number.isFinite(this.pollMs) || this.pollMs < 0)) {
+            throw new HandlerConfigError("pollInterval must be a non-negative finite number");
+        }
+        if (this.window !== undefined && (!Number.isSafeInteger(this.window) || this.window < 1)) {
+            throw new HandlerConfigError("dedupWindow must be a positive safe integer");
+        }
+        if (this.retryPolicy !== undefined &&
+            (!Number.isSafeInteger(this.retryPolicy.maxAttempts) || this.retryPolicy.maxAttempts < 1)) {
+            throw new HandlerConfigError("retry maxAttempts must be a positive safe integer");
+        }
+        if (this.consolidationIntervalMs !== undefined &&
+            (!Number.isFinite(this.consolidationIntervalMs) || this.consolidationIntervalMs <= 0)) {
+            throw new HandlerConfigError("consolidateEvery must be a positive finite number");
+        }
+        if (this.retryPolicy !== undefined &&
+            (!Number.isFinite(this.retryPolicy.baseDelayMs) || this.retryPolicy.baseDelayMs < 0)) {
+            throw new HandlerConfigError("retry baseDelayMs must be a non-negative finite number");
+        }
+        if (this.concurrencyPolicy?.kind === "serial-per-partition" &&
+            (!Number.isSafeInteger(this.concurrencyPolicy.maxPartitions) ||
+                this.concurrencyPolicy.maxPartitions < 1)) {
+            throw new HandlerConfigError("maxPartitions must be a positive safe integer");
+        }
+        return new AgentHandle({
+            id: this.agentId,
+            ...(this.group !== undefined ? { consumerGroup: this.group } : {}),
+            listenOn: this.listenTopic,
+            handler: this.agentHandler,
+            ...(this.replyTopic !== undefined ? { respondOn: this.replyTopic } : {}),
+            ...(this.route !== undefined ? { inboxRoute: this.route } : {}),
+            ...(this.pollMs !== undefined ? { pollIntervalMs: this.pollMs } : {}),
+            shutdownGraceMs: this.graceMs,
+            ...(this.concurrencyPolicy !== undefined ? { concurrency: this.concurrencyPolicy } : {}),
+            warmDedup: this.shouldWarmDedup,
+            middleware: [...this.middlewareList],
+            ...(this.sink !== undefined ? { deadLetterSink: this.sink } : {}),
+            ...(this.window !== undefined ? { dedupWindow: this.window } : {}),
+            ...(this.retryPolicy !== undefined ? { retry: this.retryPolicy } : {}),
+            ...(this.dedup !== undefined ? { deduplicator: this.dedup } : {}),
+            capabilities: this.advertisedCapabilities,
+            ackOnPickup: this.pickupAck,
+            ...(this.signatureVerifier !== undefined ? { verifier: this.signatureVerifier } : {}),
+            ...(this.signer !== undefined ? { signingKey: this.signer } : {}),
+            ...(this.actionGovernor !== undefined ? { governor: this.actionGovernor } : {}),
+            ...(this.mode !== undefined ? { governorMode: this.mode } : {}),
+            ...(this.consolidationIntervalMs !== undefined
+                ? { consolidateEveryMs: this.consolidationIntervalMs }
+                : {}),
+            ...(this.memoryConsolidator !== undefined ? { consolidator: this.memoryConsolidator } : {})
+        }, laser);
+    }
+}
+export const Agent = {
+    builder() {
+        return new AgentBuilder();
+    }
+};
+//# sourceMappingURL=builder.js.map

package/dist/agent/builder.js.map

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

package/dist/agent/context.d.ts

@@ -0,0 +1,68 @@
+import { type LaserError } from "../client/errors.js";
+import type { BytesLike } from "../client/bytes.js";
+import type { Laser } from "../client/laser.js";
+import type { Provenance } from "../provenance/provenance.js";
+import type { AgentId } from "../types/ids.js";
+import type { SigningKey } from "../signing.js";
+import type { AgentMessage } from "./reliable-consumer.js";
+import { type CapabilitySelector, type InboxRoute } from "./router.js";
+/** Determines when a fan-out gather completes. */
+export type GatherPolicy = 
+/** Wait for every branch, bounded by the deadline. */
+{
+    readonly kind: "requireAll";
+}
+/** Stop after the requested number of branches succeed. */
+ | {
+    readonly kind: "quorum";
+    readonly needed: number;
+}
+/** Collect the branches completed before the deadline. */
+ | {
+    readonly kind: "bestEffort";
+};
+export declare const REQUIRE_ALL: GatherPolicy;
+export declare const BEST_EFFORT: GatherPolicy;
+export declare function quorumOf(needed: number): GatherPolicy;
+/** Attributed replies and failures from a fan-out gather. */
+export interface Gather {
+    /** Successful replies paired with their agents. */
+    readonly ok: readonly (readonly [AgentId, AgentMessage])[];
+    /** Failed branches paired with their agents. */
+    readonly failures: readonly (readonly [AgentId, LaserError])[];
+}
+export declare function emptyGather(): Gather;
+/** Returns successful replies without agent attribution. */
+export declare function gatherReplies(gather: Gather): readonly AgentMessage[];
+/** Reports whether a quorum policy is satisfied. */
+export declare function quorumSatisfied(policy: GatherPolicy, successes: number): boolean;
+export interface AgentContextOptions {
+    readonly agent?: AgentId;
+    readonly respondOn?: string;
+    readonly inboxRoute?: InboxRoute;
+    readonly signingKey?: SigningKey;
+    /** Time source for deterministic presence checks. */
+    readonly nowMicros?: () => bigint;
+}
+export declare class AgentContext {
+    readonly laser: Laser;
+    readonly message: AgentMessage;
+    readonly agent: AgentId | undefined;
+    readonly respondOn: string | undefined;
+    readonly inboxRoute: InboxRoute;
+    private readonly signingKey;
+    private readonly nowMicros;
+    constructor(laser: Laser, message: AgentMessage, options?: AgentContextOptions);
+    respond(payload: BytesLike): Promise<void>;
+    replyOn(topic: string, payload: BytesLike): Promise<void>;
+    send(topic: string, payload: BytesLike, provenance: Provenance): Promise<void>;
+    request(requestTopic: string, replyTopic: string, payload: BytesLike, provenance: Provenance, timeoutMs: number, signal?: AbortSignal): Promise<AgentMessage>;
+    respondInput(replyTopic: string, response: BytesLike): Promise<void>;
+    approvalGate(replyTopic: string, prompt: BytesLike, timeoutMs: number, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<Uint8Array>;
+    spawnSubconversation(): Provenance;
+    fanOut(selector: CapabilitySelector, payload: BytesLike, policy: GatherPolicy, deadlineMs: number): Promise<Gather>;
+    private replyProvenance;
+}
+//# sourceMappingURL=context.d.ts.map

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

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