[Fleet Execution] [Database Triggers 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 from a database trigger or event stream (e.g., using Supabase webhooks, PostgreSQL listen/notify, or MongoDB change streams).

Code-Level Diagnosis

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

Current Implementation

// Missing example

Proposed Implementation

Files to modify: Create packages/core/examples/database-triggers/index.ts and packages/core/examples/database-triggers/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,7 @@
 Orchestrate complex, long-running coding tasks to an ephemeral cloud environment integrated with a GitHub repo.
 
 ## Examples
 
 - [Basic Session](./examples/basic-session/README.md)
+- [Database Triggers](./examples/database-triggers/README.md)

Test Scenarios

1. The example code correctly implements a database trigger listener or webhook handler that initiates a Jules session.
2. Follow the README.md instructions -> Instructions correctly guide a user to set up the database trigger and run the example.

Target Files

• packages/core/examples/database-triggers/index.ts
• packages/core/examples/database-triggers/README.md
• packages/core/examples/database-triggers/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:14750404909885933131
• Link: https://jules.google.com/session/14750404909885933131