vercel-labs/seal

vercel-labs のプロフィール

記録された最新のソース活動: 2026年7月17日 17:25

SkillsMP カタログ更新: 2026年10月17日 00:09

収集済み skills: 8

GitHub スター: 8
GitHub フォーク: 3

リポジトリの README

README の元ファイル：README.md

README の元ファイルを読む

README 全文を表示

# seal A personal AI assistant built as a **durable agent**: every agent run is a Vercel workflow, so turns survive restarts, streams can be resumed mid-run, and tool calls can park indefinitely waiting for human approval. Seal is an example app for the [AI SDK for Python](https://ai-python.dev) (the `ai` package) and for [Workflows with Python](https://vercel.com/docs/workflows/python) (`vercel.workflow`). The agent (Claude via the AI Gateway) has three tools: `bash`, `web_fetch`, and `subagent`. Bash runs are gated behind an approval UI when run by the main agent, but not when run by a subagent. (That is silly, but this is a demo app.) ## How it works - **frontend/** — React + Vite chat UI using the AI SDK (`useChat`) and [AI Elements](https://elements.ai-sdk.dev). Reconnecting to a session re-tails the in-flight stream (`useChat({ resume: true })`). - **backend/app/** — FastAPI service. `POST /api/chat` starts (or resumes) a run and streams the AI SDK UI message protocol; other endpoints cover sessions, titles, and private blob attachments. See `app/server.py` for the endpoint list. - **backend/agent/** — the durable agent itself. `driver.py` runs a `run_session` workflow that spawns one child `run_turn` workflow per agent turn and suspends on a hook until it finishes. Tool approvals are workflow hooks too: the turn parks until the user answers, then resumes with the decision. Model calls, stream writes, and session snapshots are all workflow steps, replay-safe via the workflow's deterministic RNG/clock. - **Storage** — durable streams and session snapshots are stored on the workflow SDK's run streams (`agent/stream.py`). Session metadata (`app/sessions.py`) uses Postgres when `DATABASE_URL` is set, local JSON files otherwise. Uses Vercel Blob to store attachments when available. Deployment is two Vercel services (see `vercel.json`): the frontend and the backend, with the workflow worker declared in `backend/pyproject.toml`. ## Development Prereqs: [uv](https://docs.astral.sh/uv/), [pnpm](https://pnpm.io), and the [Vercel CLI](https://vercel.com/docs/cli). ```sh ./dev-setup.sh # sync backend deps (works around a vercel-worker version override) cd frontend && pnpm install vercel dev # serves frontend + backend + worker on :3000 ``` Environment: `AI_GATEWAY_API_KEY` (model access), optional `DATABASE_URL` (Postgres storage), and a blob token for attachments. ### Checks ```sh make ci # everything below make ci-backend # uv sync, ruff, mypy, ty, pytest make ci-frontend # pnpm install, prettier, eslint, tsc, vitest, build ``` ### E2E tests `e2e/` drives a real browser against a running instance: ```sh cd e2e && pnpm install && pnpm run install-browser pnpm test # expects the app at http://localhost:3000 pnpm run test:images # image latency: time to first image, time to all N ``` `test:images` prompts "draw N pictures of things you find interesting" (`N=5` by default) and reports when each image actually painted, measured from the submit click. Timings also land in `/tmp/seal-e2e-images-summary.json`. ## Deployment Deploy as a project to Vercel with `vc deploy`. `DATABASE_URL` must point to a Postgres database, which can most easily be done by configuring a marketplace integration with Neon or similar.

リポジトリの README を読み込んでいます…

このリポジトリの skills

ソフトウェア開発者

1 件の職業カテゴリ · 100% 分類済み

skill

職業分類

説明

更新

ai-python-custom-loop

ソフトウェア開発者

Use when building custom agent loops. Modify tool dispatch, history management, hooks, control flow.

原文の言語: 英語

2026-07-17

ai-python-custom-provider

ソフトウェア開発者

Use for implementing custom providers in AI SDK for Python.

原文の言語: 英語

2026-07-17

ai-python-durable-execution

ソフトウェア開発者

Use when adding durable execution to AI SDK for Python, building durable agent loops, or serializing messages across workflow steps.

原文の言語: 英語

2026-07-17

ai-python-serverless-execution

ソフトウェア開発者

Use when building serverless AI SDK for Python endpoints, handling hook approvals, deferring hooks, or resuming runs across requests.

原文の言語: 英語

2026-07-17

ai-python-streaming-tools

ソフトウェア開発者

Use for AI SDK for Python async-generator tools, streaming tool output, subagent tools, PartialToolCallResult events, and custom tool aggregation.

原文の言語: 英語

2026-07-17

ai-python-subagents

ソフトウェア開発者

Use for the subagent-as-a-tool pattern.

原文の言語: 英語

2026-07-17

ai-python-ui-adapter

ソフトウェア開発者

Use when connecting AI SDK for Python streams to AI SDK UI useChat clients.

原文の言語: 英語

2026-07-17

ai-python-basics

ソフトウェア開発者

Use for AI SDK for Python basics. Configure a model, make messages, stream, declare tools, build a basic agent.

原文の言語: 英語

2026-07-15

収集済み skill 8 件中 8 件を表示しています。

AI アシスタントでインストール

このプロンプトをコピーして、使用中の AI アシスタントに送ってください。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/vercel-labs/seal.