AGENTS.md@packages/runtime-coreA

AGENTS.md@packages/runtime-core from maomaochong-ai/open-astravia is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add maomaochong-ai/open-astravia/packages/runtime-core/AGENTS.md@git:20261001.0ce1911

Pins git:20261001.0ce1911 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
maomaochong-ai/open-astravia
Path
packages/runtime-core/AGENTS.md
Versions recorded
5
Latest version
git:20261001.0ce1911, committed Oct 1, 2026
First version recorded
Aug 6, 2026
Size
2,062 bytes
Repository stars
39
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Team: Runtime

> 本包属于 Runtime 能力域,所有修改同时服从根 `AGENTS.md` 与 ADR-0077。

## 职责范围

产品无关的多轮运行机制,定义 Session、Turn admission、Queue、Runtime Snapshot、Conversation
Document、生命周期事务、恢复、资源所有权、Port、Session Extension 和通用事件路由。

本包不拥有 Todo、IM、知识库、Coding Prompt、产品 Profile 等产品规则,也不访问文件系统、进程、
数据库、Electron 或其他具体环境。

## 关键模块

- `src/contracts.ts` — SessionEvent、PromptRequest、SessionFacade 等核心契约
- `src/runtime-host/` — 运行时宿主实现(RuntimeHost、Active Session 事务、事件、历史与生命周期)
- `src/errors.ts` — 错误定义

## 注意事项

- 本包是 `desktop` 和 `cli-host` 的直接依赖,接口变更影响所有应用层
- 公开事件和 Port 是 `coding-agent` 与应用宿主消费的下层合同,变更需同步检查消费者
- Kernel 与 Runtime 合同必须保持产品无关,不得导入 `@astravia/coding-agent`
- 生产代码、测试、配置和包清单均不得反向依赖 `@astravia/coding-agent`
- Runtime 包拥有实际能力,不是 `coding-agent` 的兼容转发层
- “可跨平台”不是进入本包的充分条件;包含产品名词或默认产品选择的逻辑仍由产品包拥有

## 测试要求

- 使用本包 Vitest Node 测试和产品无关的合同 fixture;不得从 `coding-agent` 或具体 Host 导入测试实现。
- Kernel 阶段、Session 状态、事件或 Port 变化必须覆盖合法转换、拒绝转换、错误与取消传播、事件顺序和重复调用语义。
- Runtime Host、资源注册或初始化流程变化必须覆盖成功、初始化失败、部分初始化回滚、中止、正常关闭、重复关闭和释放失败;测试应能证明每项资源只由明确 owner 释放。
- 公开合同变化除实现测试外还要运行受影响消费者的合同测试;仅通过本包类型检查不足以证明宿主兼容。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add maomaochong-ai/open-astravia/packages/runtime-core/AGENTS.md@sha256:9508a0d3284ab760

The line at the top of this page pins the label git:20261001.0ce1911, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mgxemr4675lqvadm.svg)](https://markdownregistry.com/a/art_mgxemr4675lqvadm)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 6, 2026 and Oct 1, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20261001.0ce1911 latest2026-10-01 0ce1911 2,062 BA view · diff
git:20260818.995e8e12026-08-18 995e8e1 2,056 BA view · diff
git:20260815.3a6942a2026-08-15 3a6942a 2,059 BA view · diff
git:20260811.9384bf02026-08-11 9384bf0 1,632 BA view · diff
git:20260806.0959a3f2026-08-06 0959a3f 952 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (2062 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

maomaochong-ai/open-astravia · 39 stars · license Apache-2.0 · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mgxemr4675lqvadm
GET https://markdownregistry.com/api/v1/resolve?ref=maomaochong-ai/open-astravia/packages/runtime-core/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/9508a0d3284ab76058ee503a4b5c7618de40dab699d83e6ca16bdded683cc9b0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from maomaochong-ai/open-astravia

astravia-testing SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/astravia-testing/SKILL.md · 为 OpenAstravia 的功能变更、Bug 修复、重构、公共合同和 UI 交互设计、编写或审查测试;在决定测试范围、补充回归测试、覆盖用户常见使用流程或评估测试质量时使用。纯文档或没有运行时行为变化的编辑不使用。
git:20261014.02ac874 · audit A · 39 stars
compose-component-design SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/compose-component-design/SKILL.md · Use when designing or reviewing reusable Jetpack Compose component APIs with modifier parameters, root layout…
git:20260928.e3f9971 · audit A · 39 stars
compose-state-and-effects SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/compose-state-and-effects/SKILL.md · Use when writing or reviewing Jetpack Compose state ownership, remember state, state hoisting, screen state holders…
git:20260928.e3f9971 · audit A · 39 stars
design-taste-frontend SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/design-taste-frontend/SKILL.md · Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right…
git:20260911.9951787 · audit B · 39 stars
diagnose SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/diagnose/SKILL.md · Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument →…
git:20260922.7ea4a67 · audit A · 39 stars
expo-overview SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/expo-overview/SKILL.md · Framework (OSS). Entry point and router for every Expo or EAS task. Load this skill first — before writing code and…
v1.1.0 · audit A · 39 stars
expo-project-structure SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/expo-project-structure/SKILL.md · Framework (OSS). Folder structure for a new Expo app. Use when scaffolding or laying out a new Expo project with Expo…
v1.0.0 · audit B · 39 stars
expo-router SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/expo-router/SKILL.md · Framework (OSS). Navigation and routing for Expo Router. Covers file-based routes, groups and dynamic routes, folder…
v1.0.1 · audit A · 39 stars
find-skills SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/find-skills/SKILL.md · Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is…
git:20260901.3ee8f34 · audit A · 39 stars
frontend-design SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/frontend-design/SKILL.md · Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with…
git:20260911.9951787 · audit A · 39 stars
grill-me SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/grill-me/SKILL.md · Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of…
git:20260922.7ea4a67 · audit A · 39 stars
grill-with-docs SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/grill-with-docs/SKILL.md · Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates…
git:20260922.7ea4a67 · audit A · 39 stars

Every file in maomaochong-ai/open-astravia

Browse by kind, by grade A, or by owner.