agent-relay-providers 0.104.0

package/claude.ts

@@ -0,0 +1,129 @@
+import { registerProvider } from "./registry.js";
+import type { ProviderManifest, ProviderModelCapabilities, ProviderModelLimits } from "./types.js";
+
+const CLAUDE_LOW_TO_MAX = ["low", "medium", "high", "max"];
+const CLAUDE_LOW_TO_XHIGH_MAX = ["low", "medium", "high", "xhigh", "max"];
+const CONTEXT_200K = { value: 200_000, source: "catalog", confidence: "declared" } as const;
+const CONTEXT_1M = { value: 1_000_000, source: "catalog", confidence: "declared" } as const;
+const CODE_MODEL_CAPABILITIES: ProviderModelCapabilities = {
+  modalities: {
+    input: { text: true, image: true },
+    output: { text: true },
+  },
+  tools: {
+    code: true,
+    review: true,
+    debug: true,
+    refactor: true,
+  },
+  source: "catalog",
+  confidence: "declared",
+};
+const quotaWindows = [
+  { name: "five_hour", unit: "%", reset: true },
+  { name: "seven_day", unit: "%", reset: true },
+] as const;
+
+function codeModel(limits?: ProviderModelLimits): Pick<NonNullable<ProviderManifest["catalog"]["models"][number]>, "limits" | "capabilities"> {
+  return {
+    ...(limits ? { limits } : {}),
+    capabilities: CODE_MODEL_CAPABILITIES,
+  };
+}
+
+export const claudeProviderManifest = {
+  id: "claude",
+  label: "Claude",
+  icon: "🟠",
+  launch: {
+    managedPolicyPrompt: {
+      alwaysOn: "append-system-prompt",
+    },
+  },
+  catalog: {
+    defaultModel: "sonnet-4.6",
+    models: [
+      { alias: "fable-5", label: "Fable 5", providerModel: "claude-fable-5", efforts: CLAUDE_LOW_TO_XHIGH_MAX, defaultEffort: "medium", unavailable: "suspended by export-control directive, 2026-06-12", ...codeModel({ contextWindowTokens: CONTEXT_1M }) },
+      { alias: "opus-4.8", label: "Opus 4.8", providerModel: "claude-opus-4-8", efforts: CLAUDE_LOW_TO_XHIGH_MAX, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+      { alias: "opus-4.8[1m]", label: "Opus 4.8 1M", providerModel: "claude-opus-4-8[1m]", efforts: CLAUDE_LOW_TO_XHIGH_MAX, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_1M }) },
+      { alias: "opus-4.7", label: "Opus 4.7", providerModel: "claude-opus-4-7", efforts: CLAUDE_LOW_TO_XHIGH_MAX, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+      { alias: "opus-4.7[1m]", label: "Opus 4.7 1M", providerModel: "claude-opus-4-7[1m]", efforts: CLAUDE_LOW_TO_XHIGH_MAX, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_1M }) },
+      { alias: "opus-4.6", label: "Opus 4.6", providerModel: "claude-opus-4-6", efforts: CLAUDE_LOW_TO_MAX, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+      { alias: "opus-4.6[1m]", label: "Opus 4.6 1M", providerModel: "claude-opus-4-6[1m]", efforts: CLAUDE_LOW_TO_MAX, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_1M }) },
+      { alias: "sonnet-4.6", label: "Sonnet 4.6", providerModel: "claude-sonnet-4-6", efforts: CLAUDE_LOW_TO_MAX, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+      { alias: "sonnet-4.6[1m]", label: "Sonnet 4.6 1M", providerModel: "claude-sonnet-4-6[1m]", efforts: CLAUDE_LOW_TO_MAX, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_1M }) },
+      { alias: "haiku", label: "Haiku", providerModel: "haiku", efforts: [], ...codeModel() },
+    ],
+  },
+  quotaWindows: [...quotaWindows],
+  capabilityDefaults: {
+    lifecycle: {
+      managed: true,
+      shutdownHard: { when: "headless", value: true, otherwise: false },
+      restartHard: { when: "headless", value: true, otherwise: false },
+      semanticStatus: true,
+      reconnect: true,
+    },
+    session: {
+      fileRead: true,
+      fileWrite: { when: "approval:not-read-only", value: true, otherwise: false },
+      shell: true,
+      shellMode: { open: "unrestricted", guarded: "guarded", readOnly: "read-only-guarded" },
+    },
+    context: {
+      managed: "headless",
+      compact: { when: "headless", value: true, otherwise: false },
+      clear: { when: "headless", value: true, otherwise: false },
+      inject: true,
+      resumePreference: ["native", "clear-inject", "none"],
+    },
+    quota: {
+      supported: true,
+      source: "probe",
+      unit: "%",
+      windows: [...quotaWindows],
+    },
+    terminal: {
+      mode: "live",
+      condition: "headless",
+      live: { read: true, write: true },
+    },
+    liveSession: {
+      capture: true,
+      inject: true,
+      interrupt: true,
+      promptEcho: true,
+      reasoning: true,
+      slashCommands: true,
+    },
+  },
+  slashCommands: ["/clear", "/compact", "/model", "/help"],
+  resume: { supported: true, idFormat: "uuid-v4", idPattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" },
+  home: { configDir: ".claude", envPrefix: "CLAUDE", configDirEnvVar: "CLAUDE_CONFIG_DIR", quotaCredentialFile: ".credentials.json", authItems: [".credentials.json", "statsig"] },
+  provisioning: {
+    pluginManifestPath: ".claude-plugin/plugin.json",
+    bundledPlugin: {
+      ref: "agent-relay-claude-plugin",
+      dir: "runner/plugins/claude",
+      title: "Agent Relay Claude plugin",
+      description: "Bundled Agent Relay Claude plugin, materialized whole through the provisioning registry.",
+      omitFiles: ["monitors/relay-monitor.provisioned.mjs"],
+      fileOverrides: [{ path: "monitors/relay-monitor.ts", sourcePath: "monitors/relay-monitor.provisioned.mjs" }],
+    },
+  },
+  upgrade: {
+    packages: ["agent-relay-runner", "agent-relay-plugin"],
+    detectPackages: ["agent-relay-runner"],
+    detectCommands: ["claude"],
+  },
+  probe: {
+    command: "claude",
+    args: ["--version"],
+    healthCheck: "claude --version",
+    featureChecks: [{ name: "rig", command: "claude-rig", homeDir: ".claude-rig" }],
+  },
+  quotaPoll: { strategy: "none" },
+  shim: { kind: "claude-relay" },
+} satisfies ProviderManifest;
+
+registerProvider(claudeProviderManifest);

