@serverkgg/bridge 0.1.1 → 0.1.3

package/src/runtime/bridgeConsoleHandler.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, test } from "bun:test";
+import { describe, expect, it } from "bun:test";
 import type { BridgeCommandOptions, BridgeContext, BridgeReply } from "../context";
 import { BridgeKind, BridgeUserError } from "../core";
 import type { BridgeDriver, BridgeTerminalModule } from "../modules";
@@ -60,7 +60,7 @@ const handlerFor = (driver: BridgeDriver) => {
 };
 
 describe("routing a console line to the driver before the game's stdin", () => {
-	test("answers with the driver's reply when the driver handles the line", async () => {
+	it("answers with the driver's reply when the driver handles the line", async () => {
 		const { handler, written } = handlerFor(
 			driverWith(
 				terminalWith(async (_context, input) => {
@@ -81,7 +81,7 @@ describe("routing a console line to the driver before the game's stdin", () => {
 		expect(written).toEqual([]);
 	});
 
-	test("hands the driver the same line the caller typed", async () => {
+	it("hands the driver the same line the caller typed", async () => {
 		const seen: string[] = [];
 
 		const { handler } = handlerFor(
@@ -105,7 +105,7 @@ describe("routing a console line to the driver before the game's stdin", () => {
 		]);
 	});
 
-	test("writes the line to stdin when the driver answers null", async () => {
+	it("writes the line to stdin when the driver answers null", async () => {
 		const { handler, written } = handlerFor(
 			driverWith(
 				terminalWith(async () => {
@@ -124,7 +124,7 @@ describe("routing a console line to the driver before the game's stdin", () => {
 		]);
 	});
 
-	test("keeps the expect and timeout of a line the driver leaves alone", async () => {
+	it("keeps the expect and timeout of a line the driver leaves alone", async () => {
 		const { handler } = handlerFor(
 			driverWith(
 				terminalWith(async () => {
@@ -143,7 +143,7 @@ describe("routing a console line to the driver before the game's stdin", () => {
 		).toBe("matched");
 	});
 
-	test("writes the line to stdin when the driver declares no handler", async () => {
+	it("writes the line to stdin when the driver declares no handler", async () => {
 		const { handler, written } = handlerFor(
 			driverWith({
 				kind: BridgeKind.Terminal,
@@ -158,7 +158,7 @@ describe("routing a console line to the driver before the game's stdin", () => {
 		]);
 	});
 
-	test("writes the line to stdin when the game declares no terminal at all", async () => {
+	it("writes the line to stdin when the game declares no terminal at all", async () => {
 		const { handler, written } = handlerFor(driverWith(undefined));
 
 		await handler("list", {});
@@ -168,7 +168,7 @@ describe("routing a console line to the driver before the game's stdin", () => {
 		]);
 	});
 
-	test("refuses the line with the driver's own text when the driver rejects it", async () => {
+	it("refuses the line with the driver's own text when the driver rejects it", async () => {
 		const refusal = {
 			ar: "هذا الأمر يشتغل داخل اللعبة بس.",
 			en: "That command only works inside the game.",

package/src/runtime/bridgeContext.test.ts

@@ -1,4 +1,4 @@
-import { afterEach, beforeEach, describe, expect, test } from "bun:test";
+import { afterEach, beforeEach, describe, expect, it } from "bun:test";
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
@@ -38,7 +38,7 @@ describe("the context's variable maps", () => {
 		});
 	});
 
-	test("hand a driver every variable and secret the agent wrote, and follow a rewrite", async () => {
+	it("hand a driver every variable and secret the agent wrote, and follow a rewrite", async () => {
 		const boot = configWith(
 			{
 				MY_VAR: "1",
@@ -72,6 +72,9 @@ describe("the context's variable maps", () => {
 				onSetup() {
 					return;
 				},
+				onActivity() {
+					return;
+				},
 				async onRestart() {
 					return;
 				},
@@ -158,6 +161,9 @@ describe("the context's ports and address", () => {
 					onSetup() {
 						return;
 					},
+					onActivity() {
+						return;
+					},
 					async onRestart() {
 						return;
 					},
@@ -179,7 +185,7 @@ describe("the context's ports and address", () => {
 		});
 	});
 
-	test("hand a driver the block the agent published and its public address", async () => {
+	it("hand a driver the block the agent published and its public address", async () => {
 		const boot = configWith({
 			portCounts: {
 				game: 1,
@@ -203,7 +209,7 @@ describe("the context's ports and address", () => {
 		expect(context.server.publicAddress).toBe("203.0.113.7");
 	});
 
-	test("treat every port as a single one and the address as unknown for a file an older agent wrote", async () => {
+	it("treat every port as a single one and the address as unknown for a file an older agent wrote", async () => {
 		const boot = configWith({});
 
 		await writeFile(path, JSON.stringify(boot));
@@ -218,7 +224,7 @@ describe("the context's ports and address", () => {
 		expect(() => context.portBlock("query")).toThrow('this game declares no port named "query"');
 	});
 
-	test("follow a rewrite of the public address", async () => {
+	it("follow a rewrite of the public address", async () => {
 		const boot = configWith({});
 
 		await writeFile(path, JSON.stringify(boot));

package/src/runtime/bridgeContext.ts

@@ -1,5 +1,5 @@
 import type { BridgeContext } from "../context";
-import type { BridgeValues } from "../core";
+import type { BridgeActivity, BridgeValues } from "../core";
 import type { BridgeConfig, BridgeSetupRuntime } from "../protocol";
 import { stripAnsi } from "../utils";
 import { createBridgeCodecs } from "./bridgeCodec";
@@ -18,6 +18,7 @@ export interface ContextHooks {
 	onLog: BridgeLeveledLogger;
 	onEmit: (event: string, payload?: BridgeValues) => void;
 	onSetup: (runtime: BridgeSetupRuntime | null) => void;
+	onActivity: (entry: BridgeActivity) => void;
 	onRestart: () => Promise<void>;
 }
 
@@ -141,6 +142,12 @@ export const createContext = (
 			},
 		},
 
+		activity: {
+			report(entry) {
+				hooks.onActivity(entry);
+			},
+		},
+
 		emit(event, payload) {
 			hooks.onEmit(event, payload);
 		},