@jami-studio/pinpoint 0.1.12

package/dist/server/index.js

@@ -0,0 +1,457 @@
+import {
+  PinSchema
+} from "../chunk-J5PXKVTM.js";
+import {
+  __require
+} from "../chunk-DGUM43GV.js";
+
+// src/server/middleware.ts
+import { Router } from "express";
+
+// src/storage/file-store.ts
+import { randomUUID } from "crypto";
+import {
+  readdir,
+  readFile,
+  writeFile,
+  unlink,
+  rename,
+  mkdir
+} from "fs/promises";
+import { tmpdir } from "os";
+import { join, resolve } from "path";
+var VALID_ID = /^[a-zA-Z0-9_-]+$/;
+var FileStore = class {
+  dir;
+  constructor(dataDir = "data/pins") {
+    this.dir = resolve(dataDir);
+  }
+  validateId(id) {
+    if (!VALID_ID.test(id)) {
+      throw new Error(`Invalid pin ID: ${id}`);
+    }
+  }
+  pinPath(id) {
+    this.validateId(id);
+    const resolved = join(this.dir, `${id}.json`);
+    if (!resolved.startsWith(this.dir)) {
+      throw new Error("Path traversal detected");
+    }
+    return resolved;
+  }
+  async ensureDir() {
+    await mkdir(this.dir, { recursive: true });
+  }
+  async readPin(filePath) {
+    try {
+      const content = await readFile(filePath, "utf-8");
+      const parsed = JSON.parse(content);
+      const result = PinSchema.safeParse(parsed);
+      return result.success ? result.data : null;
+    } catch {
+      return null;
+    }
+  }
+  async atomicWrite(filePath, data) {
+    await this.ensureDir();
+    const tempPath = join(tmpdir(), `pinpoint-${randomUUID()}.tmp`);
+    await writeFile(tempPath, data, "utf-8");
+    await rename(tempPath, filePath);
+  }
+  async load(pageUrl) {
+    return this.list({ pageUrl });
+  }
+  async save(pin) {
+    const filePath = this.pinPath(pin.id);
+    await this.atomicWrite(filePath, JSON.stringify(pin, null, 2));
+  }
+  async update(id, patch) {
+    const filePath = this.pinPath(id);
+    const existing = await this.readPin(filePath);
+    if (!existing) return;
+    const updated = {
+      ...existing,
+      ...patch,
+      id: existing.id,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.atomicWrite(filePath, JSON.stringify(updated, null, 2));
+  }
+  async delete(id) {
+    try {
+      await unlink(this.pinPath(id));
+    } catch {
+    }
+  }
+  async list(filter) {
+    await this.ensureDir();
+    let files;
+    try {
+      files = await readdir(this.dir);
+    } catch {
+      return [];
+    }
+    const pins = [];
+    for (const file of files) {
+      if (!file.endsWith(".json")) continue;
+      const pin = await this.readPin(join(this.dir, file));
+      if (!pin) continue;
+      if (filter?.pageUrl && pin.pageUrl !== filter.pageUrl) continue;
+      if (filter?.status && pin.status.state !== filter.status) continue;
+      pins.push(pin);
+    }
+    return pins.sort(
+      (a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime()
+    );
+  }
+  async clear(pageUrl) {
+    await this.ensureDir();
+    let files;
+    try {
+      files = await readdir(this.dir);
+    } catch {
+      return;
+    }
+    for (const file of files) {
+      if (!file.endsWith(".json")) continue;
+      const filePath = join(this.dir, file);
+      if (pageUrl) {
+        const pin = await this.readPin(filePath);
+        if (pin && pin.pageUrl === pageUrl) {
+          await unlink(filePath).catch(() => {
+          });
+        }
+      } else {
+        await unlink(filePath).catch(() => {
+        });
+      }
+    }
+  }
+};
+
+// src/server/middleware.ts
+var VALID_ID2 = /^[a-zA-Z0-9_-]+$/;
+function validateId(id) {
+  return VALID_ID2.test(id) && id.length > 0 && id.length <= 128;
+}
+function pagePinRoutes(options = {}) {
+  const router = Router();
+  const store = new FileStore(options.dataDir || "data/pins");
+  router.get("/", async (req, res) => {
+    try {
+      const pageUrl = String(req.query.pageUrl || "") || void 0;
+      const status = req.query.status ? String(req.query.status) : void 0;
+      const pins = await store.list({ pageUrl, status });
+      res.json(pins);
+    } catch (err) {
+      res.status(500).json({ error: "Failed to list pins" });
+    }
+  });
+  router.get("/:id", async (req, res) => {
+    try {
+      const id = String(req.params.id);
+      if (!validateId(id)) {
+        res.status(400).json({ error: "Invalid pin ID" });
+        return;
+      }
+      const pins = await store.list();
+      const pin = pins.find((p) => p.id === id);
+      if (!pin) {
+        res.status(404).json({ error: "Pin not found" });
+        return;
+      }
+      res.json(pin);
+    } catch (err) {
+      res.status(500).json({ error: "Failed to get pin" });
+    }
+  });
+  router.post("/", async (req, res) => {
+    try {
+      const result = PinSchema.safeParse(req.body);
+      if (!result.success) {
+        res.status(400).json({ error: "Invalid pin data", details: result.error.issues });
+        return;
+      }
+      await store.save(result.data);
+      res.status(201).json(result.data);
+    } catch (err) {
+      res.status(500).json({ error: "Failed to create pin" });
+    }
+  });
+  router.patch("/:id", async (req, res) => {
+    try {
+      const id = String(req.params.id);
+      if (!validateId(id)) {
+        res.status(400).json({ error: "Invalid pin ID" });
+        return;
+      }
+      const result = PinSchema.partial().safeParse(req.body);
+      if (!result.success) {
+        res.status(400).json({ error: "Invalid pin data", details: result.error.issues });
+        return;
+      }
+      await store.update(id, result.data);
+      res.json({ ok: true });
+    } catch (err) {
+      res.status(500).json({ error: "Failed to update pin" });
+    }
+  });
+  router.delete("/:id", async (req, res) => {
+    try {
+      const id = String(req.params.id);
+      if (!validateId(id)) {
+        res.status(400).json({ error: "Invalid pin ID" });
+        return;
+      }
+      await store.delete(id);
+      res.json({ ok: true });
+    } catch (err) {
+      res.status(500).json({ error: "Failed to delete pin" });
+    }
+  });
+  router.delete("/", async (req, res) => {
+    try {
+      const pageUrl = String(req.query.pageUrl || "") || void 0;
+      await store.clear(pageUrl);
+      res.json({ ok: true });
+    } catch (err) {
+      res.status(500).json({ error: "Failed to clear pins" });
+    }
+  });
+  return router;
+}
+
+// src/server/a2a.ts
+function registerPinpointA2A(app, options = {}) {
+  const store = new FileStore(options.dataDir || "data/pins");
+  const config = {
+    name: "pinpoint",
+    description: "Visual feedback and annotation tool for web applications",
+    skills: [
+      {
+        id: "get-annotations",
+        name: "Get Pins",
+        description: "Retrieve visual feedback annotations"
+      },
+      {
+        id: "resolve-annotation",
+        name: "Resolve Pin",
+        description: "Mark an annotation as resolved"
+      },
+      {
+        id: "create-annotation",
+        name: "Create Pin",
+        description: "Create a new annotation programmatically"
+      }
+    ],
+    handler: async (message, _context) => {
+      const { method, params } = message;
+      switch (method) {
+        case "get-annotations": {
+          const pins = await store.list(params);
+          return { result: pins };
+        }
+        case "resolve-annotation": {
+          await store.update(params.id, {
+            status: {
+              state: "resolved",
+              changedAt: (/* @__PURE__ */ new Date()).toISOString(),
+              changedBy: "agent"
+            }
+          });
+          return { result: { ok: true } };
+        }
+        case "create-annotation": {
+          const validated = PinSchema.safeParse(params?.pin);
+          if (!validated.success) {
+            return { error: { code: -32602, message: "Invalid pin data" } };
+          }
+          await store.save(validated.data);
+          return { result: { ok: true } };
+        }
+        default:
+          return { error: { code: -32601, message: "Method not found" } };
+      }
+    }
+  };
+  try {
+    const { enableA2A } = __require("@agent-native/core/a2a");
+    enableA2A(app, config);
+  } catch {
+    app.get("/.well-known/agent-card.json", (_req, res) => {
+      res.json({
+        name: config.name,
+        description: config.description,
+        skills: config.skills,
+        url: "/a2a/pinpoint"
+      });
+    });
+    app.post("/a2a/pinpoint", async (req, res) => {
+      try {
+        const result = await config.handler(req.body, {});
+        res.json(result);
+      } catch (err) {
+        res.status(500).json({ error: "A2A handler error" });
+      }
+    });
+  }
+}
+
+// src/server/mcp.ts
+function createPinpointMCPTools(options = {}) {
+  const store = new FileStore(options.dataDir || "data/pins");
+  return {
+    tools: [
+      {
+        name: "get_annotations",
+        description: "Get visual feedback annotations from the page",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pageUrl: {
+              type: "string",
+              description: "Filter by page URL"
+            },
+            status: {
+              type: "string",
+              enum: ["open", "acknowledged", "resolved", "dismissed"],
+              description: "Filter by status"
+            }
+          }
+        }
+      },
+      {
+        name: "resolve_annotation",
+        description: "Mark an annotation as resolved",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              description: "The annotation ID to resolve"
+            },
+            message: {
+              type: "string",
+              description: "Optional resolution message"
+            }
+          },
+          required: ["id"]
+        }
+      },
+      {
+        name: "create_annotation",
+        description: "Create a new annotation on a page element",
+        inputSchema: {
+          type: "object",
+          properties: {
+            pageUrl: {
+              type: "string",
+              description: "The page URL"
+            },
+            selector: {
+              type: "string",
+              description: "CSS selector of the element"
+            },
+            comment: {
+              type: "string",
+              description: "The annotation comment"
+            }
+          },
+          required: ["pageUrl", "selector", "comment"]
+        }
+      },
+      {
+        name: "delete_annotation",
+        description: "Delete an annotation",
+        inputSchema: {
+          type: "object",
+          properties: {
+            id: {
+              type: "string",
+              description: "The annotation ID to delete"
+            }
+          },
+          required: ["id"]
+        }
+      }
+    ],
+    async handleTool(name, args) {
+      switch (name) {
+        case "get_annotations": {
+          const pins = await store.list({
+            pageUrl: args.pageUrl,
+            status: args.status
+          });
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(pins, null, 2)
+              }
+            ]
+          };
+        }
+        case "resolve_annotation": {
+          await store.update(args.id, {
+            status: {
+              state: "resolved",
+              changedAt: (/* @__PURE__ */ new Date()).toISOString(),
+              changedBy: "agent"
+            }
+          });
+          return {
+            content: [{ type: "text", text: `Resolved annotation ${args.id}` }]
+          };
+        }
+        case "create_annotation": {
+          const { randomUUID: randomUUID2 } = await import("crypto");
+          const now = (/* @__PURE__ */ new Date()).toISOString();
+          const pin = {
+            id: randomUUID2(),
+            pageUrl: args.pageUrl,
+            createdAt: now,
+            updatedAt: now,
+            comment: args.comment,
+            element: {
+              tagName: "unknown",
+              classNames: [],
+              selector: args.selector,
+              boundingRect: { x: 0, y: 0, width: 0, height: 0 }
+            },
+            status: {
+              state: "open",
+              changedAt: now,
+              changedBy: "agent"
+            }
+          };
+          await store.save(pin);
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Created annotation ${pin.id} on ${args.selector}`
+              }
+            ]
+          };
+        }
+        case "delete_annotation": {
+          await store.delete(args.id);
+          return {
+            content: [{ type: "text", text: `Deleted annotation ${args.id}` }]
+          };
+        }
+        default:
+          return {
+            content: [{ type: "text", text: `Unknown tool: ${name}` }]
+          };
+      }
+    }
+  };
+}
+export {
+  FileStore,
+  createPinpointMCPTools,
+  pagePinRoutes,
+  registerPinpointA2A
+};
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/middleware.ts","../../src/storage/file-store.ts","../../src/server/a2a.ts","../../src/server/mcp.ts"],"sourcesContent":["// @agent-native/pinpoint — Express middleware for pin CRUD\r\n// MIT License\r\n//\r\n// REST routes: GET (list), GET/:id, POST, PATCH/:id, DELETE/:id\r\n// Path traversal validation on all IDs.\r\n\r\nimport { Router, type Request, type Response } from \"express\";\r\n\r\nimport { FileStore } from \"../storage/file-store.js\";\r\nimport { PinSchema } from \"../storage/schemas.js\";\r\n\r\nconst VALID_ID = /^[a-zA-Z0-9_-]+$/;\r\n\r\nfunction validateId(id: string): boolean {\r\n  return VALID_ID.test(id) && id.length > 0 && id.length <= 128;\r\n}\r\n\r\nexport interface PinRoutesOptions {\r\n  /** Directory for pin data files. Default: data/pins */\r\n  dataDir?: string;\r\n}\r\n\r\n/**\r\n * Create Express router with pin CRUD endpoints.\r\n *\r\n * Usage:\r\n * ```ts\r\n * import { pagePinRoutes } from '@agent-native/pinpoint/server';\r\n * app.use('/api/pins', pagePinRoutes());\r\n * ```\r\n */\r\nexport function pagePinRoutes(options: PinRoutesOptions = {}): Router {\r\n  const router = Router();\r\n  const store = new FileStore(options.dataDir || \"data/pins\");\r\n\r\n  // GET / — List all pins, optionally filtered\r\n  router.get(\"/\", async (req: Request, res: Response) => {\r\n    try {\r\n      const pageUrl = String(req.query.pageUrl || \"\") || undefined;\r\n      const status = req.query.status\r\n        ? (String(req.query.status) as any)\r\n        : undefined;\r\n      const pins = await store.list({ pageUrl, status });\r\n      res.json(pins);\r\n    } catch (err) {\r\n      res.status(500).json({ error: \"Failed to list pins\" });\r\n    }\r\n  });\r\n\r\n  // GET /:id — Get a single pin\r\n  router.get(\"/:id\", async (req: Request, res: Response) => {\r\n    try {\r\n      const id = String(req.params.id);\r\n      if (!validateId(id)) {\r\n        res.status(400).json({ error: \"Invalid pin ID\" });\r\n        return;\r\n      }\r\n      const pins = await store.list();\r\n      const pin = pins.find((p) => p.id === id);\r\n      if (!pin) {\r\n        res.status(404).json({ error: \"Pin not found\" });\r\n        return;\r\n      }\r\n      res.json(pin);\r\n    } catch (err) {\r\n      res.status(500).json({ error: \"Failed to get pin\" });\r\n    }\r\n  });\r\n\r\n  // POST / — Create a new pin\r\n  router.post(\"/\", async (req: Request, res: Response) => {\r\n    try {\r\n      const result = PinSchema.safeParse(req.body);\r\n      if (!result.success) {\r\n        res\r\n          .status(400)\r\n          .json({ error: \"Invalid pin data\", details: result.error.issues });\r\n        return;\r\n      }\r\n      await store.save(result.data as any);\r\n      res.status(201).json(result.data);\r\n    } catch (err) {\r\n      res.status(500).json({ error: \"Failed to create pin\" });\r\n    }\r\n  });\r\n\r\n  // PATCH /:id — Update a pin\r\n  router.patch(\"/:id\", async (req: Request, res: Response) => {\r\n    try {\r\n      const id = String(req.params.id);\r\n      if (!validateId(id)) {\r\n        res.status(400).json({ error: \"Invalid pin ID\" });\r\n        return;\r\n      }\r\n      const result = PinSchema.partial().safeParse(req.body);\r\n      if (!result.success) {\r\n        res\r\n          .status(400)\r\n          .json({ error: \"Invalid pin data\", details: result.error.issues });\r\n        return;\r\n      }\r\n      await store.update(id, result.data);\r\n      res.json({ ok: true });\r\n    } catch (err) {\r\n      res.status(500).json({ error: \"Failed to update pin\" });\r\n    }\r\n  });\r\n\r\n  // DELETE /:id — Delete a pin\r\n  router.delete(\"/:id\", async (req: Request, res: Response) => {\r\n    try {\r\n      const id = String(req.params.id);\r\n      if (!validateId(id)) {\r\n        res.status(400).json({ error: \"Invalid pin ID\" });\r\n        return;\r\n      }\r\n      await store.delete(id);\r\n      res.json({ ok: true });\r\n    } catch (err) {\r\n      res.status(500).json({ error: \"Failed to delete pin\" });\r\n    }\r\n  });\r\n\r\n  // DELETE / — Clear pins (optionally by pageUrl)\r\n  router.delete(\"/\", async (req: Request, res: Response) => {\r\n    try {\r\n      const pageUrl = String(req.query.pageUrl || \"\") || undefined;\r\n      await store.clear(pageUrl);\r\n      res.json({ ok: true });\r\n    } catch (err) {\r\n      res.status(500).json({ error: \"Failed to clear pins\" });\r\n    }\r\n  });\r\n\r\n  return router;\r\n}\r\n","// @agent-native/pinpoint — Server-side file storage adapter\r\n// MIT License\r\n//\r\n// Writes to data/pins/{uuid}.json — one file per annotation.\r\n// Atomic writes (temp + rename). Path traversal validation on all IDs.\r\n\r\nimport { randomUUID } from \"crypto\";\r\nimport {\r\n  readdir,\r\n  readFile,\r\n  writeFile,\r\n  unlink,\r\n  rename,\r\n  mkdir,\r\n} from \"fs/promises\";\r\nimport { tmpdir } from \"os\";\r\nimport { join, resolve } from \"path\";\r\n\r\nimport type { Pin, PinStatus, PinStorage } from \"../types/index.js\";\r\nimport { PinSchema } from \"./schemas.js\";\r\n\r\nconst VALID_ID = /^[a-zA-Z0-9_-]+$/;\r\n\r\nexport class FileStore implements PinStorage {\r\n  private dir: string;\r\n\r\n  constructor(dataDir: string = \"data/pins\") {\r\n    this.dir = resolve(dataDir);\r\n  }\r\n\r\n  private validateId(id: string): void {\r\n    if (!VALID_ID.test(id)) {\r\n      throw new Error(`Invalid pin ID: ${id}`);\r\n    }\r\n  }\r\n\r\n  private pinPath(id: string): string {\r\n    this.validateId(id);\r\n    const resolved = join(this.dir, `${id}.json`);\r\n    // Ensure resolved path is within the data directory\r\n    if (!resolved.startsWith(this.dir)) {\r\n      throw new Error(\"Path traversal detected\");\r\n    }\r\n    return resolved;\r\n  }\r\n\r\n  private async ensureDir(): Promise<void> {\r\n    await mkdir(this.dir, { recursive: true });\r\n  }\r\n\r\n  private async readPin(filePath: string): Promise<Pin | null> {\r\n    try {\r\n      const content = await readFile(filePath, \"utf-8\");\r\n      const parsed = JSON.parse(content);\r\n      const result = PinSchema.safeParse(parsed);\r\n      return result.success ? (result.data as Pin) : null;\r\n    } catch {\r\n      return null;\r\n    }\r\n  }\r\n\r\n  private async atomicWrite(filePath: string, data: string): Promise<void> {\r\n    await this.ensureDir();\r\n    const tempPath = join(tmpdir(), `pinpoint-${randomUUID()}.tmp`);\r\n    await writeFile(tempPath, data, \"utf-8\");\r\n    await rename(tempPath, filePath);\r\n  }\r\n\r\n  async load(pageUrl: string): Promise<Pin[]> {\r\n    return this.list({ pageUrl });\r\n  }\r\n\r\n  async save(pin: Pin): Promise<void> {\r\n    const filePath = this.pinPath(pin.id);\r\n    await this.atomicWrite(filePath, JSON.stringify(pin, null, 2));\r\n  }\r\n\r\n  async update(id: string, patch: Partial<Pin>): Promise<void> {\r\n    const filePath = this.pinPath(id);\r\n    const existing = await this.readPin(filePath);\r\n    if (!existing) return;\r\n    const updated: Pin = {\r\n      ...existing,\r\n      ...patch,\r\n      id: existing.id,\r\n      updatedAt: new Date().toISOString(),\r\n    };\r\n    await this.atomicWrite(filePath, JSON.stringify(updated, null, 2));\r\n  }\r\n\r\n  async delete(id: string): Promise<void> {\r\n    try {\r\n      await unlink(this.pinPath(id));\r\n    } catch {\r\n      // File already deleted or doesn't exist\r\n    }\r\n  }\r\n\r\n  async list(filter?: {\r\n    pageUrl?: string;\r\n    status?: PinStatus;\r\n  }): Promise<Pin[]> {\r\n    await this.ensureDir();\r\n    let files: string[];\r\n    try {\r\n      files = await readdir(this.dir);\r\n    } catch {\r\n      return [];\r\n    }\r\n\r\n    const pins: Pin[] = [];\r\n    for (const file of files) {\r\n      if (!file.endsWith(\".json\")) continue;\r\n      const pin = await this.readPin(join(this.dir, file));\r\n      if (!pin) continue;\r\n      if (filter?.pageUrl && pin.pageUrl !== filter.pageUrl) continue;\r\n      if (filter?.status && pin.status.state !== filter.status) continue;\r\n      pins.push(pin);\r\n    }\r\n\r\n    return pins.sort(\r\n      (a, b) =>\r\n        new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime(),\r\n    );\r\n  }\r\n\r\n  async clear(pageUrl?: string): Promise<void> {\r\n    await this.ensureDir();\r\n    let files: string[];\r\n    try {\r\n      files = await readdir(this.dir);\r\n    } catch {\r\n      return;\r\n    }\r\n\r\n    for (const file of files) {\r\n      if (!file.endsWith(\".json\")) continue;\r\n      const filePath = join(this.dir, file);\r\n      if (pageUrl) {\r\n        const pin = await this.readPin(filePath);\r\n        if (pin && pin.pageUrl === pageUrl) {\r\n          await unlink(filePath).catch(() => {});\r\n        }\r\n      } else {\r\n        await unlink(filePath).catch(() => {});\r\n      }\r\n    }\r\n  }\r\n}\r\n","// @agent-native/pinpoint — A2A agent registration\r\n// MIT License\r\n//\r\n// Exposes annotations via the Agent-to-Agent (A2A) protocol.\r\n\r\nimport type { Application } from \"express\";\r\n\r\nimport { FileStore } from \"../storage/file-store.js\";\r\nimport { PinSchema } from \"../storage/schemas.js\";\r\n\r\ninterface A2ASkill {\r\n  id: string;\r\n  name: string;\r\n  description: string;\r\n}\r\n\r\ninterface A2AConfig {\r\n  name: string;\r\n  description: string;\r\n  skills: A2ASkill[];\r\n  handler: (message: any, context: any) => Promise<any>;\r\n}\r\n\r\n/**\r\n * Register Pinpoint as an A2A agent.\r\n * Call this after creating your express app.\r\n *\r\n * ```ts\r\n * import { registerPinpointA2A } from '@agent-native/pinpoint/server';\r\n * registerPinpointA2A(app);\r\n * ```\r\n */\r\nexport function registerPinpointA2A(\r\n  app: Application,\r\n  options: { dataDir?: string } = {},\r\n): void {\r\n  const store = new FileStore(options.dataDir || \"data/pins\");\r\n\r\n  const config: A2AConfig = {\r\n    name: \"pinpoint\",\r\n    description: \"Visual feedback and annotation tool for web applications\",\r\n    skills: [\r\n      {\r\n        id: \"get-annotations\",\r\n        name: \"Get Pins\",\r\n        description: \"Retrieve visual feedback annotations\",\r\n      },\r\n      {\r\n        id: \"resolve-annotation\",\r\n        name: \"Resolve Pin\",\r\n        description: \"Mark an annotation as resolved\",\r\n      },\r\n      {\r\n        id: \"create-annotation\",\r\n        name: \"Create Pin\",\r\n        description: \"Create a new annotation programmatically\",\r\n      },\r\n    ],\r\n    handler: async (message, _context) => {\r\n      const { method, params } = message;\r\n\r\n      switch (method) {\r\n        case \"get-annotations\": {\r\n          const pins = await store.list(params);\r\n          return { result: pins };\r\n        }\r\n        case \"resolve-annotation\": {\r\n          await store.update(params.id, {\r\n            status: {\r\n              state: \"resolved\",\r\n              changedAt: new Date().toISOString(),\r\n              changedBy: \"agent\",\r\n            },\r\n          });\r\n          return { result: { ok: true } };\r\n        }\r\n        case \"create-annotation\": {\r\n          const validated = PinSchema.safeParse(params?.pin);\r\n          if (!validated.success) {\r\n            return { error: { code: -32602, message: \"Invalid pin data\" } };\r\n          }\r\n          await store.save(validated.data as any);\r\n          return { result: { ok: true } };\r\n        }\r\n        default:\r\n          return { error: { code: -32601, message: \"Method not found\" } };\r\n      }\r\n    },\r\n  };\r\n\r\n  // Try to use @agent-native/core's enableA2A\r\n  try {\r\n    const { enableA2A } = require(\"@agent-native/core/a2a\");\r\n    enableA2A(app, config);\r\n  } catch {\r\n    // If enableA2A is not available, set up basic A2A endpoints manually\r\n    app.get(\"/.well-known/agent-card.json\", (_req, res) => {\r\n      res.json({\r\n        name: config.name,\r\n        description: config.description,\r\n        skills: config.skills,\r\n        url: \"/a2a/pinpoint\",\r\n      });\r\n    });\r\n\r\n    app.post(\"/a2a/pinpoint\", async (req, res) => {\r\n      try {\r\n        const result = await config.handler(req.body, {});\r\n        res.json(result);\r\n      } catch (err) {\r\n        res.status(500).json({ error: \"A2A handler error\" });\r\n      }\r\n    });\r\n  }\r\n}\r\n","// @agent-native/pinpoint — MCP server for pin tools\r\n// MIT License\r\n\r\nimport { FileStore } from \"../storage/file-store.js\";\r\n\r\n/**\r\n * Create MCP tool handlers for Pinpoint.\r\n * These can be registered with an MCP server instance.\r\n *\r\n * ```ts\r\n * import { Server } from '@modelcontextprotocol/sdk/server/index.js';\r\n * import { createPinpointMCPTools } from '@agent-native/pinpoint/server';\r\n *\r\n * const server = new Server({ name: 'pinpoint', version: '1.0.0' }, { capabilities: { tools: {} } });\r\n * const tools = createPinpointMCPTools();\r\n * // Register tools with server...\r\n * ```\r\n */\r\nexport function createPinpointMCPTools(options: { dataDir?: string } = {}) {\r\n  const store = new FileStore(options.dataDir || \"data/pins\");\r\n\r\n  return {\r\n    tools: [\r\n      {\r\n        name: \"get_annotations\",\r\n        description: \"Get visual feedback annotations from the page\",\r\n        inputSchema: {\r\n          type: \"object\" as const,\r\n          properties: {\r\n            pageUrl: {\r\n              type: \"string\",\r\n              description: \"Filter by page URL\",\r\n            },\r\n            status: {\r\n              type: \"string\",\r\n              enum: [\"open\", \"acknowledged\", \"resolved\", \"dismissed\"],\r\n              description: \"Filter by status\",\r\n            },\r\n          },\r\n        },\r\n      },\r\n      {\r\n        name: \"resolve_annotation\",\r\n        description: \"Mark an annotation as resolved\",\r\n        inputSchema: {\r\n          type: \"object\" as const,\r\n          properties: {\r\n            id: {\r\n              type: \"string\",\r\n              description: \"The annotation ID to resolve\",\r\n            },\r\n            message: {\r\n              type: \"string\",\r\n              description: \"Optional resolution message\",\r\n            },\r\n          },\r\n          required: [\"id\"],\r\n        },\r\n      },\r\n      {\r\n        name: \"create_annotation\",\r\n        description: \"Create a new annotation on a page element\",\r\n        inputSchema: {\r\n          type: \"object\" as const,\r\n          properties: {\r\n            pageUrl: {\r\n              type: \"string\",\r\n              description: \"The page URL\",\r\n            },\r\n            selector: {\r\n              type: \"string\",\r\n              description: \"CSS selector of the element\",\r\n            },\r\n            comment: {\r\n              type: \"string\",\r\n              description: \"The annotation comment\",\r\n            },\r\n          },\r\n          required: [\"pageUrl\", \"selector\", \"comment\"],\r\n        },\r\n      },\r\n      {\r\n        name: \"delete_annotation\",\r\n        description: \"Delete an annotation\",\r\n        inputSchema: {\r\n          type: \"object\" as const,\r\n          properties: {\r\n            id: {\r\n              type: \"string\",\r\n              description: \"The annotation ID to delete\",\r\n            },\r\n          },\r\n          required: [\"id\"],\r\n        },\r\n      },\r\n    ],\r\n\r\n    async handleTool(\r\n      name: string,\r\n      args: Record<string, any>,\r\n    ): Promise<{ content: Array<{ type: string; text: string }> }> {\r\n      switch (name) {\r\n        case \"get_annotations\": {\r\n          const pins = await store.list({\r\n            pageUrl: args.pageUrl,\r\n            status: args.status,\r\n          });\r\n          return {\r\n            content: [\r\n              {\r\n                type: \"text\",\r\n                text: JSON.stringify(pins, null, 2),\r\n              },\r\n            ],\r\n          };\r\n        }\r\n\r\n        case \"resolve_annotation\": {\r\n          await store.update(args.id, {\r\n            status: {\r\n              state: \"resolved\",\r\n              changedAt: new Date().toISOString(),\r\n              changedBy: \"agent\",\r\n            },\r\n          });\r\n          return {\r\n            content: [{ type: \"text\", text: `Resolved annotation ${args.id}` }],\r\n          };\r\n        }\r\n\r\n        case \"create_annotation\": {\r\n          const { randomUUID } = await import(\"crypto\");\r\n          const now = new Date().toISOString();\r\n          const pin = {\r\n            id: randomUUID(),\r\n            pageUrl: args.pageUrl,\r\n            createdAt: now,\r\n            updatedAt: now,\r\n            comment: args.comment,\r\n            element: {\r\n              tagName: \"unknown\",\r\n              classNames: [],\r\n              selector: args.selector,\r\n              boundingRect: { x: 0, y: 0, width: 0, height: 0 },\r\n            },\r\n            status: {\r\n              state: \"open\" as const,\r\n              changedAt: now,\r\n              changedBy: \"agent\",\r\n            },\r\n          };\r\n          await store.save(pin as any);\r\n          return {\r\n            content: [\r\n              {\r\n                type: \"text\",\r\n                text: `Created annotation ${pin.id} on ${args.selector}`,\r\n              },\r\n            ],\r\n          };\r\n        }\r\n\r\n        case \"delete_annotation\": {\r\n          await store.delete(args.id);\r\n          return {\r\n            content: [{ type: \"text\", text: `Deleted annotation ${args.id}` }],\r\n          };\r\n        }\r\n\r\n        default:\r\n          return {\r\n            content: [{ type: \"text\", text: `Unknown tool: ${name}` }],\r\n          };\r\n      }\r\n    },\r\n  };\r\n}\r\n"],"mappings":"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","names":["VALID_ID","randomUUID"]}

package/dist/types/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@jami-studio/pinpoint",
+  "version": "0.1.12",
+  "description": "Visual feedback and annotation tool for agent-native web applications",
+  "homepage": "https://github.com/studio-jami/jami-studio#readme",
+  "bugs": {
+    "url": "https://github.com/studio-jami/jami-studio/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/studio-jami/jami-studio",
+    "directory": "packages/pinpoint"
+  },
+  "bin": {
+    "pinpoint": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src/scripts",
+    ".agents"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.browser.js",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./primitives": {
+      "types": "./dist/primitives/index.d.ts",
+      "import": "./dist/primitives/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest --run --passWithNoTests"
+  },
+  "dependencies": {
+    "@medv/finder": "^4.0.2",
+    "bippy": "^0.5.32",
+    "element-source": "^0.0.3",
+    "solid-js": "^1.9.10",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@agent-native/core": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@types/express": "^5.0.3",
+    "@types/node": "^24.2.1",
+    "@types/react": "^19.2.14",
+    "babel-preset-solid": "^1.9.10",
+    "esbuild-plugin-solid": "^0.6.0",
+    "express": "^5.1.0",
+    "tsup": "^8.4.0",
+    "typescript": "catalog:",
+    "typescript-7": "catalog:",
+    "vite-plugin-solid": "^2.11.0",
+    "vitest": "^4.1.5"
+  },
+  "peerDependencies": {
+    "@agent-native/core": ">=0.8.0",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  }
+}

package/src/scripts/create-pin.ts

@@ -0,0 +1,43 @@
+// @agent-native/pinpoint — Create annotation script
+// MIT License
+
+import { randomUUID } from "crypto";
+
+import { parseArgs, fail } from "@agent-native/core/scripts";
+
+import { FileStore } from "../storage/file-store.js";
+import type { Pin } from "../types/index.js";
+
+export default async function (args: string[]) {
+  const { pageUrl, selector, comment, author } = parseArgs(args) as {
+    pageUrl?: string;
+    selector?: string;
+    comment?: string;
+    author?: string;
+  };
+
+  if (!pageUrl) fail("--pageUrl is required");
+  if (!selector) fail("--selector is required");
+  if (!comment) fail("--comment is required");
+
+  const now = new Date().toISOString();
+  const pin: Pin = {
+    id: randomUUID(),
+    pageUrl: pageUrl!,
+    createdAt: now,
+    updatedAt: now,
+    author,
+    comment: comment!,
+    element: {
+      tagName: "unknown",
+      classNames: [],
+      selector: selector!,
+      boundingRect: { x: 0, y: 0, width: 0, height: 0 },
+    },
+    status: { state: "open", changedAt: now, changedBy: "agent" },
+  };
+
+  const store = new FileStore();
+  await store.save(pin);
+  console.log(`Created annotation ${pin.id} on ${pageUrl} → ${selector}`);
+}

package/src/scripts/delete-pin.ts

@@ -0,0 +1,16 @@
+// @agent-native/pinpoint — Delete annotation script
+// MIT License
+
+import { parseArgs, fail } from "@agent-native/core/scripts";
+
+import { FileStore } from "../storage/file-store.js";
+
+export default async function (args: string[]) {
+  const { id } = parseArgs(args) as { id?: string };
+
+  if (!id) fail("--id is required");
+
+  const store = new FileStore();
+  await store.delete(id!);
+  console.log(`Deleted annotation ${id}`);
+}