sessionpipe 0.13.0 → 0.13.1

package/dist/run.d.ts

@@ -29,7 +29,7 @@ export declare function releaseJob(claimed: string | undefined): void;
  *  worker lives, `abandonedMs`) goes back to the queue, then every queued job older
  *  than `olderThanMs` (younger ones belong to the worker their hook just spawned)
  *  is claimed and run. Every worker sweeps before it exits. */
-export declare function sweepJobs(state: string, olderThanMs?: number, limit?: number, abandonedMs?: number): Promise<number>;
+export declare function sweepJobs(state: string, olderThanMs?: number, limit?: number, abandonedMs?: number, o?: DrainLife): Promise<number>;
 export declare function log(state: string, line: string): void;
 /** <state>/facts/<harness>/<session>.json — what the machine learned about a session. */
 export declare function factsState(state: string): FactsState;
@@ -62,7 +62,11 @@ export declare function runJob(job: Job, opts?: {
     now?: number;
     claimed?: string;
     lockWaitMs?: number;
-}): Promise<{
+    /** false: the events go to the outbox and the sinks are left for the caller to drain. */
+    drain?: boolean;
+    /** The drain's clock (pacing); tests stand in a simulated one. */
+    clock?: Clock;
+} & DrainLife): Promise<{
     events: Event[];
     delivered: Record<string, number>;
     requeued?: string;
@@ -80,6 +84,28 @@ export declare function appendObserved(state: string, harness: string, id: strin
     now?: number;
     lockWaitMs?: number;
 }): Promise<Event | null>;
+/** What the drain reads the time from and waits with; tests stand in a simulated one. */
+export interface Clock {
+    now(): number;
+    sleep(ms: number): Promise<void>;
+}
+/** A pass of the drain starts at least this long after the machine's last request to
+ *  a receiver (issue #208): under a few hundred subagents a receiver gets one request
+ *  a second with everything that piled up, not one per hook. A lone event goes at once. */
+export declare const PACE_MS = 1000;
+/** How long a worker's life must still run for a pass of the drain to start: the
+ *  pace's wait (≤ PACE_MS) and a round trip. A worker that has less leaves the work
+ *  marked (flush.more) and hands it on (DrainLife.handoff) rather than be ended by its
+ *  deadline mid-pass, holding events nobody else knows to send. */
+export declare const PASS_BUDGET_MS = 3000;
+/** A worker's remaining life, for the drain and the sweep. Both unset: no limit. */
+export interface DrainLife {
+    /** When the process will be ended (epoch ms, on the drain's clock). */
+    deadline?: number;
+    /** Called, with the flush lock released, when work is left marked for another
+     *  worker because this one's life is too short for it (worker.ts starts a drainer). */
+    handoff?: () => void;
+}
 /** One worker drains a machine's sinks at a time (the `flush` lock). Another whose
  *  events are in the outbox meanwhile marks that there is more and leaves them to
  *  it (null: nothing sent by this one). The one draining looks for the mark after
@@ -87,11 +113,17 @@ export declare function appendObserved(state: string, harness: string, id: strin
  *  in its next pass or with the worker that appended them, never wait for a later
  *  hook. Under a flood of hook events this is one uploader sending full batches,
  *  not one per event, all refused together (mordast, 2026-10-14: 828 refusals in
- *  two minutes, 5 192 jobs queued). */
+ *  two minutes, 5 192 jobs queued). A pass that would follow the machine's last
+ *  request by less than PACE_MS first waits out the rest, holding the lock: the
+ *  workers that arrive meanwhile only mark that there is more, and the pass sends
+ *  everything they appended. A pass starts only while the worker's life has
+ *  PASS_BUDGET_MS left; otherwise the mark stays and the work is handed on. */
 export declare function drain(state: string, sinkConfigs: SinkConfig[], outbox: Outbox, first?: {
     harness: string;
     session: string;
-}): Promise<Record<string, number> | null>;
+}, o?: {
+    clock?: Clock;
+} & DrainLife): Promise<Record<string, number> | null>;
 /** HTTP.md §2: a sink that answered 429 isn't tried again before its `retry-after`;
  *  one that was unreachable (5xx, a timeout) waits 2 s · 10 s · 60 s · 5 min · 30 min,
  *  then every 30 min. Kept in <state>/backoff/<sink>.json, so every worker on the
@@ -115,7 +147,10 @@ export declare function flush(state: string, sinkConfigs: SinkConfig[], outbox:
     harness: string;
     session: string;
 }, o?: {
-    force?: boolean;
+    /** Try a sink in backoff anyway (`sessionpipe replay`). */ force?: boolean;
+    /** Stamps the machine's last request (drain's pace). */ clock?: Clock;
+    /** Counts, per sink, the tool events it was configured not to be sent (`replay`). */
+    thinned?: Record<string, number>;
 }): Promise<Record<string, number>>;
 export { VERSION };
 export declare const versionLine: () => string;

