[Fleet Execution] [Webhook Integration Example]

[davideast]

Goal Reference

This issue was generated from .fleet/goals/sdk-examples.md. The worker agent should read this file for full context including verification commands, constraints, and structural guidance.

Objective

Create an example demonstrating how to trigger a Jules session via a webhook. This aligns with event-driven workflows utilizing frameworks like Express or Hono.

Code-Level Diagnosis

Code path: packages/core/examples/webhook/
Mechanism: The packages/core/examples/webhook/ directory and its corresponding examples are entirely missing.
Root cause: The SDK lacks a runnable, practical example of integrating Jules with webhook events.

Current Implementation

// Missing example

Proposed Implementation

Files to modify: Create packages/core/examples/webhook/index.ts (using Hono or Express) and packages/core/examples/webhook/README.md. Update packages/core/README.md to link to the new example.

Integration (Before -> After)

--- a/packages/core/README.md
+++ b/packages/core/README.md
@@ -10,6 +10,10 @@
 Orchestrate complex, long-running coding tasks to an ephemeral cloud environment integrated with a GitHub repo.
 
+## Examples
+
+- [Basic Session](./examples/basic-session/README.md)
+- [Advanced Session](./examples/advanced-session/README.md)
+- [Agent Workflow](./examples/agent/README.md)
+- [Webhook Integration](./examples/webhook/README.md)
+
 ## Send work to a Cloud based session

Test Scenarios

1. Run bun run index.ts (or equivalent) in the webhook directory -> Server starts up. Sending a POST request to the webhook endpoint successfully creates a Jules session.
2. Follow the README.md instructions -> Instructions correctly guide a user to run the example and send requests.

Target Files

• packages/core/examples/webhook/index.ts
• packages/core/examples/webhook/README.md
• packages/core/examples/webhook/package.json
• packages/core/README.md

Boundary Rules

Restrict your modifications exclusively to the files listed in the Target Files section. Ensure your source changes are entirely backward-compatible if unowned tests outside your boundary fail. Retain all existing file names and locations outside your explicitly declared target list.

---

Fleet Context

• Source: jules:session:14691557552061927599
• Link: https://jules.google.com/session/14691557552061927599