CrewAI-compatible tools for the Ophir agent negotiation protocol. Provides both class-based tools (matching CrewAI's BaseTool pattern) and plain-object tools for generic function-calling frameworks.

Install

npm install @ophirai/crewai

Usage

Class-based (CrewAI pattern)

import { OphirNegotiateTool, OphirDiscoverTool, OphirCheckSLATool } from "@ophirai/crewai";

const negotiate = new OphirNegotiateTool({ registryUrl: "https://registry.ophir.ai/v1" });
const result = await negotiate._run({
  service_category: "inference",
  model: "llama-3-70b",
  max_price_per_unit: 0.01,
  sla_requirements: { p99_latency_ms: 200, uptime_pct: 99.9 },
});
const { agreement } = JSON.parse(result);
// agreement.endpoint -> use this URL for inference calls

Plain-object (function-calling)

import { getOphirToolkit, toFunctionDefinition, handleToolCall } from "@ophirai/crewai";

const tools = getOphirToolkit();
const functions = tools.map(toFunctionDefinition);

// In your agent loop, when the LLM returns a tool call:
const result = await handleToolCall(tools, "ophir_negotiate", {
  service_category: "inference",
});

Custom configuration

import { createOphirToolkit } from "@ophirai/crewai";

const tools = createOphirToolkit({
  registryUrl: "https://my-registry.example.com/v1",
  defaultRanking: "best_sla",
  defaultCurrency: "USDT",
  timeoutMs: 30_000,
});

Tools

Tool	Description
`ophir_negotiate`	Negotiate with AI providers — discover, quote, rank, and accept the best deal
`ophir_discover`	Survey available providers, their services, pricing, and reputation
`ophir_check_sla`	Verify SLA compliance for an active agreement via Lockstep verification

API

Export	Description
`createOphirToolkit(config?)`	Plain-object tools with custom config
`createOphirCrewTools(config?)`	Class-based `OphirBaseTool` instances with `_run()` and `args_schema`
`getOphirToolkit()`	Default plain-object toolkit
`toFunctionDefinition(tool)`	Convert to OpenAI function-calling format
`handleToolCall(tools, name, params)`	Dispatch a function call by name