rong 0.6.0

RongJS runtime and embedding API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

# @rongjs/rong-skill

Installer and packaging tools for Rong agent skills.

The source skills live under `../../docs/skills/`. Public runtime API references
come from `../../docs/api/`. This package generates self-contained install assets
under `assets/` when packed or when the CLI is run from a source checkout.

## Bundled Skills

- `rong-runtime-developer` - write Rong JavaScript scripts, choose public APIs,
  adapt examples, run `rong_cli`, and compile bytecode.
- `rong-module-author` - write or edit Rust modules that expose Rong APIs,
  classes, functions, type conversions, and JavaScript errors.
- `rong-runtime-embedder` - build Rust hosts around Rong runtimes, module
  policies, worker pools, timeouts, interruption, and lifecycle management.

## Install

Install all bundled skills:

```bash
npx @rongjs/rong-skill install
```

Project-local install:

```bash
npx @rongjs/rong-skill install --project
```

Install one skill:

```bash
npx @rongjs/rong-skill install --skill rong-module-author
```

Install the Rust host embedding skill:

```bash
npx @rongjs/rong-skill install --skill rong-runtime-embedder
```

Custom skills directory:

```bash
npx @rongjs/rong-skill install --dir /path/to/skills
```

Overwrite existing installed copies:

```bash
npx @rongjs/rong-skill install --force
```

List bundled skills:

```bash
npx @rongjs/rong-skill list
```

## Layout

Source of truth:

```text
../../docs/
|-- api/
`-- skills/
    |-- rong-module-author/
    |-- rong-runtime-developer/
    `-- rong-runtime-embedder/
```

Generated package assets:

```text
assets/
|-- rong-module-author/
|   |-- SKILL.md
|   `-- references/
|       |-- classes.md
|       |-- errors.md
|       |-- functions.md
|       |-- module-structure.md
|       `-- type-conversion.md
|-- rong-runtime-developer/
|   |-- SKILL.md
|   `-- references/
|       |-- api-*.md
|       |-- api-index.md
|       |-- examples.md
|       `-- quickstart.md
`-- rong-runtime-embedder/
    |-- SKILL.md
    `-- references/
        |-- interruption.md
        |-- runtime-setup.md
        `-- worker-pools.md
```

Each installed skill follows the standard `SKILL.md` + optional `references/`
structure. `assets/` is generated and is not the documentation source of truth.

## Development

Validate skill packaging without writing `assets/`:

```bash
npm --prefix packages/skill run check
```

Generate `assets/` explicitly:

```bash
npm --prefix packages/skill run pack:skills
```

Remove generated `assets/`:

```bash
node packages/skill/bin/pack.mjs --clean
```

## Requirements

- Node.js >= 18 for the installer.
- An agent runtime that supports file-based skills.

## License

MIT OR Apache-2.0