@descryy/runtime-orchestrator 0.4.0 → 0.4.2

package/dist/attach-to-running-process.d.ts

@@ -18,6 +18,7 @@
  * Disclosed, not solved, same as `readiness.ts`.
  */
 import type { ProcessOutputSource } from "@descryy/runtime-backend-observation";
+import { type AttachFence } from "@descryy/runtime-controller";
 export interface AttachToRunningProcessOptions {
     readonly processId: string;
     /** The pid of the already-running target. Verified alive before attaching, and re-checked on every poll to detect exit. */
@@ -48,6 +49,17 @@ export interface AttachToRunningProcessOptions {
  * purpose. Any other error is treated as "exists" rather than guessed away.
  */
 export declare function isProcessAlive(pid: number): boolean;
+/**
+ * `attachToRunningProcess`'s return value: a `ProcessOutputSource` (structurally
+ * unchanged, so every existing consumer keeps working unmodified) plus the
+ * attach-time fence (RT-N3) that produced its `preExistingLineCount`. Exposed so
+ * a caller can disclose it -- the process's own start time, whether some other
+ * process also holds the log file open, and the recorded attach offset -- rather
+ * than that information existing only internally to this function.
+ */
+export interface AttachedProcessOutputSource extends ProcessOutputSource {
+    readonly attachFence: AttachFence;
+}
 /**
  * Attach to an already-running process via a log file it is already writing to.
  * Throws immediately if the pid isn't alive — refuses rather than returning a
@@ -55,11 +67,17 @@ export declare function isProcessAlive(pid: number): boolean;
  *
  * Lines already in `logFilePath` at attach time are yielded first, followed by
  * whatever the target writes afterward — indistinguishable from `execute`'s live
- * tail once attached.
+ * tail once attached, EXCEPT that each pre-existing line carries
+ * `ProcessOutputLine.preExisting: true` (RT-N3, `computeAttachFence`) — real,
+ * captured evidence, but evidence this run did not watch happen. A consumer that
+ * turns these lines into `Evidence` (e.g. `createLogCollector`) is expected to
+ * carry that flag through to `Evidence.preExisting`, and a promotion path that
+ * would otherwise mint or confirm an R4 graph edge from it must refuse (see
+ * `resolveObservedCrossServiceCall`, `@descryy/runtime-graph-correlator`).
  *
  * Ends when the caller's window closes or the target exits, whichever comes
  * first (see `stopObserving`) — both are needed, or a healthy target polls
  * forever, or a dead one polls until the caller notices.
  */
-export declare function attachToRunningProcess(options: AttachToRunningProcessOptions): ProcessOutputSource;
+export declare function attachToRunningProcess(options: AttachToRunningProcessOptions): AttachedProcessOutputSource;
 //# sourceMappingURL=attach-to-running-process.d.ts.map

package/dist/attach-to-running-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attach-to-running-process.d.ts","sourceRoot":"","sources":["../src/attach-to-running-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAIhF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2HAA2H;IAC3H,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2LAA2L;IAC3L,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,mBAAmB,CA2BlG"}
+{"version":3,"file":"attach-to-running-process.d.ts","sourceRoot":"","sources":["../src/attach-to-running-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAInF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2HAA2H;IAC3H,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2LAA2L;IAC3L,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,2BAA2B,CAkC1G"}

package/dist/attach-to-running-process.js

@@ -18,6 +18,7 @@
  * Disclosed, not solved, same as `readiness.ts`.
  */
 import { readFileSync } from "node:fs";
+import { computeAttachFence } from "@descryy/runtime-controller";
 import { createPollingProcessOutputSource } from "./polling-output-source.js";
 /**
  * `process.kill(pid, 0)` sends no signal — it only asks the kernel whether
@@ -41,7 +42,13 @@ export function isProcessAlive(pid) {
  *
  * Lines already in `logFilePath` at attach time are yielded first, followed by
  * whatever the target writes afterward — indistinguishable from `execute`'s live
- * tail once attached.
+ * tail once attached, EXCEPT that each pre-existing line carries
+ * `ProcessOutputLine.preExisting: true` (RT-N3, `computeAttachFence`) — real,
+ * captured evidence, but evidence this run did not watch happen. A consumer that
+ * turns these lines into `Evidence` (e.g. `createLogCollector`) is expected to
+ * carry that flag through to `Evidence.preExisting`, and a promotion path that
+ * would otherwise mint or confirm an R4 graph edge from it must refuse (see
+ * `resolveObservedCrossServiceCall`, `@descryy/runtime-graph-correlator`).
  *
  * Ends when the caller's window closes or the target exits, whichever comes
  * first (see `stopObserving`) — both are needed, or a healthy target polls
@@ -52,7 +59,8 @@ export function attachToRunningProcess(options) {
         throw new Error(`attachToRunningProcess: pid ${options.pid} for "${options.processId}" is not running — attach requires ` +
             `a target that already exists. Use ExecutionController.run() to spawn a new process instead.`);
     }
-    return createPollingProcessOutputSource({
+    const attachFence = computeAttachFence(options.pid, options.logFilePath);
+    const source = createPollingProcessOutputSource({
         processId: options.processId,
         // an ad-hoc attach may have no declared service; null is the honest answer
         serviceName: options.serviceName ?? null,
@@ -68,7 +76,11 @@ export function attachToRunningProcess(options) {
         // either reason ends the source; dropping the liveness half would leave a
         // target that dies mid-window polled until the caller noticed
         isFinished: () => options.stopObserving() || !isProcessAlive(options.pid),
+        // RT-N3: everything already in the file at attach time is marked, not
+        // discarded -- see `AttachedProcessOutputSource`'s doc.
+        preExistingLineCount: attachFence.preExistingLineCount,
         ...(options.pollIntervalMs !== undefined ? { pollIntervalMs: options.pollIntervalMs } : {}),
     });
+    return { ...source, attachFence };
 }
 //# sourceMappingURL=attach-to-running-process.js.map

package/dist/attach-to-running-process.js.map

@@ -1 +1 @@
-{"version":3,"file":"attach-to-running-process.js","sourceRoot":"","sources":["../src/attach-to-running-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIvC,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AA0B9E;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAsC;IAC3E,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,+BAA+B,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,SAAS,qCAAqC;YACvG,6FAA6F,CAChG,CAAC;IACJ,CAAC;IAED,OAAO,gCAAgC,CAAC;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,2EAA2E;QAC3E,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,UAAU,EAAE,GAAG,EAAE;YACf,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,MAAM,IAAI,KAAK,CACb,oDAAoD,OAAO,CAAC,WAAW,aAAa,OAAO,CAAC,GAAG,KAAK,MAAM,EAAE,CAC7G,CAAC;YACJ,CAAC;QACH,CAAC;QACD,0EAA0E;QAC1E,8DAA8D;QAC9D,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5F,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"attach-to-running-process.js","sourceRoot":"","sources":["../src/attach-to-running-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAoB,MAAM,6BAA6B,CAAC;AAEnF,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AA0B9E;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC;AAcD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAsC;IAC3E,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,+BAA+B,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,SAAS,qCAAqC;YACvG,6FAA6F,CAChG,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,gCAAgC,CAAC;QAC9C,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,2EAA2E;QAC3E,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,UAAU,EAAE,GAAG,EAAE;YACf,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,MAAM,IAAI,KAAK,CACb,oDAAoD,OAAO,CAAC,WAAW,aAAa,OAAO,CAAC,GAAG,KAAK,MAAM,EAAE,CAC7G,CAAC;YACJ,CAAC;QACH,CAAC;QACD,0EAA0E;QAC1E,8DAA8D;QAC9D,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC;QACzE,sEAAsE;QACtE,wDAAwD;QACxD,oBAAoB,EAAE,WAAW,CAAC,oBAAoB;QACtD,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5F,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC;AACpC,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export type { PollingProcessOutputSourceOptions } from "./polling-output-source.ts";
 export { createPollingProcessOutputSource } from "./polling-output-source.ts";
-export type { AttachToRunningProcessOptions } from "./attach-to-running-process.ts";
+export type { AttachToRunningProcessOptions, AttachedProcessOutputSource } from "./attach-to-running-process.ts";
 export { attachToRunningProcess, isProcessAlive } from "./attach-to-running-process.ts";
 export type { AttachToRunningNodeProcessOptions } from "./attach-to-running-node-process.ts";
 export { attachToRunningNodeProcess, discoverNodeInspectorUrl } from "./attach-to-running-node-process.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAC9E,YAAY,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AACpF,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACxF,YAAY,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC3G,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9F,YAAY,EACV,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,gCAAgC,EAChC,kBAAkB,EAClB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACnI,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACtH,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,8BAA8B,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAC9E,YAAY,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AACjH,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACxF,YAAY,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC3G,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAC9F,YAAY,EACV,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,gCAAgC,EAChC,kBAAkB,EAClB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACnI,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACtH,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,8BAA8B,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/polling-output-source.d.ts

@@ -19,6 +19,25 @@ export interface PollingProcessOutputSourceOptions {
     /** True once the process has exited. Output already buffered is still drained afterwards. */
     readonly isFinished: () => boolean;
     readonly pollIntervalMs?: number;
+    /**
+     * How many of the lines this source will EVER yield already existed in the
+     * underlying buffer before observation began — e.g. `attachToRunningProcess`'s
+     * attach-time snapshot of an already-running target's log file (RT-N3).
+     * Counted in complete (newline-terminated) lines, not bytes: this source
+     * already reasons in lines, and byte offsets don't survive UTF-8 decoding
+     * cleanly. Default 0 — an ordinary spawned process has no pre-existing
+     * backlog. The Nth line this source yields (0-indexed, across BOTH the main
+     * loop and the final flush) is marked `preExisting: true` when N is less
+     * than this count.
+     *
+     * One disclosed edge case: a line torn exactly at the attach instant (an
+     * unterminated partial already in the file at attach, completed by content
+     * written afterward) is counted as NOT pre-existing by this index-based
+     * rule, even though its opening bytes are — the same "cannot be made
+     * perfectly correct over a plain text file" limit `attachToRunningProcess`
+     * documents, not solved here either.
+     */
+    readonly preExistingLineCount?: number;
 }
 export declare function createPollingProcessOutputSource(options: PollingProcessOutputSourceOptions): ProcessOutputSource;
 //# sourceMappingURL=polling-output-source.d.ts.map

package/dist/polling-output-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polling-output-source.d.ts","sourceRoot":"","sources":["../src/polling-output-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwC,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEtH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gIAAgI;IAChI,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAID,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iCAAiC,GAAG,mBAAmB,CAkDhH"}
+{"version":3,"file":"polling-output-source.d.ts","sourceRoot":"","sources":["../src/polling-output-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwC,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEtH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gIAAgI;IAChI,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAID,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iCAAiC,GAAG,mBAAmB,CAyDhH"}

package/dist/polling-output-source.js

@@ -13,12 +13,19 @@ import { LineSplitter } from "@descryy/runtime-backend-observation";
 const DEFAULT_POLL_INTERVAL_MS = 50;
 export function createPollingProcessOutputSource(options) {
     const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const preExistingLineCount = options.preExistingLineCount ?? 0;
     return {
         processId: options.processId,
         serviceName: options.serviceName,
         lines: (async function* () {
             const splitter = new LineSplitter();
             let consumed = 0;
+            let lineIndex = 0;
+            function nextLine(text, observedAt) {
+                const preExisting = lineIndex < preExistingLineCount;
+                lineIndex++;
+                return { text, stream: "combined", observedAt, ...(preExisting ? { preExisting: true } : {}) };
+            }
             for (;;) {
                 const whole = options.readOutput();
                 // Relies on the buffer only ever growing (true of `ManagedProcess` today,
@@ -36,7 +43,7 @@ export function createPollingProcessOutputSource(options) {
                     consumed = whole.length;
                     const observedAt = new Date().toISOString();
                     for (const text of splitter.push(chunk)) {
-                        yield { text, stream: "combined", observedAt };
+                        yield nextLine(text, observedAt);
                     }
                     // no sleep: a burst of output should drain at memory speed
                     continue;
@@ -45,7 +52,7 @@ export function createPollingProcessOutputSource(options) {
                     const observedAt = new Date().toISOString();
                     // a final unterminated line matters most -- a process dying mid-write
                     for (const text of splitter.flush()) {
-                        yield { text, stream: "combined", observedAt };
+                        yield nextLine(text, observedAt);
                     }
                     return;
                 }

package/dist/polling-output-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"polling-output-source.js","sourceRoot":"","sources":["../src/polling-output-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAoD,MAAM,sCAAsC,CAAC;AAatH,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAEpC,MAAM,UAAU,gCAAgC,CAAC,OAA0C;IACzF,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAE1E,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC;YACrB,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;YACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;YAEjB,SAAS,CAAC;gBACR,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;gBAEnC,0EAA0E;gBAC1E,4EAA4E;gBAC5E,8EAA8E;gBAC9E,wEAAwE;gBACxE,wBAAwB;gBACxB,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,OAAO,KAAK,CAAC,MAAM,4BAA4B;wBAC1F,6FAA6F;wBAC7F,6EAA6E,CAChF,CAAC;gBACJ,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;oBAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBACpC,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;oBACxB,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;wBACxC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;oBACjD,CAAC;oBACD,2DAA2D;oBAC3D,SAAS;gBACX,CAAC;gBAED,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;oBACzB,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBAC5C,sEAAsE;oBACtE,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;wBACpC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;oBACjD,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;YACtE,CAAC;QACH,CAAC,CAAC,EAAE;KACL,CAAC;AACJ,CAAC"}
+{"version":3,"file":"polling-output-source.js","sourceRoot":"","sources":["../src/polling-output-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAoD,MAAM,sCAAsC,CAAC;AAgCtH,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAEpC,MAAM,UAAU,gCAAgC,CAAC,OAA0C;IACzF,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAC1E,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,CAAC,CAAC;IAE/D,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC;YACrB,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;YACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,SAAS,QAAQ,CAAC,IAAY,EAAE,UAAkB;gBAChD,MAAM,WAAW,GAAG,SAAS,GAAG,oBAAoB,CAAC;gBACrD,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACjG,CAAC;YAED,SAAS,CAAC;gBACR,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;gBAEnC,0EAA0E;gBAC1E,4EAA4E;gBAC5E,8EAA8E;gBAC9E,wEAAwE;gBACxE,wBAAwB;gBACxB,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,OAAO,KAAK,CAAC,MAAM,4BAA4B;wBAC1F,6FAA6F;wBAC7F,6EAA6E,CAChF,CAAC;gBACJ,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;oBAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBACpC,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;oBACxB,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;wBACxC,MAAM,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBACnC,CAAC;oBACD,2DAA2D;oBAC3D,SAAS;gBACX,CAAC;gBAED,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;oBACzB,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBAC5C,sEAAsE;oBACtE,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;wBACpC,MAAM,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBACnC,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;YACtE,CAAC;QACH,CAAC,CAAC,EAAE;KACL,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@descryy/runtime-orchestrator",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "description": "Assembles the runtime: controller-spawned services, live process output, collectors from a RuntimeAdapter, and a CollectorContext that can resolve script origins to source roots.",
   "license": "UNLICENSED",
@@ -29,14 +29,14 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/runtime-contracts": "0.3.0",
-    "@descryy/runtime-backend-observation": "0.3.0",
-    "@descryy/runtime-controller": "0.3.0",
-    "@descryy/runtime-evidence-store": "0.4.0",
-    "@descryy/runtime-adapter-typescript": "0.3.0",
-    "@descryy/runtime-environment-profile": "0.4.0",
-    "@descryy/runtime-remote-log-ingestion": "0.4.0",
-    "@descryy/runtime-external-service-observation": "0.3.0"
+    "@descryy/runtime-contracts": "0.3.1",
+    "@descryy/runtime-backend-observation": "0.3.1",
+    "@descryy/runtime-controller": "0.3.1",
+    "@descryy/runtime-evidence-store": "0.4.1",
+    "@descryy/runtime-adapter-typescript": "0.3.1",
+    "@descryy/runtime-environment-profile": "0.4.1",
+    "@descryy/runtime-remote-log-ingestion": "0.4.1",
+    "@descryy/runtime-external-service-observation": "0.3.1"
   },
   "devDependencies": {
     "@descryy/runtime-adapter-csharp": "*",