The VibeOS SDK

<script>
  // window.vos is injected asynchronously. Two things can be true when your
  // script runs: the SDK is already there, or it isn't yet.
  // This pattern handles both — always use it.
  function start() {
    // Safe to call window.vos.* from here on.
    window.vos.app.getInfo().then(function (info) {
      document.title = info.name;
    });
  }

  if (window.vos) start();
  else window.addEventListener("vos-ready", start, { once: true });
</script>

// Every method returns a Promise, so async/await works normally.
async function start() {
  const info = await window.vos.app.getInfo();
  const files = await window.vos.fs.readDir(info.sandboxPath);
  console.log(info.name, "has", files.length, "files");
}

// Calls reject with a normal Error. Always handle rejection —
// a missing file, a denied path and an offline API all arrive this way.
try {
  const text = await window.vos.fs.readFile("home/Documents", "note.md");
} catch (err) {
  console.warn("read failed:", err.message);
}

// Optional: drop this into your app for editor autocomplete.
// The runtime object is injected by VibeOS — you never import anything.
type VosEntry = { name: string; type: string };

interface Vos {
  fs: {
    readDir(path: string): Promise<VosEntry[]>;
    readFile(path: string, name: string): Promise<string | null>;
    writeFile(path: string, name: string, content: string): Promise<boolean>;
    deleteFile(path: string, name: string): Promise<boolean>;
    deleteDir(path: string): Promise<boolean>;
    rename(fromPath: string, toPath: string): Promise<boolean>;
    move(fromPath: string, toPath: string): Promise<boolean>;
    onChange(cb: (d: { affectedPath?: string }) => void): () => void;
    watch(
      path: string,
      cb: (d: { affectedPath?: string }) => void,
      opts?: { debounceMs?: number },
    ): () => void;
  };
  ai: {
    chat(messages: { role: "system" | "user" | "assistant"; content: string }[]): Promise<string>;
    canUse(category?: string): Promise<{ ok: boolean; code?: string; message?: string }>;
  };
  net: {
    fetch(url: string, init?: { method?: string; headers?: Record<string, string>; body?: string }):
      Promise<{ status: number; statusText: string; headers: Record<string, string>; body?: string; bodyBase64?: string }>;
  };
  app: {
    getInfo(): Promise<{
      name: string;
      id: string;
      closeBehavior: "close" | "minimize";
      sandboxPath: string;
      permissions: { hasRead: boolean; hasWrite: boolean; hasAi: boolean; hasNet: boolean; network: string[] };
    }>;
  };
}

declare global {
  interface Window { vos: Vos }
}