package/codex.ts

@@ -0,0 +1,125 @@
+import { registerProvider } from "./registry.js";
+import type { ProviderManifest, ProviderModelCapabilities, ProviderModelLimits } from "./types.js";
+
+const CODEX_REASONING = ["low", "medium", "high", "xhigh"];
+const CONTEXT_200K = { value: 200_000, source: "catalog", confidence: "declared" } as const;
+const CODE_MODEL_CAPABILITIES: ProviderModelCapabilities = {
+  modalities: {
+    input: { text: true, image: true },
+    output: { text: true },
+  },
+  tools: {
+    code: true,
+    review: true,
+    debug: true,
+    refactor: true,
+  },
+  source: "catalog",
+  confidence: "declared",
+};
+const quotaWindows = [
+  { name: "primary", unit: "%", reset: true },
+  { name: "secondary", unit: "%", reset: true },
+] as const;
+
+function codeModel(limits?: ProviderModelLimits): Pick<NonNullable<ProviderManifest["catalog"]["models"][number]>, "limits" | "capabilities"> {
+  return {
+    ...(limits ? { limits } : {}),
+    capabilities: CODE_MODEL_CAPABILITIES,
+  };
+}
+
+export const codexProviderManifest = {
+  id: "codex",
+  label: "Codex",
+  icon: "⌨️",
+  launch: {
+    managedPolicyPrompt: {
+      alwaysOn: "prompt",
+    },
+  },
+  catalog: {
+    defaultModel: "gpt-5.5",
+    models: [
+      { alias: "gpt-5.5", label: "GPT-5.5", providerModel: "gpt-5.5", efforts: CODEX_REASONING, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+      { alias: "gpt-5.4", label: "GPT-5.4", providerModel: "gpt-5.4", efforts: CODEX_REASONING, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+      { alias: "gpt-5.4-mini", label: "GPT-5.4 Mini", providerModel: "gpt-5.4-mini", efforts: CODEX_REASONING, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+      { alias: "gpt-5.3-codex", label: "GPT-5.3 Codex", providerModel: "gpt-5.3-codex", efforts: CODEX_REASONING, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+      { alias: "gpt-5.3-codex-spark", label: "GPT-5.3 Codex Spark", providerModel: "gpt-5.3-codex-spark", efforts: CODEX_REASONING, defaultEffort: "high", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+      { alias: "gpt-5.2", label: "GPT-5.2", providerModel: "gpt-5.2", efforts: CODEX_REASONING, defaultEffort: "medium", ...codeModel({ contextWindowTokens: CONTEXT_200K }) },
+    ],
+  },
+  quotaWindows: [...quotaWindows],
+  capabilityDefaults: {
+    lifecycle: {
+      managed: true,
+      shutdownHard: true,
+      restartHard: true,
+      semanticStatus: true,
+      reconnect: true,
+    },
+    session: {
+      fileRead: true,
+      fileWrite: { when: "approval:not-read-only", value: true, otherwise: false },
+      shell: { when: "approval:not-read-only", value: true, otherwise: false },
+      shellMode: { open: "unrestricted", guarded: "guarded", readOnly: "none" },
+    },
+    context: {
+      managed: "always",
+      compact: true,
+      clear: true,
+      inject: true,
+      resumePreference: ["native", "clear-inject", "none"],
+    },
+    quota: {
+      supported: true,
+      source: "probe",
+      unit: "%",
+      windows: [...quotaWindows],
+    },
+    terminal: {
+      mode: "attach",
+      attach: {
+        create: true,
+        read: true,
+        write: true,
+        detach: true,
+      },
+    },
+    liveSession: {
+      capture: true,
+      inject: true,
+      interrupt: true,
+      promptEcho: true,
+      reasoning: true,
+      slashCommands: true,
+    },
+  },
+  slashCommands: ["/compact", "/new"],
+  resume: { supported: true, idFormat: "codex-thread-id", idPattern: "[\\w-]+" },
+  home: { configDir: ".codex", envPrefix: "CODEX", configDirEnvVar: "CODEX_HOME", quotaCredentialFile: "auth.json", authItems: ["auth.json", "installation_id"] },
+  provisioning: {
+    pluginManifestPath: ".codex-plugin/plugin.json",
+    bundledSkills: {
+      refPrefix: "agent-relay-codex-",
+      dir: "runner/plugins/codex/skills",
+      titlePrefix: "Agent Relay Codex skill: ",
+      description: "Bundled Agent Relay Codex skill, materialized through the provisioning registry.",
+      entryFile: "SKILL.md",
+    },
+  },
+  upgrade: {
+    packages: ["agent-relay-runner", "agent-relay-codex"],
+    detectPackages: ["agent-relay-runner", "agent-relay-codex"],
+    detectCommands: ["codex-relay", "agent-relay-runner"],
+  },
+  probe: {
+    command: "codex",
+    args: ["--version"],
+    healthCheck: "codex --version",
+  },
+  quotaPoll: { strategy: "codex-app-server" },
+  shim: { kind: "codex-relay", extraBinPaths: ["codex/bin/codex"], cleanLegacyHooks: true },
+} satisfies ProviderManifest;
+
+registerProvider(codexProviderManifest);

package/index.ts

@@ -0,0 +1,5 @@
+import "./claude.js";
+import "./codex.js";
+
+export * from "./registry.js";
+export * from "./types.js";

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "agent-relay-providers",
+  "version": "0.104.0",
+  "description": "Serializable provider manifests for Agent Relay deploy targets",
+  "type": "module",
+  "license": "AGPL-3.0-or-later",
+  "author": "Edin Mujkanovic <edin@exelerus.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edimuj/agent-relay.git",
+    "directory": "providers"
+  },
+  "main": "./index.ts",
+  "types": "./index.ts",
+  "exports": {
+    ".": {
+      "types": "./index.ts",
+      "import": "./index.ts"
+    },
+    "./types": {
+      "types": "./types.ts",
+      "import": "./types.ts"
+    }
+  },
+  "files": [
+    "*.ts"
+  ]
+}

package/registry.ts

@@ -0,0 +1,56 @@
+import type { ProviderManifest } from "./types.js";
+
+const PROVIDER_ID_RE = /^[a-z][a-z0-9-]*$/;
+const manifests = new Map<string, ProviderManifest>();
+
+export function registerProvider(manifest: ProviderManifest): void {
+  if (!PROVIDER_ID_RE.test(manifest.id)) {
+    throw new Error(`invalid provider id: ${manifest.id}`);
+  }
+  if (!manifest.label.trim()) {
+    throw new Error(`provider ${manifest.id} is missing a label`);
+  }
+  if (!manifest.icon.trim()) {
+    throw new Error(`provider ${manifest.id} is missing an icon`);
+  }
+  if (manifests.has(manifest.id)) {
+    throw new Error(`provider already registered: ${manifest.id}`);
+  }
+  manifests.set(manifest.id, manifest);
+}
+
+export function getManifest(id: string): ProviderManifest | undefined {
+  return manifests.get(id);
+}
+
+export function getAllManifests(): ProviderManifest[] {
+  return [...manifests.values()];
+}
+
+export function isValidResumeId(providerId: string, id: string): boolean {
+  if (!id) return false;
+  const manifest = manifests.get(providerId);
+  if (!manifest?.resume?.supported) return false;
+  const pattern = manifest.resume.idPattern;
+  if (!pattern) return true;
+  return new RegExp(`^${pattern}$`, "i").test(id);
+}
+
+export function resumeLogExtractionRe(providerId: string): RegExp | undefined {
+  const manifest = manifests.get(providerId);
+  if (!manifest?.resume?.supported || !manifest.resume.idPattern || !manifest.probe?.command) return undefined;
+  return new RegExp(`\\b${manifest.probe.command}\\s+--resume\\s+(${manifest.resume.idPattern})\\b`, "gi");
+}
+
+type AccountKeyAliasResolver = (accountKey: string) => string[];
+const accountKeyAliasResolvers = new Map<string, AccountKeyAliasResolver>();
+
+export function registerAccountKeyAliases(providerId: string, resolver: AccountKeyAliasResolver): void {
+  accountKeyAliasResolvers.set(providerId, resolver);
+}
+
+export function quotaAccountKeyAliases(providerId: string, accountKey: string): string[] {
+  return accountKeyAliasResolvers.get(providerId)?.(accountKey) ?? [];
+}
+
+export const PROVIDER_MANIFESTS: ReadonlyMap<string, ProviderManifest> = manifests;

package/types.ts

@@ -0,0 +1,244 @@
+export type ProviderCatalogValueSource = "catalog" | "provider" | "runtime" | "override";
+export type ProviderCatalogConfidence = "declared" | "verified" | "estimated" | "unknown";
+
+export interface ProviderCatalogValue<T> {
+  value: T;
+  source: ProviderCatalogValueSource;
+  confidence: ProviderCatalogConfidence;
+  lastUpdatedAt?: number;
+}
+
+export interface ProviderModelLimits {
+  contextWindowTokens?: ProviderCatalogValue<number>;
+  maxOutputTokens?: ProviderCatalogValue<number>;
+}
+
+export interface ProviderContextThreshold {
+  selfCompactUtilization: number;
+  warnUtilization?: number;
+  hardBackstopUtilization?: number;
+}
+
+export interface ProviderModelModalities {
+  input: {
+    text: boolean;
+    image?: boolean;
+    audio?: boolean;
+    video?: boolean;
+    pdf?: boolean;
+  };
+  output: {
+    text: boolean;
+    image?: boolean;
+    audio?: boolean;
+    video?: boolean;
+  };
+}
+
+export interface ProviderModelToolCapabilities {
+  code?: boolean;
+  review?: boolean;
+  debug?: boolean;
+  refactor?: boolean;
+  shell?: boolean;
+  fileRead?: boolean;
+  fileWrite?: boolean;
+  webSearch?: boolean;
+  imageGeneration?: boolean;
+  imageEditing?: boolean;
+}
+
+export interface ProviderModelCapabilities {
+  modalities: ProviderModelModalities;
+  tools?: ProviderModelToolCapabilities;
+  source: ProviderCatalogValueSource;
+  confidence: ProviderCatalogConfidence;
+  lastUpdatedAt?: number;
+}
+
+export interface ProviderModelEntry {
+  alias: string;
+  label: string;
+  providerModel: string;
+  efforts: string[];
+  defaultEffort?: string;
+  disabled?: boolean;
+  unavailable?: string;
+  limits?: ProviderModelLimits;
+  contextThreshold?: ProviderContextThreshold;
+  capabilities?: ProviderModelCapabilities;
+}
+
+export interface QuotaWindowDescriptor {
+  name: string;
+  unit: "%" | string;
+  reset: boolean;
+  description?: string;
+}
+
+export interface ProviderProbeFeatureCheck {
+  name: string;
+  command?: string;
+  homeDir?: string;
+}
+
+export interface ProviderProbeDescriptor {
+  command?: string;
+  args?: string[];
+  healthCheck?: string;
+  featureChecks?: ProviderProbeFeatureCheck[];
+}
+
+export interface ProviderHomeDescriptor {
+  configDir?: string;
+  envPrefix?: string;
+  /** The environment variable that sets the provider's config home directory
+   *  (e.g. "CLAUDE_CONFIG_DIR", "CODEX_HOME"). */
+  configDirEnvVar?: string;
+  quotaCredentialFile?: string;
+  /** Auth-related items to symlink from the host provider home into an isolated
+   *  home so the provider is launch-ready without a re-login. */
+  authItems?: string[];
+}
+
+export interface ProviderUpgradeDescriptor {
+  packages: string[];
+  detectPackages?: string[];
+  detectCommands?: string[];
+}
+
+export interface ProviderQuotaPollDescriptor {
+  strategy: "none" | "codex-app-server";
+}
+
+export interface ProviderShimDescriptor {
+  kind: "claude-relay" | "codex-relay";
+  extraBinPaths?: string[];
+  cleanLegacyHooks?: boolean;
+}
+
+export type ProviderCapabilityCondition =
+  | "always"
+  | "never"
+  | "headless"
+  | "interactive"
+  | "approval:read-only"
+  | "approval:not-read-only"
+  | "adapter:compact-supports-instructions"
+  | "adapter:clear-context";
+
+export interface ConditionalBooleanDefault {
+  when: ProviderCapabilityCondition;
+  value: boolean;
+  otherwise: boolean;
+}
+
+export type BooleanCapabilityDefault = boolean | ConditionalBooleanDefault;
+
+export interface ProviderCapabilityDefaults {
+  lifecycle: {
+    managed: boolean;
+    shutdownHard: BooleanCapabilityDefault;
+    restartHard: BooleanCapabilityDefault;
+    semanticStatus: boolean;
+    reconnect: boolean;
+  };
+  session: {
+    fileRead: boolean;
+    fileWrite: BooleanCapabilityDefault;
+    shell: BooleanCapabilityDefault;
+    shellMode: {
+      open: string;
+      guarded: string;
+      readOnly: string;
+    };
+  };
+  context: {
+    managed: ProviderCapabilityCondition;
+    compact: BooleanCapabilityDefault;
+    clear: BooleanCapabilityDefault;
+    inject: boolean;
+    resumePreference: Array<"native" | "clear-inject" | "none">;
+  };
+  quota: {
+    supported: boolean;
+    source: "probe" | "provider" | "runtime";
+    unit: "%" | string;
+    windows: QuotaWindowDescriptor[];
+  };
+  terminal: {
+    mode: "none" | "live" | "attach";
+    condition?: ProviderCapabilityCondition;
+    live?: {
+      read: boolean;
+      write: boolean;
+    };
+    attach?: {
+      create: boolean;
+      read: boolean;
+      write: boolean;
+      detach: boolean;
+    };
+  };
+  liveSession: {
+    capture: boolean;
+    inject: boolean;
+    interrupt: boolean;
+    promptEcho: boolean;
+    reasoning: boolean;
+    slashCommands: boolean;
+  };
+}
+
+export interface ProviderBundledFileOverride {
+  path: string;
+  sourcePath: string;
+}
+
+export interface ProviderBundledPluginDescriptor {
+  ref: string;
+  dir: string;
+  title: string;
+  description: string;
+  omitFiles?: string[];
+  fileOverrides?: ProviderBundledFileOverride[];
+}
+
+export interface ProviderBundledSkillSetDescriptor {
+  refPrefix: string;
+  dir: string;
+  titlePrefix: string;
+  description: string;
+  entryFile?: string;
+}
+
+export interface ProviderProvisioningDescriptor {
+  pluginManifestPath?: string;
+  bundledPlugin?: ProviderBundledPluginDescriptor;
+  bundledSkills?: ProviderBundledSkillSetDescriptor;
+}
+
+export interface ProviderManifest {
+  id: string;
+  label: string;
+  icon: string;
+  launch?: {
+    managedPolicyPrompt?: {
+      alwaysOn: "prompt" | "append-system-prompt";
+    };
+  };
+  catalog: {
+    models: ProviderModelEntry[];
+    defaultModel?: string;
+  };
+  quotaWindows: QuotaWindowDescriptor[];
+  capabilityDefaults: Partial<ProviderCapabilityDefaults>;
+  slashCommands?: string[];
+  resume?: { supported: boolean; idFormat?: string; idPattern?: string };
+  home?: ProviderHomeDescriptor;
+  provisioning?: ProviderProvisioningDescriptor;
+  upgrade?: ProviderUpgradeDescriptor;
+  probe?: ProviderProbeDescriptor;
+  quotaPoll?: ProviderQuotaPollDescriptor;
+  shim?: ProviderShimDescriptor;
+}