Instance API

// Read instance state — single round-trip for config + guardrails + upgrade
const res: Response = await fetch('/api/instance/config');
const { devMode, config, guardrails, upgrade }: {
devMode: boolean;
config: { branchName: string; dataDir: string; createdAt: string } | null;
guardrails: object | null;
upgrade: { upgradeAvailable: boolean; commitsBehind: number } | null;
} = await res.json();

if (devMode) {
console.log('Dev mode — instance config unavailable');
} else if (config) {
console.log(`Instance on branch: ${config.branchName}`);
console.log(`Data dir: ${config.dataDir}`);
if (upgrade?.upgradeAvailable) {
  console.log(`${upgrade.commitsBehind} upstream commit(s) available`);
}
}

// Re-run instance bootstrap — safe to call multiple times
const res: Response = await fetch('/api/instance/init', { method: 'POST' });

if (res.ok) {
const { ensureResult, config }: {
  ensureResult: { created: boolean };
  config: { branchName: string } | null;
} = await res.json();

if (ensureResult.created) {
  console.log(`Instance bootstrapped on branch: ${config?.branchName}`);
} else {
  console.log('Instance already initialized — guardrails re-applied');
}
} else {
const { error }: { error: string } = await res.json();
console.error(`Bootstrap failed: ${error}`);
}

// Spawn the upgrade task — navigate to the task view for streaming progress
const res: Response = await fetch('/api/instance/upgrade', { method: 'POST' });

if (res.status === 202) {
const { taskId }: { taskId: string } = await res.json();
console.log(`Upgrade task: ${taskId}`);
// Navigate to /tasks/${taskId} to watch the merge progress
} else if (res.status === 409) {
const { error }: { error: string } = await res.json();
console.log(`Cannot upgrade: ${error}`);
}

// Force an upgrade check and display the result
interface UpgradeState {
upgradeAvailable: boolean;
commitsBehind: number;
lastPolledAt: number | null;
pollFailureCount: number;
}

const res: Response = await fetch('/api/instance/upgrade/check', { method: 'POST' });
const body: { ok: boolean; state?: UpgradeState; skipped?: string } = await res.json();

if (body.ok && body.state) {
if (body.state.upgradeAvailable) {
  console.log(`Upgrade available — ${body.state.commitsBehind} commit(s) behind origin/main`);
} else {
  console.log('Up to date');
}
} else {
console.log(`Check skipped: ${body.skipped ?? 'unknown'}`);
}

// Poll upgrade status from a client component
interface UpgradeStatus {
devMode: boolean;
upgradeAvailable: boolean;
commitsBehind: number;
lastPolledAt: number | null;
lastUpgradeTaskId: string | null;
pollFailureCount: number;
}

const status: UpgradeStatus = await fetch('/api/instance/upgrade/status')
.then((r: Response) => r.json());

if (status.devMode) {
console.log('Dev mode — upgrade status suppressed');
} else if (status.upgradeAvailable) {
console.log(`Upgrade available: ${status.commitsBehind} commits behind`);
if (status.lastUpgradeTaskId) {
  console.log(`Previous upgrade task: ${status.lastUpgradeTaskId}`);
}
} else {
const lastPoll = status.lastPolledAt
  ? new Date(status.lastPolledAt * 1000).toLocaleString()
  : 'never';
console.log(`Up to date. Last checked: ${lastPoll}`);
}