ag-common

Various reusable TypeScript libraries for common, API (AWS Cognito and AWS CDK), and React UI use cases.

The provider-neutral AI helpers are exported from ag-common and support text, multimodal input, typed media output, and optional direct Codex endpoints.

import { createAIClient } from "ag-common";

const ai = createAIClient({
  endpoint: {
    protocol: "codex",
    url: "http://192.168.0.205:4501/v1",
    token: process.env.CODEX_TOKEN!,
  },
});

const result = await ai.generate({
  input: [{ role: "user", content: [{ type: "text", text: "Describe this image." }] }],
  output: ["text"],
  model: "local-model",
});

const models = await ai.models();
const imageModels = models.filter((model) => model.outputModalities?.includes("image"));

Codex URLs must be direct private LAN IPv4 addresses. The client sends the version-one job protocol under /v1, polls bounded job status, and keeps one idempotency key for retries. Omitting endpoint uses the configured Google AI adapter and its API keys. models() returns provider-neutral metadata with the model id and any input/output modalities, reasoning efforts, preferences, web search, default, and readiness fields the provider exposes. Capability fields may be omitted when a provider does not publish them.

Install

npm i -S ag-common

Usage

Please raise any issues or requests you might have here

Testing

pnpm test runs the deterministic tests without live AWS resources. The legacy AWS checks are opt-in through pnpm test:integration:aws and require the existing ag-common-tests DynamoDB table and S3 bucket. The DynamoDB check wipes that dedicated test table; do not run it against shared application data.

License

ISC