Skip to content

feat(api): workflow outline, workspace schedules list, clearer v2 errors, and catalog value types - #9905

Merged
waleedlatif1 merged 7 commits into
stagingfrom
feat/v2-agent-authoring
Nov 11, 2026
Merged

waleedlatif1 merged 7 commits into
stagingfrom
feat/v2-agent-authoring

Conversation

@waleedlatif1

Copy link
Copy Markdown
Collaborator

Summary

  • v2 errors include an optional error.traceId (same id as the x-request-id header), and validation messages name where the problem is, e.g. body.limit: .... v1 and internal error output is unchanged. Named traceId because v2 already uses requestId for a client-supplied operation id.
  • The read-only API key 403 now ends with "Use a full-access API key." details.code is unchanged.
  • Block catalog fields expose valueType from the block's declared inputs, next to the editor type. Shared projection, so Copilot sees the same thing. Absent when it can't be derived; no generated examples.
  • New GET /api/v2/workflows/{id}/outline: a compact, read-only view of the draft (same authorization as /state, output is a subset of it). Documented as never to be PUT back to /state.
  • New GET /api/v2/schedules?workspaceId=: every live schedule in a workspace, cursor-paged, sharing the per-workflow list's row predicate.
  • Schedule cron/timezone stay editable only by editing the schedule block and deploying: deploys recompute the schedule row from the deployed block, and rescheduling reads the deployed block's timezone, so a live-row edit would be half-applied and reverted. The field descriptions and CLI docs now say this.

Test plan

  • Generators current: openapi, mcp-operations, cli-api, cli-docs, v2-route-table; check:api-validation:strict, check-openapi-specs
  • Targeted vitest: list-pagination, query-declaration, cross-cutting, catalog projection, MCP catalog/dispatch, v2 builders/validation, execute/logs/chat-deployment/knowledge/uploads routes, openapi documents, sim-cli contract/client
  • valueType test fails with the join removed
  • CI gate (type-check, audits, full suite)

@vercel

vercel Bot commented Nov 11, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Nov 11, 2026 10:21pm UTC

Request Review

@greptile-apps

greptile-apps Bot commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Medium impact] The latest changes appear safe to merge.

Summary

This PR adds workflow outlines, workspace schedule lists, catalog value types, and clearer v2 errors.

  • Callers can read a compact outline of a workflow draft.
  • Callers can page through schedules run by a workspace’s deployed workflows.
  • Catalog fields can report the type of value they hold.
  • V2 errors now show request IDs and where validation failed.
  • Read-only API key denials tell callers which key to use.
  • Generated docs baselines track the added API and CLI pages.

Reviews (4) · Last reviewed commit: "docs(api): say the outline's derived fie..." · Reviewed by Greptile

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 43 files

Reply with feedback, questions, or to request a fix.

Turn on auto-fix | Re-trigger cubic

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@greptile

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Nov 11, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@greptile

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Nov 11, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 45 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Turn on auto-fix | Re-trigger cubic

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@greptile

@waleedlatif1

Copy link
Copy Markdown
Collaborator Author

@cubic-dev-ai review this PR

@cubic-dev-ai

cubic-dev-ai Bot commented Nov 11, 2026

Copy link
Copy Markdown
Contributor

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 45 files

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

Turn on auto-fix | Re-trigger cubic

This branch was successfully deployed

1 active deployment
Preview — 615fc62c Deployed Nov 11, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant