omnicall-agent 0.1.0

package/README.md

@@ -0,0 +1,55 @@
+# omnicall-agent
+
+**An autonomous AI agent in ~150 lines — with no API keys.** The brain (248 LLMs) and the tools (live web search) are one keyless, pay-per-call endpoint: [Omnicall](https://omnicall.gocreativeai.com). Pay per call in USDC via x402 on Base/Solana, or with a `gck_` credit key. It runs **free out of the box**.
+
+```bash
+npx omnicall-agent "What is the x402 protocol and who is building on it?"
+```
+
+That's it — no OpenAI key, no Anthropic key, no signup. The agent picks a model, searches the web when it needs facts, and answers.
+
+## Why this exists
+
+Most "agent starter kits" make you sign up for an LLM provider, paste a key, add a billing card, then wire up a separate search API with *its* key. **omnicall-agent needs none of that.** One endpoint gives an agent every model plus tools, and it pays per call — so you can ship an autonomous agent with zero accounts and pay only for what it actually does.
+
+## Two modes
+
+| Mode | Setup | What you get |
+|------|-------|--------------|
+| **Free** | nothing | Single-shot answer on the free tier. Instant. |
+| **Agentic** | `OMNICALL_KEY` | Full reason→search→verify loop over 248 premium models + live web search. |
+
+```bash
+# Free — runs immediately
+npx omnicall-agent "Summarize the latest on agent payments"
+
+# Agentic — unlock tools + premium models with a credit key (or x402 wallet)
+export OMNICALL_KEY=gck_your_key      # get one at https://omnicall.gocreativeai.com
+npx omnicall-agent "Research USDC stablecoin volume trends and cite sources"
+```
+
+### Environment
+
+| Var | Default | Purpose |
+|-----|---------|---------|
+| `OMNICALL_KEY` | _(none)_ | `gck_` credit key or x402-funded key. Unlocks the agentic loop. |
+| `OMNICALL_MODEL` | `auto` | Model id. `auto` routes to the cheapest capable model. |
+| `OMNICALL_URL` | `https://omnicall.gocreativeai.com` | Gateway base URL. |
+
+## How it works
+
+The agent is a simple loop against Omnicall's OpenAI-compatible gateway:
+
+1. Send the goal to a model (`POST /v1/chat/completions`, `model: "auto"`).
+2. If the model asks to look something up (`SEARCH: <query>`), the agent calls `GET /v1/web/<query>` and feeds the result back.
+3. Repeat until the model returns a `FINAL:` answer.
+
+Every call is metered and paid per-use — no subscription, no idle cost.
+
+## Build your own on the same rails
+
+- OpenAI SDK drop-in: `base_url="https://omnicall.gocreativeai.com/v1"`
+- MCP server: `npx -y omnicall-mcp` (or `claude mcp add --transport http omnicall https://omnicall.gocreativeai.com/mcp`)
+- 248 models, image/video/voice/music, and live crypto/markets/web/research — all keyless, all pay-per-call.
+
+MIT licensed.

package/index.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+// omnicall-agent — a tiny autonomous research agent that runs entirely on Omnicall.
+// No OpenAI key, no Anthropic key, no signup. The agent's brain (248 LLMs) and its
+// web-search tool are all one keyless, pay-per-call endpoint. Pay per call in USDC
+// via x402, or with a gck_ credit key. Runs free out of the box.
+//
+//   npx omnicall-agent "What is the x402 protocol and who uses it?"
+//
+// Optional env:
+//   OMNICALL_KEY   gck_ credit key (or any x402-funded key) -> unlocks the full
+//                  agentic loop with live web search + 248 premium models.
+//   OMNICALL_MODEL model id (default "auto" -> Omnicall routes to the cheapest capable model)
+//   OMNICALL_URL   override the gateway (default https://omnicall.gocreativeai.com)
+
+const BASE = (process.env.OMNICALL_URL || 'https://omnicall.gocreativeai.com').replace(/\/$/, '');
+const KEY = process.env.OMNICALL_KEY || '';
+const MODEL = process.env.OMNICALL_MODEL || 'auto';
+const MAX_STEPS = 6;
+
+const goal = process.argv.slice(2).join(' ').trim();
+if (!goal) {
+  console.error('Usage: omnicall-agent "<your question or task>"');
+  process.exit(1);
+}
+
+const log = (...a) => console.error('\x1b[2m' + a.join(' ') + '\x1b[0m'); // dim, to stderr
+
+async function chat(messages) {
+  const r = await fetch(`${BASE}/v1/chat/completions`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', ...(KEY ? { Authorization: `Bearer ${KEY}` } : {}) },
+    body: JSON.stringify({ model: MODEL, messages }),
+  });
+  if (!r.ok) throw new Error(`gateway ${r.status}: ${(await r.text()).slice(0, 200)}`);
+  const j = await r.json();
+  return j.choices?.[0]?.message?.content?.trim() || '';
+}
+
+// Multi-platform research (web + github + more) condensed into a compact text block.
+async function research(query) {
+  try {
+    const r = await fetch(`${BASE}/v1/research/${encodeURIComponent(query)}`, {
+      headers: KEY ? { Authorization: `Bearer ${KEY}` } : {},
+    });
+    if (!r.ok) return `(search unavailable: ${r.status})`;
+    const j = await r.json();
+    const out = [];
+    const res = j.results || {};
+    const w = res.web || {};
+    if (w.answer || w.heading) out.push(`web: ${[w.heading, w.answer].filter(Boolean).join(' — ')}`);
+    if (Array.isArray(res.github?.repos)) {
+      for (const repo of res.github.repos.slice(0, 5)) {
+        out.push(`github: ${repo.name} (${repo.stars}★) — ${repo.description || ''} ${repo.url || ''}`.trim());
+      }
+    }
+    // Fold in any other platform that returned a short answer/title.
+    for (const [name, v] of Object.entries(res)) {
+      if (name === 'web' || name === 'github' || !v || typeof v !== 'object') continue;
+      const snip = v.answer || v.summary || v.title || v.text;
+      if (snip) out.push(`${name}: ${String(snip).slice(0, 240)}`);
+    }
+    return out.length ? out.join('\n').slice(0, 2000) : '(no useful results — answer from your own knowledge)';
+  } catch (e) {
+    return `(search error: ${e.message})`;
+  }
+}
+
+// ---- Free, zero-setup mode: single-shot answer on the free tier ----
+async function freeMode() {
+  log(`[omnicall-agent] free mode (no key) — answering with the free tier.`);
+  const r = await fetch(`${BASE}/v1/ai/free/${encodeURIComponent(goal)}`);
+  const j = await r.json();
+  console.log('\n' + (j.response || JSON.stringify(j)));
+  console.log(
+    `\n\x1b[2m— answered free on ${j.model || 'free tier'}. ` +
+      `Set OMNICALL_KEY (a gck_ credit key) to unlock live web search + 248 premium models ` +
+      `and the full agentic loop. Keyless x402 also works.\x1b[0m`
+  );
+}
+
+// ---- Full agentic loop: reason + search until done (needs a key) ----
+async function agentMode() {
+  log(`[omnicall-agent] agentic mode on ${BASE} (model: ${MODEL}).`);
+  const messages = [
+    {
+      role: 'system',
+      content:
+        'You are an autonomous research agent powered by Omnicall. Work step by step toward the user goal. ' +
+        'When you need fresh facts, output ONE line exactly: SEARCH: <query> and nothing else. ' +
+        'You will then receive RESULT: <data>. When you can fully answer, output: FINAL: <answer>. ' +
+        'Prefer to verify with at least one search before a FINAL answer.',
+    },
+    { role: 'user', content: goal },
+  ];
+
+  let searches = 0;
+  const MAX_SEARCHES = 3;
+  for (let step = 1; step <= MAX_STEPS; step++) {
+    const out = await chat(messages);
+    // Strip markdown emphasis/backticks so directives parse even when the model bolds them.
+    const clean = out.replace(/[*`]/g, '');
+    const searchMatch = clean.match(/SEARCH:\s*(.+)/i);
+    const finalMatch = clean.match(/FINAL:\s*([\s\S]+)/i);
+
+    // Prefer FINAL unless a SEARCH clearly comes first.
+    if (finalMatch && (!searchMatch || finalMatch.index <= searchMatch.index)) {
+      console.log('\n' + finalMatch[1].trim());
+      log(`\n[done in ${step} step(s), ${searches} search(es) — all calls billed per-use on Omnicall]`);
+      return;
+    }
+    if (searchMatch && searches < MAX_SEARCHES) {
+      const q = searchMatch[1].trim().replace(/^["']|["']$/g, '');
+      searches++;
+      log(`  → search ${searches}/${MAX_SEARCHES}: ${q}`);
+      const result = await research(q);
+      messages.push({ role: 'assistant', content: out });
+      const nudge =
+        searches >= MAX_SEARCHES
+          ? ' You have used your last search — answer now with FINAL: <answer>.'
+          : '';
+      messages.push({ role: 'user', content: `RESULT: ${result}${nudge}` });
+      continue;
+    }
+    // Out of searches, or a plain answer with no directive — wrap up.
+    const answer = finalMatch ? finalMatch[1].trim() : clean.replace(/SEARCH:.*/i, '').trim() || out.trim();
+    console.log('\n' + answer);
+    log(`\n[done in ${step} step(s), ${searches} search(es) — all calls billed per-use on Omnicall]`);
+    return;
+  }
+  log('[reached step limit]');
+}
+
+(KEY ? agentMode() : freeMode()).catch((e) => {
+  console.error('\x1b[31m' + e.message + '\x1b[0m');
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "omnicall-agent",
+  "version": "0.1.0",
+  "description": "A tiny autonomous research agent that runs entirely on Omnicall — 248 LLMs + live web search through one keyless, pay-per-call endpoint. No OpenAI/Anthropic key, no signup.",
+  "bin": {
+    "omnicall-agent": "index.js"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ai-agent",
+    "autonomous-agent",
+    "omnicall",
+    "x402",
+    "pay-per-call",
+    "llm",
+    "openai-compatible",
+    "agent",
+    "keyless",
+    "blockrun-alternative"
+  ],
+  "homepage": "https://omnicall.gocreativeai.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ColinHughes2121/omnicall-agent.git"
+  },
+  "license": "MIT",
+  "author": "GoCreative AI"
+}