@knpkv/herdr-coordinator 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 knpkv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# `@knpkv/herdr-coordinator`
+
+Persistent chat contracts over the Herdr fleet job protocol.
+
+Ask mode submits an `agent.delegate` consult job. Work mode submits a locally authorized work job and therefore follows the fleet approval policy. Chat turns persist beside their job IDs and history derives current state from the owning host's durable job record. The browser-facing history contains the newest 32 turns in chronological order; older turns remain durable and addressable by job ID.
+
+Coordinator output is newline-delimited `herdr.coordinator.child.v1` lifecycle events. Both events carry the exact fleet job ID and request ID. A `started` event with the exact sanitized worker identity and reported relationship must arrive before the matching `completed` event. Missing, malformed, duplicate, reordered, job-mismatched, or request-mismatched events fail with named lifecycle errors. Terminal transcripts are never accepted as chat replies. Chat history exposes the same persisted worker and canonical Connect target after restart.
+
+Browser-safe schemas are exported from `@knpkv/herdr-coordinator/model`.

package/dist/chat.d.ts

@@ -0,0 +1,137 @@
+import type { FleetService, HostConfiguration } from "@knpkv/herdr-fleet";
+import { Crypto, Effect } from "effect";
+import { ChatHistoryError } from "./errors.js";
+import { type ChatRequest } from "./model.js";
+import type { ChatStoreService } from "./store.js";
+export interface CoordinatorChatOptions {
+    readonly config: HostConfiguration;
+    readonly fleet: FleetService;
+    readonly now?: Effect.Effect<number>;
+    readonly nextId?: Effect.Effect<string>;
+    readonly store: ChatStoreService;
+}
+export declare const makeCoordinatorChat: (options: CoordinatorChatOptions) => Effect.Effect<{
+    history: () => Effect.Effect<{
+        entries: ({
+            createdAt: number;
+            id: string;
+            message: string;
+            mode: "ask" | "work";
+            reply: string | null;
+            state: "completed" | "failed" | "interrupted" | "pending" | "running";
+            updatedAt: number;
+        } | {
+            createdAt: number;
+            id: string;
+            message: string;
+            mode: "ask" | "work";
+            reply: string | null;
+            state: "completed" | "failed" | "interrupted" | "pending" | "running";
+            updatedAt: number;
+            worker: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            connectTarget: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly url: string;
+            };
+        })[];
+    }, ChatHistoryError | import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError, never>;
+    run: (jobId: string) => Effect.Effect<{
+        readonly id: string;
+        readonly createdAt: number;
+        readonly updatedAt: number;
+        readonly actor: string;
+        readonly hash: string;
+        readonly approvalNonce: string | null;
+        readonly approvalExpiresAt?: number | null;
+        readonly approvedBy: string | null;
+        readonly approvedAt?: number | null;
+        readonly rejectedBy?: string | null;
+        readonly rejectedAt?: number | null;
+        readonly expiredAt?: number | null;
+        readonly status: "expired" | "failed" | "interrupted" | "pending_approval" | "queued" | "rejected" | "running" | "succeeded";
+        readonly payload: {
+            readonly kind: "nix.check";
+        } | {
+            readonly kind: "nix.apply";
+            readonly ref: string;
+        } | {
+            readonly kind: "agent.delegate";
+            readonly repository: string;
+            readonly prompt: string;
+            readonly mode: "consult" | "review" | "work";
+            readonly channel?: "coordinator_chat";
+        } | {
+            readonly kind: "agent.message";
+            readonly session: string;
+            readonly message: string;
+        } | {
+            readonly kind: "browser.mcp.recover";
+        };
+        readonly result: string | null;
+        readonly error: string | null;
+        readonly worker?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+        readonly connectTarget?: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly url: string;
+        };
+        readonly workerTerminalObservedAt?: number | null;
+    }, ChatHistoryError | import("@knpkv/herdr-fleet").FleetApprovalError | import("@knpkv/herdr-fleet").FleetJobNotFoundError | import("@knpkv/herdr-fleet").FleetStoreError | import("@knpkv/herdr-fleet").FleetTransitionConflictError | import("@knpkv/herdr-fleet").FleetValidationError, never>;
+    submit: (request: ChatRequest, actor: string) => Effect.Effect<{
+        entry: {
+            createdAt: number;
+            id: string;
+            message: string;
+            mode: "ask" | "work";
+            reply: string | null;
+            state: "completed" | "failed" | "interrupted" | "pending" | "running";
+            updatedAt: number;
+        } | {
+            createdAt: number;
+            id: string;
+            message: string;
+            mode: "ask" | "work";
+            reply: string | null;
+            state: "completed" | "failed" | "interrupted" | "pending" | "running";
+            updatedAt: number;
+            worker: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly name: string;
+                readonly paneId: string;
+                readonly relationship?: {
+                    readonly parentAgentId: string;
+                    readonly relation: "delegated" | "pair" | "review";
+                };
+            };
+            connectTarget: {
+                readonly host: string;
+                readonly agentId: string;
+                readonly url: string;
+            };
+        };
+        jobId: string;
+        queued: boolean;
+    }, ChatHistoryError | import("@knpkv/herdr-fleet").FleetJobConflictError | import("@knpkv/herdr-fleet").FleetOperationError | import("@knpkv/herdr-fleet").FleetStoreError | import("@knpkv/herdr-fleet").FleetValidationError, never>;
+}, never, Crypto.Crypto>;
+export type CoordinatorChat = Effect.Success<ReturnType<typeof makeCoordinatorChat>>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAa,MAAM,oBAAoB,CAAA;AACpF,OAAO,EAAS,MAAM,EAAE,MAAM,EAAkB,MAAM,QAAQ,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAoC,KAAK,WAAW,EAAyC,MAAM,YAAY,CAAA;AACtH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACvC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;CACjC;AAyDD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA0F9B,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAA"}

