@jcr-adk/state 2.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/event-convert.d.ts

@@ -0,0 +1,15 @@
+import type { AdkEventBase } from "@jcr-adk/core";
+import type { EventEnvelope } from "./event-envelope.js";
+import type { PersistedAdkEvent } from "./types.js";
+export type AdkEventConversionResult = {
+    readonly ok: true;
+    readonly envelope: EventEnvelope;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/** Convert domain AdkEventBase to on-disk EventEnvelope (F-01 shape). */
+export declare function adkEventToEnvelope(event: AdkEventBase): AdkEventConversionResult;
+/** Convert persisted envelope back to AdkEventBase. */
+export declare function envelopeToAdkEvent(envelope: EventEnvelope, seq: number): PersistedAdkEvent;
+//# sourceMappingURL=event-convert.d.ts.map

package/dist/event-convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-convert.d.ts","sourceRoot":"","sources":["../src/event-convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA8BpD,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,wBAAwB,CA2DhF;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CA4C1F"}

package/dist/event-convert.js

@@ -0,0 +1,135 @@
+const KIND_TO_TYPE = {
+    "run.started": "run.started",
+    "run.completed": "run.completed",
+    "run.failed": "run.failed",
+    "tool.invoked": "tool.invoked",
+    "tool.completed": "tool.completed",
+    "policy.denied": "policy.denied",
+    "policy.approval.required": "policy.approval.required",
+    "policy.approved": "policy.approved",
+    "gate.report": "gate.completed",
+    "mutation.denied": "mutation.denied",
+    "tool.failed": "tool.failed",
+};
+const TYPE_TO_KIND = {
+    "run.started": "run.started",
+    "run.completed": "run.completed",
+    "run.failed": "run.failed",
+    "tool.invoked": "tool.invoked",
+    "tool.completed": "tool.completed",
+    "tool.failed": "tool.failed",
+    "policy.denied": "policy.denied",
+    "policy.approval.required": "policy.approval.required",
+    "policy.approved": "policy.approved",
+    "gate.completed": "gate.report",
+    "mutation.denied": "mutation.denied",
+};
+/** Convert domain AdkEventBase to on-disk EventEnvelope (F-01 shape). */
+export function adkEventToEnvelope(event) {
+    const type = KIND_TO_TYPE[event.kind];
+    const base = {
+        timestamp: event.timestamp,
+        specId: event.specId,
+        runId: event.runId,
+        requestId: event.requestId,
+        type,
+    };
+    if (event.kind === "tool.completed") {
+        const toolName = stringField(event.payload, "toolName");
+        const toolCallId = stringField(event.payload, "toolCallId") ?? event.id;
+        if (!toolName)
+            return { ok: false, message: "tool.completed missing toolName in payload" };
+        const { toolName: _t, toolCallId: _c, ...rest } = event.payload;
+        return {
+            ok: true,
+            envelope: { ...base, type: "tool.completed", toolName, toolCallId, payload: rest },
+        };
+    }
+    if (event.kind === "tool.failed") {
+        const toolName = stringField(event.payload, "toolName");
+        const toolCallId = stringField(event.payload, "toolCallId") ?? event.id;
+        const error = stringField(event.payload, "error");
+        if (!toolName || !error) {
+            return { ok: false, message: "tool.failed missing toolName or error in payload" };
+        }
+        return { ok: true, envelope: { ...base, type: "tool.failed", toolName, toolCallId, error } };
+    }
+    if (event.kind === "policy.denied" ||
+        event.kind === "policy.approval.required" ||
+        event.kind === "policy.approved" ||
+        event.kind === "gate.report") {
+        const type = event.kind === "gate.report"
+            ? "gate.completed"
+            : event.kind;
+        return {
+            ok: true,
+            envelope: {
+                ...base,
+                type,
+                payload: { ...event.payload },
+            },
+        };
+    }
+    return {
+        ok: true,
+        envelope: {
+            ...base,
+            type,
+            payload: { ...event.payload },
+        },
+    };
+}
+/** Convert persisted envelope back to AdkEventBase. */
+export function envelopeToAdkEvent(envelope, seq) {
+    const kind = TYPE_TO_KIND[envelope.type];
+    const id = inferEventId(envelope);
+    if (envelope.type === "tool.completed") {
+        return {
+            id,
+            kind,
+            timestamp: envelope.timestamp,
+            specId: envelope.specId,
+            runId: envelope.runId,
+            requestId: envelope.requestId,
+            payload: { toolName: envelope.toolName, toolCallId: envelope.toolCallId, ...envelope.payload },
+            seq,
+        };
+    }
+    if (envelope.type === "tool.failed") {
+        return {
+            id,
+            kind: "tool.failed",
+            timestamp: envelope.timestamp,
+            specId: envelope.specId,
+            runId: envelope.runId,
+            requestId: envelope.requestId,
+            payload: {
+                toolName: envelope.toolName,
+                toolCallId: envelope.toolCallId,
+                error: envelope.error,
+            },
+            seq,
+        };
+    }
+    return {
+        id,
+        kind,
+        timestamp: envelope.timestamp,
+        specId: envelope.specId,
+        runId: envelope.runId,
+        requestId: envelope.requestId,
+        payload: envelope.payload ?? {},
+        seq,
+    };
+}
+function inferEventId(envelope) {
+    if ("toolCallId" in envelope && typeof envelope.toolCallId === "string") {
+        return envelope.toolCallId;
+    }
+    return `${envelope.runId}-${envelope.type}-${envelope.timestamp}`;
+}
+function stringField(payload, key) {
+    const value = payload[key];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=event-convert.js.map

package/dist/event-convert.js.map

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

package/dist/event-envelope.d.ts

@@ -0,0 +1,60 @@
+/** On-disk JSONL event types — F-01 compatible `type` field. */
+export type EventType = "run.started" | "run.completed" | "run.failed" | "tool.invoked" | "tool.completed" | "tool.failed" | "policy.denied" | "policy.approval.required" | "policy.approved" | "gate.completed" | "mutation.denied";
+export interface EventEnvelopeBase {
+    readonly timestamp: string;
+    readonly specId: string;
+    readonly runId: string;
+    readonly requestId: string;
+    readonly type: EventType;
+}
+export interface ToolCompletedEnvelope extends EventEnvelopeBase {
+    readonly type: "tool.completed";
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly payload: Record<string, unknown>;
+}
+export interface ToolFailedEnvelope extends EventEnvelopeBase {
+    readonly type: "tool.failed";
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly error: string;
+}
+export interface PolicyDeniedEnvelope extends EventEnvelopeBase {
+    readonly type: "policy.denied";
+    readonly payload: Record<string, unknown>;
+}
+export interface PolicyApprovalRequiredEnvelope extends EventEnvelopeBase {
+    readonly type: "policy.approval.required";
+    readonly payload: Record<string, unknown>;
+}
+export interface PolicyApprovedEnvelope extends EventEnvelopeBase {
+    readonly type: "policy.approved";
+    readonly payload: Record<string, unknown>;
+}
+export interface GateCompletedEnvelope extends EventEnvelopeBase {
+    readonly type: "gate.completed";
+    readonly payload: Record<string, unknown>;
+}
+export interface GenericEventEnvelope extends EventEnvelopeBase {
+    readonly type: Exclude<EventType, "tool.completed" | "tool.failed" | "policy.denied" | "policy.approval.required" | "policy.approved" | "gate.completed">;
+    readonly payload?: Record<string, unknown>;
+    readonly toolName?: string;
+    readonly toolCallId?: string;
+    readonly error?: string;
+}
+export type EventEnvelope = ToolCompletedEnvelope | ToolFailedEnvelope | PolicyDeniedEnvelope | PolicyApprovalRequiredEnvelope | PolicyApprovedEnvelope | GateCompletedEnvelope | GenericEventEnvelope;
+export type EnvelopeValidationResult = {
+    readonly ok: true;
+    readonly envelope: EventEnvelope;
+} | {
+    readonly ok: false;
+    readonly reason: "INVALID_SHAPE" | "UNKNOWN_TYPE";
+    readonly message: string;
+};
+/** Validate parsed JSON as EventEnvelope. */
+export declare function validateEventEnvelope(raw: unknown): EnvelopeValidationResult;
+/** Serialize envelope to a single JSONL line (no trailing newline). */
+export declare function serializeEventEnvelope(envelope: EventEnvelope): string;
+/** Parse one JSONL line — empty lines are invalid. */
+export declare function parseEventLine(line: string): EnvelopeValidationResult;
+//# sourceMappingURL=event-envelope.d.ts.map

package/dist/event-envelope.d.ts.map

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

package/dist/event-envelope.js

@@ -0,0 +1,96 @@
+const EVENT_TYPES = [
+    "run.started",
+    "run.completed",
+    "run.failed",
+    "tool.invoked",
+    "tool.completed",
+    "tool.failed",
+    "policy.denied",
+    "policy.approval.required",
+    "policy.approved",
+    "gate.completed",
+    "mutation.denied",
+];
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireString(obj, key) {
+    const value = obj[key];
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+/** Validate parsed JSON as EventEnvelope. */
+export function validateEventEnvelope(raw) {
+    if (!isRecord(raw)) {
+        return { ok: false, reason: "INVALID_SHAPE", message: "event must be an object" };
+    }
+    const timestamp = requireString(raw, "timestamp");
+    const specId = requireString(raw, "specId");
+    const runId = requireString(raw, "runId");
+    const requestId = requireString(raw, "requestId");
+    const type = requireString(raw, "type");
+    if (!timestamp || !specId || !runId || !requestId || !type) {
+        return { ok: false, reason: "INVALID_SHAPE", message: "missing correlation or type fields" };
+    }
+    if (!EVENT_TYPES.includes(type)) {
+        return { ok: false, reason: "UNKNOWN_TYPE", message: `unknown event type: ${type}` };
+    }
+    const base = { timestamp, specId, runId, requestId, type: type };
+    if (type === "tool.completed") {
+        const toolName = requireString(raw, "toolName");
+        const toolCallId = requireString(raw, "toolCallId");
+        const payload = raw.payload;
+        if (!toolName || !toolCallId || !isRecord(payload)) {
+            return { ok: false, reason: "INVALID_SHAPE", message: "tool.completed requires toolName, toolCallId, payload" };
+        }
+        return { ok: true, envelope: { ...base, type: "tool.completed", toolName, toolCallId, payload } };
+    }
+    if (type === "tool.failed") {
+        const toolName = requireString(raw, "toolName");
+        const toolCallId = requireString(raw, "toolCallId");
+        const error = requireString(raw, "error");
+        if (!toolName || !toolCallId || !error) {
+            return { ok: false, reason: "INVALID_SHAPE", message: "tool.failed requires toolName, toolCallId, error" };
+        }
+        return { ok: true, envelope: { ...base, type: "tool.failed", toolName, toolCallId, error } };
+    }
+    if (type === "policy.denied" ||
+        type === "policy.approval.required" ||
+        type === "policy.approved" ||
+        type === "gate.completed") {
+        const payload = raw.payload;
+        if (!isRecord(payload)) {
+            return { ok: false, reason: "INVALID_SHAPE", message: `${type} requires payload object` };
+        }
+        return {
+            ok: true,
+            envelope: { ...base, type, payload },
+        };
+    }
+    const envelope = {
+        ...base,
+        type: type,
+        payload: isRecord(raw.payload) ? raw.payload : undefined,
+        toolName: typeof raw.toolName === "string" ? raw.toolName : undefined,
+        toolCallId: typeof raw.toolCallId === "string" ? raw.toolCallId : undefined,
+        error: typeof raw.error === "string" ? raw.error : undefined,
+    };
+    return { ok: true, envelope };
+}
+/** Serialize envelope to a single JSONL line (no trailing newline). */
+export function serializeEventEnvelope(envelope) {
+    return JSON.stringify(envelope);
+}
+/** Parse one JSONL line — empty lines are invalid. */
+export function parseEventLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return { ok: false, reason: "INVALID_SHAPE", message: "empty line" };
+    }
+    try {
+        return validateEventEnvelope(JSON.parse(trimmed));
+    }
+    catch {
+        return { ok: false, reason: "INVALID_SHAPE", message: "invalid JSON" };
+    }
+}
+//# sourceMappingURL=event-envelope.js.map

package/dist/event-envelope.js.map

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

package/dist/in-memory-event-store.d.ts

@@ -0,0 +1,13 @@
+import type { AdkEventBase } from "@jcr-adk/core";
+import type { AppendOutcome, EventStore, PersistedAdkEvent } from "./types.js";
+/** In-memory EventStore for unit tests and local dev. */
+export declare class InMemoryEventStore implements EventStore {
+    private seq;
+    private events;
+    private readonly boundRunId?;
+    constructor(boundRunId?: string);
+    append(event: AdkEventBase): Promise<AppendOutcome>;
+    readAll(): Promise<PersistedAdkEvent[]>;
+    readByRun(runId: string): AsyncGenerator<PersistedAdkEvent>;
+}
+//# sourceMappingURL=in-memory-event-store.d.ts.map

package/dist/in-memory-event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-event-store.d.ts","sourceRoot":"","sources":["../src/in-memory-event-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,yDAAyD;AACzD,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;gBAEzB,UAAU,CAAC,EAAE,MAAM;IAIzB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA+BnD,OAAO,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAItC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC;CAKnE"}

package/dist/in-memory-event-store.js

@@ -0,0 +1,54 @@
+/** In-memory EventStore for unit tests and local dev. */
+export class InMemoryEventStore {
+    seq = 0;
+    events = [];
+    boundRunId;
+    constructor(boundRunId) {
+        this.boundRunId = boundRunId;
+    }
+    async append(event) {
+        if (!isValidEvent(event)) {
+            return {
+                ok: false,
+                reason: "INVALID_EVENT",
+                message: "missing required event fields",
+            };
+        }
+        if (this.boundRunId && event.runId !== this.boundRunId) {
+            return {
+                ok: false,
+                reason: "RUN_ID_MISMATCH",
+                message: `runId mismatch: expected ${this.boundRunId}`,
+            };
+        }
+        if (this.events.length > 0 && event.runId !== this.events[0].runId) {
+            return {
+                ok: false,
+                reason: "RUN_ID_MISMATCH",
+                message: "single-runId store rejects mixed runId",
+            };
+        }
+        this.seq += 1;
+        const persisted = { ...event, seq: this.seq };
+        this.events.push(persisted);
+        return { ok: true, event: persisted };
+    }
+    async readAll() {
+        return [...this.events];
+    }
+    async *readByRun(runId) {
+        for (const event of this.events) {
+            if (event.runId === runId)
+                yield event;
+        }
+    }
+}
+function isValidEvent(event) {
+    return Boolean(event.id &&
+        event.kind &&
+        event.timestamp &&
+        event.specId &&
+        event.runId &&
+        event.requestId);
+}
+//# sourceMappingURL=in-memory-event-store.js.map

package/dist/in-memory-event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-event-store.js","sourceRoot":"","sources":["../src/in-memory-event-store.ts"],"names":[],"mappings":"AAOA,yDAAyD;AACzD,MAAM,OAAO,kBAAkB;IACrB,GAAG,GAAG,CAAC,CAAC;IACR,MAAM,GAAwB,EAAE,CAAC;IACxB,UAAU,CAAU;IAErC,YAAY,UAAmB;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAmB;QAC9B,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,eAAe;gBACvB,OAAO,EAAE,+BAA+B;aACzC,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YACvD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,iBAAiB;gBACzB,OAAO,EAAE,4BAA4B,IAAI,CAAC,UAAU,EAAE;aACvD,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,KAAK,EAAE,CAAC;YACpE,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,iBAAiB;gBACzB,OAAO,EAAE,wCAAwC;aAClD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,MAAM,SAAS,GAAsB,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,CAAC,SAAS,CAAC,KAAa;QAC5B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;gBAAE,MAAM,KAAK,CAAC;QACzC,CAAC;IACH,CAAC;CACF;AAED,SAAS,YAAY,CAAC,KAAmB;IACvC,OAAO,OAAO,CACZ,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,IAAI;QACV,KAAK,CAAC,SAAS;QACf,KAAK,CAAC,MAAM;QACZ,KAAK,CAAC,KAAK;QACX,KAAK,CAAC,SAAS,CAClB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export type { PersistedAdkEvent, AppendResult, AppendFailure, AppendOutcome, EventStore, } from "./types.js";
+export { EVENT_FIRST_WRITE_ORDERING } from "./types.js";
+export type { EventType, EventEnvelope, EventEnvelopeBase, ToolCompletedEnvelope, ToolFailedEnvelope, PolicyDeniedEnvelope, GateCompletedEnvelope, EnvelopeValidationResult, } from "./event-envelope.js";
+export { validateEventEnvelope, serializeEventEnvelope, parseEventLine, } from "./event-envelope.js";
+export { adkEventToEnvelope, envelopeToAdkEvent } from "./event-convert.js";
+export type { AdkEventConversionResult } from "./event-convert.js";
+export { JsonlWriter } from "./jsonl-writer.js";
+export type { JsonlReadResult, JsonlAppendResult } from "./jsonl-writer.js";
+export { JsonlEventStore } from "./jsonl-event-store.js";
+export type { JsonlEventStoreOptions } from "./jsonl-event-store.js";
+export { InMemoryEventStore } from "./in-memory-event-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,YAAY,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { EVENT_FIRST_WRITE_ORDERING } from "./types.js";
+export { validateEventEnvelope, serializeEventEnvelope, parseEventLine, } from "./event-envelope.js";
+export { adkEventToEnvelope, envelopeToAdkEvent } from "./event-convert.js";
+export { JsonlWriter } from "./jsonl-writer.js";
+export { JsonlEventStore } from "./jsonl-event-store.js";
+export { InMemoryEventStore } from "./in-memory-event-store.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAYxD,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG5E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/jsonl-event-store.d.ts

@@ -0,0 +1,37 @@
+import type { AdkEventBase } from "@jcr-adk/core";
+import type { EventEnvelope } from "./event-envelope.js";
+import type { AppendOutcome, EventStore, PersistedAdkEvent } from "./types.js";
+export interface JsonlEventStoreOptions {
+    readonly filePath: string;
+    /** When set, rejects append if runId differs from file or bound value. */
+    readonly boundRunId?: string;
+}
+/**
+ * File-backed append-only EventStore.
+ *
+ * Fix 2: in-memory seq/runId cache — O(1) append after first write.
+ *   - On first append, file is read once to replay existing seq/runId.
+ *   - Subsequent appends use cached values; no extra readAll().
+ *   - Cache is invalidated if an external write corrupts the file;
+ *     callers must construct a fresh instance in that case.
+ *
+ * Fix 4: JsonlWriter.INVALID_LINE → AppendOutcome.INVALID_EVENT mapping.
+ *   - Serialisation failures are now reported as INVALID_EVENT, not CORRUPT_LINE.
+ */
+export declare class JsonlEventStore implements EventStore {
+    private readonly writer;
+    private readonly boundRunId?;
+    /** Cached after first interaction with the file. */
+    private cachedSeq;
+    private cachedRunId;
+    private cacheInitialised;
+    constructor(options: JsonlEventStoreOptions);
+    get filePath(): string;
+    /** Initialise cache from existing file content (called once). */
+    private initCache;
+    append(event: AdkEventBase): Promise<AppendOutcome>;
+    appendEnvelope(envelope: EventEnvelope): Promise<AppendOutcome>;
+    readAll(): Promise<PersistedAdkEvent[]>;
+    readByRun(runId: string): AsyncGenerator<PersistedAdkEvent>;
+}
+//# sourceMappingURL=jsonl-event-store.d.ts.map

package/dist/jsonl-event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-event-store.d.ts","sourceRoot":"","sources":["../src/jsonl-event-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IAErC,oDAAoD;IACpD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,EAAE,sBAAsB;IAK3C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,iEAAiE;YACnD,SAAS;IAUjB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAQnD,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC/D,OAAO,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAQtC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC;CAMnE"}

package/dist/jsonl-event-store.js

@@ -0,0 +1,89 @@
+import { adkEventToEnvelope, envelopeToAdkEvent } from "./event-convert.js";
+import { JsonlWriter } from "./jsonl-writer.js";
+/**
+ * File-backed append-only EventStore.
+ *
+ * Fix 2: in-memory seq/runId cache — O(1) append after first write.
+ *   - On first append, file is read once to replay existing seq/runId.
+ *   - Subsequent appends use cached values; no extra readAll().
+ *   - Cache is invalidated if an external write corrupts the file;
+ *     callers must construct a fresh instance in that case.
+ *
+ * Fix 4: JsonlWriter.INVALID_LINE → AppendOutcome.INVALID_EVENT mapping.
+ *   - Serialisation failures are now reported as INVALID_EVENT, not CORRUPT_LINE.
+ */
+export class JsonlEventStore {
+    writer;
+    boundRunId;
+    /** Cached after first interaction with the file. */
+    cachedSeq = null;
+    cachedRunId = null;
+    cacheInitialised = false;
+    constructor(options) {
+        this.writer = new JsonlWriter(options.filePath);
+        this.boundRunId = options.boundRunId;
+    }
+    get filePath() {
+        return this.writer.path;
+    }
+    /** Initialise cache from existing file content (called once). */
+    async initCache() {
+        const existing = await this.writer.readAll();
+        if (!existing.ok)
+            return existing;
+        this.cachedSeq = existing.events.length;
+        this.cachedRunId = existing.events[0]?.runId ?? null;
+        this.cacheInitialised = true;
+        return { ok: true };
+    }
+    async append(event) {
+        const converted = adkEventToEnvelope(event);
+        if (!converted.ok) {
+            return { ok: false, reason: "INVALID_EVENT", message: converted.message };
+        }
+        return this.appendEnvelope(converted.envelope);
+    }
+    async appendEnvelope(envelope) {
+        if (!this.cacheInitialised) {
+            const init = await this.initCache();
+            if (!init.ok)
+                return init;
+        }
+        const expectedRunId = this.boundRunId ?? this.cachedRunId;
+        if (expectedRunId !== null && envelope.runId !== expectedRunId) {
+            return {
+                ok: false,
+                reason: "RUN_ID_MISMATCH",
+                message: `runId mismatch: expected ${expectedRunId}, got ${envelope.runId}`,
+            };
+        }
+        const written = await this.writer.append(envelope);
+        if (!written.ok) {
+            return {
+                ok: false,
+                reason: written.reason === "IO_ERROR" ? "IO_ERROR" : "INVALID_EVENT",
+                message: written.message,
+            };
+        }
+        this.cachedSeq = (this.cachedSeq ?? 0) + 1;
+        if (this.cachedRunId === null) {
+            this.cachedRunId = envelope.runId;
+        }
+        return { ok: true, event: envelopeToAdkEvent(envelope, this.cachedSeq) };
+    }
+    async readAll() {
+        const result = await this.writer.readAll();
+        if (!result.ok) {
+            throw new Error(`failed to read events: ${result.message}`);
+        }
+        return result.events.map((envelope, index) => envelopeToAdkEvent(envelope, index + 1));
+    }
+    async *readByRun(runId) {
+        const all = await this.readAll();
+        for (const event of all) {
+            if (event.runId === runId)
+                yield event;
+        }
+    }
+}
+//# sourceMappingURL=jsonl-event-store.js.map

package/dist/jsonl-event-store.js.map

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

package/dist/jsonl-writer.d.ts

@@ -0,0 +1,30 @@
+import { type EventEnvelope } from "./event-envelope.js";
+export type JsonlReadResult = {
+    readonly ok: true;
+    readonly events: EventEnvelope[];
+} | {
+    readonly ok: false;
+    readonly reason: "IO_ERROR" | "CORRUPT_LINE";
+    readonly message: string;
+    readonly lineNumber?: number;
+};
+export type JsonlAppendResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly reason: "IO_ERROR" | "INVALID_LINE" | "CORRUPT_FILE";
+    readonly message: string;
+};
+/** Append-only JSONL writer with line validation. */
+export declare class JsonlWriter {
+    private readonly filePath;
+    constructor(filePath: string);
+    get path(): string;
+    /** Read and validate all lines — fail-closed on first corrupt line. */
+    readAll(): Promise<JsonlReadResult>;
+    /** Append one validated line — writes full line + newline via appendFile. */
+    append(envelope: EventEnvelope): Promise<JsonlAppendResult>;
+    /** Replace file contents — test helper only. */
+    writeRaw(content: string): Promise<void>;
+}
+//# sourceMappingURL=jsonl-writer.d.ts.map

