@knpkv/herdr-hub 0.21.0 → 0.22.0

package/dist/module-contract.d.ts

@@ -1,5 +1,5 @@
 import { Result, Schema } from "effect";
-export declare const ModuleListener: Schema.Literals<readonly ["serve", "approval", "tailnet", "lan", "work"]>;
+export declare const ModuleListener: Schema.Literals<readonly ["serve", "approval", "tailnet", "lan"]>;
 export type ModuleListener = typeof ModuleListener.Type;
 /** Shared metadata. `requires` describes UI capabilities; the server mount enforces access. */
 export declare const ModuleDescriptor: Schema.Struct<{
@@ -10,7 +10,7 @@ export declare const ModuleDescriptor: Schema.Struct<{
         readonly id: Schema.String;
         readonly label: Schema.String;
     }>>;
-    readonly listeners: Schema.$Array<Schema.Literals<readonly ["serve", "approval", "tailnet", "lan", "work"]>>;
+    readonly listeners: Schema.$Array<Schema.Literals<readonly ["serve", "approval", "tailnet", "lan"]>>;
     readonly requires: Schema.$Array<Schema.Literals<readonly ["read", "write"]>>;
 }>;
 export type ModuleDescriptor = typeof ModuleDescriptor.Type;
@@ -52,5 +52,16 @@ export declare const fleetModule: {
     readonly requires: readonly ["read", "write"];
 };
 export type FleetModuleDestination = ModuleDestination<typeof fleetModule>;
+export declare const todayModule: {
+    readonly id: "today";
+    readonly label: "Today";
+    readonly defaultPage: "overview";
+    readonly pages: readonly [{
+        readonly id: "overview";
+        readonly label: "Today";
+    }];
+    readonly listeners: readonly ["serve"];
+    readonly requires: readonly ["read"];
+};
 export {};
 //# sourceMappingURL=module-contract.d.ts.map