package/dist/run.d.ts.map

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

package/dist/secrets.d.ts

@@ -21,10 +21,20 @@ export declare function probe(store: SecretStore, run?: Runner): boolean;
  *  desktop session: on a server its keyring is locked whenever nobody is logged in,
  *  which is exactly when the daemon needs its token. */
 export declare function bestStore(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform, run?: Runner): StoreName;
-export declare const storeLabel: (s: StoreName | undefined) => string;
-/** The sink with its token and secret filled in from its store. Null when they live in
- *  a store this process can't read right now (a keychain locked in an ssh session):
- *  the caller leaves the events in the outbox rather than sending them unsigned. */
+export declare const storeLabel: (s: StoreName | undefined, platform?: NodeJS.Platform) => string;
+/** What keeps a key in the config file private: a mode on POSIX; on Windows, where modes
+ *  mean nothing, the profile folder's own permissions. */
+export declare const fileKept: (platform?: NodeJS.Platform) => string;
+/** `connect`'s line for keys that stay in the file. */
+export declare function keysFileNote(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): string;
+/** The sink with its token and secret filled in from its store: each item the store
+ *  holds, since a sink has a token, a Webhooks secret, or both (`sink add --secret`
+ *  with no `--token` signs and sends no bearer). Null when the store can't be read
+ *  from this process right now (a keychain locked in an ssh session): the caller
+ *  leaves the events in the outbox rather than sending them unsigned. One item and not
+ *  the other is not that: the store has just answered a read from this process, so it
+ *  is readable right now, and the item it didn't give is one it doesn't hold. A locked
+ *  store fails both reads. */
 export declare function sinkWithSecrets(s: SinkConfig, run?: Runner): SinkConfig | null;
 /** Store a sink's secrets in `to` (or back in the file) and save the config. */
 export declare function moveSinkSecrets(to: StoreName, o?: {

package/dist/secrets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAcA,OAAO,EAA0B,KAAK,UAAU,EAAe,MAAM,mBAAmB,CAAC;AAEzF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,gBAAgB,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAI7C,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAChH,eAAO,MAAM,aAAa,EAAE,MAQ3B,CAAC;AAEF;;uFAEuF;AACvF,eAAO,MAAM,WAAW,SAAU,MAAM,SAAQ,OAAO,GAAG,QAAQ,KAAa,MAK9E,CAAC;AACF,eAAO,MAAM,cAAc,YAAa,MAAM,KAAG,MAA8B,CAAC;AAQhF,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAQzG;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAalH;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAGhG;AAED,mFAAmF;AACnF,wBAAgB,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAK9E;AAED;;;wDAGwD;AACxD,wBAAgB,SAAS,CACvB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAsB,GAC1B,SAAS,CAaX;AAED,eAAO,MAAM,UAAU,MAAO,SAAS,GAAG,SAAS,KAAG,MAC2D,CAAC;AAElH;;oFAEoF;AACpF,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAE,MAAsB,GAAG,UAAU,GAAG,IAAI,CAM7F;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,EAAE,EAAE,SAAS,EACb,CAAC,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA+CrC;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAIhF"}
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAcA,OAAO,EAA0B,KAAK,UAAU,EAAe,MAAM,mBAAmB,CAAC;AAEzF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,gBAAgB,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAI7C,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAChH,eAAO,MAAM,aAAa,EAAE,MAQ3B,CAAC;AAEF;;uFAEuF;AACvF,eAAO,MAAM,WAAW,SAAU,MAAM,SAAQ,OAAO,GAAG,QAAQ,KAAa,MAK9E,CAAC;AACF,eAAO,MAAM,cAAc,YAAa,MAAM,KAAG,MAA8B,CAAC;AAQhF,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAQzG;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAalH;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAGhG;AAED,mFAAmF;AACnF,wBAAgB,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAK9E;AAED;;;wDAGwD;AACxD,wBAAgB,SAAS,CACvB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAsB,GAC1B,SAAS,CAaX;AAED,eAAO,MAAM,UAAU,MAAO,SAAS,GAAG,SAAS,aAAY,MAAM,CAAC,QAAQ,KAAsB,MAO7E,CAAC;AAExB;0DAC0D;AAC1D,eAAO,MAAM,QAAQ,cAAc,MAAM,CAAC,QAAQ,KAAsB,MACV,CAAC;AAE/D,uDAAuD;AACvD,wBAAgB,YAAY,CAC1B,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAGR;AAED;;;;;;;8BAO8B;AAC9B,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAE,MAAsB,GAAG,UAAU,GAAG,IAAI,CAM7F;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,EAAE,EAAE,SAAS,EACb,CAAC,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACtC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA8CrC;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAIhF"}

package/dist/wellknown.d.ts

@@ -0,0 +1,31 @@
+import { type Config, type SinkConfig, type Tier } from "@sessionpipe/core";
+import { type ToolsMode } from "./fold.js";
+export interface WellKnownRead {
+    max_tier?: number;
+    endpoints?: {
+        events?: string;
+    };
+    capabilities?: string[];
+    tools?: unknown;
+}
+/** How long what a worker learned stands before it reads the file again. */
+export declare const WELL_KNOWN_MAX_AGE_MS: number;
+export declare const wellKnownUrl: (sinkUrl: string) => string;
+/** The file, parsed; throws with a sentence (`HTTP 404`, the fetch's own words) when it can't be read. */
+export declare function readWellKnown(sinkUrl: string, timeoutMs: number, fetchFn?: typeof fetch): Promise<WellKnownRead>;
+/** What the file says, onto the sink. Returns what changed for the person, in words:
+ *  a cap below the tier asked for, and the tool events the receiver asked for. */
+export declare function applyWellKnown(s: SinkConfig, wk: WellKnownRead, tier: Tier, now?: Date): string[];
+/** Read again the well-known file of every HTTP sink a worker hasn't looked at for a
+ *  day, and keep what changed. One short read per sink per day, never on the hook's
+ *  own path; a failed read is noted as tried, so the next try is a day away. */
+export declare function refreshWellKnown(cfg: Config, o?: {
+    now?: () => number;
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+}): Promise<boolean>;
+/** The worker's call: the config read, refreshed where stale, and written back only when
+ *  something was learned or tried. Nothing a drain depends on; errors are swallowed. */
+export declare function refreshSinks(o?: Parameters<typeof refreshWellKnown>[1]): Promise<void>;
+export type { ToolsMode };
+//# sourceMappingURL=wellknown.d.ts.map

package/dist/wellknown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wellknown.d.ts","sourceRoot":"","sources":["../src/wellknown.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,MAAM,EAAc,KAAK,UAAU,EAAE,KAAK,IAAI,EAAe,MAAM,mBAAmB,CAAC;AACrG,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,QAAmB,CAAC;AAEtD,eAAO,MAAM,YAAY,YAAa,MAAM,KAAG,MAAiE,CAAC;AAEjH,0GAA0G;AAC1G,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,aAAa,CAAC,CAIxB;AAED;kFACkF;AAClF,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAa,GAAG,MAAM,EAAE,CAgBvG;AAOD;;gFAEgF;AAChF,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,CAAC,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACzE,OAAO,CAAC,OAAO,CAAC,CAclB;AAED;wFACwF;AACxF,wBAAsB,YAAY,CAAC,CAAC,GAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhG;AAED,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/worker.d.ts

@@ -1,5 +1,11 @@
 #!/usr/bin/env node
+/** How long a worker lives. */
+export declare const WORKER_LIFE_MS = 15000;
+/** The argument that starts a worker with no job, to drain what another left marked. */
+export declare const DRAIN_ARG = "--drain";
 /** One worker run over `argv` as node received it ([node, worker.js, job]). Resolves
- *  once the job is done and the sweep is over; the process then exits 0. */
+ *  once the job is done and the sweep is over; the process then exits 0. A drain
+ *  that finds this worker's life too short for another pass leaves the work marked
+ *  and starts one fresh worker to take it over (at most one per worker). */
 export declare function workerMain(argv: string[]): Promise<void>;
 //# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":";AAkBA;4EAC4E;AAC5E,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB9D"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":";AAmBA,+BAA+B;AAC/B,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,wFAAwF;AACxF,eAAO,MAAM,SAAS,YAAY,CAAC;AAQnC;;;4EAG4E;AAC5E,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC9D"}