@simplr-ai/ai 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Simplr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# @simplr-ai/ai
+
+**Use Simplr as tools inside *your* AI agent.** This package wraps Simplr's
+fraud / identity / phone / order checks as ready-to-use **tools** for LLM agents:
+first-class support for the **Vercel AI SDK** (`tool()` + zod), plus a
+framework-agnostic core so the exact same tools work with **raw OpenAI
+function-calling** and **LangChain**.
+
+> **How this differs from the Simplr MCP servers.** `@simplr-ai/dev-mcp` helps a
+> coding agent *build with* Simplr (integration guides + snippets), and
+> `@simplr-ai/mcp` is a runtime **delegation gateway** that exposes *your own*
+> registered endpoints to AI agents. **This package is neither** — it gives you
+> Simplr's checks as tools you drop directly into the agent *you* are building,
+> with no MCP server to run. Under the hood it mirrors the
+> [`@simplr-ai/node`](../simplr-node-sdk) SDK's endpoints and response envelope.
+
+## Install
+
+```bash
+npm install @simplr-ai/ai ai zod
+```
+
+`zod` is a dependency. `ai` (Vercel AI SDK) and `@langchain/core` are **optional
+peer dependencies** — install only the one(s) for the framework you use. They are
+imported lazily, so the package works fine if they're absent (you'll get a clear
+error only when you call a function that needs them).
+
+## Quick start — Vercel AI SDK
+
+```ts
+import { generateText } from "ai";
+import { openai } from "@ai-sdk/openai";
+import { createSimplrTools } from "@simplr-ai/ai";
+
+const tools = createSimplrTools({ apiKey: process.env.SIMPLR_API_KEY! });
+
+const { text } = await generateText({
+  model: openai("gpt-4o"),
+  tools, // { simplr_check_identity, simplr_score_order, simplr_phone_intelligence, simplr_report_phone_outcome }
+  maxSteps: 5,
+  prompt: "A new user signed up with user@example.com and +14155552671. Are they risky?",
+});
+```
+
+`createSimplrTools` returns an object of Vercel-AI `tool()` instances keyed by
+tool name. Prefer a framework-free shape? Use `createSimplrToolDescriptors(config)`
+to get plain `{ name, description, inputSchema, execute }` descriptors.
+
+## Quick start — OpenAI function-calling
+
+```ts
+import OpenAI from "openai";
+import { simplrOpenAITools, executeSimplrTool } from "@simplr-ai/ai/openai";
+
+const config = { apiKey: process.env.SIMPLR_API_KEY! };
+const client = new OpenAI();
+
+const res = await client.chat.completions.create({
+  model: "gpt-4o",
+  messages: [{ role: "user", content: "Is +14155552671 a risky phone number?" }],
+  tools: simplrOpenAITools(config), // [{ type: "function", function: { name, description, parameters } }]
+});
+
+const call = res.choices[0].message.tool_calls?.[0];
+if (call) {
+  const result = await executeSimplrTool(call.function.name, call.function.arguments, config);
+  // feed `result` back to the model as a tool message…
+}
+```
+
+No OpenAI SDK is required to build the schemas — `simplrOpenAITools` returns plain
+JSON. `executeSimplrTool` validates the model's arguments against the tool's zod
+schema before calling the API.
+
+## Quick start — LangChain
+
+```ts
+import { ChatOpenAI } from "@langchain/openai";
+import { createSimplrLangChainTools } from "@simplr-ai/ai/langchain";
+
+const tools = await createSimplrLangChainTools({ apiKey: process.env.SIMPLR_API_KEY! });
+const model = new ChatOpenAI({ model: "gpt-4o" }).bindTools(tools);
+```
+
+Returns `DynamicStructuredTool` instances. Requires `@langchain/core`.
+
+## Tool catalog
+
+| Tool | Endpoint | What it does |
+| --- | --- | --- |
+| `simplr_check_identity` | `POST /v1/check` | Score a user/event (email and/or phone) for fraud/identity risk — signups, logins, password resets. |
+| `simplr_score_order` | `POST /v1/orders` | Score a placed order/transaction for payment fraud risk. |
+| `simplr_phone_intelligence` | `GET /v1/check/phone/intelligence/{phone}` | Read-only lookup of stored risk intelligence for a phone number (carrier, line type, SIM-swap signals). |
+| `simplr_report_phone_outcome` | `POST /v1/check/phone/report` | Feedback signal: report a confirmed real-world outcome for a phone to improve future scoring. |
+
+Every check result includes `risk_score` (0–100, higher = riskier) and
+`risk_level` — one of `low`, `medium`, `high`, `critical`. Use those to decide
+whether to **allow**, **challenge** (step-up auth / manual review), or **block**.
+
+## Public API by subpath
+
+| Import | Exports |
+| --- | --- |
+| `@simplr-ai/ai` | `createSimplrTools(config)`, `createSimplrToolDescriptors(config)`, `SimplrClient`, `schemas`, `SimplrError`, all result types |
+| `@simplr-ai/ai/openai` | `simplrOpenAITools(config)`, `executeSimplrTool(name, args, config)`, `zodToJsonSchema` |
+| `@simplr-ai/ai/langchain` | `createSimplrLangChainTools(config)` |
+
+`config` is `{ apiKey: string; baseUrl?: string; timeoutMs?: number; fetch?: typeof fetch }`.
+
+## Security
+
+Use a **secret key** (`sk_live_…` / `sk_test_…`) and only ever construct these
+tools **server-side** — in your API route, agent backend, or worker. Never ship a
+secret key (or these tool factories) to a browser, mobile app, or any client the
+model's user controls. The key is sent as the `X-API-Key` header. Default
+per-request timeout is 15s.
+
+## Docs & license
+
+Full API reference: https://docs.simplr.so/docs/sdks/ — MIT licensed.

