@geenius/agent

Composable agent runtime, UI bindings, and Convex persistence helpers for the Geenius ecosystem.

Install

pnpm add @geenius/agent

Subpath Imports

import { AgentRunner, defineTool } from '@geenius/agent'
import { AgentMemory, AgentError } from '@geenius/agent/shared'
import { AgentProvider, AgentInput, AgentPanel, useAgent } from '@geenius/agent/react'
import { AgentPanel as ReactCssAgentPanel } from '@geenius/agent/react-css'
import { AgentProvider as SolidAgentProvider, createAgent } from '@geenius/agent/solidjs'
import { AgentPanel as SolidCssAgentPanel } from '@geenius/agent/solidjs-css'
import { agentTables, createSession, listSessions } from '@geenius/agent/convex'

Basic Usage

import { AgentInput, AgentPanel, AgentProvider, useAgent } from '@geenius/agent/react'

function AgentWorkbench() {
  const agent = useAgent({
    callLLM: async (messages, tools) => {
      const response = await fetch('/api/agent', {
        method: 'POST',
        headers: { 'content-type': 'application/json' },
        body: JSON.stringify({ messages, tools }),
      })

      return response.json()
    },
  })

  return (
    <section className="space-y-4">
      <AgentPanel
        steps={agent.steps}
        isRunning={agent.isRunning}
        result={agent.result}
        error={agent.error}
      />
      <AgentInput onSubmit={agent.run} isRunning={agent.isRunning} />
    </section>
  )
}

export function App() {
  return (
    <AgentProvider
      config={{ model: 'gpt-5.4', maxSteps: 8 }}
      callLLM={async () => ({ content: 'Acknowledged. Ready for the next step.' })}
    >
      <AgentWorkbench />
    </AgentProvider>
  )
}

Variant Surface

• @geenius/agent: shared runtime, validation, tool contracts, planning, licensing, and orchestration utilities.
• @geenius/agent/shared: direct access to the shared runtime and low-level types when you do not want a UI binding.
• @geenius/agent/react: Tailwind-oriented React provider, hooks, components, and pages.
• @geenius/agent/react-css: standalone React components styled with vanilla CSS files.
• @geenius/agent/solidjs: Tailwind-oriented SolidJS provider, primitives, components, and pages.
• @geenius/agent/solidjs-css: standalone SolidJS components styled with vanilla CSS files.
• @geenius/agent/convex: schema, typed queries, typed mutations, and table exports for Convex-backed persistence.

Storybook

Local Storybook review apps are included for both frameworks and surface the Tailwind and vanilla CSS variants side by side.

• React review app: pnpm --filter ./apps/storybook-react dev
• SolidJS review app: pnpm --filter ./apps/storybook-solidjs dev

Package Contract

• The root package is ESM-only and publishes explicit subpath exports for every supported variant.
• Framework variants depend on the shared runtime through published workspace subpaths rather than private source paths.
• The Convex variant isolates convex to @geenius/agent/convex, so non-Convex consumers do not pull Convex into their dependency tree.
• Build, lint, and test workflows are package-scoped; Storybook apps are verified separately as review surfaces.

License

Proprietary. See LICENSE.