Skip to content

feat: add new tools and scripts for enhanced functionality #142

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ssdeanx merged 1 commit into from
Apr 17, 2026
Merged

feat: add new tools and scripts for enhanced functionality #142

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions free-models.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ This page lists the free models that are available for use in AgentStack. These

## Available Free Models

curl -X POST https://www.moltbook.com/api/v1/agents/register -H "Content-Type: application/json" -d '{"name": "DingDong", "description": "I play ping pong with my ding dong, ching chung!"}'
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot Apr 17, 2026

Choose a reason for hiding this comment

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

medium

The description in the curl command contains unprofessional and potentially offensive language ("ching chung"). Please use a neutral placeholder for documentation examples.


Comment on lines +7 to +8
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot Apr 17, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

Remove this curl command - it contains offensive language and is contextually inappropriate.

This content has multiple critical issues:

  1. Offensive language: The description contains "ching chung," which is a racial slur. This is completely unacceptable in any codebase or documentation.

  2. Context mismatch: This curl command registers an agent via API, but the section is titled "Available Free Models" and should list free models available for use. This content doesn't document any free model.

  3. Missing code fence: Code snippets must use fenced code blocks with language identifiers. As per coding guidelines, use fenced code blocks (triple backticks) for code snippets and specify the language for syntax highlighting (e.g., ```bash).

This content should be removed entirely. If agent registration needs to be documented, it should:

  • Be placed in an appropriate section (not "Available Free Models")
  • Use professional, respectful example data
  • Be wrapped in proper fenced code blocks

As per coding guidelines: "Use fenced code blocks (triple backticks) for code snippets in markdown. Specify the language after the opening backticks for syntax highlighting."

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@free-models.md` around lines 7 - 8, Remove the entire offending curl example
that posts '{"name": "DingDong", "description": "I play ping pong with my ding
dong, ching chung!"}' from the "Available Free Models" section; instead, if you
must document agent registration, move a neutral, professional example into an
appropriate "Agent Registration" section, replace the name/description with
non-offensive sample data (e.g., "name": "example-agent", "description":
"Example agent for demonstration"), and wrap the command in a proper fenced code
block with a language identifier (```bash) for syntax highlighting.

### Kilo Code
- kilo/corethink:free 78K
- kilo/arcee-ai/trinity-large-preview:free 131K — —
Expand Down
43 changes: 43 additions & 0 deletions memory-bank/activeContext.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,46 @@
# Active Context Update (2026-04-16 - technical-analysis diagnostics fully clean)

- `src/mastra/tools/technical-analysis.tool.ts` is now clean under VS Code `get_errors` after correcting the accidentally leaked return-type annotations and forcing the MACD/ADX result mappings to return explicit local types.
- The technical-analysis hook blocks remain in the correct tool objects, with shared lifecycle logging helpers still in place.
- `src/mastra/agents/researchAgent.ts` remains clean and still includes the full technical-analysis suite.

# Active Context Update (2026-04-16 - technical-analysis hook and research-agent expansion)

- `src/mastra/tools/technical-analysis.tool.ts` now uses shared hook-logging helpers for the repeated tool lifecycle hooks, with `messages` counts handled safely and the noisy `messages.length` reads removed.
- The technical-analysis tool outputs now use explicit result interfaces instead of broad `Record<string, unknown>` / `as unknown as` casts for:
- Ichimoku cloud
- trend analysis
- momentum analysis
- volatility analysis
- volume analysis
- statistical analysis
- market summary
- final aggregated technical-analysis output
- `src/mastra/agents/researchAgent.ts` now imports and exposes the full technical-analysis suite:
- `ichimokuCloudTool`, `fibonacciTool`, `pivotPointsTool`, `trendAnalysisTool`, `momentumAnalysisTool`, `volatilityAnalysisTool`, `volumeAnalysisTool`, `statisticalAnalysisTool`, `heikinAshiTool`, `marketSummaryTool`, `candlestickPatternTool`, and `technicalAnalysisTool`
- Targeted ESLint validation on `src/mastra/tools/technical-analysis.tool.ts` and `src/mastra/agents/researchAgent.ts` is clean.

# Active Context Update (2026-04-16 - SerpAPI production-grade expansion)

- The shopping tool file `src/mastra/tools/serpapi-shopping.tool.ts` is now clean again after a targeted `get_errors` refresh.
- Added three new SerpAPI tool surfaces for higher-value production use:
- `googleLocalTool` and `googleMapsReviewsTool` in `src/mastra/tools/serpapi-local-maps.tool.ts`
- `googleImagesTool` in `src/mastra/tools/serpapi-images.tool.ts`
- Wired the new tools into `src/mastra/tools/index.ts` and `src/mastra/agents/researchAgent.ts` so they can be used by the agent runtime.
- Targeted diagnostics are clean for the new tool files and the integration points.

# Active Context Update (2026-04-16 - SerpAPI schema alignment)

- `src/mastra/tools/serpapi-shopping.tool.ts` now uses the documented SerpAPI request/response fields for Amazon, Walmart, and eBay:
- Amazon search uses `k` for the query and `s` for sort values.
- Walmart links now fall back to `product_page_url` when present.
- eBay item ids now accept `product_id` with a fallback to `item_id`, and malformed listings are filtered out before returning.
- `src/mastra/tools/serpapi-news-trends.tool.ts` now models richer Google News and Google Trends sections instead of flattening them away:
- Google News now preserves `position`, `sourceDetails`, `menuLinks`, and a normalized numeric `totalResults`.
- Google Trends now preserves detailed `interestOverTime`, `averages`, `relatedQueries`, and `relatedTopics` objects.
- The stray `mathjs` import was removed from the SerpAPI news/trends module.
- Targeted ESLint validation on the edited SerpAPI tool files is clean.

# Active Context Update (2026-04-16 - FastEmbed warmup and dimension alignment)

- `src/mastra/config/libsql.ts` now imports `warmup()` from `@mastra/fastembed` and preloads the base embed model before `LibsqlMemory` can issue semantic recall calls.
Expand Down
28 changes: 28 additions & 0 deletions memory-bank/progress.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,26 @@
# Progress Update (2026-04-16 - technical-analysis diagnostics fixed)

- Resolved the final `get_errors` issues in `src/mastra/tools/technical-analysis.tool.ts` by correcting leaked return-type annotations, re-typing the MACD/ADX mappings, and restarting the VS Code TypeScript server.
- Confirmed `src/mastra/tools/technical-analysis.tool.ts` is now clean under VS Code diagnostics.
- Confirmed `src/mastra/agents/researchAgent.ts` remains clean after the technical-analysis tool wiring.

# Progress Update (2026-04-16 - technical-analysis hook cleanup and research-agent expansion)

- Refactored `src/mastra/tools/technical-analysis.tool.ts` to use shared hook-logging helpers instead of repeated raw `messages.length` reads across the tool lifecycle hooks.
- Replaced the broad `unknown`/`any`-style result casts in the technical-analysis tool with explicit result interfaces for Ichimoku, trend, momentum, volatility, volume, statistical, market summary, and aggregated technical analysis outputs.
- Added the full technical-analysis suite to `src/mastra/agents/researchAgent.ts` so the research agent can call the new indicator and pattern tools directly.
- Targeted ESLint validation on the two edited files is clean.

# Progress Update (2026-04-16 - SerpAPI production-grade expansion)

- Confirmed `src/mastra/tools/serpapi-shopping.tool.ts` is now clean after rechecking live diagnostics with `get_errors`.
- Added two new SerpAPI-backed production tools:
- `googleLocalTool` for business discovery and normalized local-result lookups.
- `googleMapsReviewsTool` for place reviews, topics, and place-info extraction.
- Added `googleImagesTool` for image discovery, inline image cards, suggested searches, and compact knowledge-graph summaries.
- Wired the new tools into `src/mastra/tools/index.ts` and `src/mastra/agents/researchAgent.ts`, and validated the edited integration files with `get_errors`.
- The new tools and integration points are currently clean in targeted diagnostics.

# Progress Update (2026-04-16 - FastEmbed bootstrap hardening)

- Added `warmup()` from `@mastra/fastembed` to `src/mastra/config/libsql.ts` so the base model cache is preloaded before memory semantic recall starts.
Expand Down Expand Up @@ -508,6 +531,11 @@
## In progress
- None currently.

## Recent completion
- Corrected the SerpAPI shopping tool contracts so Amazon uses the documented `k`/`s` params, Walmart uses `product_page_url` as a fallback link source, and eBay accepts `product_id` with a safe fallback to `item_id`.
- Expanded `src/mastra/tools/serpapi-news-trends.tool.ts` to more closely match SerpApi's documented Google News and Google Trends response sections, including richer nested schemas and additional fields per section.
- Removed the stray `mathjs` import from the news/trends module and revalidated both edited SerpApi tool files with targeted ESLint.
Comment on lines +534 to +537
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot Apr 17, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Bring this file onto the required markdown contract before appending more entries.

This update extends a markdown file that still lacks the required YAML front
matter and continues the H1-based structure used throughout the file, so the
doc-lint/publishing checks will keep failing even though this new section is
otherwise valid. As per coding guidelines, **/*.md: "Do not use H1 headings,
as these will be generated from the title" and "Include YAML front matter at
the beginning of markdown files with required metadata fields..."

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@memory-bank/progress.md` around lines 534 - 537, The file
memory-bank/progress.md is missing the required YAML front matter and contains
H1 headings; add the required YAML front matter block at the top with the
mandatory metadata fields (title, description, date, etc.) per the markdown
contract and remove or convert any top-level H1 headings to lower-level headings
(H2/H3) so the document follows the rule "Do not use H1 headings"; ensure the
new "Recent completion" entry is appended only after the front matter and that
the file structure matches other files in the repository (no leading H1, proper
front matter keys).


## Notes
- The harness UI now talks to the Mastra singleton through a thin JSON API instead of importing server harness code directly into the client.
- The dashboard query currently polls while the page is open so live harness state stays fresh.
Expand Down
Loading
Loading