unbrowse 3.1.0-experiments.186be38 → 3.1.0-experiments.4499af2

package/dist/cli.js

@@ -31,7 +31,7 @@ var __promiseAll = (args) => Promise.all(args);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../../src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "3.1.0-experiments.186be38", BUILD_GIT_SHA = "186be383bb59", BUILD_CODE_HASH = "1488fc1d92b7", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4xLjAtZXhwZXJpbWVudHMuMTg2YmUzOCIsImdpdF9zaGEiOiIxODZiZTM4M2JiNTkiLCJjb2RlX2hhc2giOiIxNDg4ZmMxZDkyYjciLCJ0cmFjZV92ZXJzaW9uIjoiMTQ4OGZjMWQ5MmI3QDE4NmJlMzgzYmI1OSIsImlzc3VlZF9hdCI6IjIwMjYtMDQtMDZUMDM6MzQ6MDUuMDkwWiJ9", BUILD_RELEASE_MANIFEST_SIGNATURE = "YZKX-KcH1QZ29BvWApkOsllb4sm0Uv-743YX97ml6HM", BUILD_DEFAULT_BACKEND_URL = "https://unbrowse-backend-experiments.lewis-6d8.workers.dev";
+var BUILD_RELEASE_VERSION = "3.1.0-experiments.4499af2", BUILD_GIT_SHA = "4499af2aaeef", BUILD_CODE_HASH = "1488fc1d92b7", BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4xLjAtZXhwZXJpbWVudHMuNDQ5OWFmMiIsImdpdF9zaGEiOiI0NDk5YWYyYWFlZWYiLCJjb2RlX2hhc2giOiIxNDg4ZmMxZDkyYjciLCJ0cmFjZV92ZXJzaW9uIjoiMTQ4OGZjMWQ5MmI3QDQ0OTlhZjJhYWVlZiIsImlzc3VlZF9hdCI6IjIwMjYtMDQtMDZUMDY6MTU6NTguMzQxWiJ9", BUILD_RELEASE_MANIFEST_SIGNATURE = "7ubu-WX8UeKTtx8vc4T3z2S1BklaHIdGNvftIPQ8jJ0", BUILD_DEFAULT_BACKEND_URL = "https://unbrowse-backend-experiments.lewis-6d8.workers.dev";
 
 // ../../src/version.ts
 import { createHash } from "crypto";
@@ -796,6 +796,14 @@ var init_bundle_scanner = __esm(() => {
   init_logger();
 });
 
+// ../../src/reverse-engineer/token-sources.ts
+var init_token_sources = () => {};
+
+// ../../src/execution/token-resolver.ts
+var init_token_resolver = __esm(() => {
+  init_token_sources();
+});
+
 // ../../src/vault/index.ts
 import { join as join7 } from "path";
 import { homedir as homedir5 } from "os";
@@ -1014,6 +1022,7 @@ var init_execution = __esm(async () => {
   init_capture();
   init_reverse_engineer();
   init_bundle_scanner();
+  init_token_resolver();
   init_marketplace();
   init_runtime();
   init_transform();
@@ -3731,6 +3740,25 @@ async function cmdFeedback(flags) {
     body.diagnostics = JSON.parse(flags.diagnostics);
   output(await api2("POST", "/v1/feedback", body), !!flags.pretty);
 }
+async function cmdAnnotate(flags) {
+  const skillId = flags.skill;
+  const endpointId = flags.endpoint;
+  if (!skillId || !endpointId)
+    die("--skill and --endpoint are required");
+  const body = {};
+  if (flags.text) {
+    body.annotations = [{ text: flags.text }];
+  }
+  if (flags.constraint) {
+    const parts = flags.constraint.split(":");
+    if (parts.length >= 3) {
+      body.constraints = [{ param: parts[0], rule: parts[1], message: parts.slice(2).join(":") }];
+    }
+  }
+  if (!body.annotations && !body.constraints)
+    die("--text or --constraint required");
+  output(await api2("POST", `/v1/skills/${skillId}/endpoints/${endpointId}/annotate`, body), !!flags.pretty);
+}
 async function cmdReview(flags) {
   const skillId = flags.skill;
   if (!skillId)
@@ -3945,6 +3973,7 @@ var CLI_REFERENCE = {
     { name: "resolve", usage: '--intent "..." [--domain "..."] [--url "..."] [opts]', desc: "Search cached indexed/published routes and optionally execute the top trusted endpoint" },
     { name: "execute", usage: "--skill ID --endpoint ID [opts]", desc: "Execute a specific endpoint" },
     { name: "feedback", usage: "--skill ID --endpoint ID --rating N", desc: "Submit feedback (mandatory after resolve)" },
+    { name: "annotate", usage: "--skill ID --endpoint ID --text 'tip' [--constraint 'param:rule:message']", desc: "Contribute best practices or constraints for an endpoint" },
     { name: "review", usage: "--skill ID --endpoints '[...]'", desc: "Push reviewed descriptions/schema metadata back to a captured skill before publish" },
     { name: "index", usage: "--skill ID", desc: "Recompute local graph/contracts/export from cached skill state only" },
     { name: "publish", usage: "--skill ID [--confirm-publish] [--endpoints '[...]']", desc: "Re-index locally, inspect publish-review metadata, then publish/share from cached skill state" },
@@ -4571,6 +4600,7 @@ async function main() {
     "exec",
     "feedback",
     "fb",
+    "annotate",
     "review",
     "index",
     "publish",
@@ -4642,6 +4672,8 @@ async function main() {
     case "feedback":
     case "fb":
       return cmdFeedback(flags);
+    case "annotate":
+      return cmdAnnotate(flags);
     case "review":
       return cmdReview(flags);
     case "index":

package/dist/mcp.js

@@ -225,11 +225,11 @@ import { dirname, join, parse } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // ../../src/build-info.generated.ts
-var BUILD_RELEASE_VERSION = "3.1.0-experiments.186be38";
-var BUILD_GIT_SHA = "186be383bb59";
+var BUILD_RELEASE_VERSION = "3.1.0-experiments.4499af2";
+var BUILD_GIT_SHA = "4499af2aaeef";
 var BUILD_CODE_HASH = "1488fc1d92b7";
-var BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4xLjAtZXhwZXJpbWVudHMuMTg2YmUzOCIsImdpdF9zaGEiOiIxODZiZTM4M2JiNTkiLCJjb2RlX2hhc2giOiIxNDg4ZmMxZDkyYjciLCJ0cmFjZV92ZXJzaW9uIjoiMTQ4OGZjMWQ5MmI3QDE4NmJlMzgzYmI1OSIsImlzc3VlZF9hdCI6IjIwMjYtMDQtMDZUMDM6MzQ6MDUuMDkwWiJ9";
-var BUILD_RELEASE_MANIFEST_SIGNATURE = "YZKX-KcH1QZ29BvWApkOsllb4sm0Uv-743YX97ml6HM";
+var BUILD_RELEASE_MANIFEST_BASE64 = "eyJzY2hlbWFfdmVyc2lvbiI6MSwicmVsZWFzZV92ZXJzaW9uIjoiMy4xLjAtZXhwZXJpbWVudHMuNDQ5OWFmMiIsImdpdF9zaGEiOiI0NDk5YWYyYWFlZWYiLCJjb2RlX2hhc2giOiIxNDg4ZmMxZDkyYjciLCJ0cmFjZV92ZXJzaW9uIjoiMTQ4OGZjMWQ5MmI3QDQ0OTlhZjJhYWVlZiIsImlzc3VlZF9hdCI6IjIwMjYtMDQtMDZUMDY6MTU6NTguMzQxWiJ9";
+var BUILD_RELEASE_MANIFEST_SIGNATURE = "7ubu-WX8UeKTtx8vc4T3z2S1BklaHIdGNvftIPQ8jJ0";
 var BUILD_DEFAULT_BACKEND_URL = "https://unbrowse-backend-experiments.lewis-6d8.workers.dev";
 
 // ../../src/version.ts
@@ -1410,12 +1410,23 @@ function addExecuteNextStepHints(result, args) {
     hints.feedback_skill = skillId;
   if (endpointId)
     hints.feedback_endpoint = endpointId;
+  const constraints = isPlainObject(nested) && Array.isArray(nested.constraints) ? nested.constraints : undefined;
+  if (constraints?.length) {
+    hints.known_constraints = constraints;
+  }
+  const annotations = isPlainObject(nested) && Array.isArray(nested.annotations) ? nested.annotations : undefined;
+  if (annotations?.length) {
+    hints.community_notes = annotations;
+  }
   const desc = isPlainObject(nested) && typeof nested.description === "string" ? nested.description : "";
   const looksGeneric = !desc || desc.startsWith("Captured ") || desc.startsWith("Returns results");
   if (looksGeneric) {
     hints.first_use_review_needed = true;
     hints.review_step = "After feedback, call unbrowse_review to write proper endpoint descriptions, then unbrowse_publish to share to marketplace.";
   }
+  if (skillId && endpointId) {
+    hints.contribute = "If you learned something about this endpoint (required params, gotchas, best practices), call unbrowse_annotate to share it with other agents.";
+  }
   return { ...result, _workflow_hints: hints };
 }
 function addCaptureNextStepHints(result, _args) {
@@ -2452,6 +2463,42 @@ var tools = [
       const withHints = addCaptureNextStepHints(result, args);
       return successResult(withHints, "Browse session closed. See _workflow_hints for required next steps: call unbrowse_review then unbrowse_publish.");
     }
+  },
+  {
+    name: "unbrowse_annotate",
+    description: "Contribute constraints or best practices for an endpoint. Call this after executing an endpoint to share what you learned (required params, gotchas, tips) with other agents.",
+    parameters: {
+      type: "object",
+      properties: {
+        skill: { type: "string", description: "Skill ID" },
+        endpoint: { type: "string", description: "Endpoint ID" },
+        constraints: {
+          type: "array",
+          description: "Learned constraints (required params, deprecated fields, format rules)",
+          items: { type: "object", properties: { param: { type: "string" }, rule: { type: "string" }, message: { type: "string" } }, required: ["param", "rule", "message"] }
+        },
+        annotations: {
+          type: "array",
+          description: "Free-text best practices, tips, or gotchas",
+          items: { type: "object", properties: { text: { type: "string" } }, required: ["text"] }
+        }
+      },
+      required: ["skill", "endpoint"]
+    },
+    handler: async (args) => {
+      await ensureServerReady();
+      const skillId = args.skill;
+      const endpointId = args.endpoint;
+      const body = {};
+      if (Array.isArray(args.constraints))
+        body.constraints = args.constraints;
+      if (Array.isArray(args.annotations))
+        body.annotations = args.annotations;
+      if (!body.constraints && !body.annotations)
+        return errorResult("Provide constraints and/or annotations");
+      const result = await api2("POST", `/v1/skills/${skillId}/endpoints/${endpointId}/annotate`, body);
+      return successResult(result, "Annotation saved. Other agents will see your contribution when using this endpoint.");
+    }
   }
 ];
 var toolMap = new Map(tools.map((tool) => [tool.name, tool]));