@zibby/skills 0.1.33 → 0.1.35
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 +2 -0
- package/dist/browser.d.ts +19 -0
- package/dist/chat-memory.d.ts +355 -0
- package/dist/chat-notify.d.ts +409 -0
- package/dist/core-tools.d.ts +131 -0
- package/dist/function-skill.d.ts +149 -0
- package/dist/git.d.ts +72 -0
- package/dist/github.d.ts +777 -0
- package/dist/github.js +4 -3
- package/dist/gitlab.d.ts +396 -0
- package/dist/gitlab.js +19 -0
- package/dist/index.d.ts +45 -0
- package/dist/index.js +145 -126
- package/dist/integrations.d.ts +110 -0
- package/dist/jira.d.ts +547 -0
- package/dist/lark.d.ts +161 -0
- package/dist/linear.d.ts +344 -0
- package/dist/llm-billing.d.ts +294 -0
- package/dist/memory.d.ts +137 -0
- package/dist/package.json +67 -17
- package/dist/plane.d.ts +24 -0
- package/dist/report.d.ts +354 -0
- package/dist/report.js +9 -9
- package/dist/sentry.d.ts +43 -0
- package/dist/skill-installer.d.ts +86 -0
- package/dist/slack.d.ts +284 -0
- package/dist/test-runner.d.ts +220 -0
- package/dist/trackers/github-adapter.d.ts +96 -0
- package/dist/trackers/github-adapter.js +4 -3
- package/dist/trackers/index.d.ts +27 -0
- package/dist/trackers/index.js +16 -15
- package/dist/trackers/jira-adapter.d.ts +90 -0
- package/dist/trackers/linear-adapter.d.ts +89 -0
- package/dist/trackers/plane-adapter.d.ts +101 -0
- package/dist/trackers/types.d.ts +335 -0
- package/dist/workflow-builder.d.ts +245 -0
- package/docs/apps/agent-ops.md +6 -6
- package/docs/apps/deploy.md +1 -1
- package/docs/apps/index.md +1 -1
- package/docs/apps/managing.md +1 -1
- package/docs/cli-reference.md +65 -65
- package/docs/cloning-repositories.md +9 -9
- package/docs/cloud/bundles.md +8 -8
- package/docs/cloud/dedicated-egress.md +6 -6
- package/docs/cloud/env-vars.md +29 -29
- package/docs/cloud/limits.md +11 -11
- package/docs/cloud/triggering.md +16 -16
- package/docs/concepts/agents.md +4 -4
- package/docs/concepts/sessions.md +7 -7
- package/docs/concepts/state.md +1 -1
- package/docs/concepts/sub-graphs.md +9 -9
- package/docs/get-started/deploy.md +14 -14
- package/docs/get-started/install.md +4 -4
- package/docs/get-started/run-locally.md +12 -12
- package/docs/get-started/trigger-and-logs.md +14 -14
- package/docs/get-started/use-from-agents.md +17 -17
- package/docs/get-started/your-first-workflow.md +8 -8
- package/docs/integrations/gitlab.md +1 -1
- package/docs/integrations/lark.md +2 -2
- package/docs/integrations/linear.md +1 -1
- package/docs/integrations/notion.md +2 -2
- package/docs/integrations/plane.md +1 -1
- package/docs/integrations/slack.md +1 -1
- package/docs/intro.md +4 -4
- package/docs/legacy/test-automation.md +2 -2
- package/docs/packages/cli.md +11 -11
- package/docs/packages/core.md +2 -2
- package/docs/packages/mcp-cli.md +18 -18
- package/docs/packages/skills.md +2 -2
- package/docs/packages/ui-memory.md +1 -1
- package/docs/recipes/bug-autofix.md +1 -1
- package/docs/recipes/index.md +3 -3
- package/docs/recipes/pipeline-supervisor.md +4 -4
- package/docs/recipes/sentry-triage.md +7 -7
- package/docs/recipes/test.md +6 -6
- package/docs/skills/browser.md +2 -2
- package/docs/skills/chat-memory.md +1 -1
- package/docs/skills/core-tools.md +1 -1
- package/docs/skills/function-skill.md +1 -1
- package/docs/skills/github.md +2 -2
- package/docs/skills/index.md +1 -1
- package/docs/skills/jira.md +1 -1
- package/docs/skills/lark.md +1 -1
- package/docs/skills/memory.md +2 -2
- package/docs/skills/sentry.md +1 -1
- package/docs/skills/slack.md +2 -2
- package/package.json +67 -17
package/docs/packages/mcp-cli.md
CHANGED
|
@@ -22,17 +22,17 @@ A Model Context Protocol (MCP) server that exposes the Zibby CLI surface — dep
|
|
|
22
22
|
| `zibby_logout` | Clears the saved session. |
|
|
23
23
|
| `zibby_status` | Who is logged in, how many projects are cached, whether the session is still valid. |
|
|
24
24
|
| `zibby_list_projects` | List the Zibby projects the user has access to. |
|
|
25
|
-
| `zibby_list_templates` | List official
|
|
26
|
-
| `
|
|
27
|
-
| `
|
|
28
|
-
| `
|
|
29
|
-
| `
|
|
30
|
-
| `
|
|
31
|
-
| `
|
|
32
|
-
| `
|
|
33
|
-
| `
|
|
34
|
-
|
|
35
|
-
**Destructive operations are intentionally not exposed.**
|
|
25
|
+
| `zibby_list_templates` | List official agent templates (browser-test-automation, code-analysis, generate-test-cases, …). |
|
|
26
|
+
| `zibby_scaffold_agent` | Scaffold `.zibby/workflows/<name>/` from an official template. |
|
|
27
|
+
| `zibby_validate_agent` | Static-check a local agent (~30 ms, no API call). |
|
|
28
|
+
| `zibby_list_agents` | List agents: local, remote, or both. |
|
|
29
|
+
| `zibby_deploy_agent` | Deploy a local agent to a project. |
|
|
30
|
+
| `zibby_trigger_agent` | Trigger a deployed agent by UUID. Returns `jobId`. |
|
|
31
|
+
| `zibby_agent_logs` | Fetch the latest N log lines from a run (one-shot — call again for newer lines). |
|
|
32
|
+
| `zibby_run_agent_local` | Run an agent on the user's machine one-shot, for debugging. No cloud. |
|
|
33
|
+
| `zibby_download_agent` | Pull a deployed agent back to local. Requires explicit `confirm: true` from the agent. |
|
|
34
|
+
|
|
35
|
+
**Destructive operations are intentionally not exposed.** Agent deletion, env-var mutation, schedule changes, and credential management stay in the `zibby` CLI directly. The agent has to involve the user out-of-band for those.
|
|
36
36
|
|
|
37
37
|
## Install
|
|
38
38
|
|
|
@@ -128,14 +128,14 @@ If your agent on Windows can't find `npx`, wrap with `cmd /c`:
|
|
|
128
128
|
```
|
|
129
129
|
User: Deploy the browser-test template to my "playhouse" project.
|
|
130
130
|
Agent: → zibby_list_projects
|
|
131
|
-
→
|
|
132
|
-
→
|
|
133
|
-
→
|
|
131
|
+
→ zibby_scaffold_agent (browser-test-automation → .zibby/workflows/playhouse-tests/)
|
|
132
|
+
→ zibby_validate_agent
|
|
133
|
+
→ zibby_deploy_agent
|
|
134
134
|
→ "Deployed v1 of playhouse-tests. UUID 988…"
|
|
135
135
|
|
|
136
136
|
User: Run it against staging.zibby.dev.
|
|
137
|
-
Agent: →
|
|
138
|
-
→
|
|
137
|
+
Agent: → zibby_trigger_agent (input: { url: "https://staging.zibby.dev" })
|
|
138
|
+
→ zibby_agent_logs (lines: 200, jobId: "abc-123")
|
|
139
139
|
→ "Run completed. Found 0 errors."
|
|
140
140
|
```
|
|
141
141
|
|
|
@@ -144,7 +144,7 @@ Agent: → zibby_trigger_workflow (input: { url: "https://staging.zibby.dev" })
|
|
|
144
144
|
Two-stage by design (mirrors how the `zibby` CLI works):
|
|
145
145
|
|
|
146
146
|
1. **Session token** (`zibby_login`) — device-code OAuth via browser. Identifies the user.
|
|
147
|
-
2. **Per-project API tokens** — fetched at login time and cached locally. The MCP server picks the right token automatically when you call a project-scoped tool like `
|
|
147
|
+
2. **Per-project API tokens** — fetched at login time and cached locally. The MCP server picks the right token automatically when you call a project-scoped tool like `zibby_deploy_agent`.
|
|
148
148
|
|
|
149
149
|
All credentials live in `~/.zibby/config.json` (mode `0600`). The same file `zibby login` writes — so if you've already done `zibby login` from a terminal, the MCP server picks up that session.
|
|
150
150
|
|
|
@@ -156,7 +156,7 @@ The user's password never touches the MCP server: login is OAuth in the browser,
|
|
|
156
156
|
- **Minimum env passthrough** — only `HOME`, `USER`, `PATH`, and the project-scoped `ZIBBY_API_KEY` reach the child CLI process.
|
|
157
157
|
- **API tokens never returned to the agent** — they live in `~/.zibby/config.json` only, read server-side per call.
|
|
158
158
|
- **Destructive ops excluded** — see the table above.
|
|
159
|
-
- **`
|
|
159
|
+
- **`zibby_download_agent` requires `confirm: true`** — the schema rejects calls without it. Agents must explicitly opt in after confirming the destination path with the user.
|
|
160
160
|
|
|
161
161
|
## Troubleshooting
|
|
162
162
|
|
package/docs/packages/skills.md
CHANGED
|
@@ -17,7 +17,7 @@ npm install @zibby/skills
|
|
|
17
17
|
|
|
18
18
|
## What Are Skills?
|
|
19
19
|
|
|
20
|
-
A **skill** is a declarative description of an MCP (Model Context Protocol) server and the tools it exposes. Skills are the bridge between your
|
|
20
|
+
A **skill** is a declarative description of an MCP (Model Context Protocol) server and the tools it exposes. Skills are the bridge between your agent nodes and external capabilities like browser automation, Jira, GitHub, Slack, and test memory.
|
|
21
21
|
|
|
22
22
|
Skills are **agent-agnostic** — the same skill definition works across Cursor, Claude, and Codex. The framework resolves the skill into the right MCP configuration for whichever agent is active.
|
|
23
23
|
|
|
@@ -46,7 +46,7 @@ export const executeLiveNode = {
|
|
|
46
46
|
};
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
-
When the
|
|
49
|
+
When the agent runs:
|
|
50
50
|
1. The framework reads the node's `skills` array
|
|
51
51
|
2. For each skill, calls `skill.resolve()` to get the MCP server config
|
|
52
52
|
3. Injects the resolved MCP server into the agent's environment
|
|
@@ -51,7 +51,7 @@ zibby memory init
|
|
|
51
51
|
|
|
52
52
|
Creates `.zibby/memory/.dolt/` with the schema for runs, selectors, page model, navigation, and insights.
|
|
53
53
|
|
|
54
|
-
### 3. Enable memory in your
|
|
54
|
+
### 3. Enable memory in your agent
|
|
55
55
|
|
|
56
56
|
Add `SKILLS.MEMORY` to any node that should have memory access:
|
|
57
57
|
|
|
@@ -78,7 +78,7 @@ Plus the children's own config: Jira connected (triage/poll/writeback), GitHub c
|
|
|
78
78
|
## Deploy
|
|
79
79
|
|
|
80
80
|
```bash
|
|
81
|
-
zibby agent templates # browse the marketplace
|
|
81
|
+
zibby agent templates # browse the marketplace
|
|
82
82
|
zibby agent new bug-autofix -t bug-autofix # scaffold the orchestrator
|
|
83
83
|
# ...also scaffold + deploy ticket-triage, code-fix, tracker-writeback in the same project
|
|
84
84
|
zibby agent deploy bug-autofix
|
package/docs/recipes/index.md
CHANGED
|
@@ -5,9 +5,9 @@ title: Agent Marketplace
|
|
|
5
5
|
|
|
6
6
|
# Agent Marketplace
|
|
7
7
|
|
|
8
|
-
Zibby ships a set of **ready-made agents** — production-ready automations you can deploy today. Each one is a real Zibby agent
|
|
8
|
+
Zibby ships a set of **ready-made agents** — production-ready automations you can deploy today. Each one is a real Zibby agent, eating its own dog food. Browse them, deploy with one command, and tune them to your project.
|
|
9
9
|
|
|
10
|
-
> **
|
|
10
|
+
> An **Agent** is a deployed automation built on coding-agent CLIs. Build and ship one with the `zibby agent` CLI.
|
|
11
11
|
|
|
12
12
|
```
|
|
13
13
|
┌──────────────────┐
|
|
@@ -53,7 +53,7 @@ Three reasons we ship ready-made agents alongside the platform:
|
|
|
53
53
|
If you have an agent you'd want shipped as a built-in:
|
|
54
54
|
|
|
55
55
|
```bash
|
|
56
|
-
zibby agent new my-agent # scaffold
|
|
56
|
+
zibby agent new my-agent # scaffold
|
|
57
57
|
# ... build it out ...
|
|
58
58
|
zibby agent run my-agent # test locally
|
|
59
59
|
zibby agent deploy my-agent # ship to your cloud account
|
|
@@ -11,7 +11,7 @@ v1 is strictly **READ → PROPOSE → NOTIFY**. It never edits another agent's g
|
|
|
11
11
|
|
|
12
12
|
```
|
|
13
13
|
scan_pipelines (deterministic + Zibby REST API, PAT-authed)
|
|
14
|
-
→ propose_improvements (LLM — one proposal per flagged
|
|
14
|
+
→ propose_improvements (LLM — one proposal per flagged agent)
|
|
15
15
|
→ notify (LLM + SKILLS.CHAT_NOTIFY — one review card)
|
|
16
16
|
```
|
|
17
17
|
|
|
@@ -21,7 +21,7 @@ If `scan_pipelines` flags nothing, the graph short-circuits straight to `notify`
|
|
|
21
21
|
|
|
22
22
|
A direct authed `GET /executions?projectId=<id>&limit=200` against the Zibby REST API (the same route the dashboard and remote MCP server use), carrying a **user personal access token** in `Authorization: Bearer`.
|
|
23
23
|
|
|
24
|
-
It must be a USER PAT (`zby_pat_…`), **not** the Fargate-injected `PROJECT_API_TOKEN`: every cross-
|
|
24
|
+
It must be a USER PAT (`zby_pat_…`), **not** the Fargate-injected `PROJECT_API_TOKEN`: every cross-agent read route requires a `userId` from the authorizer, and a project token carries none — so it 401s.
|
|
25
25
|
|
|
26
26
|
## Config (ENV tab)
|
|
27
27
|
|
|
@@ -40,9 +40,9 @@ Optional:
|
|
|
40
40
|
| Field | Default | Meaning |
|
|
41
41
|
|---|---|---|
|
|
42
42
|
| `lookbackHours` | 24 | Hours of execution history to scan |
|
|
43
|
-
| `minFailRate` | 0.4 | Flag
|
|
43
|
+
| `minFailRate` | 0.4 | Flag an agent failing ≥ this fraction of recent runs |
|
|
44
44
|
| `targetWorkflowTypes` | — | Optional name filter (case-insensitive substring) |
|
|
45
|
-
| `maxPipelines` | 25 | Cap on distinct
|
|
45
|
+
| `maxPipelines` | 25 | Cap on distinct agents analyzed per run |
|
|
46
46
|
|
|
47
47
|
## Trigger
|
|
48
48
|
|
|
@@ -5,7 +5,7 @@ title: Sentry triage recipe
|
|
|
5
5
|
|
|
6
6
|
# `sentry-triage` — agent-driven Sentry triage
|
|
7
7
|
|
|
8
|
-
An hourly Sentry triage
|
|
8
|
+
An hourly Sentry triage agent that fetches unresolved issues, classifies them by severity, and **routes them to the right human**. Three nodes, end-to-end agent-driven, deployed from the marketplace in one click.
|
|
9
9
|
|
|
10
10
|
```
|
|
11
11
|
fetch_issues → classify → dispatch_alerts
|
|
@@ -27,12 +27,12 @@ The agent uses [`slack_lookup_user_by_email`](../skills/slack), [`slack_list_use
|
|
|
27
27
|
## Deploy from the marketplace
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
|
-
zibby
|
|
30
|
+
zibby agent templates deploy sentry-triage --project <project-id>
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
Or via the dashboard: `/marketplace/workflows` → Sentry Triage → Deploy.
|
|
34
34
|
|
|
35
|
-
After deploy, configure ENV (Apps →
|
|
35
|
+
After deploy, configure ENV (Apps → agent → ENV tab):
|
|
36
36
|
|
|
37
37
|
| Env var | Required? | Default | What it does |
|
|
38
38
|
|---|---|---|---|
|
|
@@ -79,15 +79,15 @@ If you deployed your backend with `RELEASE_SHA` Sentry release-tracking on, susp
|
|
|
79
79
|
Each node's prompt lives in its own module — fork the template, edit, redeploy:
|
|
80
80
|
|
|
81
81
|
```bash
|
|
82
|
-
zibby
|
|
82
|
+
zibby agent download <uuid>
|
|
83
83
|
# edit nodes/dispatch-node.js
|
|
84
|
-
zibby
|
|
84
|
+
zibby agent deploy ./sentry-triage # same UUID, new version
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
Or fork the whole template repo if you want long-term divergence — it's just a `@zibby/workflow-templates/sentry-triage/` directory in the published package.
|
|
88
88
|
|
|
89
89
|
## Cadence
|
|
90
90
|
|
|
91
|
-
Default: hourly cron, fires `sinceMinutes=60`. Change in the trigger config (Apps →
|
|
91
|
+
Default: hourly cron, fires `sinceMinutes=60`. Change in the trigger config (Apps → agent → Triggers) — keep the SQL safe `since` between 5 and 1440 minutes (`inputSchema` enforces this).
|
|
92
92
|
|
|
93
|
-
→ Next: [`zibby test`](./test) (the browser-testing recipe) or [Build your own
|
|
93
|
+
→ Next: [`zibby test`](./test) (the browser-testing recipe) or [Build your own agent](../get-started/your-first-workflow).
|
package/docs/recipes/test.md
CHANGED
|
@@ -7,7 +7,7 @@ title: Browser test recipe (zibby test)
|
|
|
7
7
|
|
|
8
8
|
The browser-test recipe takes a plain-English spec, drives a real browser via a coding agent (Cursor / Claude / Codex / Gemini), runs the assertions, and produces a Playwright script + verification video.
|
|
9
9
|
|
|
10
|
-
It's a worked example of what the Zibby platform does — every step is a regular
|
|
10
|
+
It's a worked example of what the Zibby platform does — every step is a regular agent node with Zod-validated handoff. You can read the source, fork it, or build your own variation.
|
|
11
11
|
|
|
12
12
|
## Quick start
|
|
13
13
|
|
|
@@ -38,7 +38,7 @@ zibby test test-specs/checkout.txt --agent claude
|
|
|
38
38
|
|
|
39
39
|
Open the session in [Zibby Studio](https://zibby.app/studio) to scrub through the run, swap the prompt, re-execute any node.
|
|
40
40
|
|
|
41
|
-
## The graph (this is just a Zibby
|
|
41
|
+
## The graph (this is just a Zibby agent)
|
|
42
42
|
|
|
43
43
|
Under the hood, `zibby test` is a 3-node graph:
|
|
44
44
|
|
|
@@ -115,10 +115,10 @@ Auto-pull on test start, auto-push on test pass. Failing runs don't pollute team
|
|
|
115
115
|
|
|
116
116
|
## Forking the recipe
|
|
117
117
|
|
|
118
|
-
If the built-in recipe doesn't fit your case, scaffold a custom
|
|
118
|
+
If the built-in recipe doesn't fit your case, scaffold a custom agent and copy the structure:
|
|
119
119
|
|
|
120
120
|
```bash
|
|
121
|
-
zibby
|
|
121
|
+
zibby agent new my-test-agent
|
|
122
122
|
```
|
|
123
123
|
|
|
124
124
|
Then in `graph.mjs`, define your own nodes:
|
|
@@ -170,7 +170,7 @@ That's the platform. The recipe is just a starter.
|
|
|
170
170
|
npx @zibby/cli test test-specs/checkout.txt --headless
|
|
171
171
|
```
|
|
172
172
|
|
|
173
|
-
For
|
|
173
|
+
For agents triggered remotely (rather than per-CI-run), use [`agent trigger`](../cloud/triggering) on a deployed graph.
|
|
174
174
|
|
|
175
175
|
## Why this is different from Playwright codegen / a basic LLM script
|
|
176
176
|
|
|
@@ -187,4 +187,4 @@ For workflows triggered remotely (rather than per-CI-run), use [`workflow trigge
|
|
|
187
187
|
|
|
188
188
|
- [Recipes overview](./)
|
|
189
189
|
- [Concepts: graph](../concepts/graph) — the primitives this recipe uses
|
|
190
|
-
- [Cloud triggering](../cloud/triggering) — fire
|
|
190
|
+
- [Cloud triggering](../cloud/triggering) — fire agents from CI/CD
|
package/docs/skills/browser.md
CHANGED
|
@@ -5,7 +5,7 @@ title: Browser
|
|
|
5
5
|
|
|
6
6
|
# Browser skill
|
|
7
7
|
|
|
8
|
-
Playwright-driven browser automation. Click, type, navigate, snapshot, record video. Used by `zibby test` and by any
|
|
8
|
+
Playwright-driven browser automation. Click, type, navigate, snapshot, record video. Used by `zibby test` and by any agent node that needs to drive a web UI.
|
|
9
9
|
|
|
10
10
|
- **ID:** `browser`
|
|
11
11
|
- **MCP server:** `playwright` (tools exposed as `mcp__playwright__*`)
|
|
@@ -45,7 +45,7 @@ npm install @zibby/mcp-browser
|
|
|
45
45
|
|
|
46
46
|
Override the bin path with `MCP_BROWSER_PATH` if you need to point at a local checkout.
|
|
47
47
|
|
|
48
|
-
## Use in
|
|
48
|
+
## Use in an agent
|
|
49
49
|
|
|
50
50
|
```js
|
|
51
51
|
import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
|
@@ -72,7 +72,7 @@ Turn `infer` on when you want mem0 to consolidate noisy inputs into clean facts;
|
|
|
72
72
|
|
|
73
73
|
On Zibby Cloud, mem0 state **persists across Fargate tasks**. mem0's SQLite vector + history stores are rooted under the workspace's tenant-scoped `.zibby/memory/` tree, which is tarball-synced between executions — so a memory written in one run is recallable in the next, even though each run is a fresh, ephemeral container. mem0 user IDs are workspace-scoped (`workspace:<name>`, overridable via `ZIBBY_MEMORY_USER_ID`), keeping each project's memory isolated.
|
|
74
74
|
|
|
75
|
-
## Use in
|
|
75
|
+
## Use in an agent
|
|
76
76
|
|
|
77
77
|
```js
|
|
78
78
|
import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
|
@@ -27,7 +27,7 @@ Most Claude/Cursor/Codex nodes get these tools by default from their agent strat
|
|
|
27
27
|
|
|
28
28
|
None. The skill has no env keys, no auth, no external dependencies.
|
|
29
29
|
|
|
30
|
-
## Use in
|
|
30
|
+
## Use in an agent
|
|
31
31
|
|
|
32
32
|
```js
|
|
33
33
|
import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
|
@@ -34,7 +34,7 @@ export const myTool = skill('my_tool', {
|
|
|
34
34
|
|
|
35
35
|
Calling `skill()` both creates and **registers** the skill in the global registry, so just importing the module is enough to make it available.
|
|
36
36
|
|
|
37
|
-
## Use in
|
|
37
|
+
## Use in an agent
|
|
38
38
|
|
|
39
39
|
Once registered, reference by id:
|
|
40
40
|
|
package/docs/skills/github.md
CHANGED
|
@@ -37,11 +37,11 @@ Two options:
|
|
|
37
37
|
|
|
38
38
|
**GitHub App (recommended).** In **Settings → Integrations**, click **Connect GitHub**, install the Zibby GitHub App on the orgs/repos you want, and authorize. Tokens auto-refresh; you don't manage them. See the [GitHub Integration page](../integrations/github.md) for the full app permissions list.
|
|
39
39
|
|
|
40
|
-
**Personal access token.** Set `GITHUB_TOKEN` in your
|
|
40
|
+
**Personal access token.** Set `GITHUB_TOKEN` in your agent's env (locally) or via **Cloud → Env vars** (cloud runs). Scope `repo` for private read+write, `public_repo` for public-only.
|
|
41
41
|
|
|
42
42
|
The skill reads `envKeys: ['GITHUB_TOKEN']` and the official `@modelcontextprotocol/server-github` consumes it directly.
|
|
43
43
|
|
|
44
|
-
## Use in
|
|
44
|
+
## Use in an agent
|
|
45
45
|
|
|
46
46
|
```js
|
|
47
47
|
import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
package/docs/skills/index.md
CHANGED
|
@@ -20,7 +20,7 @@ Per-skill reference for everything shipped in `@zibby/skills`. For the mental mo
|
|
|
20
20
|
| [Jira](./jira.md) | `jira` | Issues, sprints, comments, transitions | Atlassian OAuth |
|
|
21
21
|
| Linear | `linear` | `linear_list_issues`, `linear_get_issue`, `linear_add_comment`, `linear_update_state`, `linear_list_teams/states/labels` | `LINEAR_API_KEY` |
|
|
22
22
|
| Plane | `plane` | Projects, work items, cycles, modules, epics, comments (official MCP) | `PLANE_API_KEY` (+ `PLANE_WORKSPACE_SLUG`, `PLANE_BASE_URL`) |
|
|
23
|
-
| Notion | n/a | Not an attachable MCP skill — a [connectable integration](../integrations/notion.md).
|
|
23
|
+
| Notion | n/a | Not an attachable MCP skill — a [connectable integration](../integrations/notion.md). Agents publish a `report` object to Notion blocks (`reportToNotionBlocks`), e.g. the `notify-notion` template | OAuth (dashboard) / `NOTION_API_KEY` (SDK) |
|
|
24
24
|
| [Memory](./memory.md) | `memory` | Test history, selectors, page model (Dolt) | `zibby init --mem` |
|
|
25
25
|
| [Chat memory](./chat-memory.md) | `chat-memory` | `memory_store`, `memory_recall`, `memory_brief`, `task_log`, `task_history` | None (Dolt or mem0) |
|
|
26
26
|
| [Core tools](./core-tools.md) | `core-tools` | `read_file`, `write_file`, `list_directory`, `run_command`, `open_url`, `wait` | None |
|
package/docs/skills/jira.md
CHANGED
|
@@ -40,7 +40,7 @@ See the [Jira Integration page](../integrations/jira.md) for the user-facing set
|
|
|
40
40
|
|
|
41
41
|
Under the hood the bin reads `ATLASSIAN_ACCESS_TOKEN` + `ATLASSIAN_CLOUD_ID` (and optional `ATLASSIAN_INSTANCE_URL`), which the backend supplies through `resolveIntegrationToken('jira')`.
|
|
42
42
|
|
|
43
|
-
## Use in
|
|
43
|
+
## Use in an agent
|
|
44
44
|
|
|
45
45
|
```js
|
|
46
46
|
import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
package/docs/skills/lark.md
CHANGED
|
@@ -30,7 +30,7 @@ Lark bots authenticate with App ID + App Secret. The bot needs `im:message` and
|
|
|
30
30
|
|
|
31
31
|
For self-hosted Lark deployments, set `host` on the integration config; the default is the standard Feishu host.
|
|
32
32
|
|
|
33
|
-
## Use in
|
|
33
|
+
## Use in an agent
|
|
34
34
|
|
|
35
35
|
```js
|
|
36
36
|
import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
package/docs/skills/memory.md
CHANGED
|
@@ -30,7 +30,7 @@ Requires [Dolt](https://docs.dolthub.com/introduction/installation) and an initi
|
|
|
30
30
|
```bash
|
|
31
31
|
# macOS
|
|
32
32
|
brew install dolt
|
|
33
|
-
# then, in your
|
|
33
|
+
# then, in your agent workspace:
|
|
34
34
|
zibby init --mem
|
|
35
35
|
```
|
|
36
36
|
|
|
@@ -40,7 +40,7 @@ Override the bin location for development with `MCP_MEMORY_PATH`.
|
|
|
40
40
|
|
|
41
41
|
See [Tests → Memory](../tests/memory.md) for the full memory lifecycle.
|
|
42
42
|
|
|
43
|
-
## Use in
|
|
43
|
+
## Use in an agent
|
|
44
44
|
|
|
45
45
|
```js
|
|
46
46
|
import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
package/docs/skills/sentry.md
CHANGED
|
@@ -29,7 +29,7 @@ Sentry uses OAuth 2.0 with PKCE (public client — no client secret).
|
|
|
29
29
|
|
|
30
30
|
The backend (`/integrations/sentry/connect` and `/integrations/sentry/callback`) handles the PKCE exchange. Tokens auto-refresh on use; if refresh fails, click **Reconnect** in the same settings panel.
|
|
31
31
|
|
|
32
|
-
## Use in
|
|
32
|
+
## Use in an agent
|
|
33
33
|
|
|
34
34
|
```js
|
|
35
35
|
import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
package/docs/skills/slack.md
CHANGED
|
@@ -31,7 +31,7 @@ Slack uses a bot token + workspace team id.
|
|
|
31
31
|
1. Create (or reuse) a Slack app at [api.slack.com/apps](https://api.slack.com/apps).
|
|
32
32
|
2. Add Bot Token Scopes: `chat:write`, `channels:read`, `channels:history`, `groups:read`, `users:read`, `reactions:write` (minimum).
|
|
33
33
|
3. Install the app to your workspace; copy the **Bot User OAuth Token** (`xoxb-…`) and **Team ID**.
|
|
34
|
-
4. Set them on the
|
|
34
|
+
4. Set them on the agent's env (locally) or via **Cloud → Env vars**:
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
37
|
SLACK_BOT_TOKEN=xoxb-...
|
|
@@ -40,7 +40,7 @@ SLACK_TEAM_ID=T01234567
|
|
|
40
40
|
|
|
41
41
|
The skill declares `envKeys: ['SLACK_BOT_TOKEN', 'SLACK_TEAM_ID']` and the official `@modelcontextprotocol/server-slack` consumes them.
|
|
42
42
|
|
|
43
|
-
## Use in
|
|
43
|
+
## Use in an agent
|
|
44
44
|
|
|
45
45
|
```js
|
|
46
46
|
import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
|
package/package.json
CHANGED
|
@@ -1,29 +1,78 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@zibby/skills",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.35",
|
|
4
4
|
"description": "Built-in skill definitions for Zibby test automation framework",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
|
+
"types": "dist/index.d.ts",
|
|
7
8
|
"exports": {
|
|
8
|
-
".":
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"default": "./dist/index.js"
|
|
12
|
+
},
|
|
9
13
|
"./bin/mcp-sentry.mjs": "./bin/mcp-sentry.mjs",
|
|
10
14
|
"./bin/mcp-lark.mjs": "./bin/mcp-lark.mjs",
|
|
11
15
|
"./bin/mcp-slack.mjs": "./bin/mcp-slack.mjs",
|
|
12
|
-
"./browser":
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
"./
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
"./
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
16
|
+
"./browser": {
|
|
17
|
+
"types": "./dist/browser.d.ts",
|
|
18
|
+
"default": "./dist/browser.js"
|
|
19
|
+
},
|
|
20
|
+
"./jira": {
|
|
21
|
+
"types": "./dist/jira.d.ts",
|
|
22
|
+
"default": "./dist/jira.js"
|
|
23
|
+
},
|
|
24
|
+
"./github": {
|
|
25
|
+
"types": "./dist/github.d.ts",
|
|
26
|
+
"default": "./dist/github.js"
|
|
27
|
+
},
|
|
28
|
+
"./gitlab": {
|
|
29
|
+
"types": "./dist/gitlab.d.ts",
|
|
30
|
+
"default": "./dist/gitlab.js"
|
|
31
|
+
},
|
|
32
|
+
"./linear": {
|
|
33
|
+
"types": "./dist/linear.d.ts",
|
|
34
|
+
"default": "./dist/linear.js"
|
|
35
|
+
},
|
|
36
|
+
"./plane": {
|
|
37
|
+
"types": "./dist/plane.d.ts",
|
|
38
|
+
"default": "./dist/plane.js"
|
|
39
|
+
},
|
|
40
|
+
"./slack": {
|
|
41
|
+
"types": "./dist/slack.d.ts",
|
|
42
|
+
"default": "./dist/slack.js"
|
|
43
|
+
},
|
|
44
|
+
"./lark": {
|
|
45
|
+
"types": "./dist/lark.d.ts",
|
|
46
|
+
"default": "./dist/lark.js"
|
|
47
|
+
},
|
|
48
|
+
"./memory": {
|
|
49
|
+
"types": "./dist/memory.d.ts",
|
|
50
|
+
"default": "./dist/memory.js"
|
|
51
|
+
},
|
|
52
|
+
"./function": {
|
|
53
|
+
"types": "./dist/function-skill.d.ts",
|
|
54
|
+
"default": "./dist/function-skill.js"
|
|
55
|
+
},
|
|
56
|
+
"./integrations": {
|
|
57
|
+
"types": "./dist/integrations.d.ts",
|
|
58
|
+
"default": "./dist/integrations.js"
|
|
59
|
+
},
|
|
60
|
+
"./report": {
|
|
61
|
+
"types": "./dist/report.d.ts",
|
|
62
|
+
"default": "./dist/report.js"
|
|
63
|
+
},
|
|
64
|
+
"./llm-billing": {
|
|
65
|
+
"types": "./dist/llm-billing.d.ts",
|
|
66
|
+
"default": "./dist/llm-billing.js"
|
|
67
|
+
},
|
|
68
|
+
"./sentry": {
|
|
69
|
+
"types": "./dist/sentry.d.ts",
|
|
70
|
+
"default": "./dist/sentry.js"
|
|
71
|
+
}
|
|
24
72
|
},
|
|
25
73
|
"scripts": {
|
|
26
|
-
"build": "node ../scripts/build.mjs",
|
|
74
|
+
"build": "node ../scripts/build.mjs && npm run build:types",
|
|
75
|
+
"build:types": "tsc -p tsconfig.types.json",
|
|
27
76
|
"prepack": "node scripts/copy-docs.mjs",
|
|
28
77
|
"lint": "eslint .",
|
|
29
78
|
"lint:fix": "eslint --fix ."
|
|
@@ -56,8 +105,8 @@
|
|
|
56
105
|
"node": ">=18.0.0"
|
|
57
106
|
},
|
|
58
107
|
"dependencies": {
|
|
59
|
-
"@zibby/agent-workflow": "^0.3.0",
|
|
60
108
|
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
109
|
+
"@zibby/agent-workflow": "^0.3.0",
|
|
61
110
|
"better-sqlite3": "^12.6.2",
|
|
62
111
|
"mem0ai": "npm:@zibby/mem0ai@^3.0.5",
|
|
63
112
|
"zod": "^3.23.0 || ^4.0.0"
|
|
@@ -73,6 +122,7 @@
|
|
|
73
122
|
"@eslint/js": "^10.0.1",
|
|
74
123
|
"esbuild": "^0.28.0",
|
|
75
124
|
"eslint": "^10.0.2",
|
|
76
|
-
"globals": "^17.4.0"
|
|
125
|
+
"globals": "^17.4.0",
|
|
126
|
+
"typescript": "^5.9.3"
|
|
77
127
|
}
|
|
78
128
|
}
|