package/dist/chat.js

@@ -0,0 +1,117 @@
+import { Clock, Crypto, Effect, Result, Schema } from "effect";
+import { ChatHistoryError } from "./errors.js";
+import { CoordinatorReply } from "./model.js";
+const historyError = (operation) => (cause) => new ChatHistoryError({ cause, detail: String(cause), operation });
+const stateOf = (record) => {
+    switch (record.status) {
+        case "pending_approval":
+        case "queued":
+            return "pending";
+        case "running":
+            return "running";
+        case "succeeded":
+            return "completed";
+        case "expired":
+        case "failed":
+        case "rejected":
+            return "failed";
+        case "interrupted":
+            return "interrupted";
+    }
+};
+const entryFor = Effect.fn("CoordinatorChat.entryFor")(function* (turn, record) {
+    const state = stateOf(record);
+    const reply = state === "completed"
+        ? yield* Schema.decodeUnknownEffect(CoordinatorReply)(record.result).pipe(Effect.mapError(historyError("chat.reply.decode")))
+        : null;
+    const entry = {
+        createdAt: turn.createdAt,
+        id: turn.id,
+        message: turn.message,
+        mode: turn.mode,
+        reply,
+        state,
+        updatedAt: record.updatedAt
+    };
+    if (record.worker === undefined)
+        return entry;
+    if (record.connectTarget === undefined) {
+        return yield* new ChatHistoryError({
+            cause: record,
+            detail: "started coordinator worker is missing its exact Connect target",
+            operation: "chat.worker_target"
+        });
+    }
+    return {
+        ...entry,
+        worker: record.worker,
+        connectTarget: record.connectTarget
+    };
+});
+export const makeCoordinatorChat = Effect.fn("CoordinatorChat.make")(function* (options) {
+    const cryptoService = yield* Crypto.Crypto;
+    const nextId = options.nextId ??
+        cryptoService.randomUUIDv4.pipe(Effect.mapError(historyError("chat.id")));
+    const now = options.now ?? Clock.currentTimeMillis;
+    const submit = Effect.fn("CoordinatorChat.submit")(function* (request, actor) {
+        const createdAt = yield* now;
+        const id = yield* nextId;
+        const record = yield* options.fleet.submit({
+            payload: {
+                kind: "agent.delegate",
+                channel: "coordinator_chat",
+                mode: request.mode === "ask" ? "consult" : "work",
+                prompt: request.message,
+                repository: options.config.repository
+            }
+        }, actor);
+        const persisted = yield* Effect.result(options.store.put({
+            createdAt,
+            id,
+            jobId: record.id,
+            message: request.message,
+            mode: request.mode
+        }));
+        if (Result.isFailure(persisted)) {
+            const compensated = yield* Effect.result(options.fleet.abortSubmission(record.id, "coordinator chat turn was not persisted"));
+            if (Result.isFailure(compensated)) {
+                return yield* new ChatHistoryError({
+                    cause: {
+                        compensation: compensated.failure,
+                        persistence: persisted.failure
+                    },
+                    detail: "chat persistence failed and the fleet job could not be aborted",
+                    operation: "chat.submit.compensate"
+                });
+            }
+            return yield* persisted.failure;
+        }
+        const turn = persisted.success;
+        return {
+            entry: yield* entryFor(turn, record),
+            jobId: record.id,
+            queued: record.status === "queued"
+        };
+    });
+    const history = Effect.fn("CoordinatorChat.history")(function* () {
+        const turns = yield* options.store.list();
+        const entries = yield* Effect.forEach(turns, (turn) => options.fleet.get(turn.jobId).pipe(Effect.flatMap((record) => entryFor(turn, record))));
+        return { entries };
+    });
+    const run = Effect.fn("CoordinatorChat.run")(function* (jobId) {
+        const turn = yield* options.store.getByJob(jobId);
+        if (turn === undefined) {
+            const aborted = yield* Effect.result(options.fleet.abortSubmission(jobId, "coordinator chat turn is missing"));
+            return yield* new ChatHistoryError({
+                cause: Result.isFailure(aborted) ? aborted.failure : jobId,
+                detail: Result.isFailure(aborted)
+                    ? "coordinator chat turn is missing and its fleet job could not be aborted"
+                    : "coordinator chat turn is missing; its fleet job was aborted",
+                operation: "chat.run.lookup"
+            });
+        }
+        return yield* options.fleet.runCoordinatorChat(jobId);
+    });
+    return { history, run, submit };
+});
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+import { Schema } from "effect";
+declare const CoordinatorLifecycleMalformedError_base: Schema.Class<CoordinatorLifecycleMalformedError, Schema.TaggedStruct<"CoordinatorLifecycleMalformedError", {
+    readonly detail: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class CoordinatorLifecycleMalformedError extends CoordinatorLifecycleMalformedError_base {
+}
+declare const CoordinatorLifecycleMissingEventError_base: Schema.Class<CoordinatorLifecycleMissingEventError, Schema.TaggedStruct<"CoordinatorLifecycleMissingEventError", {
+    readonly event: Schema.Literals<readonly ["started", "completed"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class CoordinatorLifecycleMissingEventError extends CoordinatorLifecycleMissingEventError_base {
+}
+declare const CoordinatorLifecycleConflictError_base: Schema.Class<CoordinatorLifecycleConflictError, Schema.TaggedStruct<"CoordinatorLifecycleConflictError", {
+    readonly reason: Schema.Literals<readonly ["duplicate_started", "duplicate_completed", "completed_before_started", "request_mismatch", "job_mismatch"]>;
+}>, import("effect/Cause").YieldableError>;
+export declare class CoordinatorLifecycleConflictError extends CoordinatorLifecycleConflictError_base {
+}
+declare const ChatHistoryError_base: Schema.Class<ChatHistoryError, Schema.TaggedStruct<"ChatHistoryError", {
+    readonly cause: Schema.Defect;
+    readonly detail: Schema.String;
+    readonly operation: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class ChatHistoryError extends ChatHistoryError_base {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;;;;AAE/B,qBAAa,kCAAmC,SAAQ,uCAGvD;CAAG;;;;AAEJ,qBAAa,qCAAsC,SAAQ,0CAG1D;CAAG;;;;AAEJ,qBAAa,iCAAkC,SAAQ,sCAWtD;CAAG;;;;;;AAEJ,qBAAa,gBAAiB,SAAQ,qBAGrC;CAAG"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+import { Schema } from "effect";
+export class CoordinatorLifecycleMalformedError extends Schema.TaggedError()("CoordinatorLifecycleMalformedError", { detail: Schema.String }) {
+}
+export class CoordinatorLifecycleMissingEventError extends Schema.TaggedError()("CoordinatorLifecycleMissingEventError", { event: Schema.Literals(["started", "completed"]) }) {
+}
+export class CoordinatorLifecycleConflictError extends Schema.TaggedError()("CoordinatorLifecycleConflictError", {
+    reason: Schema.Literals([
+        "duplicate_started",
+        "duplicate_completed",
+        "completed_before_started",
+        "request_mismatch",
+        "job_mismatch"
+    ])
+}) {
+}
+export class ChatHistoryError extends Schema.TaggedError()("ChatHistoryError", { cause: Schema.Defect(), detail: Schema.String, operation: Schema.String }) {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,OAAO,kCAAmC,SAAQ,MAAM,CAAC,WAAW,EAAsC,CAC9G,oCAAoC,EACpC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAC1B;CAAG;AAEJ,MAAM,OAAO,qCAAsC,SAAQ,MAAM,CAAC,WAAW,EAAyC,CACpH,uCAAuC,EACvC,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,EAAE,CACrD;CAAG;AAEJ,MAAM,OAAO,iCAAkC,SAAQ,MAAM,CAAC,WAAW,EAAqC,CAC5G,mCAAmC,EACnC;IACE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC;QACtB,mBAAmB;QACnB,qBAAqB;QACrB,0BAA0B;QAC1B,kBAAkB;QAClB,cAAc;KACf,CAAC;CACH,CACF;CAAG;AAEJ,MAAM,OAAO,gBAAiB,SAAQ,MAAM,CAAC,WAAW,EAAoB,CAC1E,kBAAkB,EAClB,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAC5E;CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./chat.js";
+export * from "./errors.js";
+export * from "./lifecycle.js";
+export * from "./model.js";
+export * from "./store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./chat.js";
+export * from "./errors.js";
+export * from "./lifecycle.js";
+export * from "./model.js";
+export * from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,20 @@
+import type { AgentWorkerIdentity } from "@knpkv/herdr-fleet";
+import { Effect } from "effect";
+import { CoordinatorLifecycleConflictError, CoordinatorLifecycleMalformedError, CoordinatorLifecycleMissingEventError } from "./errors.js";
+export declare const makeCoordinatorLifecycle: <E, R>(expectedJobId: string, workerStarted: (identity: AgentWorkerIdentity) => Effect.Effect<void, E, R>) => {
+    accept: (line: string) => Effect.Effect<undefined, E | CoordinatorLifecycleConflictError | CoordinatorLifecycleMalformedError, R>;
+    finish: () => Effect.Effect<{
+        reply: string;
+        worker: {
+            readonly host: string;
+            readonly agentId: string;
+            readonly name: string;
+            readonly paneId: string;
+            readonly relationship?: {
+                readonly parentAgentId: string;
+                readonly relation: "delegated" | "pair" | "review";
+            };
+        };
+    }, CoordinatorLifecycleMissingEventError, never>;
+};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,MAAM,EAAU,MAAM,QAAQ,CAAA;AACvC,OAAO,EACL,iCAAiC,EACjC,kCAAkC,EAClC,qCAAqC,EACtC,MAAM,aAAa,CAAA;AAmEpB,eAAO,MAAM,wBAAwB,GAAI,CAAC,EAAE,CAAC,iBAC5B,MAAM,iBACN,CACb,QAAQ,EAAE,mBAAmB,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;;;;;;;;;;;;;;;CA8D/B,CAAA"}

package/dist/lifecycle.js

@@ -0,0 +1,102 @@
+import { Effect, Schema } from "effect";
+import { CoordinatorLifecycleConflictError, CoordinatorLifecycleMalformedError, CoordinatorLifecycleMissingEventError } from "./errors.js";
+import { CoordinatorLifecycleEvent } from "./model.js";
+const JsonObject = Schema.Record(Schema.String, Schema.Json);
+const EventTag = Schema.Struct({ type: Schema.Literals(["started", "completed"]) });
+const exactKeys = (value, expected) => {
+    const actual = Object.keys(value).sort();
+    const wanted = [...expected].sort();
+    return actual.length === wanted.length &&
+        actual.every((key, index) => key === wanted[index]);
+};
+const malformed = (detail) => new CoordinatorLifecycleMalformedError({ detail });
+const decodeLine = Effect.fn("CoordinatorLifecycle.decodeLine")(function* (line) {
+    const json = yield* Effect.try({
+        try: () => JSON.parse(line),
+        catch: () => malformed("lifecycle event is not JSON")
+    });
+    const object = yield* Schema.decodeUnknownEffect(JsonObject)(json).pipe(Effect.mapError(() => malformed("lifecycle event is not an object")));
+    const tag = yield* Schema.decodeUnknownEffect(EventTag)(object).pipe(Effect.mapError(() => malformed("lifecycle event type is invalid")));
+    const expected = tag.type === "started"
+        ? ["jobId", "protocol", "requestId", "type", "worker"]
+        : ["jobId", "protocol", "reply", "requestId", "type"];
+    if (!exactKeys(object, expected)) {
+        return yield* malformed("lifecycle event contains unexpected fields");
+    }
+    if (tag.type === "started") {
+        const worker = yield* Schema.decodeUnknownEffect(JsonObject)(object.worker).pipe(Effect.mapError(() => malformed("started worker payload is not an object")));
+        const workerKeys = Object.keys(worker);
+        if (!exactKeys(worker, ["agentId", "host", "name", "paneId"]) &&
+            !exactKeys(worker, ["agentId", "host", "name", "paneId", "relationship"])) {
+            return yield* malformed("started worker payload contains unexpected fields");
+        }
+        if (!workerKeys.includes("relationship")) {
+            return yield* Schema.decodeUnknownEffect(CoordinatorLifecycleEvent)(object).pipe(Effect.mapError(() => malformed("lifecycle event fields are invalid")));
+        }
+        const relationship = yield* Schema.decodeUnknownEffect(JsonObject)(worker.relationship).pipe(Effect.mapError(() => malformed("started relationship payload is not an object")));
+        if (!exactKeys(relationship, ["parentAgentId", "relation"])) {
+            return yield* malformed("started relationship payload contains unexpected fields");
+        }
+    }
+    return yield* Schema.decodeUnknownEffect(CoordinatorLifecycleEvent)(object).pipe(Effect.mapError(() => malformed("lifecycle event fields are invalid")));
+});
+export const makeCoordinatorLifecycle = (expectedJobId, workerStarted) => {
+    let identity;
+    let reply;
+    let requestId;
+    const accept = Effect.fn("CoordinatorLifecycle.accept")(function* (line) {
+        const event = yield* decodeLine(line);
+        if (event.jobId !== expectedJobId) {
+            return yield* new CoordinatorLifecycleConflictError({
+                reason: "job_mismatch"
+            });
+        }
+        if (event.type === "started") {
+            if (identity !== undefined) {
+                return yield* new CoordinatorLifecycleConflictError({
+                    reason: "duplicate_started"
+                });
+            }
+            if (reply !== undefined) {
+                return yield* new CoordinatorLifecycleConflictError({
+                    reason: "completed_before_started"
+                });
+            }
+            identity = event.worker;
+            requestId = event.requestId;
+            yield* workerStarted(event.worker);
+            return;
+        }
+        if (identity === undefined) {
+            return yield* new CoordinatorLifecycleConflictError({
+                reason: "completed_before_started"
+            });
+        }
+        if (reply !== undefined) {
+            return yield* new CoordinatorLifecycleConflictError({
+                reason: "duplicate_completed"
+            });
+        }
+        if (requestId !== event.requestId) {
+            return yield* new CoordinatorLifecycleConflictError({
+                reason: "request_mismatch"
+            });
+        }
+        reply = event.reply;
+    });
+    const finish = Effect.fn("CoordinatorLifecycle.finish")(function* () {
+        if (identity === undefined) {
+            return yield* new CoordinatorLifecycleMissingEventError({
+                event: "started"
+            });
+        }
+        if (reply === undefined) {
+            return yield* new CoordinatorLifecycleMissingEventError({
+                event: "completed"
+            });
+        }
+        return { reply, worker: identity };
+    });
+    return { accept, finish };
+};
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

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

package/dist/model.d.ts

@@ -0,0 +1,126 @@
+import { Schema } from "effect";
+export declare const ChatMode: Schema.Literals<readonly ["ask", "work"]>;
+export type ChatMode = typeof ChatMode.Type;
+export declare const ChatMessage: Schema.Trimmed;
+export declare const ChatRequest: Schema.Struct<{
+    readonly message: Schema.Trimmed;
+    readonly mode: Schema.Literals<readonly ["ask", "work"]>;
+}>;
+export interface ChatRequest extends Schema.Schema.Type<typeof ChatRequest> {
+}
+export declare const StoredChatTurn: Schema.Struct<{
+    readonly createdAt: Schema.Number;
+    readonly id: Schema.String;
+    readonly jobId: Schema.String;
+    readonly message: Schema.Trimmed;
+    readonly mode: Schema.Literals<readonly ["ask", "work"]>;
+}>;
+export interface StoredChatTurn extends Schema.Schema.Type<typeof StoredChatTurn> {
+}
+export declare const ChatState: Schema.Literals<readonly ["pending", "running", "failed", "interrupted", "completed"]>;
+export type ChatState = typeof ChatState.Type;
+export declare const CoordinatorReply: Schema.String;
+export declare const chatHistoryMaxEntries = 32;
+export declare const ChatEntry: Schema.Struct<{
+    readonly createdAt: Schema.Number;
+    readonly id: Schema.String;
+    readonly message: Schema.Trimmed;
+    readonly mode: Schema.Literals<readonly ["ask", "work"]>;
+    readonly reply: Schema.NullOr<Schema.String>;
+    readonly state: Schema.Literals<readonly ["pending", "running", "failed", "interrupted", "completed"]>;
+    readonly updatedAt: Schema.Number;
+    readonly worker: Schema.optionalKey<Schema.Struct<{
+        readonly host: Schema.String;
+        readonly agentId: Schema.String;
+        readonly name: Schema.String;
+        readonly paneId: Schema.String;
+        readonly relationship: Schema.optionalKey<Schema.Struct<{
+            readonly parentAgentId: Schema.String;
+            readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+        }>>;
+    }>>;
+    readonly connectTarget: Schema.optionalKey<Schema.Struct<{
+        readonly host: Schema.String;
+        readonly agentId: Schema.String;
+        readonly url: Schema.String;
+    }>>;
+}>;
+export interface ChatEntry extends Schema.Schema.Type<typeof ChatEntry> {
+}
+export declare const ChatHistory: Schema.Struct<{
+    readonly entries: Schema.$Array<Schema.Struct<{
+        readonly createdAt: Schema.Number;
+        readonly id: Schema.String;
+        readonly message: Schema.Trimmed;
+        readonly mode: Schema.Literals<readonly ["ask", "work"]>;
+        readonly reply: Schema.NullOr<Schema.String>;
+        readonly state: Schema.Literals<readonly ["pending", "running", "failed", "interrupted", "completed"]>;
+        readonly updatedAt: Schema.Number;
+        readonly worker: Schema.optionalKey<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly agentId: Schema.String;
+            readonly name: Schema.String;
+            readonly paneId: Schema.String;
+            readonly relationship: Schema.optionalKey<Schema.Struct<{
+                readonly parentAgentId: Schema.String;
+                readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+            }>>;
+        }>>;
+        readonly connectTarget: Schema.optionalKey<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly agentId: Schema.String;
+            readonly url: Schema.String;
+        }>>;
+    }>>;
+}>;
+export interface ChatHistory extends Schema.Schema.Type<typeof ChatHistory> {
+}
+export declare const CoordinatorLifecycleStarted: Schema.Struct<{
+    readonly protocol: Schema.Literal<"herdr.coordinator.child.v1">;
+    readonly jobId: Schema.String;
+    readonly requestId: Schema.String;
+    readonly type: Schema.Literal<"started">;
+    readonly worker: Schema.Struct<{
+        readonly host: Schema.String;
+        readonly agentId: Schema.String;
+        readonly name: Schema.String;
+        readonly paneId: Schema.String;
+        readonly relationship: Schema.optionalKey<Schema.Struct<{
+            readonly parentAgentId: Schema.String;
+            readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+        }>>;
+    }>;
+}>;
+export type CoordinatorLifecycleStarted = typeof CoordinatorLifecycleStarted.Type;
+export declare const CoordinatorLifecycleCompleted: Schema.Struct<{
+    readonly protocol: Schema.Literal<"herdr.coordinator.child.v1">;
+    readonly jobId: Schema.String;
+    readonly reply: Schema.String;
+    readonly requestId: Schema.String;
+    readonly type: Schema.Literal<"completed">;
+}>;
+export type CoordinatorLifecycleCompleted = typeof CoordinatorLifecycleCompleted.Type;
+export declare const CoordinatorLifecycleEvent: Schema.Union<readonly [Schema.Struct<{
+    readonly protocol: Schema.Literal<"herdr.coordinator.child.v1">;
+    readonly jobId: Schema.String;
+    readonly requestId: Schema.String;
+    readonly type: Schema.Literal<"started">;
+    readonly worker: Schema.Struct<{
+        readonly host: Schema.String;
+        readonly agentId: Schema.String;
+        readonly name: Schema.String;
+        readonly paneId: Schema.String;
+        readonly relationship: Schema.optionalKey<Schema.Struct<{
+            readonly parentAgentId: Schema.String;
+            readonly relation: Schema.Literals<readonly ["delegated", "pair", "review"]>;
+        }>>;
+    }>;
+}>, Schema.Struct<{
+    readonly protocol: Schema.Literal<"herdr.coordinator.child.v1">;
+    readonly jobId: Schema.String;
+    readonly reply: Schema.String;
+    readonly requestId: Schema.String;
+    readonly type: Schema.Literal<"completed">;
+}>]>;
+export type CoordinatorLifecycleEvent = typeof CoordinatorLifecycleEvent.Type;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAU/B,eAAO,MAAM,QAAQ,2CAAmC,CAAA;AACxD,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C,eAAO,MAAM,WAAW,gBAIvB,CAAA;AAED,eAAO,MAAM,WAAW;;;EAA0D,CAAA;AAClF,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC;CAAG;AAE9E,eAAO,MAAM,cAAc;;;;;;EAMzB,CAAA;AACF,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,CAAC;CAAG;AAEpF,eAAO,MAAM,SAAS,wFAAgF,CAAA;AACtG,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAA;AAE7C,eAAO,MAAM,gBAAgB,eAI5B,CAAA;AAED,eAAO,MAAM,qBAAqB,KAAK,CAAA;AAEvC,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;EAoBrB,CAAA;AACD,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC;CAAG;AAE1E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;EAEtB,CAAA;AACF,MAAM,WAAW,WAAY,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC;CAAG;AAE9E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAMtC,CAAA;AACF,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAC,IAAI,CAAA;AAEjF,eAAO,MAAM,6BAA6B;;;;;;EAMxC,CAAA;AACF,MAAM,MAAM,6BAA6B,GAAG,OAAO,6BAA6B,CAAC,IAAI,CAAA;AAErF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;IAGpC,CAAA;AACF,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAA"}

package/dist/model.js

@@ -0,0 +1,55 @@
+import { AgentConnectTarget, AgentWorkerIdentity } from "@knpkv/herdr-fleet/model";
+import { Schema } from "effect";
+const Identifier = Schema.String.check(Schema.isNonEmpty(), Schema.isMaxLength(256));
+const utf8 = new TextEncoder();
+const utf8MaxBytes = (maximumBytes) => Schema.makeFilter((value) => utf8.encode(value).byteLength <= maximumBytes, { expected: `UTF-8 text no larger than ${maximumBytes} bytes` });
+export const ChatMode = Schema.Literals(["ask", "work"]);
+export const ChatMessage = Schema.Trimmed.check(Schema.isNonEmpty(), Schema.isMaxLength(2_000), utf8MaxBytes(2_000));
+export const ChatRequest = Schema.Struct({ message: ChatMessage, mode: ChatMode });
+export const StoredChatTurn = Schema.Struct({
+    createdAt: Schema.Number,
+    id: Identifier,
+    jobId: Identifier,
+    message: ChatMessage,
+    mode: ChatMode
+});
+export const ChatState = Schema.Literals(["pending", "running", "failed", "interrupted", "completed"]);
+export const CoordinatorReply = Schema.String.check(Schema.isNonEmpty(), Schema.isMaxLength(20_000), utf8MaxBytes(20_000));
+export const chatHistoryMaxEntries = 32;
+export const ChatEntry = Schema.Struct({
+    createdAt: Schema.Number,
+    id: Identifier,
+    message: ChatMessage,
+    mode: ChatMode,
+    reply: Schema.NullOr(CoordinatorReply),
+    state: ChatState,
+    updatedAt: Schema.Number,
+    worker: Schema.optionalKey(AgentWorkerIdentity),
+    connectTarget: Schema.optionalKey(AgentConnectTarget)
+}).check(Schema.makeFilter((entry) => (entry.worker === undefined && entry.connectTarget === undefined) ||
+    (entry.worker !== undefined &&
+        entry.connectTarget !== undefined &&
+        entry.worker.host === entry.connectTarget.host &&
+        entry.worker.agentId === entry.connectTarget.agentId), { expected: "exact Connect target for the matching coordinator worker" }));
+export const ChatHistory = Schema.Struct({
+    entries: Schema.Array(ChatEntry).check(Schema.isMaxLength(chatHistoryMaxEntries))
+});
+export const CoordinatorLifecycleStarted = Schema.Struct({
+    protocol: Schema.Literal("herdr.coordinator.child.v1"),
+    jobId: Identifier,
+    requestId: Identifier,
+    type: Schema.Literal("started"),
+    worker: AgentWorkerIdentity
+});
+export const CoordinatorLifecycleCompleted = Schema.Struct({
+    protocol: Schema.Literal("herdr.coordinator.child.v1"),
+    jobId: Identifier,
+    reply: CoordinatorReply,
+    requestId: Identifier,
+    type: Schema.Literal("completed")
+});
+export const CoordinatorLifecycleEvent = Schema.Union([
+    CoordinatorLifecycleStarted,
+    CoordinatorLifecycleCompleted
+]);
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,32 @@
+import { Effect, FileSystem, Path } from "effect";
+import { ChatHistoryError } from "./errors.js";
+import { StoredChatTurn, type StoredChatTurn as StoredChatTurnType } from "./model.js";
+export interface ChatStoreService {
+    readonly getByJob: (jobId: string) => Effect.Effect<StoredChatTurnType | undefined, ChatHistoryError>;
+    readonly list: () => Effect.Effect<ReadonlyArray<StoredChatTurnType>, ChatHistoryError>;
+    readonly put: (turn: StoredChatTurnType) => Effect.Effect<StoredChatTurnType, ChatHistoryError>;
+}
+export declare class ChatStore {
+    #private;
+    readonly path: string;
+    private constructor();
+    static readonly open: (path: string) => Effect.Effect<ChatStore, ChatHistoryError, FileSystem.FileSystem | Path.Path>;
+    readonly put: (this: ChatStore, turn: StoredChatTurn) => Effect.Effect<StoredChatTurn, ChatHistoryError, never>;
+    readonly getByJob: (this: ChatStore, jobId: string) => Effect.Effect<{
+        readonly createdAt: number;
+        readonly id: string;
+        readonly jobId: string;
+        readonly message: string;
+        readonly mode: "ask" | "work";
+    } | undefined, ChatHistoryError, never>;
+    readonly list: (this: ChatStore) => Effect.Effect<{
+        readonly createdAt: number;
+        readonly id: string;
+        readonly jobId: string;
+        readonly message: string;
+        readonly mode: "ask" | "work";
+    }[], ChatHistoryError, never>;
+    private secureFiles;
+    close(): void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAU,MAAM,QAAQ,CAAA;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAyB,cAAc,EAAE,KAAK,cAAc,IAAI,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAmB7G,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,CACjB,KAAK,EAAE,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,kBAAkB,GAAG,SAAS,EAAE,gBAAgB,CAAC,CAAA;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,EAAE,gBAAgB,CAAC,CAAA;IACvF,QAAQ,CAAC,GAAG,EAAE,CACZ,IAAI,EAAE,kBAAkB,KACrB,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAA;CACzD;AAED,qBAAa,SAAS;;IAGpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,OAAO,eAkBN;IAED,MAAM,CAAC,QAAQ,CAAC,IAAI,kGAgBlB;IAEF,QAAQ,CAAC,GAAG,oGAeV;IAEF,QAAQ,CAAC,QAAQ;;;;;;4CASf;IAEF,QAAQ,CAAC,IAAI;;;;;;kCAeX;IAEF,OAAO,CAAC,WAAW;IAoBnB,KAAK,IAAI,IAAI,CAEZ;CACF"}

package/dist/store.js

@@ -0,0 +1,93 @@
+import { Effect, FileSystem, Path, Schema } from "effect";
+import { DatabaseSync } from "node:sqlite";
+import { ChatHistoryError } from "./errors.js";
+import { chatHistoryMaxEntries, StoredChatTurn } from "./model.js";
+const storeError = (operation) => (cause) => new ChatHistoryError({ cause, detail: String(cause), operation });
+const StoredTurnRow = Schema.Struct({ record: Schema.String });
+const decodeTurn = (encoded) => Effect.try({
+    try: () => Schema.decodeUnknownSync(StoredChatTurn)(JSON.parse(encoded)),
+    catch: storeError("chat.parse")
+});
+const decodeRow = (operation, row) => Schema.decodeUnknownEffect(StoredTurnRow)(row).pipe(Effect.mapError(storeError(operation)), Effect.flatMap(({ record }) => decodeTurn(record)));
+export class ChatStore {
+    #database;
+    #fileSystem;
+    path;
+    constructor(path, fileSystem) {
+        this.path = path;
+        this.#fileSystem = fileSystem;
+        this.#database = new DatabaseSync(path);
+        try {
+            this.#database.exec(`
+        PRAGMA journal_mode = WAL;
+        CREATE TABLE IF NOT EXISTS chat_turns (
+          id TEXT PRIMARY KEY,
+          job_id TEXT NOT NULL UNIQUE,
+          created_at INTEGER NOT NULL,
+          record TEXT NOT NULL
+        );
+      `);
+        }
+        catch (error) {
+            this.#database.close();
+            throw error;
+        }
+    }
+    static open = Effect.fn("ChatStore.open")(function* (path) {
+        const fileSystem = yield* FileSystem.FileSystem;
+        const paths = yield* Path.Path;
+        const directory = paths.dirname(path);
+        yield* fileSystem.makeDirectory(directory, { recursive: true, mode: 0o700 }).pipe(Effect.mapError(storeError("chat.openDirectory")));
+        yield* fileSystem.chmod(directory, 0o700).pipe(Effect.mapError(storeError("chat.secureDirectory")));
+        const store = yield* Effect.try({
+            try: () => new ChatStore(path, fileSystem),
+            catch: storeError("chat.openDatabase")
+        });
+        yield* store.secureFiles();
+        return store;
+    });
+    put = Effect.fn("ChatStore.put")(function* (turn) {
+        const stored = yield* Effect.try({
+            try: () => {
+                this.#database
+                    .prepare("INSERT INTO chat_turns (id, job_id, created_at, record) VALUES (?, ?, ?, ?)")
+                    .run(turn.id, turn.jobId, turn.createdAt, JSON.stringify(turn));
+                return turn;
+            },
+            catch: storeError("chat.put")
+        });
+        yield* this.secureFiles();
+        return stored;
+    });
+    getByJob = Effect.fn("ChatStore.getByJob")(function* (jobId) {
+        const row = yield* Effect.try({
+            try: () => this.#database.prepare("SELECT record FROM chat_turns WHERE job_id = ?").get(jobId),
+            catch: storeError("chat.getByJob")
+        });
+        return row === undefined ? undefined : yield* decodeRow("chat.getByJob", row);
+    });
+    list = Effect.fn("ChatStore.list")(function* () {
+        const rows = yield* Effect.try({
+            try: () => this.#database.prepare(`SELECT record FROM (
+           SELECT id, created_at, record
+           FROM chat_turns
+           ORDER BY created_at DESC, id DESC
+           LIMIT ?
+         )
+         ORDER BY created_at ASC, id ASC`).all(chatHistoryMaxEntries),
+            catch: storeError("chat.list")
+        });
+        return yield* Effect.forEach(rows, (row) => decodeRow("chat.list", row));
+    });
+    secureFiles() {
+        const fileSystem = this.#fileSystem;
+        const files = [this.path, `${this.path}-wal`, `${this.path}-shm`];
+        return Effect.forEach(files, (path) => fileSystem.exists(path).pipe(Effect.mapError(storeError("chat.secureExists")), Effect.flatMap((exists) => exists
+            ? fileSystem.chmod(path, 0o600).pipe(Effect.mapError(storeError("chat.secureChmod")))
+            : Effect.void)), { discard: true });
+    }
+    close() {
+        this.#database.close();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@knpkv/herdr-coordinator",
+  "version": "0.2.0",
+  "description": "Persistent coordinator chat contracts for Herdr fleet jobs",
+  "license": "MIT",
+  "author": "knpkv",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/knpkv/npm.git",
+    "directory": "packages/herdr-coordinator"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./model": {
+      "types": "./dist/model.d.ts",
+      "import": "./dist/model.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "dependencies": {
+    "effect": "4.0.0-rc.109",
+    "@knpkv/herdr-fleet": "^0.2.0"
+  },
+  "devDependencies": {
+    "@effect/platform-node": "4.0.0-rc.109",
+    "@effect/vitest": "4.0.0-rc.109",
+    "@types/node": "^26.2.0",
+    "rimraf": "^6.1.3",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc -b --force",
+    "check": "tsc -b tsconfig.json",
+    "clean": "rimraf dist *.tsbuildinfo",
+    "lint": "eslint \"{src,test}/**/*.ts\"",
+    "pack:deterministic": "pnpm build && node ../../scripts/pack-herdr.mjs .",
+    "test": "vitest run"
+  }
+}