artifacts

# Artifacts — Serving Interactive Web Content Serve a directory or a Hono app to a public, auth-protected URL via localtunnel. Useful for sharing reports, dashboards, approval flows, or anything else a human needs to look at in a browser. The CLI is a subcommand of `agent-swarm`. Always invoke as **`agent-swarm artifact <subcommand>`** — there is no top-level `artifact` binary. ## Quick Start ### Static content ```bash # Create your content in a persisted directory mkdir -p /workspace/personal/artifacts/my-report echo '<h1>My Report</h1>' > /workspace/personal/artifacts/my-report/index.html # Serve it (auto-assigns a free port, creates tunnel, registers in service registry) agent-swarm artifact serve /workspace/personal/artifacts/my-report --name my-report # -> Artifact "my-report" live at https://<agentId>-my-report.lt.desplega.ai (port <auto>) ``` ### Programmatic (custom Hono server) ```typescript import { createArtifactServer } from '../artifact-sdk'; import { Hono } from 'hono'; const app = new Hono(); app.get('/', (c) => c.html('<h1>Dashboard</h1>')); const server = createArtifactServer({ name: 'dashboard', app }); await server.start(); console.log(`Live at: ${server.url}`); ``` You can also `agent-swarm artifact serve ./server.ts --name dashboard` if `server.ts` exports a Hono instance as its default export. ## CLI Commands | Command | Description | |---|---| | `agent-swarm artifact serve <path> --name <name> [--port <port>] [--no-auth] [--subdomain <sub>]` ...