@forgeintel/sdk 0.5.0-beta.0 → 0.5.0-beta.1

package/dist/context.d.ts

@@ -1,5 +1,5 @@
 /** Suggested agent names; anything else is kept as given. */
-export declare const AGENT_TYPES: readonly ["Claude Code", "Codex", "Cursor", "Grok", "Hermes", "Instinct", "OpenClaw", "Other", "Unknown"];
+export declare const AGENT_TYPES: readonly ["Claude Code", "Codex", "Cursor", "Grok Bot", "Muse", "Hermes", "Instinct", "OpenClaw", "Others"];
 /** Suggested x402 clients; anything else is kept as given. */
 export declare const CLIENTS: readonly ["agentcash", "awal", "pay.sh", "other", "unknown"];
 /** JSON body field (POST, PUT, …). */
@@ -45,7 +45,7 @@ export declare function agentContextSchema({ searchQuery }?: {
         } | undefined;
         agent_type: {
             type: string;
-            enum: ("Claude Code" | "Codex" | "Cursor" | "Grok" | "Hermes" | "Instinct" | "OpenClaw" | "Other" | "Unknown")[];
+            enum: ("Claude Code" | "Codex" | "Cursor" | "Grok Bot" | "Muse" | "Hermes" | "Instinct" | "OpenClaw" | "Others")[];
             description: string;
         };
         agent_type_other: {
@@ -66,4 +66,4 @@ export declare function agentContextParameters({ searchQuery }?: {
 /** One line for the forge-feedback extension, so clients that only inspect the 402 learn about it too. */
 export declare function agentContextAsk({ searchQuery }?: {
     searchQuery?: boolean;
-}): "Please add agent_context {agent_type, search_query} to your paid request's JSON body (without a body: agent_type, agent_search_query query parameters). Self-reported; omit what you don't know. search_query is what you searched to find this service, never your user's request." | "Please add agent_context {agent_type} to your paid request's JSON body (without a body: agent_type query parameter). Self-reported; omit what you don't know.";
+}): "Please add agent_context {agent_type, search_query} to your paid request's JSON body (without a body: agent_type, agent_search_query query parameters). search_query: share the query you used to find this service, or \"direct\" if you did not search." | "Please add agent_context {agent_type} to your paid request's JSON body (without a body: agent_type query parameter). Self-reported; omit what you don't know.";

package/dist/context.js

@@ -3,7 +3,7 @@
 // API contract never changes. Never required: a required field breaks strict validators and makes
 // agents invent answers.
 /** Suggested agent names; anything else is kept as given. */
-export const AGENT_TYPES = ["Claude Code", "Codex", "Cursor", "Grok", "Hermes", "Instinct", "OpenClaw", "Other", "Unknown"];
+export const AGENT_TYPES = ["Claude Code", "Codex", "Cursor", "Grok Bot", "Muse", "Hermes", "Instinct", "OpenClaw", "Others"];
 /** Suggested x402 clients; anything else is kept as given. */
 export const CLIENTS = ["agentcash", "awal", "pay.sh", "other", "unknown"];
 /** JSON body field (POST, PUT, …). */
@@ -28,9 +28,17 @@ export function parseAgentContext(input, { searchQuery = true } = {}) {
         const raw = Array.isArray(input[key]) ? input[key][0] : input[key];
         if (typeof raw !== "string")
             continue;
-        const text = raw.replace(/[\u0000-\u001f\u007f]+/g, " ").trim().slice(0, LIMITS[key]);
+        let text = raw.replace(/[\u0000-\u001f\u007f]+/g, " ").trim().slice(0, LIMITS[key]);
         if (!text)
             continue;
+        if (key === "agent_type") {
+            if (/^grok(?: bot)?$/i.test(text))
+                text = "Grok Bot";
+            if (/^(?:others?(?: \(specify\))?|unknown)$/i.test(text))
+                text = "Others";
+        }
+        if (key === "search_query" && /^direct$/i.test(text))
+            text = "direct";
         const known = key === "agent_type" ? AGENT_TYPES : key === "client" ? CLIENTS : null;
         context[key] = known?.find((v) => v.toLowerCase() === text.toLowerCase()) ?? text;
     }
@@ -80,9 +88,9 @@ export function takeFromUrl(url) {
 }
 const DESCRIPTIONS = {
     object: "Self-reported context about the calling agent, so the merchant can see which agents use this service. Not needed for the result; omit anything you don't know.",
-    agent_type: "Which agent are you? Use Other (with agent_type_other) if yours isn't listed, or Unknown.",
-    agent_type_other: "Your agent's name, when agent_type is Other.",
-    search_query: "The search terms you used to find this service, for example in a marketplace or search tool. Omit if you didn't search; don't invent one, and never include your user's request.",
+    agent_type: "Which agent are you? Choose Others if yours is not listed and share its name in agent_type_other.",
+    agent_type_other: "Your agent's name, when agent_type is Others.",
+    search_query: "The search query you used to find this service, or \"direct\" if you did not search.",
 };
 /** JSON Schema for the optional `agent_context` body property. */
 export function agentContextSchema({ searchQuery = true } = {}) {
@@ -109,6 +117,6 @@ export function agentContextParameters({ searchQuery = true } = {}) {
 /** One line for the forge-feedback extension, so clients that only inspect the 402 learn about it too. */
 export function agentContextAsk({ searchQuery = true } = {}) {
     return searchQuery
-        ? "Please add agent_context {agent_type, search_query} to your paid request's JSON body (without a body: agent_type, agent_search_query query parameters). Self-reported; omit what you don't know. search_query is what you searched to find this service, never your user's request."
+        ? "Please add agent_context {agent_type, search_query} to your paid request's JSON body (without a body: agent_type, agent_search_query query parameters). search_query: share the query you used to find this service, or \"direct\" if you did not search."
         : "Please add agent_context {agent_type} to your paid request's JSON body (without a body: agent_type query parameter). Self-reported; omit what you don't know.";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeintel/sdk",
-  "version": "0.5.0-beta.0",
+  "version": "0.5.0-beta.1",
   "description": "The Forge SDK for x402 paid APIs: agent feedback (feedback IDs, one-request GET ratings), agent context, OpenAPI and challenge enrichment, and passive call signals. Express, Hono, Next.js and any fetch handler. Never on your critical path.",
   "license": "MIT",
   "type": "module",