@electric-ax/agents 0.1.5 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/entrypoint.js +650 -407
- package/dist/index.cjs +668 -418
- package/dist/index.d.cts +36 -3
- package/dist/index.d.ts +36 -3
- package/dist/index.js +653 -410
- package/package.json +5 -9
- package/skills/init.md +71 -0
- package/skills/quickstart.md +672 -0
- package/skills/tutorial.md +0 -282
- /package/skills/{tutorial → quickstart}/scaffold/entities/.gitkeep +0 -0
- /package/skills/{tutorial → quickstart}/scaffold/lib/electric-tools.ts +0 -0
- /package/skills/{tutorial → quickstart}/scaffold/package.json +0 -0
- /package/skills/{tutorial → quickstart}/scaffold/server.ts +0 -0
- /package/skills/{tutorial → quickstart}/scaffold/tsconfig.json +0 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@electric-ax/agents",
|
|
3
|
-
"version": "0.1
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "Built-in Electric Agents runtimes such as Horton and worker",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -29,26 +29,22 @@
|
|
|
29
29
|
},
|
|
30
30
|
"dependencies": {
|
|
31
31
|
"@anthropic-ai/sdk": "^0.78.0",
|
|
32
|
-
"@durable-streams/state": "npm:@electric-ax/durable-streams-state-beta@^0.3.
|
|
32
|
+
"@durable-streams/state": "npm:@electric-ax/durable-streams-state-beta@^0.3.1",
|
|
33
33
|
"@mariozechner/pi-agent-core": "^0.70.2",
|
|
34
34
|
"@mariozechner/pi-ai": "^0.70.2",
|
|
35
|
-
"@mozilla/readability": "^0.6.0",
|
|
36
35
|
"@sinclair/typebox": "^0.34.48",
|
|
36
|
+
"agent-session-protocol": "^0.0.2",
|
|
37
37
|
"better-sqlite3": "^11.10.0",
|
|
38
|
-
"jsdom": "^28.1.0",
|
|
39
38
|
"nanoid": "^3.3.11",
|
|
40
39
|
"pino": "^10.3.1",
|
|
41
40
|
"pino-pretty": "^13.0.0",
|
|
42
41
|
"sqlite-vec": "^0.1.9",
|
|
43
|
-
"
|
|
44
|
-
"
|
|
45
|
-
"@electric-ax/agents-runtime": "0.0.4"
|
|
42
|
+
"zod": "^4.3.6",
|
|
43
|
+
"@electric-ax/agents-runtime": "0.1.1"
|
|
46
44
|
},
|
|
47
45
|
"devDependencies": {
|
|
48
46
|
"@types/better-sqlite3": "^7.6.13",
|
|
49
|
-
"@types/jsdom": "^27.0.0",
|
|
50
47
|
"@types/node": "^22.19.15",
|
|
51
|
-
"@types/turndown": "^5.0.6",
|
|
52
48
|
"@vitest/coverage-v8": "^4.1.0",
|
|
53
49
|
"tsdown": "^0.9.0",
|
|
54
50
|
"typescript": "^5.0.0",
|
package/skills/init.md
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Scaffold a new Electric Agents app project and get oriented in the codebase
|
|
3
|
+
whenToUse: User wants to create a new app, start a project, or scaffold an Electric Agents application
|
|
4
|
+
keywords:
|
|
5
|
+
- init
|
|
6
|
+
- scaffold
|
|
7
|
+
- new project
|
|
8
|
+
- create app
|
|
9
|
+
- starter
|
|
10
|
+
- setup
|
|
11
|
+
user-invocable: true
|
|
12
|
+
argument-hint: '[project-name]'
|
|
13
|
+
arguments:
|
|
14
|
+
- project_name
|
|
15
|
+
max: 15000
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
# Init: Create a New Electric Agents App
|
|
19
|
+
|
|
20
|
+
Help the user scaffold and understand a new Electric Agents project.
|
|
21
|
+
|
|
22
|
+
## Flow
|
|
23
|
+
|
|
24
|
+
### 1. Assess experience
|
|
25
|
+
|
|
26
|
+
Before scaffolding, ask the user:
|
|
27
|
+
|
|
28
|
+
> "Are you familiar with Electric Agents concepts (entities, handlers, spawning workers)? If not, I can walk you through a hands-on quickstart first — or we can dive straight into setting up your project."
|
|
29
|
+
|
|
30
|
+
- If they want the quickstart → load the quickstart skill with `use_skill("quickstart")`
|
|
31
|
+
- If they want to dive in → continue to step 2
|
|
32
|
+
|
|
33
|
+
### 2. Scaffold the project
|
|
34
|
+
|
|
35
|
+
**Ask the user where they want the project.** Suggest a sensible default (e.g., `./$project_name` relative to the working directory) but let them choose. Do not create files or directories until the user confirms the location.
|
|
36
|
+
|
|
37
|
+
If `$project_name` is not provided, ask the user what they'd like to name their project.
|
|
38
|
+
|
|
39
|
+
Run the init command to create the project:
|
|
40
|
+
|
|
41
|
+
```
|
|
42
|
+
npx electric-ax agents init $project_name
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
After the command completes, read the generated project structure to orient yourself.
|
|
46
|
+
|
|
47
|
+
### 3. Orient the user
|
|
48
|
+
|
|
49
|
+
Walk through what was created. Read the key files and explain:
|
|
50
|
+
|
|
51
|
+
- **Project structure** — what each directory and file is for
|
|
52
|
+
- **Entity definitions** — where entity types are defined (e.g., `src/server/` or `entities/`)
|
|
53
|
+
- **Server setup** — how the HTTP server and webhook handler work
|
|
54
|
+
- **Frontend** — how the UI connects to the agent backend (if applicable)
|
|
55
|
+
- **Running it** — the commands to start the dev server
|
|
56
|
+
|
|
57
|
+
Keep explanations concise. The user can ask follow-up questions.
|
|
58
|
+
|
|
59
|
+
### 4. Customize
|
|
60
|
+
|
|
61
|
+
Ask the user what they want to build:
|
|
62
|
+
|
|
63
|
+
> "What kind of app are you thinking of building? I can help you customize the starter — rename entity types, add new ones, adjust the tools, or modify the UI."
|
|
64
|
+
|
|
65
|
+
Help them make their first changes to the scaffolded project.
|
|
66
|
+
|
|
67
|
+
## Rules
|
|
68
|
+
|
|
69
|
+
- Always read generated files before explaining them — don't assume the scaffold output.
|
|
70
|
+
- If the init command doesn't exist or fails, fall back to manual scaffolding: create the project directory, set up package.json, install dependencies, and create a basic server.ts using the pattern from the quickstart skill's scaffold directory.
|
|
71
|
+
- Don't overwhelm with information. Give a high-level overview first, then go deeper when asked.
|