Define agents and tools

​

createAgent options

• name: string: required display name. The Git folder determines identity.
• description?: string: description for discovery.
• instructions?: string: nonblank instructions, up to 128 KiB. Inline text overrides the package-local AGENT.md; EigenPal does not concatenate them. If omitted, EigenPal reads that file from the run’s pinned source commit.
• model?: string: configured organization model identifier. Omit it to use the platform’s configured selection.
• inputSchema?: object schema for run input.
• outputSchema?: object schema for the final answer and inferred evaluator types.
• tools?: map of model-facing names to createTool definitions. Up to 16 custom tools. Built-in names such as read, bash, finish and resource_read are reserved.
• resources?: map of imported knowledge, rule and template definitions. Keys become aliases in resource tools. See Shared resources.
• guards?: array of execution limits, described below. At most 32 entries.
• triggers?: API and email trigger configuration, described below.

​

Schema types and validation

import type { InferInput, InferOutput } from '@eigenpal/automations';
import invoice from './agent.ts';

type InvoiceInput = InferInput<typeof invoice>;
type InvoiceOutput = InferOutput<typeof invoice>;

​

createTool options

import { createTool } from '@eigenpal/automations';
import { z } from 'zod';

export const calculateTotal = createTool({
  description: 'Calculate invoice tax and total.',
  inputSchema: z.object({ subtotal: z.number().nonnegative(), rate: z.number().nonnegative() }),
  outputSchema: z.strictObject({ tax: z.number(), total: z.number() }),
  execute: ({ subtotal, rate }) => {
    const tax = Math.round(subtotal * rate * 100) / 100;
    return { tax, total: subtotal + tax };
  },
});

• description: nonblank explanation of when the model should use the tool.
• inputSchema: object schema; validates arguments before invocation and infers the execute parameter.
• outputSchema: object schema; validates the returned result and checks its TypeScript shape.
• execute: synchronous callback returning the result object. Local helpers and constants can be bundled. It receives no host filesystem, network or secrets.

​

Execution guards

guards: [maxTurns(10), maxTimeMs(60_000), maxCredits(100)];

• maxTurns(n): maximum model requests, including retries.
• maxTimeMs(n): maximum active execution time, including preparation. Time parked for human review does not count.
• maxCredits(n): maximum model credits. One credit is one cent; sandbox compute is billed separately. Use the time guard to bound active sandbox execution.

​

Triggers

triggers: {
  api: true,
  email: {
    enabled: true,
    aliases: [{
      address: 'invoices@example.com',
      allowlist: ['accounts@example.com'],
      requireSenderAuth: true,
      replyConfig: { on: 'always' },
      enabled: true,
    }],
  },
}

​

Immutable composition