Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
import { isMigrationCandidate } from './migrationGrouping';
import { apiFailure, type ModelsApi } from './modelsApi';
import type { CollectionReadAuthority } from './collectionReadAuthority';
import { resumeInstallAndStartRuntime } from './runtimeLifecycle';
import type { AgentBackend, AgentSupply, MigrationItem, RuntimeDependency } from './types';
export type GatewayAdoptionFailure = {
step: 'install' | 'start' | 'scan' | 'read';
request?: string;
responseStatus?: number;
reason: 'transport' | 'refused' | 'notReady' | 'unknown';
};
export type GatewayAdoptionResult =
| { ok: true; agent: AgentSupply; runtime: RuntimeDependency | null; candidates: MigrationItem[] }
| { ok: false; failure: GatewayAdoptionFailure; runtime: RuntimeDependency | null };
const classifiedFailure = (
error: unknown,
step: GatewayAdoptionFailure['step'],
request?: string,
): GatewayAdoptionFailure => {
const failure = apiFailure(error);
if (!failure || !failure.serverNamed) {
return { step, request, responseStatus: failure?.responseStatus, reason: 'transport' };
}
if (failure.code === 'engine_down' || failure.code === 'runtime_not_ready') {
return { step, request, responseStatus: failure.responseStatus, reason: 'notReady' };
}
if (failure.responseStatus && failure.responseStatus >= 400 && failure.responseStatus < 500) {
return { step, request, responseStatus: failure.responseStatus, reason: 'refused' };
}
return { step, request, responseStatus: failure.responseStatus, reason: 'unknown' };
};
const readFailure = (error: unknown, request: string): GatewayAdoptionResult => ({
ok: false,
failure: classifiedFailure(error, 'read', request),
runtime: null,
});
const backendRow = (agents: AgentSupply[], backend: AgentBackend): AgentSupply | null =>
agents.find((agent) => agent.backend === backend) ?? null;
/**
* Prepares a Direct backend for adoption without changing authentication or
* routing. A caller opens the shared migration dialog whenever any native row
* exists; the dialog decides whether the backend is fully importable.
*/
export async function resumeGatewayAdoption(
api: Pick<ModelsApi, 'getRuntimeStatus' | 'installRuntime' | 'startRuntime' | 'scanMigration'>,
agentReads: CollectionReadAuthority<AgentSupply[]>,
backend: AgentBackend,
installPollIntervalMs = 2_000,
): Promise<GatewayAdoptionResult> {
let agents: AgentSupply[];
try {
agents = await agentReads.readValue();
} catch (error) {
return readFailure(error, 'GET /api/models/agents');
}
const current = backendRow(agents, backend);
if (!current) {
return {
ok: false,
failure: { step: 'read', request: 'GET /api/models/agents', reason: 'unknown' },
runtime: null,
};
}
if (current.mode === 'hub') return { ok: true, agent: current, runtime: null, candidates: [] };
let runtime: RuntimeDependency;
try {
runtime = await api.getRuntimeStatus();
} catch (error) {
return readFailure(error, 'GET /api/models/runtime/status');
}
const runtimeSequence = await resumeInstallAndStartRuntime(api, runtime, () => {}, installPollIntervalMs);
if (runtimeSequence.runtime) runtime = runtimeSequence.runtime;
if (runtimeSequence.failedStep === 'install') {
return {
ok: false,
failure: { step: 'install', reason: 'unknown' },
runtime,
};
}
if (runtimeSequence.failedStep === 'start') {
return {
ok: false,
failure: runtimeSequence.error
? classifiedFailure(runtimeSequence.error, 'start', 'POST /api/models/runtime/start')
: { step: 'start', request: 'POST /api/models/runtime/start', reason: 'notReady' },
runtime,
};
}
try {
const scan = await api.scanMigration();
// Rows the Hub cannot carry stay native and never hold the switch back; a
// config blocker does, so the review opens and names the file to repair.
const candidates = scan.items.filter((item) => item.backend === backend && isMigrationCandidate(item));
return { ok: true, agent: current, runtime, candidates };
} catch (error) {
return {
ok: false,
failure: classifiedFailure(error, 'scan', 'POST /api/models/migration/scan'),
runtime,
};
}
}