Files
deepseek-harness/packages/ptc-runtime
turtle1999 caa7111f28 feat(release): publish package source, declaration maps, and documentation
Every release member publishes its TypeScript source and the declaration
maps that resolve into it, and @deepseek-ai/dsh publishes the repository
Markdown documentation staged from docs/ at prepack time.

The ./src/* export most members already declared now resolves for an
installed consumer, and a consumer editor follows a declaration to the
implementation. Bundled JavaScript maps stay unpublished; the vendored
family and the Desktop runtime file policy are unchanged.

Rationale: .agents/notes/implemented/process/2026-10-08-published-source-and-docs.md
2026-10-08 15:30:35 +08:00
..

description, kind
description kind
Package map for the PTC execution capability family: what program execution does for you, and which package owns each part. package-group

ptc-runtime/ — PTC execution capability family

English | 中文

Summary

The ptc-runtime/ group lets a model write one program that calls host-provided functions as ordinary async calls, then returns only the program's printed output and return value. Choose the TypeScript backend for execution in a fresh Node process under the configured sandbox policy, or the experimental Python backend when a CPython process is required. Each run starts without state from earlier programs. Failures are returned as results so callers can diagnose them or provide them to the model.

Table of Contents


Packages

These three packages together provide program execution; each README describes what its part does.

Package Role ctx key
ptc-runtime/ Defines what a PTC runtime does: run one program against host-provided bindings and report what it printed and returned ctx.ptcRuntime
ptc-runtime-node/ Executes TypeScript in fresh managed Node processes under the resolved sandbox policy registers ctx.ptcRuntime
experimental/ptc-runtime-python/ The experimental Python backend: owns the fd-3 wire protocol between a Node host and a CPython subprocess and the CPython runtime implementation —

Start with the subsystem reference for the service contract, then the PTC mode design that consumes this capability and the capability-seam model it follows.

Dev Note

Working context for maintainers — click to expand

None.