5d2096fb5d
Implements a comprehensive suite of AI SDK v6 tools across multiple categories: - Research (5): page-brief, compare-pages, source-credibility, claim-checklist, timeline-from-text - Web (10): fetch-text, links-catalog, extract-meta, extract-json-ld, redirect-trace, sitemap-read, rss-read, table-extract, robots-policy, url-normalize - Data (15): csv-parse, csv-stringify, json-repair, json-schema-validate, yaml-parse, yaml-stringify, text-chunk, normalize-whitespace, dedupe-by-key, pivot, rows-filter, rows-sort, rows-group-aggregate, rows-join, schema-infer - Doc (12): toc-generate, glossary-build, faq-from-text, executive-brief, decision-record-adr, prd-outline, acceptance-criteria, style-rewrite - Eng (12): diff-text-unified, env-var-docs-generate, dependency-audit-lite, conventional-commit-suggest, markdown-lint-basic, test-case-generate, stacktrace-parse, release-notes, changelog-entry, release-checklist - Security (7): redact-secrets, secret-scan-text, url-risk-heuristic, csp-compose, hardening-checklist-web, access-control-matrix, data-classification-heuristic - Stats (9): effect-size-suite, bootstrap-ci, permutation-test, multiple-testing-adjust, linear-regression-ols, logistic-regression, time-series-decompose-lite, anomaly-detect-mad - Ops (7): slo-draft, runbook-draft, postmortem-draft, postmortem-action-extractor, error-log-triage, coverage-tracker, monitoring-gap-analysis - Agent (15): prompt-to-workflow-skeleton, workflow-validate-io, workflow-explain, workflow-cost-estimate, tool-call-accuracy-score, eval-fixture-build, guardrail-policy-draft, workflow-auto-repair, tool-selection-plan, novelty-score-workflow, workflow-variant-generate, config-normalize, recipe-* - Utility (8): base64-encode, base64-decode, hash-text, regex-extract, template-render, date-parse, json-path-query, url-parse - HTML (3): html-sanitize, html-to-markdown, markdown-to-html All tools follow AI SDK v6 pattern with tool() and jsonSchema<T>(). 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
117 lines
2.4 KiB
Markdown
117 lines
2.4 KiB
Markdown
# @tpmjs/tools-stacktrace-parse
|
|
|
|
Parses stack traces into structured frames, handling Node.js and browser formats.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npm install @tpmjs/tools-stacktrace-parse
|
|
```
|
|
|
|
## Usage
|
|
|
|
```typescript
|
|
import { stacktraceParse } from '@tpmjs/tools-stacktrace-parse';
|
|
import { generateText } from 'ai';
|
|
|
|
const result = await generateText({
|
|
model: yourModel,
|
|
tools: {
|
|
stacktraceParse,
|
|
},
|
|
prompt: 'Parse this stack trace and tell me where the error occurred',
|
|
});
|
|
```
|
|
|
|
## Tool Details
|
|
|
|
### stacktraceParse
|
|
|
|
Parses a stack trace string into structured frames with file, method name, line number, and column information.
|
|
|
|
**Parameters:**
|
|
|
|
- `stacktrace` (string, required) - The stack trace string to parse (from Node.js or browser)
|
|
|
|
**Returns:**
|
|
|
|
```typescript
|
|
{
|
|
frames: Array<{
|
|
file: string | null;
|
|
methodName: string | null;
|
|
lineNumber: number | null;
|
|
column: number | null;
|
|
arguments: string[];
|
|
}>;
|
|
errorType: string | null; // e.g., "TypeError", "ReferenceError"
|
|
errorMessage: string | null; // The error message
|
|
language: 'node' | 'browser' | 'unknown';
|
|
totalFrames: number;
|
|
summary: string;
|
|
}
|
|
```
|
|
|
|
## Example Output
|
|
|
|
Given this stack trace:
|
|
|
|
```
|
|
TypeError: Cannot read property 'foo' of undefined
|
|
at getUserData (/app/user.js:45:12)
|
|
at processRequest (/app/server.js:123:5)
|
|
at Server.handleRequest (/app/server.js:89:3)
|
|
```
|
|
|
|
Returns:
|
|
|
|
```typescript
|
|
{
|
|
frames: [
|
|
{
|
|
file: "/app/user.js",
|
|
methodName: "getUserData",
|
|
lineNumber: 45,
|
|
column: 12,
|
|
arguments: []
|
|
},
|
|
{
|
|
file: "/app/server.js",
|
|
methodName: "processRequest",
|
|
lineNumber: 123,
|
|
column: 5,
|
|
arguments: []
|
|
},
|
|
{
|
|
file: "/app/server.js",
|
|
methodName: "Server.handleRequest",
|
|
lineNumber: 89,
|
|
column: 3,
|
|
arguments: []
|
|
}
|
|
],
|
|
errorType: "TypeError",
|
|
errorMessage: "Cannot read property 'foo' of undefined",
|
|
language: "node",
|
|
totalFrames: 3,
|
|
summary: "TypeError - Cannot read property 'foo' of undefined - 3 frames"
|
|
}
|
|
```
|
|
|
|
## Features
|
|
|
|
- Parses Node.js and browser stack traces
|
|
- Extracts error type and message
|
|
- Provides structured frame information
|
|
- Detects stack trace format (Node.js vs browser)
|
|
- Handles various stack trace formats
|
|
|
|
## Supported Formats
|
|
|
|
- **Node.js**: Standard V8 stack traces
|
|
- **Browser**: Chrome, Firefox, Safari formats
|
|
- **Webpack**: Bundled stack traces with source maps
|
|
|
|
## License
|
|
|
|
MIT
|