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

package/dist/agent/context.js

@@ -0,0 +1,212 @@
+import { HandlerConfigError, HandlerError, InvalidError } from "../client/errors.js";
+import { AgentTopic } from "../provenance/agent-topic.js";
+import { ADVERTISED_INBOX_ROUTE, resolveInboxRoute, resolveTargets } from "./router.js";
+export const REQUIRE_ALL = { kind: "requireAll" };
+export const BEST_EFFORT = { kind: "bestEffort" };
+export function quorumOf(needed) {
+    if (!Number.isSafeInteger(needed) || needed < 0) {
+        throw new InvalidError("quorum must be a non-negative safe integer");
+    }
+    return { kind: "quorum", needed };
+}
+export function emptyGather() {
+    return { ok: [], failures: [] };
+}
+/** Returns successful replies without agent attribution. */
+export function gatherReplies(gather) {
+    return gather.ok.map(([, message]) => message);
+}
+/** Reports whether a quorum policy is satisfied. */
+export function quorumSatisfied(policy, successes) {
+    return policy.kind === "quorum" && successes >= policy.needed;
+}
+function asLaserError(error) {
+    if (error instanceof Error && "kind" in error)
+        return error;
+    return new HandlerError("fan-out branch failed", { cause: error });
+}
+function deadlineTimer(ms) {
+    let timer;
+    const promise = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            resolve("deadline");
+        }, ms);
+    });
+    return {
+        promise,
+        cancel: () => {
+            clearTimeout(timer);
+        }
+    };
+}
+async function gatherBranches(branches, seed, policy, deadlineMs) {
+    const ok = [...seed.ok];
+    const failures = [...seed.failures];
+    const pending = new Map(branches.map((branch, index) => [index, branch]));
+    if (quorumSatisfied(policy, 0)) {
+        for (const branch of pending.values())
+            branch.controller.abort();
+        return { ok, failures };
+    }
+    const deadline = policy.kind === "bestEffort" ? deadlineTimer(deadlineMs) : undefined;
+    while (pending.size > 0) {
+        const settled = [...pending].map(([index, branch]) => branch.result.then((result) => ({ kind: "branch", index, result })));
+        const next = deadline !== undefined
+            ? await Promise.race([...settled, deadline.promise])
+            : await Promise.race(settled);
+        if (next === "deadline") {
+            for (const branch of pending.values())
+                branch.controller.abort();
+            break;
+        }
+        pending.delete(next.index);
+        if (next.result.kind === "ok") {
+            ok.push([next.result.agent, next.result.message]);
+        }
+        else {
+            failures.push([next.result.agent, next.result.error]);
+        }
+        if (quorumSatisfied(policy, ok.length)) {
+            for (const branch of pending.values())
+                branch.controller.abort();
+            break;
+        }
+    }
+    deadline?.cancel();
+    return { ok, failures };
+}
+export class AgentContext {
+    laser;
+    message;
+    agent;
+    respondOn;
+    inboxRoute;
+    signingKey;
+    nowMicros;
+    constructor(laser, message, options = {}) {
+        this.laser = laser;
+        this.message = message;
+        this.agent = options.agent;
+        this.respondOn = options.respondOn;
+        this.inboxRoute = options.inboxRoute ?? ADVERTISED_INBOX_ROUTE;
+        this.signingKey = options.signingKey;
+        this.nowMicros = options.nowMicros ?? (() => BigInt(Date.now()) * 1000n);
+    }
+    async respond(payload) {
+        const topic = this.respondOn;
+        if (topic === undefined) {
+            throw new HandlerConfigError("respond() requires the agent to configure respondOn");
+        }
+        const sender = this.message.provenance.agent;
+        const envelope = this.message.envelope;
+        if (this.signingKey !== undefined &&
+            envelope?.correlation !== undefined &&
+            this.agent !== undefined) {
+            let response = this.laser
+                .agdx(topic, this.agent, this.message.provenance.conversationId)
+                .respond(envelope.correlation, payload)
+                .signedBy(this.signingKey);
+            if (sender !== undefined)
+                response = response.withTarget(sender);
+            await response.send();
+            return;
+        }
+        const provenance = {
+            ...this.replyProvenance(),
+            ...(sender !== undefined ? { targetAgentId: sender } : {})
+        };
+        await this.laser.sendAgent(topic, payload, provenance);
+    }
+    async replyOn(topic, payload) {
+        await this.laser.sendAgent(topic, payload, this.replyProvenance());
+    }
+    async send(topic, payload, provenance) {
+        await this.laser.sendAgent(topic, payload, provenance);
+    }
+    request(requestTopic, replyTopic, payload, provenance, timeoutMs, signal) {
+        return this.laser.request(requestTopic, replyTopic, payload, provenance, timeoutMs, signal);
+    }
+    async respondInput(replyTopic, response) {
+        const envelope = this.message.envelope;
+        if (envelope === undefined) {
+            throw new HandlerConfigError("respondInput(): the handled message is not an AGDX envelope");
+        }
+        if (envelope.correlation === undefined) {
+            throw new HandlerConfigError("respondInput(): the interrupt carries no correlation");
+        }
+        if (this.agent === undefined) {
+            throw new HandlerConfigError("respondInput(): the agent has no id");
+        }
+        await this.laser
+            .agdx(replyTopic, this.agent, this.message.provenance.conversationId)
+            .respond(envelope.correlation, response)
+            .send();
+    }
+    approvalGate(replyTopic, prompt, timeoutMs, options) {
+        if (this.agent === undefined) {
+            throw new HandlerConfigError("approvalGate(): the agent has no id");
+        }
+        return this.laser
+            .agdx(AgentTopic.HumanInput, this.agent, this.message.provenance.conversationId)
+            .requestInput(replyTopic, prompt, timeoutMs, options);
+    }
+    spawnSubconversation() {
+        return this.laser.spawnSubconversation(this.message.provenance);
+    }
+    async fanOut(selector, payload, policy, deadlineMs) {
+        if (!Number.isFinite(deadlineMs) || deadlineMs < 0) {
+            throw new InvalidError("fanOut() deadline must be a non-negative finite number");
+        }
+        const replyTopic = this.respondOn;
+        if (replyTopic === undefined) {
+            throw new HandlerConfigError("fanOut() requires the agent to configure respondOn");
+        }
+        const registry = await this.laser.agentRegistry();
+        const nowMicros = this.nowMicros();
+        await registry.refresh(nowMicros);
+        if (this.inboxRoute.kind === "advertised" || selector.principal !== undefined) {
+            await registry.refreshPresence();
+        }
+        const targets = resolveTargets({ kind: "allCapable", selector }, registry, nowMicros);
+        const failures = [];
+        const branches = [];
+        for (const target of targets) {
+            let inbox;
+            try {
+                inbox = resolveInboxRoute(this.inboxRoute, target, registry.inboxFor(target));
+            }
+            catch (error) {
+                failures.push([target, asLaserError(error)]);
+                continue;
+            }
+            const controller = new AbortController();
+            const provenance = {
+                ...this.laser.spawnSubconversation(this.message.provenance),
+                targetAgentId: target
+            };
+            const result = this.laser
+                .request(inbox, replyTopic, payload, provenance, deadlineMs, controller.signal)
+                .then((message) => ({ kind: "ok", agent: target, message }))
+                .catch((error) => ({
+                kind: "error",
+                agent: target,
+                error: asLaserError(error)
+            }));
+            branches.push({ controller, result });
+        }
+        return gatherBranches(branches, { ok: [], failures }, policy, deadlineMs);
+    }
+    replyProvenance() {
+        const provenance = this.message.provenance;
+        return {
+            conversationId: provenance.conversationId,
+            causalParent: this.message.id,
+            ...(this.agent !== undefined ? { agent: this.agent } : {}),
+            ...(provenance.rootConversationId !== undefined
+                ? { rootConversationId: provenance.rootConversationId }
+                : {}),
+            ...(provenance.correlationId !== undefined ? { correlationId: provenance.correlationId } : {})
+        };
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/agent/context.js.map

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

package/dist/agent/contract.d.ts

@@ -0,0 +1,70 @@
+import { type BytesLike } from "../client/bytes.js";
+import { type LaserError } from "../client/errors.js";
+import type { Laser } from "../client/laser.js";
+import { ConversationId, type AgentId } from "../types/ids.js";
+import { type TaskState } from "../wire/agent.js";
+import { type AgentMessage } from "./reliable-consumer.js";
+import { type CapabilitySelector, type InboxRoute, type Router } from "./router.js";
+export type Contract = {
+    readonly kind: "completed";
+    readonly reply: AgentMessage;
+} | {
+    readonly kind: "failed";
+    readonly reply: AgentMessage;
+} | {
+    readonly kind: "notConsumed";
+} | {
+    readonly kind: "timedOut";
+};
+export interface ScatterOutcome {
+    readonly agent: AgentId;
+    readonly result: {
+        readonly kind: "ok";
+        readonly contract: Contract;
+    } | {
+        readonly kind: "err";
+        readonly error: LaserError;
+    };
+}
+export declare class ScatterReport {
+    readonly outcomes: readonly ScatterOutcome[];
+    constructor(outcomes: readonly ScatterOutcome[]);
+    completed(): readonly {
+        readonly agent: AgentId;
+        readonly reply: AgentMessage;
+    }[];
+    failures(): readonly {
+        readonly agent: AgentId;
+        readonly error: LaserError;
+    }[];
+}
+export declare function markRun(laser: Laser, source: AgentId, conversation: ConversationId, run: string, state: TaskState, detail?: string): Promise<void>;
+export declare class ContractBuilder {
+    private readonly laser;
+    private readonly router;
+    private readonly nowMicros;
+    private source;
+    private body;
+    private route;
+    private replyTopic;
+    private expiryMs;
+    private deadlineMs;
+    private fenceToken;
+    private conversationId;
+    private registerRun;
+    constructor(laser: Laser, router: Router, nowMicros?: () => bigint);
+    from(source: AgentId): this;
+    payload(payload: BytesLike): this;
+    inboxRoute(route: InboxRoute): this;
+    replyOn(topic: string): this;
+    expireIfNotConsumed(expiryMs: number): this;
+    deadline(deadlineMs: number): this;
+    conversation(conversation: ConversationId): this;
+    fence(fence: bigint): this;
+    registered(): this;
+    send(): Promise<Contract>;
+    private watch;
+}
+export declare function scatterReport(laser: Laser, source: AgentId, selector: CapabilitySelector, payload: BytesLike, inboxRoute: InboxRoute, deadlineMs: number, nowMicros?: bigint): Promise<ScatterReport>;
+export declare function scatter(laser: Laser, source: AgentId, selector: CapabilitySelector, payload: BytesLike, inboxRoute: InboxRoute, deadlineMs: number, nowMicros?: bigint): Promise<readonly Uint8Array[]>;
+//# sourceMappingURL=contract.d.ts.map

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

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

package/dist/agent/contract.js

@@ -0,0 +1,268 @@
+import { ownedBytes } from "../client/bytes.js";
+import { InvalidError, TimeoutError, UnsupportedError } from "../client/errors.js";
+import { INTERNAL_REPLY_HUB, INTERNAL_VERIFIER } from "../client/internals.js";
+import { AgentTopic } from "../provenance/agent-topic.js";
+import { ConversationId } from "../types/ids.js";
+import { AgentKind, METADATA_RUN, OPERATION_TASK } from "../wire/agent.js";
+import { FENCE } from "../wire/headers.js";
+import { CorrelationId } from "../wire/ids.js";
+import { agentMessageBody } from "./reliable-consumer.js";
+import { ADVERTISED_INBOX_ROUTE, requiredPrincipal, resolveInboxRoute, resolveTargets, routeRequiresPresence, routeTo } from "./router.js";
+const DEFAULT_DEADLINE_MS = 30_000;
+export class ScatterReport {
+    outcomes;
+    constructor(outcomes) {
+        this.outcomes = outcomes;
+    }
+    completed() {
+        return this.outcomes.flatMap((outcome) => outcome.result.kind === "ok" && outcome.result.contract.kind === "completed"
+            ? [{ agent: outcome.agent, reply: outcome.result.contract.reply }]
+            : []);
+    }
+    failures() {
+        return this.outcomes.flatMap((outcome) => outcome.result.kind === "err" ? [{ agent: outcome.agent, error: outcome.result.error }] : []);
+    }
+}
+function duration(name, value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new InvalidError(`${name} must be a non-negative finite number`);
+    }
+    return value;
+}
+async function resolveContract(laser, router, inboxRoute, nowMicros) {
+    if (router.kind === "broadcast" || router.kind === "allCapable") {
+        throw new InvalidError("a contract is directed to one agent, not a broadcast or all-capable route");
+    }
+    const registry = await laser.agentRegistry();
+    await registry.refresh(nowMicros);
+    if (inboxRoute.kind === "advertised" || routeRequiresPresence(router)) {
+        await registry.refreshPresence();
+    }
+    const target = resolveTargets(router, registry, nowMicros)[0];
+    if (target === undefined)
+        throw new InvalidError("the contract route resolved no target");
+    const inbox = resolveInboxRoute(inboxRoute, target, registry.inboxFor(target));
+    return {
+        target,
+        inbox,
+        expectedSigner: requiredPrincipal(router)?.toString() ?? target.asString()
+    };
+}
+function acceptsReply(laser, message, expectedSigner) {
+    const verifier = laser[INTERNAL_VERIFIER]();
+    if (verifier === undefined)
+        return message;
+    const envelope = message.envelope;
+    if (envelope === undefined)
+        return undefined;
+    try {
+        const principal = verifier.verify(envelope);
+        return principal === expectedSigner ? { ...message, verifiedPrincipal: principal } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isWorking(envelope) {
+    return (envelope?.kind === AgentKind.Status &&
+        envelope.taskState?.kind === "known" &&
+        envelope.taskState.name === "Working");
+}
+export async function markRun(laser, source, conversation, run, state, detail) {
+    const correlation = CorrelationId.parse(conversation.toString());
+    let status = laser
+        .agdx(AgentTopic.Responses, source, conversation)
+        .status(OPERATION_TASK)
+        .withCorrelation(correlation)
+        .withTaskState(state)
+        .withMetadata(METADATA_RUN, { kind: "string", value: run });
+    if (detail !== undefined) {
+        status = status.withMetadata("detail", { kind: "string", value: detail });
+    }
+    await status.send();
+}
+export class ContractBuilder {
+    laser;
+    router;
+    nowMicros;
+    source;
+    body = new Uint8Array();
+    route = ADVERTISED_INBOX_ROUTE;
+    replyTopic = AgentTopic.Responses;
+    expiryMs;
+    deadlineMs = DEFAULT_DEADLINE_MS;
+    fenceToken;
+    conversationId;
+    registerRun = false;
+    constructor(laser, router, nowMicros = () => BigInt(Date.now()) * 1000n) {
+        this.laser = laser;
+        this.router = router;
+        this.nowMicros = nowMicros;
+    }
+    from(source) {
+        this.source = source;
+        return this;
+    }
+    payload(payload) {
+        this.body = ownedBytes(payload);
+        return this;
+    }
+    inboxRoute(route) {
+        this.route = route;
+        return this;
+    }
+    replyOn(topic) {
+        this.replyTopic = topic;
+        return this;
+    }
+    expireIfNotConsumed(expiryMs) {
+        this.expiryMs = duration("contract consumption expiry", expiryMs);
+        return this;
+    }
+    deadline(deadlineMs) {
+        this.deadlineMs = duration("contract completion deadline", deadlineMs);
+        return this;
+    }
+    conversation(conversation) {
+        this.conversationId = conversation;
+        return this;
+    }
+    fence(fence) {
+        if (fence < 0n || fence > 0xffffffffffffffffn) {
+            throw new InvalidError("contract fence must be an unsigned 64-bit integer");
+        }
+        this.fenceToken = fence;
+        return this;
+    }
+    registered() {
+        this.registerRun = true;
+        return this;
+    }
+    async send() {
+        const source = this.source;
+        if (source === undefined) {
+            throw new InvalidError("a contract requires `.from(source agent id)`");
+        }
+        if (this.registerRun && !(await this.laser.capabilities()).agentWorkflow) {
+            throw new UnsupportedError("a registered contract requires a plane that serves the run registry");
+        }
+        const resolved = await resolveContract(this.laser, this.router, this.route, this.nowMicros());
+        const conversation = this.conversationId ?? ConversationId.new();
+        const actualCorrelation = CorrelationId.parse(ConversationId.new().toString());
+        const hub = await this.laser[INTERNAL_REPLY_HUB](this.replyTopic);
+        const ticket = hub.subscribeStream(actualCorrelation.toString());
+        let run;
+        try {
+            if (this.registerRun) {
+                run = (await this.laser.runs().submitWith(resolved.target.asString(), { input: this.body }))
+                    .runId;
+            }
+            let command = this.laser
+                .agdx(resolved.inbox, source, conversation)
+                .command(actualCorrelation, this.body)
+                .withTarget(resolved.target);
+            if (this.fenceToken !== undefined) {
+                command = command.withMetadata(FENCE, { kind: "int", value: this.fenceToken });
+            }
+            if (run !== undefined)
+                command = command.withMetadata(METADATA_RUN, { kind: "string", value: run });
+            if (this.expiryMs !== undefined) {
+                command = command.withDeadlineMicros(this.nowMicros() + BigInt(this.expiryMs) * 1000n);
+            }
+            await command.send();
+            if (run !== undefined) {
+                await markRun(this.laser, source, conversation, run, { kind: "known", name: "Working" });
+            }
+            const outcome = await this.watch(ticket, resolved.expectedSigner);
+            if (run !== undefined) {
+                const state = outcome.kind === "completed" ? "Completed" : "Failed";
+                const detail = outcome.kind === "failed"
+                    ? "the target replied with a terminal error"
+                    : outcome.kind === "notConsumed"
+                        ? "the command was not consumed within the expiry"
+                        : outcome.kind === "timedOut"
+                            ? "no terminal reply landed within the deadline"
+                            : undefined;
+                await markRun(this.laser, source, conversation, run, { kind: "known", name: state }, detail);
+            }
+            return outcome;
+        }
+        finally {
+            ticket.cancel();
+        }
+    }
+    async watch(ticket, expectedSigner) {
+        const started = performance.now();
+        let consumed = false;
+        for (;;) {
+            const elapsed = performance.now() - started;
+            if (!consumed && this.expiryMs !== undefined && elapsed >= this.expiryMs) {
+                return { kind: "notConsumed" };
+            }
+            if (elapsed >= this.deadlineMs)
+                return { kind: "timedOut" };
+            const nextBoundary = Math.min(this.deadlineMs - elapsed, !consumed && this.expiryMs !== undefined
+                ? this.expiryMs - elapsed
+                : Number.POSITIVE_INFINITY);
+            try {
+                const candidate = await ticket.next(Math.max(0, nextBoundary));
+                const reply = acceptsReply(this.laser, candidate, expectedSigner);
+                if (reply === undefined)
+                    continue;
+                const envelope = reply.envelope;
+                if (isWorking(envelope)) {
+                    consumed = true;
+                    continue;
+                }
+                if (envelope === undefined || envelope.kind === AgentKind.Response) {
+                    return { kind: "completed", reply };
+                }
+                if (envelope.kind === AgentKind.Error)
+                    return { kind: "failed", reply };
+            }
+            catch (error) {
+                if (!(error instanceof TimeoutError))
+                    throw error;
+            }
+        }
+    }
+}
+export async function scatterReport(laser, source, selector, payload, inboxRoute, deadlineMs, nowMicros = BigInt(Date.now()) * 1000n) {
+    duration("scatter deadline", deadlineMs);
+    const registry = await laser.agentRegistry();
+    await registry.refresh(nowMicros);
+    if (inboxRoute.kind === "advertised" || selector.principal !== undefined) {
+        await registry.refreshPresence();
+    }
+    const agents = resolveTargets({ kind: "allCapable", selector }, registry, nowMicros);
+    const outcomes = [];
+    await Promise.all(agents.map(async (agent) => {
+        try {
+            const contract = await laser
+                .contract(routeTo(agent))
+                .from(source)
+                .payload(payload)
+                .inboxRoute(inboxRoute)
+                .deadline(deadlineMs)
+                .send();
+            outcomes.push({ agent, result: { kind: "ok", contract } });
+        }
+        catch (error) {
+            outcomes.push({
+                agent,
+                result: {
+                    kind: "err",
+                    error: error instanceof Error && "kind" in error
+                        ? error
+                        : new InvalidError(String(error))
+                }
+            });
+        }
+    }));
+    return new ScatterReport(outcomes);
+}
+export async function scatter(laser, source, selector, payload, inboxRoute, deadlineMs, nowMicros = BigInt(Date.now()) * 1000n) {
+    const report = await scatterReport(laser, source, selector, payload, inboxRoute, deadlineMs, nowMicros);
+    return report.completed().map(({ reply }) => agentMessageBody(reply));
+}
+//# sourceMappingURL=contract.js.map

package/dist/agent/contract.js.map

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