@timurproko/a1 0.1.0

package/dist/src/foundation/structured-agent-runtime/reconnection.d.ts

@@ -0,0 +1,38 @@
+import { type AgentRecoveryAuthority, type StructuredAgentSnapshot, type StructuredCapabilityContract, type StructuredRecoveryAuthority } from "../workspace-contracts/index.js";
+import { StructuredEventReducer, type StructuredRuntimeView } from "./state.js";
+export interface StructuredResumeProof {
+    readonly protocolVersion: number;
+    readonly agentId: string;
+    readonly adapterId: string;
+    readonly processIdentity: string;
+    readonly ownershipProof: string;
+    readonly boundary: {
+        readonly kind: "position";
+        readonly position: number;
+        readonly resumeToken: string;
+    } | {
+        readonly kind: "snapshot";
+        readonly snapshotId: string;
+        readonly snapshot: StructuredAgentSnapshot;
+    };
+}
+export type StructuredReconnectionResult = {
+    readonly kind: "accepted";
+    readonly boundary: StructuredRecoveryAuthority["boundary"];
+    readonly view: StructuredRuntimeView | null;
+    readonly diagnostic: string;
+} | {
+    readonly kind: "terminated";
+    readonly reason: "non-reconnectable";
+    readonly diagnostic: string;
+} | {
+    readonly kind: "rejected";
+    readonly code: string;
+    readonly diagnostic: string;
+};
+export declare class StructuredReconnectionManager {
+    #private;
+    constructor(capability: StructuredCapabilityContract);
+    resume(authorityValue: AgentRecoveryAuthority, proof: StructuredResumeProof, reducer?: StructuredEventReducer | null): StructuredReconnectionResult;
+}
+//# sourceMappingURL=reconnection.d.ts.map

package/dist/src/foundation/structured-agent-runtime/reconnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnection.d.ts","sourceRoot":"","sources":["../../../../src/foundation/structured-agent-runtime/reconnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EACjC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EACb;QAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GACtF;QAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAA;KAAE,CAAC;CAC5G;AAED,MAAM,MAAM,4BAA4B,GACpC;IACA,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GACC;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAClG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,qBAAa,6BAA6B;;gBAI5B,UAAU,EAAE,4BAA4B;IAKpD,MAAM,CACJ,cAAc,EAAE,sBAAsB,EACtC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,GAAE,sBAAsB,GAAG,IAAW,GAC5C,4BAA4B;CAoEhC"}

package/dist/src/foundation/structured-agent-runtime/reconnection.js

