@chipschat/conformance 0.0.0-stage → 1.0.0

package/dist/settings.d.ts

@@ -0,0 +1,60 @@
+/**
+ * What a person changes about an agent from its page (ADRs 0134, 0140, 0143, 0146), and about a
+ * harness's own jobs from its page (ADR 0252), as the fake plays it. A harness's copies are taken whole and checked against the protocol's own schemas, as
+ * the real door checks them; the answer a copy carries is kept; and a person's change is a frame
+ * built from the copy as it stands. The kit asks for what the copy already says (the same model,
+ * the same heartbeat, the same limit, the same text), so a harness that answers changes nothing
+ * it would not have, and one that refuses has said why.
+ */
+import { type IdGenerator } from "@chipschat/protocol";
+/** One of the four copies, the harness's own shared files beside an agent's, and its own jobs. */
+export type SettingKind = "context" | "harness-context" | "model" | "heartbeat" | "context-window" | "jobs";
+/** What a socket says in its `hello` to be sent a kind's frames. */
+export declare const ACCEPTS: Readonly<Record<SettingKind, string>>;
+/** A copy's answer to a person's change: made, or refused with the harness's words. */
+export interface SettingAnswer {
+    readonly kind: SettingKind;
+    readonly id: string;
+    readonly changeId: string;
+    readonly made: boolean;
+    readonly message?: string | undefined;
+}
+export type PutOutcome = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly message: string;
+    readonly issues: readonly {
+        path: string;
+        message: string;
+    }[];
+};
+type Copy = Readonly<Record<string, unknown>>;
+/** The people and clocks a frame names. */
+export interface Asker {
+    readonly ids: IdGenerator;
+    readonly harnessId: string;
+    readonly ownerId: string;
+    readonly now: string;
+}
+export declare class FakeSettings {
+    /** The copy last taken for each `kind:id`, without its answer. */
+    private readonly copies;
+    /** Every answer a copy carried, oldest first. */
+    readonly answers: SettingAnswer[];
+    /** A copy sent: checked, kept, and its answer, if it carries one, noted. */
+    put(kind: SettingKind, id: string, body: unknown): PutOutcome;
+    copy(kind: SettingKind, id: string): Copy | undefined;
+    /** Every copy of a kind, by whose it is. */
+    copiesOf(kind: SettingKind): (readonly [id: string, copy: Copy])[];
+    answerTo(changeId: string): SettingAnswer | undefined;
+    /**
+     * The change a person would ask of a copy as it stands, as the frame the harness is sent, or
+     * nothing when the copy offers nothing to change: no file with its text.
+     */
+    askOf(kind: SettingKind, id: string, asker: Asker): Record<string, unknown> | undefined;
+    /** A file saved as it is: an agent's, or one of the harness's own set. */
+    private editOf;
+}
+export {};
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAE7B,kGAAkG;AAClG,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,iBAAiB,GACjB,OAAO,GACP,WAAW,GACX,gBAAgB,GAChB,MAAM,CAAC;AAEX,oEAAoE;AACpE,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAOzD,CAAC;AAWF,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/D,CAAC;AAEN,KAAK,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9C,2CAA2C;AAC3C,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,CAAM;IAEvC,4EAA4E;IAC5E,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,UAAU;IA0B7D,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrD,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE;IAOlE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIrD;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAmDvF,0EAA0E;IAC1E,OAAO,CAAC,MAAM;CAsBf"}

package/dist/settings.js

