open-index/open-npm huggingface dataset:
npm package: @galaar/agentecho-core
Description: AgentECHO Core - Framework-agnostic SDK for fire-and-forget AI traffic tracking
Latest version: 0.1.0

# @galaar/agentecho-core

Framework-agnostic core SDK for fire-and-forget request tracking.

## Installation

```bash
pnpm add @galaar/agentecho-core
```

## Usage

```typescript
import { createAgentECHOClient } from '@galaar/agentecho-core';

const tracker = createAgentECHOClient({
  ingestUrl: 'https://ingest.example.com/v1/events',
  keyId: 'prod-key-1',
  hmacSecret: 'your-secret',
  sampleRate: 0.1,
});

tracker.captureEvent({
  method: 'GET',
  pathname: '/api/users',
  ip: '192.168.1.1',
  userAgent: 'Mozilla/5.0...',
});
```

## Configuration

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `ingestUrl` | string | — | Backend endpoint URL |
| `keyId` | string | — | Key identifier for signing |
| `hmacSecret` | string | — | HMAC secret |
| `sampleRate` | number | 0.1 | Sample rate (0-1) |
| `timeout` | number | 3000 | Request timeout (ms) |
| `debug` | boolean | false | Enable debug logging |

## Event Data

```typescript
interface EventData {
  method?: string;
  pathname?: string;
  search?: string;
  ip?: string;
  userAgent?: string;
  referer?: string;
  tags?: Record<string, string>;
  metrics?: Record<string, number>;
}
```

## Components

The SDK is composed of independent components:

```typescript
import {
  createEventBuilder,  // Builds event payloads
  createSampler,       // Deterministic sampling
  createSigner,        // HMAC-SHA256 signing
  createTransport,     // HTTP transport
} from '@galaar/agentecho-core';
```

## Signature Format

```
HMAC-SHA256(secret, timestamp + "." + body)
```

Headers sent:
- `x-agentecho-key-id` — Key identifier
- `x-agentecho-ts` — Unix timestamp (ms)
- `x-agentecho-signature` — Base64url signature

## License

MIT
npm package: @galaar/agentecho-nextjs
Description: AgentECHO Next.js - Next.js adapter for @galaar/agentecho-core with proxy.ts integration
Latest version: 0.1.0

# @galaar/agentecho-nextjs

Next.js adapter for AgentECHO. Integrates with `proxy.ts` / `middleware.ts` for fire-and-forget event tracking.

## Installation

```bash
pnpm add @galaar/agentecho-nextjs
```

## Usage

Create `proxy.ts` in your project root:

```typescript
import { createAgentECHO } from '@galaar/agentecho-nextjs';
import { NextRequest, NextFetchEvent, NextResponse } from 'next/server';

const tracker = createAgentECHO({
  ingestUrl: process.env.AGENTECHO_INGEST_URL!,
  keyId: process.env.AGENTECHO_KEY_ID!,
  hmacSecret: process.env.AGENTECHO_HMAC_SECRET!,
});

export function proxy(req: NextRequest, event: NextFetchEvent) {
  tracker.capture(req, event);
  return NextResponse.next();
}

export const config = {
  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
};
```

## Configuration

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `ingestUrl` | string | — | Backend endpoint URL |
| `keyId` | string | — | Key identifier |
| `hmacSecret` | string | — | HMAC secret |
| `sampleRate` | number | 0.1 | Sample rate (0-1) |
| `timeout` | number | 3000 | Timeout (ms) |
| `debug` | boolean | false | Debug logging |
| `excludePaths` | string[] | [] | Additional paths to exclude |

## Captured Data

Automatically extracted from each request:

- `method` — HTTP method
- `pathname` — Request path
- `search` — Query string
- `ip` — Client IP (from `x-real-ip`, `x-forwarded-for`, or `cf-connecting-ip`)
- `userAgent` — User agent
- `referer` — Referer header

## Default Excluded Paths

- `/_next/static/*`
- `/_next/image/*`
- `/favicon.ico`
- `/robots.txt`
- `/sitemap.xml`
- `/manifest.json`
- `/apple-touch-icon*.png`

## Custom Exclusions

```typescript
const tracker = createAgentECHO({
  // ...
  excludePaths: ['/admin', '/health'],
});
```

## Exports

```typescript
import {
  createAgentECHO,     // Main factory
  extractRequestData,     // Extract data from NextRequest
  extractIpAddress,       // Extract IP from headers
  shouldCapture,          // Check if path should be captured
} from '@galaar/agentecho-nextjs';
```

## Compatibility

- Next.js 15+ (`middleware.ts`)
- Next.js 16+ (`proxy.ts`)

## License

MIT
npm package: @galacean/appx-adapter
Description: Galacean Effects 的小程序/小游戏等适配器
Author: Ant Group CO., Ltd.
Latest version: 0.4.0

# AppX Adapter

帮助 Galacean Effects 框架适配支付宝和微信小程序/小游戏等，抹平 DOM API 和小程序 API 的差异。

## 使用步骤

> 以下以微信小游戏为例

### 1、安装依赖

``` bash
# 安装 Galacean Effects 的小程序/小游戏适配器
$ npm i @galacean/appx-adapter --save
# 安装 Galacean Effects
$ npm i @galacean/effects --save
```

### 2、在微信小程序中使用

``` html
<view style="width: 375px; height: 375px; background-color: black">
  <canvas type="webgl" id="webgl" style="width: 100%; height: 100%;"></canvas>
</view>
```

``` ts
import { registerCanvas } from '@galacean/appx-adapter/weapp';
import { Player } from '@galacean/effects/weapp';

// 1. 使用 adapter 方法注册 canvas
const canvas = await registerCanvas({ id:'#webgl' });
// 2. 通过创建的 canvas 对象实例化一个 Galacean Effects 播放器
const player = new Player({
  canvas,
  pixelRatio: 2,
  renderFramework: 'webgl',
});

// 3. 加载资源并执行播放
void this.player.loadScene('url');
```
npm package: @galacean/create-galacean-app
Description: A tool for creating your galacean application. Currently supported template presets include:
Latest version: 0.9.4

# Create Galacean App

A tool for creating your galacean application. Currently supported template presets include:

- `Vanilla`(Use Vanilla JavaScript/TypeScript)
- `React`(React Template)
- `Vue`(Vue Template)
- `Ali-Mini`(Alibaba Mini Program)
- `Library`(Galacean Library)
- `MiniGame`(Alipay Mini Game)

## Usage

### npm

> Compatibility Note: Node.js version >=12.0.0.

```shell
npm init @galacean/galacean-app
```

### yarn

```shell
yarn create @galacean/galacean-app
```

After creating a template, run:

```shell
npm install
npm run dev
```

Open your browser, you can see:

![image-20210208112945261](https://gw.alipayobjects.com/zos/OasisHub/3dfda7c5-7c65-4976-bc56-6d1f47592a31/image-20210208112945261.png)

Enjoy your exploration of galacean.
npm package: @galacean/document-sense
Description: Provides a series of MCP operations related to Galacean documents
Author: Galacean Team
Latest version: 0.0.1-alpha.13

# Galacean Document Sense

Provides a Model Context Protocol (MCP) server focused on Galacean engine documentation search. It exposes tools like `search_documents` and `solve_requirement` so MCP-compatible clients can retrieve complete markdown files, find relevant snippets by keyword, or map natural language requirements to solution steps.

## Features

- Zero-config startup with STDIO transport.
- Fast in-memory indexing of the `docs/` markdown folder.
- Keyword search with relevance scoring and contextual snippets.
- Direct document retrieval by slug (filename without `.md`).

## Getting Started

```bash
npm install
npm run build
npm start
```

### Using the tool

```
search_documents --query "animator state machine"
search_documents --doc render-pipeline
solve_requirement --requirement "获取屏幕输入点"
```

The tools respond with structured JSON, so MCP clients can render the results or continue the conversation with additional context.

## Project Structure

```
docs/                # Markdown documentation corpus
src/
├── index.ts         # MCP entry point
├── server.ts        # STDIO server bootstrap
├── services/
│   └── docs-service.ts  # Document loading and search logic
└── tools/
    └── tools.ts     # Tool definitions
```

## Scripts

- `npm run build` – Compile TypeScript and copy `docs/` into `dist/`.
- `npm start` – Build the project and launch the MCP server.

## License

MIT