@@ -0,0 +1,130 @@
+import { WORKSPACE_CONTRACT_VERSION, assertRecoveryAuthority, assertStructuredAgentSnapshot, assertStructuredCapability, } from "../workspace-contracts/index.js";
+import { StructuredEventReducer } from "./state.js";
+export class StructuredReconnectionManager {
+    #capability;
+    #acceptedBoundaries = new Set();
+    constructor(capability) {
+        assertStructuredCapability(capability);
+        this.#capability = capability;
+    }
+    resume(authorityValue, proof, reducer = null) {
+        let authority;
+        try {
+            assertRecoveryAuthority(authorityValue);
+            authority = authorityValue;
+        }
+        catch (error) {
+            return rejected("invalid-authority", error);
+        }
+        if (authority.kind !== "structured")
+            return rejected("invalid-authority", new Error("structured reconnection requires structured recovery authority"));
+        if (this.#capability.resume === "none") {
+            return { kind: "terminated", reason: "non-reconnectable", diagnostic: "adapter did not negotiate reconnection; durable agent is ended after restart" };
+        }
+        if (this.#capability.resume !== authority.boundary.kind) {
+            return rejected("unsupported-resume", new Error(`persisted ${authority.boundary.kind} recovery is unavailable from negotiated ${this.#capability.resume} resume`));
+        }
+        const identityError = verifyIdentity(authority, proof);
+        if (identityError)
+            return identityError;
+        if (proof.protocolVersion !== WORKSPACE_CONTRACT_VERSION) {
+            return rejected("version-mismatch", new Error(`resume protocol ${proof.protocolVersion} does not match supported version ${WORKSPACE_CONTRACT_VERSION}`));
+        }
+        if (proof.boundary.kind !== authority.boundary.kind) {
+            return rejected("boundary-mismatch", new Error("resume proof boundary does not match the persisted recovery boundary"));
+        }
+        const boundaryKey = boundaryKeyOf(authority.boundary);
+        if (this.#acceptedBoundaries.has(boundaryKey)) {
+            return rejected("replay-detected", new Error("structured recovery boundary has already been accepted"));
+        }
+        if (authority.boundary.kind === "position") {
+            if (proof.boundary.kind !== "position")
+                return rejected("boundary-mismatch", new Error("position resume requires a position proof"));
+            if (proof.boundary.position !== authority.boundary.position) {
+                return rejected("boundary-mismatch", new Error("resume position does not match the persisted recovery boundary"));
+            }
+            if (proof.boundary.resumeToken !== authority.boundary.resumeToken) {
+                return rejected("stale-token", new Error("resume token does not match the persisted recovery boundary"));
+            }
+            let view = null;
+            if (reducer) {
+                const restored = restorePosition(reducer, authority.agentId, proof.boundary.position);
+                if (isRejected(restored))
+                    return restored;
+                view = restored;
+            }
+            this.#acceptedBoundaries.add(boundaryKey);
+            return { kind: "accepted", boundary: authority.boundary, view, diagnostic: "structured resume position verified" };
+        }
+        if (proof.boundary.kind !== "snapshot")
+            return rejected("boundary-mismatch", new Error("snapshot resume requires a snapshot proof"));
+        if (proof.boundary.snapshotId !== authority.boundary.snapshotId) {
+            return rejected("stale-token", new Error("resume snapshot identity does not match the persisted recovery boundary"));
+        }
+        if (payloadBytes(proof.boundary.snapshot.payload) > this.#capability.flow.maxSnapshotBytes) {
+            return rejected("snapshot-too-large", new Error(`resume snapshot exceeds the negotiated ${this.#capability.flow.maxSnapshotBytes} byte limit`));
+        }
+        const snapshotResult = verifySnapshot(authority.agentId, proof.boundary.snapshotId, proof.boundary.snapshot);
+        if (snapshotResult)
+            return snapshotResult;
+        if (reducer) {
+            const applied = reducer.replaceWithSnapshot(proof.boundary.snapshot);
+            if (applied.kind !== "snapshot-applied") {
+                return rejected("snapshot-recovery-failed", new Error(`snapshot recovery failed: ${applied.kind}`));
+            }
+            this.#acceptedBoundaries.add(boundaryKey);
+            return { kind: "accepted", boundary: authority.boundary, view: applied.view, diagnostic: "structured snapshot recovery verified" };
+        }
+        this.#acceptedBoundaries.add(boundaryKey);
+        return { kind: "accepted", boundary: authority.boundary, view: null, diagnostic: "structured snapshot recovery verified" };
+    }
+}
+function verifyIdentity(authority, proof) {
+    if (proof.agentId !== authority.agentId)
+        return rejected("agent-mismatch", new Error("resume proof agent does not match the durable agent identity"));
+    if (proof.adapterId !== authority.adapterId)
+        return rejected("adapter-mismatch", new Error("resume proof adapter does not match the durable adapter identity"));
+    if (proof.processIdentity !== authority.processIdentity)
+        return rejected("process-mismatch", new Error("resume proof process does not match verified process ownership"));
+    if (proof.ownershipProof !== authority.ownershipProof)
+        return rejected("proof-mismatch", new Error("resume ownership proof does not match the persisted authority"));
+    return null;
+}
+function verifySnapshot(agentId, snapshotId, snapshot) {
+    try {
+        assertStructuredAgentSnapshot(snapshot);
+    }
+    catch (error) {
+        return rejected("invalid-snapshot", error);
+    }
+    if (snapshot.snapshotId !== snapshotId)
+        return rejected("invalid-snapshot", new Error("snapshot payload identity does not match the resume boundary"));
+    if (snapshot.agentId !== agentId)
+        return rejected("agent-mismatch", new Error("snapshot payload agent does not match the durable agent identity"));
+    return null;
+}
+function restorePosition(reducer, agentId, position) {
+    if (reducer.agentId !== agentId)
+        return rejected("agent-mismatch", new Error("resume reducer agent does not match the durable agent identity"));
+    try {
+        return reducer.restoreResumeBoundary(position);
+    }
+    catch (error) {
+        return rejected("invalid-authority", error);
+    }
+}
+function boundaryKeyOf(boundary) {
+    return boundary.kind === "position"
+        ? `position:${boundary.position}:${boundary.resumeToken}`
+        : `snapshot:${boundary.snapshotId}`;
+}
+function isRejected(value) {
+    return "kind" in value && value.kind === "rejected";
+}
+function payloadBytes(payload) {
+    return new TextEncoder().encode(JSON.stringify(payload)).byteLength;
+}
+function rejected(code, error) {
+    return { kind: "rejected", code, diagnostic: error instanceof Error ? error.message : String(error) };
+}
+//# sourceMappingURL=reconnection.js.map

