@yagejs-tools/feedback 0.0.0 → 0.1.0

package/dist/gallery.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/gallery.js

@@ -0,0 +1,288 @@
+// src/client/FeedbackClient.ts
+var FeedbackClient = class {
+  constructor(server = "http://127.0.0.1:5212", timeoutMs = 3e4) {
+    this.timeoutMs = timeoutMs;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 3e5)
+      throw new Error(
+        "Feedback request timeout must be an integer from 1 to 300000 ms."
+      );
+    this.base = new URL(server);
+    this.base.pathname = this.base.pathname.replace(/\/?$/, "/");
+    if (this.base.protocol !== "http:" || !["localhost", "127.0.0.1", "[::1]"].includes(this.base.hostname) || this.base.username || this.base.password || this.base.search || this.base.hash)
+      throw new Error(
+        "Feedback server must be a loopback HTTP URL without credentials, query, or fragment."
+      );
+  }
+  timeoutMs;
+  base;
+  async request(route, body, signal) {
+    const timeout = AbortSignal.timeout(this.timeoutMs);
+    const response = await fetch(new URL(route.replace(/^\//, ""), this.base), {
+      ...body !== void 0 ? {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      } : {},
+      signal: signal ? AbortSignal.any([signal, timeout]) : timeout
+    });
+    if (!response.ok)
+      throw new Error(
+        `Feedback server returned ${response.status}: ${await response.text()}`
+      );
+    return await response.json();
+  }
+  get galleryUrl() {
+    return new URL("gallery/", this.base).href;
+  }
+  session() {
+    return this.request("session");
+  }
+  list(status) {
+    return this.request(`/comments${status ? `?status=${status}` : ""}`);
+  }
+  show(id) {
+    return this.request(`/comments/${encodeURIComponent(id)}`);
+  }
+  save(upload, signal) {
+    return this.request("/comments", upload, signal);
+  }
+  transition(id, request) {
+    return this.request(
+      `/comments/${encodeURIComponent(id)}/transitions`,
+      request
+    );
+  }
+};
+
+// src/gallery/main.ts
+var get = (id) => {
+  const element = document.getElementById(id);
+  if (!element) throw new Error(`Missing gallery element: ${id}`);
+  return element;
+};
+var api = new URL(
+  document.querySelector('meta[name="feedback-api"]').content,
+  location.href
+);
+var client = new FeedbackClient(api.href);
+var selected = /* @__PURE__ */ new Set();
+var comments = [];
+var project = "";
+var page = 0;
+var generation = 0;
+var detailGeneration = 0;
+var pageSize = 24;
+var node = (tag, text, className) => {
+  const element = document.createElement(tag);
+  if (text !== void 0) element.textContent = text;
+  if (className) element.className = className;
+  return element;
+};
+var message = (text, error = false) => {
+  get("message").textContent = text;
+  get("message").className = error ? "error" : "";
+};
+function filtered() {
+  const status = get("status").value, search = get("search").value.toLowerCase().trim();
+  return comments.filter(
+    (c) => (status === "all" || (status === "pending" ? ["open", "ingested"].includes(c.status) : c.status === status)) && (!search || `${c.text} ${c.id} ${c.target.kind === "entities" ? c.target.entities.map((e) => e.name).join(" ") : c.target.kind}`.toLowerCase().includes(search))
+  );
+}
+function selectionChanged() {
+  get("codex").disabled = get(
+    "claude"
+  ).disabled = selected.size === 0 || !project;
+  get("summary").textContent = `${filtered().length} comments \xB7 ${selected.size} selected. Reading and copying leave status unchanged.`;
+}
+function render() {
+  const items = filtered();
+  page = Math.min(page, Math.max(0, Math.ceil(items.length / pageSize) - 1));
+  get("cards").replaceChildren();
+  for (const comment of items.slice(page * pageSize, (page + 1) * pageSize)) {
+    const card = node("article", void 0, "card"), preview = node("button", void 0, "preview"), img = node("img");
+    preview.setAttribute(
+      "aria-label",
+      `View evidence: ${comment.text.slice(0, 100)}`
+    );
+    img.src = new URL(`captures/${comment.captureId}/screenshot.png`, api).href;
+    img.alt = "Captured game view";
+    img.loading = "lazy";
+    preview.append(img);
+    preview.onclick = () => {
+      void showDetail(comment.id);
+    };
+    const content = node("div", void 0, "content"), meta = node("div", void 0, "meta"), label = node("label"), checkbox = node("input");
+    checkbox.type = "checkbox";
+    checkbox.checked = selected.has(comment.id);
+    checkbox.setAttribute("aria-label", `Select comment ${comment.id}`);
+    checkbox.onchange = () => {
+      if (checkbox.checked) selected.add(comment.id);
+      else selected.delete(comment.id);
+      selectionChanged();
+    };
+    label.append(
+      checkbox,
+      node(
+        "span",
+        comment.target.kind === "global" ? "Whole view" : comment.target.kind === "area" ? "Area" : `${comment.target.entities.length} entities`
+      )
+    );
+    meta.append(label, node("span", comment.status, "badge"));
+    const open = node("button", "View evidence");
+    open.onclick = preview.onclick;
+    content.append(
+      meta,
+      node("p", comment.text, "comment"),
+      node("p", new Date(comment.created).toLocaleString(), "muted"),
+      open
+    );
+    card.append(preview, content);
+    get("cards").append(card);
+  }
+  if (!items.length)
+    get("cards").append(node("p", "No comments match this view.", "muted"));
+  get("previous").disabled = page === 0;
+  get("next").disabled = (page + 1) * pageSize >= items.length;
+  get("page").textContent = `Page ${page + 1} of ${Math.max(1, Math.ceil(items.length / pageSize))}`;
+  selectionChanged();
+}
+async function refresh() {
+  const current = ++generation;
+  get("refresh").disabled = true;
+  try {
+    const [session, records] = await Promise.all([
+      client.session(),
+      client.list()
+    ]);
+    if (current !== generation) return;
+    project = session.project;
+    comments = records.reverse();
+    get("project").textContent = project;
+    for (const id of selected)
+      if (!comments.some((c) => c.id === id)) selected.delete(id);
+    render();
+    message("");
+  } catch (error) {
+    if (current === generation)
+      message(error instanceof Error ? error.message : String(error), true);
+  } finally {
+    if (current === generation)
+      get("refresh").disabled = false;
+  }
+}
+async function showDetail(id) {
+  const current = ++detailGeneration;
+  const dialog = get("detail");
+  get("evidence").replaceChildren(node("p", "Loading evidence\u2026"));
+  if (!dialog.open) dialog.showModal();
+  try {
+    const data = await client.show(id);
+    if (current !== detailGeneration || !dialog.open) return;
+    const { comment, capture } = data, layout = node("div", void 0, "detail-grid"), figure = node("div", void 0, "capture"), img = node("img");
+    img.src = new URL(data.screenshotUrl, api).href;
+    img.alt = `Original capture at frame ${capture.frame}`;
+    figure.append(img);
+    const boxes = comment.target.kind === "area" ? [comment.target.rect] : comment.target.kind === "entities" ? comment.target.entities.map((e) => e.bounds) : [];
+    for (const box of boxes) {
+      const outline = node("div", void 0, "outline");
+      Object.assign(outline.style, {
+        left: `${box.x / capture.width * 100}%`,
+        top: `${box.y / capture.height * 100}%`,
+        width: `${box.width / capture.width * 100}%`,
+        height: `${box.height / capture.height * 100}%`
+      });
+      figure.append(outline);
+    }
+    const info = node("section");
+    info.append(
+      node("span", comment.status, "badge"),
+      node("p", comment.text, "comment"),
+      node(
+        "p",
+        `Frame ${capture.frame} \xB7 ${capture.width} \xD7 ${capture.height}`
+      ),
+      node("p", new Date(capture.created).toLocaleString(), "muted")
+    );
+    for (const [title, value] of [
+      ["Target", comment.target],
+      ["Host context", capture.context],
+      ["Inspector snapshot", capture.snapshot],
+      ["Status history", comment.history]
+    ]) {
+      const block = node("details");
+      block.append(
+        node("summary", title),
+        node("pre", JSON.stringify(value, null, 2))
+      );
+      info.append(block);
+    }
+    info.append(node("p", `Comment ${comment.id}`, "muted"));
+    layout.append(figure, info);
+    get("evidence").replaceChildren(layout);
+  } catch (error) {
+    if (current === detailGeneration)
+      get("evidence").replaceChildren(
+        node(
+          "p",
+          error instanceof Error ? error.message : String(error),
+          "error"
+        )
+      );
+  }
+}
+async function copy(agent) {
+  const ids = [...selected];
+  if (!ids.length || !project) return;
+  const instruction = `${agent === "claude" ? "/yage-feedback" : "$yage-feedback"} Address these feedback comments: ${ids.join(", ")}.
+Project: ${JSON.stringify(project)}
+Feedback server: ${api.href}
+Inspect each comment's screenshot and inspector snapshot, then follow the skill's acknowledgement and verification workflow. Limit this batch to the listed IDs.`;
+  try {
+    await navigator.clipboard.writeText(instruction);
+    message(
+      `Copied ${ids.length} comments for ${agent === "claude" ? "Claude" : "Codex"}. Paste into a session opened in this project.`
+    );
+  } catch {
+    get("instruction").value = instruction;
+    get("copy").showModal();
+    get("instruction").focus();
+    get("instruction").select();
+  }
+}
+get("refresh").onclick = () => {
+  void refresh();
+};
+for (const id of ["status", "search"])
+  get(id).addEventListener(id === "search" ? "input" : "change", () => {
+    selected.clear();
+    page = 0;
+    render();
+  });
+get("previous").onclick = () => {
+  page--;
+  render();
+};
+get("next").onclick = () => {
+  page++;
+  render();
+};
+get("select-page").onclick = () => {
+  filtered().slice(page * pageSize, (page + 1) * pageSize).forEach((c) => selected.add(c.id));
+  render();
+};
+get("clear").onclick = () => {
+  selected.clear();
+  render();
+};
+get("codex").onclick = () => {
+  void copy("codex");
+};
+get("claude").onclick = () => {
+  void copy("claude");
+};
+get("close-detail").onclick = () => get("detail").close();
+get("close-copy").onclick = () => get("copy").close();
+get("detail").addEventListener("close", () => {
+  detailGeneration++;
+});
+void refresh();

