The readable/writable stream halves of connect() TCP sockets under both stream implementations. The tests are the normative artifact. The general Socket surface (startTls, secureTransport, DNS overrides, the connect-handler protocol, HTTP-over-socket) is owned by src/workerd/api/tests/ (http-socket-test, connect-handler-test, starttls-*); this suite owns the STREAMS interaction only. A node sidecar (echo-server.js) runs three TCP servers, their ports delivered through fromEnvironment bindings (STREAMS_ECHO_PORT, STREAMS_GREET_PORT, STREAMS_STALL_PORT, plus SIDECAR_HOSTNAME): - echo: echoes every byte; on client half-close, flushes and ends (the client's readable reaches EOF after…
9.2k8mo agoReviewMountCreate a free account to mount
An informal specification of the two WHATWG queuing strategy classes as implemented in workerd, derived from — and kept in lockstep with — the test suite in this directory. The tests are the normative artifact. Both the C++ implementation (src/workerd/api/streams/readable.h) and the TypeScript implementation (src/per_isolate/webstreams/strategies.ts, behind typescript_implemented_streams) are covered. The WPT streams/queuing-strategies.any.js runs against both implementations; its 12 C++ expectedFailures in src/wpt/streams-test.ts correspond exactly to ledger entries #1–#6 below — the suite pins what the C++ side actually does where…
9.2k8mo agoReviewMountCreate a free account to mount
An informal specification of the JS-backed TransformStream as implemented in workerd, derived from — and kept in lockstep with — the test suite in this directory. The tests are the normative artifact. Both the C++ implementation (src/workerd/api/streams/transform.c++ over standard.c++'s TransformStreamDefaultController) and the TypeScript implementation (behind typescript_implemented_streams) are covered. The suite COMPLEMENTS WPT (//src/wpt:streams runs transform-streams/ against both implementations). Probing the 30+ C++ expectedFailures showed most narrow to a handful of root causes (below); several WPT "failures" (properties.any's arg counts/prototype-chain, the…
9.2k8mo agoReviewMountCreate a free account to mount
An informal specification of the JS-backed writable stream classes as implemented in workerd, derived from — and kept in lockstep with — the test suite in this directory. The tests are the normative artifact. Both the C++ implementation (src/workerd/api/streams/writable.{h,c++} over standard.c++'s WritableImpl/WritableStreamJsController) and the TypeScript implementation (src/per_isolate/webstreams/writable.ts, behind typescript_implemented_streams) are covered. The suite COMPLEMENTS WPT (//src/wpt:streams runs writable-streams/ against both implementations): behaviors WPT already asserts identically on both sides are not duplicated here. The WPT C++ expectedFailures for writable-streams/ in…
9.2k8mo agoReviewMountCreate a free account to mount
An informal specification of URL and URLSearchParams as implemented in workerd, kept in lockstep with the test suite in this directory. The tests are the normative artifact. The cells run the same modules (url-modules.capnp) against the C++ implementations and the TypeScript one: which-impl.js reads the flags; a cell's USING_TS_IMPL binding says which implementation it means to run. enable_fast_jsg_struct is not pinned: the @ and @all-compat-flags variants run each cell with it off and on. The TypeScript implementation honors the dated…
9.2k8mo agoReviewMountCreate a free account to mount
An informal specification of URLPattern as implemented in workerd, kept in lockstep with the test suite in this directory. The tests are the normative artifact. The cells run the same modules (urlpattern-modules.capnp) against the C++ implementations and the TypeScript one: which-impl.js reads the flags; a cell's USING_TS_IMPL binding says which implementation it means to run. enable_fast_jsg_struct is not pinned: the @ and @all-compat-flags variants run each cell with it off and on. The TypeScript implementation honors the dated flags above…
9.2k8mo agoReviewMountCreate a free account to mount
WebCrypto API + Node.js crypto C++ implementations over BoringSSL. crypto.h defines public JSG types (CryptoKey, SubtleCrypto, CryptoKeyUsageSet). impl.h defines internal CryptoKey::Impl base class with per-algorithm static ImportFunc/GenerateFunc dispatch. Algorithm files implement Impl subclasses. OSSLCALL() macro wraps all BoringSSL calls with error translation.
9.2k8mo agoReviewMountCreate a free account to mount
C++ implementations of Node.js built-in modules. Each module = JSG-bound class registered via NODEJS_MODULES(V) macro in node.h. TypeScript counterpart lives in src/node/. Exception: diagnostics-channel only forwards messages to tail workers (publishToTracer); the module itself is in src/node/diagnostics_channel.ts. Some node-internal: modules (dns, inspector, url) are implemented in Rust instead, in src/rust/api/, and registered by register_nodejs_modules() in src/rust/api/lib.rs, not in NODEJS_MODULES. See src/rust/AGENTS.md. Tests in tests/. Naming: <module>-test.js + <module>-test.wd-test; -nodejs- infix when needing compat flags. All tests set compatibilityFlags = ["nodejs_compat",…
9.2k8mo agoReviewMountCreate a free account to mount
Web Streams API: ReadableStream, WritableStream, TransformStream. See README.md for terse reference (classification, state machines, safety patterns). See docs/streams.md for narrative tutorial. NOTE: C++ code outside this directory does not use jsg::Ref<ReadableStream> or jsg::Ref<WritableStream> directly; it goes through the JsReadableStream / JsWritableStream abstractions in src/workerd/api/js-{readable,writable}-stream.{h,c++}, which hide which stream implementation backs a given stream (and provide JsReadableWritablePair + pipeTo/pipeThrough for abstraction-level pipelines). New C++ consumers of streams should use those abstractions, not the types defined here. Allocating the types defined here…
9.2k8mo agoReviewMountCreate a free account to mount
See README.md for terse reference (type mappings, macro catalog, error catalog). See docs/jsg.md for narrative tutorial. Macro-driven C++/V8 binding layer: declares C++ types as JS-visible resources/structs with automatic type conversion.
9.2k8mo agoReviewMountCreate a free account to mount
The workerd binary and its server. :workerd (workerd.rs, this package) is a Rust binary over three crates in this directory: This package keeps the config schema (workerd.capnp, compiled-bindings.capnp), the config compiler, the WorkerdApi and the C++ libraries the factory is built from (alarm scheduler, channel tokens, container client, facet tree index, fallback service, actor IDs, JSON logger, V8 platform), and their C++ unit tests. The Rust/C++ boundary. The factory keeps everything that touches the isolate: compiling a worker (WorkerdApi, compatibility…
9.2k8mo agoReviewMountCreate a free account to mount
WPT fetch/api runs in two cells, one per streams implementation: Both cells pin the same compatibility flags otherwise (strip_bom_in_read_all_text). Most entries in either config are fetch API divergences that apply to both implementations (missing CORS, cache modes, redirect handling, header validation, unimplemented methods, ...). They are duplicated in both configs and kept identical. Subtests whose result depends on the streams implementation. A row here means the two configs differ for that subtest: it is an expectedFailures or disabledTests entry in…
9.2k8mo agoReviewMountCreate a free account to mount
Generates @cloudflare/workers-types .d.ts files from C++ and Rust JSG RTTI (via jsg/rtti.capnp) + hand-written defines/*.d.ts. Rust descriptions come from TypeInfo and typed module registration in src/rust/jsg/; internal module registration does not make a type an ambient root. A workerd-hosted Worker extracts RTTI at runtime per compat-date; TypeScript transforms post-process into ambient and importable outputs. CI validates generated-snapshot/ matches. - Structure.tsName / StructureType.tsName supply the emitted declaration and reference name. When empty, the generator derives the name from fullyQualifiedName, which remains…
9.2k8mo agoReviewMountCreate a free account to mount
The project is built via make, not directly with swift build. Two Swift packages live in this repo: the root package (Containerization libraries + cctl + macOS-only integration binary) and vminitd/ (the Linux guest init system, compiled as a static musl binary inside the Linux dev container via the apple/container CLI — see make vminitd).
Context for AI coding agents (Claude Code, Gemini CLI, Cursor, Copilot, etc.) working in the ADK Go repository. Human contributors should start with CONTRIBUTING.md. ADK Go (google.golang.org/adk/v2) is an open-source, code-first Go toolkit for building, evaluating, and deploying AI agents. It is model-agnostic but optimized for Gemini, and is one of several ADK implementations — Go, Python, Java, Kotlin, and TypeScript — that share a conceptual model but are independent codebases. Requires the Go version declared in go.mod. Development happens…
Steady8 mentions in 2 weeks
No other project uses it yet
9k2mo agoReviewMountCreate a free account to mount
This file is for contributors and agents editing this directory. It is excluded from the docs build (exclude_docs in mkdocs.yml, exclude in the unified-docs sync), so nothing here is published. Every pull request that changes a CPython divergence MUST update its topic page here. Docstrings and inline comments do not count: the divergence has to be written down here. Host-API contracts belong in the relevant docs/ topic and binding reference; implementation rationale belongs in crate READMEs or code comments, not…
Steady2 mentions in 2 weeks
No other project uses it yet
8.9k2mo agoReviewMountCreate a free account to mount
Monorepo with 40+ packages in @sentry/*, managed with pnpm workspaces and Nx. Prefer LSP over Grep/Read for code navigation — it's faster, precise, and avoids reading entire files: Use Grep…
8.8k10d agoReviewMountCreate a free account to mount