package/dist/src/foundation/structured-agent-runtime/reconnection.js.map

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

package/dist/src/foundation/structured-agent-runtime/state.d.ts

@@ -0,0 +1,57 @@
+import { type StructuredAgentSnapshot, type StructuredCapabilityContract, type WorkspaceEvent } from "../workspace-contracts/index.js";
+export type StructuredAgentEvent = Extract<WorkspaceEvent, {
+    readonly type: "structured-event";
+}>;
+export interface StructuredRuntimeView {
+    readonly agentId: string;
+    readonly revision: number;
+    readonly lastAppliedPosition: number | null;
+    readonly nextEventPosition: number;
+    readonly appliedEventCount: number;
+    readonly lastEventType: string | null;
+    readonly lastEventPayload: unknown;
+    readonly snapshotId: string | null;
+    readonly snapshotPayload: unknown;
+}
+export type StructuredEventApplyResult = {
+    readonly kind: "applied";
+    readonly view: StructuredRuntimeView;
+} | {
+    readonly kind: "duplicate";
+    readonly view: StructuredRuntimeView;
+    readonly duplicatePosition: number;
+} | {
+    readonly kind: "resynchronization-required";
+    readonly view: StructuredRuntimeView;
+    readonly expectedPosition: number;
+    readonly receivedPosition: number;
+    readonly recovery: "snapshot" | "none";
+} | {
+    readonly kind: "rejected";
+    readonly code: string;
+    readonly diagnostic: string;
+};
+export type StructuredSnapshotApplyResult = {
+    readonly kind: "snapshot-applied";
+    readonly view: StructuredRuntimeView;
+} | {
+    readonly kind: "snapshot-stale";
+    readonly view: StructuredRuntimeView;
+    readonly currentPosition: number;
+    readonly snapshotPosition: number;
+} | {
+    readonly kind: "rejected";
+    readonly code: string;
+    readonly diagnostic: string;
+};
+export declare class StructuredEventReducer {
+    #private;
+    readonly agentId: string;
+    constructor(agentId: string, capability: StructuredCapabilityContract);
+    applyEvent(event: StructuredAgentEvent): StructuredEventApplyResult;
+    replaceWithSnapshot(snapshot: StructuredAgentSnapshot): StructuredSnapshotApplyResult;
+    restoreResumeBoundary(position: number): StructuredRuntimeView;
+    nextEventPosition(): number;
+    view(): StructuredRuntimeView;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/src/foundation/structured-agent-runtime/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/foundation/structured-agent-runtime/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,cAAc,EACpB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAAC;AAElG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GACxG;IACA,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAC;CACxC,GACC;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,MAAM,MAAM,6BAA6B,GACrC;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAC9I;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,qBAAa,sBAAsB;;IAUrB,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,4BAA4B;IAM9E,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,0BAA0B;IAsCnE,mBAAmB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,6BAA6B;IA8BrF,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB;IAY9D,iBAAiB,IAAI,MAAM;IAI3B,IAAI,IAAI,qBAAqB;CAa9B"}

package/dist/src/foundation/structured-agent-runtime/state.js

@@ -0,0 +1,119 @@
+import { assertStructuredAgentSnapshot, assertStructuredCapability, assertWorkspaceEvent, } from "../workspace-contracts/index.js";
+export class StructuredEventReducer {
+    agentId;
+    #capability;
+    #lastAppliedPosition = null;
+    #appliedEventCount = 0;
+    #revision = 0;
+    #lastEventType = null;
+    #lastEventPayload = null;
+    #snapshotId = null;
+    #snapshotPayload = null;
+    constructor(agentId, capability) {
+        this.agentId = agentId;
+        assertStructuredCapability(capability);
+        if (!agentId || agentId.includes("\0"))
+            throw new TypeError("structured reducer agent id is invalid");
+        this.#capability = capability;
+    }
+    applyEvent(event) {
+        try {
+            assertWorkspaceEvent(event);
+        }
+        catch (error) {
+            return rejected("malformed-event", error);
+        }
+        if (event.agentId !== this.agentId) {
+            return rejected("agent-mismatch", new Error("structured event agent does not match the reducer identity"));
+        }
+        if (!this.#capability.eventTypes.includes(event.eventType)) {
+            return rejected("unsupported-event-type", new Error(`structured event type is not negotiated: ${event.eventType}`));
+        }
+        if (payloadBytes(event.payload) > this.#capability.flow.maxEventBytes) {
+            return rejected("event-too-large", new Error(`structured event exceeds the negotiated ${this.#capability.flow.maxEventBytes} byte limit`));
+        }
+        const nextPosition = this.nextEventPosition();
+        if (event.position < nextPosition) {
+            return { kind: "duplicate", view: this.view(), duplicatePosition: event.position };
+        }
+        if (event.position > nextPosition) {
+            return {
+                kind: "resynchronization-required",
+                view: this.view(),
+                expectedPosition: nextPosition,
+                receivedPosition: event.position,
+                recovery: this.#capability.snapshots === "authoritative" ? "snapshot" : "none",
+            };
+        }
+        this.#lastAppliedPosition = event.position;
+        this.#appliedEventCount += 1;
+        this.#lastEventType = event.eventType;
+        this.#lastEventPayload = event.payload;
+        this.#revision += 1;
+        return { kind: "applied", view: this.view() };
+    }
+    replaceWithSnapshot(snapshot) {
+        if (this.#capability.snapshots !== "authoritative") {
+            return rejected("snapshots-unsupported", new Error("the negotiated adapter capability does not provide authoritative snapshots"));
+        }
+        try {
+            assertStructuredAgentSnapshot(snapshot);
+        }
+        catch (error) {
+            return rejected("malformed-snapshot", error);
+        }
+        if (snapshot.agentId !== this.agentId) {
+            return rejected("agent-mismatch", new Error("structured snapshot agent does not match the reducer identity"));
+        }
+        if (payloadBytes(snapshot.payload) > this.#capability.flow.maxSnapshotBytes) {
+            return rejected("snapshot-too-large", new Error(`structured snapshot exceeds the negotiated ${this.#capability.flow.maxSnapshotBytes} byte limit`));
+        }
+        const currentPosition = this.#lastAppliedPosition;
+        if (currentPosition !== null && snapshot.position < currentPosition) {
+            return { kind: "snapshot-stale", view: this.view(), currentPosition, snapshotPosition: snapshot.position };
+        }
+        this.#lastAppliedPosition = snapshot.position;
+        this.#appliedEventCount = 0;
+        this.#lastEventType = null;
+        this.#lastEventPayload = null;
+        this.#snapshotId = snapshot.snapshotId;
+        this.#snapshotPayload = snapshot.payload;
+        this.#revision += 1;
+        return { kind: "snapshot-applied", view: this.view() };
+    }
+    restoreResumeBoundary(position) {
+        if (!Number.isSafeInteger(position) || position < 0)
+            throw new RangeError("structured resume position must be a non-negative safe integer");
+        this.#lastAppliedPosition = position;
+        this.#appliedEventCount = 0;
+        this.#lastEventType = null;
+        this.#lastEventPayload = null;
+        this.#snapshotId = null;
+        this.#snapshotPayload = null;
+        this.#revision += 1;
+        return this.view();
+    }
+    nextEventPosition() {
+        return this.#lastAppliedPosition === null ? 0 : this.#lastAppliedPosition + 1;
+    }
+    view() {
+        return Object.freeze({
+            agentId: this.agentId,
+            revision: this.#revision,
+            lastAppliedPosition: this.#lastAppliedPosition,
+            nextEventPosition: this.nextEventPosition(),
+            appliedEventCount: this.#appliedEventCount,
+            lastEventType: this.#lastEventType,
+            lastEventPayload: this.#lastEventPayload,
+            snapshotId: this.#snapshotId,
+            snapshotPayload: this.#snapshotPayload,
+        });
+    }
+}
+function rejected(code, error) {
+    return { kind: "rejected", code, diagnostic: error instanceof Error ? error.message : String(error) };
+}
+function payloadBytes(payload) {
+    return new TextEncoder().encode(JSON.stringify(payload)).byteLength;
+}
+//# sourceMappingURL=state.js.map

package/dist/src/foundation/structured-agent-runtime/state.js.map

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

package/dist/src/foundation/supervision/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./main.js";
+export * from "./server.js";
+export { resolveAddOnePaths, type AddOnePaths } from "../lifecycle/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/supervision/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/supervision/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/foundation/supervision/index.js

@@ -0,0 +1,4 @@
+export * from "./main.js";
+export * from "./server.js";
+export { resolveAddOnePaths } from "../lifecycle/index.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/supervision/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/supervision/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAoB,MAAM,uBAAuB,CAAC"}

package/dist/src/foundation/supervision/main.d.ts

@@ -0,0 +1,2 @@
+export declare function runSupervisor(): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/src/foundation/supervision/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../src/foundation/supervision/main.ts"],"names":[],"mappings":"AAOA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA8BnD"}

package/dist/src/foundation/supervision/main.js

@@ -0,0 +1,40 @@
+import { randomUUID } from "node:crypto";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { assertImmutableExecutionRoot, readMaterializedRelease } from "../release/index.js";
+import { ControlStore } from "../storage/index.js";
+import { resolveAddOnePaths } from "./paths.js";
+import { SupervisorServer } from "./server.js";
+export async function runSupervisor() {
+    const paths = resolveAddOnePaths();
+    mkdirSync(paths.runtimeDir, { recursive: true, mode: 0o700 });
+    const log = (message) => appendFileSync(paths.supervisorLogPath, `${new Date().toISOString()} ${message}\n`);
+    const releaseRoot = process.env.ADDONE_RELEASE_ROOT;
+    if (!releaseRoot)
+        throw new Error("supervisor must be launched from a verified immutable AddOne release");
+    const release = await readMaterializedRelease(releaseRoot);
+    if (process.env.ADDONE_RELEASE_ID !== release.releaseId)
+        throw new Error("selected AddOne release identity does not match its verified manifest");
+    await assertImmutableExecutionRoot(release, paths.dataDir);
+    const bootNonce = randomUUID();
+    const store = new ControlStore(paths.databasePath, bootNonce);
+    const server = new SupervisorServer(store, paths, release, bootNonce);
+    await server.listen();
+    log(`supervisor ${server.id} listening at ${paths.endpoint} (pid ${process.pid})`);
+    let closing = false;
+    const close = async (signal) => {
+        if (closing)
+            return;
+        closing = true;
+        log(`received ${signal}; stopping supervised process tree`);
+        await server.close(true);
+        process.exitCode = 0;
+    };
+    process.on("SIGINT", () => void close("SIGINT"));
+    process.on("SIGTERM", () => void close("SIGTERM"));
+    process.on("uncaughtException", error => {
+        log(`uncaught exception: ${error.stack ?? error.message}`);
+        process.exitCode = 1;
+    });
+    process.on("unhandledRejection", error => log(`unhandled rejection: ${String(error)}`));
+}
+//# sourceMappingURL=main.js.map

