UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

71 lines (67 loc) • 4.31 kB
import { z } from "zod"; import { redactUserPath } from "../lib/redact"; import type { RefusalReason } from "../integrations/mutation-plan"; import { ASIDE_SYNC_EMPTY_LINES } from "./aside-profile-recovery"; import { refreshAsideProfilesThroughServer } from "./aside-profiles"; import { runCatalogAction } from "./catalog-command-result"; import { CliUsageError, RuntimeApiError, printData, takeFlag, takeOption, type RuntimeApiDeps } from "./runtime-api"; const USAGE = "Usage: ocx integration client sync --client aside [--json]"; const refusalText = { not_installed: "Aside is not installed for this profile.", conflict: "Profile configuration conflicts with the managed integration.", unsafe: "Profile configuration cannot be changed safely.", non_loopback: "The integration requires a loopback destination.", superseded_store: "The client now uses a different configuration store.", drift_requires_confirm: "Profile configuration changed; inspect it before an explicit restore.", snapshot_expired: "The recovery snapshot has expired.", write_failed: "The profile write failed. Inspect its state before retrying.", } satisfies Record<RefusalReason, string>; const profileId = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER); const text = z.string().max(32768); const resultSchema = z.discriminatedUnion("ok", [ z.object({ client: z.literal("aside"), profileId, ok: z.literal(true), changed: z.boolean(), reason: text.optional().transform(value => value === undefined ? undefined : value === "managed block is absent; refresh did not reconnect it" ? "Managed block remains absent; synchronization did not reconnect it." : "Profile synchronization returned a notice; inspect integration status."), }), z.object({ client: z.literal("aside"), profileId, ok: z.literal(false), state: z.enum(["absent", "current", "stale", "conflict", "unsafe"]), refusalReason: z.enum(["not_installed", "conflict", "unsafe", "non_loopback", "superseded_store", "drift_requires_confirm", "snapshot_expired", "write_failed"]), reason: text.optional(), residual: z.boolean().optional(), snapshotPath: text.min(1).transform(redactUserPath).optional(), }).transform(row => ({ ...row, reason: refusalText[row.refusalReason] })), ]); const resultsSchema = z.array(resultSchema).refine(rows => new Set(rows.map(row => row.profileId)).size === rows.length); /** Narrow owner seam: production always uses the established attested exchange. */ export interface AsideSyncCliDeps extends RuntimeApiDeps { refreshAsideProfilesImpl?: typeof refreshAsideProfilesThroughServer; } /** argv begins after sync. No local writer or base-URL pre-resolution. */ export function handleIntegrationAsideSync(argv: string[], deps: AsideSyncCliDeps = {}): Promise<number> { return runCatalogAction(async () => { const args = [...argv]; const wantsJson = takeFlag(args, "--json"); const client = takeOption(args, "--client"); if (args.length || client !== "aside") throw new CliUsageError("Sync requires --client aside and accepts only --json", USAGE); // Sync is an aggregate operation: every owner/transport failure is exit 1, // not the record-not-found/conflict exits used by addressed journal writes. const outcomes = await (deps.refreshAsideProfilesImpl ?? refreshAsideProfilesThroughServer)(deps) .catch(error => { if (error instanceof RuntimeApiError && error.code === "proxy_not_running") throw error; throw new Error("Aside synchronization did not complete"); }); const parsed = resultsSchema.safeParse(outcomes); if (!parsed.success) throw new Error("Invalid Aside synchronization outcome"); const results = parsed.data; const lines = results.length === 0 ? [...ASIDE_SYNC_EMPTY_LINES] : results.flatMap(row => [ `Aside profile ${row.profileId}: ${row.ok ? row.changed ? "updated" : "unchanged" : "failed"}.`, ...(row.reason ? [row.reason] : []), ...(!row.ok && row.residual ? ["Recovery is incomplete; inspect the profile before retrying."] : []), ...(!row.ok && row.snapshotPath ? [`Backup (redacted path): ${row.snapshotPath}`] : []), ]); printData({ results }, wantsJson, lines); return results.some(row => !row.ok) ? 1 : 0; }); }