Software

import { createAgentOsClient } from "@rivet-dev/agentos";

const client = createAgentOsClient({ endpoint: "https://api.rivet.dev" });
const vm = client.agentOS.getOrCreate(["my-vm"]);

// Registry software is published as digest-addressed .aospkg files next to a
// manifest. Use a release version, or `latest`.
const base = "https://releases.rivet.dev/agent-os/latest/software/";
const { artifacts } = await (await fetch(`${base}manifest.json`)).json();
const ripgrep = artifacts.find((artifact: { name: string }) => artifact.name === "ripgrep");

const installed = await vm.v1.software.install({
	source: { url: new URL(ripgrep.path, base).href, digest: ripgrep.digest },
});
if (installed.config.state === "restart_required") {
	await vm.v1.vm.restart({});
}

for (const software of await vm.v1.software.list({})) {
	console.log(software.packageId, software.commands);
}

const { packageId } = installed.source;
if (packageId) await vm.v1.software.uninstall({ packageId });

import { AgentOs } from "@rivet-dev/agentos-core";

// Registry software is published as digest-addressed .aospkg files next to a
// manifest. Use a release version, or `latest`.
const base = "https://releases.rivet.dev/agent-os/latest/software/";
const manifest = (await (await fetch(`${base}manifest.json`)).json()) as {
	artifacts: { name: string; digest: string; path: string }[];
};
const ripgrep = manifest.artifacts.find((artifact) => artifact.name === "ripgrep");
if (!ripgrep) throw new Error("ripgrep is not in the manifest");

const vm = await AgentOs.create();

try {
	// Install a package while the VM is running. The bytes are verified against
	// the digest before the package is projected into /opt/agentos.
	const installed = await vm.software.install({
		type: "url",
		url: new URL(ripgrep.path, base).href,
		expectedDigest: ripgrep.digest,
	});
	console.log(installed.packageName, installed.version, installed.commands);

	const result = await vm.process.execFile("rg", ["--version"], {
		output: { capture: "all" },
	});
	console.log(result.stdout);

	// Packages installed through this API, and every command the VM provides.
	console.log(vm.software.installed());
	console.log(await vm.software.list());

	await vm.software.uninstall(installed.packageId);
} finally {
	await vm.dispose();
}

import { createAgentOsClient } from "@rivet-dev/agentos";

const client = createAgentOsClient({ endpoint: "https://api.rivet.dev" });

const vm = client.agentOS.getOrCreate(["my-vm"], {
	createWithInput: {
		config: {
			software: [
				{
					url: "https://releases.rivet.dev/agent-os/latest/software/packages/git/<sha256>.aospkg",
				},
			],
		},
	},
});

import git from "@agentos-software/git";
import { AgentOs } from "@rivet-dev/agentos-core";

const vm = await AgentOs.create({ software: [git] });

try {
	const result = await vm.process.exec("git --version", {
		output: { capture: "all" },
	});
	console.log(result.stdout);
} finally {
	await vm.dispose();
}