Skip to content

Expose installable NodeAgent runtime contracts and Pi AI adapter - #2

Draft
HomenShum wants to merge 1 commit into
mainfrom
codex/nodeagent-runtime-contract
Draft

Expose installable NodeAgent runtime contracts and Pi AI adapter#2
HomenShum wants to merge 1 commit into
mainfrom
codex/nodeagent-runtime-contract

Conversation

@HomenShum

@HomenShum HomenShum commented Jul 20, 2026

Copy link
Copy Markdown
Owner

Outcome

Creates a collision-safe package boundary for NodeAgent and a real optional Pi AI provider adapter while keeping orchestration, tools, policy, durability, and receipts inside NodeAgent.

  • renames the package to @homenshum/nodeagent
  • exports provider-neutral runtime/model/event contracts
  • implements nodeagent.event/v1 validation aligned with NodeKit
  • implements lazy Pi model lookup, native streaming deltas, structured tool calls, exact usage/cost normalization, and honest error classification
  • adds tarball-ready library builds without making Pi mandatory for deterministic mode

Proof

  • typecheck passed
  • 9 test files / 47 tests passed
  • full production build passed
  • deterministic/durable/SQLite/happy-path proof passed
  • fresh tarball consumer import passed
  • npm audit --omit=dev: 0 vulnerabilities

Dependency status

The branch's own verify and security checks pass. The hosted node-platform / conformance check is expected to remain red until the canonical provider/event ownership additions in node-platform #4 land on main; the same assembled registry passes locally.

Boundaries

This does not publish npm, deploy an app, or replace the existing NodeAgent orchestration loop.

HomenShum added a commit that referenced this pull request Jul 29, 2026
… registry lag) (#3)

* ci: bump node-platform reusable-workflow pin to current main

The 2026-07-20 red conformance run on PR #2 was registry lag, not a
NodeAgent defect: the run predated node-platform registering the
nodeagent.event-protocol and nodeagent.provider-pi concepts in
ownership.yaml. Re-running the same run against today's registry
passes 4/4 contract declarations (verified locally and on Actions).

This bump moves the pinned reusable-workflow SHA from ef4ac8a (20 days
stale) to ab7c9e69, picking up node-platform's CI gate fixes (#22/#23).
The workflow interface (platform_ref, node_version) is unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* fix(conformance): sync canonicalFor with registry-owned concepts

node-platform main now registers nodeagent.event-protocol and
nodeagent.provider-pi with NodeAgent as owner, so the conformance
check requires them in canonicalFor. Verified locally against
node-platform@ab7c9e69: PASS, 2/2 declarations classified.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant