@agentkit-js/devtools 0.2.0

package/LICENSE

@@ -0,0 +1,186 @@
+                                 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 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, as defined by the copyright owner,
+      any work of authorship, including the original version of the Work and
+      any modifications or additions to that Work or Derivative Works of the
+      Work, that is intentionally submitted to the 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 Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and included
+      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 the 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 any
+      Contribution embodied within the Work constitutes patent 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, You must include a readable copy of the
+          attribution notices contained within such NOTICE file, 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 license statement for Your modifications and
+      may provide additional grant of rights to use, copy, modify, merge,
+      publish, distribute, sublicense, and/or sell copies of the
+      Contribution, either alone or in combination with the Work.
+
+   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 conditions of
+      TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or reproducing 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 exemplary 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 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
+
+   Copyright 2026 agentkit-js contributors
+
+   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/README.md

@@ -0,0 +1,27 @@
+# @agentkit-js/devtools
+
+Time-travel debugger — `EventLogReplay` engine + opt-in `<DevTools />` React UI.
+
+> Part of [agentkit-js](https://github.com/telleroutlook/agentkit-js) — a TypeScript + WASM agent runtime.
+
+## Install
+
+```bash
+npm install @agentkit-js/devtools @agentkit-js/core
+```
+
+## Usage
+
+Step-replay any `EventLog` and **fork from any step**. The React surface is opt-in via
+the `/react` subpath (peer-depends on React, but never required for the core engine).
+
+```tsx
+import { EventLogReplay } from "@agentkit-js/devtools";
+import { DevTools } from "@agentkit-js/devtools/react";
+```
+
+See [docs/guides/devtools.md](https://github.com/telleroutlook/agentkit-js/blob/main/docs/guides/devtools.md).
+
+## License
+
+[Apache-2.0](./LICENSE) — © agentkit-js contributors

package/dist/EventLogReplay.d.ts

@@ -0,0 +1,102 @@
+/**
+ * A2 — DevTools event-log replay engine.
+ *
+ * Pure logic. Loads a list of `LoggedEvent`s (from agentkit-js's EventLog
+ * or any equivalent source), exposes a navigable timeline, and supports
+ * "fork from step N" — produce a new event list that ends at step N so a
+ * caller can rerun the agent from that point with different inputs
+ * (changed prompt, swapped model, swapped tools).
+ *
+ * The engine intentionally does NOT know about React or any UI. The
+ * `react/` subpath wraps it in a component; this file is consumable from
+ * Node, edge runtimes, and tests alike.
+ */
+import type { AgentEvent } from "@agentkit-js/core";
+/** Shape we accept — kept structurally compatible with EventLog's LoggedEvent. */
+export interface LoggedEvent {
+    eventId: string;
+    event: AgentEvent;
+}
+/** Lightweight per-step view derived from the event stream. */
+export interface ReplayStep {
+    /** 1-based step number, or 0 for events before any `step_start`. */
+    step: number;
+    /** The event id of the `step_start` (or the first event for step 0). */
+    startEventId: string;
+    /** Indices into the underlying events array — tracked for fast slicing. */
+    fromIndex: number;
+    toIndex: number;
+    /** Convenience — the events that belong to this step (live reference). */
+    events: LoggedEvent[];
+}
+/** Snapshot returned by select() / forkAt(). */
+export interface ReplayCursor {
+    /** Total number of events in the underlying log. */
+    totalEvents: number;
+    /** Total number of steps (a "step" is delimited by `step_start` events). */
+    totalSteps: number;
+    /** Current step index, 0-based. 0 = pre-first-step events. */
+    currentStep: number;
+    /** All events up to and including `currentStep`. */
+    prefixEvents: LoggedEvent[];
+    /** Final answer text if a `final_answer` event exists in `prefixEvents`. */
+    finalAnswer: string | null;
+}
+/** Options accepted by `forkAt`. */
+export interface ForkOptions {
+    /** Optional — replace the original task with this string when describing the fork. */
+    task?: string;
+    /** Optional — note the model id swap so docs/tools can render it. */
+    modelId?: string;
+    /** Optional — free-form note attached to the fork's metadata. */
+    note?: string;
+}
+/** Result of forking — the prefix events + a metadata bundle to feed to a fresh run. */
+export interface Fork {
+    prefixEvents: LoggedEvent[];
+    forkedAtStep: number;
+    forkedAtEventId: string;
+    meta: ForkOptions & {
+        forkedFromTraceId?: string;
+    };
+}
+/**
+ * Replay engine for one trace. Construction is O(n) over the event list;
+ * navigation operations are O(1).
+ */
+export declare class EventLogReplay {
+    #private;
+    constructor(events: LoggedEvent[], opts?: {
+        traceId?: string;
+    });
+    /** Number of events in the log. */
+    get eventCount(): number;
+    /** Number of distinct steps (delimited by `step_start` events). */
+    get stepCount(): number;
+    /** Read-only view of the underlying events. */
+    get events(): readonly LoggedEvent[];
+    /** Read-only view of the computed step boundaries. */
+    get steps(): readonly ReplayStep[];
+    /**
+     * Return a cursor positioned at `step`. Negative values clamp to 0;
+     * values past the end clamp to `stepCount`.
+     *
+     * `prefixEvents` includes everything up to AND INCLUDING the named step
+     * — so `select(0)` returns events before the first `step_start`, and
+     * `select(stepCount)` returns the full log.
+     */
+    select(step: number): ReplayCursor;
+    /**
+     * Fork from the given step. Returns the prefix event list AND a metadata
+     * bundle the caller can use to spawn a fresh agent run with the prefix
+     * replayed in (eg by feeding the events into a new MessageAssembler).
+     */
+    forkAt(step: number, opts?: ForkOptions): Fork;
+    /**
+     * Find the highest step index whose first event id is ≤ the given
+     * eventId. Lets the UI map a clicked event row back to its step.
+     * Returns 0 when the eventId precedes all `step_start`s.
+     */
+    stepForEventId(eventId: string): number;
+}
+//# sourceMappingURL=EventLogReplay.d.ts.map

package/dist/EventLogReplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventLogReplay.d.ts","sourceRoot":"","sources":["../src/EventLogReplay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,4EAA4E;IAC5E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wFAAwF;AACxF,MAAM,WAAW,IAAI;IACnB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,WAAW,GAAG;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED;;;GAGG;AACH,qBAAa,cAAc;;gBAKb,MAAM,EAAE,WAAW,EAAE,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAOlE,mCAAmC;IACnC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,mEAAmE;IACnE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,+CAA+C;IAC/C,IAAI,MAAM,IAAI,SAAS,WAAW,EAAE,CAEnC;IAED,sDAAsD;IACtD,IAAI,KAAK,IAAI,SAAS,UAAU,EAAE,CAEjC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAsBlC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,IAAI;IAclD;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CA6CxC"}

package/dist/EventLogReplay.js

@@ -0,0 +1,159 @@
+/**
+ * A2 — DevTools event-log replay engine.
+ *
+ * Pure logic. Loads a list of `LoggedEvent`s (from agentkit-js's EventLog
+ * or any equivalent source), exposes a navigable timeline, and supports
+ * "fork from step N" — produce a new event list that ends at step N so a
+ * caller can rerun the agent from that point with different inputs
+ * (changed prompt, swapped model, swapped tools).
+ *
+ * The engine intentionally does NOT know about React or any UI. The
+ * `react/` subpath wraps it in a component; this file is consumable from
+ * Node, edge runtimes, and tests alike.
+ */
+/**
+ * Replay engine for one trace. Construction is O(n) over the event list;
+ * navigation operations are O(1).
+ */
+export class EventLogReplay {
+    #events;
+    #steps;
+    #traceId;
+    constructor(events, opts = {}) {
+        // Defensive copy so external mutation cannot corrupt the timeline.
+        this.#events = [...events];
+        this.#traceId = opts.traceId;
+        this.#steps = this.#computeSteps();
+    }
+    /** Number of events in the log. */
+    get eventCount() {
+        return this.#events.length;
+    }
+    /** Number of distinct steps (delimited by `step_start` events). */
+    get stepCount() {
+        return this.#steps.length;
+    }
+    /** Read-only view of the underlying events. */
+    get events() {
+        return this.#events;
+    }
+    /** Read-only view of the computed step boundaries. */
+    get steps() {
+        return this.#steps;
+    }
+    /**
+     * Return a cursor positioned at `step`. Negative values clamp to 0;
+     * values past the end clamp to `stepCount`.
+     *
+     * `prefixEvents` includes everything up to AND INCLUDING the named step
+     * — so `select(0)` returns events before the first `step_start`, and
+     * `select(stepCount)` returns the full log.
+     */
+    select(step) {
+        const clamped = Math.max(0, Math.min(this.#steps.length, step));
+        let prefix;
+        if (clamped === 0) {
+            prefix =
+                this.#steps.length > 0
+                    ? this.#events.slice(0, this.#steps[0]?.fromIndex)
+                    : [...this.#events];
+        }
+        else {
+            const stepEntry = this.#steps[clamped - 1];
+            prefix = stepEntry ? this.#events.slice(0, stepEntry.toIndex + 1) : [...this.#events];
+        }
+        const finalAnswer = findFinalAnswer(prefix);
+        return {
+            totalEvents: this.#events.length,
+            totalSteps: this.#steps.length,
+            currentStep: clamped,
+            prefixEvents: prefix,
+            finalAnswer,
+        };
+    }
+    /**
+     * Fork from the given step. Returns the prefix event list AND a metadata
+     * bundle the caller can use to spawn a fresh agent run with the prefix
+     * replayed in (eg by feeding the events into a new MessageAssembler).
+     */
+    forkAt(step, opts = {}) {
+        const cursor = this.select(step);
+        const lastEvent = cursor.prefixEvents[cursor.prefixEvents.length - 1];
+        return {
+            prefixEvents: cursor.prefixEvents,
+            forkedAtStep: cursor.currentStep,
+            forkedAtEventId: lastEvent?.eventId ?? "",
+            meta: {
+                ...opts,
+                ...(this.#traceId ? { forkedFromTraceId: this.#traceId } : {}),
+            },
+        };
+    }
+    /**
+     * Find the highest step index whose first event id is ≤ the given
+     * eventId. Lets the UI map a clicked event row back to its step.
+     * Returns 0 when the eventId precedes all `step_start`s.
+     */
+    stepForEventId(eventId) {
+        let lastMatch = 0;
+        for (let i = 0; i < this.#steps.length; i++) {
+            const step = this.#steps[i];
+            if (!step)
+                break;
+            if (step.startEventId <= eventId) {
+                lastMatch = i + 1;
+            }
+            else {
+                break;
+            }
+        }
+        return lastMatch;
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    #computeSteps() {
+        const out = [];
+        let stepIndex = 0;
+        for (let i = 0; i < this.#events.length; i++) {
+            const ev = this.#events[i];
+            if (!ev)
+                continue;
+            if (ev.event.event === "step_start") {
+                // Close out the previous step (if any) before opening this one.
+                const prev = out[out.length - 1];
+                if (prev)
+                    prev.toIndex = i - 1;
+                stepIndex += 1;
+                out.push({
+                    step: stepIndex,
+                    startEventId: ev.eventId,
+                    fromIndex: i,
+                    toIndex: i, // tentative, fixed up below
+                    events: [],
+                });
+            }
+        }
+        // Final close-out for the last step.
+        const lastStep = out[out.length - 1];
+        if (lastStep)
+            lastStep.toIndex = this.#events.length - 1;
+        // Backfill the events arrays.
+        for (const s of out) {
+            s.events = this.#events.slice(s.fromIndex, s.toIndex + 1);
+        }
+        return out;
+    }
+}
+function findFinalAnswer(events) {
+    for (let i = events.length - 1; i >= 0; i--) {
+        const e = events[i]?.event;
+        if (!e)
+            continue;
+        if (e.event === "final_answer") {
+            const data = e.data;
+            if (data && typeof data.answer === "string")
+                return data.answer;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=EventLogReplay.js.map

package/dist/EventLogReplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventLogReplay.js","sourceRoot":"","sources":["../src/EventLogReplay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuDH;;;GAGG;AACH,MAAM,OAAO,cAAc;IAChB,OAAO,CAAgB;IACvB,MAAM,CAAe;IACrB,QAAQ,CAAqB;IAEtC,YAAY,MAAqB,EAAE,OAA6B,EAAE;QAChE,mEAAmE;QACnE,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC;IAED,mCAAmC;IACnC,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,mEAAmE;IACnE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,+CAA+C;IAC/C,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,sDAAsD;IACtD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAY;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAChE,IAAI,MAAqB,CAAC;QAC1B,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,MAAM;gBACJ,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBACpB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;oBAClD,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAC3C,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAChC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC9B,WAAW,EAAE,OAAO;YACpB,YAAY,EAAE,MAAM;YACpB,WAAW;SACZ,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAY,EAAE,OAAoB,EAAE;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtE,OAAO;YACL,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,YAAY,EAAE,MAAM,CAAC,WAAW;YAChC,eAAe,EAAE,SAAS,EAAE,OAAO,IAAI,EAAE;YACzC,IAAI,EAAE;gBACJ,GAAG,IAAI;gBACP,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,OAAe;QAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI;gBAAE,MAAM;YACjB,IAAI,IAAI,CAAC,YAAY,IAAI,OAAO,EAAE,CAAC;gBACjC,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,6EAA6E;IAE7E,aAAa;QACX,MAAM,GAAG,GAAiB,EAAE,CAAC;QAC7B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,CAAC,EAAE;gBAAE,SAAS;YAClB,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;gBACpC,gEAAgE;gBAChE,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACjC,IAAI,IAAI;oBAAE,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC/B,SAAS,IAAI,CAAC,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,SAAS;oBACf,YAAY,EAAE,EAAE,CAAC,OAAO;oBACxB,SAAS,EAAE,CAAC;oBACZ,OAAO,EAAE,CAAC,EAAE,4BAA4B;oBACxC,MAAM,EAAE,EAAE;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,qCAAqC;QACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,QAAQ;YAAE,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACzD,8BAA8B;QAC9B,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,SAAS,eAAe,CAAC,MAAqB;IAC5C,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QAC3B,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAI,CAAqC,CAAC,IAAI,CAAC;YACzD,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QAClE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @agentkit-js/devtools — runtime-agnostic primitives.
+ *
+ * Re-exports the replay engine and helper types. The React UI lives in the
+ * `./react` subpath so consumers without React (eg server-side fork tools)
+ * don't pay the bundle cost.
+ */
+export type { Fork, ForkOptions, LoggedEvent, ReplayCursor, ReplayStep, } from "./EventLogReplay.js";
+export { EventLogReplay } from "./EventLogReplay.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;;;;;;GAMG;AACH,YAAY,EACV,IAAI,EACJ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,GACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { EventLogReplay } from "./EventLogReplay.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":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/react/DevTools.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A2 — DevTools React component.
+ *
+ * Renders an event timeline, a step inspector, and a "fork from step N"
+ * affordance. State and rendering only — the actual fork (running a fresh
+ * agent on the prefix) is the host application's job; this component
+ * surfaces the user's intent via `onFork`.
+ *
+ * The component is intentionally style-light — the host page can wrap it
+ * or pass `className` props at the section boundaries. We don't ship CSS
+ * to keep the bundle tiny.
+ */
+import { type Fork, type LoggedEvent } from "../EventLogReplay.js";
+export interface DevToolsProps {
+    /** The full event log for one trace, as produced by EventLog.replay(). */
+    events: LoggedEvent[];
+    /** Optional trace id; surfaced in fork metadata. */
+    traceId?: string;
+    /**
+     * Called when the user clicks "Fork from this step". The host application
+     * should kick off a fresh agent run with the supplied prefix events and
+     * the user-edited override (task / modelId / note).
+     *
+     * Returning a Promise is fine; the component does NOT await it (no spinner
+     * UI in this baseline). Add your own status display in the host page.
+     */
+    onFork?: (fork: Fork) => void | Promise<void>;
+}
+export declare function DevTools({ events, traceId, onFork }: DevToolsProps): import("react").JSX.Element;
+//# sourceMappingURL=DevTools.d.ts.map

package/dist/react/DevTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevTools.d.ts","sourceRoot":"","sources":["../../src/react/DevTools.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAEL,KAAK,IAAI,EAET,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,wBAAgB,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,aAAa,+BA2IlE"}

package/dist/react/DevTools.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * A2 — DevTools React component.
+ *
+ * Renders an event timeline, a step inspector, and a "fork from step N"
+ * affordance. State and rendering only — the actual fork (running a fresh
+ * agent on the prefix) is the host application's job; this component
+ * surfaces the user's intent via `onFork`.
+ *
+ * The component is intentionally style-light — the host page can wrap it
+ * or pass `className` props at the section boundaries. We don't ship CSS
+ * to keep the bundle tiny.
+ */
+import { useMemo, useState } from "react";
+import { EventLogReplay, } from "../EventLogReplay.js";
+export function DevTools({ events, traceId, onFork }) {
+    const replay = useMemo(() => new EventLogReplay(events, traceId !== undefined ? { traceId } : {}), [events, traceId]);
+    const [step, setStep] = useState(replay.stepCount);
+    const [taskOverride, setTaskOverride] = useState("");
+    const [modelOverride, setModelOverride] = useState("");
+    const [note, setNote] = useState("");
+    const cursor = useMemo(() => replay.select(step), [replay, step]);
+    const triggerFork = () => {
+        const opts = {};
+        if (taskOverride.trim())
+            opts.task = taskOverride.trim();
+        if (modelOverride.trim())
+            opts.modelId = modelOverride.trim();
+        if (note.trim())
+            opts.note = note.trim();
+        const fork = replay.forkAt(step, opts);
+        void onFork?.(fork);
+    };
+    return (_jsxs("div", { "data-testid": "agentkit-devtools", style: { fontFamily: "ui-sans-serif, system-ui", fontSize: 13 }, children: [_jsxs("header", { style: { marginBottom: 8 }, children: [_jsx("strong", { children: "Agent DevTools" }), _jsxs("span", { style: { color: "#888", marginLeft: 8 }, children: [replay.stepCount, " step", replay.stepCount === 1 ? "" : "s", " \u00B7 ", replay.eventCount, " event", replay.eventCount === 1 ? "" : "s"] })] }), _jsxs("div", { style: { display: "flex", gap: 12 }, children: [_jsxs("div", { style: { minWidth: 220, borderRight: "1px solid #eee", paddingRight: 8 }, children: [_jsx("div", { style: { fontWeight: 600, marginBottom: 6 }, children: "Steps" }), _jsxs("ol", { style: { listStyle: "none", padding: 0, margin: 0 }, children: [_jsx("li", { children: _jsx("button", { type: "button", onClick: () => setStep(0), "aria-pressed": step === 0, style: selectedStyle(step === 0), children: "0 \u00B7 prelude" }) }), replay.steps.map((s) => (_jsx("li", { children: _jsxs("button", { type: "button", onClick: () => setStep(s.step), "aria-pressed": step === s.step, style: selectedStyle(step === s.step), children: [s.step, " \u00B7 ", s.events.length, " event", s.events.length === 1 ? "" : "s"] }) }, s.startEventId)))] })] }), _jsxs("div", { style: { flex: 1, minWidth: 0 }, children: [_jsxs("div", { style: { fontWeight: 600, marginBottom: 6 }, children: ["Cursor: step ", cursor.currentStep, " / ", cursor.totalSteps] }), cursor.finalAnswer ? (_jsxs("div", { style: {
+                                    background: "#f6fff6",
+                                    border: "1px solid #cfe9cf",
+                                    padding: 6,
+                                    marginBottom: 8,
+                                }, children: [_jsx("div", { style: { fontWeight: 600, fontSize: 11, color: "#3a7" }, children: "FINAL ANSWER" }), _jsx("div", { style: { whiteSpace: "pre-wrap" }, children: cursor.finalAnswer })] })) : null, _jsxs("div", { style: { marginBottom: 8 }, children: [_jsx("div", { style: { fontWeight: 600, marginBottom: 4 }, children: "Events in prefix" }), _jsx("ul", { style: { listStyle: "none", padding: 0, margin: 0, maxHeight: 200, overflow: "auto" }, children: cursor.prefixEvents.map((le) => (_jsxs("li", { style: { borderBottom: "1px solid #f3f3f3", padding: "2px 0" }, children: [_jsx("code", { style: { color: "#888", fontSize: 11 }, children: le.eventId }), " ", _jsx("strong", { children: le.event.event }), " ", _jsx("span", { style: { color: "#666" }, children: summarise(le.event) })] }, le.eventId))) })] }), _jsxs("details", { children: [_jsxs("summary", { style: { cursor: "pointer", fontWeight: 600 }, children: ["Fork from step ", step] }), _jsxs("div", { style: { marginTop: 6, display: "grid", gap: 6 }, children: [_jsxs("label", { children: [_jsx("div", { style: { fontSize: 11, color: "#666" }, children: "Task override (optional)" }), _jsx("textarea", { rows: 2, value: taskOverride, onChange: (e) => setTaskOverride(e.target.value), style: { width: "100%", fontSize: 12 } })] }), _jsxs("label", { children: [_jsx("div", { style: { fontSize: 11, color: "#666" }, children: "Model override (optional)" }), _jsx("input", { value: modelOverride, onChange: (e) => setModelOverride(e.target.value), placeholder: "e.g. claude-haiku-4-5", style: { width: "100%", fontSize: 12 } })] }), _jsxs("label", { children: [_jsx("div", { style: { fontSize: 11, color: "#666" }, children: "Note (optional)" }), _jsx("input", { value: note, onChange: (e) => setNote(e.target.value), style: { width: "100%", fontSize: 12 } })] }), _jsx("button", { type: "button", onClick: triggerFork, children: "Fork & re-run" })] })] })] })] })] }));
+}
+function selectedStyle(selected) {
+    return {
+        display: "block",
+        width: "100%",
+        textAlign: "left",
+        padding: "3px 6px",
+        border: "1px solid transparent",
+        background: selected ? "#eef" : "transparent",
+        fontWeight: selected ? 600 : 400,
+        cursor: "pointer",
+        fontSize: 12,
+    };
+}
+function summarise(ev) {
+    const data = ev.data;
+    if (!data)
+        return "";
+    if ("answer" in data) {
+        const a = data.answer;
+        return typeof a === "string" ? a.slice(0, 80) : "";
+    }
+    if ("toolName" in data)
+        return String(data.toolName);
+    if ("step" in data)
+        return `step ${String(data.step)}`;
+    return "";
+}
+//# sourceMappingURL=DevTools.js.map

package/dist/react/DevTools.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @agentkit-js/devtools/react — React UI for the replay engine.
+ *
+ * Imported via `import { DevTools } from "@agentkit-js/devtools/react";`.
+ * Pure component layer; the underlying logic lives in EventLogReplay
+ * (one subpath up).
+ */
+export type { DevToolsProps } from "./DevTools.js";
+export { DevTools } from "./DevTools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/react/index.js

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

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@agentkit-js/devtools",
+  "version": "0.2.0",
+  "description": "DevTools for agentkit-js — event timeline, step-replay, fork-from-checkpoint",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "jsdom": "^29.1.1",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "@agentkit-js/core": "workspace:*"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/telleroutlook/agentkit-js.git",
+    "directory": "packages/devtools"
+  },
+  "homepage": "https://github.com/telleroutlook/agentkit-js/tree/main/packages/devtools#readme",
+  "bugs": {
+    "url": "https://github.com/telleroutlook/agentkit-js/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "agentkit",
+    "agent",
+    "ai",
+    "llm"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "author": "agentkit-js contributors"
+}