package/dist/jsonl-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-writer.d.ts","sourceRoot":"","sources":["../src/jsonl-writer.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjI,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpH,qDAAqD;AACrD,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,uEAAuE;IACjE,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IA6BzC,6EAA6E;IACvE,MAAM,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgBjE,gDAAgD;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAI/C"}

package/dist/jsonl-writer.js

@@ -0,0 +1,69 @@
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { parseEventLine, serializeEventEnvelope, } from "./event-envelope.js";
+/** Append-only JSONL writer with line validation. */
+export class JsonlWriter {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    get path() {
+        return this.filePath;
+    }
+    /** Read and validate all lines — fail-closed on first corrupt line. */
+    async readAll() {
+        let raw;
+        try {
+            raw = await readFile(this.filePath, "utf8");
+        }
+        catch (error) {
+            if (isEnoent(error)) {
+                return { ok: true, events: [] };
+            }
+            return { ok: false, reason: "IO_ERROR", message: String(error) };
+        }
+        const lines = raw.split("\n").filter((line) => line.length > 0);
+        const events = [];
+        for (let i = 0; i < lines.length; i += 1) {
+            const parsed = parseEventLine(lines[i]);
+            if (!parsed.ok) {
+                return {
+                    ok: false,
+                    reason: "CORRUPT_LINE",
+                    message: parsed.message,
+                    lineNumber: i + 1,
+                };
+            }
+            events.push(parsed.envelope);
+        }
+        return { ok: true, events };
+    }
+    /** Append one validated line — writes full line + newline via appendFile. */
+    async append(envelope) {
+        const line = serializeEventEnvelope(envelope);
+        const parsed = parseEventLine(line);
+        if (!parsed.ok) {
+            return { ok: false, reason: "INVALID_LINE", message: parsed.message };
+        }
+        try {
+            await mkdir(path.dirname(this.filePath), { recursive: true });
+            await appendFile(this.filePath, `${line}\n`, "utf8");
+            return { ok: true };
+        }
+        catch (error) {
+            return { ok: false, reason: "IO_ERROR", message: String(error) };
+        }
+    }
+    /** Replace file contents — test helper only. */
+    async writeRaw(content) {
+        await mkdir(path.dirname(this.filePath), { recursive: true });
+        await writeFile(this.filePath, content, "utf8");
+    }
+}
+function isEnoent(error) {
+    return isRecord(error) && "code" in error && error.code === "ENOENT";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=jsonl-writer.js.map

package/dist/jsonl-writer.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+import type { AdkEventBase } from "@jcr-adk/core";
+/** Persisted event — adds sequence for JSONL ordering. Owned by state. */
+export interface PersistedAdkEvent extends AdkEventBase {
+    readonly seq: number;
+}
+export interface AppendResult {
+    readonly ok: true;
+    readonly event: PersistedAdkEvent;
+}
+export interface AppendFailure {
+    readonly ok: false;
+    readonly reason: "IO_ERROR" | "CORRUPT_LINE" | "INVALID_EVENT" | "RUN_ID_MISMATCH";
+    readonly message: string;
+}
+export type AppendOutcome = AppendResult | AppendFailure;
+/**
+ * EventStore contract — append fail-closed on IO/corrupt/runId mismatch.
+ * Callers must not mark mutations successful until append returns ok.
+ */
+export interface EventStore {
+    append(event: AdkEventBase): Promise<AppendOutcome>;
+    readAll(): Promise<PersistedAdkEvent[]>;
+    readByRun(runId: string): AsyncGenerator<PersistedAdkEvent>;
+}
+/** Write ordering rule for gateway/state integration. */
+export declare const EVENT_FIRST_WRITE_ORDERING: "mutation-pending-until-event-append";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,0EAA0E;AAC1E,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EACX,UAAU,GACV,cAAc,GACd,eAAe,GACf,iBAAiB,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,aAAa,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpD,OAAO,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;CAC7D;AAED,yDAAyD;AACzD,eAAO,MAAM,0BAA0B,EACrC,qCAA8C,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+/** Write ordering rule for gateway/state integration. */
+export const EVENT_FIRST_WRITE_ORDERING = "mutation-pending-until-event-append";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkCA,yDAAyD;AACzD,MAAM,CAAC,MAAM,0BAA0B,GACrC,qCAA8C,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@jcr-adk/state",
+  "version": "2.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@jcr-adk/core": "2.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "description": "JCR ADK (Jason Cursor ADK) — state",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test src/in-memory-event-store.test.ts src/jsonl-event-store.test.ts",
+    "build": "tsc -p tsconfig.build.json"
+  }
+}