Skip to content

[Fleet Execution] Implement Tier 1 Deterministic SDK Examples #248

@jules-fleet

Description

@jules-fleet

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

Implement deterministic Tier 1 scripts to demonstrate basic SDK usage without agentic workflows. This includes Basic Design Generation, Browse and Export, Batch Generation, and Screenshot Gallery.

Code-Level Diagnosis

Code path: packages/sdk/examples/
Mechanism: Currently, the examples folder contains individual .ts files, but lacks structured directories (basic-design, browse-and-export, batch-generation, screenshot-gallery) with their own README.md and index.ts files as specified by the new standard.
Root cause: Missing architectural scaffolding for foundational deterministic examples.

Current Implementation

// Missing directory structure for deterministic scripts.

Proposed Implementation

Files to modify: Create directories and files for each Tier 1 script.

Integration (Before -> After)

+ packages/sdk/examples/basic-design/index.ts
+ packages/sdk/examples/basic-design/README.md
+ packages/sdk/examples/browse-and-export/index.ts
+ packages/sdk/examples/browse-and-export/README.md
+ packages/sdk/examples/batch-generation/index.ts
+ packages/sdk/examples/batch-generation/README.md
+ packages/sdk/examples/screenshot-gallery/index.ts
+ packages/sdk/examples/screenshot-gallery/README.md

Test Scenarios

  1. Basic Design Script: Execute bun index.ts -> Should successfully generate screen and output HTML and Image URL.
  2. Batch Generation: Provide JSON prompt list -> Execute script -> Outputs multiple generated screen details.

Target Files

  • packages/sdk/examples/basic-design/README.md
  • packages/sdk/examples/basic-design/index.ts
  • packages/sdk/examples/browse-and-export/README.md
  • packages/sdk/examples/browse-and-export/index.ts
  • packages/sdk/examples/batch-generation/README.md
  • packages/sdk/examples/batch-generation/index.ts
  • packages/sdk/examples/screenshot-gallery/README.md
  • packages/sdk/examples/screenshot-gallery/index.ts
  • packages/sdk/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

Metadata

Metadata

Assignees

No one assigned

    Labels

    fleetFleet-managed issue

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions