[AAASM-4807] 📝 (examples): Fix real-integration snippets to use existing SDK APIs

[Chisanan232]

What changed

The sidecar-runtime scenario's snippets labeled "real integration" taught a
non-existent SDK API in both languages: ctx.client.call_tool("read_file", path=...)
(Python) and ctx.client.callTool(...) (Node). Neither exists — the Python
GatewayClient has no call_tool (its dispatch method is the async
dispatch_tool(tool_name, args: dict)), and the Node AssemblyContext has no
client at all (tool governance is withAssembly(tools, { gatewayClient })).

This corrects both snippets (in README.md and the node agent's comments) to the
actual published SDK surface, verified against the sibling python-sdk /
node-sdk sources:

• Python — init_assembly() registers the agent and wires the framework
  adapter, which governs each call via the runtime interceptor (check_tool_start);
  the direct client path is the async ctx.client.dispatch_tool("read_file", {"path": ...}).
• Node — withAssembly(tools, { gatewayClient, agentId }) wraps each tool's
  execute() with a pre-execution check that throws PolicyViolationError on deny.

The offline stand-in shims are left functionally untouched, but their comments no
longer claim to mirror the exact SDK method names — they are relabeled as
teaching stand-ins pointing at the real API.

Related ticket

Closes AAASM-4807

Jira: https://lightning-dust-mite.atlassian.net/browse/AAASM-4807

How to verify

• node --check scenarios/sidecar-runtime/examples/node-agent/agent.js passes.
• Each corrected API exists in the SDK sources: withAssembly /
  PolicyViolationError (node-sdk/src/index.ts), the { gatewayClient, agentId }
  options (node-sdk/src/wrappers/with-assembly.ts), init_assembly +
  AssemblyContext.client + async dispatch_tool (python-sdk/agent_assembly/).

Checklist

• PR title follows [AAASM-XXXX] <GitEmoji> (<scope>): <summary>
• No secrets, API keys, or .env files committed
• Example sub-projects include their own README.md with prerequisites and run instructions
• SDK/runtime version dependencies are documented or pinned

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[Chisanan232]

🤖 Claude Code — PR review

Scope (AAASM-4807, MED): ✅ corrected the 'real integration' snippets that taught a non-existent ctx.client.call_tool/callTool in both SDKs → real ctx.client.dispatch_tool(name, {dict}) (python) and withAssembly(tools,{gatewayClient,agentId}) throwing PolicyViolationError (node), every symbol grep-verified against SDK sources.

1. CI — ✅ all green (24). node --check passes.
2. Scope/ready — ✅ two in-scope files only; offline shims untouched; disjoint from [AAASM-4804] 🐛 (examples): Fix broken node live-core driver (non-existent ctx.client.callTool) #333.
3. Side effects — none (docs/comments only).
4. FE — n/a.

Verdict: ready to merge pending Pioneer approval.