package/dist/module-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-contract.d.ts","sourceRoot":"","sources":["../src/module-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAKvC,eAAO,MAAM,cAAc,2EAAmE,CAAA;AAC9F,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB;;;;;;;;;;EAO3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;;;;;AAE3D,qBAAa,uBAAwB,SAAQ,4BAY3C;CAAG;AAEL,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,UAC1B,aAAa,CAAC,gBAAgB,CAAC,KACrC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAuBxE,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,YAAY,GAAI,KAAK,CAAC,CAAC,SAAS,gBAAgB,cAAc,CAAC,KAAG,CAAe,CAAA;AAE9F,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,CAAC,SAAS,gBAAgB,GACrG;IAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;CAAE,GACrE,KAAK,CAAA;AAET,iGAAiG;AACjG,eAAO,MAAM,yBAAyB,gBAAiB,aAAa,CAAC,gBAAgB,CAAC,KAAG,MAUtF,CAAA;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;CAYtB,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAAA"}
+{"version":3,"file":"module-contract.d.ts","sourceRoot":"","sources":["../src/module-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAKvC,eAAO,MAAM,cAAc,mEAA2D,CAAA;AACtF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB;;;;;;;;;;EAO3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;;;;;AAE3D,qBAAa,uBAAwB,SAAQ,4BAY3C;CAAG;AAEL,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,UAC1B,aAAa,CAAC,gBAAgB,CAAC,KACrC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAuBxE,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,YAAY,GAAI,KAAK,CAAC,CAAC,SAAS,gBAAgB,cAAc,CAAC,KAAG,CAAe,CAAA;AAE9F,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,CAAC,SAAS,gBAAgB,GACrG;IAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAA;CAAE,GACrE,KAAK,CAAA;AAET,iGAAiG;AACjG,eAAO,MAAM,yBAAyB,gBAAiB,aAAa,CAAC,gBAAgB,CAAC,KAAG,MAUtF,CAAA;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;CAYtB,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAAA;AAE1E,eAAO,MAAM,WAAW;;;;;;;;;;CAOtB,CAAA"}

package/dist/module-contract.js

@@ -1,7 +1,7 @@
 import { Result, Schema } from "effect";
 const Segment = Schema.String.check(Schema.isPattern(/^[a-z][a-z0-9-]*$/));
 const Label = Schema.String.check(Schema.isMinLength(1));
-export const ModuleListener = Schema.Literals(["serve", "approval", "tailnet", "lan", "work"]);
+export const ModuleListener = Schema.Literals(["serve", "approval", "tailnet", "lan"]);
 /** Shared metadata. `requires` describes UI capabilities; the server mount enforces access. */
 export const ModuleDescriptor = Schema.Struct({
     id: Segment,
@@ -74,4 +74,12 @@ export const fleetModule = defineModule({
     listeners: ["serve"],
     requires: ["read", "write"]
 });
+export const todayModule = defineModule({
+    id: "today",
+    label: "Today",
+    defaultPage: "overview",
+    pages: [{ id: "overview", label: "Today" }],
+    listeners: ["serve"],
+    requires: ["read"]
+});
 //# sourceMappingURL=module-contract.js.map

package/dist/module-contract.js.map

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

package/dist/module-needs-you-server.d.ts

@@ -0,0 +1,59 @@
+import { Effect } from "effect";
+import { NeedsYouProviderResult } from "./module-needs-you.js";
+export interface NeedsYouProvider {
+    readonly id: string;
+    readonly read: Effect.Effect<NeedsYouProviderResult>;
+}
+/**
+ * Providers close their service requirements at startup. Keep the whole earliest-created row
+ * for duplicate opaque keys; sort expiry ascending, null last, then creation time and key.
+ */
+export declare const collectNeedsYou: (providers: readonly NeedsYouProvider[]) => Effect.Effect<{
+    readonly _tag: "Complete";
+    readonly items: readonly {
+        readonly key: string;
+        readonly provider: string;
+        readonly destination: {
+            readonly _tag: "FleetApproval";
+            readonly module: "fleet";
+            readonly host: string;
+            readonly jobId: string;
+        };
+        readonly kind: "agent.delegate" | "agent.message" | "browser.mcp.recover" | "nix.apply" | "nix.check" | "work.abandon" | "work.admit" | "work.reassign" | "work.reconcile" | "work.recover";
+        readonly actor: string;
+        readonly createdAt: number;
+        readonly expiresAt: number | null;
+    }[];
+} | {
+    readonly _tag: "Partial";
+    readonly items: readonly {
+        readonly key: string;
+        readonly provider: string;
+        readonly destination: {
+            readonly _tag: "FleetApproval";
+            readonly module: "fleet";
+            readonly host: string;
+            readonly jobId: string;
+        };
+        readonly kind: "agent.delegate" | "agent.message" | "browser.mcp.recover" | "nix.apply" | "nix.check" | "work.abandon" | "work.admit" | "work.reassign" | "work.reconcile" | "work.recover";
+        readonly actor: string;
+        readonly createdAt: number;
+        readonly expiresAt: number | null;
+    }[];
+    readonly sources: readonly {
+        readonly provider: string;
+        readonly issue: {
+            readonly state: "truncated";
+        } | {
+            readonly state: "failed";
+            readonly reason: "internal" | "invalid_response" | "offline" | "request_failed" | "timeout" | "unavailable";
+        } | {
+            readonly state: "hosts";
+            readonly hosts: readonly {
+                readonly host: string;
+                readonly reason: "internal" | "invalid_response" | "offline" | "request_failed" | "timeout" | "unavailable";
+            }[];
+        };
+    }[];
+}, never, never>;
+//# sourceMappingURL=module-needs-you-server.d.ts.map

package/dist/module-needs-you-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-needs-you-server.d.ts","sourceRoot":"","sources":["../src/module-needs-you-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAgC,MAAM,QAAQ,CAAA;AACpE,OAAO,EAEL,sBAAsB,EAGvB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAA;CACrD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA6F1B,CAAA"}

package/dist/module-needs-you-server.js

@@ -0,0 +1,96 @@
+import { Cause, Effect, Exit, Option, Result, Schema } from "effect";
+import { NeedsYouProviderResult } from "./module-needs-you.js";
+/**
+ * Providers close their service requirements at startup. Keep the whole earliest-created row
+ * for duplicate opaque keys; sort expiry ascending, null last, then creation time and key.
+ */
+export const collectNeedsYou = Effect.fn("ModuleRegistry.collectNeedsYou")(function* (providers) {
+    const readings = yield* Effect.forEach(providers, Effect.fnUntraced(function* (provider) {
+        const result = yield* Effect.exit(provider.read.pipe(Effect.timeoutOption("4 seconds")));
+        if (Exit.isFailure(result)) {
+            if (Cause.hasInterrupts(result.cause))
+                return yield* Effect.failCause(result.cause);
+            yield* Effect.logError("Needs-you provider failed", result.cause).pipe(Effect.annotateLogs("module", provider.id));
+            return {
+                items: [],
+                sources: [{
+                        provider: provider.id,
+                        issue: {
+                            state: "failed",
+                            reason: "internal"
+                        }
+                    }]
+            };
+        }
+        if (Option.isNone(result.value)) {
+            return {
+                items: [],
+                sources: [{
+                        provider: provider.id,
+                        issue: {
+                            state: "failed",
+                            reason: "timeout"
+                        }
+                    }]
+            };
+        }
+        const decoded = Schema.decodeUnknownResult(NeedsYouProviderResult, { onExcessProperty: "error" })(result.value.value);
+        if (Result.isFailure(decoded) || decoded.success.items.some((item) => item.destination.module !== provider.id)) {
+            return {
+                items: [],
+                sources: [{
+                        provider: provider.id,
+                        issue: {
+                            state: "failed",
+                            reason: "invalid_response"
+                        }
+                    }]
+            };
+        }
+        return {
+            items: decoded.success.items.map(({ sourceKey, ...item }) => ({
+                ...item,
+                provider: provider.id,
+                key: `${provider.id}:${sourceKey}`
+            })),
+            sources: decoded.success.issues.map((issue) => ({ provider: provider.id, issue }))
+        };
+    }), { concurrency: 4 });
+    const unique = new Map();
+    for (const item of readings.flatMap((reading) => reading.items)) {
+        const previous = unique.get(item.key);
+        if (previous === undefined || item.createdAt < previous.createdAt)
+            unique.set(item.key, item);
+    }
+    const items = [...unique.values()].sort((a, b) => {
+        if (a.expiresAt !== b.expiresAt) {
+            if (a.expiresAt === null)
+                return 1;
+            if (b.expiresAt === null)
+                return -1;
+            return a.expiresAt - b.expiresAt;
+        }
+        return a.createdAt - b.createdAt || (a.key < b.key ? -1 : a.key > b.key ? 1 : 0);
+    });
+    const sources = readings.flatMap((reading) => reading.sources);
+    const counts = new Map();
+    const truncated = new Set();
+    const bounded = [];
+    for (const item of items) {
+        const count = counts.get(item.provider) ?? 0;
+        if (count < 256) {
+            bounded.push(item);
+            counts.set(item.provider, count + 1);
+        }
+        else {
+            truncated.add(item.provider);
+        }
+    }
+    for (const provider of truncated) {
+        if (!sources.some((source) => source.provider === provider && source.issue.state === "truncated")) {
+            sources.push({ provider, issue: { state: "truncated" } });
+        }
+    }
+    return sources.length === 0 ? { _tag: "Complete", items: bounded } : { _tag: "Partial", items: bounded, sources };
+});
+//# sourceMappingURL=module-needs-you-server.js.map

package/dist/module-needs-you-server.js.map

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

package/dist/module-needs-you.d.ts

@@ -0,0 +1,146 @@
+import { Schema } from "effect";
+/** Exact object selectors, without an approval proof, action payload or URL. */
+export declare const NeedsYouDestination: Schema.TaggedStruct<"FleetApproval", {
+    readonly module: Schema.Literal<"fleet">;
+    readonly host: Schema.String;
+    readonly jobId: Schema.String;
+}>;
+export interface NeedsYouDestination extends Schema.Schema.Type<typeof NeedsYouDestination> {
+}
+/** Providers supply local keys; the hub owns their module namespace. */
+export declare const NeedsYouCandidate: Schema.Struct<{
+    readonly sourceKey: Schema.String;
+    readonly destination: Schema.TaggedStruct<"FleetApproval", {
+        readonly module: Schema.Literal<"fleet">;
+        readonly host: Schema.String;
+        readonly jobId: Schema.String;
+    }>;
+    readonly kind: Schema.Literals<readonly ["nix.check", "nix.apply", "agent.delegate", "agent.message", "work.reconcile", "work.admit", "work.recover", "work.reassign", "work.abandon", "browser.mcp.recover"]>;
+    readonly actor: Schema.String;
+    readonly createdAt: Schema.Number;
+    readonly expiresAt: Schema.NullOr<Schema.Number>;
+}>;
+export interface NeedsYouCandidate extends Schema.Schema.Type<typeof NeedsYouCandidate> {
+}
+export declare const NeedsYouFailureReason: Schema.Literals<readonly ["offline", "unavailable", "timeout", "request_failed", "invalid_response", "internal"]>;
+export declare const NeedsYouIssue: Schema.Union<readonly [Schema.Struct<{
+    readonly state: Schema.Literal<"truncated">;
+}>, Schema.Struct<{
+    readonly state: Schema.Literal<"failed">;
+    readonly reason: Schema.Literals<readonly ["offline", "unavailable", "timeout", "request_failed", "invalid_response", "internal"]>;
+}>, Schema.Struct<{
+    readonly state: Schema.Literal<"hosts">;
+    readonly hosts: Schema.$Array<Schema.Struct<{
+        readonly host: Schema.String;
+        readonly reason: Schema.Literals<readonly ["offline", "unavailable", "timeout", "request_failed", "invalid_response", "internal"]>;
+    }>>;
+}>]>;
+export type NeedsYouIssue = typeof NeedsYouIssue.Type;
+/** A failed or bounded source remains visible even when it returned no items. */
+export declare const NeedsYouProviderResult: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly sourceKey: Schema.String;
+        readonly destination: Schema.TaggedStruct<"FleetApproval", {
+            readonly module: Schema.Literal<"fleet">;
+            readonly host: Schema.String;
+            readonly jobId: Schema.String;
+        }>;
+        readonly kind: Schema.Literals<readonly ["nix.check", "nix.apply", "agent.delegate", "agent.message", "work.reconcile", "work.admit", "work.recover", "work.reassign", "work.abandon", "browser.mcp.recover"]>;
+        readonly actor: Schema.String;
+        readonly createdAt: Schema.Number;
+        readonly expiresAt: Schema.NullOr<Schema.Number>;
+    }>>;
+    readonly issues: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly state: Schema.Literal<"truncated">;
+    }>, Schema.Struct<{
+        readonly state: Schema.Literal<"failed">;
+        readonly reason: Schema.Literals<readonly ["offline", "unavailable", "timeout", "request_failed", "invalid_response", "internal"]>;
+    }>, Schema.Struct<{
+        readonly state: Schema.Literal<"hosts">;
+        readonly hosts: Schema.$Array<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly reason: Schema.Literals<readonly ["offline", "unavailable", "timeout", "request_failed", "invalid_response", "internal"]>;
+        }>>;
+    }>]>>;
+}>;
+export interface NeedsYouProviderResult extends Schema.Schema.Type<typeof NeedsYouProviderResult> {
+}
+export declare const NeedsYouItem: Schema.Struct<{
+    readonly key: Schema.String;
+    readonly provider: Schema.String;
+    readonly destination: Schema.TaggedStruct<"FleetApproval", {
+        readonly module: Schema.Literal<"fleet">;
+        readonly host: Schema.String;
+        readonly jobId: Schema.String;
+    }>;
+    readonly kind: Schema.Literals<readonly ["nix.check", "nix.apply", "agent.delegate", "agent.message", "work.reconcile", "work.admit", "work.recover", "work.reassign", "work.abandon", "browser.mcp.recover"]>;
+    readonly actor: Schema.String;
+    readonly createdAt: Schema.Number;
+    readonly expiresAt: Schema.NullOr<Schema.Number>;
+}>;
+export interface NeedsYouItem extends Schema.Schema.Type<typeof NeedsYouItem> {
+}
+export declare const NeedsYouSource: Schema.Struct<{
+    readonly provider: Schema.String;
+    readonly issue: Schema.Union<readonly [Schema.Struct<{
+        readonly state: Schema.Literal<"truncated">;
+    }>, Schema.Struct<{
+        readonly state: Schema.Literal<"failed">;
+        readonly reason: Schema.Literals<readonly ["offline", "unavailable", "timeout", "request_failed", "invalid_response", "internal"]>;
+    }>, Schema.Struct<{
+        readonly state: Schema.Literal<"hosts">;
+        readonly hosts: Schema.$Array<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly reason: Schema.Literals<readonly ["offline", "unavailable", "timeout", "request_failed", "invalid_response", "internal"]>;
+        }>>;
+    }>]>;
+}>;
+export interface NeedsYouSource extends Schema.Schema.Type<typeof NeedsYouSource> {
+}
+/** Complete has no source problems; Partial always names at least one. */
+export declare const NeedsYouResult: Schema.Union<readonly [Schema.TaggedStruct<"Complete", {
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly key: Schema.String;
+        readonly provider: Schema.String;
+        readonly destination: Schema.TaggedStruct<"FleetApproval", {
+            readonly module: Schema.Literal<"fleet">;
+            readonly host: Schema.String;
+            readonly jobId: Schema.String;
+        }>;
+        readonly kind: Schema.Literals<readonly ["nix.check", "nix.apply", "agent.delegate", "agent.message", "work.reconcile", "work.admit", "work.recover", "work.reassign", "work.abandon", "browser.mcp.recover"]>;
+        readonly actor: Schema.String;
+        readonly createdAt: Schema.Number;
+        readonly expiresAt: Schema.NullOr<Schema.Number>;
+    }>>;
+}>, Schema.TaggedStruct<"Partial", {
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly key: Schema.String;
+        readonly provider: Schema.String;
+        readonly destination: Schema.TaggedStruct<"FleetApproval", {
+            readonly module: Schema.Literal<"fleet">;
+            readonly host: Schema.String;
+            readonly jobId: Schema.String;
+        }>;
+        readonly kind: Schema.Literals<readonly ["nix.check", "nix.apply", "agent.delegate", "agent.message", "work.reconcile", "work.admit", "work.recover", "work.reassign", "work.abandon", "browser.mcp.recover"]>;
+        readonly actor: Schema.String;
+        readonly createdAt: Schema.Number;
+        readonly expiresAt: Schema.NullOr<Schema.Number>;
+    }>>;
+    readonly sources: Schema.$Array<Schema.Struct<{
+        readonly provider: Schema.String;
+        readonly issue: Schema.Union<readonly [Schema.Struct<{
+            readonly state: Schema.Literal<"truncated">;
+        }>, Schema.Struct<{
+            readonly state: Schema.Literal<"failed">;
+            readonly reason: Schema.Literals<readonly ["offline", "unavailable", "timeout", "request_failed", "invalid_response", "internal"]>;
+        }>, Schema.Struct<{
+            readonly state: Schema.Literal<"hosts">;
+            readonly hosts: Schema.$Array<Schema.Struct<{
+                readonly host: Schema.String;
+                readonly reason: Schema.Literals<readonly ["offline", "unavailable", "timeout", "request_failed", "invalid_response", "internal"]>;
+            }>>;
+        }>]>;
+    }>>;
+}>]>;
+export type NeedsYouResult = typeof NeedsYouResult.Type;
+//# sourceMappingURL=module-needs-you.d.ts.map

package/dist/module-needs-you.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-needs-you.d.ts","sourceRoot":"","sources":["../src/module-needs-you.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAK/B,gFAAgF;AAChF,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAA;AACF,MAAM,WAAW,mBAAoB,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,mBAAmB,CAAC;CAAG;AAE9F,wEAAwE;AACxE,eAAO,MAAM,iBAAiB;;;;;;;;;;;EAO5B,CAAA;AACF,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,iBAAiB,CAAC;CAAG;AAE1F,eAAO,MAAM,qBAAqB,mHAOhC,CAAA;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;IAUxB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,iFAAiF;AACjF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;EAGjC,CAAA;AACF,MAAM,WAAW,sBAAuB,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC;CAAG;AAGpG,eAAO,MAAM,YAAY;;;;;;;;;;;;EAQvB,CAAA;AACF,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC;CAAG;AAEhF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;EAAgE,CAAA;AAC3F,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,CAAC;CAAG;AAEpF,0EAA0E;AAC1E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA"}

package/dist/module-needs-you.js

@@ -0,0 +1,63 @@
+import { FleetHostName, JobActor, JobIdentifier, JobPayload } from "@knpkv/herdr-fleet/model";
+import { Schema } from "effect";
+const SourceKey = Schema.String.check(Schema.isNonEmpty(), Schema.isMaxLength(512));
+const Timestamp = Schema.Number.check(Schema.isInt(), Schema.isBetween({ minimum: 0, maximum: 8_640_000_000_000_000 }));
+/** Exact object selectors, without an approval proof, action payload or URL. */
+export const NeedsYouDestination = Schema.TaggedStruct("FleetApproval", {
+    module: Schema.Literal("fleet"),
+    host: FleetHostName,
+    jobId: JobIdentifier
+});
+/** Providers supply local keys; the hub owns their module namespace. */
+export const NeedsYouCandidate = Schema.Struct({
+    sourceKey: SourceKey,
+    destination: NeedsYouDestination,
+    kind: Schema.Literals(Schema.Union(JobPayload.members).pipe(Schema.toTaggedUnion("kind")).discriminants),
+    actor: JobActor,
+    createdAt: Timestamp,
+    expiresAt: Schema.NullOr(Timestamp)
+});
+export const NeedsYouFailureReason = Schema.Literals([
+    "offline",
+    "unavailable",
+    "timeout",
+    "request_failed",
+    "invalid_response",
+    "internal"
+]);
+export const NeedsYouIssue = Schema.Union([
+    Schema.Struct({ state: Schema.Literal("truncated") }),
+    Schema.Struct({ state: Schema.Literal("failed"), reason: NeedsYouFailureReason }),
+    Schema.Struct({
+        state: Schema.Literal("hosts"),
+        hosts: Schema.Array(Schema.Struct({
+            host: FleetHostName,
+            reason: NeedsYouFailureReason
+        })).check(Schema.isMinLength(1))
+    })
+]);
+/** A failed or bounded source remains visible even when it returned no items. */
+export const NeedsYouProviderResult = Schema.Struct({
+    items: Schema.Array(NeedsYouCandidate),
+    issues: Schema.Array(NeedsYouIssue)
+});
+const ProviderId = Schema.String.check(Schema.isPattern(/^[a-z][a-z0-9-]*$/));
+export const NeedsYouItem = Schema.Struct({
+    key: Schema.String.check(Schema.isNonEmpty(), Schema.isMaxLength(1_024)),
+    provider: ProviderId,
+    destination: NeedsYouCandidate.fields.destination,
+    kind: NeedsYouCandidate.fields.kind,
+    actor: NeedsYouCandidate.fields.actor,
+    createdAt: NeedsYouCandidate.fields.createdAt,
+    expiresAt: NeedsYouCandidate.fields.expiresAt
+});
+export const NeedsYouSource = Schema.Struct({ provider: ProviderId, issue: NeedsYouIssue });
+/** Complete has no source problems; Partial always names at least one. */
+export const NeedsYouResult = Schema.Union([
+    Schema.TaggedStruct("Complete", { items: Schema.Array(NeedsYouItem) }),
+    Schema.TaggedStruct("Partial", {
+        items: Schema.Array(NeedsYouItem),
+        sources: Schema.Array(NeedsYouSource).check(Schema.isMinLength(1))
+    })
+]);
+//# sourceMappingURL=module-needs-you.js.map