package/dist/index.d.ts

@@ -0,0 +1,117 @@
+import { Plugin, EngineContext } from '@yagejs/core';
+
+/** Physical KeyboardEvent.code plus exact modifiers; omitted modifiers are false. */
+interface FeedbackShortcut {
+    code: string;
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+    meta?: boolean;
+}
+interface FeedbackShortcuts {
+    /** Omitted bindings retain their defaults; false disables this action's key. */
+    feedback?: FeedbackShortcut | false;
+    freeze?: FeedbackShortcut | false;
+    stepFrame?: FeedbackShortcut | false;
+    stepTenFrames?: FeedbackShortcut | false;
+}
+
+type Json = null | boolean | number | string | Json[] | {
+    [key: string]: Json;
+};
+interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface FeedbackEntity {
+    sceneId: string;
+    id: string;
+    generation: number;
+    name: string;
+    bounds: Rect;
+}
+type FeedbackTarget = {
+    kind: "global";
+} | {
+    kind: "entities";
+    entities: FeedbackEntity[];
+} | {
+    kind: "area";
+    rect: Rect;
+};
+interface FeedbackCapture {
+    version: 1;
+    id: string;
+    sessionId: string;
+    created: string;
+    frame: number;
+    url: string;
+    width: number;
+    height: number;
+    context: Json;
+    snapshot: Json;
+    entities: FeedbackEntity[];
+}
+interface AuthoredComment {
+    id: string;
+    captureId: string;
+    text: string;
+    created: string;
+    target: FeedbackTarget;
+    status: "open";
+}
+type FeedbackStatus = "open" | "ingested" | "addressed" | "resolved";
+type FeedbackAction = "ingest" | "address" | "resolve" | "reopen";
+interface FeedbackTransition {
+    requestId: string;
+    expectedRevision: number;
+    action: FeedbackAction;
+    actor: string;
+    note?: string;
+}
+interface FeedbackHistoryEntry extends FeedbackTransition {
+    revision: number;
+    created: string;
+    from: FeedbackStatus;
+    to: FeedbackStatus;
+}
+interface FeedbackComment extends Omit<AuthoredComment, "status"> {
+    status: FeedbackStatus;
+    revision: number;
+    history: FeedbackHistoryEntry[];
+}
+interface FeedbackDetail {
+    comment: FeedbackComment;
+    capture: FeedbackCapture;
+    screenshotPath: string;
+    screenshotUrl: string;
+}
+
+interface FeedbackOptions {
+    /** Use the same debug flag supplied to Engine. Disabled plugins mount no UI. */
+    enabled: boolean;
+    /** Full API base URL. Defaults to dev-server metadata, then localhost:5212. */
+    server?: string;
+    /** Defaults to F8/F9 for feedback/freeze and F10/Shift+F10 for stepping. Override individual bindings or pass false to disable all. */
+    shortcuts?: boolean | FeedbackShortcuts;
+    context?: () => Json;
+}
+/** Composes the runtime adapter, session, transport, and DOM interface. */
+declare class FeedbackPlugin implements Plugin {
+    private readonly options;
+    readonly name = "feedback";
+    readonly version = "0.0.0";
+    readonly dependencies: readonly ["renderer", "debug"];
+    private context;
+    private panel;
+    private readonly client;
+    private readonly shortcuts;
+    constructor(options: FeedbackOptions);
+    install(context: EngineContext): void;
+    onStart(): void;
+    onDestroy(): void;
+}
+
+export { type AuthoredComment, type FeedbackAction, type FeedbackCapture, type FeedbackComment, type FeedbackDetail, type FeedbackEntity, type FeedbackHistoryEntry, type FeedbackOptions, FeedbackPlugin, type FeedbackShortcut, type FeedbackShortcuts, type FeedbackStatus, type FeedbackTarget, type FeedbackTransition, type Json, type Rect };