Pi

Pi packages preview

Shared TypeScript packages for Pi runtime applications.

This repository contains the open-source runtime contracts, adapters, and
orchestration helpers that are consumed by Pi Agent and related applications.
The packages are intentionally small and composable: host applications provide
HTTP routing, authentication, model runtime setup, deployment configuration, and
product-specific UI.

Packages

Category	Package	Purpose
Core	`@amaster.ai/pi-shared`	Shared runtime types and contracts: settings loader, session/event/artifact types, turn and subagent types.
Core	`@amaster.ai/pi-storage`	JSON-file and MySQL/Prisma persistence adapters for sessions, transcripts, events, memory, artifacts, subagents, and scheduled tasks.
Extension	`@amaster.ai/pi-attachments`	Attachment normalization, local/remote upload handling, document parsing, and model-readable attachment prompts.
Extension	`@amaster.ai/pi-telemetry`	Runtime telemetry with Langfuse and OpenTelemetry exporters.
Extension	`@amaster.ai/pi-task-scheduler`	Cron-based scheduled task management with LLM-callable tools.
Extension	`@amaster.ai/pi-browser-use`	Browser automation wrapping chrome-devtools-mcp with `browser_`-prefixed tools.
Extension	`@amaster.ai/pi-web-access`	Web search and URL content extraction across configurable providers.
Extension	`@amaster.ai/pi-computer-use`	Computer-use extension for CUA computer-server with desktop automation tools.
Extension	`@amaster.ai/pi-channels`	Native messaging channels: Feishu, WeCom, and webhooks.
Extension	`@amaster.ai/pi-memory`	Persistent curated memory (`MEMORY.md` + `USER.md`) injected into the system prompt as a frozen snapshot.
Extension	`@amaster.ai/pi-security`	Resource-aware security policy engine and tool authorization.
Extension	`@amaster.ai/pi-teamwork`	Team collaboration and issue management via Multica.
Extension	`@amaster.ai/pi-image-gen`	Image generation via OpenAI gpt-image, Google Nano Banana, Alibaba Qwen-Image, OpenRouter, and custom providers.

Core packages provide types and persistence used by every host application.
Extension packages each register Pi runtime extensions via their ./extension
subpath entry point and are loaded on demand.

Every package is ESM-only and published under the @amaster.ai npm scope.

Extension Previews

@amaster.ai/pi-attachments	@amaster.ai/pi-telemetry	@amaster.ai/pi-task-scheduler
@amaster.ai/pi-browser-use	@amaster.ai/pi-computer-use	@amaster.ai/pi-channels
@amaster.ai/pi-memory	@amaster.ai/pi-security	@amaster.ai/pi-teamwork
@amaster.ai/pi-image-gen	@amaster.ai/pi-web-access

Requirements

Node.js >=24
pnpm 10.18.3

Use Corepack when possible:

corepack enable
corepack install -g [email protected]

Development

Install dependencies:

pnpm install

Run the full local check:

pnpm run pr-check

Common commands:

pnpm build
pnpm typecheck
pnpm test
pnpm --filter @amaster.ai/pi-storage prisma:generate

@amaster.ai/pi-storage includes a Prisma schema at
packages/storage/prisma/schema.prisma. The root build and typecheck
scripts generate the Prisma client before compiling project references.

Consuming Packages

Install only the packages your application needs:

pnpm add @amaster.ai/pi-shared @amaster.ai/pi-storage

Most packages expose a root entry point. Some packages also expose focused
subpath entry points:

import { createRuntimeStorage } from "@amaster.ai/pi-storage";
import { JsonRuntimeStorage } from "@amaster.ai/pi-storage/json";
import { loadPiSettings } from "@amaster.ai/pi-shared/settings";
import { createLangfuseExporter } from "@amaster.ai/pi-telemetry/langfuse";
import { createOtelExporter } from "@amaster.ai/pi-telemetry/otel";
import memoryExtension from "@amaster.ai/pi-memory/extension";

Extension packages register themselves through their ./extension subpath
entry point. Host applications import these and pass them to the Pi runtime
during setup.

See each package README for package-specific examples and public API notes.

License

Apache-2.0

Pi