@getpagr/cli 1.0.5 → 1.0.7
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 +30 -4
- package/dist/commands/config.d.ts.map +1 -1
- package/dist/commands/config.js +13 -0
- package/dist/commands/config.js.map +1 -1
- package/dist/commands/init.d.ts.map +1 -1
- package/dist/commands/init.js +7 -276
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/upload.d.ts.map +1 -1
- package/dist/commands/upload.js +14 -1
- package/dist/commands/upload.js.map +1 -1
- package/dist/lib/api.d.ts +1 -0
- package/dist/lib/api.d.ts.map +1 -1
- package/dist/lib/api.js +23 -8
- package/dist/lib/api.js.map +1 -1
- package/dist/lib/skills.d.ts +3 -0
- package/dist/lib/skills.d.ts.map +1 -0
- package/dist/lib/skills.js +299 -0
- package/dist/lib/skills.js.map +1 -0
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -7,7 +7,33 @@ One local `.html` file in, one public Pagr URL out.
|
|
|
7
7
|
## Requirements
|
|
8
8
|
|
|
9
9
|
- Node.js 20 or newer.
|
|
10
|
-
- A Pagr account (optional).
|
|
10
|
+
- A Pagr account (optional — see [Authentication](#authentication-and-anonymous-usage)).
|
|
11
|
+
|
|
12
|
+
## Authentication and Anonymous Usage
|
|
13
|
+
|
|
14
|
+
`pagr upload` works without an API key for one-shot publishing. Everything else requires a key.
|
|
15
|
+
|
|
16
|
+
| Operation | No API key | With API key |
|
|
17
|
+
| --- | --- | --- |
|
|
18
|
+
| `pagr upload file.html` (no flags) | Works. 24h TTL, 1 MB max, auto-generated slug. | Works with plan-based limits. |
|
|
19
|
+
| `pagr upload --slug` / `--password` / `--hide-banner` | Fails locally with an auth-required message. | Works if your plan allows the feature. |
|
|
20
|
+
| `pagr ls`, `pagr rm`, `pagr rename` | Fails locally: missing API key. | Works. |
|
|
21
|
+
|
|
22
|
+
Rate limits for anonymous uploads: **10 uploads per hour per IP**. Exceeding the limit returns `429 Rate limit exceeded`.
|
|
23
|
+
|
|
24
|
+
To unlock the rest of the CLI, run `pagr login` (browser flow) or set `PAGR_API_KEY=pagr_...` in your environment.
|
|
25
|
+
|
|
26
|
+
## Edge WAF header
|
|
27
|
+
|
|
28
|
+
The CLI sends an `X-Pagr-Token` header on every API request. This value is a Cloudflare WAF allow-list heuristic for the published CLI, not an authentication secret and not an authorization control. The Worker authorizes requests with Clerk bearer tokens or hashed `pagr_...` API keys only.
|
|
29
|
+
|
|
30
|
+
When publishing a new CLI release, rotate the WAF token with:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
pnpm --filter @getpagr/cli generate-waf-token
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
Then update the matching Cloudflare WAF Custom Rule before publishing the package. If the edge token is stale, users should receive the CLI's "package is outdated" 403 guidance.
|
|
11
37
|
|
|
12
38
|
## Installation
|
|
13
39
|
|
|
@@ -41,11 +67,11 @@ Run `pagr login` to connect the CLI to your Pagr account.
|
|
|
41
67
|
pagr login
|
|
42
68
|
```
|
|
43
69
|
|
|
44
|
-
The default browser flow works like this:
|
|
70
|
+
The default browser flow (backed by Clerk auth in the app) works like this:
|
|
45
71
|
|
|
46
72
|
1. The CLI starts a temporary local callback server on `127.0.0.1`.
|
|
47
73
|
2. The CLI opens `https://app.getpagr.co/cli?callback=...&state=...` in your browser.
|
|
48
|
-
3. The Pagr app
|
|
74
|
+
3. The Pagr app validates your Clerk session, creates a CLI API key, and posts it back to the local callback.
|
|
49
75
|
4. The CLI validates the `state`, validates that the key starts with `pagr_`, and stores it in `~/.pagr/config.json`.
|
|
50
76
|
5. The login session times out after 5 minutes.
|
|
51
77
|
|
|
@@ -293,7 +319,7 @@ Behavior:
|
|
|
293
319
|
- The MCP server command remains:
|
|
294
320
|
|
|
295
321
|
```bash
|
|
296
|
-
npx -y @
|
|
322
|
+
npx -y @getpagr/mcp
|
|
297
323
|
```
|
|
298
324
|
|
|
299
325
|
## CI Usage
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,qDAuExB,CAAA"}
|
package/dist/commands/config.js
CHANGED
|
@@ -1,5 +1,8 @@
|
|
|
1
|
+
import { existsSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
1
3
|
import { defineCommand } from 'citty';
|
|
2
4
|
import { readConfig, writeConfig } from '../lib/config.js';
|
|
5
|
+
import { writeSkillFiles } from '../lib/skills.js';
|
|
3
6
|
export const configCommand = defineCommand({
|
|
4
7
|
meta: {
|
|
5
8
|
name: 'config',
|
|
@@ -26,6 +29,16 @@ export const configCommand = defineCommand({
|
|
|
26
29
|
const current = readConfig();
|
|
27
30
|
writeConfig({ ...current, apiKey: args.key });
|
|
28
31
|
console.log('API key saved to ~/.pagr/config.json');
|
|
32
|
+
// Also update skill files in the current workspace if it's initialized
|
|
33
|
+
const cwd = process.cwd();
|
|
34
|
+
const skillMdPath = join(cwd, 'SKILL.md');
|
|
35
|
+
const hasSkillFile = existsSync(skillMdPath);
|
|
36
|
+
const hasClaudeDir = existsSync(join(cwd, '.claude'));
|
|
37
|
+
const hasAgentsDir = existsSync(join(cwd, '.agents'));
|
|
38
|
+
if (hasSkillFile || hasClaudeDir || hasAgentsDir) {
|
|
39
|
+
writeSkillFiles(cwd, args.key, hasClaudeDir);
|
|
40
|
+
console.log('Workspace skill files updated with your active API key and remote MCP instructions.');
|
|
41
|
+
}
|
|
29
42
|
},
|
|
30
43
|
}),
|
|
31
44
|
'set-url': defineCommand({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,WAAW;;;;;;;;;;;;;EAqCtB,CAAA"}
|
package/dist/commands/init.js
CHANGED
|
@@ -1,265 +1,8 @@
|
|
|
1
1
|
import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
|
2
2
|
import { join } from 'node:path';
|
|
3
3
|
import { defineCommand } from 'citty';
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
'',
|
|
7
|
-
'Use this skill when the user wants to publish, update, list, delete, or manage HTML files with the Pagr CLI.',
|
|
8
|
-
'',
|
|
9
|
-
'## When To Use This Skill',
|
|
10
|
-
'',
|
|
11
|
-
'- Publishing generated HTML reports, dashboards, documents, or plans.',
|
|
12
|
-
'- Updating existing published Pagr pages while keeping the same public URL.',
|
|
13
|
-
'- Creating shareable URLs for local HTML artifacts.',
|
|
14
|
-
'- Listing or deleting Pagr files from a user account.',
|
|
15
|
-
'- Setting up Pagr in a project for agent workflows.',
|
|
16
|
-
'- Publishing HTML artifacts from CI.',
|
|
17
|
-
'',
|
|
18
|
-
'## Core Rules',
|
|
19
|
-
'',
|
|
20
|
-
'- Use `pagr upload <file>` for HTML files.',
|
|
21
|
-
'- Never invent a Pagr URL. Always return the URL printed by the CLI.',
|
|
22
|
-
'- If a file contains `<meta name="pagr-id">` or `<meta name="pagr-slug">`, `pagr upload <file>` may update the existing page instead of creating a new one.',
|
|
23
|
-
'- Updates replace the current HTML in place. Pagr does not store previous HTML versions or rollback history.',
|
|
24
|
-
'- Prefer `PAGR_API_KEY` in CI instead of writing `~/.pagr/config.json`.',
|
|
25
|
-
'- Do not print or expose full API keys unless the user explicitly asks to configure authentication.',
|
|
26
|
-
'- If upload, update, list, or delete fails, surface the exact CLI/API error.',
|
|
27
|
-
'',
|
|
28
|
-
'## Installation',
|
|
29
|
-
'',
|
|
30
|
-
'```bash',
|
|
31
|
-
'npm install -g @getpagr/cli',
|
|
32
|
-
'```',
|
|
33
|
-
'',
|
|
34
|
-
'Pagr CLI requires Node.js 20 or newer. The installed command is `pagr`.',
|
|
35
|
-
'',
|
|
36
|
-
'## Authentication',
|
|
37
|
-
'',
|
|
38
|
-
'Browser login:',
|
|
39
|
-
'',
|
|
40
|
-
'```bash',
|
|
41
|
-
'pagr login',
|
|
42
|
-
'```',
|
|
43
|
-
'',
|
|
44
|
-
'`pagr login` starts a browser login flow, authenticates with Pagr, receives a CLI API key through a local callback, and saves it to `~/.pagr/config.json`.',
|
|
45
|
-
'',
|
|
46
|
-
'Manual login for SSH, headless, or locked-down environments:',
|
|
47
|
-
'',
|
|
48
|
-
'```bash',
|
|
49
|
-
'pagr login --manual',
|
|
50
|
-
'```',
|
|
51
|
-
'',
|
|
52
|
-
'Save a key without prompting:',
|
|
53
|
-
'',
|
|
54
|
-
'```bash',
|
|
55
|
-
'pagr login --key pagr_...',
|
|
56
|
-
'```',
|
|
57
|
-
'',
|
|
58
|
-
'Set a key directly in local config:',
|
|
59
|
-
'',
|
|
60
|
-
'```bash',
|
|
61
|
-
'pagr config set-key pagr_...',
|
|
62
|
-
'```',
|
|
63
|
-
'',
|
|
64
|
-
'API keys must start with `pagr_`.',
|
|
65
|
-
'',
|
|
66
|
-
'Config location:',
|
|
67
|
-
'',
|
|
68
|
-
'```text',
|
|
69
|
-
'~/.pagr/config.json',
|
|
70
|
-
'```',
|
|
71
|
-
'',
|
|
72
|
-
'Auth lookup order:',
|
|
73
|
-
'',
|
|
74
|
-
'1. `PAGR_API_KEY`',
|
|
75
|
-
'2. `~/.pagr/config.json`',
|
|
76
|
-
'3. Error if neither exists',
|
|
77
|
-
'',
|
|
78
|
-
'## Upload New HTML',
|
|
79
|
-
'',
|
|
80
|
-
'```bash',
|
|
81
|
-
'pagr upload report.html',
|
|
82
|
-
'```',
|
|
83
|
-
'',
|
|
84
|
-
'Behavior:',
|
|
85
|
-
'',
|
|
86
|
-
'- Reads the local HTML file as UTF-8.',
|
|
87
|
-
'- Uploads raw HTML to Pagr.',
|
|
88
|
-
'- Prints the public URL.',
|
|
89
|
-
'- Copies the URL to the clipboard when supported.',
|
|
90
|
-
'- When `CI` is set, also prints:',
|
|
91
|
-
'',
|
|
92
|
-
'```text',
|
|
93
|
-
'PAGR_SLUG=...',
|
|
94
|
-
'PAGR_URL=...',
|
|
95
|
-
'```',
|
|
96
|
-
'',
|
|
97
|
-
'## Upload With Title And Slug',
|
|
98
|
-
'',
|
|
99
|
-
'Set a page title:',
|
|
100
|
-
'',
|
|
101
|
-
'```bash',
|
|
102
|
-
'pagr upload report.html --title "Weekly report"',
|
|
103
|
-
'pagr upload report.html -t "Weekly report"',
|
|
104
|
-
'```',
|
|
105
|
-
'',
|
|
106
|
-
'Request a stable readable slug:',
|
|
107
|
-
'',
|
|
108
|
-
'```bash',
|
|
109
|
-
'pagr upload report.html --slug weekly-report',
|
|
110
|
-
'pagr upload report.html -s weekly-report',
|
|
111
|
-
'```',
|
|
112
|
-
'',
|
|
113
|
-
'Use both:',
|
|
114
|
-
'',
|
|
115
|
-
'```bash',
|
|
116
|
-
'pagr upload report.html --slug weekly-report --title "Weekly report"',
|
|
117
|
-
'```',
|
|
118
|
-
'',
|
|
119
|
-
'`--title` sends `X-Pagr-Title`. `--slug` requests a stable readable URL. Custom slugs can be plan-gated.',
|
|
120
|
-
'',
|
|
121
|
-
'## Update Existing Pages',
|
|
122
|
-
'',
|
|
123
|
-
'```bash',
|
|
124
|
-
'pagr upload report.html --update --slug weekly-report',
|
|
125
|
-
'pagr upload report.html -u -s weekly-report',
|
|
126
|
-
'```',
|
|
127
|
-
'',
|
|
128
|
-
'Behavior:',
|
|
129
|
-
'',
|
|
130
|
-
'- Checks slug ownership first.',
|
|
131
|
-
'- Fails if the slug is missing or not owned by the authenticated user.',
|
|
132
|
-
'- Sends replacement HTML to the existing page.',
|
|
133
|
-
'- Keeps the public URL stable.',
|
|
134
|
-
'- Replaces current content in place; this is not versioning.',
|
|
135
|
-
'',
|
|
136
|
-
'## Auto-Update With Meta Tags',
|
|
137
|
-
'',
|
|
138
|
-
'```html',
|
|
139
|
-
'<meta name="pagr-id" content="...">',
|
|
140
|
-
'<meta name="pagr-slug" content="weekly-report">',
|
|
141
|
-
'```',
|
|
142
|
-
'',
|
|
143
|
-
'Update priority:',
|
|
144
|
-
'',
|
|
145
|
-
'1. `pagr-id` updates by stable document ID.',
|
|
146
|
-
'2. `pagr-slug` updates by slug.',
|
|
147
|
-
'3. `--update --slug` forces update by slug.',
|
|
148
|
-
'4. Otherwise a new file is uploaded.',
|
|
149
|
-
'',
|
|
150
|
-
'Inject Pagr metadata into the source file:',
|
|
151
|
-
'',
|
|
152
|
-
'```bash',
|
|
153
|
-
'pagr upload report.html --inject',
|
|
154
|
-
'```',
|
|
155
|
-
'',
|
|
156
|
-
'`--inject` writes Pagr metadata into the local HTML source after upload. If a new upload has no `pagr-slug`, the CLI auto-injects metadata for future updates. This modifies the local source HTML file.',
|
|
157
|
-
'',
|
|
158
|
-
'## List Files',
|
|
159
|
-
'',
|
|
160
|
-
'```bash',
|
|
161
|
-
'pagr ls',
|
|
162
|
-
'pagr ls --limit 20',
|
|
163
|
-
'```',
|
|
164
|
-
'',
|
|
165
|
-
'Default limit is 50. Output includes slug, views, plan, title, and URL. If no files exist, the CLI prints `No files found.`',
|
|
166
|
-
'',
|
|
167
|
-
'## Delete Files',
|
|
168
|
-
'',
|
|
169
|
-
'```bash',
|
|
170
|
-
'pagr rm weekly-report',
|
|
171
|
-
'pagr rm weekly-report --yes',
|
|
172
|
-
'pagr rm weekly-report -y',
|
|
173
|
-
'```',
|
|
174
|
-
'',
|
|
175
|
-
'Without `--yes`, the CLI asks for confirmation and accepts `y` or `yes`. Delete is not reversible.',
|
|
176
|
-
'',
|
|
177
|
-
'## Config Commands',
|
|
178
|
-
'',
|
|
179
|
-
'```bash',
|
|
180
|
-
'pagr config show',
|
|
181
|
-
'pagr config set-key pagr_...',
|
|
182
|
-
'pagr config set-url https://pagr.link',
|
|
183
|
-
'```',
|
|
184
|
-
'',
|
|
185
|
-
'`pagr config show` masks the API key. `set-key` requires a `pagr_` prefix. `set-url` overrides the Worker API URL in local config. Environment variables override local config.',
|
|
186
|
-
'',
|
|
187
|
-
'## Init Command',
|
|
188
|
-
'',
|
|
189
|
-
'```bash',
|
|
190
|
-
'pagr init',
|
|
191
|
-
'pagr init --no-claude',
|
|
192
|
-
'pagr init --no-mcp',
|
|
193
|
-
'```',
|
|
194
|
-
'',
|
|
195
|
-
'`pagr init` writes:',
|
|
196
|
-
'',
|
|
197
|
-
'- `SKILL.md`',
|
|
198
|
-
'- `.claude/skills/pagr/SKILL.md` unless `--no-claude`',
|
|
199
|
-
'- `.agents/skills/pagr/SKILL.md`',
|
|
200
|
-
'- `.claude/settings.json` MCP server config unless `--no-mcp`',
|
|
201
|
-
'',
|
|
202
|
-
'MCP config:',
|
|
203
|
-
'',
|
|
204
|
-
'```json',
|
|
205
|
-
'{',
|
|
206
|
-
' "mcpServers": {',
|
|
207
|
-
' "pagr": {',
|
|
208
|
-
' "command": "npx",',
|
|
209
|
-
' "args": ["-y", "@pagr/mcp"]',
|
|
210
|
-
' }',
|
|
211
|
-
' }',
|
|
212
|
-
'}',
|
|
213
|
-
'```',
|
|
214
|
-
'',
|
|
215
|
-
'## CI Usage',
|
|
216
|
-
'',
|
|
217
|
-
'Use `PAGR_API_KEY` in CI. Do not write `~/.pagr/config.json` in CI.',
|
|
218
|
-
'',
|
|
219
|
-
'```yaml',
|
|
220
|
-
'- name: Publish HTML report',
|
|
221
|
-
' run: pagr upload output/report.html --title "Nightly report"',
|
|
222
|
-
' env:',
|
|
223
|
-
' PAGR_API_KEY: ${{ secrets.PAGR_API_KEY }}',
|
|
224
|
-
'```',
|
|
225
|
-
'',
|
|
226
|
-
'When `CI` is set, use the machine-readable `PAGR_SLUG` and `PAGR_URL` output lines.',
|
|
227
|
-
'',
|
|
228
|
-
'## Environment Variables',
|
|
229
|
-
'',
|
|
230
|
-
'- `PAGR_API_KEY`: overrides the locally saved key.',
|
|
231
|
-
'- `PAGR_WORKER_URL`: overrides the Worker API URL. Default is `https://pagr.link`.',
|
|
232
|
-
'- `PAGR_APP_URL`: overrides the app URL used by `pagr login`. Default is `https://app.getpagr.co`.',
|
|
233
|
-
'- `CI`: makes upload print machine-readable `PAGR_SLUG` and `PAGR_URL`.',
|
|
234
|
-
'',
|
|
235
|
-
'## Error Handling',
|
|
236
|
-
'',
|
|
237
|
-
'Common failures:',
|
|
238
|
-
'',
|
|
239
|
-
'- Missing API key: run `pagr login`, run `pagr login --manual`, or set `PAGR_API_KEY`.',
|
|
240
|
-
'- Invalid API key format: keys must start with `pagr_`.',
|
|
241
|
-
'- Cannot read file: confirm the path exists and points to an HTML file.',
|
|
242
|
-
'- Slug not found or not owned during update: upload without `--update` or use the correct slug.',
|
|
243
|
-
'- Upload/update/list/delete API errors: surface the exact CLI error.',
|
|
244
|
-
'- Clipboard failure does not fail upload; the URL is still printed.',
|
|
245
|
-
'',
|
|
246
|
-
'If browser login fails, use `pagr login --manual`. If upload fails due to plan or file limit, surface the CLI error and tell the user to check account plan and file size.',
|
|
247
|
-
'',
|
|
248
|
-
'## Agent Workflow',
|
|
249
|
-
'',
|
|
250
|
-
'1. Confirm the target file exists and is HTML.',
|
|
251
|
-
'2. If the user wants a stable URL, use `--slug`.',
|
|
252
|
-
'3. If the file already has `pagr-id` or `pagr-slug`, use plain `pagr upload <file>` unless the user asks for a new page.',
|
|
253
|
-
'4. If the user explicitly wants to replace an existing page, use:',
|
|
254
|
-
'',
|
|
255
|
-
'```bash',
|
|
256
|
-
'pagr upload <file> --update --slug <slug>',
|
|
257
|
-
'```',
|
|
258
|
-
'',
|
|
259
|
-
'5. Return the URL printed by the CLI.',
|
|
260
|
-
'6. In CI, capture `PAGR_URL`.',
|
|
261
|
-
].join('\n') + '\n';
|
|
262
|
-
const CLAUDE_SKILL_MD = SKILL_MD;
|
|
4
|
+
import { readConfig } from '../lib/config.js';
|
|
5
|
+
import { writeSkillFiles } from '../lib/skills.js';
|
|
263
6
|
export const initCommand = defineCommand({
|
|
264
7
|
meta: {
|
|
265
8
|
name: 'init',
|
|
@@ -281,22 +24,10 @@ export const initCommand = defineCommand({
|
|
|
281
24
|
},
|
|
282
25
|
run({ args }) {
|
|
283
26
|
const cwd = process.cwd();
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
if (!existsSync(claudeSkillsDir)) {
|
|
289
|
-
mkdirSync(claudeSkillsDir, { recursive: true });
|
|
290
|
-
}
|
|
291
|
-
writeFileSync(join(claudeSkillsDir, 'SKILL.md'), CLAUDE_SKILL_MD, 'utf-8');
|
|
292
|
-
console.log('Created .claude/skills/pagr/SKILL.md');
|
|
293
|
-
}
|
|
294
|
-
const agentsSkillsDir = join(cwd, '.agents', 'skills', 'pagr');
|
|
295
|
-
if (!existsSync(agentsSkillsDir)) {
|
|
296
|
-
mkdirSync(agentsSkillsDir, { recursive: true });
|
|
297
|
-
}
|
|
298
|
-
writeFileSync(join(agentsSkillsDir, 'SKILL.md'), SKILL_MD, 'utf-8');
|
|
299
|
-
console.log('Created .agents/skills/pagr/SKILL.md');
|
|
27
|
+
const cfg = readConfig();
|
|
28
|
+
const apiKey = cfg.apiKey;
|
|
29
|
+
writeSkillFiles(cwd, apiKey, args.claude);
|
|
30
|
+
console.log('Created workspace skill files.');
|
|
300
31
|
if (args.mcp) {
|
|
301
32
|
writeClaudeMcpSettings(cwd);
|
|
302
33
|
console.log('Updated .claude/settings.json with the Pagr MCP server');
|
|
@@ -318,7 +49,7 @@ function writeClaudeMcpSettings(cwd) {
|
|
|
318
49
|
...(settings.mcpServers ?? {}),
|
|
319
50
|
pagr: {
|
|
320
51
|
command: 'npx',
|
|
321
|
-
args: ['-y', '@
|
|
52
|
+
args: ['-y', '@getpagr/mcp'],
|
|
322
53
|
},
|
|
323
54
|
};
|
|
324
55
|
writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`, 'utf-8');
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;
|
|
1
|
+
{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/commands/upload.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/commands/upload.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoKxB,CAAA"}
|
package/dist/commands/upload.js
CHANGED
|
@@ -6,6 +6,7 @@ import { defineCommand } from 'citty';
|
|
|
6
6
|
import { uploadFile, updateFile, updateFileById, checkSlugOwnership } from '../lib/api.js';
|
|
7
7
|
import { tryGetApiKey, getWorkerUrl } from '../lib/config.js';
|
|
8
8
|
import { extractPagrSlug, extractPagrId, injectPagrSlug, injectPagrId } from '../lib/meta.js';
|
|
9
|
+
const DEFAULT_APP_URL = 'https://app.getpagr.co';
|
|
9
10
|
export const uploadCommand = defineCommand({
|
|
10
11
|
meta: {
|
|
11
12
|
name: 'upload',
|
|
@@ -126,7 +127,12 @@ export const uploadCommand = defineCommand({
|
|
|
126
127
|
});
|
|
127
128
|
if (!apiKey) {
|
|
128
129
|
console.log(`Published (anonymous, expires in 24h): ${result.url}`);
|
|
129
|
-
|
|
130
|
+
if (result.claimToken) {
|
|
131
|
+
console.log(`Save permanently: ${buildClaimUrl(result.slug, result.claimToken)}`);
|
|
132
|
+
}
|
|
133
|
+
else {
|
|
134
|
+
console.log(`Run \`pagr login\` to keep pages permanently.`);
|
|
135
|
+
}
|
|
130
136
|
}
|
|
131
137
|
else {
|
|
132
138
|
console.log(`Published: ${result.url}`);
|
|
@@ -176,6 +182,13 @@ function openUrl(url) {
|
|
|
176
182
|
spawn('xdg-open', [url], { stdio: 'ignore', detached: true }).unref();
|
|
177
183
|
}
|
|
178
184
|
}
|
|
185
|
+
function buildClaimUrl(slug, claimToken) {
|
|
186
|
+
const appUrl = new URL(process.env.PAGR_APP_URL ?? DEFAULT_APP_URL);
|
|
187
|
+
const returnTo = `/share?claim=${encodeURIComponent(slug)}&claimToken=${encodeURIComponent(claimToken)}`;
|
|
188
|
+
appUrl.pathname = '/login';
|
|
189
|
+
appUrl.search = new URLSearchParams({ returnTo }).toString();
|
|
190
|
+
return appUrl.toString();
|
|
191
|
+
}
|
|
179
192
|
async function copyToClipboard(value) {
|
|
180
193
|
const os = platform();
|
|
181
194
|
if (os === 'darwin' || os === 'win32') {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/commands/upload.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/commands/upload.ts"],"names":[],"mappings":"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"}
|
package/dist/lib/api.d.ts
CHANGED
package/dist/lib/api.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;
|
|
1
|
+
{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"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"}
|
package/dist/lib/api.js
CHANGED
|
@@ -1,5 +1,20 @@
|
|
|
1
|
+
// Rotate this token on each published @pagr/cli release:
|
|
2
|
+
// node packages/cli/generate-waf-token.mjs
|
|
3
|
+
// Then update the Cloudflare WAF Custom Rule expression for pagr.link to match.
|
|
4
|
+
// A stale token causes Cloudflare to return a non-JSON 403, which
|
|
5
|
+
// pagrFetch() converts into an actionable "please update" error.
|
|
6
|
+
const WAF_BYPASS_TOKEN = 'moden-eng';
|
|
7
|
+
async function pagrFetch(url, init) {
|
|
8
|
+
const headers = new Headers(init?.headers);
|
|
9
|
+
headers.set('X-Pagr-Token', WAF_BYPASS_TOKEN);
|
|
10
|
+
const res = await fetch(url, { ...init, headers });
|
|
11
|
+
if (res.status === 403 && !res.headers.get('content-type')?.includes('application/json')) {
|
|
12
|
+
throw new Error('Your @pagr/cli package is outdated and blocked by the server. Please update: npm install -g @pagr/cli');
|
|
13
|
+
}
|
|
14
|
+
return res;
|
|
15
|
+
}
|
|
1
16
|
export async function getUser(apiKey, workerUrl) {
|
|
2
|
-
const res = await
|
|
17
|
+
const res = await pagrFetch(`${workerUrl}/api/user`, {
|
|
3
18
|
headers: { 'Authorization': `Bearer ${apiKey}` },
|
|
4
19
|
});
|
|
5
20
|
if (!res.ok) {
|
|
@@ -20,7 +35,7 @@ export async function uploadFile(opts) {
|
|
|
20
35
|
headers['X-Pagr-TTL'] = opts.ttl;
|
|
21
36
|
if (opts.hideBanner)
|
|
22
37
|
headers['X-Pagr-Hide-Banner'] = 'true';
|
|
23
|
-
const res = await
|
|
38
|
+
const res = await pagrFetch(`${opts.workerUrl}/api/upload`, {
|
|
24
39
|
method: 'POST',
|
|
25
40
|
headers,
|
|
26
41
|
body: opts.html,
|
|
@@ -52,7 +67,7 @@ export async function updateFile(opts) {
|
|
|
52
67
|
headers['X-Pagr-Title'] = opts.title;
|
|
53
68
|
if (opts.hideBanner !== undefined)
|
|
54
69
|
headers['X-Pagr-Hide-Banner'] = String(opts.hideBanner);
|
|
55
|
-
const res = await
|
|
70
|
+
const res = await pagrFetch(`${opts.workerUrl}/api/upload/${opts.slug}`, {
|
|
56
71
|
method: 'PUT',
|
|
57
72
|
headers,
|
|
58
73
|
body: opts.html,
|
|
@@ -79,7 +94,7 @@ export async function updateFileById(opts) {
|
|
|
79
94
|
headers['X-Pagr-Title'] = opts.title;
|
|
80
95
|
if (opts.hideBanner !== undefined)
|
|
81
96
|
headers['X-Pagr-Hide-Banner'] = String(opts.hideBanner);
|
|
82
|
-
const res = await
|
|
97
|
+
const res = await pagrFetch(`${opts.workerUrl}/api/upload/id/${opts.documentId}`, {
|
|
83
98
|
method: 'PUT',
|
|
84
99
|
headers,
|
|
85
100
|
body: opts.html,
|
|
@@ -98,7 +113,7 @@ export async function updateFileById(opts) {
|
|
|
98
113
|
return result;
|
|
99
114
|
}
|
|
100
115
|
export async function checkSlugOwnership(slug, apiKey, workerUrl) {
|
|
101
|
-
const res = await
|
|
116
|
+
const res = await pagrFetch(`${workerUrl}/api/files/${encodeURIComponent(slug)}`, {
|
|
102
117
|
headers: { 'Authorization': `Bearer ${apiKey}` },
|
|
103
118
|
});
|
|
104
119
|
if (res.status === 404)
|
|
@@ -106,7 +121,7 @@ export async function checkSlugOwnership(slug, apiKey, workerUrl) {
|
|
|
106
121
|
return res.ok;
|
|
107
122
|
}
|
|
108
123
|
export async function listFiles(apiKey, workerUrl, limit = 100) {
|
|
109
|
-
const res = await
|
|
124
|
+
const res = await pagrFetch(`${workerUrl}/api/files?limit=${limit}`, {
|
|
110
125
|
headers: { 'Authorization': `Bearer ${apiKey}` },
|
|
111
126
|
});
|
|
112
127
|
if (!res.ok) {
|
|
@@ -117,7 +132,7 @@ export async function listFiles(apiKey, workerUrl, limit = 100) {
|
|
|
117
132
|
return data.files;
|
|
118
133
|
}
|
|
119
134
|
export async function deleteFile(slug, apiKey, workerUrl) {
|
|
120
|
-
const res = await
|
|
135
|
+
const res = await pagrFetch(`${workerUrl}/api/files/${slug}`, {
|
|
121
136
|
method: 'DELETE',
|
|
122
137
|
headers: { 'Authorization': `Bearer ${apiKey}` },
|
|
123
138
|
});
|
|
@@ -130,7 +145,7 @@ export async function renameFile(slug, nextSlug, apiKey, workerUrl, title) {
|
|
|
130
145
|
return patchFileMeta({ slug, nextSlug, title, apiKey, workerUrl });
|
|
131
146
|
}
|
|
132
147
|
async function patchFileMeta(opts) {
|
|
133
|
-
const res = await
|
|
148
|
+
const res = await pagrFetch(`${opts.workerUrl}/api/files/${opts.slug}`, {
|
|
134
149
|
method: 'PATCH',
|
|
135
150
|
headers: {
|
|
136
151
|
'Content-Type': 'application/json',
|
package/dist/lib/api.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,SAAiB;IAC7D,MAAM,GAAG,GAAG,MAAM,
|
|
1
|
+
{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,GAAI,SAAQ,MAAoB,KAAG,MAoR/D,CAAA;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,GAAE,OAAc,GAAG,IAAI,CAqB/F"}
|
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
export const getSkillTemplate = (apiKey = '{api_key}') => {
|
|
4
|
+
return [
|
|
5
|
+
'---',
|
|
6
|
+
'name: pagr',
|
|
7
|
+
'description: Publish, update, list, delete, or manage HTML files with the Pagr CLI or remote MCP server. Use when publishing HTML reports, dashboards, documents, or planning artifacts, or configuring Pagr in a project.',
|
|
8
|
+
'---',
|
|
9
|
+
'',
|
|
10
|
+
'# Pagr CLI Skill',
|
|
11
|
+
'',
|
|
12
|
+
'Use this skill when the user wants to publish, update, list, delete, or manage HTML files with the Pagr CLI or through the remote MCP server.',
|
|
13
|
+
'',
|
|
14
|
+
'## When To Use This Skill',
|
|
15
|
+
'',
|
|
16
|
+
'- Publishing generated HTML reports, dashboards, documents, or plans.',
|
|
17
|
+
'- Updating existing published Pagr pages while keeping the same public URL.',
|
|
18
|
+
'- Creating shareable URLs for local HTML artifacts.',
|
|
19
|
+
'- Listing or deleting Pagr files from a user account.',
|
|
20
|
+
'- Setting up Pagr in a project for agent workflows.',
|
|
21
|
+
'- Publishing HTML artifacts from CI.',
|
|
22
|
+
'- Using the remote MCP server to publish HTML reports.',
|
|
23
|
+
'',
|
|
24
|
+
'## Core Rules',
|
|
25
|
+
'',
|
|
26
|
+
'- Use `pagr upload <file>` for HTML files.',
|
|
27
|
+
'- Never invent a Pagr URL. Always return the URL printed by the CLI.',
|
|
28
|
+
'- If a file contains `<meta name="pagr-id">` or `<meta name="pagr-slug">`, `pagr upload <file>` may update the existing page instead of creating a new one.',
|
|
29
|
+
'- Updates replace the current HTML in place. Pagr does not store previous HTML versions or rollback history.',
|
|
30
|
+
'- Prefer `PAGR_API_KEY` in CI instead of writing `~/.pagr/config.json`.',
|
|
31
|
+
'- Do not print or expose full API keys unless the user explicitly asks to configure authentication.',
|
|
32
|
+
'- If upload, update, list, or delete fails, surface the exact CLI/API error.',
|
|
33
|
+
'',
|
|
34
|
+
'## Remote MCP Server (SSE)',
|
|
35
|
+
'',
|
|
36
|
+
'You can connect to Pagr\'s remote Model Context Protocol (MCP) server over SSE (Server-Sent Events) to allow any MCP-compatible agent to publish files directly.',
|
|
37
|
+
'',
|
|
38
|
+
'The remote MCP server endpoint is:',
|
|
39
|
+
'```text',
|
|
40
|
+
`https://mcp.getpagr.co/mcp?PAGR_API_KEY=${apiKey}`,
|
|
41
|
+
'```',
|
|
42
|
+
'',
|
|
43
|
+
'When using an MCP-compatible client (like Claude.ai Web App Custom Connectors, Cursor IDE, or others), configure the Server URL pointing to the endpoint above. This allows the client to call tools like `upload_file` and publish pages seamlessly.',
|
|
44
|
+
'',
|
|
45
|
+
'## Installation',
|
|
46
|
+
'',
|
|
47
|
+
'```bash',
|
|
48
|
+
'npm install -g @getpagr/cli',
|
|
49
|
+
'```',
|
|
50
|
+
'',
|
|
51
|
+
'Pagr CLI requires Node.js 20 or newer. The installed command is `pagr`.',
|
|
52
|
+
'',
|
|
53
|
+
'## Authentication',
|
|
54
|
+
'',
|
|
55
|
+
'Browser login:',
|
|
56
|
+
'',
|
|
57
|
+
'```bash',
|
|
58
|
+
'pagr login',
|
|
59
|
+
'```',
|
|
60
|
+
'',
|
|
61
|
+
'`pagr login` starts a browser login flow, authenticates with Pagr, receives a CLI API key through a local callback, and saves it to `~/.pagr/config.json`.',
|
|
62
|
+
'',
|
|
63
|
+
'Manual login for SSH, headless, or locked-down environments:',
|
|
64
|
+
'',
|
|
65
|
+
'```bash',
|
|
66
|
+
'pagr login --manual',
|
|
67
|
+
'```',
|
|
68
|
+
'',
|
|
69
|
+
'Save a key without prompting:',
|
|
70
|
+
'',
|
|
71
|
+
'```bash',
|
|
72
|
+
'pagr login --key pagr_...',
|
|
73
|
+
'```',
|
|
74
|
+
'',
|
|
75
|
+
'Set a key directly in local config:',
|
|
76
|
+
'',
|
|
77
|
+
'```bash',
|
|
78
|
+
'pagr config set-key pagr_...',
|
|
79
|
+
'```',
|
|
80
|
+
'',
|
|
81
|
+
'API keys must start with `pagr_`.',
|
|
82
|
+
'',
|
|
83
|
+
'Config location:',
|
|
84
|
+
'',
|
|
85
|
+
'```text',
|
|
86
|
+
'~/.pagr/config.json',
|
|
87
|
+
'```',
|
|
88
|
+
'',
|
|
89
|
+
'Auth lookup order:',
|
|
90
|
+
'',
|
|
91
|
+
'1. `PAGR_API_KEY`',
|
|
92
|
+
'2. `~/.pagr/config.json`',
|
|
93
|
+
'3. Error if neither exists',
|
|
94
|
+
'',
|
|
95
|
+
'## Upload New HTML',
|
|
96
|
+
'',
|
|
97
|
+
'```bash',
|
|
98
|
+
'pagr upload report.html',
|
|
99
|
+
'```',
|
|
100
|
+
'',
|
|
101
|
+
'Behavior:',
|
|
102
|
+
'',
|
|
103
|
+
'- Reads the local HTML file as UTF-8.',
|
|
104
|
+
'- Uploads raw HTML to Pagr.',
|
|
105
|
+
'- Prints the public URL.',
|
|
106
|
+
'- Copies the URL to the clipboard when supported.',
|
|
107
|
+
'- When `CI` is set, also prints:',
|
|
108
|
+
'',
|
|
109
|
+
'```text',
|
|
110
|
+
'PAGR_SLUG=...',
|
|
111
|
+
'PAGR_URL=...',
|
|
112
|
+
'```',
|
|
113
|
+
'',
|
|
114
|
+
'## Upload With Title And Slug',
|
|
115
|
+
'',
|
|
116
|
+
'Set a page title:',
|
|
117
|
+
'',
|
|
118
|
+
'```bash',
|
|
119
|
+
'pagr upload report.html --title "Weekly report"',
|
|
120
|
+
'pagr upload report.html -t "Weekly report"',
|
|
121
|
+
'```',
|
|
122
|
+
'',
|
|
123
|
+
'Request a stable readable slug:',
|
|
124
|
+
'',
|
|
125
|
+
'```bash',
|
|
126
|
+
'pagr upload report.html --slug weekly-report',
|
|
127
|
+
'pagr upload report.html -s weekly-report',
|
|
128
|
+
'```',
|
|
129
|
+
'',
|
|
130
|
+
'Use both:',
|
|
131
|
+
'',
|
|
132
|
+
'```bash',
|
|
133
|
+
'pagr upload report.html --slug weekly-report --title "Weekly report"',
|
|
134
|
+
'```',
|
|
135
|
+
'',
|
|
136
|
+
'`--title` sends `X-Pagr-Title`. `--slug` requests a stable readable URL. Custom slugs can be plan-gated.',
|
|
137
|
+
'',
|
|
138
|
+
'## Update Existing Pages',
|
|
139
|
+
'',
|
|
140
|
+
'```bash',
|
|
141
|
+
'pagr upload report.html --update --slug weekly-report',
|
|
142
|
+
'pagr upload report.html -u -s weekly-report',
|
|
143
|
+
'```',
|
|
144
|
+
'',
|
|
145
|
+
'Behavior:',
|
|
146
|
+
'',
|
|
147
|
+
'- Checks slug ownership first.',
|
|
148
|
+
'- Fails if the slug is missing or not owned by the authenticated user.',
|
|
149
|
+
'- Sends replacement HTML to the existing page.',
|
|
150
|
+
'- Keeps the public URL stable.',
|
|
151
|
+
'- Replaces current content in place; this is not versioning.',
|
|
152
|
+
'',
|
|
153
|
+
'## Auto-Update With Meta Tags',
|
|
154
|
+
'',
|
|
155
|
+
'```html',
|
|
156
|
+
'<meta name="pagr-id" content="...">',
|
|
157
|
+
'<meta name="pagr-slug" content="weekly-report">',
|
|
158
|
+
'```',
|
|
159
|
+
'',
|
|
160
|
+
'Update priority:',
|
|
161
|
+
'',
|
|
162
|
+
'1. `pagr-id` updates by stable document ID.',
|
|
163
|
+
'2. `pagr-slug` updates by slug.',
|
|
164
|
+
'3. `--update --slug` forces update by slug.',
|
|
165
|
+
'4. Otherwise a new file is uploaded.',
|
|
166
|
+
'',
|
|
167
|
+
'Inject Pagr metadata into the source file:',
|
|
168
|
+
'',
|
|
169
|
+
'```bash',
|
|
170
|
+
'pagr upload report.html --inject',
|
|
171
|
+
'```',
|
|
172
|
+
'',
|
|
173
|
+
'`--inject` writes Pagr metadata into the local HTML source after upload. If a new upload has no `pagr-slug`, the CLI auto-injects metadata for future updates. This modifies the local source HTML file.',
|
|
174
|
+
'',
|
|
175
|
+
'## List Files',
|
|
176
|
+
'',
|
|
177
|
+
'```bash',
|
|
178
|
+
'pagr ls',
|
|
179
|
+
'pagr ls --limit 20',
|
|
180
|
+
'```',
|
|
181
|
+
'',
|
|
182
|
+
'Default limit is 50. Output includes slug, views, plan, title, and URL. If no files exist, the CLI prints `No files found.`',
|
|
183
|
+
'',
|
|
184
|
+
'## Delete Files',
|
|
185
|
+
'',
|
|
186
|
+
'```bash',
|
|
187
|
+
'pagr rm weekly-report',
|
|
188
|
+
'pagr rm weekly-report --yes',
|
|
189
|
+
'pagr rm weekly-report -y',
|
|
190
|
+
'```',
|
|
191
|
+
'',
|
|
192
|
+
'Without `--yes`, the CLI asks for confirmation and accepts `y` or `yes`. Delete is not reversible.',
|
|
193
|
+
'',
|
|
194
|
+
'## Config Commands',
|
|
195
|
+
'',
|
|
196
|
+
'```bash',
|
|
197
|
+
'pagr config show',
|
|
198
|
+
'pagr config set-key pagr_...',
|
|
199
|
+
'pagr config set-url https://pagr.link',
|
|
200
|
+
'```',
|
|
201
|
+
'',
|
|
202
|
+
'`pagr config show` masks the API key. `set-key` requires a `pagr_` prefix. `set-url` overrides the Worker API URL in local config. Environment variables override local config.',
|
|
203
|
+
'',
|
|
204
|
+
'## Init Command',
|
|
205
|
+
'',
|
|
206
|
+
'```bash',
|
|
207
|
+
'pagr init',
|
|
208
|
+
'pagr init --no-claude',
|
|
209
|
+
'pagr init --no-mcp',
|
|
210
|
+
'```',
|
|
211
|
+
'',
|
|
212
|
+
'`pagr init` writes:',
|
|
213
|
+
'',
|
|
214
|
+
'- `SKILL.md`',
|
|
215
|
+
'- `.claude/skills/pagr/SKILL.md` unless `--no-claude`',
|
|
216
|
+
'- `.agents/skills/pagr/SKILL.md`',
|
|
217
|
+
'- `.claude/settings.json` MCP server config unless `--no-mcp`',
|
|
218
|
+
'',
|
|
219
|
+
'MCP config:',
|
|
220
|
+
'',
|
|
221
|
+
'```json',
|
|
222
|
+
'{',
|
|
223
|
+
' "mcpServers": {',
|
|
224
|
+
' "pagr": {',
|
|
225
|
+
' "command": "npx",',
|
|
226
|
+
' "args": ["-y", "@getpagr/mcp"]',
|
|
227
|
+
' }',
|
|
228
|
+
' }',
|
|
229
|
+
'}',
|
|
230
|
+
'```',
|
|
231
|
+
'',
|
|
232
|
+
'## CI Usage',
|
|
233
|
+
'',
|
|
234
|
+
'Use `PAGR_API_KEY` in CI. Do not write `~/.pagr/config.json` in CI.',
|
|
235
|
+
'',
|
|
236
|
+
'```yaml',
|
|
237
|
+
'- name: Publish HTML report',
|
|
238
|
+
' run: pagr upload output/report.html --title "Nightly report"',
|
|
239
|
+
' env:',
|
|
240
|
+
' PAGR_API_KEY: ${{ secrets.PAGR_API_KEY }}',
|
|
241
|
+
'```',
|
|
242
|
+
'',
|
|
243
|
+
'When `CI` is set, use the machine-readable `PAGR_SLUG` and `PAGR_URL` output lines.',
|
|
244
|
+
'',
|
|
245
|
+
'## Environment Variables',
|
|
246
|
+
'',
|
|
247
|
+
'- `PAGR_API_KEY`: overrides the locally saved key.',
|
|
248
|
+
'- `PAGR_WORKER_URL`: overrides the Worker API URL. Default is `https://pagr.link`.',
|
|
249
|
+
'- `PAGR_APP_URL`: overrides the app URL used by `pagr login`. Default is `https://app.getpagr.co`.',
|
|
250
|
+
'- `CI`: makes upload print machine-readable `PAGR_SLUG` and `PAGR_URL`.',
|
|
251
|
+
'',
|
|
252
|
+
'## Error Handling',
|
|
253
|
+
'',
|
|
254
|
+
'Common failures:',
|
|
255
|
+
'',
|
|
256
|
+
'- Missing API key: run `pagr login`, run `pagr login --manual`, or set `PAGR_API_KEY`.',
|
|
257
|
+
'- Invalid API key format: keys must start with `pagr_`.',
|
|
258
|
+
'- Cannot read file: confirm the path exists and points to an HTML file.',
|
|
259
|
+
'- Slug not found or not owned during update: upload without `--update` or use the correct slug.',
|
|
260
|
+
'- Upload/update/list/delete API errors: surface the exact CLI error.',
|
|
261
|
+
'- Clipboard failure does not fail upload; the URL is still printed.',
|
|
262
|
+
'',
|
|
263
|
+
'If browser login fails, use `pagr login --manual`. If upload fails due to plan or file limit, surface the CLI error and tell the user to check account plan and file size.',
|
|
264
|
+
'',
|
|
265
|
+
'## Agent Workflow',
|
|
266
|
+
'',
|
|
267
|
+
'1. Confirm the target file exists and is HTML.',
|
|
268
|
+
'2. If the user wants a stable URL, use `--slug`.',
|
|
269
|
+
'3. If the file already has `pagr-id` or `pagr-slug`, use plain `pagr upload <file>` unless the user asks for a new page.',
|
|
270
|
+
'4. If the user explicitly wants to replace an existing page, use:',
|
|
271
|
+
'',
|
|
272
|
+
'```bash',
|
|
273
|
+
'pagr upload <file> --update --slug <slug>',
|
|
274
|
+
'```',
|
|
275
|
+
'',
|
|
276
|
+
'5. Return the URL printed by the CLI.',
|
|
277
|
+
'6. In CI, capture `PAGR_URL`.',
|
|
278
|
+
].join('\n') + '\n';
|
|
279
|
+
};
|
|
280
|
+
export function writeSkillFiles(cwd, apiKey, writeClaude = true) {
|
|
281
|
+
const content = getSkillTemplate(apiKey);
|
|
282
|
+
// 1. Write root SKILL.md
|
|
283
|
+
writeFileSync(join(cwd, 'SKILL.md'), content, 'utf-8');
|
|
284
|
+
// 2. Write .claude/skills/pagr/SKILL.md
|
|
285
|
+
if (writeClaude) {
|
|
286
|
+
const claudeSkillsDir = join(cwd, '.claude', 'skills', 'pagr');
|
|
287
|
+
if (!existsSync(claudeSkillsDir)) {
|
|
288
|
+
mkdirSync(claudeSkillsDir, { recursive: true });
|
|
289
|
+
}
|
|
290
|
+
writeFileSync(join(claudeSkillsDir, 'SKILL.md'), content, 'utf-8');
|
|
291
|
+
}
|
|
292
|
+
// 3. Write .agents/skills/pagr/SKILL.md
|
|
293
|
+
const agentsSkillsDir = join(cwd, '.agents', 'skills', 'pagr');
|
|
294
|
+
if (!existsSync(agentsSkillsDir)) {
|
|
295
|
+
mkdirSync(agentsSkillsDir, { recursive: true });
|
|
296
|
+
}
|
|
297
|
+
writeFileSync(join(agentsSkillsDir, 'SKILL.md'), content, 'utf-8');
|
|
298
|
+
}
|
|
299
|
+
//# sourceMappingURL=skills.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAiB,WAAW,EAAU,EAAE;IACvE,OAAO;QACL,KAAK;QACL,YAAY;QACZ,4NAA4N;QAC5N,KAAK;QACL,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,+IAA+I;QAC/I,EAAE;QACF,2BAA2B;QAC3B,EAAE;QACF,uEAAuE;QACvE,6EAA6E;QAC7E,qDAAqD;QACrD,uDAAuD;QACvD,qDAAqD;QACrD,sCAAsC;QACtC,wDAAwD;QACxD,EAAE;QACF,eAAe;QACf,EAAE;QACF,4CAA4C;QAC5C,sEAAsE;QACtE,6JAA6J;QAC7J,8GAA8G;QAC9G,yEAAyE;QACzE,qGAAqG;QACrG,8EAA8E;QAC9E,EAAE;QACF,4BAA4B;QAC5B,EAAE;QACF,kKAAkK;QAClK,EAAE;QACF,oCAAoC;QACpC,SAAS;QACT,2CAA2C,MAAM,EAAE;QACnD,KAAK;QACL,EAAE;QACF,uPAAuP;QACvP,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,SAAS;QACT,6BAA6B;QAC7B,KAAK;QACL,EAAE;QACF,yEAAyE;QACzE,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,gBAAgB;QAChB,EAAE;QACF,SAAS;QACT,YAAY;QACZ,KAAK;QACL,EAAE;QACF,4JAA4J;QAC5J,EAAE;QACF,8DAA8D;QAC9D,EAAE;QACF,SAAS;QACT,qBAAqB;QACrB,KAAK;QACL,EAAE;QACF,+BAA+B;QAC/B,EAAE;QACF,SAAS;QACT,2BAA2B;QAC3B,KAAK;QACL,EAAE;QACF,qCAAqC;QACrC,EAAE;QACF,SAAS;QACT,8BAA8B;QAC9B,KAAK;QACL,EAAE;QACF,mCAAmC;QACnC,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,SAAS;QACT,qBAAqB;QACrB,KAAK;QACL,EAAE;QACF,oBAAoB;QACpB,EAAE;QACF,mBAAmB;QACnB,0BAA0B;QAC1B,4BAA4B;QAC5B,EAAE;QACF,oBAAoB;QACpB,EAAE;QACF,SAAS;QACT,yBAAyB;QACzB,KAAK;QACL,EAAE;QACF,WAAW;QACX,EAAE;QACF,uCAAuC;QACvC,6BAA6B;QAC7B,0BAA0B;QAC1B,mDAAmD;QACnD,kCAAkC;QAClC,EAAE;QACF,SAAS;QACT,eAAe;QACf,cAAc;QACd,KAAK;QACL,EAAE;QACF,+BAA+B;QAC/B,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,SAAS;QACT,iDAAiD;QACjD,4CAA4C;QAC5C,KAAK;QACL,EAAE;QACF,iCAAiC;QACjC,EAAE;QACF,SAAS;QACT,8CAA8C;QAC9C,0CAA0C;QAC1C,KAAK;QACL,EAAE;QACF,WAAW;QACX,EAAE;QACF,SAAS;QACT,sEAAsE;QACtE,KAAK;QACL,EAAE;QACF,0GAA0G;QAC1G,EAAE;QACF,0BAA0B;QAC1B,EAAE;QACF,SAAS;QACT,uDAAuD;QACvD,6CAA6C;QAC7C,KAAK;QACL,EAAE;QACF,WAAW;QACX,EAAE;QACF,gCAAgC;QAChC,wEAAwE;QACxE,gDAAgD;QAChD,gCAAgC;QAChC,8DAA8D;QAC9D,EAAE;QACF,+BAA+B;QAC/B,EAAE;QACF,SAAS;QACT,qCAAqC;QACrC,iDAAiD;QACjD,KAAK;QACL,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,6CAA6C;QAC7C,iCAAiC;QACjC,6CAA6C;QAC7C,sCAAsC;QACtC,EAAE;QACF,4CAA4C;QAC5C,EAAE;QACF,SAAS;QACT,kCAAkC;QAClC,KAAK;QACL,EAAE;QACF,0MAA0M;QAC1M,EAAE;QACF,eAAe;QACf,EAAE;QACF,SAAS;QACT,SAAS;QACT,oBAAoB;QACpB,KAAK;QACL,EAAE;QACF,6HAA6H;QAC7H,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,SAAS;QACT,uBAAuB;QACvB,6BAA6B;QAC7B,0BAA0B;QAC1B,KAAK;QACL,EAAE;QACF,oGAAoG;QACpG,EAAE;QACF,oBAAoB;QACpB,EAAE;QACF,SAAS;QACT,kBAAkB;QAClB,8BAA8B;QAC9B,uCAAuC;QACvC,KAAK;QACL,EAAE;QACF,iLAAiL;QACjL,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,SAAS;QACT,WAAW;QACX,uBAAuB;QACvB,oBAAoB;QACpB,KAAK;QACL,EAAE;QACF,qBAAqB;QACrB,EAAE;QACF,cAAc;QACd,uDAAuD;QACvD,kCAAkC;QAClC,+DAA+D;QAC/D,EAAE;QACF,aAAa;QACb,EAAE;QACF,SAAS;QACT,GAAG;QACH,mBAAmB;QACnB,eAAe;QACf,yBAAyB;QACzB,sCAAsC;QACtC,OAAO;QACP,KAAK;QACL,GAAG;QACH,KAAK;QACL,EAAE;QACF,aAAa;QACb,EAAE;QACF,qEAAqE;QACrE,EAAE;QACF,SAAS;QACT,6BAA6B;QAC7B,gEAAgE;QAChE,QAAQ;QACR,+CAA+C;QAC/C,KAAK;QACL,EAAE;QACF,qFAAqF;QACrF,EAAE;QACF,0BAA0B;QAC1B,EAAE;QACF,oDAAoD;QACpD,oFAAoF;QACpF,oGAAoG;QACpG,yEAAyE;QACzE,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,wFAAwF;QACxF,yDAAyD;QACzD,yEAAyE;QACzE,iGAAiG;QACjG,sEAAsE;QACtE,qEAAqE;QACrE,EAAE;QACF,4KAA4K;QAC5K,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,gDAAgD;QAChD,kDAAkD;QAClD,0HAA0H;QAC1H,mEAAmE;QACnE,EAAE;QACF,SAAS;QACT,2CAA2C;QAC3C,KAAK;QACL,EAAE;QACF,uCAAuC;QACvC,+BAA+B;KAChC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AACrB,CAAC,CAAA;AAED,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,MAAe,EAAE,cAAuB,IAAI;IACvF,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAExC,yBAAyB;IACzB,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAEtD,wCAAwC;IACxC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC9D,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACjC,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,CAAC;QACD,aAAa,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACpE,CAAC;IAED,wCAAwC;IACxC,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC9D,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,CAAC;IACD,aAAa,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AACpE,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@getpagr/cli",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.7",
|
|
4
4
|
"description": "Upload and manage HTML files from the command line. Visit getpagr.co for more information.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -41,7 +41,8 @@
|
|
|
41
41
|
"dev": "tsc --watch",
|
|
42
42
|
"test": "vitest run",
|
|
43
43
|
"typecheck": "tsc --noEmit",
|
|
44
|
-
"prepublishOnly": "pnpm run build && pnpm run typecheck"
|
|
44
|
+
"prepublishOnly": "pnpm run build && pnpm run typecheck",
|
|
45
|
+
"generate-waf-token": "node generate-waf-token.mjs"
|
|
45
46
|
},
|
|
46
47
|
"dependencies": {
|
|
47
48
|
"citty": "^0.2.2"
|