@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.
Files changed (87) hide show
  1. package/README.md +2 -0
  2. package/dist/browser.d.ts +19 -0
  3. package/dist/chat-memory.d.ts +355 -0
  4. package/dist/chat-notify.d.ts +409 -0
  5. package/dist/core-tools.d.ts +131 -0
  6. package/dist/function-skill.d.ts +149 -0
  7. package/dist/git.d.ts +72 -0
  8. package/dist/github.d.ts +777 -0
  9. package/dist/github.js +4 -3
  10. package/dist/gitlab.d.ts +396 -0
  11. package/dist/gitlab.js +19 -0
  12. package/dist/index.d.ts +45 -0
  13. package/dist/index.js +145 -126
  14. package/dist/integrations.d.ts +110 -0
  15. package/dist/jira.d.ts +547 -0
  16. package/dist/lark.d.ts +161 -0
  17. package/dist/linear.d.ts +344 -0
  18. package/dist/llm-billing.d.ts +294 -0
  19. package/dist/memory.d.ts +137 -0
  20. package/dist/package.json +67 -17
  21. package/dist/plane.d.ts +24 -0
  22. package/dist/report.d.ts +354 -0
  23. package/dist/report.js +9 -9
  24. package/dist/sentry.d.ts +43 -0
  25. package/dist/skill-installer.d.ts +86 -0
  26. package/dist/slack.d.ts +284 -0
  27. package/dist/test-runner.d.ts +220 -0
  28. package/dist/trackers/github-adapter.d.ts +96 -0
  29. package/dist/trackers/github-adapter.js +4 -3
  30. package/dist/trackers/index.d.ts +27 -0
  31. package/dist/trackers/index.js +16 -15
  32. package/dist/trackers/jira-adapter.d.ts +90 -0
  33. package/dist/trackers/linear-adapter.d.ts +89 -0
  34. package/dist/trackers/plane-adapter.d.ts +101 -0
  35. package/dist/trackers/types.d.ts +335 -0
  36. package/dist/workflow-builder.d.ts +245 -0
  37. package/docs/apps/agent-ops.md +6 -6
  38. package/docs/apps/deploy.md +1 -1
  39. package/docs/apps/index.md +1 -1
  40. package/docs/apps/managing.md +1 -1
  41. package/docs/cli-reference.md +65 -65
  42. package/docs/cloning-repositories.md +9 -9
  43. package/docs/cloud/bundles.md +8 -8
  44. package/docs/cloud/dedicated-egress.md +6 -6
  45. package/docs/cloud/env-vars.md +29 -29
  46. package/docs/cloud/limits.md +11 -11
  47. package/docs/cloud/triggering.md +16 -16
  48. package/docs/concepts/agents.md +4 -4
  49. package/docs/concepts/sessions.md +7 -7
  50. package/docs/concepts/state.md +1 -1
  51. package/docs/concepts/sub-graphs.md +9 -9
  52. package/docs/get-started/deploy.md +14 -14
  53. package/docs/get-started/install.md +4 -4
  54. package/docs/get-started/run-locally.md +12 -12
  55. package/docs/get-started/trigger-and-logs.md +14 -14
  56. package/docs/get-started/use-from-agents.md +17 -17
  57. package/docs/get-started/your-first-workflow.md +8 -8
  58. package/docs/integrations/gitlab.md +1 -1
  59. package/docs/integrations/lark.md +2 -2
  60. package/docs/integrations/linear.md +1 -1
  61. package/docs/integrations/notion.md +2 -2
  62. package/docs/integrations/plane.md +1 -1
  63. package/docs/integrations/slack.md +1 -1
  64. package/docs/intro.md +4 -4
  65. package/docs/legacy/test-automation.md +2 -2
  66. package/docs/packages/cli.md +11 -11
  67. package/docs/packages/core.md +2 -2
  68. package/docs/packages/mcp-cli.md +18 -18
  69. package/docs/packages/skills.md +2 -2
  70. package/docs/packages/ui-memory.md +1 -1
  71. package/docs/recipes/bug-autofix.md +1 -1
  72. package/docs/recipes/index.md +3 -3
  73. package/docs/recipes/pipeline-supervisor.md +4 -4
  74. package/docs/recipes/sentry-triage.md +7 -7
  75. package/docs/recipes/test.md +6 -6
  76. package/docs/skills/browser.md +2 -2
  77. package/docs/skills/chat-memory.md +1 -1
  78. package/docs/skills/core-tools.md +1 -1
  79. package/docs/skills/function-skill.md +1 -1
  80. package/docs/skills/github.md +2 -2
  81. package/docs/skills/index.md +1 -1
  82. package/docs/skills/jira.md +1 -1
  83. package/docs/skills/lark.md +1 -1
  84. package/docs/skills/memory.md +2 -2
  85. package/docs/skills/sentry.md +1 -1
  86. package/docs/skills/slack.md +2 -2
  87. package/package.json +67 -17
