Skip to content

feat: instrument telemetry for create command - #1202

Merged
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry
May 11, 2026
Merged

feat: instrument telemetry for create command#1202
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry

Conversation

@Hweinstock

@HweinstockHweinstock commented May 11, 2026

Copy link
Copy Markdown
Contributor

Description

Add telemetry instrumentation to the create command for both CLI and TUI paths.

  • CLI path: wrapped handleCreateCLI with runCliCommand('create', ...) to emit CreateAttrs on success/failure
  • TUI path: wrapped useCreateFlow's run() with withCommandRunTelemetry('create', ...)
  • Widened CreateAttrs.agent_type to use the shared AgentType enum (includes 'byo')
  • Added telemetry assertions to existing integration tests

Attributes emitted: language, framework, model_provider, memory, protocol, build, agent_type, network_mode, has_agent

Related Issue

Closes #

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 test:unit and npm run test:integ
  • I ran npm run typecheck
  • I ran npm run lint
  • If I modified src/assets/, I ran npm run test:update-snapshots and committed the updated snapshots

Additional testing:

  • Integration tests pass (11/11 in create-frameworks + create-edge-cases)
  • E2E verified with tarball: telemetry JSONL correctly emitted for both success and failure paths

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-actionsgithub-actionsBot added the size/m PR size: M label May 11, 2026
@github-actionsgithub-actionsBot added the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Package Tarball

aws-agentcore-0.13.1.tgz

How to install

npm install https://github.com/aws/agentcore-cli/releases/download/pr-1202-tarball/aws-agentcore-0.13.1.tgz

@agentcore-cli-automationagentcore-cli-automation left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Nice work wiring up telemetry for create! I only found one issue worth flagging before merge — see the inline comment about the BYO path in the TUI instrumentation.

Comment threadsrc/cli/tui/screens/create/useCreateFlow.ts Outdated
@github-actionsgithub-actionsBot removed the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
@Hweinstock
Hweinstockforce-pushed the feat/create-telemetry branch from 5edb792 to cbe5fe1CompareMay 11, 2026 21:06
@github-actionsgithub-actionsBot added size/m PR size: M and removed size/m PR size: M labels May 11, 2026
@Hweinstock
Hweinstock marked this pull request as ready for review May 11, 2026 21:13
@Hweinstock
Hweinstock requested a review from a teamMay 11, 2026 21:13

@notgitikanotgitika 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.

looks great to me, thanks!