package/dist/src/foundation/supervision/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../../src/foundation/supervision/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,iBAAiB,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,OAAO,IAAI,CAAC,CAAC;IACrH,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACpD,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1G,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,OAAO,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAClJ,MAAM,4BAA4B,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACtE,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,cAAc,MAAM,CAAC,EAAE,iBAAiB,KAAK,CAAC,QAAQ,SAAS,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IAEnF,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,KAAK,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;QACrC,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,GAAG,CAAC,YAAY,MAAM,oCAAoC,CAAC,CAAC;QAC5D,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,CAAC,EAAE;QACtC,GAAG,CAAC,uBAAuB,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC"}

package/dist/src/foundation/supervision/paths.d.ts

@@ -0,0 +1,2 @@
+export { resolveAddOnePaths, type AddOnePaths } from "../lifecycle/index.js";
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/foundation/supervision/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/foundation/supervision/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/foundation/supervision/paths.js

@@ -0,0 +1,2 @@
+export { resolveAddOnePaths } from "../lifecycle/index.js";
+//# sourceMappingURL=paths.js.map

package/dist/src/foundation/supervision/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/foundation/supervision/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAoB,MAAM,uBAAuB,CAAC"}

package/dist/src/foundation/supervision/server.d.ts

@@ -0,0 +1,21 @@
+import { type SupervisorSnapshot } from "../lifecycle/index.js";
+import type { MaterializedRelease } from "../release/index.js";
+import { ControlStore } from "../storage/index.js";
+import { type AddOnePaths } from "./paths.js";
+export declare class SupervisorServer {
+    #private;
+    readonly store: ControlStore;
+    readonly release: MaterializedRelease;
+    readonly terminateProcess: (code: number) => void;
+    readonly id: `${string}-${string}-${string}-${string}-${string}`;
+    readonly bootNonce: string;
+    readonly pidStartIdentity: string;
+    readonly startedAt: string;
+    readonly paths: AddOnePaths;
+    constructor(store: ControlStore, paths: AddOnePaths | undefined, release: MaterializedRelease, bootNonce?: string, terminateProcess?: (code: number) => void);
+    snapshot(): SupervisorSnapshot;
+    listen(): Promise<void>;
+    close(stopAgents?: boolean): Promise<void>;
+    closeForReleaseReplacement(stopAgents: boolean): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/src/foundation/supervision/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/foundation/supervision/server.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAElE,qBAAa,gBAAgB;;IAczB,QAAQ,CAAC,KAAK,EAAE,YAAY;IAE5B,QAAQ,CAAC,OAAO,EAAE,mBAAmB;IAErC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IAjBnD,QAAQ,CAAC,EAAE,sDAAgB;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,SAAyE;IAClG,QAAQ,CAAC,SAAS,SAA4B;IAC9C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;gBASjB,KAAK,EAAE,YAAY,EAC5B,KAAK,yBAAuB,EACnB,OAAO,EAAE,mBAAmB,EACrC,SAAS,GAAE,MAAqB,EACvB,gBAAgB,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAiC;IAOhF,QAAQ,IAAI,kBAAkB;IAIxB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBvB,KAAK,CAAC,UAAU,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxC,0BAA0B,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CA8LrE"}