@@ -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 workflow templates (browser-test-automation, code-analysis, generate-test-cases, …). |
26
- | `zibby_scaffold_workflow` | Scaffold `.zibby/workflows/<name>/` from an official template. |
27
- | `zibby_validate_workflow` | Static-check a local workflow (~30 ms, no API call). |
28
- | `zibby_list_workflows` | List workflows: local, remote, or both. |
29
- | `zibby_deploy_workflow` | Deploy a local workflow to a project. |
30
- | `zibby_trigger_workflow` | Trigger a deployed workflow by UUID. Returns `jobId`. |
31
- | `zibby_workflow_logs` | Fetch the latest N log lines from a run (one-shot — call again for newer lines). |
32
- | `zibby_run_workflow_local` | Run a workflow on the user's machine one-shot, for debugging. No cloud. |
33
- | `zibby_download_workflow` | Pull a deployed workflow back to local. Requires explicit `confirm: true` from the agent. |
34
-
35
- **Destructive operations are intentionally not exposed.** Workflow 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.
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
- zibby_scaffold_workflow (browser-test-automation → .zibby/workflows/playhouse-tests/)
132
- zibby_validate_workflow
133
- zibby_deploy_workflow
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: → zibby_trigger_workflow (input: { url: "https://staging.zibby.dev" })
138
- zibby_workflow_logs (lines: 200, jobId: "abc-123")
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 `zibby_deploy_workflow`.
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
- - **`zibby_download_workflow` requires `confirm: true`** — the schema rejects calls without it. Agents must explicitly opt in after confirming the destination path with the user.
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
 
@@ -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 workflow nodes and external capabilities like browser automation, Jira, GitHub, Slack, and test memory.
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 workflow runs:
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 workflow
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 (zibby workflow templates still works)
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
@@ -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 (a workflow graph under the hood), eating its own dog food. Browse them, deploy with one command, and tune them to your project.
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
- > **"Agent" is the product noun** for a deployed automation. The CLI / SDK / API still speak "workflow" the CLI command is `zibby agent` (`zibby workflow` still works as an alias), the package is `@zibby/agent-workflow`.
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 (zibby workflow new still works)
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 pipeline)
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-pipeline read route requires a `userId` from the authorizer, and a project token carries none — so it 401s.
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 a pipeline failing ≥ this fraction of recent runs |
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 pipelines analyzed per run |
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 workflow 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.
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 workflow templates deploy sentry-triage --project <project-id>
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 → workflow → ENV tab):
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 workflow download <uuid>
82
+ zibby agent download <uuid>
83
83
  # edit nodes/dispatch-node.js
84
- zibby workflow deploy ./sentry-triage # same UUID, new version
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 → workflow → Triggers) — keep the SQL safe `since` between 5 and 1440 minutes (`inputSchema` enforces this).
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 workflow](../get-started/your-first-workflow).
93
+ → Next: [`zibby test`](./test) (the browser-testing recipe) or [Build your own agent](../get-started/your-first-workflow).
@@ -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 workflow node with Zod-validated handoff. You can read the source, fork it, or build your own variation.
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 workflow)
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 workflow and copy the structure:
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 workflow new my-test-pipeline
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 workflows triggered remotely (rather than per-CI-run), use [`workflow trigger`](../cloud/triggering) on a deployed graph.
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 workflows from CI/CD
190
+ - [Cloud triggering](../cloud/triggering) — fire agents from CI/CD
@@ -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 workflow node that needs to drive a web UI.
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 a workflow
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 a workflow
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 a workflow
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 a workflow
37
+ ## Use in an agent
38
38
 
39
39
  Once registered, reference by id:
40
40
 
@@ -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 workflow's env (locally) or via **Cloud → Env vars** (cloud runs). Scope `repo` for private read+write, `public_repo` for public-only.
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 a workflow
44
+ ## Use in an agent
45
45
 
46
46
  ```js
47
47
  import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
@@ -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). Workflows publish a `report` object to Notion blocks (`reportToNotionBlocks`), e.g. the `notify-notion` template | OAuth (dashboard) / `NOTION_API_KEY` (SDK) |
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 |
@@ -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 a workflow
43
+ ## Use in an agent
44
44
 
45
45
  ```js
46
46
  import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
@@ -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 a workflow
33
+ ## Use in an agent
34
34
 
35
35
  ```js
36
36
  import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
@@ -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 workflow workspace:
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 a workflow
43
+ ## Use in an agent
44
44
 
45
45
  ```js
46
46
  import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
@@ -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 a workflow
32
+ ## Use in an agent
33
33
 
34
34
  ```js
35
35
  import { WorkflowAgent, WorkflowGraph } from '@zibby/core';
@@ -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 workflow's env (locally) or via **Cloud → Env vars**:
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 a workflow
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.33",
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
- ".": "./dist/index.js",
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": "./dist/browser.js",
13
- "./jira": "./dist/jira.js",
14
- "./github": "./dist/github.js",
15
- "./plane": "./dist/plane.js",
16
- "./slack": "./dist/slack.js",
17
- "./lark": "./dist/lark.js",
18
- "./memory": "./dist/memory.js",
19
- "./function": "./dist/function-skill.js",
20
- "./integrations": "./dist/integrations.js",
21
- "./report": "./dist/report.js",
22
- "./llm-billing": "./dist/llm-billing.js",
23
- "./sentry": "./dist/sentry.js"
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
  }