open-index/open-npm huggingface dataset:
npm package: @hirey/hi-agent-contracts
Description: `hi-agent-contracts` 承载 Hi external agent gateway 的正式公共合同。
Latest version: 0.1.13

# hi-agent-contracts

`hi-agent-contracts` 承载 Hi external agent gateway 的正式公共合同。

## 内容

- well-known / skills / capabilities / registry / delivery 的公共类型
- topic / scope / delivery profile / capability binding 常量
- event/resource ref / preview / installation / endpoint / subscription 输入类型
- normalize / parse / fetch-uri 辅助函数

## 当前协议重点

- discovery 层：`/.well-known/hi-agent-platform.json`
- skills artifact：`SKILL.md`、`manifest.json`、`bundle.zip`
- capability 层：稳定 `hi.*` capability id + HTTP/MCP bindings
- registry 层：`agents`、`agent_installations`、`agent_endpoints`、`agent_subscriptions`
- installation receiving capability 层：`pull_stream`、`claim_ack`、`generic_webhook`、`claude_channel`、`openclaw_hooks`、`openresponses`、`local_receiver`
- delivery 层：`generic.event-webhook.v1`、`openclaw.hooks.agent.v1`、`openresponses.v1`、`hi.sse.v1`

这个仓不承载数据库、HTTP server 或业务编排；它只负责公共合同本身。
npm package: @hirey/hi-agent-sdk
Description: `hi-agent-sdk` 是 external agent 接入 Hi 的正式 client / stream SDK。
Latest version: 0.1.9

# hi-agent-sdk

`hi-agent-sdk` 是 external agent 接入 Hi 的正式 client / stream SDK。

## 当前内容

- `HiAgentPlatformClient`：well-known、skills、capabilities、capability call
- `HiAgentGatewayClient`：register / connect / activate / me / installation / endpoints / subscriptions / test-delivery / claim / fetch / ack
- `createHiAgentClients()`：先读 well-known，再自动构造 platform + gateway client；后续调用会切到 well-known 返回的 canonical service URL，而不是死守初始 discovery URL
- `exchangeHiAgentClientCredentialsToken()`：用 register 返回的 `client_id/client_secret` 向 gateway `oauth_token_url` 交换短期 access token
- SSE stream helper

## 使用顺序

- 先读取 `/.well-known/hi-agent-platform.json`
- 再按服务目录访问 skills / capabilities / registry / delivery；如果 discovery URL 和实际业务入口分离（例如 CDN 只负责 discover，auth-required capability call 走 canonical origin），SDK 会自动切到 well-known 返回的正式 base URL
- 首次 `register` 时 `agent_id` 可以省略；gateway 会正式生成 canonical `ag_...`，之后再用返回/查询到的 agent 身份继续 `activate` 或 `connect`
- 如果宿主需要声明自己的收消息方式，使用 register/connect 的 `delivery_capabilities`，或后续调用 `GET/PUT /v1/agents/me/installation`
- push profile 与 subscription/claim/fetch/ack 可以并行配置，但正式消费确认仍然建议走 claim/fetch/ack

后续如果要支持 webhook 回调签名、自动重连状态机、cursor 持久化，可继续在这里扩展。
npm package: @hirez_io/lembas-cypress
Description: A cypress plugin to run lembas setup files as a task.
Latest version: 0.0.5

# lembas-cypress

A cypress plugin to run lembas setup files as a task.

## Usage

In your `plugins/index.ts` add the following:

```
import { setupDataTask } from '@hirez_io/lembas-cypress';

export default (on, config) => {
  on('task', setupDataTask);
  
};

```

Then in your tests you can call the task like this:

```
import { SETUP_DATA } from '@hirez_io/lembas-cypress';
import { MainSetupData } from './main.smoke.setup';

describe('main smoke test', () => {

  it('should do something', () => {

    cy.task<MainSetupData>(SETUP_DATA, 'src/smoke/main.smoke.setup').then(data) => {

      cy.visit('/');

      // ... do something with the data ...
      
    });
  });
});


```