@@ -0,0 +1,142 @@
+/**
+ * What a person changes about an agent from its page (ADRs 0134, 0140, 0143, 0146), and about a
+ * harness's own jobs from its page (ADR 0252), as the fake plays it. A harness's copies are taken whole and checked against the protocol's own schemas, as
+ * the real door checks them; the answer a copy carries is kept; and a person's change is a frame
+ * built from the copy as it stands. The kit asks for what the copy already says (the same model,
+ * the same heartbeat, the same limit, the same text), so a harness that answers changes nothing
+ * it would not have, and one that refuses has said why.
+ */
+import { agentContextPut, agentContextWindowPut, agentHeartbeatPut, agentModelPut, harnessContextPut, harnessJobsPut, } from "@chipschat/protocol";
+/** What a socket says in its `hello` to be sent a kind's frames. */
+export const ACCEPTS = {
+    context: "context",
+    "harness-context": "context",
+    model: "models",
+    heartbeat: "heartbeats",
+    "context-window": "context_windows",
+    jobs: "jobs",
+};
+const SCHEMAS = {
+    context: agentContextPut,
+    "harness-context": harnessContextPut,
+    model: agentModelPut,
+    heartbeat: agentHeartbeatPut,
+    "context-window": agentContextWindowPut,
+    jobs: harnessJobsPut,
+};
+export class FakeSettings {
+    /** The copy last taken for each `kind:id`, without its answer. */
+    copies = new Map();
+    /** Every answer a copy carried, oldest first. */
+    answers = [];
+    /** A copy sent: checked, kept, and its answer, if it carries one, noted. */
+    put(kind, id, body) {
+        const parsed = SCHEMAS[kind].safeParse(body);
+        if (!parsed.success) {
+            return {
+                ok: false,
+                message: `That is not a copy of ${kind === "harness-context" ? "a harness's files" : kind === "jobs" ? "a harness's jobs" : `an agent's ${kind}`}.`,
+                issues: parsed.error.issues.map((issue) => ({
+                    path: issue.path.join(".") || "(root)",
+                    message: issue.message,
+                })),
+            };
+        }
+        const { answers, refuses, ...copy } = parsed.data;
+        this.copies.set(`${kind}:${id}`, copy);
+        if (answers !== undefined)
+            this.answers.push({ kind, id, changeId: answers, made: true });
+        if (refuses !== undefined) {
+            const changeId = String(refuses["change_id"] ?? refuses["edit_id"]);
+            const message = typeof refuses["message"] === "string" ? refuses["message"] : undefined;
+            this.answers.push({ kind, id, changeId, made: false, message });
+        }
+        return { ok: true };
+    }
+    copy(kind, id) {
+        return this.copies.get(`${kind}:${id}`);
+    }
+    /** Every copy of a kind, by whose it is. */
+    copiesOf(kind) {
+        const prefix = `${kind}:`;
+        return [...this.copies]
+            .filter(([key]) => key.startsWith(prefix))
+            .map(([key, copy]) => [key.slice(prefix.length), copy]);
+    }
+    answerTo(changeId) {
+        return this.answers.find((answer) => answer.changeId === changeId);
+    }
+    /**
+     * The change a person would ask of a copy as it stands, as the frame the harness is sent, or
+     * nothing when the copy offers nothing to change: no file with its text.
+     */
+    askOf(kind, id, asker) {
+        const copy = this.copy(kind, id);
+        if (copy === undefined)
+            return undefined;
+        const asked = { harness_id: asker.harnessId, asked_by: asker.ownerId, asked_at: asker.now };
+        const change = () => asker.ids.next("change");
+        switch (kind) {
+            case "model":
+                return {
+                    frame: "model.change",
+                    change_id: change(),
+                    agent_id: id,
+                    model: copy["model"],
+                    effort: copy["effort"] ?? null,
+                    ...asked,
+                };
+            case "heartbeat":
+                return {
+                    frame: "heartbeat.change",
+                    change_id: change(),
+                    agent_id: id,
+                    on: copy["on"],
+                    every: copy["every"],
+                    ...asked,
+                };
+            case "jobs": {
+                const job = (copy["jobs"] ?? []).find((each) => each["editable"]);
+                if (job === undefined)
+                    return undefined;
+                return {
+                    frame: "job.change",
+                    change_id: change(),
+                    job_id: job["job_id"],
+                    on: job["on"],
+                    ...(job["choices"] === undefined ? {} : { every: job["every"] }),
+                    ...asked,
+                };
+            }
+            case "context-window": {
+                const limit = copy["limit"];
+                return {
+                    frame: "context_window.change",
+                    change_id: change(),
+                    agent_id: id,
+                    at: limit?.at ?? null,
+                    ...asked,
+                };
+            }
+            default:
+                return this.editOf(kind, id, copy, asked, asker);
+        }
+    }
+    /** A file saved as it is: an agent's, or one of the harness's own set. */
+    editOf(kind, id, copy, asked, asker) {
+        const files = (copy[kind === "context" ? "files" : "shared"] ?? []);
+        const file = files.find((each) => typeof each["text"] === "string" && each["editable"] === true);
+        if (file === undefined)
+            return undefined;
+        return {
+            frame: "context.edit",
+            edit_id: asker.ids.next("edit"),
+            ...(kind === "context" ? { agent_id: id } : {}),
+            name: file["name"],
+            text: file["text"],
+            base_hash: typeof file["hash"] === "string" ? file["hash"] : "unknown",
+            ...asked,
+        };
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/spend.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What a room's job has spent (ADR 0117), worked out from the fake's log as the server does: from
+ * the last person's act or brief handed into the room, what the room's `usage` reports said since,
+ * a run's own report being its total so far, against what the room allows a job.
+ */
+import { type JobSpend } from "@chipschat/protocol";
+/** An event of the fake's log, as much of it as the job reads. */
+interface StoredEvent {
+    readonly seq: number;
+    readonly type: string;
+    readonly space_id: string | null;
+    readonly run_id: string | null;
+    readonly actor: {
+        readonly kind: string;
+    };
+    readonly payload: Readonly<Record<string, unknown>>;
+}
+export declare function spendInLog(log: readonly StoredEvent[], spaceId: string, upto: number): JobSpend;
+export {};
+//# sourceMappingURL=spend.d.ts.map

package/dist/spend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spend.d.ts","sourceRoot":"","sources":["../src/spend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA6B,KAAK,QAAQ,EAAkB,MAAM,qBAAqB,CAAC;AAE/F,kEAAkE;AAClE,UAAU,WAAW;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AA0CD,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAiB/F"}

package/dist/spend.js

@@ -0,0 +1,50 @@
+/**
+ * What a room's job has spent (ADR 0117), worked out from the fake's log as the server does: from
+ * the last person's act or brief handed into the room, what the room's `usage` reports said since,
+ * a run's own report being its total so far, against what the room allows a job.
+ */
+import { DEFAULT_SPEND_CEILING_USD, resetsTheCount } from "@chipschat/protocol";
+/** Where the room's job began: the last person's act, or the last brief handed in. */
+function jobStart(room) {
+    return (room.findLast((event) => (event.actor.kind === "person" && resetsTheCount(event.type, event.payload)) ||
+        (event.type === "run.requested" && typeof event.payload["lane_id"] === "string"))?.seq ?? 0);
+}
+/** What a `usage` report said a run cost, when it said. */
+function costOf(event) {
+    return event.payload["cost"]?.usd;
+}
+/** Count one `usage` into its run's total, and into the job's spend when it is the job's. */
+function tally(into, event, job) {
+    const run = event.run_id ?? "";
+    const usd = costOf(event);
+    if (usd === undefined) {
+        if (job)
+            into.silent.add(run);
+        return;
+    }
+    const was = into.totals.get(run) ?? 0;
+    const now = event.payload["scope"] === "run" ? usd : was + usd;
+    into.totals.set(run, now);
+    if (!job)
+        return;
+    into.costed.add(run);
+    into.spent += now - was;
+}
+export function spendInLog(log, spaceId, upto) {
+    const room = log.filter((event) => event.space_id === spaceId && event.seq <= upto);
+    const since = jobStart(room);
+    const so = { spent: 0, totals: new Map(), costed: new Set(), silent: new Set() };
+    for (const event of log) {
+        if (event.type !== "usage" || event.seq > upto)
+            continue;
+        tally(so, event, event.seq > since && event.space_id === spaceId);
+    }
+    const ceiling = room.findLast((event) => event.type === "space.spend_ceiling_set")?.payload["usd"];
+    return {
+        ceiling_usd: typeof ceiling === "number" ? ceiling : DEFAULT_SPEND_CEILING_USD,
+        spent_usd: Math.max(0, Math.round(so.spent * 1e6) / 1e6),
+        since_seq: since,
+        uncounted_runs: [...so.silent].filter((run) => !so.costed.has(run)).length,
+    };
+}
+//# sourceMappingURL=spend.js.map

package/dist/spend.js.map

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

package/dist/subject.d.ts

@@ -0,0 +1,55 @@
+/**
+ * What the kit drives: an adapter, brought up against a Chips it was given, and — for a harness
+ * that cannot act on its own here — asked for a turn.
+ *
+ * The kit plays the person. It says something in a space, answers the card that comes back,
+ * answers a question if one is asked, and reads what the harness sent. Which side of the wire
+ * the adapter is on is the adapter's business: a harness that runs itself — Scout, Jacobian's
+ * channel — hears the message on its own socket and runs a turn by itself. An adapter with no
+ * model behind it in a test is asked to
+ * play the harness's side instead — the events a real turn would send, with the message as the
+ * prompt. A custom harness that a person started by hand is the first kind: the kit prints where
+ * Chips is and waits for it to connect.
+ */
+/** Where the fake Chips is, and who the harness is there. Everything an adapter needs to connect. */
+export interface ChipsAddress {
+    /** `http://127.0.0.1:<port>`. The socket is at `/v1/ws` under it. */
+    readonly url: string;
+    readonly workspaceId: string;
+    readonly harnessId: string;
+    /** The harness's bearer token, `chips_at_…`. */
+    readonly token: string;
+    /** The person the harness belongs to, and the one whose message starts the scenario. */
+    readonly ownerId: string;
+    /** The direct space between the owner and the harness, where the scenario is played. */
+    readonly spaceId: string;
+}
+/** The person's message, as the kit said it. */
+export interface Turn {
+    readonly spaceId: string;
+    readonly messageId: string;
+    readonly text: string;
+}
+export interface Subject {
+    /** The adapter's id — `scout`, `custom` — named in the report. */
+    readonly name: string;
+    /**
+     * What the harness declares, as its registration would (ADR 0046). A harness that declares
+     * `new_spaces` is asked for a room as well, after the golden scenario, and must claim it: it
+     * is a harness that runs itself, since nobody calls `turn` for that room.
+     */
+    readonly capabilities?: readonly string[] | undefined;
+    /** Bring the adapter up against this Chips. Resolves when it is ready to hear a message. */
+    readonly start: (chips: ChipsAddress) => Promise<void>;
+    /**
+     * The harness's side of one turn, for an adapter whose harness cannot act here on its own.
+     * Called right after the person's message is posted, and awaited only after the run has
+     * ended — an approval it asks for is answered while it runs. Absent for a harness that
+     * answers a message by itself.
+     */
+    readonly turn?: ((message: Turn) => Promise<void>) | undefined;
+    readonly stop: () => Promise<void>;
+}
+/** A harness somebody starts by hand against the address the kit prints. */
+export declare function customSubject(): Subject;
+//# sourceMappingURL=subject.d.ts.map

package/dist/subject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../src/subject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,gDAAgD;AAChD,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtD,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,IAAI,OAAO,CAMvC"}

package/dist/subject.js

@@ -0,0 +1,22 @@
+/**
+ * What the kit drives: an adapter, brought up against a Chips it was given, and — for a harness
+ * that cannot act on its own here — asked for a turn.
+ *
+ * The kit plays the person. It says something in a space, answers the card that comes back,
+ * answers a question if one is asked, and reads what the harness sent. Which side of the wire
+ * the adapter is on is the adapter's business: a harness that runs itself — Scout, Jacobian's
+ * channel — hears the message on its own socket and runs a turn by itself. An adapter with no
+ * model behind it in a test is asked to
+ * play the harness's side instead — the events a real turn would send, with the message as the
+ * prompt. A custom harness that a person started by hand is the first kind: the kit prints where
+ * Chips is and waits for it to connect.
+ */
+/** A harness somebody starts by hand against the address the kit prints. */
+export function customSubject() {
+    return {
+        name: "custom",
+        start: async () => undefined,
+        stop: async () => undefined,
+    };
+}
+//# sourceMappingURL=subject.js.map

package/dist/subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.js","sourceRoot":"","sources":["../src/subject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4CH,4EAA4E;AAC5E,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;QAC5B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KAC5B,CAAC;AACJ,CAAC"}

package/dist/waiting.d.ts

@@ -0,0 +1,12 @@
+/** Waiting on the fake's log, and on what is not in it, for the scenario and the checks. */
+import type { FakeChips } from "./fake-chips.js";
+import type { StoredEvent } from "./workspace.js";
+export declare const POLL_MS = 200;
+export declare function sleep(ms: number): Promise<void>;
+/** What the harness said: as itself, or as one of its agents, beside which it is named (ADR 0087). */
+export declare function byHarness(event: StoredEvent, harnessId: string): boolean;
+/** The first event that matches within the time, or nothing. */
+export declare function within(chips: FakeChips, match: (event: StoredEvent) => boolean, ms: number): Promise<StoredEvent | undefined>;
+/** The first thing `read` finds within the time, asked every `POLL_MS`: for what no event says. */
+export declare function until<T>(read: () => T | undefined, ms: number): Promise<T | undefined>;
+//# sourceMappingURL=waiting.d.ts.map

package/dist/waiting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting.d.ts","sourceRoot":"","sources":["../src/waiting.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAKxE;AAED,gEAAgE;AAChE,wBAAsB,MAAM,CAC1B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,EACtC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAMlC;AAED,mGAAmG;AACnG,wBAAsB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAO5F"}

package/dist/waiting.js

@@ -0,0 +1,30 @@
+/** Waiting on the fake's log, and on what is not in it, for the scenario and the checks. */
+export const POLL_MS = 200;
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** What the harness said: as itself, or as one of its agents, beside which it is named (ADR 0087). */
+export function byHarness(event, harnessId) {
+    return (event.actor.id === harnessId ||
+        event.actor.harness_id === harnessId);
+}
+/** The first event that matches within the time, or nothing. */
+export async function within(chips, match, ms) {
+    try {
+        return await chips.waitFor((event) => (match(event) ? event : undefined), ms);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The first thing `read` finds within the time, asked every `POLL_MS`: for what no event says. */
+export async function until(read, ms) {
+    const deadline = Date.now() + ms;
+    for (;;) {
+        const found = read();
+        if (found !== undefined || Date.now() >= deadline)
+            return found;
+        await sleep(POLL_MS);
+    }
+}
+//# sourceMappingURL=waiting.js.map

package/dist/waiting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting.js","sourceRoot":"","sources":["../src/waiting.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAK5F,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAC;AAE3B,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,SAAS,CAAC,KAAkB,EAAE,SAAiB;IAC7D,OAAO,CACL,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS;QAC3B,KAAK,CAAC,KAAiC,CAAC,UAAU,KAAK,SAAS,CAClE,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAAgB,EAChB,KAAsC,EACtC,EAAU;IAEV,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,KAAK,CAAI,IAAyB,EAAE,EAAU;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IACjC,SAAS,CAAC;QACR,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;QACrB,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;YAAE,OAAO,KAAK,CAAC;QAChE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}