Skip to content

feat: add JSON schema generation from Zod#661

Merged
Hweinstock merged 1 commit intomainfrom
feat/json-schema-generation
Mar 26, 2026
Merged

feat: add JSON schema generation from Zod#661
Hweinstock merged 1 commit intomainfrom
feat/json-schema-generation

Conversation

@Hweinstock
Copy link
Copy Markdown
Contributor

@Hweinstock Hweinstock commented Mar 26, 2026

Description

Adds tooling to generate a JSON Schema from the Zod AgentCoreProjectSpecSchema, using Zod v4's built-in toJSONSchema. The generated schema enables IDE autocomplete and validation for agentcore.json files.

See demo internally.

Notes:

  • trusting the domain will be required until we are in a trusted catalog, ex https://github.com/SchemaStore/schemastore. However, its pretty easy for customers to figure out.
  • the branch suffix in the schema url is only used to test serving the schema from this branch, in production it will be schema.agentcore.aws.dev/v*.
  • we are not yet pushing it into generated projects automatically until we are ready to release to customers and the schema is ready to be served from mainline.
  • schema generation is currently a manual process, but eventually we should combine it with release. The risk is that committing a change IS releasing a change to customers, so we guard this process behind PR for now.

Related Issues

N/A

Documentation PR

N/A

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation update
  • Other (please describe):

Testing

How have you tested the change?

  • I ran npm run typecheck
  • I ran npm run lint

Checklist

  • I have read the CONTRIBUTING document
  • I have added any necessary tests that prove my fix is effective or my feature works
  • I have updated the documentation accordingly
  • I have added an appropriate example to the documentation to outline the feature, or no new docs are needed
  • My changes generate no new warnings
  • Any dependent changes have been merged and published

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the
terms of your choice.

@github-actions github-actions bot added the size/xl PR size: XL label Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from e188520 to edf03d8 Compare March 26, 2026 11:53
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 26, 2026

Coverage Report

Status Category Percentage Covered / Total
🔵 Lines 45.67% 6440 / 14101
🔵 Statements 45.22% 6831 / 15106
🔵 Functions 44.38% 1153 / 2598
🔵 Branches 45.57% 4197 / 9208
Generated in workflow #1383 for commit 6029ce6 by the Vitest Coverage Report Action

@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from edf03d8 to 4bee05e Compare March 26, 2026 11:55
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from 4bee05e to 3836dba Compare March 26, 2026 11:57
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from 3836dba to b3c6792 Compare March 26, 2026 12:00
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from b3c6792 to d6735b7 Compare March 26, 2026 12:04
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from d6735b7 to 79ef9a2 Compare March 26, 2026 12:26
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from 79ef9a2 to 61f7b3f Compare March 26, 2026 13:54
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from dd6a31f to 6678f9b Compare March 26, 2026 18:15
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from 6678f9b to 2c253e3 Compare March 26, 2026 20:13
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from 2c253e3 to 4e70b68 Compare March 26, 2026 20:15
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from 4e70b68 to f9f4d44 Compare March 26, 2026 20:25
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock force-pushed the feat/json-schema-generation branch from f9f4d44 to 6029ce6 Compare March 26, 2026 20:42
@github-actions github-actions bot added size/xl PR size: XL and removed size/xl PR size: XL labels Mar 26, 2026
@Hweinstock Hweinstock merged commit 2d02eeb into main Mar 26, 2026
21 checks passed
@Hweinstock Hweinstock deleted the feat/json-schema-generation branch March 26, 2026 23:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/xl PR size: XL

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants