Entrys

Give your AI agents a single entry point to access internal APIs and tools. Redact PII by default, audit every request, and control access, without modifying your existing services.

Installation

npm install @entrys/client
# or
pnpm add @entrys/client

Quick Start

import Entry from "@entrys/client";

const entry = new Entry({
  apiKey: process.env.ENTRYS_API_KEY
});

const customer = await entry.invoke("get_customer", {
  params: { id: "123" }
});

console.log(customer);
// { name: "Jane Doe", email: "[REDACTED]", ... }

Configuration

Set your API key pass it directly:

const entry = new Entry({ apiKey: "ent_your_api_key" });

For self-hosted deployments, also set the base URL:

const entry = new Entry({
  apiKey: process.env.ENTRYS_API_KEY,
  baseUrl: "http://localhost:3001"
});

API

new Entry(options?)

Create a new entrys client.

Options (all optional):

• apiKey - Your agent API key. Defaults to ENTRYS_API_KEY env var
• baseUrl - Gateway URL. Defaults to ENTRYS_BASE_URL env var or https://api.entrys.co
• fetch - Custom fetch implementation

agent.invoke(toolName, options?)

Invoke a registered tool through the gateway. Returns the output directly.

Parameters:

• toolName (string) - Name of the tool to invoke
• options.params (object) - URL path parameters
• options.input (object) - Request body data
• options.context (object) - Additional context

Returns: Promise<T> - The tool output (with PII automatically redacted)

Throws: EntryError on failure

const customer = await entry.invoke("get_customer", {
  params: { id: "123" }
});

const invoice = await entry.invoke("get_invoice", {
  params: { customerId: "123" }
});

agent.invokeWithMeta(toolName, options?)

Same as invoke but also returns metadata including redaction info.

const { output, meta } = await entry.invokeWithMeta("get_customer", {
  params: { id: "123" }
});

console.log(meta.requestId);   // Unique request ID
console.log(meta.latencyMs);   // Request latency
console.log(meta.redactions);  // [{ type: "email", count: 1 }]

agent.invokeRaw(toolName, options?)

Returns the raw response without throwing on errors. Useful if you want to handle errors yourself.

Error Handling

import { Entry, EntryError } from "@entrys/client";

try {
  await entry.invoke("get_customer", { params: { id: "123" } });
} catch (err) {
  if (err instanceof EntryError) {
    console.log(err.code);      // 'TOOL_NOT_FOUND', 'UNAUTHORIZED', etc.
    console.log(err.message);   // Human-readable message
    console.log(err.requestId); // For debugging
  }
}

Error Codes

• TOOL_NOT_FOUND - Tool doesn't exist in this environment
• UNAUTHORIZED - Agent not authorized for this tool
• RATE_LIMITED - Rate limit exceeded (60 req/min)
• VALIDATION_ERROR - Invalid parameters
• UPSTREAM_ERROR - The upstream API returned an error