package/dist/index.cjs

@@ -0,0 +1,253 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  SimplrClient: () => SimplrClient,
+  SimplrError: () => SimplrError,
+  createSimplrToolDescriptors: () => createSimplrToolDescriptors,
+  createSimplrTools: () => createSimplrTools,
+  schemas: () => schemas_exports
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/errors.ts
+var SimplrError = class extends Error {
+  status;
+  body;
+  constructor(message, status, body) {
+    super(message);
+    this.name = "SimplrError";
+    this.status = status;
+    this.body = body;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.simplr.sh";
+var DEFAULT_TIMEOUT_MS = 15e3;
+function resolve(config) {
+  if (!config?.apiKey) throw new Error("@simplr-ai/ai: `apiKey` is required");
+  const fetchImpl = config.fetch ?? globalThis.fetch;
+  if (typeof fetchImpl !== "function") {
+    throw new Error(
+      "@simplr-ai/ai: no global fetch available \u2014 use Node 18+ or pass `fetch` in config"
+    );
+  }
+  return {
+    apiKey: config.apiKey,
+    baseUrl: (config.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, ""),
+    timeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    fetchImpl
+  };
+}
+async function apiRequest(cfg, method, path, body) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), cfg.timeoutMs);
+  try {
+    const res = await cfg.fetchImpl(`${cfg.baseUrl}${path}`, {
+      method,
+      headers: { "Content-Type": "application/json", "X-API-Key": cfg.apiKey },
+      body: body !== void 0 ? JSON.stringify(body) : void 0,
+      signal: controller.signal
+    });
+    const text = await res.text();
+    let parsed;
+    try {
+      parsed = text ? JSON.parse(text) : void 0;
+    } catch {
+      parsed = text;
+    }
+    if (!res.ok) {
+      const message = parsed && (parsed.message || parsed.error) || `Simplr API error ${res.status}`;
+      throw new SimplrError(message, res.status, parsed);
+    }
+    return parsed && typeof parsed === "object" && "content" in parsed ? parsed.content : parsed;
+  } catch (err) {
+    if (err instanceof SimplrError) throw err;
+    if (err instanceof Error && err.name === "AbortError") {
+      throw new SimplrError(`Request to ${path} timed out after ${cfg.timeoutMs}ms`, 0, null);
+    }
+    throw new SimplrError(err instanceof Error ? err.message : "Network error", 0, null);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+var SimplrClient = class {
+  cfg;
+  constructor(config) {
+    this.cfg = resolve(config);
+  }
+  /** POST /v1/check — identity/fraud check. */
+  check(input) {
+    return apiRequest(this.cfg, "POST", "/v1/check", input);
+  }
+  /** POST /v1/orders — order fraud scoring. */
+  scoreOrder(input) {
+    return apiRequest(this.cfg, "POST", "/v1/orders", input);
+  }
+  /** GET /v1/check/phone/intelligence/{phone} — stored phone intelligence. */
+  phoneIntelligence(phone) {
+    return apiRequest(
+      this.cfg,
+      "GET",
+      `/v1/check/phone/intelligence/${encodeURIComponent(phone)}`
+    );
+  }
+  /** POST /v1/check/phone/report — report a real-world phone outcome. */
+  reportPhone(input) {
+    return apiRequest(this.cfg, "POST", "/v1/check/phone/report", input);
+  }
+};
+
+// src/schemas.ts
+var schemas_exports = {};
+__export(schemas_exports, {
+  checkIdentitySchema: () => checkIdentitySchema,
+  phoneIntelligenceSchema: () => phoneIntelligenceSchema,
+  reportPhoneOutcomeSchema: () => reportPhoneOutcomeSchema,
+  scoreOrderSchema: () => scoreOrderSchema
+});
+var import_zod = require("zod");
+var checkIdentitySchema = import_zod.z.object({
+  email: import_zod.z.string().email().optional().describe("The user's email address to evaluate (e.g. for signup/login risk)."),
+  phone: import_zod.z.string().optional().describe("The user's phone number in E.164 format (e.g. +14155552671)."),
+  event_type: import_zod.z.string().optional().describe(
+    "The lifecycle event being scored, e.g. 'signup', 'login', 'checkout', 'password_reset'. Helps tune the risk model."
+  ),
+  event_id: import_zod.z.string().optional().describe("Your own idempotency / correlation id for this event, if any."),
+  metadata: import_zod.z.record(import_zod.z.unknown()).optional().describe(
+    "Arbitrary extra context about the event (e.g. { ip: '1.2.3.4', user_id: 'u_123' }). Free-form key/value object."
+  )
+}).describe(
+  "Provide at least one of `email` or `phone`. Returns a fraud/identity risk assessment for the given user or event."
+);
+var scoreOrderSchema = import_zod.z.object({
+  order_id: import_zod.z.string().describe("Your unique identifier for this order."),
+  external_id: import_zod.z.string().optional().describe("An optional secondary id (e.g. your payment-processor reference)."),
+  amount: import_zod.z.number().describe("The order total as a number in the order's currency (e.g. 129.99)."),
+  currency: import_zod.z.string().describe("ISO 4217 currency code, e.g. 'USD', 'EUR', 'GBP'."),
+  fingerprint_hash: import_zod.z.string().optional().describe(
+    "Device fingerprint hash from a prior identity check, if available, to link the order to a device."
+  ),
+  metadata: import_zod.z.record(import_zod.z.unknown()).optional().describe("Arbitrary extra order context (items, shipping, customer id, etc.).")
+}).describe(
+  "Score a placed order for payment/transaction fraud risk. Returns a risk_score and risk_level for the order."
+);
+var phoneIntelligenceSchema = import_zod.z.object({
+  phone: import_zod.z.string().describe(
+    "The phone number to look up, in E.164 format (e.g. +14155552671). It will be URL-encoded."
+  )
+}).describe(
+  "Fetch stored risk intelligence for a phone number (carrier, line type, SIM-swap signals, prior outcomes). Read-only, no side effects."
+);
+var reportPhoneOutcomeSchema = import_zod.z.object({
+  phone: import_zod.z.string().describe("The phone number the outcome applies to, in E.164 format."),
+  outcome: import_zod.z.enum([
+    "fraud",
+    "sim_swap_fraud",
+    "account_takeover",
+    "spam",
+    "bot",
+    "legitimate"
+  ]).describe(
+    "The confirmed real-world outcome for this phone: 'legitimate' (good actor), 'fraud', 'sim_swap_fraud', 'account_takeover', 'spam', or 'bot'."
+  ),
+  check_id: import_zod.z.string().optional().describe("The id of the original check this outcome relates to, if known."),
+  confidence: import_zod.z.number().min(0).max(1).optional().describe("Your confidence in the reported outcome, 0.0\u20131.0."),
+  metadata: import_zod.z.record(import_zod.z.unknown()).optional().describe("Arbitrary extra context about how the outcome was determined.")
+}).describe(
+  "Report a confirmed real-world outcome for a phone number back to Simplr. This is a feedback/training signal that improves future scoring \u2014 only call it once you actually know the outcome."
+);
+
+// src/tools.ts
+var RISK_LEVEL_DOC = "The result includes `risk_score` (0\u2013100, higher = riskier) and `risk_level` (one of 'low', 'medium', 'high', 'critical').";
+function createSimplrToolDescriptors(config) {
+  const client = new SimplrClient(config);
+  return {
+    simplr_check_identity: {
+      name: "simplr_check_identity",
+      description: "Assess the fraud/identity risk of a user or event using their email and/or phone. Use this for signups, logins, password resets, or any moment you need to decide whether to trust, challenge (e.g. step-up auth), or block a user. " + RISK_LEVEL_DOC,
+      inputSchema: checkIdentitySchema,
+      execute: (args) => client.check(args)
+    },
+    simplr_score_order: {
+      name: "simplr_score_order",
+      description: "Score a placed order/transaction for payment fraud risk given its amount, currency, and ids. Use this at checkout or post-purchase review to decide whether to approve, hold for manual review, or reject an order. " + RISK_LEVEL_DOC,
+      inputSchema: scoreOrderSchema,
+      execute: (args) => client.scoreOrder(args)
+    },
+    simplr_phone_intelligence: {
+      name: "simplr_phone_intelligence",
+      description: "Look up stored risk intelligence for a phone number (carrier, line type, SIM-swap and prior-outcome signals). Read-only with no side effects \u2014 safe to call whenever you need context about a phone number before deciding.",
+      inputSchema: phoneIntelligenceSchema,
+      execute: (args) => client.phoneIntelligence(args.phone)
+    },
+    simplr_report_phone_outcome: {
+      name: "simplr_report_phone_outcome",
+      description: "Report a confirmed real-world outcome for a phone number (e.g. 'fraud', 'sim_swap_fraud', 'legitimate') back to Simplr. This is a feedback/training signal that improves future scoring. Only call it once you actually KNOW the outcome \u2014 do not guess.",
+      inputSchema: reportPhoneOutcomeSchema,
+      execute: (args) => client.reportPhone(args)
+    }
+  };
+}
+
+// src/index.ts
+function createSimplrTools(config) {
+  let tool;
+  try {
+    const mod = loadAi();
+    tool = mod.tool;
+    if (typeof tool !== "function") {
+      throw new Error("`ai` is installed but does not export `tool`.");
+    }
+  } catch (err) {
+    throw new Error(
+      "@simplr-ai/ai: createSimplrTools() requires the Vercel AI SDK. Install it with `npm install ai`, or use createSimplrToolDescriptors() for a framework-agnostic alternative. (Original error: " + (err instanceof Error ? err.message : String(err)) + ")"
+    );
+  }
+  const descriptors = createSimplrToolDescriptors(config);
+  const out = {};
+  for (const key of Object.keys(descriptors)) {
+    const d = descriptors[key];
+    out[key] = tool({
+      description: d.description,
+      // The AI SDK reads either `inputSchema` (v4+) or `parameters` (v3); we set
+      // both to the zod schema so it works across versions.
+      inputSchema: d.inputSchema,
+      parameters: d.inputSchema,
+      execute: (args) => d.execute(args)
+    });
+  }
+  return out;
+}
+function loadAi() {
+  const specifier = "ai";
+  return require(specifier);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SimplrClient,
+  SimplrError,
+  createSimplrToolDescriptors,
+  createSimplrTools,
+  schemas
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/client.ts","../src/schemas.ts","../src/tools.ts"],"sourcesContent":["/**\n * `@simplr-ai/ai` — main entry.\n *\n * Exposes Simplr's fraud/identity/phone checks as ready-to-use tools for AI\n * agents. The primary integration is the Vercel AI SDK (`ai` package): call\n * `createSimplrTools(config)` to get an object of `tool()` instances you can pass\n * straight into `generateText`/`streamText`.\n *\n * `ai` is an OPTIONAL peer dependency and is imported lazily, so this package\n * builds and tests without it installed. If you call `createSimplrTools` without\n * `ai` present, a clear error tells you to install it (or use\n * `createSimplrToolDescriptors`, which needs no framework).\n */\nimport {\n  createSimplrToolDescriptors,\n  type SimplrToolDescriptor,\n  type SimplrToolName,\n} from \"./tools.js\";\nimport type { SimplrAIConfig } from \"./types.js\";\n\nexport { SimplrError } from \"./errors.js\";\nexport * from \"./types.js\";\nexport {\n  createSimplrToolDescriptors,\n  type SimplrToolDescriptor,\n  type SimplrToolName,\n} from \"./tools.js\";\nexport * as schemas from \"./schemas.js\";\nexport { SimplrClient } from \"./client.js\";\n\n/** The shape of a Vercel AI SDK `tool()` instance (kept loose to avoid a hard dep). */\nexport type VercelTool = unknown;\n\n/**\n * Create Vercel AI SDK tools for every Simplr capability, keyed by tool name.\n *\n * ```ts\n * import { generateText } from \"ai\";\n * import { openai } from \"@ai-sdk/openai\";\n * import { createSimplrTools } from \"@simplr-ai/ai\";\n *\n * const tools = createSimplrTools({ apiKey: process.env.SIMPLR_API_KEY! });\n * const { text } = await generateText({\n *   model: openai(\"gpt-4o\"),\n *   tools,\n *   prompt: \"Is user@example.com risky to sign up?\",\n * });\n * ```\n *\n * Requires the optional peer dependency `ai`. If it isn't installed, this throws\n * with installation guidance — use `createSimplrToolDescriptors` for a\n * framework-free alternative.\n */\nexport function createSimplrTools(\n  config: SimplrAIConfig,\n): Record<SimplrToolName, VercelTool> {\n  let tool: (spec: any) => unknown;\n  try {\n    // Lazy, synchronous resolution so absence of `ai` is a clear error and the\n    // return type stays simple (no Promise). `require` works under both CJS and\n    // tsup's interop; in pure ESM environments where `ai` is installed this is\n    // resolvable too.\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const mod = loadAi();\n    tool = mod.tool;\n    if (typeof tool !== \"function\") {\n      throw new Error(\"`ai` is installed but does not export `tool`.\");\n    }\n  } catch (err) {\n    throw new Error(\n      \"@simplr-ai/ai: createSimplrTools() requires the Vercel AI SDK. \" +\n        \"Install it with `npm install ai`, or use createSimplrToolDescriptors() \" +\n        \"for a framework-agnostic alternative. (Original error: \" +\n        (err instanceof Error ? err.message : String(err)) +\n        \")\",\n    );\n  }\n\n  const descriptors = createSimplrToolDescriptors(config);\n  const out = {} as Record<SimplrToolName, VercelTool>;\n  for (const key of Object.keys(descriptors) as SimplrToolName[]) {\n    const d = descriptors[key] as SimplrToolDescriptor;\n    out[key] = tool({\n      description: d.description,\n      // The AI SDK reads either `inputSchema` (v4+) or `parameters` (v3); we set\n      // both to the zod schema so it works across versions.\n      inputSchema: d.inputSchema,\n      parameters: d.inputSchema,\n      execute: (args: unknown) => d.execute(args as any),\n    });\n  }\n  return out;\n}\n\n/** Resolve the optional `ai` peer dependency synchronously via `require`. */\nfunction loadAi(): { tool: (spec: any) => unknown } {\n  // In CJS output `require` exists directly. In ESM output tsup injects a\n  // `require` shim (via createRequire) when `require` is referenced, so this\n  // works under both module systems without bundling `ai` itself.\n  const specifier = \"ai\";\n  return (require as NodeRequire)(specifier);\n}\n","/**\n * Thrown when the Simplr API returns a non-2xx response, or a request fails\n * (network error / timeout — in which case `status` is 0 and `body` is null).\n *\n * Mirrors `SimplrError` from `@simplr-ai/node`.\n */\nexport class SimplrError extends Error {\n  readonly status: number;\n  readonly body: unknown;\n\n  constructor(message: string, status: number, body: unknown) {\n    super(message);\n    this.name = \"SimplrError\";\n    this.status = status;\n    this.body = body;\n  }\n}\n","/**\n * Thin internal HTTP client.\n *\n * This mirrors the minimal request layer of `@simplr-ai/node` (`apiRequest` +\n * the check / orders / phone endpoints) so this package has **no unbuilt\n * workspace dependency** and tests can run fully offline. If you need the full\n * SDK (bulk, edge, flags, webhooks) use `@simplr-ai/node` directly.\n */\nimport { SimplrError } from \"./errors.js\";\nimport type {\n  CheckInput,\n  CheckResult,\n  OrderInput,\n  OrderResult,\n  PhoneIntelligenceResult,\n  PhoneReportInput,\n  PhoneReportResult,\n  SimplrAIConfig,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.simplr.sh\";\nconst DEFAULT_TIMEOUT_MS = 15000;\n\ninterface ResolvedConfig {\n  apiKey: string;\n  baseUrl: string;\n  timeoutMs: number;\n  fetchImpl: typeof fetch;\n}\n\nfunction resolve(config: SimplrAIConfig): ResolvedConfig {\n  if (!config?.apiKey) throw new Error(\"@simplr-ai/ai: `apiKey` is required\");\n  const fetchImpl = config.fetch ?? globalThis.fetch;\n  if (typeof fetchImpl !== \"function\") {\n    throw new Error(\n      \"@simplr-ai/ai: no global fetch available — use Node 18+ or pass `fetch` in config\",\n    );\n  }\n  return {\n    apiKey: config.apiKey,\n    baseUrl: (config.baseUrl || DEFAULT_BASE_URL).replace(/\\/+$/, \"\"),\n    timeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,\n    fetchImpl,\n  };\n}\n\n/**\n * Internal request helper. Sends `X-API-Key`, applies a timeout, and unwraps the\n * API's `{ success, message, content }` envelope (returning `content`).\n */\nasync function apiRequest<T>(\n  cfg: ResolvedConfig,\n  method: \"GET\" | \"POST\",\n  path: string,\n  body?: unknown,\n): Promise<T> {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), cfg.timeoutMs);\n  try {\n    const res = await cfg.fetchImpl(`${cfg.baseUrl}${path}`, {\n      method,\n      headers: { \"Content-Type\": \"application/json\", \"X-API-Key\": cfg.apiKey },\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n      signal: controller.signal,\n    });\n\n    const text = await res.text();\n    let parsed: any;\n    try {\n      parsed = text ? JSON.parse(text) : undefined;\n    } catch {\n      parsed = text;\n    }\n\n    if (!res.ok) {\n      const message =\n        (parsed && (parsed.message || parsed.error)) || `Simplr API error ${res.status}`;\n      throw new SimplrError(message, res.status, parsed);\n    }\n\n    return (parsed && typeof parsed === \"object\" && \"content\" in parsed\n      ? parsed.content\n      : parsed) as T;\n  } catch (err) {\n    if (err instanceof SimplrError) throw err;\n    if (err instanceof Error && err.name === \"AbortError\") {\n      throw new SimplrError(`Request to ${path} timed out after ${cfg.timeoutMs}ms`, 0, null);\n    }\n    throw new SimplrError(err instanceof Error ? err.message : \"Network error\", 0, null);\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\n/** A minimal Simplr API client exposing only the endpoints these tools need. */\nexport class SimplrClient {\n  private readonly cfg: ResolvedConfig;\n\n  constructor(config: SimplrAIConfig) {\n    this.cfg = resolve(config);\n  }\n\n  /** POST /v1/check — identity/fraud check. */\n  check(input: CheckInput): Promise<CheckResult> {\n    return apiRequest(this.cfg, \"POST\", \"/v1/check\", input);\n  }\n\n  /** POST /v1/orders — order fraud scoring. */\n  scoreOrder(input: OrderInput): Promise<OrderResult> {\n    return apiRequest(this.cfg, \"POST\", \"/v1/orders\", input);\n  }\n\n  /** GET /v1/check/phone/intelligence/{phone} — stored phone intelligence. */\n  phoneIntelligence(phone: string): Promise<PhoneIntelligenceResult> {\n    return apiRequest(\n      this.cfg,\n      \"GET\",\n      `/v1/check/phone/intelligence/${encodeURIComponent(phone)}`,\n    );\n  }\n\n  /** POST /v1/check/phone/report — report a real-world phone outcome. */\n  reportPhone(input: PhoneReportInput): Promise<PhoneReportResult> {\n    return apiRequest(this.cfg, \"POST\", \"/v1/check/phone/report\", input);\n  }\n}\n","/**\n * Zod input schemas for each Simplr tool, with rich `.describe()` text so that\n * LLMs call the tools with the right arguments. Each schema corresponds 1:1 to\n * the API request body documented in the Simplr contract.\n */\nimport { z } from \"zod\";\n\n/** Input for `simplr_check_identity` → POST /v1/check. */\nexport const checkIdentitySchema = z\n  .object({\n    email: z\n      .string()\n      .email()\n      .optional()\n      .describe(\"The user's email address to evaluate (e.g. for signup/login risk).\"),\n    phone: z\n      .string()\n      .optional()\n      .describe(\"The user's phone number in E.164 format (e.g. +14155552671).\"),\n    event_type: z\n      .string()\n      .optional()\n      .describe(\n        \"The lifecycle event being scored, e.g. 'signup', 'login', 'checkout', 'password_reset'. Helps tune the risk model.\",\n      ),\n    event_id: z\n      .string()\n      .optional()\n      .describe(\"Your own idempotency / correlation id for this event, if any.\"),\n    metadata: z\n      .record(z.unknown())\n      .optional()\n      .describe(\n        \"Arbitrary extra context about the event (e.g. { ip: '1.2.3.4', user_id: 'u_123' }). Free-form key/value object.\",\n      ),\n  })\n  .describe(\n    \"Provide at least one of `email` or `phone`. Returns a fraud/identity risk assessment for the given user or event.\",\n  );\n\n/** Input for `simplr_score_order` → POST /v1/orders. */\nexport const scoreOrderSchema = z\n  .object({\n    order_id: z\n      .string()\n      .describe(\"Your unique identifier for this order.\"),\n    external_id: z\n      .string()\n      .optional()\n      .describe(\"An optional secondary id (e.g. your payment-processor reference).\"),\n    amount: z\n      .number()\n      .describe(\"The order total as a number in the order's currency (e.g. 129.99).\"),\n    currency: z\n      .string()\n      .describe(\"ISO 4217 currency code, e.g. 'USD', 'EUR', 'GBP'.\"),\n    fingerprint_hash: z\n      .string()\n      .optional()\n      .describe(\n        \"Device fingerprint hash from a prior identity check, if available, to link the order to a device.\",\n      ),\n    metadata: z\n      .record(z.unknown())\n      .optional()\n      .describe(\"Arbitrary extra order context (items, shipping, customer id, etc.).\"),\n  })\n  .describe(\n    \"Score a placed order for payment/transaction fraud risk. Returns a risk_score and risk_level for the order.\",\n  );\n\n/** Input for `simplr_phone_intelligence` → GET /v1/check/phone/intelligence/{phone}. */\nexport const phoneIntelligenceSchema = z\n  .object({\n    phone: z\n      .string()\n      .describe(\n        \"The phone number to look up, in E.164 format (e.g. +14155552671). It will be URL-encoded.\",\n      ),\n  })\n  .describe(\n    \"Fetch stored risk intelligence for a phone number (carrier, line type, SIM-swap signals, prior outcomes). Read-only, no side effects.\",\n  );\n\n/** Input for `simplr_report_phone_outcome` → POST /v1/check/phone/report. */\nexport const reportPhoneOutcomeSchema = z\n  .object({\n    phone: z\n      .string()\n      .describe(\"The phone number the outcome applies to, in E.164 format.\"),\n    outcome: z\n      .enum([\n        \"fraud\",\n        \"sim_swap_fraud\",\n        \"account_takeover\",\n        \"spam\",\n        \"bot\",\n        \"legitimate\",\n      ])\n      .describe(\n        \"The confirmed real-world outcome for this phone: 'legitimate' (good actor), 'fraud', 'sim_swap_fraud', 'account_takeover', 'spam', or 'bot'.\",\n      ),\n    check_id: z\n      .string()\n      .optional()\n      .describe(\"The id of the original check this outcome relates to, if known.\"),\n    confidence: z\n      .number()\n      .min(0)\n      .max(1)\n      .optional()\n      .describe(\"Your confidence in the reported outcome, 0.0–1.0.\"),\n    metadata: z\n      .record(z.unknown())\n      .optional()\n      .describe(\"Arbitrary extra context about how the outcome was determined.\"),\n  })\n  .describe(\n    \"Report a confirmed real-world outcome for a phone number back to Simplr. This is a feedback/training signal that improves future scoring — only call it once you actually know the outcome.\",\n  );\n\nexport type CheckIdentityArgs = z.infer<typeof checkIdentitySchema>;\nexport type ScoreOrderArgs = z.infer<typeof scoreOrderSchema>;\nexport type PhoneIntelligenceArgs = z.infer<typeof phoneIntelligenceSchema>;\nexport type ReportPhoneOutcomeArgs = z.infer<typeof reportPhoneOutcomeSchema>;\n","/**\n * Framework-agnostic tool descriptors.\n *\n * Each descriptor is a plain object `{ name, description, inputSchema, execute }`.\n * The same descriptors are wrapped for Vercel AI SDK (`./index`), raw OpenAI\n * function-calling (`./openai`), and LangChain (`./langchain`).\n */\nimport type { z } from \"zod\";\nimport { SimplrClient } from \"./client.js\";\nimport {\n  checkIdentitySchema,\n  phoneIntelligenceSchema,\n  reportPhoneOutcomeSchema,\n  scoreOrderSchema,\n  type CheckIdentityArgs,\n  type PhoneIntelligenceArgs,\n  type ReportPhoneOutcomeArgs,\n  type ScoreOrderArgs,\n} from \"./schemas.js\";\nimport type {\n  CheckResult,\n  OrderResult,\n  PhoneIntelligenceResult,\n  PhoneReportResult,\n  SimplrAIConfig,\n} from \"./types.js\";\n\n/** A single framework-agnostic Simplr tool descriptor. */\nexport interface SimplrToolDescriptor<Args = any, Result = any> {\n  /** Stable tool name, e.g. `simplr_check_identity`. */\n  name: string;\n  /** Agent-facing description (when to use it, what it returns). */\n  description: string;\n  /** Zod schema for the tool's input arguments. */\n  inputSchema: z.ZodType<Args>;\n  /** Run the tool against the Simplr API and return the unwrapped result. */\n  execute: (args: Args) => Promise<Result>;\n}\n\nconst RISK_LEVEL_DOC =\n  \"The result includes `risk_score` (0–100, higher = riskier) and `risk_level` (one of 'low', 'medium', 'high', 'critical').\";\n\n/**\n * Build the four Simplr tool descriptors bound to a client. These are pure data\n * + closures — no AI framework is required to use them.\n */\nexport function createSimplrToolDescriptors(\n  config: SimplrAIConfig,\n): {\n  simplr_check_identity: SimplrToolDescriptor<CheckIdentityArgs, CheckResult>;\n  simplr_score_order: SimplrToolDescriptor<ScoreOrderArgs, OrderResult>;\n  simplr_phone_intelligence: SimplrToolDescriptor<\n    PhoneIntelligenceArgs,\n    PhoneIntelligenceResult\n  >;\n  simplr_report_phone_outcome: SimplrToolDescriptor<\n    ReportPhoneOutcomeArgs,\n    PhoneReportResult\n  >;\n} {\n  const client = new SimplrClient(config);\n\n  return {\n    simplr_check_identity: {\n      name: \"simplr_check_identity\",\n      description:\n        \"Assess the fraud/identity risk of a user or event using their email and/or phone. \" +\n        \"Use this for signups, logins, password resets, or any moment you need to decide whether to \" +\n        \"trust, challenge (e.g. step-up auth), or block a user. \" +\n        RISK_LEVEL_DOC,\n      inputSchema: checkIdentitySchema,\n      execute: (args) => client.check(args),\n    },\n\n    simplr_score_order: {\n      name: \"simplr_score_order\",\n      description:\n        \"Score a placed order/transaction for payment fraud risk given its amount, currency, and ids. \" +\n        \"Use this at checkout or post-purchase review to decide whether to approve, hold for manual review, or reject an order. \" +\n        RISK_LEVEL_DOC,\n      inputSchema: scoreOrderSchema,\n      execute: (args) => client.scoreOrder(args),\n    },\n\n    simplr_phone_intelligence: {\n      name: \"simplr_phone_intelligence\",\n      description:\n        \"Look up stored risk intelligence for a phone number (carrier, line type, SIM-swap and prior-outcome signals). \" +\n        \"Read-only with no side effects — safe to call whenever you need context about a phone number before deciding.\",\n      inputSchema: phoneIntelligenceSchema,\n      execute: (args) => client.phoneIntelligence(args.phone),\n    },\n\n    simplr_report_phone_outcome: {\n      name: \"simplr_report_phone_outcome\",\n      description:\n        \"Report a confirmed real-world outcome for a phone number (e.g. 'fraud', 'sim_swap_fraud', 'legitimate') back to Simplr. \" +\n        \"This is a feedback/training signal that improves future scoring. Only call it once you actually KNOW the outcome — \" +\n        \"do not guess.\",\n      inputSchema: reportPhoneOutcomeSchema,\n      execute: (args) => client.reportPhone(args),\n    },\n  };\n}\n\n/** The set of tool names exposed by this package. */\nexport type SimplrToolName =\n  | \"simplr_check_identity\"\n  | \"simplr_score_order\"\n  | \"simplr_phone_intelligence\"\n  | \"simplr_report_phone_outcome\";\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,195 @@
+import { z } from 'zod';
+import { S as SimplrAIConfig, C as CheckResult, O as OrderResult, P as PhoneIntelligenceResult, a as PhoneReportResult, b as CheckInput, c as OrderInput, d as PhoneReportInput } from './types-Y9ma4qBT.cjs';
+export { e as PhoneOutcome, R as RiskLevel } from './types-Y9ma4qBT.cjs';
+
+/**
+ * Zod input schemas for each Simplr tool, with rich `.describe()` text so that
+ * LLMs call the tools with the right arguments. Each schema corresponds 1:1 to
+ * the API request body documented in the Simplr contract.
+ */
+
+/** Input for `simplr_check_identity` → POST /v1/check. */
+declare const checkIdentitySchema: z.ZodObject<{
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    event_type: z.ZodOptional<z.ZodString>;
+    event_id: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    email?: string | undefined;
+    phone?: string | undefined;
+    event_type?: string | undefined;
+    event_id?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    email?: string | undefined;
+    phone?: string | undefined;
+    event_type?: string | undefined;
+    event_id?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+/** Input for `simplr_score_order` → POST /v1/orders. */
+declare const scoreOrderSchema: z.ZodObject<{
+    order_id: z.ZodString;
+    external_id: z.ZodOptional<z.ZodString>;
+    amount: z.ZodNumber;
+    currency: z.ZodString;
+    fingerprint_hash: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    order_id: string;
+    amount: number;
+    currency: string;
+    metadata?: Record<string, unknown> | undefined;
+    external_id?: string | undefined;
+    fingerprint_hash?: string | undefined;
+}, {
+    order_id: string;
+    amount: number;
+    currency: string;
+    metadata?: Record<string, unknown> | undefined;
+    external_id?: string | undefined;
+    fingerprint_hash?: string | undefined;
+}>;
+/** Input for `simplr_phone_intelligence` → GET /v1/check/phone/intelligence/{phone}. */
+declare const phoneIntelligenceSchema: z.ZodObject<{
+    phone: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    phone: string;
+}, {
+    phone: string;
+}>;
+/** Input for `simplr_report_phone_outcome` → POST /v1/check/phone/report. */
+declare const reportPhoneOutcomeSchema: z.ZodObject<{
+    phone: z.ZodString;
+    outcome: z.ZodEnum<["fraud", "sim_swap_fraud", "account_takeover", "spam", "bot", "legitimate"]>;
+    check_id: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    phone: string;
+    outcome: "fraud" | "sim_swap_fraud" | "account_takeover" | "spam" | "bot" | "legitimate";
+    metadata?: Record<string, unknown> | undefined;
+    check_id?: string | undefined;
+    confidence?: number | undefined;
+}, {
+    phone: string;
+    outcome: "fraud" | "sim_swap_fraud" | "account_takeover" | "spam" | "bot" | "legitimate";
+    metadata?: Record<string, unknown> | undefined;
+    check_id?: string | undefined;
+    confidence?: number | undefined;
+}>;
+type CheckIdentityArgs = z.infer<typeof checkIdentitySchema>;
+type ScoreOrderArgs = z.infer<typeof scoreOrderSchema>;
+type PhoneIntelligenceArgs = z.infer<typeof phoneIntelligenceSchema>;
+type ReportPhoneOutcomeArgs = z.infer<typeof reportPhoneOutcomeSchema>;
+
+type schemas_CheckIdentityArgs = CheckIdentityArgs;
+type schemas_PhoneIntelligenceArgs = PhoneIntelligenceArgs;
+type schemas_ReportPhoneOutcomeArgs = ReportPhoneOutcomeArgs;
+type schemas_ScoreOrderArgs = ScoreOrderArgs;
+declare const schemas_checkIdentitySchema: typeof checkIdentitySchema;
+declare const schemas_phoneIntelligenceSchema: typeof phoneIntelligenceSchema;
+declare const schemas_reportPhoneOutcomeSchema: typeof reportPhoneOutcomeSchema;
+declare const schemas_scoreOrderSchema: typeof scoreOrderSchema;
+declare namespace schemas {
+  export { type schemas_CheckIdentityArgs as CheckIdentityArgs, type schemas_PhoneIntelligenceArgs as PhoneIntelligenceArgs, type schemas_ReportPhoneOutcomeArgs as ReportPhoneOutcomeArgs, type schemas_ScoreOrderArgs as ScoreOrderArgs, schemas_checkIdentitySchema as checkIdentitySchema, schemas_phoneIntelligenceSchema as phoneIntelligenceSchema, schemas_reportPhoneOutcomeSchema as reportPhoneOutcomeSchema, schemas_scoreOrderSchema as scoreOrderSchema };
+}
+
+/**
+ * Framework-agnostic tool descriptors.
+ *
+ * Each descriptor is a plain object `{ name, description, inputSchema, execute }`.
+ * The same descriptors are wrapped for Vercel AI SDK (`./index`), raw OpenAI
+ * function-calling (`./openai`), and LangChain (`./langchain`).
+ */
+
+/** A single framework-agnostic Simplr tool descriptor. */
+interface SimplrToolDescriptor<Args = any, Result = any> {
+    /** Stable tool name, e.g. `simplr_check_identity`. */
+    name: string;
+    /** Agent-facing description (when to use it, what it returns). */
+    description: string;
+    /** Zod schema for the tool's input arguments. */
+    inputSchema: z.ZodType<Args>;
+    /** Run the tool against the Simplr API and return the unwrapped result. */
+    execute: (args: Args) => Promise<Result>;
+}
+/**
+ * Build the four Simplr tool descriptors bound to a client. These are pure data
+ * + closures — no AI framework is required to use them.
+ */
+declare function createSimplrToolDescriptors(config: SimplrAIConfig): {
+    simplr_check_identity: SimplrToolDescriptor<CheckIdentityArgs, CheckResult>;
+    simplr_score_order: SimplrToolDescriptor<ScoreOrderArgs, OrderResult>;
+    simplr_phone_intelligence: SimplrToolDescriptor<PhoneIntelligenceArgs, PhoneIntelligenceResult>;
+    simplr_report_phone_outcome: SimplrToolDescriptor<ReportPhoneOutcomeArgs, PhoneReportResult>;
+};
+/** The set of tool names exposed by this package. */
+type SimplrToolName = "simplr_check_identity" | "simplr_score_order" | "simplr_phone_intelligence" | "simplr_report_phone_outcome";
+
+/**
+ * Thrown when the Simplr API returns a non-2xx response, or a request fails
+ * (network error / timeout — in which case `status` is 0 and `body` is null).
+ *
+ * Mirrors `SimplrError` from `@simplr-ai/node`.
+ */
+declare class SimplrError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(message: string, status: number, body: unknown);
+}
+
+/** A minimal Simplr API client exposing only the endpoints these tools need. */
+declare class SimplrClient {
+    private readonly cfg;
+    constructor(config: SimplrAIConfig);
+    /** POST /v1/check — identity/fraud check. */
+    check(input: CheckInput): Promise<CheckResult>;
+    /** POST /v1/orders — order fraud scoring. */
+    scoreOrder(input: OrderInput): Promise<OrderResult>;
+    /** GET /v1/check/phone/intelligence/{phone} — stored phone intelligence. */
+    phoneIntelligence(phone: string): Promise<PhoneIntelligenceResult>;
+    /** POST /v1/check/phone/report — report a real-world phone outcome. */
+    reportPhone(input: PhoneReportInput): Promise<PhoneReportResult>;
+}
+
+/**
+ * `@simplr-ai/ai` — main entry.
+ *
+ * Exposes Simplr's fraud/identity/phone checks as ready-to-use tools for AI
+ * agents. The primary integration is the Vercel AI SDK (`ai` package): call
+ * `createSimplrTools(config)` to get an object of `tool()` instances you can pass
+ * straight into `generateText`/`streamText`.
+ *
+ * `ai` is an OPTIONAL peer dependency and is imported lazily, so this package
+ * builds and tests without it installed. If you call `createSimplrTools` without
+ * `ai` present, a clear error tells you to install it (or use
+ * `createSimplrToolDescriptors`, which needs no framework).
+ */
+
+/** The shape of a Vercel AI SDK `tool()` instance (kept loose to avoid a hard dep). */
+type VercelTool = unknown;
+/**
+ * Create Vercel AI SDK tools for every Simplr capability, keyed by tool name.
+ *
+ * ```ts
+ * import { generateText } from "ai";
+ * import { openai } from "@ai-sdk/openai";
+ * import { createSimplrTools } from "@simplr-ai/ai";
+ *
+ * const tools = createSimplrTools({ apiKey: process.env.SIMPLR_API_KEY! });
+ * const { text } = await generateText({
+ *   model: openai("gpt-4o"),
+ *   tools,
+ *   prompt: "Is user@example.com risky to sign up?",
+ * });
+ * ```
+ *
+ * Requires the optional peer dependency `ai`. If it isn't installed, this throws
+ * with installation guidance — use `createSimplrToolDescriptors` for a
+ * framework-free alternative.
+ */
+declare function createSimplrTools(config: SimplrAIConfig): Record<SimplrToolName, VercelTool>;
+
+export { CheckInput, CheckResult, OrderInput, OrderResult, PhoneIntelligenceResult, PhoneReportInput, PhoneReportResult, SimplrAIConfig, SimplrClient, SimplrError, type SimplrToolDescriptor, type SimplrToolName, type VercelTool, createSimplrToolDescriptors, createSimplrTools, schemas };