feat: Add gateway and API urls to sync input

[adamspofford-dfinity]

Makes plugins aware of the deployment network's configured API URL and gateway URL. Plugins do not have HTTP access and so cannot actually call these URLs, but making a canister aware of its own URL allows it to serve frontend HTTP content referencing sibling canisters better.

_{Stack created with GitHub Stacks CLI • Give Feedback 💬}

[Copilot]

🟡 Changes recommended

The modified v0.2 WIT record breaks compatibility with existing v0.2 plugin binaries and requires a new interface version.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds deployment network API and gateway URLs to sync plugin inputs.

Changes:

• Resolves and propagates network URLs through sync operations.
• Extends the plugin WIT/runtime interface and documentation.
• Adds URL passthrough tests and example output.

File summaries

File	Description
examples/icp-sync-plugin/plugin/src/lib.rs	Reports network URLs.
docs/guides/writing-sync-plugins.md	Documents URL usage.
docs/concepts/sync-plugins.md	Describes new input fields.
crates/icp/src/operations/sync.rs	Propagates URLs through synchronization.
crates/icp/src/operations/deploy.rs	Resolves URLs during deployment.
crates/icp/src/network/mod.rs	Adds URL-only network access.
crates/icp/src/network/access.rs	Introduces NetworkUrls.
crates/icp/src/canister/sync/script.rs	Updates test parameters.
crates/icp/src/canister/sync/plugin.rs	Passes URLs to plugin runtime.
crates/icp/src/canister/sync/mod.rs	Adds URLs to sync parameters.
crates/icp-sync-plugin/tests/fixtures/test-plugin/src/lib.rs	Echoes URL inputs in tests.
crates/icp-sync-plugin/sync-plugin.wit	Adds API and gateway fields.
crates/icp-sync-plugin/src/runtime.rs	Supplies URLs to v2 plugins.
crates/icp-sync-plugin/DESIGN.md	Updates runtime design documentation.
crates/icp-sync-plugin/Cargo.toml	Adds the URL dependency.
crates/icp-cli/tests/sync_tests.rs	Verifies managed-network URL output.
crates/icp-cli/src/commands/sync.rs	Resolves URLs for direct sync.
Cargo.lock	Records the dependency update.

Review details

• Files reviewed: 17/18 changed files
• Comments generated: 1
• Review effort level: Balanced

---

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