package/dist/module-needs-you.js.map

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

package/dist/module-server.d.ts

@@ -1,5 +1,6 @@
 import { Context, Effect, Layer, Schema } from "effect";
 import { type ModuleDescriptor, type ModuleListener, ModuleRegistrationError } from "./module-contract.js";
+import { type NeedsYouProviderResult } from "./module-needs-you.js";
 export interface ModuleResponse {
     readonly status: 200 | 201 | 202;
     readonly body: Schema.Json;
@@ -24,6 +25,8 @@ export interface ModuleApiRoute {
 }
 declare const ModuleHandlers_base: Context.ServiceClass<ModuleHandlers, "@knpkv/herdr-hub/ModuleHandlers", {
     readonly routes: ReadonlyArray<ModuleApiRoute>;
+    /** Closed over services at layer build; expected source failures are returned as issues. */
+    readonly needsYou?: Effect.Effect<NeedsYouProviderResult>;
 }>;
 export declare class ModuleHandlers extends ModuleHandlers_base {
 }
@@ -43,22 +46,22 @@ export declare class ModuleRegistry extends ModuleRegistry_base {
 }
 /** Validate both registrations before acquiring any module layer; metadata must be shared. */
 export declare const makeModuleLayer: <E, R>(descriptors: ReadonlyArray<ModuleDescriptor>, modules: ReadonlyArray<ServerModule<E, R>>) => Layer.Layer<ModuleRegistry, E | ModuleRegistrationError, R>;
-/** Read routes encode the declared success schema; handlers close over services acquired by their layer. */
-export declare const moduleReadRoute: <A>(path: ModuleApiRoute["path"], success: Schema.Codec<A, Schema.Json, never, never>, handle: (query: URLSearchParams) => Effect.Effect<A, ModuleRouteFailure>, status?: ModuleResponse["status"]) => ModuleApiRoute;
-/** Decode a mutation body after authorization, then encode the declared success schema. */
-export declare const moduleWriteRoute: <A, B>(method: Exclude<ModuleApiRoute["method"], "GET">, path: ModuleApiRoute["path"], schema: Schema.Codec<A, unknown, never, never>, success: Schema.Codec<B, Schema.Json, never, never>, handle: (body: A, query: URLSearchParams) => Effect.Effect<B, ModuleRouteFailure>, status?: ModuleResponse["status"]) => ModuleApiRoute;
+/** Read routes decode a query codec and encode success; stable services are acquired by the product layer. */
+export declare const moduleReadRoute: <Q, A>(path: ModuleApiRoute["path"], querySchema: Schema.Codec<Q, URLSearchParams, never, never>, success: Schema.Codec<A, Schema.Json, never, never>, handle: (query: Q) => Effect.Effect<A, ModuleRouteFailure>, status?: ModuleResponse["status"]) => ModuleApiRoute;
+/** Decode query and body after authorization; handlers receive the validated selectors and body. */
+export declare const moduleWriteRoute: <Q, A, B>(method: Exclude<ModuleApiRoute["method"], "GET">, path: ModuleApiRoute["path"], querySchema: Schema.Codec<Q, URLSearchParams, never, never>, schema: Schema.Codec<A, unknown, never, never>, success: Schema.Codec<B, Schema.Json, never, never>, handle: (body: A, query: Q) => Effect.Effect<B, ModuleRouteFailure>, status?: ModuleResponse["status"]) => ModuleApiRoute;
 /**
  * Return null for unmatched methods, modules or listeners. For `/v1/modules/*`, callers must
  * answer 404 on null, never delegate that namespace to another handler. A work-mode listener
  * remains restricted to its existing peer API and must not invoke this mount.
  */
-export declare const dispatchModuleRoute: <E, R>(request: {
+export declare const dispatchModuleRoute: <E, R, OriginError = E, BodyError = E>(request: {
     readonly method: string;
     readonly url: URL;
-    readonly listener: ModuleListener;
+    readonly listener: ModuleListener | "work";
     readonly authorize: Effect.Effect<unknown, E, R>;
-    readonly sameOrigin: Effect.Effect<unknown, E, R>;
-    readonly readJson: () => Effect.Effect<Schema.Json, E, R>;
-}) => Effect.Effect<ModuleResponse | null, E | ModuleRouteFailure, R | ModuleRegistry>;
+    readonly sameOrigin: Effect.Effect<unknown, OriginError, R>;
+    readonly readJson: () => Effect.Effect<Schema.Json, BodyError, R>;
+}) => Effect.Effect<ModuleResponse | null, BodyError | E | OriginError | ModuleRouteFailure, R | ModuleRegistry>;
 export {};
 //# sourceMappingURL=module-server.d.ts.map

package/dist/module-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-server.d.ts","sourceRoot":"","sources":["../src/module-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/D,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,uBAAuB,EAGxB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAA;CAC3B;;;;;AAED,0FAA0F;AAC1F,qBAAa,kBAAmB,SAAQ,uBAGtC;CAAG;AAEL,QAAA,MAAM,iBAAiB,eAA2B,CAAA;AAGlD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC5D,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,IAAI,MAAM,EAAE,CAAA;CAC5B;;qBAmBoB,aAAa,CAAC,cAAc,CAAC;;AAHlD,qBAAa,cAAe,SAAQ,mBAKE;CAAG;AAEzC,wFAAwF;AACxF,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK;IAChD,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CACrD;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;CAC/C;;sBAKqB,aAAa,CAAC,aAAa,CAAC;;AAHlD,qBAAa,cAAe,SAAQ,mBAKE;CAAG;AAEzC,8FAA8F;AAC9F,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,eACrB,aAAa,CAAC,gBAAgB,CAAC,WACnC,aAAa,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KACzC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,GAAG,uBAAuB,EAAE,CAAC,CAkC1D,CAAA;AAEH,4GAA4G;AAC5G,eAAO,MAAM,eAAe,GAAI,CAAC,QACzB,cAAc,CAAC,MAAM,CAAC,WACnB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,UAC3C,CAAC,KAAK,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,kBAAkB,CAAC,WAChE,cAAc,CAAC,QAAQ,CAAC,KAC/B,cAQG,CAAA;AAEN,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAAE,CAAC,UAC3B,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,QAC1C,cAAc,CAAC,MAAM,CAAC,UACpB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,WACrC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,UAC3C,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,kBAAkB,CAAC,WACzE,cAAc,CAAC,QAAQ,CAAC,KAC/B,cAWG,CAAA;AAEN;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAkD,CAAC,EAAE,CAAC;qBACnE,MAAM;kBACT,GAAG;uBACE,cAAc;wBACb,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;yBAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;uBAC9B,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;sFAoBzD,CAAA"}
+{"version":3,"file":"module-server.d.ts","sourceRoot":"","sources":["../src/module-server.ts"],"names":[],"mappings":"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"}

package/dist/module-server.js

@@ -1,5 +1,7 @@
 import { Context, Effect, Layer, Result, Schema } from "effect";
-import { ModuleRegistrationError, moduleRegistryFingerprint, validateModuleRegistry } from "./module-contract.js";
+import { ModuleRegistrationError, moduleRegistryFingerprint, todayModule, validateModuleRegistry } from "./module-contract.js";
+import { collectNeedsYou } from "./module-needs-you-server.js";
+import { NeedsYouResult } from "./module-needs-you.js";
 /** Safe route failures carry public copy only. Provider errors stay inside the module. */
 export class ModuleRouteFailure extends Schema.TaggedError()("ModuleRouteFailure", {
     status: Schema.Literals([400, 404, 409, 500, 503]),
@@ -38,20 +40,39 @@ export const makeModuleLayer = (descriptors, modules) => Layer.effect(ModuleRegi
             if (!routeHandlers.has(route) || Result.isFailure(Schema.decodeUnknownResult(ApiPath)(route.path))) {
                 return yield* new ModuleRegistrationError({ module: module.descriptor.id, reason: "invalid_route" });
             }
+            if (module.descriptor.id === todayModule.id && route.method === "GET" && route.path === "/needs-you") {
+                return yield* new ModuleRegistrationError({ module: module.descriptor.id, reason: "duplicate_route" });
+            }
             const identity = `${route.method} ${route.path}`;
             if (identities.has(identity)) {
                 return yield* new ModuleRegistrationError({ module: module.descriptor.id, reason: "duplicate_route" });
             }
             identities.add(identity);
         }
-        return { descriptor: module.descriptor, routes: handlers.routes };
+        return { descriptor: module.descriptor, routes: handlers.routes, needsYou: handlers.needsYou };
     }));
-    return { modules: mounted };
+    const providers = mounted.flatMap((module) => module.needsYou === undefined
+        ? [] :
+        [{ id: module.descriptor.id, read: module.needsYou }]);
+    const readNeedsYou = collectNeedsYou(providers);
+    return {
+        modules: mounted.map((module) => ({
+            descriptor: module.descriptor,
+            routes: module.descriptor.id === todayModule.id
+                ? [
+                    ...module.routes,
+                    moduleReadRoute("/needs-you", Schema.fromURLSearchParams(Schema.Record(Schema.String, Schema.Never)), NeedsYouResult, () => readNeedsYou)
+                ]
+                : module.routes
+        }))
+    };
 }));
-/** Read routes encode the declared success schema; handlers close over services acquired by their layer. */
-export const moduleReadRoute = (path, success, handle, status = 200) => registerRoute("GET", path, (query) => handle(query).pipe(Effect.flatMap((body) => Schema.encodeEffect(success)(body)), Effect.mapError((error) => error._tag === "ModuleRouteFailure" ? error : new ModuleRouteFailure({ status: 500, code: "invalid_response" })), Effect.map((body) => ({ status, body }))));
-/** Decode a mutation body after authorization, then encode the declared success schema. */
-export const moduleWriteRoute = (method, path, schema, success, handle, status = 200) => registerRoute(method, path, (query, body) => Schema.decodeUnknownEffect(schema)(body).pipe(Effect.mapError(() => new ModuleRouteFailure({ status: 400, code: "invalid_body" })), Effect.flatMap((decoded) => handle(decoded, query)), Effect.flatMap((response) => Schema.encodeEffect(success)(response).pipe(Effect.mapError(() => new ModuleRouteFailure({ status: 500, code: "invalid_response" })))), Effect.map((body) => ({ status, body }))));
+/** Decode query selectors before the handler; unknown keys fail instead of being discarded. */
+const decodeModuleQuery = (schema, query) => Schema.decodeUnknownEffect(schema, { onExcessProperty: "error" })(query).pipe(Effect.mapError(() => new ModuleRouteFailure({ status: 400, code: "invalid_query" })));
+/** Read routes decode a query codec and encode success; stable services are acquired by the product layer. */
+export const moduleReadRoute = (path, querySchema, success, handle, status = 200) => registerRoute("GET", path, (query) => decodeModuleQuery(querySchema, query).pipe(Effect.flatMap(handle), Effect.flatMap((body) => Schema.encodeEffect(success)(body)), Effect.mapError((error) => error._tag === "ModuleRouteFailure" ? error : new ModuleRouteFailure({ status: 500, code: "invalid_response" })), Effect.map((body) => ({ status, body }))));
+/** Decode query and body after authorization; handlers receive the validated selectors and body. */
+export const moduleWriteRoute = (method, path, querySchema, schema, success, handle, status = 200) => registerRoute(method, path, (query, body) => decodeModuleQuery(querySchema, query).pipe(Effect.flatMap((decodedQuery) => Schema.decodeUnknownEffect(schema)(body).pipe(Effect.mapError(() => new ModuleRouteFailure({ status: 400, code: "invalid_body" })), Effect.flatMap((decoded) => handle(decoded, decodedQuery)))), Effect.flatMap((response) => Schema.encodeEffect(success)(response).pipe(Effect.mapError(() => new ModuleRouteFailure({ status: 500, code: "invalid_response" })))), Effect.map((body) => ({ status, body }))));
 /**
  * Return null for unmatched methods, modules or listeners. For `/v1/modules/*`, callers must
  * answer 404 on null, never delegate that namespace to another handler. A work-mode listener
@@ -63,7 +84,7 @@ export const dispatchModuleRoute = Effect.fn("ModuleRegistry.dispatch")(function
         const prefix = `/v1/modules/${module.descriptor.id}`;
         if (!request.url.pathname.startsWith(`${prefix}/`))
             continue;
-        if (!module.descriptor.listeners.includes(request.listener))
+        if (!module.descriptor.listeners.some((listener) => listener === request.listener))
             return null;
         const route = module.routes.find((candidate) => candidate.method === request.method && `${prefix}${candidate.path}` === request.url.pathname);
         if (route === undefined)