@agentcomms/events-daemon 0.26.2 → 0.27.0

package/README.md

@@ -24,8 +24,12 @@ agent-events run                     # in a terminal you keep open: the owner of
 ## How it runs
 
 `agent-events run` starts the **foreground owner**. It owns the event database while that terminal runs, and stops
-cleanly on `agent-events stop` or when the terminal closes. There is no background service or autostart in this
-release; the desktop app will supervise it later. Its state lives in an owner-only directory. A state directory so
+cleanly on `agent-events stop` or when the terminal closes. A clean stop writes `last-stop.json` beside the
+database, with the owner's PID, the time, and whether it was asked to stop or got a signal, so a supervisor can tell
+it from a crash. From 0.27.0 the desktop app can
+run it for you: it starts it in the background, restarts it after a crash and keeps it running after the app quits
+(see [the desktop app](../../README.md#the-desktop-app)). There is still no OS service of its own (launchd, systemd
+or a Windows service). Its state lives in an owner-only directory. A state directory so
 deep that its control socket's path would pass the system limit (103 bytes on macOS, 107 on Linux) is refused, with
 a hint to pin a shorter one. `agent-events --version` (or `-V`) prints the installed daemon version; a subcommand's
 `--version <number>` continues to select an immutable rule, target, subscriber or judge version.

package/dist/{b3-contract-BSQ-vU21.mjs → b3-contract-DIasFAno.mjs}

@@ -852,7 +852,7 @@ async function removeTarget(targetId, options = {}) {
 //#endregion
 //#region src/version.ts
 /** The package version, read from package.json at build time. */
-const VERSION = "0.26.2";
+const VERSION = "0.27.0";
 //#endregion
 //#region src/mcp/server.ts
 function reply(data) {

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { $ as addSubscriber, $t as isControlHello, A as normaliseSourceOptions, At as updateJudge, B as canonicalJudgeKindEnablement, Bt as deliveriesList, C as normaliseActivationDocument, Ct as judgeKindsList, D as normaliseGmailSourceOptions, Dt as removeJudge, E as classifySourceOptionChange, Et as judgesList, F as assertCreatableLayaJudge, Ft as doctor, G as registerLayaEnablementInputs, Gt as catalogueShow, H as layaEnablementInputsFor, Ht as heldList, I as assertLayaJudgeKindAvailable, It as ACTIVATION_FAILURE, J as addTarget, Jt as probeControl, K as createEventsMcpServer, Kt as approvalView, L as assertLayaRuleJudgeOffered, Lt as isActivationFailureCode, M as APPROVED_TYPESAFE_MODELS, Mt as assertDoctorReportV1, N as JUDGE_BUDGET_ID, Nt as assertDoctorReportV2, O as normaliseResendSourceOptions, Ot as removeJudgeModel, P as JUDGE_KIND_DEFINITIONS, Pt as assertDoctorReportV3, Q as targetTest, Qt as encodeControlFrame, R as canonicalJudge, Rt as disableAll, S as disclosureBindingFor, St as enableJudgeKind, T as sseDeliveryTarget, Tt as judgeTest, U as layaJudgeKindDefinitionFor, Ut as retryDelivery, V as judgeKindDefinition, Vt as dropDelivery, W as layaJudgeTermsFor, Wt as catalogueList, X as targetsList, Xt as ControlFrameReader, Y as removeTarget$1, Yt as CONTROL_PROTOCOL_VERSIONS, Z as updateTarget, Zt as controlFailure, _ as isOwnerControlWireOperation, _t as pause, an as readInstance, at as loadSqlite, b as canonicalSubscriber, bt as budgetShow, cn as assertControlSupported, ct as createRule$1, d as B3_SECRET_TERMINAL_ORIGIN, dn as verifyControlSocket, dt as removeRule, en as isControlRequest, et as removeSubscriber, f as isB3ControlOperation, fn as verifyPrivateSocketDirectory, ft as ruleShow$1, g as OWNER_CONTROL_WIRES, gn as eventPaths, gt as ruleTestRetained, h as layaJudgePreviewFor, hn as ensureOwnerOnlyFile, ht as ruleTest, in as processIsLive, it as status, j as normaliseWhatsAppSourceOptions, jt as enableAll, k as normaliseSlackSourceOptions, kt as updateBudget, ln as assertSocketPathFits, lt as disableRule$1, m as renderB3ApprovalPreviewV1, mn as ensureEventSocketDirectory, mt as updateRule, nn as mayRecoverStaleInstance, nt as updateSubscriber, on as removeInstance, ot as sourceShow$1, p as isB3SecretOperation, pn as ensureEventPaths, pt as rulesList, q as VERSION, qt as EventControlClient, rn as newInstanceRecord, rt as stop, sn as writeInstance, st as sourcesList, tn as negotiateVersion, tt as subscribersList, un as controlEndpoint, ut as enableRule, v as activationDocumentDigest, vt as resume, w as canonicalSseSubscriber, wt as judgeModelStatus, x as canonicalTarget, xt as disableJudgeKind, y as canonicalFullRuleDocument, yt as addJudge, z as canonicalJudgeBudget, zt as decideHeld } from "./b3-contract-BSQ-vU21.mjs";
+import { $ as addSubscriber, $t as isControlHello, A as normaliseSourceOptions, At as updateJudge, B as canonicalJudgeKindEnablement, Bt as deliveriesList, C as normaliseActivationDocument, Ct as judgeKindsList, D as normaliseGmailSourceOptions, Dt as removeJudge, E as classifySourceOptionChange, Et as judgesList, F as assertCreatableLayaJudge, Ft as doctor, G as registerLayaEnablementInputs, Gt as catalogueShow, H as layaEnablementInputsFor, Ht as heldList, I as assertLayaJudgeKindAvailable, It as ACTIVATION_FAILURE, J as addTarget, Jt as probeControl, K as createEventsMcpServer, Kt as approvalView, L as assertLayaRuleJudgeOffered, Lt as isActivationFailureCode, M as APPROVED_TYPESAFE_MODELS, Mt as assertDoctorReportV1, N as JUDGE_BUDGET_ID, Nt as assertDoctorReportV2, O as normaliseResendSourceOptions, Ot as removeJudgeModel, P as JUDGE_KIND_DEFINITIONS, Pt as assertDoctorReportV3, Q as targetTest, Qt as encodeControlFrame, R as canonicalJudge, Rt as disableAll, S as disclosureBindingFor, St as enableJudgeKind, T as sseDeliveryTarget, Tt as judgeTest, U as layaJudgeKindDefinitionFor, Ut as retryDelivery, V as judgeKindDefinition, Vt as dropDelivery, W as layaJudgeTermsFor, Wt as catalogueList, X as targetsList, Xt as ControlFrameReader, Y as removeTarget$1, Yt as CONTROL_PROTOCOL_VERSIONS, Z as updateTarget, Zt as controlFailure, _ as isOwnerControlWireOperation, _t as pause, an as readInstance, at as loadSqlite, b as canonicalSubscriber, bt as budgetShow, cn as assertControlSupported, ct as createRule$1, d as B3_SECRET_TERMINAL_ORIGIN, dn as verifyControlSocket, dt as removeRule, en as isControlRequest, et as removeSubscriber, f as isB3ControlOperation, fn as verifyPrivateSocketDirectory, ft as ruleShow$1, g as OWNER_CONTROL_WIRES, gn as eventPaths, gt as ruleTestRetained, h as layaJudgePreviewFor, hn as ensureOwnerOnlyFile, ht as ruleTest, in as processIsLive, it as status, j as normaliseWhatsAppSourceOptions, jt as enableAll, k as normaliseSlackSourceOptions, kt as updateBudget, ln as assertSocketPathFits, lt as disableRule$1, m as renderB3ApprovalPreviewV1, mn as ensureEventSocketDirectory, mt as updateRule, nn as mayRecoverStaleInstance, nt as updateSubscriber, on as removeInstance, ot as sourceShow$1, p as isB3SecretOperation, pn as ensureEventPaths, pt as rulesList, q as VERSION, qt as EventControlClient, rn as newInstanceRecord, rt as stop, sn as writeInstance, st as sourcesList, tn as negotiateVersion, tt as subscribersList, un as controlEndpoint, ut as enableRule, v as activationDocumentDigest, vt as resume, w as canonicalSseSubscriber, wt as judgeModelStatus, x as canonicalTarget, xt as disableJudgeKind, y as canonicalFullRuleDocument, yt as addJudge, z as canonicalJudgeBudget, zt as decideHeld } from "./b3-contract-DIasFAno.mjs";
 import { a as createLayaWorkerBoundary, d as encodeWorkerFrame, h as isLayaTemplateId, l as WorkerFrameParser, u as createWorkerRequestId, v as installErrorSink } from "./worker-boundary-probe-CFN6EsyK.mjs";
 import { _ as JUDGE_KIND_TYPESAFE, c as validateLocalEndpoint, d as assertApprovedAddressSet, f as parseIpLiteral, h as JUDGE_KIND_LAYA, i as webhookDeliveryTarget, l as AddressPolicyError, m as JUDGE_KINDS, n as canonicalWebhookTarget, p as EventDomainError, r as secretWebhookUrlDescriptor, t as canonicalSecretWebhookUrl, u as assertAddressAllowed, v as assertJudgeKindEnabled, y as isJudgeKind } from "./webhook-target-EzLIFpIY.mjs";
 import { c as migrateEventSecrets, i as RecordStorageError, l as openEventSecretStore, n as LayaModelRepository, o as WriterQuiescer, s as withEventWriterLease, t as EventRecordCipher } from "./records-BRl5wEbC.mjs";
@@ -24210,19 +24210,58 @@ async function startOwnerWithLock(options, stateDir, paths, lock, started, onDat
 }
 /** Runs the owner until a local stop request or a terminal signal closes it cleanly. */
 async function runEventOwner(options = {}) {
-	const owner = await startEventOwner(options);
+	const stateDir = options.stateDir ?? resolvePaths().stateDir;
+	const signals = options.signals ?? process;
+	const owner = await startEventOwner({
+		...options,
+		stateDir
+	});
+	let reason = "request";
 	const stop = () => {
+		reason = "signal";
 		owner.stop();
 	};
-	process.once("SIGINT", stop);
-	process.once("SIGTERM", stop);
+	signals.once("SIGINT", stop);
+	signals.once("SIGTERM", stop);
 	try {
 		await owner.stopped;
 	} finally {
-		process.off("SIGINT", stop);
-		process.off("SIGTERM", stop);
+		signals.off("SIGINT", stop);
+		signals.off("SIGTERM", stop);
 		await owner.stop();
 	}
+	await writeLastStop(eventPaths(stateDir), reason);
+}
+const LAST_STOP_FILE = "last-stop.json";
+/**
+* The clean-stop marker (desktop 0.27.0, P2): `{"version":1,"pid":…,"at":"<ISO 8601>","reason":"request"|"signal"}`
+* beside the database. A supervisor that no longer has this process as its child reads it to tell a stop from a crash:
+* a marker for the service's PID, newer than its start, with reason `request`, means the person stopped it; reason
+* `signal` — a logout, a shutdown, a kill — is not their decision, and the desktop app restarts it as after a crash.
+* Owner-only like the instance record, and written atomically, so a reader sees the previous marker or this one, never
+* a part of either.
+*/
+async function writeLastStop(paths, reason) {
+	const target = join(paths.root, LAST_STOP_FILE);
+	const temporary = join(paths.root, `${LAST_STOP_FILE}.${randomBytes(8).toString("hex")}.tmp`);
+	const marker = {
+		version: 1,
+		pid: process.pid,
+		at: (/* @__PURE__ */ new Date()).toISOString(),
+		reason
+	};
+	try {
+		await writeFile(temporary, `${JSON.stringify(marker)}\n`, {
+			encoding: "utf8",
+			mode: 384,
+			flag: "wx"
+		});
+		await chmod(temporary, 384);
+		await rename(temporary, target);
+	} catch (error) {
+		await rm(temporary, { force: true });
+		throw error;
+	}
 }
 async function handleControl(owner, lifecycle, database, activations, dispatcher, sourceRegistry, writerQuiescer, request, b3OwnerService, doctorReport, connectedAccounts = async () => []) {
 	if (!isOwnerControlWireOperation(request.operation)) throw new CommsError("USAGE", "the local event control operation is not recognised");

package/dist/index.mjs

@@ -1 +1 @@
-export { t as B3_APPROVAL_VIEW_VARIANTS, n as B3_CAPABILITIES, r as B3_CONTROL_CONTRACT, i as B3_CONTROL_ERROR_CODES, a as B3_CONTROL_V1_OPERATION_SPECS, o as B3_CONTROL_V1_RESULT_OPERATIONS, s as B3_CONTROL_V1_SCHEMA_VERSION, c as B3_CONTROL_V1_SUCCESSOR_REQUIREMENT, l as B3_DESKTOP_CONTROL_OPERATIONS, u as B3_JUDGE_UNAVAILABLE_VARIANTS, d as B3_SECRET_TERMINAL_ORIGIN, K as createEventsMcpServer, m as renderB3ApprovalPreviewV1, it as status } from "./b3-contract-BSQ-vU21.mjs";
+export { t as B3_APPROVAL_VIEW_VARIANTS, n as B3_CAPABILITIES, r as B3_CONTROL_CONTRACT, i as B3_CONTROL_ERROR_CODES, a as B3_CONTROL_V1_OPERATION_SPECS, o as B3_CONTROL_V1_RESULT_OPERATIONS, s as B3_CONTROL_V1_SCHEMA_VERSION, c as B3_CONTROL_V1_SUCCESSOR_REQUIREMENT, l as B3_DESKTOP_CONTROL_OPERATIONS, u as B3_JUDGE_UNAVAILABLE_VARIANTS, d as B3_SECRET_TERMINAL_ORIGIN, K as createEventsMcpServer, m as renderB3ApprovalPreviewV1, it as status } from "./b3-contract-DIasFAno.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentcomms/events-daemon",
-  "version": "0.26.2",
+  "version": "0.27.0",
   "description": "The local event service for agent-communications: rules you approve deliver Gmail, Slack, Resend and WhatsApp events to a signed webhook, a local live stream or a dry-run log.",
   "type": "module",
   "license": "MIT",
@@ -37,12 +37,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@agentcomms/core": "0.26.2",
-    "@agentcomms/events": "0.26.2",
-    "@agentcomms/gmail": "0.26.2",
-    "@agentcomms/whatsapp": "0.26.2",
-    "@agentcomms/slack": "0.26.2",
-    "@agentcomms/resend": "0.26.2"
+    "@agentcomms/core": "0.27.0",
+    "@agentcomms/events": "0.27.0",
+    "@agentcomms/gmail": "0.27.0",
+    "@agentcomms/resend": "0.27.0",
+    "@agentcomms/slack": "0.27.0",
+    "@agentcomms/whatsapp": "0.27.0"
   },
   "devDependencies": {
     "@modelcontextprotocol/client": "2.3.1",
@@ -73,5 +73,5 @@
     "typecheck": "tsc -p tsconfig.json",
     "test": "node --import ../../test/helpers/loopback-seal-preload.mjs --experimental-strip-types --disable-warning=ExperimentalWarning --test \"test/**/*.test.ts\" test/laya-runtime-package.test.mjs"
   },
-  "gitHead": "c3fbb731e23401ea56862349d3c1e596be53ed11"
+  "gitHead": "9cb31ae29511a6b9424464601540c1ce9584ecea"
 }