agentic-surfaces 0.1.23 → 0.1.25
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/README.md +40 -0
- package/package.json +17 -3
package/README.md
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# agentic-surfaces
|
|
2
|
+
|
|
3
|
+
A small, local-first workflow engine for running deterministic, agent-in-the-loop automations
|
|
4
|
+
against your "surfaces" (Jira / Confluence / GitHub / HTTP APIs). Workflows are plain YAML:
|
|
5
|
+
deterministic nodes (`task.http`, `task.transform`, `task.branch`, `task.foreach`, cache) do the
|
|
6
|
+
wiring, and `agent.run` nodes call a Claude agent to decide or draft — with a live dashboard.
|
|
7
|
+
|
|
8
|
+
**Repo & full docs:** https://github.com/dalebaldwin/agentic-surfaces
|
|
9
|
+
|
|
10
|
+
## Quick start
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
# point it at a folder containing agentic-surfaces.config.yaml + workflows/
|
|
14
|
+
npx -y agentic-surfaces start ./my-project --ui
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
- `--ui` serves a live dashboard at http://127.0.0.1:4000 (workflow graph, runs, agent activity,
|
|
18
|
+
cache inspector).
|
|
19
|
+
- `--watch` restarts on config changes (use under a supervisor for live editing).
|
|
20
|
+
- Cron-triggered workflows fire on schedule; entry workflows are runnable from the dashboard.
|
|
21
|
+
|
|
22
|
+
## Secrets
|
|
23
|
+
|
|
24
|
+
Workflows reference secrets as `${VAR}`. Provide them however you like:
|
|
25
|
+
|
|
26
|
+
- a **`.env`** file in the working directory (auto-loaded), e.g. `JIRA_EMAIL=…`, or
|
|
27
|
+
- a secrets manager such as **Doppler** (`doppler run -- npx agentic-surfaces …`), or
|
|
28
|
+
- plain `export`s.
|
|
29
|
+
|
|
30
|
+
Real environment variables and Doppler override a `.env`.
|
|
31
|
+
|
|
32
|
+
## Safety
|
|
33
|
+
|
|
34
|
+
Set `dryRun: true` in `agentic-surfaces.config.yaml` to block + log all writes (deterministic HTTP
|
|
35
|
+
writes and capable agents' tool/MCP writes) while you build. Flip to `false` to go live.
|
|
36
|
+
|
|
37
|
+
## Packages
|
|
38
|
+
|
|
39
|
+
This is the launcher for the [`@agentic-surfaces/*`](https://github.com/dalebaldwin/agentic-surfaces)
|
|
40
|
+
toolkit (`cli`, `core`, `agent`, `server`, connectors). MIT licensed.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentic-surfaces",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.25",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"description": "Visualize and follow your agentic-surfaces workflows in the browser — run `npx agentic-surfaces` from your repo to open the live dashboard.",
|
|
@@ -11,11 +11,25 @@
|
|
|
11
11
|
"agentic-surfaces": "dist/bin.js"
|
|
12
12
|
},
|
|
13
13
|
"files": [
|
|
14
|
-
"dist"
|
|
14
|
+
"dist",
|
|
15
|
+
"README.md"
|
|
15
16
|
],
|
|
16
17
|
"dependencies": {
|
|
17
|
-
"@agentic-surfaces/cli": "0.1.
|
|
18
|
+
"@agentic-surfaces/cli": "0.1.25"
|
|
18
19
|
},
|
|
20
|
+
"repository": {
|
|
21
|
+
"type": "git",
|
|
22
|
+
"url": "git+https://github.com/dalebaldwin/agentic-surfaces.git",
|
|
23
|
+
"directory": "packages/launcher"
|
|
24
|
+
},
|
|
25
|
+
"homepage": "https://github.com/dalebaldwin/agentic-surfaces#readme",
|
|
26
|
+
"bugs": "https://github.com/dalebaldwin/agentic-surfaces/issues",
|
|
27
|
+
"keywords": [
|
|
28
|
+
"agentic-surfaces",
|
|
29
|
+
"workflow",
|
|
30
|
+
"ai-agents",
|
|
31
|
+
"claude"
|
|
32
|
+
],
|
|
19
33
|
"scripts": {
|
|
20
34
|
"build": "tsc -b"
|
|
21
35
|
}
|