A desktop coding agent with free access to frontier models.
TypeScript
import {
assertWorldName,
defaultDisplayStage,
defaultScriptWorldSnapshotDirectory,
EVENTS_ENV,
eventsPath,
hold,
LEDGER_ENV,
ledgerPath,
readLedger,
receiptName,
resolveStage,
rewriteLedger,
progress,
output,
secret,
trackResource,
type LedgerEntry,
type Progress,
type WorldOutput,
} from "@omnirush/world";
import { resolvePlace, type Place } from "./place.ts";
export interface RecipeTools {
stack: AsyncDisposableStack;
place: Place;
stage: string;
progress: Progress;
output: typeof output;
secret: typeof secret;
stageName(base: string): string;
track(entry: Omit<LedgerEntry, "at">): Promise<void>;
}
export interface WorldRecipe<O extends Record<string, WorldOutput> = Record<string, WorldOutput>> {
kind: "recipe";
name: string;
build(tools: RecipeTools): Promise<O>;
}
export function recipe<O extends Record<string, WorldOutput>>(
name: string,
build: (tools: RecipeTools) => Promise<O>,
): WorldRecipe<O> {
assertWorldName(name);
return { kind: "recipe", name, build };
}
export async function runRecipe(def: WorldRecipe): Promise<void> {
const worldStage = resolveStage(process.env);
const path = process.env[LEDGER_ENV]
?? ledgerPath(defaultScriptWorldSnapshotDirectory(), receiptName(def.name, worldStage));
process.env[LEDGER_ENV] = path;
process.env[EVENTS_ENV] ??= eventsPath(
defaultScriptWorldSnapshotDirectory(),
receiptName(def.name, worldStage),
);
let completed = false;
try {
{
await using stack = new AsyncDisposableStack();
const stage = worldStage ?? defaultDisplayStage(process.env);
const place = resolvePlace();
const outputs = await def.build({
stack,
place,
progress: progress(),
output,
secret,
stage,
stageName: (base) => `${base} (${stage})`,
track: trackResource,
});
await hold({ name: def.name, outputs });
}
completed = true;
} finally {
if (completed) {
const retained = (await readLedger(path)).filter((entry) => entry.retain === true);
await rewriteLedger(path, retained);
}
}
}