Skip to content

refactor(telemetry): rename Workflow Insight to Durable Execution Telemetry - #1019

Merged
ParidelPooya merged 3 commits into
mainfrom
rename-insight-to-telemetry
Oct 19, 2026
Merged

ParidelPooya merged 3 commits into
mainfrom
rename-insight-to-telemetry

Conversation

@ParidelPooya

@ParidelPooya ParidelPooya commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary

This PR renames the Workflow Insight packages to Durable Execution Telemetry. The old names are not accepted after this change.

Before After Display name
@aws/durable-execution-sdk-js-insight @aws/durable-execution-sdk-js-telemetry-exporter Durable Execution Telemetry Exporter
@aws/durable-execution-sdk-js-insight-mcp @aws/durable-execution-sdk-js-telemetry-mcp Durable Execution Telemetry MCP
aws-durable-execution-sdk-js-insight-vscode aws-durable-execution-sdk-js-telemetry-vscode Durable Execution Telemetry VSCode
aws-durable-execution-sdk-js-insight-desktop aws-durable-execution-sdk-js-telemetry-desktop Durable Execution Telemetry Desktop
@aws/durable-execution-sdk-js-insight-core (private) @aws/durable-execution-sdk-js-telemetry-core –

Breaking changes

All of these are renamed. The readers accept only the new values.

  • Public API: workflowInsight() is now durableExecutionTelemetry(), WorkflowInsightRecord is now DurableExecutionTelemetryRecord, InsightExporter is now TelemetryExporter, and InsightConfig is now TelemetryConfig. The other Insight* names change the same way.
  • Record discriminator: recordType: "WorkflowInsight" is now "DurableExecutionTelemetry". The explorers and the MCP server do not find records written before this change.
  • Default table and index names: workflow_insight and workflow-insight are now durable_execution_telemetry and durable-execution-telemetry.
  • EventBridge source: aws.durable-execution.insight is now software.amazon.lambda.durable.telemetry (EventBridge reserves the aws. prefix for AWS services; this matches the Java SDK).
  • VS Code settings: workflowInsight.* is now durableExecutionTelemetry.*.
  • Desktop: insight-settings.json is now telemetry-settings.json, and insight-favorites.json is now telemetry-favorites.json. The product name, and therefore the app data directory, is now "Durable Execution Telemetry Desktop".
  • MCP: the durable-insight-mcp command is now durable-telemetry-mcp, and the DURABLE_INSIGHT_* environment variables are now DURABLE_TELEMETRY_*.
  • The VS Code extension ID changes, so installed copies do not upgrade in place.

Release wiring

  • Tag prefixes: insight- is now telemetry-exporter-, mcp- is now telemetry-mcp-, and workflow-insight-vscode-v is now telemetry-vscode-v.
  • Commit scope: insight is now telemetry.
  • The npm publish list, CI jobs and RELEASING.md point at the new package paths.

Not renamed

The following names refer to other AWS products or to the plain English word, so they are unchanged:

  • CloudWatch Logs Insights, including logsInsights.ts and runLogsInsightsQuery.
  • Application Insights.
  • The word "insights".

Testing

I ran these locally on Node 22. All of them pass.

  • npm ci (root and webview-ui), using the updated lockfile.
  • npm run build.
  • verify-declared-files-shipped.mjs.
  • npm run typecheck:hosts.
  • Webview tsc --noEmit.
  • The vscode, desktop and mcp host builds.
  • lint:ci, lint:versions, lint:filenames and lint:suppressions.
  • npm run test: all workspaces pass. Three suites are skipped; the same suites are skipped on main.

Follow-ups outside this PR

  • npm trusted publishing (OIDC) must be configured for the two new package names before the next release. If it is not, the publish of those two packages fails.
  • Run npm deprecate on @aws/durable-execution-sdk-js-insight and @aws/durable-execution-sdk-js-insight-mcp, pointing users at the new names.
  • Open PRs that touch the old package paths will need a rebase.

@ParidelPooya
ParidelPooya temporarily deployed to ai-pr-review-runtime October 19, 2026 15:36 — with GitHub Actions Inactive
@ParidelPooya
ParidelPooya temporarily deployed to ai-pr-review-runtime October 19, 2026 15:37 — with GitHub Actions Inactive
@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

hln33
hln33 previously approved these changes Oct 19, 2026
Comment thread RELEASING.md Resolved
ParidelPooya added a commit to aws/aws-durable-execution-sdk-java that referenced this pull request Oct 19, 2026
Rename the insight-plugin module to telemetry-exporter, the artifactId to
aws-durable-execution-sdk-java-plugin-telemetry-exporter and the Java package to
software.amazon.lambda.durable.telemetry. Rename the public API, the recordType
discriminator and the default resource names to match the JavaScript SDK
(aws/aws-durable-execution-sdk-js#1019). Old names are no longer accepted.
@ParidelPooya
ParidelPooya temporarily deployed to ai-pr-review-runtime October 19, 2026 18:39 — with GitHub Actions Inactive
hln33
hln33 previously approved these changes Oct 19, 2026
@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

…emetry

Rename the Workflow Insight packages, public API, persisted values and
release wiring to Durable Execution Telemetry.

Packages and directories:
- @aws/durable-execution-sdk-js-insight -> @aws/durable-execution-sdk-js-telemetry-exporter
- @aws/durable-execution-sdk-js-insight-mcp -> @aws/durable-execution-sdk-js-telemetry-mcp
- @aws/durable-execution-sdk-js-insight-core -> @aws/durable-execution-sdk-js-telemetry-core
- aws-durable-execution-sdk-js-insight-vscode -> aws-durable-execution-sdk-js-telemetry-vscode
- aws-durable-execution-sdk-js-insight-desktop -> aws-durable-execution-sdk-js-telemetry-desktop

BREAKING CHANGE: the public API, the record discriminator
(recordType "DurableExecutionTelemetry"), default table/index names,
the EventBridge source, VS Code settings keys, environment variables
and the desktop settings file are renamed. Old names are not accepted.
EventBridge reserves the "aws." source prefix for AWS services, so the
default aws.durable-execution.telemetry would be rejected. Use
software.amazon.lambda.durable.telemetry, matching the Java SDK.
@ParidelPooya
ParidelPooya force-pushed the rename-insight-to-telemetry branch from 40f1e9a to 7ba55cd Compare October 19, 2026 23:20
@ParidelPooya
ParidelPooya temporarily deployed to ai-pr-review-runtime October 19, 2026 23:21 — with GitHub Actions Inactive
@github-actions

Copy link
Copy Markdown

Codex AI review

No actionable findings in the PR changes. Residual test risk: builds, tests, and ESM/CommonJS and host packaging were reviewed statically but not executed, as requested.

Reviewed commit 7ba55cd28cf8983706220d3d9a77328d21089650. Workflow run

@ParidelPooya
ParidelPooya merged commit 5f0c707 into main Oct 19, 2026
37 checks passed
@ParidelPooya
ParidelPooya deleted the rename-insight-to-telemetry branch October 19, 2026 23:55
hln33 added a commit that referenced this pull request Oct 26, 2026
By submitting this pull request, I confirm that my contribution is made
under the terms of the Apache 2.0 license.

### Issue Link, if available

Stacked on #1019. This PR targets `rename-insight-to-telemetry` and
should merge after #1019.

Replaces #1029 with a branch in `aws/aws-durable-execution-sdk-js`. Both
PRs contain the same commits through `31503917`.

### Description

- Bump the telemetry exporter and MCP packages from `0.1.0-alpha.0` to
stable `1.0.0`. Update their root lockfile entries.
- Remove all 41 exporter `@experimental` annotations. MCP has no such
annotations.
- Remove the repository README sentence describing Durable Execution
Telemetry as preview.

Runtime implementations, API signatures, and other package versions are
unchanged.

### Demo/Screenshots

Not applicable. These changes affect package metadata and documentation.

### Checklist

- [x] I have filled out every section of the PR template
- [x] I have thoroughly tested this change

### Testing

- Node 22: full `npm run build` and `npm run test` passed.
- `lint:ci`, `lint:versions`, `lint:filenames`, `lint:suppressions`, and
`typecheck:hosts` passed.
- Packaging checks passed for both packages. All 32 declaration files in
the exporter tarball contain no experimental annotations.
- Five temporary stability checks and five release checks passed. The
built MCP server reports `1.0.0` during initialization.

#### Unit Tests

5,141 Jest tests passed, with six existing skips. Two Vitest tests
passed. These totals include 81 exporter tests and 404 MCP tests.

No runtime behavior changed. Focused metadata and documentation checks
ran outside the repository; no source test files were added.

#### Integration Tests

Local integration tests passed through `npm run test`. Cloud tests were
not run. No deployment or npm publication was performed.

#### Examples

Not applicable. No public API or example behavior changed.

### CI note

The same-repository head removes the fork restriction on integration
tests. The build workflow still only matches PR bases `main` and `v1.x`.
The usual build and integration workflow will not run while this PR
targets the parent branch.

---------

Co-authored-by: Pooya Paridel <[email protected]>
Popy21 pushed a commit to Popy21/aws-durable-execution-sdk-go that referenced this pull request Nov 6, 2026
Rename Workflow Insight to Durable Execution Telemetry, as the
JavaScript SDK does in aws/aws-durable-execution-sdk-js#1019. The
explorer and MCP server of the JavaScript SDK read the records of every
SDK, so the persisted values must match. The old names are not
accepted.

- The insight module is now the telemetry module, at
  github.com/aws/aws-durable-execution-sdk-go/telemetry, with package
  telemetry. Its display name is Durable Execution Telemetry Exporter.
- InsightPlugin is now TelemetryPlugin. Other exported names keep their
  names in the new package.
- recordType is "DurableExecutionTelemetry". The default prefixes and
  index are durable-execution-telemetry, the default tables
  durable_execution_telemetry, and the default EventBridge source
  aws.durable-execution.telemetry.
- The insight-plugin example is now telemetry-exporter.
- The release tool, CI, scripts, and docs use the telemetry module and
  its telemetry/vX.Y.Z tags. The insight module was never tagged.
- The release notes record the rename.

This branch was previously deployed

1 inactive deployment
ai-pr-review-runtime — 7ba55cd2 Deployed Oct 19, 2026 by ParidelPooya via ai-pr-review / Codex review / Generate Codex review #1368
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.

2 participants