@Hweinstock
Hweinstock merged commit bceddde into aws:mainMay 11, 2026
24 checks passed
@Hweinstock
Hweinstock deleted the feat/create-telemetry branch May 11, 2026 21:40
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
tejaskash pushed a commit that referenced this pull request May 13, 2026
* docs: add telemetry instrumentation guide (#1197)
* chore: replace PAT tokens with GitHub App token (#1198)
Replace secrets.PAT_TOKEN and secrets.AUTOMATION_ACCOUNT_PAT_TOKEN with
short-lived tokens generated by the agentcore-devx-automation GitHub App
(ID: 3637953) via actions/create-github-app-token@v1.
This improves security by using ephemeral tokens scoped to the
installation rather than long-lived personal access tokens.
Requires adding repo variable APP_ID=3637953 and repo secret
APP_PRIVATE_KEY with the app's RSA private key.
* fix: add batch eval, recommendation, and CloudWatch Logs write permissions to docs (#1113)
* feat: instrument telemetry for create command (CLI + TUI) (#1202)
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
* chore: replace all github.token/GITHUB_TOKEN with GitHub App token
Replaces all occurrences of \${{ github.token }} and \${{ secrets.GITHUB_TOKEN }}
across .github/workflows/ with a per-job GitHub App token generated via
actions/create-github-app-token@v1 using vars.APP_ID and secrets.APP_PRIVATE_KEY.
* fix: bump versions to resolve security audit failure
* revert: keep pr-title.yml using GITHUB_TOKEN (read-only access sufficient)
* feat(evaluator): add kmsKeyArn support for custom evaluator (#994)
* feat(evaluator): Add kmsKeyArn support for custom evaluator
* fix: sync package-lock.json with package.json
The lock file was out of sync after dependency bumps on main were merged,
causing npm ci to fail in CI.
* fix: revert unrelated dep bumps and fix formatting
Reverts @opentelemetry/exporter-metrics-otlp-http ^0.217.0 back to
^0.214.0 and secretlint ^13.0.0 back to ^12.2.0 — these were
accidentally included in the feature commit from unmerged dependabot PRs
and introduce high-severity protobufjs vulnerabilities.
Restores fast-xml-parser and @aws-sdk/xml-builder overrides that were
also inadvertently removed.
Fixes Prettier formatting on agentcore-project.ts import lines.
* fix: sync package-lock.json with updated dependencies
---------
Co-authored-by: notgitika <gitijh@gmail.com>
* refactor: unify result types with discriminated Result<T, E> union (#1125)
* refactor: unify result types with discriminated Result<T, E> union
Introduce a shared Result<T, E> type (inspired by Rust's Result) that
replaces ad-hoc { success: boolean; error?: string } patterns across
the codebase.
Key changes:
- Add src/lib/types.ts with Result<T, E> discriminated union type
- Add toError() helper in src/cli/errors.ts for catch blocks
- Migrate all command, operation, and primitive result types to Result<T>
- Error field is now Error (not string) on the failure branch
- Data fields only exist on the success branch (proper narrowing)
- Update all consumers to narrow before accessing branch-specific fields
- Update test assertions to match new Error objects and add narrowing
* docs: update AGENTS.md and telemetry README to reflect Result<T, E> type
* feat: record command attrs on telemetry failure via fallbackAttrs (#1204)
* feat: record command attrs on telemetry failure via fallbackAttrs
Add optional fallbackAttrs parameter to client.withCommandRun so
command-specific attributes are recorded even when the callback throws.
- client.ts: accept fallbackAttrs, use on failure instead of {}
- client.ts: run resilientParse on all non-empty attrs (not just success)
- cli-command-run.ts: withCommandRunTelemetry passes attrs as fallbackAttrs
- cli-command-run.ts: runCliCommand accepts optional knownAttrs param
- command.tsx: extract knownAttrs upfront, pass to runCliCommand
- client.test.ts: add unit tests for fallbackAttrs behavior
- create-edge-cases.test.ts: assert attrs present on failure entry
* chore: rebase onto mainline
* fix: sync-preview pushes directly on clean merge, PRs only on conflict (#1078)
* fix: sync-preview workflow restores version instead of ignoring files
Instead of keeping preview's entire package.json/package-lock.json
(which discards new deps, scripts, etc. from main), accept main's
content and surgically restore only the version field to preview's
value after merge.
* fix: push directly to preview on clean merge via GitHub App bypass
Use agentcore-devx-automation app token to bypass branch protection
and push directly when the merge is clean (or only version conflicts).
Only creates a PR when there are real conflicts in other files.
* chore: use app-slug instead of app-id for token generation
* fix: address review feedback on sync-preview workflow
- Pass PREVIEW_VERSION via env var instead of string interpolation in
node -e scripts (safer against special chars)
- Make git add of package-lock.json conditional on file existence to
match the earlier -f guard
- Replace loose title search for dedup with headRefName prefix filter
to avoid false positives from unrelated PRs
- Clarify why package.json/package-lock.json are special-cased (preview
carries a different version string that needs preserving)
* fix: restore preview-owned files after sync merge
Adds a step to restore schemas/agentcore.schema.v1.json and CHANGELOG.md
to preview's versions after merging main. These files are auto-generated
during preview releases — schema-check CI rejects direct modifications
to schemas/, and CHANGELOG.md tracks preview releases separately.
* fix: use app-id instead of app-slug for GitHub App token
Aligns with the pattern in PR #1210 and ci-failure-issue.yml.
* feat: instrument telemetry for deploy command (CLI + TUI) (#1206)
* chore: sync safe commits from main into preview
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
* chore: merge main into preview with Result refactor
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
---------
Co-authored-by: Hweinstock <42325418+Hweinstock@users.noreply.github.com>
Co-authored-by: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Co-authored-by: Gitika <53349492+notgitika@users.noreply.github.com>
Co-authored-by: Aidan Daly <aidandal@amazon.com>
Co-authored-by: Harrison Weinstock <hkobew@amazon.com>
Co-authored-by: aws-aditya21 <saivenki@amazon.com>
Co-authored-by: notgitika <gitijh@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/mPR size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Hweinstock@notgitika@agentcore-cli-automation
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
feat: instrument telemetry for create command by Hweinstock · Pull Request #1202 · aws/agentcore-cli · GitHub
Skip to content

feat: instrument telemetry for create command - #1202

Merged
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry
May 11, 2026
Merged

feat: instrument telemetry for create command#1202
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry

Conversation

@Hweinstock

@HweinstockHweinstock commented May 11, 2026

Copy link
Copy Markdown
Contributor

Description

Add telemetry instrumentation to the create command for both CLI and TUI paths.

  • CLI path: wrapped handleCreateCLI with runCliCommand('create', ...) to emit CreateAttrs on success/failure
  • TUI path: wrapped useCreateFlow's run() with withCommandRunTelemetry('create', ...)
  • Widened CreateAttrs.agent_type to use the shared AgentType enum (includes 'byo')
  • Added telemetry assertions to existing integration tests

Attributes emitted: language, framework, model_provider, memory, protocol, build, agent_type, network_mode, has_agent

Related Issue

Closes #

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 test:unit and npm run test:integ
  • I ran npm run typecheck
  • I ran npm run lint
  • If I modified src/assets/, I ran npm run test:update-snapshots and committed the updated snapshots

Additional testing:

  • Integration tests pass (11/11 in create-frameworks + create-edge-cases)
  • E2E verified with tarball: telemetry JSONL correctly emitted for both success and failure paths

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-actionsgithub-actionsBot added the size/m PR size: M label May 11, 2026
@github-actionsgithub-actionsBot added the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Package Tarball

aws-agentcore-0.13.1.tgz

How to install

npm install https://github.com/aws/agentcore-cli/releases/download/pr-1202-tarball/aws-agentcore-0.13.1.tgz

@agentcore-cli-automationagentcore-cli-automation left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Nice work wiring up telemetry for create! I only found one issue worth flagging before merge — see the inline comment about the BYO path in the TUI instrumentation.

Comment threadsrc/cli/tui/screens/create/useCreateFlow.ts Outdated
@github-actionsgithub-actionsBot removed the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
@Hweinstock
Hweinstockforce-pushed the feat/create-telemetry branch from 5edb792 to cbe5fe1CompareMay 11, 2026 21:06
@github-actionsgithub-actionsBot added size/m PR size: M and removed size/m PR size: M labels May 11, 2026
@Hweinstock
Hweinstock marked this pull request as ready for review May 11, 2026 21:13
@Hweinstock
Hweinstock requested a review from a teamMay 11, 2026 21:13

@notgitikanotgitika 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.

looks great to me, thanks!

@Hweinstock
Hweinstock merged commit bceddde into aws:mainMay 11, 2026
24 checks passed
@Hweinstock
Hweinstock deleted the feat/create-telemetry branch May 11, 2026 21:40
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
tejaskash pushed a commit that referenced this pull request May 13, 2026
* docs: add telemetry instrumentation guide (#1197)
* chore: replace PAT tokens with GitHub App token (#1198)
Replace secrets.PAT_TOKEN and secrets.AUTOMATION_ACCOUNT_PAT_TOKEN with
short-lived tokens generated by the agentcore-devx-automation GitHub App
(ID: 3637953) via actions/create-github-app-token@v1.
This improves security by using ephemeral tokens scoped to the
installation rather than long-lived personal access tokens.
Requires adding repo variable APP_ID=3637953 and repo secret
APP_PRIVATE_KEY with the app's RSA private key.
* fix: add batch eval, recommendation, and CloudWatch Logs write permissions to docs (#1113)
* feat: instrument telemetry for create command (CLI + TUI) (#1202)
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
* chore: replace all github.token/GITHUB_TOKEN with GitHub App token
Replaces all occurrences of \${{ github.token }} and \${{ secrets.GITHUB_TOKEN }}
across .github/workflows/ with a per-job GitHub App token generated via
actions/create-github-app-token@v1 using vars.APP_ID and secrets.APP_PRIVATE_KEY.
* fix: bump versions to resolve security audit failure
* revert: keep pr-title.yml using GITHUB_TOKEN (read-only access sufficient)
* feat(evaluator): add kmsKeyArn support for custom evaluator (#994)
* feat(evaluator): Add kmsKeyArn support for custom evaluator
* fix: sync package-lock.json with package.json
The lock file was out of sync after dependency bumps on main were merged,
causing npm ci to fail in CI.
* fix: revert unrelated dep bumps and fix formatting
Reverts @opentelemetry/exporter-metrics-otlp-http ^0.217.0 back to
^0.214.0 and secretlint ^13.0.0 back to ^12.2.0 — these were
accidentally included in the feature commit from unmerged dependabot PRs
and introduce high-severity protobufjs vulnerabilities.
Restores fast-xml-parser and @aws-sdk/xml-builder overrides that were
also inadvertently removed.
Fixes Prettier formatting on agentcore-project.ts import lines.
* fix: sync package-lock.json with updated dependencies
---------
Co-authored-by: notgitika <gitijh@gmail.com>
* refactor: unify result types with discriminated Result<T, E> union (#1125)
* refactor: unify result types with discriminated Result<T, E> union
Introduce a shared Result<T, E> type (inspired by Rust's Result) that
replaces ad-hoc { success: boolean; error?: string } patterns across
the codebase.
Key changes:
- Add src/lib/types.ts with Result<T, E> discriminated union type
- Add toError() helper in src/cli/errors.ts for catch blocks
- Migrate all command, operation, and primitive result types to Result<T>
- Error field is now Error (not string) on the failure branch
- Data fields only exist on the success branch (proper narrowing)
- Update all consumers to narrow before accessing branch-specific fields
- Update test assertions to match new Error objects and add narrowing
* docs: update AGENTS.md and telemetry README to reflect Result<T, E> type
* feat: record command attrs on telemetry failure via fallbackAttrs (#1204)
* feat: record command attrs on telemetry failure via fallbackAttrs
Add optional fallbackAttrs parameter to client.withCommandRun so
command-specific attributes are recorded even when the callback throws.
- client.ts: accept fallbackAttrs, use on failure instead of {}
- client.ts: run resilientParse on all non-empty attrs (not just success)
- cli-command-run.ts: withCommandRunTelemetry passes attrs as fallbackAttrs
- cli-command-run.ts: runCliCommand accepts optional knownAttrs param
- command.tsx: extract knownAttrs upfront, pass to runCliCommand
- client.test.ts: add unit tests for fallbackAttrs behavior
- create-edge-cases.test.ts: assert attrs present on failure entry
* chore: rebase onto mainline
* fix: sync-preview pushes directly on clean merge, PRs only on conflict (#1078)
* fix: sync-preview workflow restores version instead of ignoring files
Instead of keeping preview's entire package.json/package-lock.json
(which discards new deps, scripts, etc. from main), accept main's
content and surgically restore only the version field to preview's
value after merge.
* fix: push directly to preview on clean merge via GitHub App bypass
Use agentcore-devx-automation app token to bypass branch protection
and push directly when the merge is clean (or only version conflicts).
Only creates a PR when there are real conflicts in other files.
* chore: use app-slug instead of app-id for token generation
* fix: address review feedback on sync-preview workflow
- Pass PREVIEW_VERSION via env var instead of string interpolation in
node -e scripts (safer against special chars)
- Make git add of package-lock.json conditional on file existence to
match the earlier -f guard
- Replace loose title search for dedup with headRefName prefix filter
to avoid false positives from unrelated PRs
- Clarify why package.json/package-lock.json are special-cased (preview
carries a different version string that needs preserving)
* fix: restore preview-owned files after sync merge
Adds a step to restore schemas/agentcore.schema.v1.json and CHANGELOG.md
to preview's versions after merging main. These files are auto-generated
during preview releases — schema-check CI rejects direct modifications
to schemas/, and CHANGELOG.md tracks preview releases separately.
* fix: use app-id instead of app-slug for GitHub App token
Aligns with the pattern in PR #1210 and ci-failure-issue.yml.
* feat: instrument telemetry for deploy command (CLI + TUI) (#1206)
* chore: sync safe commits from main into preview
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
* chore: merge main into preview with Result refactor
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
---------
Co-authored-by: Hweinstock <42325418+Hweinstock@users.noreply.github.com>
Co-authored-by: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Co-authored-by: Gitika <53349492+notgitika@users.noreply.github.com>
Co-authored-by: Aidan Daly <aidandal@amazon.com>
Co-authored-by: Harrison Weinstock <hkobew@amazon.com>
Co-authored-by: aws-aditya21 <saivenki@amazon.com>
Co-authored-by: notgitika <gitijh@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/mPR size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Hweinstock@notgitika@agentcore-cli-automation
, 'i'); if (__m === '*' || __re.test(location.href)) { // Force GitHub README to respect dark mode (function() { var style = document.createElement('style'); style.textContent = ' .markdown-body { color-scheme: dark light; } .markdown-body pre { background: #161b22 !important; } .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; } .markdown-body table th, .markdown-body table td { border-color: #30363d !important; } .markdown-body img { background: #0d1117; } .markdown-body blockquote { border-left-color: #8b949e; } .markdown-body hr { border-color: #30363d; } '; document.head.appendChild(style); })(); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat: instrument telemetry for create command by Hweinstock · Pull Request #1202 · aws/agentcore-cli · GitHub
Skip to content

feat: instrument telemetry for create command - #1202

Merged
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry
May 11, 2026
Merged

feat: instrument telemetry for create command#1202
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry

Conversation

@Hweinstock

@HweinstockHweinstock commented May 11, 2026

Copy link
Copy Markdown
Contributor

Description

Add telemetry instrumentation to the create command for both CLI and TUI paths.

  • CLI path: wrapped handleCreateCLI with runCliCommand('create', ...) to emit CreateAttrs on success/failure
  • TUI path: wrapped useCreateFlow's run() with withCommandRunTelemetry('create', ...)
  • Widened CreateAttrs.agent_type to use the shared AgentType enum (includes 'byo')
  • Added telemetry assertions to existing integration tests

Attributes emitted: language, framework, model_provider, memory, protocol, build, agent_type, network_mode, has_agent

Related Issue

Closes #

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 test:unit and npm run test:integ
  • I ran npm run typecheck
  • I ran npm run lint
  • If I modified src/assets/, I ran npm run test:update-snapshots and committed the updated snapshots

Additional testing:

  • Integration tests pass (11/11 in create-frameworks + create-edge-cases)
  • E2E verified with tarball: telemetry JSONL correctly emitted for both success and failure paths

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-actionsgithub-actionsBot added the size/m PR size: M label May 11, 2026
@github-actionsgithub-actionsBot added the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Package Tarball

aws-agentcore-0.13.1.tgz

How to install

npm install https://github.com/aws/agentcore-cli/releases/download/pr-1202-tarball/aws-agentcore-0.13.1.tgz

@agentcore-cli-automationagentcore-cli-automation left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Nice work wiring up telemetry for create! I only found one issue worth flagging before merge — see the inline comment about the BYO path in the TUI instrumentation.

Comment threadsrc/cli/tui/screens/create/useCreateFlow.ts Outdated
@github-actionsgithub-actionsBot removed the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
@Hweinstock
Hweinstockforce-pushed the feat/create-telemetry branch from 5edb792 to cbe5fe1CompareMay 11, 2026 21:06
@github-actionsgithub-actionsBot added size/m PR size: M and removed size/m PR size: M labels May 11, 2026
@Hweinstock
Hweinstock marked this pull request as ready for review May 11, 2026 21:13
@Hweinstock
Hweinstock requested a review from a teamMay 11, 2026 21:13

@notgitikanotgitika 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.

looks great to me, thanks!

@Hweinstock
Hweinstock merged commit bceddde into aws:mainMay 11, 2026
24 checks passed
@Hweinstock
Hweinstock deleted the feat/create-telemetry branch May 11, 2026 21:40
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
tejaskash pushed a commit that referenced this pull request May 13, 2026
* docs: add telemetry instrumentation guide (#1197)
* chore: replace PAT tokens with GitHub App token (#1198)
Replace secrets.PAT_TOKEN and secrets.AUTOMATION_ACCOUNT_PAT_TOKEN with
short-lived tokens generated by the agentcore-devx-automation GitHub App
(ID: 3637953) via actions/create-github-app-token@v1.
This improves security by using ephemeral tokens scoped to the
installation rather than long-lived personal access tokens.
Requires adding repo variable APP_ID=3637953 and repo secret
APP_PRIVATE_KEY with the app's RSA private key.
* fix: add batch eval, recommendation, and CloudWatch Logs write permissions to docs (#1113)
* feat: instrument telemetry for create command (CLI + TUI) (#1202)
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
* chore: replace all github.token/GITHUB_TOKEN with GitHub App token
Replaces all occurrences of \${{ github.token }} and \${{ secrets.GITHUB_TOKEN }}
across .github/workflows/ with a per-job GitHub App token generated via
actions/create-github-app-token@v1 using vars.APP_ID and secrets.APP_PRIVATE_KEY.
* fix: bump versions to resolve security audit failure
* revert: keep pr-title.yml using GITHUB_TOKEN (read-only access sufficient)
* feat(evaluator): add kmsKeyArn support for custom evaluator (#994)
* feat(evaluator): Add kmsKeyArn support for custom evaluator
* fix: sync package-lock.json with package.json
The lock file was out of sync after dependency bumps on main were merged,
causing npm ci to fail in CI.
* fix: revert unrelated dep bumps and fix formatting
Reverts @opentelemetry/exporter-metrics-otlp-http ^0.217.0 back to
^0.214.0 and secretlint ^13.0.0 back to ^12.2.0 — these were
accidentally included in the feature commit from unmerged dependabot PRs
and introduce high-severity protobufjs vulnerabilities.
Restores fast-xml-parser and @aws-sdk/xml-builder overrides that were
also inadvertently removed.
Fixes Prettier formatting on agentcore-project.ts import lines.
* fix: sync package-lock.json with updated dependencies
---------
Co-authored-by: notgitika <gitijh@gmail.com>
* refactor: unify result types with discriminated Result<T, E> union (#1125)
* refactor: unify result types with discriminated Result<T, E> union
Introduce a shared Result<T, E> type (inspired by Rust's Result) that
replaces ad-hoc { success: boolean; error?: string } patterns across
the codebase.
Key changes:
- Add src/lib/types.ts with Result<T, E> discriminated union type
- Add toError() helper in src/cli/errors.ts for catch blocks
- Migrate all command, operation, and primitive result types to Result<T>
- Error field is now Error (not string) on the failure branch
- Data fields only exist on the success branch (proper narrowing)
- Update all consumers to narrow before accessing branch-specific fields
- Update test assertions to match new Error objects and add narrowing
* docs: update AGENTS.md and telemetry README to reflect Result<T, E> type
* feat: record command attrs on telemetry failure via fallbackAttrs (#1204)
* feat: record command attrs on telemetry failure via fallbackAttrs
Add optional fallbackAttrs parameter to client.withCommandRun so
command-specific attributes are recorded even when the callback throws.
- client.ts: accept fallbackAttrs, use on failure instead of {}
- client.ts: run resilientParse on all non-empty attrs (not just success)
- cli-command-run.ts: withCommandRunTelemetry passes attrs as fallbackAttrs
- cli-command-run.ts: runCliCommand accepts optional knownAttrs param
- command.tsx: extract knownAttrs upfront, pass to runCliCommand
- client.test.ts: add unit tests for fallbackAttrs behavior
- create-edge-cases.test.ts: assert attrs present on failure entry
* chore: rebase onto mainline
* fix: sync-preview pushes directly on clean merge, PRs only on conflict (#1078)
* fix: sync-preview workflow restores version instead of ignoring files
Instead of keeping preview's entire package.json/package-lock.json
(which discards new deps, scripts, etc. from main), accept main's
content and surgically restore only the version field to preview's
value after merge.
* fix: push directly to preview on clean merge via GitHub App bypass
Use agentcore-devx-automation app token to bypass branch protection
and push directly when the merge is clean (or only version conflicts).
Only creates a PR when there are real conflicts in other files.
* chore: use app-slug instead of app-id for token generation
* fix: address review feedback on sync-preview workflow
- Pass PREVIEW_VERSION via env var instead of string interpolation in
node -e scripts (safer against special chars)
- Make git add of package-lock.json conditional on file existence to
match the earlier -f guard
- Replace loose title search for dedup with headRefName prefix filter
to avoid false positives from unrelated PRs
- Clarify why package.json/package-lock.json are special-cased (preview
carries a different version string that needs preserving)
* fix: restore preview-owned files after sync merge
Adds a step to restore schemas/agentcore.schema.v1.json and CHANGELOG.md
to preview's versions after merging main. These files are auto-generated
during preview releases — schema-check CI rejects direct modifications
to schemas/, and CHANGELOG.md tracks preview releases separately.
* fix: use app-id instead of app-slug for GitHub App token
Aligns with the pattern in PR #1210 and ci-failure-issue.yml.
* feat: instrument telemetry for deploy command (CLI + TUI) (#1206)
* chore: sync safe commits from main into preview
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
* chore: merge main into preview with Result refactor
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
---------
Co-authored-by: Hweinstock <42325418+Hweinstock@users.noreply.github.com>
Co-authored-by: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Co-authored-by: Gitika <53349492+notgitika@users.noreply.github.com>
Co-authored-by: Aidan Daly <aidandal@amazon.com>
Co-authored-by: Harrison Weinstock <hkobew@amazon.com>
Co-authored-by: aws-aditya21 <saivenki@amazon.com>
Co-authored-by: notgitika <gitijh@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/mPR size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Hweinstock@notgitika@agentcore-cli-automation
, 'i'); if (__m === '*' || __re.test(location.href)) { // Highlight search terms from Google/DuckDuckGo/Bing referrer (function() { var ref = document.referrer; var terms = []; if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) { var url = new URL(ref); var q = url.searchParams.get('q') || url.searchParams.get('p'); if (q) { terms = q.split(/\s+/).filter(function(t) { return t.length > 2; }); } } if (terms.length === 0) return; var style = document.createElement('style'); style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }'; document.head.appendChild(style); function highlight(node) { if (node.nodeType === 3) { // text node var text = node.textContent; var found = false; terms.forEach(function(term) { var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat: instrument telemetry for create command by Hweinstock · Pull Request #1202 · aws/agentcore-cli · GitHub
Skip to content

feat: instrument telemetry for create command - #1202

Merged
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry
May 11, 2026
Merged

feat: instrument telemetry for create command#1202
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry

Conversation

@Hweinstock

@HweinstockHweinstock commented May 11, 2026

Copy link
Copy Markdown
Contributor

Description

Add telemetry instrumentation to the create command for both CLI and TUI paths.

  • CLI path: wrapped handleCreateCLI with runCliCommand('create', ...) to emit CreateAttrs on success/failure
  • TUI path: wrapped useCreateFlow's run() with withCommandRunTelemetry('create', ...)
  • Widened CreateAttrs.agent_type to use the shared AgentType enum (includes 'byo')
  • Added telemetry assertions to existing integration tests

Attributes emitted: language, framework, model_provider, memory, protocol, build, agent_type, network_mode, has_agent

Related Issue

Closes #

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 test:unit and npm run test:integ
  • I ran npm run typecheck
  • I ran npm run lint
  • If I modified src/assets/, I ran npm run test:update-snapshots and committed the updated snapshots

Additional testing:

  • Integration tests pass (11/11 in create-frameworks + create-edge-cases)
  • E2E verified with tarball: telemetry JSONL correctly emitted for both success and failure paths

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-actionsgithub-actionsBot added the size/m PR size: M label May 11, 2026
@github-actionsgithub-actionsBot added the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Package Tarball

aws-agentcore-0.13.1.tgz

How to install

npm install https://github.com/aws/agentcore-cli/releases/download/pr-1202-tarball/aws-agentcore-0.13.1.tgz

@agentcore-cli-automationagentcore-cli-automation left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Nice work wiring up telemetry for create! I only found one issue worth flagging before merge — see the inline comment about the BYO path in the TUI instrumentation.

Comment threadsrc/cli/tui/screens/create/useCreateFlow.ts Outdated
@github-actionsgithub-actionsBot removed the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
@Hweinstock
Hweinstockforce-pushed the feat/create-telemetry branch from 5edb792 to cbe5fe1CompareMay 11, 2026 21:06
@github-actionsgithub-actionsBot added size/m PR size: M and removed size/m PR size: M labels May 11, 2026
@Hweinstock
Hweinstock marked this pull request as ready for review May 11, 2026 21:13
@Hweinstock
Hweinstock requested a review from a teamMay 11, 2026 21:13

@notgitikanotgitika 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.

looks great to me, thanks!

@Hweinstock
Hweinstock merged commit bceddde into aws:mainMay 11, 2026
24 checks passed
@Hweinstock
Hweinstock deleted the feat/create-telemetry branch May 11, 2026 21:40
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
tejaskash pushed a commit that referenced this pull request May 13, 2026
* docs: add telemetry instrumentation guide (#1197)
* chore: replace PAT tokens with GitHub App token (#1198)
Replace secrets.PAT_TOKEN and secrets.AUTOMATION_ACCOUNT_PAT_TOKEN with
short-lived tokens generated by the agentcore-devx-automation GitHub App
(ID: 3637953) via actions/create-github-app-token@v1.
This improves security by using ephemeral tokens scoped to the
installation rather than long-lived personal access tokens.
Requires adding repo variable APP_ID=3637953 and repo secret
APP_PRIVATE_KEY with the app's RSA private key.
* fix: add batch eval, recommendation, and CloudWatch Logs write permissions to docs (#1113)
* feat: instrument telemetry for create command (CLI + TUI) (#1202)
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
* chore: replace all github.token/GITHUB_TOKEN with GitHub App token
Replaces all occurrences of \${{ github.token }} and \${{ secrets.GITHUB_TOKEN }}
across .github/workflows/ with a per-job GitHub App token generated via
actions/create-github-app-token@v1 using vars.APP_ID and secrets.APP_PRIVATE_KEY.
* fix: bump versions to resolve security audit failure
* revert: keep pr-title.yml using GITHUB_TOKEN (read-only access sufficient)
* feat(evaluator): add kmsKeyArn support for custom evaluator (#994)
* feat(evaluator): Add kmsKeyArn support for custom evaluator
* fix: sync package-lock.json with package.json
The lock file was out of sync after dependency bumps on main were merged,
causing npm ci to fail in CI.
* fix: revert unrelated dep bumps and fix formatting
Reverts @opentelemetry/exporter-metrics-otlp-http ^0.217.0 back to
^0.214.0 and secretlint ^13.0.0 back to ^12.2.0 — these were
accidentally included in the feature commit from unmerged dependabot PRs
and introduce high-severity protobufjs vulnerabilities.
Restores fast-xml-parser and @aws-sdk/xml-builder overrides that were
also inadvertently removed.
Fixes Prettier formatting on agentcore-project.ts import lines.
* fix: sync package-lock.json with updated dependencies
---------
Co-authored-by: notgitika <gitijh@gmail.com>
* refactor: unify result types with discriminated Result<T, E> union (#1125)
* refactor: unify result types with discriminated Result<T, E> union
Introduce a shared Result<T, E> type (inspired by Rust's Result) that
replaces ad-hoc { success: boolean; error?: string } patterns across
the codebase.
Key changes:
- Add src/lib/types.ts with Result<T, E> discriminated union type
- Add toError() helper in src/cli/errors.ts for catch blocks
- Migrate all command, operation, and primitive result types to Result<T>
- Error field is now Error (not string) on the failure branch
- Data fields only exist on the success branch (proper narrowing)
- Update all consumers to narrow before accessing branch-specific fields
- Update test assertions to match new Error objects and add narrowing
* docs: update AGENTS.md and telemetry README to reflect Result<T, E> type
* feat: record command attrs on telemetry failure via fallbackAttrs (#1204)
* feat: record command attrs on telemetry failure via fallbackAttrs
Add optional fallbackAttrs parameter to client.withCommandRun so
command-specific attributes are recorded even when the callback throws.
- client.ts: accept fallbackAttrs, use on failure instead of {}
- client.ts: run resilientParse on all non-empty attrs (not just success)
- cli-command-run.ts: withCommandRunTelemetry passes attrs as fallbackAttrs
- cli-command-run.ts: runCliCommand accepts optional knownAttrs param
- command.tsx: extract knownAttrs upfront, pass to runCliCommand
- client.test.ts: add unit tests for fallbackAttrs behavior
- create-edge-cases.test.ts: assert attrs present on failure entry
* chore: rebase onto mainline
* fix: sync-preview pushes directly on clean merge, PRs only on conflict (#1078)
* fix: sync-preview workflow restores version instead of ignoring files
Instead of keeping preview's entire package.json/package-lock.json
(which discards new deps, scripts, etc. from main), accept main's
content and surgically restore only the version field to preview's
value after merge.
* fix: push directly to preview on clean merge via GitHub App bypass
Use agentcore-devx-automation app token to bypass branch protection
and push directly when the merge is clean (or only version conflicts).
Only creates a PR when there are real conflicts in other files.
* chore: use app-slug instead of app-id for token generation
* fix: address review feedback on sync-preview workflow
- Pass PREVIEW_VERSION via env var instead of string interpolation in
node -e scripts (safer against special chars)
- Make git add of package-lock.json conditional on file existence to
match the earlier -f guard
- Replace loose title search for dedup with headRefName prefix filter
to avoid false positives from unrelated PRs
- Clarify why package.json/package-lock.json are special-cased (preview
carries a different version string that needs preserving)
* fix: restore preview-owned files after sync merge
Adds a step to restore schemas/agentcore.schema.v1.json and CHANGELOG.md
to preview's versions after merging main. These files are auto-generated
during preview releases — schema-check CI rejects direct modifications
to schemas/, and CHANGELOG.md tracks preview releases separately.
* fix: use app-id instead of app-slug for GitHub App token
Aligns with the pattern in PR #1210 and ci-failure-issue.yml.
* feat: instrument telemetry for deploy command (CLI + TUI) (#1206)
* chore: sync safe commits from main into preview
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
* chore: merge main into preview with Result refactor
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
---------
Co-authored-by: Hweinstock <42325418+Hweinstock@users.noreply.github.com>
Co-authored-by: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Co-authored-by: Gitika <53349492+notgitika@users.noreply.github.com>
Co-authored-by: Aidan Daly <aidandal@amazon.com>
Co-authored-by: Harrison Weinstock <hkobew@amazon.com>
Co-authored-by: aws-aditya21 <saivenki@amazon.com>
Co-authored-by: notgitika <gitijh@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/mPR size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Hweinstock@notgitika@agentcore-cli-automation
, 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ' feat: instrument telemetry for create command by Hweinstock · Pull Request #1202 · aws/agentcore-cli · GitHub
Skip to content

feat: instrument telemetry for create command - #1202

Merged
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry
May 11, 2026
Merged

feat: instrument telemetry for create command#1202
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry

Conversation

@Hweinstock

@HweinstockHweinstock commented May 11, 2026

Copy link
Copy Markdown
Contributor

Description

Add telemetry instrumentation to the create command for both CLI and TUI paths.

  • CLI path: wrapped handleCreateCLI with runCliCommand('create', ...) to emit CreateAttrs on success/failure
  • TUI path: wrapped useCreateFlow's run() with withCommandRunTelemetry('create', ...)
  • Widened CreateAttrs.agent_type to use the shared AgentType enum (includes 'byo')
  • Added telemetry assertions to existing integration tests

Attributes emitted: language, framework, model_provider, memory, protocol, build, agent_type, network_mode, has_agent

Related Issue

Closes #

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 test:unit and npm run test:integ
  • I ran npm run typecheck
  • I ran npm run lint
  • If I modified src/assets/, I ran npm run test:update-snapshots and committed the updated snapshots

Additional testing:

  • Integration tests pass (11/11 in create-frameworks + create-edge-cases)
  • E2E verified with tarball: telemetry JSONL correctly emitted for both success and failure paths

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-actionsgithub-actionsBot added the size/m PR size: M label May 11, 2026
@github-actionsgithub-actionsBot added the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Package Tarball

aws-agentcore-0.13.1.tgz

How to install

npm install https://github.com/aws/agentcore-cli/releases/download/pr-1202-tarball/aws-agentcore-0.13.1.tgz

@agentcore-cli-automationagentcore-cli-automation left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Nice work wiring up telemetry for create! I only found one issue worth flagging before merge — see the inline comment about the BYO path in the TUI instrumentation.

Comment threadsrc/cli/tui/screens/create/useCreateFlow.ts Outdated
@github-actionsgithub-actionsBot removed the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
@Hweinstock
Hweinstockforce-pushed the feat/create-telemetry branch from 5edb792 to cbe5fe1CompareMay 11, 2026 21:06
@github-actionsgithub-actionsBot added size/m PR size: M and removed size/m PR size: M labels May 11, 2026
@Hweinstock
Hweinstock marked this pull request as ready for review May 11, 2026 21:13
@Hweinstock
Hweinstock requested a review from a teamMay 11, 2026 21:13

@notgitikanotgitika 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.

looks great to me, thanks!

@Hweinstock
Hweinstock merged commit bceddde into aws:mainMay 11, 2026
24 checks passed
@Hweinstock
Hweinstock deleted the feat/create-telemetry branch May 11, 2026 21:40
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
tejaskash pushed a commit that referenced this pull request May 13, 2026
* docs: add telemetry instrumentation guide (#1197)
* chore: replace PAT tokens with GitHub App token (#1198)
Replace secrets.PAT_TOKEN and secrets.AUTOMATION_ACCOUNT_PAT_TOKEN with
short-lived tokens generated by the agentcore-devx-automation GitHub App
(ID: 3637953) via actions/create-github-app-token@v1.
This improves security by using ephemeral tokens scoped to the
installation rather than long-lived personal access tokens.
Requires adding repo variable APP_ID=3637953 and repo secret
APP_PRIVATE_KEY with the app's RSA private key.
* fix: add batch eval, recommendation, and CloudWatch Logs write permissions to docs (#1113)
* feat: instrument telemetry for create command (CLI + TUI) (#1202)
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
* chore: replace all github.token/GITHUB_TOKEN with GitHub App token
Replaces all occurrences of \${{ github.token }} and \${{ secrets.GITHUB_TOKEN }}
across .github/workflows/ with a per-job GitHub App token generated via
actions/create-github-app-token@v1 using vars.APP_ID and secrets.APP_PRIVATE_KEY.
* fix: bump versions to resolve security audit failure
* revert: keep pr-title.yml using GITHUB_TOKEN (read-only access sufficient)
* feat(evaluator): add kmsKeyArn support for custom evaluator (#994)
* feat(evaluator): Add kmsKeyArn support for custom evaluator
* fix: sync package-lock.json with package.json
The lock file was out of sync after dependency bumps on main were merged,
causing npm ci to fail in CI.
* fix: revert unrelated dep bumps and fix formatting
Reverts @opentelemetry/exporter-metrics-otlp-http ^0.217.0 back to
^0.214.0 and secretlint ^13.0.0 back to ^12.2.0 — these were
accidentally included in the feature commit from unmerged dependabot PRs
and introduce high-severity protobufjs vulnerabilities.
Restores fast-xml-parser and @aws-sdk/xml-builder overrides that were
also inadvertently removed.
Fixes Prettier formatting on agentcore-project.ts import lines.
* fix: sync package-lock.json with updated dependencies
---------
Co-authored-by: notgitika <gitijh@gmail.com>
* refactor: unify result types with discriminated Result<T, E> union (#1125)
* refactor: unify result types with discriminated Result<T, E> union
Introduce a shared Result<T, E> type (inspired by Rust's Result) that
replaces ad-hoc { success: boolean; error?: string } patterns across
the codebase.
Key changes:
- Add src/lib/types.ts with Result<T, E> discriminated union type
- Add toError() helper in src/cli/errors.ts for catch blocks
- Migrate all command, operation, and primitive result types to Result<T>
- Error field is now Error (not string) on the failure branch
- Data fields only exist on the success branch (proper narrowing)
- Update all consumers to narrow before accessing branch-specific fields
- Update test assertions to match new Error objects and add narrowing
* docs: update AGENTS.md and telemetry README to reflect Result<T, E> type
* feat: record command attrs on telemetry failure via fallbackAttrs (#1204)
* feat: record command attrs on telemetry failure via fallbackAttrs
Add optional fallbackAttrs parameter to client.withCommandRun so
command-specific attributes are recorded even when the callback throws.
- client.ts: accept fallbackAttrs, use on failure instead of {}
- client.ts: run resilientParse on all non-empty attrs (not just success)
- cli-command-run.ts: withCommandRunTelemetry passes attrs as fallbackAttrs
- cli-command-run.ts: runCliCommand accepts optional knownAttrs param
- command.tsx: extract knownAttrs upfront, pass to runCliCommand
- client.test.ts: add unit tests for fallbackAttrs behavior
- create-edge-cases.test.ts: assert attrs present on failure entry
* chore: rebase onto mainline
* fix: sync-preview pushes directly on clean merge, PRs only on conflict (#1078)
* fix: sync-preview workflow restores version instead of ignoring files
Instead of keeping preview's entire package.json/package-lock.json
(which discards new deps, scripts, etc. from main), accept main's
content and surgically restore only the version field to preview's
value after merge.
* fix: push directly to preview on clean merge via GitHub App bypass
Use agentcore-devx-automation app token to bypass branch protection
and push directly when the merge is clean (or only version conflicts).
Only creates a PR when there are real conflicts in other files.
* chore: use app-slug instead of app-id for token generation
* fix: address review feedback on sync-preview workflow
- Pass PREVIEW_VERSION via env var instead of string interpolation in
node -e scripts (safer against special chars)
- Make git add of package-lock.json conditional on file existence to
match the earlier -f guard
- Replace loose title search for dedup with headRefName prefix filter
to avoid false positives from unrelated PRs
- Clarify why package.json/package-lock.json are special-cased (preview
carries a different version string that needs preserving)
* fix: restore preview-owned files after sync merge
Adds a step to restore schemas/agentcore.schema.v1.json and CHANGELOG.md
to preview's versions after merging main. These files are auto-generated
during preview releases — schema-check CI rejects direct modifications
to schemas/, and CHANGELOG.md tracks preview releases separately.
* fix: use app-id instead of app-slug for GitHub App token
Aligns with the pattern in PR #1210 and ci-failure-issue.yml.
* feat: instrument telemetry for deploy command (CLI + TUI) (#1206)
* chore: sync safe commits from main into preview
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
* chore: merge main into preview with Result refactor
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
---------
Co-authored-by: Hweinstock <42325418+Hweinstock@users.noreply.github.com>
Co-authored-by: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Co-authored-by: Gitika <53349492+notgitika@users.noreply.github.com>
Co-authored-by: Aidan Daly <aidandal@amazon.com>
Co-authored-by: Harrison Weinstock <hkobew@amazon.com>
Co-authored-by: aws-aditya21 <saivenki@amazon.com>
Co-authored-by: notgitika <gitijh@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/mPR size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Hweinstock@notgitika@agentcore-cli-automation
, 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat: instrument telemetry for create command by Hweinstock · Pull Request #1202 · aws/agentcore-cli · GitHub
Skip to content

feat: instrument telemetry for create command - #1202

Merged
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry
May 11, 2026
Merged

feat: instrument telemetry for create command#1202
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry

Conversation

@Hweinstock

@HweinstockHweinstock commented May 11, 2026

Copy link
Copy Markdown
Contributor

Description

Add telemetry instrumentation to the create command for both CLI and TUI paths.

  • CLI path: wrapped handleCreateCLI with runCliCommand('create', ...) to emit CreateAttrs on success/failure
  • TUI path: wrapped useCreateFlow's run() with withCommandRunTelemetry('create', ...)
  • Widened CreateAttrs.agent_type to use the shared AgentType enum (includes 'byo')
  • Added telemetry assertions to existing integration tests

Attributes emitted: language, framework, model_provider, memory, protocol, build, agent_type, network_mode, has_agent

Related Issue

Closes #

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 test:unit and npm run test:integ
  • I ran npm run typecheck
  • I ran npm run lint
  • If I modified src/assets/, I ran npm run test:update-snapshots and committed the updated snapshots

Additional testing:

  • Integration tests pass (11/11 in create-frameworks + create-edge-cases)
  • E2E verified with tarball: telemetry JSONL correctly emitted for both success and failure paths

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-actionsgithub-actionsBot added the size/m PR size: M label May 11, 2026
@github-actionsgithub-actionsBot added the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Package Tarball

aws-agentcore-0.13.1.tgz

How to install

npm install https://github.com/aws/agentcore-cli/releases/download/pr-1202-tarball/aws-agentcore-0.13.1.tgz

@agentcore-cli-automationagentcore-cli-automation left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Nice work wiring up telemetry for create! I only found one issue worth flagging before merge — see the inline comment about the BYO path in the TUI instrumentation.

Comment threadsrc/cli/tui/screens/create/useCreateFlow.ts Outdated
@github-actionsgithub-actionsBot removed the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
@Hweinstock
Hweinstockforce-pushed the feat/create-telemetry branch from 5edb792 to cbe5fe1CompareMay 11, 2026 21:06
@github-actionsgithub-actionsBot added size/m PR size: M and removed size/m PR size: M labels May 11, 2026
@Hweinstock
Hweinstock marked this pull request as ready for review May 11, 2026 21:13
@Hweinstock
Hweinstock requested a review from a teamMay 11, 2026 21:13

@notgitikanotgitika 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.

looks great to me, thanks!

@Hweinstock
Hweinstock merged commit bceddde into aws:mainMay 11, 2026
24 checks passed
@Hweinstock
Hweinstock deleted the feat/create-telemetry branch May 11, 2026 21:40
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
tejaskash pushed a commit that referenced this pull request May 13, 2026
* docs: add telemetry instrumentation guide (#1197)
* chore: replace PAT tokens with GitHub App token (#1198)
Replace secrets.PAT_TOKEN and secrets.AUTOMATION_ACCOUNT_PAT_TOKEN with
short-lived tokens generated by the agentcore-devx-automation GitHub App
(ID: 3637953) via actions/create-github-app-token@v1.
This improves security by using ephemeral tokens scoped to the
installation rather than long-lived personal access tokens.
Requires adding repo variable APP_ID=3637953 and repo secret
APP_PRIVATE_KEY with the app's RSA private key.
* fix: add batch eval, recommendation, and CloudWatch Logs write permissions to docs (#1113)
* feat: instrument telemetry for create command (CLI + TUI) (#1202)
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
* chore: replace all github.token/GITHUB_TOKEN with GitHub App token
Replaces all occurrences of \${{ github.token }} and \${{ secrets.GITHUB_TOKEN }}
across .github/workflows/ with a per-job GitHub App token generated via
actions/create-github-app-token@v1 using vars.APP_ID and secrets.APP_PRIVATE_KEY.
* fix: bump versions to resolve security audit failure
* revert: keep pr-title.yml using GITHUB_TOKEN (read-only access sufficient)
* feat(evaluator): add kmsKeyArn support for custom evaluator (#994)
* feat(evaluator): Add kmsKeyArn support for custom evaluator
* fix: sync package-lock.json with package.json
The lock file was out of sync after dependency bumps on main were merged,
causing npm ci to fail in CI.
* fix: revert unrelated dep bumps and fix formatting
Reverts @opentelemetry/exporter-metrics-otlp-http ^0.217.0 back to
^0.214.0 and secretlint ^13.0.0 back to ^12.2.0 — these were
accidentally included in the feature commit from unmerged dependabot PRs
and introduce high-severity protobufjs vulnerabilities.
Restores fast-xml-parser and @aws-sdk/xml-builder overrides that were
also inadvertently removed.
Fixes Prettier formatting on agentcore-project.ts import lines.
* fix: sync package-lock.json with updated dependencies
---------
Co-authored-by: notgitika <gitijh@gmail.com>
* refactor: unify result types with discriminated Result<T, E> union (#1125)
* refactor: unify result types with discriminated Result<T, E> union
Introduce a shared Result<T, E> type (inspired by Rust's Result) that
replaces ad-hoc { success: boolean; error?: string } patterns across
the codebase.
Key changes:
- Add src/lib/types.ts with Result<T, E> discriminated union type
- Add toError() helper in src/cli/errors.ts for catch blocks
- Migrate all command, operation, and primitive result types to Result<T>
- Error field is now Error (not string) on the failure branch
- Data fields only exist on the success branch (proper narrowing)
- Update all consumers to narrow before accessing branch-specific fields
- Update test assertions to match new Error objects and add narrowing
* docs: update AGENTS.md and telemetry README to reflect Result<T, E> type
* feat: record command attrs on telemetry failure via fallbackAttrs (#1204)
* feat: record command attrs on telemetry failure via fallbackAttrs
Add optional fallbackAttrs parameter to client.withCommandRun so
command-specific attributes are recorded even when the callback throws.
- client.ts: accept fallbackAttrs, use on failure instead of {}
- client.ts: run resilientParse on all non-empty attrs (not just success)
- cli-command-run.ts: withCommandRunTelemetry passes attrs as fallbackAttrs
- cli-command-run.ts: runCliCommand accepts optional knownAttrs param
- command.tsx: extract knownAttrs upfront, pass to runCliCommand
- client.test.ts: add unit tests for fallbackAttrs behavior
- create-edge-cases.test.ts: assert attrs present on failure entry
* chore: rebase onto mainline
* fix: sync-preview pushes directly on clean merge, PRs only on conflict (#1078)
* fix: sync-preview workflow restores version instead of ignoring files
Instead of keeping preview's entire package.json/package-lock.json
(which discards new deps, scripts, etc. from main), accept main's
content and surgically restore only the version field to preview's
value after merge.
* fix: push directly to preview on clean merge via GitHub App bypass
Use agentcore-devx-automation app token to bypass branch protection
and push directly when the merge is clean (or only version conflicts).
Only creates a PR when there are real conflicts in other files.
* chore: use app-slug instead of app-id for token generation
* fix: address review feedback on sync-preview workflow
- Pass PREVIEW_VERSION via env var instead of string interpolation in
node -e scripts (safer against special chars)
- Make git add of package-lock.json conditional on file existence to
match the earlier -f guard
- Replace loose title search for dedup with headRefName prefix filter
to avoid false positives from unrelated PRs
- Clarify why package.json/package-lock.json are special-cased (preview
carries a different version string that needs preserving)
* fix: restore preview-owned files after sync merge
Adds a step to restore schemas/agentcore.schema.v1.json and CHANGELOG.md
to preview's versions after merging main. These files are auto-generated
during preview releases — schema-check CI rejects direct modifications
to schemas/, and CHANGELOG.md tracks preview releases separately.
* fix: use app-id instead of app-slug for GitHub App token
Aligns with the pattern in PR #1210 and ci-failure-issue.yml.
* feat: instrument telemetry for deploy command (CLI + TUI) (#1206)
* chore: sync safe commits from main into preview
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
* chore: merge main into preview with Result refactor
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
---------
Co-authored-by: Hweinstock <42325418+Hweinstock@users.noreply.github.com>
Co-authored-by: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Co-authored-by: Gitika <53349492+notgitika@users.noreply.github.com>
Co-authored-by: Aidan Daly <aidandal@amazon.com>
Co-authored-by: Harrison Weinstock <hkobew@amazon.com>
Co-authored-by: aws-aditya21 <saivenki@amazon.com>
Co-authored-by: notgitika <gitijh@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/mPR size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Hweinstock@notgitika@agentcore-cli-automation
, 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ' feat: instrument telemetry for create command by Hweinstock · Pull Request #1202 · aws/agentcore-cli · GitHub
Skip to content

feat: instrument telemetry for create command - #1202

Merged
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry
May 11, 2026
Merged

feat: instrument telemetry for create command#1202
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry

Conversation

@Hweinstock

@HweinstockHweinstock commented May 11, 2026

Copy link
Copy Markdown
Contributor

Description

Add telemetry instrumentation to the create command for both CLI and TUI paths.

  • CLI path: wrapped handleCreateCLI with runCliCommand('create', ...) to emit CreateAttrs on success/failure
  • TUI path: wrapped useCreateFlow's run() with withCommandRunTelemetry('create', ...)
  • Widened CreateAttrs.agent_type to use the shared AgentType enum (includes 'byo')
  • Added telemetry assertions to existing integration tests

Attributes emitted: language, framework, model_provider, memory, protocol, build, agent_type, network_mode, has_agent

Related Issue

Closes #

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 test:unit and npm run test:integ
  • I ran npm run typecheck
  • I ran npm run lint
  • If I modified src/assets/, I ran npm run test:update-snapshots and committed the updated snapshots

Additional testing:

  • Integration tests pass (11/11 in create-frameworks + create-edge-cases)
  • E2E verified with tarball: telemetry JSONL correctly emitted for both success and failure paths

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-actionsgithub-actionsBot added the size/m PR size: M label May 11, 2026
@github-actionsgithub-actionsBot added the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Package Tarball

aws-agentcore-0.13.1.tgz

How to install

npm install https://github.com/aws/agentcore-cli/releases/download/pr-1202-tarball/aws-agentcore-0.13.1.tgz

@agentcore-cli-automationagentcore-cli-automation left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Nice work wiring up telemetry for create! I only found one issue worth flagging before merge — see the inline comment about the BYO path in the TUI instrumentation.

Comment threadsrc/cli/tui/screens/create/useCreateFlow.ts Outdated
@github-actionsgithub-actionsBot removed the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
@Hweinstock
Hweinstockforce-pushed the feat/create-telemetry branch from 5edb792 to cbe5fe1CompareMay 11, 2026 21:06
@github-actionsgithub-actionsBot added size/m PR size: M and removed size/m PR size: M labels May 11, 2026
@Hweinstock
Hweinstock marked this pull request as ready for review May 11, 2026 21:13
@Hweinstock
Hweinstock requested a review from a teamMay 11, 2026 21:13

@notgitikanotgitika 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.

looks great to me, thanks!

@Hweinstock
Hweinstock merged commit bceddde into aws:mainMay 11, 2026
24 checks passed
@Hweinstock
Hweinstock deleted the feat/create-telemetry branch May 11, 2026 21:40
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
tejaskash pushed a commit that referenced this pull request May 13, 2026
* docs: add telemetry instrumentation guide (#1197)
* chore: replace PAT tokens with GitHub App token (#1198)
Replace secrets.PAT_TOKEN and secrets.AUTOMATION_ACCOUNT_PAT_TOKEN with
short-lived tokens generated by the agentcore-devx-automation GitHub App
(ID: 3637953) via actions/create-github-app-token@v1.
This improves security by using ephemeral tokens scoped to the
installation rather than long-lived personal access tokens.
Requires adding repo variable APP_ID=3637953 and repo secret
APP_PRIVATE_KEY with the app's RSA private key.
* fix: add batch eval, recommendation, and CloudWatch Logs write permissions to docs (#1113)
* feat: instrument telemetry for create command (CLI + TUI) (#1202)
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
* chore: replace all github.token/GITHUB_TOKEN with GitHub App token
Replaces all occurrences of \${{ github.token }} and \${{ secrets.GITHUB_TOKEN }}
across .github/workflows/ with a per-job GitHub App token generated via
actions/create-github-app-token@v1 using vars.APP_ID and secrets.APP_PRIVATE_KEY.
* fix: bump versions to resolve security audit failure
* revert: keep pr-title.yml using GITHUB_TOKEN (read-only access sufficient)
* feat(evaluator): add kmsKeyArn support for custom evaluator (#994)
* feat(evaluator): Add kmsKeyArn support for custom evaluator
* fix: sync package-lock.json with package.json
The lock file was out of sync after dependency bumps on main were merged,
causing npm ci to fail in CI.
* fix: revert unrelated dep bumps and fix formatting
Reverts @opentelemetry/exporter-metrics-otlp-http ^0.217.0 back to
^0.214.0 and secretlint ^13.0.0 back to ^12.2.0 — these were
accidentally included in the feature commit from unmerged dependabot PRs
and introduce high-severity protobufjs vulnerabilities.
Restores fast-xml-parser and @aws-sdk/xml-builder overrides that were
also inadvertently removed.
Fixes Prettier formatting on agentcore-project.ts import lines.
* fix: sync package-lock.json with updated dependencies
---------
Co-authored-by: notgitika <gitijh@gmail.com>
* refactor: unify result types with discriminated Result<T, E> union (#1125)
* refactor: unify result types with discriminated Result<T, E> union
Introduce a shared Result<T, E> type (inspired by Rust's Result) that
replaces ad-hoc { success: boolean; error?: string } patterns across
the codebase.
Key changes:
- Add src/lib/types.ts with Result<T, E> discriminated union type
- Add toError() helper in src/cli/errors.ts for catch blocks
- Migrate all command, operation, and primitive result types to Result<T>
- Error field is now Error (not string) on the failure branch
- Data fields only exist on the success branch (proper narrowing)
- Update all consumers to narrow before accessing branch-specific fields
- Update test assertions to match new Error objects and add narrowing
* docs: update AGENTS.md and telemetry README to reflect Result<T, E> type
* feat: record command attrs on telemetry failure via fallbackAttrs (#1204)
* feat: record command attrs on telemetry failure via fallbackAttrs
Add optional fallbackAttrs parameter to client.withCommandRun so
command-specific attributes are recorded even when the callback throws.
- client.ts: accept fallbackAttrs, use on failure instead of {}
- client.ts: run resilientParse on all non-empty attrs (not just success)
- cli-command-run.ts: withCommandRunTelemetry passes attrs as fallbackAttrs
- cli-command-run.ts: runCliCommand accepts optional knownAttrs param
- command.tsx: extract knownAttrs upfront, pass to runCliCommand
- client.test.ts: add unit tests for fallbackAttrs behavior
- create-edge-cases.test.ts: assert attrs present on failure entry
* chore: rebase onto mainline
* fix: sync-preview pushes directly on clean merge, PRs only on conflict (#1078)
* fix: sync-preview workflow restores version instead of ignoring files
Instead of keeping preview's entire package.json/package-lock.json
(which discards new deps, scripts, etc. from main), accept main's
content and surgically restore only the version field to preview's
value after merge.
* fix: push directly to preview on clean merge via GitHub App bypass
Use agentcore-devx-automation app token to bypass branch protection
and push directly when the merge is clean (or only version conflicts).
Only creates a PR when there are real conflicts in other files.
* chore: use app-slug instead of app-id for token generation
* fix: address review feedback on sync-preview workflow
- Pass PREVIEW_VERSION via env var instead of string interpolation in
node -e scripts (safer against special chars)
- Make git add of package-lock.json conditional on file existence to
match the earlier -f guard
- Replace loose title search for dedup with headRefName prefix filter
to avoid false positives from unrelated PRs
- Clarify why package.json/package-lock.json are special-cased (preview
carries a different version string that needs preserving)
* fix: restore preview-owned files after sync merge
Adds a step to restore schemas/agentcore.schema.v1.json and CHANGELOG.md
to preview's versions after merging main. These files are auto-generated
during preview releases — schema-check CI rejects direct modifications
to schemas/, and CHANGELOG.md tracks preview releases separately.
* fix: use app-id instead of app-slug for GitHub App token
Aligns with the pattern in PR #1210 and ci-failure-issue.yml.
* feat: instrument telemetry for deploy command (CLI + TUI) (#1206)
* chore: sync safe commits from main into preview
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
* chore: merge main into preview with Result refactor
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
---------
Co-authored-by: Hweinstock <42325418+Hweinstock@users.noreply.github.com>
Co-authored-by: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Co-authored-by: Gitika <53349492+notgitika@users.noreply.github.com>
Co-authored-by: Aidan Daly <aidandal@amazon.com>
Co-authored-by: Harrison Weinstock <hkobew@amazon.com>
Co-authored-by: aws-aditya21 <saivenki@amazon.com>
Co-authored-by: notgitika <gitijh@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/mPR size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Hweinstock@notgitika@agentcore-cli-automation
, 'i'); if (__m === '*' || __re.test(location.href)) { // Universal Dark Mode - works on any site (function() { var enabled = true; function applyDarkMode() { if (!enabled) return; // Create style element if it doesn't exist var style = document.getElementById('universal-dark-mode-style'); if (!style) { style = document.createElement('style'); style.id = 'universal-dark-mode-style'; document.head.appendChild(style); } // Dark mode CSS - inverts colors but preserves images/video style.textContent = ' /* Invert everything except media */ html { filter: invert(1) hue-rotate(180deg) !important; background: #1a1a2e !important; } /* Restore images, videos, iframes, canvas */ img, video, iframe, canvas, svg, picture, [style*="background-image"] { filter: invert(1) hue-rotate(180deg) !important; } /* Preserve specific elements that should not be inverted */ .no-dark-mode, .no-dark-mode *, [data-theme="light"], [data-theme="light"], .ace_editor, .ace_editor *, .CodeMirror, .CodeMirror *, .monaco-editor, .monaco-editor *, .markdown-body pre, .markdown-body pre *, .highlight, .highlight *, pre code, pre code * { filter: none !important; } /* Fix common UI elements */ .modal, .popup, .dropdown-menu, .tooltip, .popover { filter: invert(1) hue-rotate(180deg) !important; background: #2d2d44 !important; border-color: #444 !important; } /* Scrollbars */ ::-webkit-scrollbar { background: #1a1a2e !important; } ::-webkit-scrollbar-thumb { background: #444 !important; } ::-webkit-scrollbar-thumb:hover { background: #555 !important; } /* Selection */ ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; } ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; } '; } function removeDarkMode() { var style = document.getElementById('universal-dark-mode-style'); if (style) style.remove(); } // Toggle with Alt+Shift+D document.addEventListener('keydown', function(e) { if (e.altKey && e.shiftKey && e.key === 'D') { e.preventDefault(); enabled = !enabled; if (enabled) { applyDarkMode(); console.log('[Universal Dark Mode] Enabled'); } else { removeDarkMode(); console.log('[Universal Dark Mode] Disabled'); } } }); // Apply on load applyDarkMode(); // Re-apply on dynamic content var observer = new MutationObserver(function(mutations) { if (enabled && !document.getElementById('universal-dark-mode-style')) { applyDarkMode(); } }); observer.observe(document.head, { childList: true }); console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle'); })(); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })(); feat: instrument telemetry for create command by Hweinstock · Pull Request #1202 · aws/agentcore-cli · GitHub
Skip to content

feat: instrument telemetry for create command - #1202

Merged
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry
May 11, 2026
Merged

feat: instrument telemetry for create command#1202
Hweinstock merged 1 commit into
aws:mainfrom
Hweinstock:feat/create-telemetry

Conversation

@Hweinstock

@HweinstockHweinstock commented May 11, 2026

Copy link
Copy Markdown
Contributor

Description

Add telemetry instrumentation to the create command for both CLI and TUI paths.

  • CLI path: wrapped handleCreateCLI with runCliCommand('create', ...) to emit CreateAttrs on success/failure
  • TUI path: wrapped useCreateFlow's run() with withCommandRunTelemetry('create', ...)
  • Widened CreateAttrs.agent_type to use the shared AgentType enum (includes 'byo')
  • Added telemetry assertions to existing integration tests

Attributes emitted: language, framework, model_provider, memory, protocol, build, agent_type, network_mode, has_agent

Related Issue

Closes #

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 test:unit and npm run test:integ
  • I ran npm run typecheck
  • I ran npm run lint
  • If I modified src/assets/, I ran npm run test:update-snapshots and committed the updated snapshots

Additional testing:

  • Integration tests pass (11/11 in create-frameworks + create-edge-cases)
  • E2E verified with tarball: telemetry JSONL correctly emitted for both success and failure paths

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-actionsgithub-actionsBot added the size/m PR size: M label May 11, 2026
@github-actionsgithub-actionsBot added the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Package Tarball

aws-agentcore-0.13.1.tgz

How to install

npm install https://github.com/aws/agentcore-cli/releases/download/pr-1202-tarball/aws-agentcore-0.13.1.tgz

@agentcore-cli-automationagentcore-cli-automation left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Nice work wiring up telemetry for create! I only found one issue worth flagging before merge — see the inline comment about the BYO path in the TUI instrumentation.

Comment threadsrc/cli/tui/screens/create/useCreateFlow.ts Outdated
@github-actionsgithub-actionsBot removed the agentcore-harness-reviewing AgentCore Harness review in progress label May 11, 2026
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
@Hweinstock
Hweinstockforce-pushed the feat/create-telemetry branch from 5edb792 to cbe5fe1CompareMay 11, 2026 21:06
@github-actionsgithub-actionsBot added size/m PR size: M and removed size/m PR size: M labels May 11, 2026
@Hweinstock
Hweinstock marked this pull request as ready for review May 11, 2026 21:13
@Hweinstock
Hweinstock requested a review from a teamMay 11, 2026 21:13

@notgitikanotgitika 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.

looks great to me, thanks!

@Hweinstock
Hweinstock merged commit bceddde into aws:mainMay 11, 2026
24 checks passed
@Hweinstock
Hweinstock deleted the feat/create-telemetry branch May 11, 2026 21:40
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
notgitika added a commit that referenced this pull request May 13, 2026
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
tejaskash pushed a commit that referenced this pull request May 13, 2026
* docs: add telemetry instrumentation guide (#1197)
* chore: replace PAT tokens with GitHub App token (#1198)
Replace secrets.PAT_TOKEN and secrets.AUTOMATION_ACCOUNT_PAT_TOKEN with
short-lived tokens generated by the agentcore-devx-automation GitHub App
(ID: 3637953) via actions/create-github-app-token@v1.
This improves security by using ephemeral tokens scoped to the
installation rather than long-lived personal access tokens.
Requires adding repo variable APP_ID=3637953 and repo secret
APP_PRIVATE_KEY with the app's RSA private key.
* fix: add batch eval, recommendation, and CloudWatch Logs write permissions to docs (#1113)
* feat: instrument telemetry for create command (CLI + TUI) (#1202)
Add telemetry recording to the create command in both CLI and TUI paths:
- CLI: wrap handleCreateCLI with runCliCommand to emit CreateAttrs on success/failure
- TUI: wrap useCreateFlow's run() with withCommandRunTelemetry
- Add telemetry assertions to existing integration tests (frameworks + edge cases)
* chore: replace all github.token/GITHUB_TOKEN with GitHub App token
Replaces all occurrences of \${{ github.token }} and \${{ secrets.GITHUB_TOKEN }}
across .github/workflows/ with a per-job GitHub App token generated via
actions/create-github-app-token@v1 using vars.APP_ID and secrets.APP_PRIVATE_KEY.
* fix: bump versions to resolve security audit failure
* revert: keep pr-title.yml using GITHUB_TOKEN (read-only access sufficient)
* feat(evaluator): add kmsKeyArn support for custom evaluator (#994)
* feat(evaluator): Add kmsKeyArn support for custom evaluator
* fix: sync package-lock.json with package.json
The lock file was out of sync after dependency bumps on main were merged,
causing npm ci to fail in CI.
* fix: revert unrelated dep bumps and fix formatting
Reverts @opentelemetry/exporter-metrics-otlp-http ^0.217.0 back to
^0.214.0 and secretlint ^13.0.0 back to ^12.2.0 — these were
accidentally included in the feature commit from unmerged dependabot PRs
and introduce high-severity protobufjs vulnerabilities.
Restores fast-xml-parser and @aws-sdk/xml-builder overrides that were
also inadvertently removed.
Fixes Prettier formatting on agentcore-project.ts import lines.
* fix: sync package-lock.json with updated dependencies
---------
Co-authored-by: notgitika <gitijh@gmail.com>
* refactor: unify result types with discriminated Result<T, E> union (#1125)
* refactor: unify result types with discriminated Result<T, E> union
Introduce a shared Result<T, E> type (inspired by Rust's Result) that
replaces ad-hoc { success: boolean; error?: string } patterns across
the codebase.
Key changes:
- Add src/lib/types.ts with Result<T, E> discriminated union type
- Add toError() helper in src/cli/errors.ts for catch blocks
- Migrate all command, operation, and primitive result types to Result<T>
- Error field is now Error (not string) on the failure branch
- Data fields only exist on the success branch (proper narrowing)
- Update all consumers to narrow before accessing branch-specific fields
- Update test assertions to match new Error objects and add narrowing
* docs: update AGENTS.md and telemetry README to reflect Result<T, E> type
* feat: record command attrs on telemetry failure via fallbackAttrs (#1204)
* feat: record command attrs on telemetry failure via fallbackAttrs
Add optional fallbackAttrs parameter to client.withCommandRun so
command-specific attributes are recorded even when the callback throws.
- client.ts: accept fallbackAttrs, use on failure instead of {}
- client.ts: run resilientParse on all non-empty attrs (not just success)
- cli-command-run.ts: withCommandRunTelemetry passes attrs as fallbackAttrs
- cli-command-run.ts: runCliCommand accepts optional knownAttrs param
- command.tsx: extract knownAttrs upfront, pass to runCliCommand
- client.test.ts: add unit tests for fallbackAttrs behavior
- create-edge-cases.test.ts: assert attrs present on failure entry
* chore: rebase onto mainline
* fix: sync-preview pushes directly on clean merge, PRs only on conflict (#1078)
* fix: sync-preview workflow restores version instead of ignoring files
Instead of keeping preview's entire package.json/package-lock.json
(which discards new deps, scripts, etc. from main), accept main's
content and surgically restore only the version field to preview's
value after merge.
* fix: push directly to preview on clean merge via GitHub App bypass
Use agentcore-devx-automation app token to bypass branch protection
and push directly when the merge is clean (or only version conflicts).
Only creates a PR when there are real conflicts in other files.
* chore: use app-slug instead of app-id for token generation
* fix: address review feedback on sync-preview workflow
- Pass PREVIEW_VERSION via env var instead of string interpolation in
node -e scripts (safer against special chars)
- Make git add of package-lock.json conditional on file existence to
match the earlier -f guard
- Replace loose title search for dedup with headRefName prefix filter
to avoid false positives from unrelated PRs
- Clarify why package.json/package-lock.json are special-cased (preview
carries a different version string that needs preserving)
* fix: restore preview-owned files after sync merge
Adds a step to restore schemas/agentcore.schema.v1.json and CHANGELOG.md
to preview's versions after merging main. These files are auto-generated
during preview releases — schema-check CI rejects direct modifications
to schemas/, and CHANGELOG.md tracks preview releases separately.
* fix: use app-id instead of app-slug for GitHub App token
Aligns with the pattern in PR #1210 and ci-failure-issue.yml.
* feat: instrument telemetry for deploy command (CLI + TUI) (#1206)
* chore: sync safe commits from main into preview
Cherry-picks non-breaking changes from main:
- docs: add telemetry instrumentation guide (#1197)
- chore: replace PAT tokens with GitHub App token (#1198)
- fix: add batch eval, recommendation, CloudWatch Logs permissions (#1113)
- feat(evaluator): add kmsKeyArn support (#994)
- chore: replace github.token with GitHub App token (#1210)
- fix: sync-preview workflow rewrite (#1078)
Skipped (requires dedicated effort due to Result type refactor):
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for create/deploy (#1202, #1206)
- feat: record command attrs on failure (#1204)
* chore: merge main into preview with Result refactor
Brings in all remaining main commits including:
- refactor: unify result types with Result<T, E> (#1125)
- feat: instrument telemetry for deploy command (#1206)
- feat: record command attrs on failure (#1204)
- feat: instrument telemetry for create command (#1202)
Adapts preview's deploy flow to use OperationResult with string errors
for compatibility with the telemetry layer.
---------
Co-authored-by: Hweinstock <42325418+Hweinstock@users.noreply.github.com>
Co-authored-by: Aidan Daly <99039782+aidandaly24@users.noreply.github.com>
Co-authored-by: Gitika <53349492+notgitika@users.noreply.github.com>
Co-authored-by: Aidan Daly <aidandal@amazon.com>
Co-authored-by: Harrison Weinstock <hkobew@amazon.com>
Co-authored-by: aws-aditya21 <saivenki@amazon.com>
Co-authored-by: notgitika <gitijh@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/mPR size: M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Hweinstock@notgitika@agentcore-cli-automation