[SDK/Factories] Add Factory Pagination And Completion Options

[MRayermannMSFT]

What

The Node.js Agent Factories API adds paginated run listing with cursor and truncation metadata. Factory run and resume options now forward completion notifications and phase-name logging.

Why

SDK callers can inspect complete run history without raw RPC calls. This pull request is stacked on #2430 because that pull request provides the generated Copilot CLI 1.0.81 contract.

[Copilot]

Copilot review overview

Review tier: Balanced
Findings: None

What changed in this PR

Adds Node.js Agent Factories pagination metadata and runtime completion/phase controls.

Changes:

• Adds paginated listRuns overloads while preserving the array-returning API.
• Forwards notification and phase logging options for runs and resumes.
• Documents and tests the new behavior.

File	Description
nodejs/​src/​factory.ts	Defines pagination types and runtime options.
nodejs/​src/​session.ts	Implements pagination and option forwarding.
nodejs/​src/​index.ts	Exports pagination types.
nodejs/​src/​extension.ts	Exports pagination types for extensions.
nodejs/​docs/​factories.md	Documents the new API.
nodejs/​test/​factory.test.ts	Tests RPC forwarding and response shapes.
nodejs/​test/​e2e/​factory.e2e.test.ts	Tests pagination and runtime controls end to end.
nodejs/​test/​e2e/​fixtures/​factory-extension.mjs	Adds a phased E2E factory fixture.
CHANGELOG.md	Records the feature additions.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[github-actions]

Cross-SDK Consistency Review ✅

This PR adds paginated listRuns() and notifyOnComplete/logPhaseNames options to the Node.js Agent Factories convenience API, which is Node.js-only at this time.

Findings

No cross-SDK consistency issues. Here's why:

1. Underlying RPC types are already consistent: The generated RPC types (FactoryListRunsRequest, FactoryListRunsResult, notifyOnComplete, logPhaseNames on RunOptions/FactoryResumeRequest) already exist in all six SDK generated layers — Python (generated/rpc.py), Go (rpc/zrpc.go), .NET (Generated/Rpc.cs), and the contract is shared.

2. The SessionFactoryApi high-level convenience layer is Node.js-only by design: The other SDKs (Python, Go, .NET, Java, Rust) expose factory operations only via raw RPC — there is no equivalent session.factory.listRuns() wrapper in those SDKs yet. The CHANGELOG correctly scopes this to "Node.js Agent Factories convenience API."

3. The new options (notifyOnComplete, logPhaseNames) are passed through to the CLI via RPC fields that are already generated in all SDKs — so callers of the raw RPC APIs in other languages can already use these options today.

Summary

The PR maintains parity at the RPC contract level and adds Node.js-specific convenience ergonomics on top of an already Node.js-only factory session API surface. No changes needed in other SDKs.

Generated by SDK Consistency Review Agent for #2431 · sonnet46 41.6 AIC · ⌖ 5.47 AIC · ⊞ 6.6K · ◷