Describe ctx.session by how it behaves, not by what it lacks

The context session is a full CopilotSession, so factory.run and factory.resume are present and callable. Saying the APIs are absent contradicted the exported type. The guide and the published comment now say the session refuses those calls.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 5ece6b29-8b10-47aa-ab17-b64c47f5fdcd

Author: MRayermannMSFT

nodejs/docs/factories.md

@@ -61,7 +61,7 @@ The `run()` context provides:
 - `ctx.step(key, producer, options?)`: Journals the producer's JSON result under a stable key so a resume replays it without re-running the producer. A journaled (default) producer must return a JSON-serializable value; `undefined` or a non-JSON value is rejected. Pass `{ volatile: true }` to bypass the journal and run the producer every time.
 
   The key is the *sole* identity: neither the producer body nor its inputs contribute to it. A resume replays the cached value for a matching key even if the producer has since changed, so version the key (`"scan-v2"`) whenever its inputs or meaning change. Journaled producers are best-effort at-least-once and may run again across crashes or concurrent same-key callers, so keep side effects idempotent.
-- `ctx.session`: The session returned by `joinSession`, without the APIs that start and resume factory runs. Call `extensions_manage` with `operation: "guide"` to read more about the session APIs.
+- `ctx.session`: The session returned by `joinSession`. It refuses calls that start or resume a factory run. Call `extensions_manage` with `operation: "guide"` to read more about the session APIs.
 - `ctx.signal`: Cooperative cancellation signal for extension work and subprocesses.
 - `ctx.factory(...)`: Always rejects because nested factories are not supported.
 

nodejs/src/factory.ts

@@ -175,8 +175,8 @@ export interface FactoryContext<TArgs extends JsonValue = JsonValue> {
     /** Caller-supplied input, forwarded verbatim. */
     args: TArgs;
     /**
-     * The session instance returned by `joinSession`, without the APIs that
-     * start and resume factory runs.
+     * The session instance returned by `joinSession`. It refuses calls that
+     * start or resume a factory run.
      */
     session: CopilotSession;
     /** Cooperative cancellation signal for the current factory run. */

nodejs/test/factory.test.ts

@@ -446,7 +446,7 @@ describe("factories", () => {
             "Options are exactly `label`, `schema`, `model`, `agent`, `reasoningEffort`, and `contextTier`"
         );
         expect(normalizedGuide).toContain(
-            "session returned by `joinSession`, without the APIs that start and resume factory runs"
+            "session returned by `joinSession`. It refuses calls that start or resume a factory run"
         );
 
         expect(normalizedPublicApi).toContain("SDK-initiated runs do not request permission");
@@ -457,7 +457,7 @@ describe("factories", () => {
         expect(normalizedPublicApi).toContain("SDK-initiated resumes do not request permission");
         expect(normalizedPublicApi).toContain("with a documented resume code rejects with");
         expect(normalizedPublicApi).toContain(
-            "session instance returned by `joinSession`, without the APIs that start and resume factory runs"
+            "session instance returned by `joinSession`. It refuses calls that start or resume a factory run"
         );
     });