@cursor/july 0.1.2 → 0.1.3

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 (174) hide show
  1. package/AGENTS.md +16 -5
  2. package/README.md +8 -9
  3. package/dist/bin/agent-serve.d.ts +3 -1
  4. package/dist/bin/agent-serve.d.ts.map +1 -1
  5. package/dist/bin/agent-serve.js +389 -152
  6. package/dist/docs/404.html +2 -2
  7. package/dist/docs/ab.html +3 -3
  8. package/dist/docs/assets/{app.Oje4vhlk.js → app.BR0RbIdx.js} +1 -1
  9. package/dist/docs/assets/chunks/@localSearchIndexroot.DtIOQzGj.js +1 -0
  10. package/dist/docs/assets/chunks/{VPLocalSearchBox.H5XZ2zCB.js → VPLocalSearchBox.qjsVTneI.js} +1 -1
  11. package/dist/docs/assets/chunks/{theme.CTR_TuaE.js → theme.2Kg8jIp_.js} +2 -2
  12. package/dist/docs/assets/{quickstart.md.CfU8_uTC.js → quickstart.md.BU6Iwi_9.js} +18 -6
  13. package/dist/docs/assets/{reference_cli.md.DA730zCu.js → reference_cli.md.Bv6pOxcF.js} +11 -6
  14. package/dist/docs/assets/{reference_cli.md.DA730zCu.lean.js → reference_cli.md.Bv6pOxcF.lean.js} +1 -1
  15. package/dist/docs/building-with-agents.html +3 -3
  16. package/dist/docs/concepts.html +3 -3
  17. package/dist/docs/deployment.html +3 -3
  18. package/dist/docs/evals.html +3 -3
  19. package/dist/docs/guides/agent-to-agent.html +3 -3
  20. package/dist/docs/guides/cloud-runtime.html +3 -3
  21. package/dist/docs/guides/github.html +3 -3
  22. package/dist/docs/guides/human-in-the-loop.html +3 -3
  23. package/dist/docs/guides/slack.html +3 -3
  24. package/dist/docs/guides/webhooks.html +3 -3
  25. package/dist/docs/hashmap.json +1 -1
  26. package/dist/docs/hillclimbing.html +3 -3
  27. package/dist/docs/index.html +3 -3
  28. package/dist/docs/quickstart.html +22 -10
  29. package/dist/docs/reference/agent-config.html +3 -3
  30. package/dist/docs/reference/channels.html +3 -3
  31. package/dist/docs/reference/cli.html +14 -9
  32. package/dist/docs/reference/connections.html +3 -3
  33. package/dist/docs/reference/hooks.html +3 -3
  34. package/dist/docs/reference/http-api.html +3 -3
  35. package/dist/docs/reference/instructions.html +3 -3
  36. package/dist/docs/reference/playground.html +3 -3
  37. package/dist/docs/reference/project-layout.html +3 -3
  38. package/dist/docs/reference/schedules.html +3 -3
  39. package/dist/docs/reference/sessions.html +3 -3
  40. package/dist/docs/reference/skills.html +3 -3
  41. package/dist/docs/reference/subagents.html +3 -3
  42. package/dist/docs/reference/tools.html +3 -3
  43. package/dist/docs/scaffolding-agents.html +3 -3
  44. package/dist/docs/storage.html +3 -3
  45. package/dist/docs/troubleshooting.html +3 -3
  46. package/dist/internal/chat-client.d.ts +29 -3
  47. package/dist/internal/chat-client.d.ts.map +1 -1
  48. package/dist/internal/chat-client.js +180 -27
  49. package/dist/internal/cli-ax.d.ts +75 -2
  50. package/dist/internal/cli-ax.d.ts.map +1 -1
  51. package/dist/internal/cli-ax.js +600 -52
  52. package/dist/internal/cli-cursor.d.ts.map +1 -1
  53. package/dist/internal/cli-cursor.js +8 -36
  54. package/dist/internal/cli-deploy.d.ts +59 -3
  55. package/dist/internal/cli-deploy.d.ts.map +1 -1
  56. package/dist/internal/cli-deploy.js +316 -38
  57. package/dist/internal/cursor/credentials.d.ts +9 -0
  58. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  59. package/dist/internal/cursor/credentials.js +12 -0
  60. package/dist/internal/deploy-client.d.ts +9 -1
  61. package/dist/internal/deploy-client.d.ts.map +1 -1
  62. package/dist/internal/deploy-client.js +23 -3
  63. package/dist/internal/deploy-source.d.ts +35 -0
  64. package/dist/internal/deploy-source.d.ts.map +1 -0
  65. package/dist/internal/deploy-source.js +118 -0
  66. package/dist/internal/discovery.d.ts +11 -0
  67. package/dist/internal/discovery.d.ts.map +1 -1
  68. package/dist/internal/discovery.js +43 -14
  69. package/dist/internal/eval-run-store.d.ts.map +1 -1
  70. package/dist/internal/eval-run-store.js +2 -1
  71. package/dist/internal/eval-runner.d.ts +2 -0
  72. package/dist/internal/eval-runner.d.ts.map +1 -1
  73. package/dist/internal/eval-runner.js +2 -0
  74. package/dist/internal/event-mapper.d.ts +54 -1
  75. package/dist/internal/event-mapper.d.ts.map +1 -1
  76. package/dist/internal/event-mapper.js +151 -41
  77. package/dist/internal/init-project.d.ts +88 -1
  78. package/dist/internal/init-project.d.ts.map +1 -1
  79. package/dist/internal/init-project.js +221 -31
  80. package/dist/internal/install-cursor-skills.d.ts +64 -0
  81. package/dist/internal/install-cursor-skills.d.ts.map +1 -0
  82. package/dist/internal/install-cursor-skills.js +274 -0
  83. package/dist/internal/logs-client.d.ts +60 -0
  84. package/dist/internal/logs-client.d.ts.map +1 -0
  85. package/dist/internal/logs-client.js +311 -0
  86. package/dist/internal/open-browser.d.ts +5 -0
  87. package/dist/internal/open-browser.d.ts.map +1 -0
  88. package/dist/internal/open-browser.js +34 -0
  89. package/dist/internal/playground/toolchain.d.ts.map +1 -1
  90. package/dist/internal/playground/toolchain.js +16 -11
  91. package/dist/internal/playground-proxy.d.ts +69 -0
  92. package/dist/internal/playground-proxy.d.ts.map +1 -0
  93. package/dist/internal/playground-proxy.js +468 -0
  94. package/dist/internal/prompt-context.d.ts +35 -0
  95. package/dist/internal/prompt-context.d.ts.map +1 -0
  96. package/dist/internal/prompt-context.js +71 -0
  97. package/dist/internal/request-headers.d.ts +11 -0
  98. package/dist/internal/request-headers.d.ts.map +1 -0
  99. package/dist/internal/request-headers.js +14 -0
  100. package/dist/internal/resolve-prod-target.d.ts +42 -0
  101. package/dist/internal/resolve-prod-target.d.ts.map +1 -0
  102. package/dist/internal/resolve-prod-target.js +111 -0
  103. package/dist/internal/run-client.d.ts +2 -2
  104. package/dist/internal/run-client.d.ts.map +1 -1
  105. package/dist/internal/run-client.js +38 -23
  106. package/dist/internal/server.d.ts.map +1 -1
  107. package/dist/internal/server.js +10 -4
  108. package/dist/internal/session-engine.d.ts +1 -1
  109. package/dist/internal/session-engine.d.ts.map +1 -1
  110. package/dist/internal/session-engine.js +21 -6
  111. package/dist/internal/sessions-client.d.ts +21 -0
  112. package/dist/internal/sessions-client.d.ts.map +1 -0
  113. package/dist/internal/sessions-client.js +168 -0
  114. package/dist/internal/stream-progress.d.ts.map +1 -1
  115. package/dist/internal/stream-progress.js +31 -3
  116. package/dist/internal/terminal-style.d.ts +22 -0
  117. package/dist/internal/terminal-style.d.ts.map +1 -0
  118. package/dist/internal/terminal-style.js +49 -0
  119. package/dist/internal/trajectory.d.ts +10 -5
  120. package/dist/internal/trajectory.d.ts.map +1 -1
  121. package/dist/internal/trajectory.js +82 -10
  122. package/dist/internal/workspace.d.ts +11 -0
  123. package/dist/internal/workspace.d.ts.map +1 -1
  124. package/dist/internal/workspace.js +38 -4
  125. package/dist/playground/assets/index-D-vo2lV_.css +1 -0
  126. package/dist/playground/assets/index-x60b9q2j.js +312 -0
  127. package/dist/playground/index.html +2 -2
  128. package/dist/types.d.ts +26 -1
  129. package/dist/types.d.ts.map +1 -1
  130. package/docs/quickstart.md +22 -7
  131. package/docs/reference/cli.md +51 -3
  132. package/package.json +3 -1
  133. package/skills/ab/SKILL.md +8 -8
  134. package/skills/create-agent/SKILL.md +28 -22
  135. package/skills/debug/SKILL.md +11 -11
  136. package/skills/evals/SKILL.md +16 -16
  137. package/skills/framework-map/SKILL.md +6 -6
  138. package/skills/github/SKILL.md +13 -13
  139. package/skills/hillclimb/SKILL.md +10 -10
  140. package/skills/setup-slack/SKILL.md +13 -13
  141. package/src/bin/agent-serve.ts +422 -188
  142. package/src/internal/chat-client.ts +252 -37
  143. package/src/internal/cli-ax.ts +722 -72
  144. package/src/internal/cli-cursor.ts +14 -42
  145. package/src/internal/cli-deploy.ts +428 -49
  146. package/src/internal/cursor/credentials.ts +14 -0
  147. package/src/internal/deploy-client.ts +45 -4
  148. package/src/internal/deploy-source.ts +133 -0
  149. package/src/internal/discovery.ts +53 -16
  150. package/src/internal/eval-run-store.ts +2 -1
  151. package/src/internal/eval-runner.ts +5 -0
  152. package/src/internal/event-mapper.ts +222 -42
  153. package/src/internal/init-project.ts +333 -51
  154. package/src/internal/install-cursor-skills.ts +327 -0
  155. package/src/internal/logs-client.ts +442 -0
  156. package/src/internal/open-browser.ts +41 -0
  157. package/src/internal/playground/toolchain.ts +15 -13
  158. package/src/internal/playground-proxy.ts +576 -0
  159. package/src/internal/prompt-context.ts +95 -0
  160. package/src/internal/request-headers.ts +23 -0
  161. package/src/internal/resolve-prod-target.ts +150 -0
  162. package/src/internal/run-client.ts +39 -36
  163. package/src/internal/server.ts +12 -3
  164. package/src/internal/session-engine.ts +22 -3
  165. package/src/internal/sessions-client.ts +182 -0
  166. package/src/internal/stream-progress.ts +36 -2
  167. package/src/internal/terminal-style.ts +74 -0
  168. package/src/internal/trajectory.ts +91 -13
  169. package/src/internal/workspace.ts +42 -4
  170. package/src/types.ts +42 -6
  171. package/dist/docs/assets/chunks/@localSearchIndexroot.zwQ9RCQ7.js +0 -1
  172. package/dist/playground/assets/index-B1Qc9h2u.css +0 -1
  173. package/dist/playground/assets/index-CpDYCj8W.js +0 -79
  174. /package/dist/docs/assets/{quickstart.md.CfU8_uTC.lean.js → quickstart.md.BU6Iwi_9.lean.js} +0 -0
@@ -0,0 +1,64 @@
1
+ /**
2
+ * Offer to install the package's coding-agent skills into the user's
3
+ * personal Cursor skills dir under `~/.cursor/skills/agentkit/<skill>/`.
4
+ *
5
+ * Cursor walks `~/.cursor/skills` recursively, so the `agentkit/` folder is
6
+ * only organizational — identity comes from the leaf folder that holds
7
+ * SKILL.md. Skipped for `--json` / non-TTY hosts.
8
+ */
9
+ /** Category folder under ~/.cursor/skills (Cursor discovers nested skills). */
10
+ export declare const CURSOR_SKILLS_NAMESPACE = "agentkit";
11
+ export interface PackageSkill {
12
+ /** Frontmatter `name` (e.g. agentkit-create-agent). */
13
+ name: string;
14
+ /** Leaf install directory under agentkit/ (e.g. create-agent). */
15
+ leafDir: string;
16
+ /** Absolute path to the source skill directory in the package. */
17
+ sourceDir: string;
18
+ }
19
+ export declare function cursorSkillsHome(home?: string): string;
20
+ /** `~/.cursor/skills/agentkit` — where package skills are installed. */
21
+ export declare function agentkitCursorSkillsDir(skillsHome?: string): string;
22
+ /** Absolute install path for one skill: `…/agentkit/<leafDir>`. */
23
+ export declare function skillInstallPath(skill: Pick<PackageSkill, "leafDir">, skillsHome?: string): string;
24
+ /**
25
+ * Skills shipped next to the running package. Uses the frontmatter `name`
26
+ * when present, otherwise `agentkit-<dir>`.
27
+ */
28
+ export declare function listShippedPackageSkills(packageRoot?: string): Promise<PackageSkill[]>;
29
+ /**
30
+ * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentkit/.
31
+ * Install still overwrites every shipped skill when the user confirms — this
32
+ * helper is for messaging (fresh install vs update).
33
+ */
34
+ export declare function findMissingCursorSkills(options?: {
35
+ packageRoot?: string;
36
+ skillsHome?: string;
37
+ }): Promise<PackageSkill[]>;
38
+ /**
39
+ * Copy each skill directory into `skillsHome/agentkit/<leafDir>/`.
40
+ * Always overwrites so a package upgrade refreshes local Cursor skills.
41
+ * Strips monorepo-only frontmatter and removes leaf dirs no longer shipped.
42
+ */
43
+ export declare function installCursorSkills(skills: readonly PackageSkill[], skillsHome?: string): Promise<string[]>;
44
+ /** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
45
+ export declare function prepareSkillMarkdownForCursorInstall(content: string): string;
46
+ export interface OfferInstallCursorSkillsOptions {
47
+ /** Skip when false (non-TTY / `--json`). */
48
+ interactive?: boolean;
49
+ packageRoot?: string;
50
+ skillsHome?: string;
51
+ /** Injected yes/no for tests. */
52
+ confirm?: (question: string) => Promise<boolean>;
53
+ out?: (text: string) => void;
54
+ }
55
+ /**
56
+ * On a TTY, offer to install/update every shipped package skill into
57
+ * ~/.cursor/skills/agentkit (always overwriting). No-op when non-interactive
58
+ * or the package ships no skills.
59
+ */
60
+ export declare function offerInstallCursorSkills(options?: OfferInstallCursorSkillsOptions): Promise<{
61
+ installed: string[];
62
+ skipped: boolean;
63
+ }>;
64
+ //# sourceMappingURL=install-cursor-skills.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"install-cursor-skills.d.ts","sourceRoot":"","sources":["../../src/internal/install-cursor-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,GAAE,MAAsC,GAC3C,MAAM,CAGR;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,UAAU,GAAE,MAA2B,GACtC,MAAM,CAER;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACpC,UAAU,GAAE,MAA2B,GACtC,MAAM,CAER;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,GAAE,MAAyB,GACrC,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BzB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAY1B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,UAAU,GAAE,MAA2B,GACtC,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB;AAED,oFAAoF;AACpF,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY5E;AAoBD,MAAM,WAAW,+BAA+B;IAC9C,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA+CpD"}
@@ -0,0 +1,274 @@
1
+ /**
2
+ * Offer to install the package's coding-agent skills into the user's
3
+ * personal Cursor skills dir under `~/.cursor/skills/agentkit/<skill>/`.
4
+ *
5
+ * Cursor walks `~/.cursor/skills` recursively, so the `agentkit/` folder is
6
+ * only organizational — identity comes from the leaf folder that holds
7
+ * SKILL.md. Skipped for `--json` / non-TTY hosts.
8
+ */
9
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
10
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
11
+ return new (P || (P = Promise))(function (resolve, reject) {
12
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
13
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
14
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
15
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
16
+ });
17
+ };
18
+ import { access, cp, mkdir, readdir, readFile, rm, writeFile, } from "node:fs/promises";
19
+ import { homedir } from "node:os";
20
+ import { join } from "node:path";
21
+ import { packageRootDir } from "./distribution.js";
22
+ import { stdoutPalette } from "./terminal-style.js";
23
+ /** Monorepo-only skill; excluded from the published package. */
24
+ const SKIP_SKILL_DIRS = new Set(["operate"]);
25
+ /** Category folder under ~/.cursor/skills (Cursor discovers nested skills). */
26
+ export const CURSOR_SKILLS_NAMESPACE = "agentkit";
27
+ export function cursorSkillsHome(home) {
28
+ var _a;
29
+ if (home === void 0) { home = (_a = process.env.HOME) !== null && _a !== void 0 ? _a : homedir(); }
30
+ const resolved = home.trim() === "" ? homedir() : home;
31
+ return join(resolved, ".cursor", "skills");
32
+ }
33
+ /** `~/.cursor/skills/agentkit` — where package skills are installed. */
34
+ export function agentkitCursorSkillsDir(skillsHome = cursorSkillsHome()) {
35
+ return join(skillsHome, CURSOR_SKILLS_NAMESPACE);
36
+ }
37
+ /** Absolute install path for one skill: `…/agentkit/<leafDir>`. */
38
+ export function skillInstallPath(skill, skillsHome = cursorSkillsHome()) {
39
+ return join(agentkitCursorSkillsDir(skillsHome), skill.leafDir);
40
+ }
41
+ /**
42
+ * Skills shipped next to the running package. Uses the frontmatter `name`
43
+ * when present, otherwise `agentkit-<dir>`.
44
+ */
45
+ export function listShippedPackageSkills() {
46
+ return __awaiter(this, arguments, void 0, function* (packageRoot = packageRootDir()) {
47
+ var _a;
48
+ const skillsRoot = join(packageRoot, "skills");
49
+ let entries;
50
+ try {
51
+ entries = yield readdir(skillsRoot, { withFileTypes: true });
52
+ }
53
+ catch (_b) {
54
+ return [];
55
+ }
56
+ const skills = [];
57
+ for (const entry of entries) {
58
+ if (!entry.isDirectory() || SKIP_SKILL_DIRS.has(entry.name)) {
59
+ continue;
60
+ }
61
+ const sourceDir = join(skillsRoot, entry.name);
62
+ const skillMd = join(sourceDir, "SKILL.md");
63
+ try {
64
+ yield access(skillMd);
65
+ }
66
+ catch (_c) {
67
+ continue;
68
+ }
69
+ const raw = yield readFile(skillMd, "utf8");
70
+ const name = (_a = parseSkillName(raw)) !== null && _a !== void 0 ? _a : `agentkit-${entry.name}`;
71
+ skills.push({ name, leafDir: entry.name, sourceDir });
72
+ }
73
+ skills.sort((a, b) => a.leafDir.localeCompare(b.leafDir));
74
+ return skills;
75
+ });
76
+ }
77
+ /**
78
+ * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentkit/.
79
+ * Install still overwrites every shipped skill when the user confirms — this
80
+ * helper is for messaging (fresh install vs update).
81
+ */
82
+ export function findMissingCursorSkills(options) {
83
+ return __awaiter(this, void 0, void 0, function* () {
84
+ var _a;
85
+ const shipped = yield listShippedPackageSkills(options === null || options === void 0 ? void 0 : options.packageRoot);
86
+ const home = (_a = options === null || options === void 0 ? void 0 : options.skillsHome) !== null && _a !== void 0 ? _a : cursorSkillsHome();
87
+ const missing = [];
88
+ for (const skill of shipped) {
89
+ try {
90
+ yield access(join(skillInstallPath(skill, home), "SKILL.md"));
91
+ }
92
+ catch (_b) {
93
+ missing.push(skill);
94
+ }
95
+ }
96
+ return missing;
97
+ });
98
+ }
99
+ /**
100
+ * Copy each skill directory into `skillsHome/agentkit/<leafDir>/`.
101
+ * Always overwrites so a package upgrade refreshes local Cursor skills.
102
+ * Strips monorepo-only frontmatter and removes leaf dirs no longer shipped.
103
+ */
104
+ export function installCursorSkills(skills_1) {
105
+ return __awaiter(this, arguments, void 0, function* (skills, skillsHome = cursorSkillsHome()) {
106
+ const namespaceDir = agentkitCursorSkillsDir(skillsHome);
107
+ yield mkdir(namespaceDir, { recursive: true });
108
+ const shippedLeaves = new Set(skills.map((skill) => skill.leafDir));
109
+ let existingLeaves = [];
110
+ try {
111
+ const entries = yield readdir(namespaceDir, { withFileTypes: true });
112
+ existingLeaves = entries
113
+ .filter((entry) => entry.isDirectory())
114
+ .map((entry) => entry.name);
115
+ }
116
+ catch (_a) {
117
+ existingLeaves = [];
118
+ }
119
+ for (const leaf of existingLeaves) {
120
+ if (!shippedLeaves.has(leaf)) {
121
+ yield rm(join(namespaceDir, leaf), { recursive: true, force: true });
122
+ }
123
+ }
124
+ const installed = [];
125
+ for (const skill of skills) {
126
+ const target = skillInstallPath(skill, skillsHome);
127
+ yield cp(skill.sourceDir, target, { recursive: true, force: true });
128
+ const skillMdPath = join(target, "SKILL.md");
129
+ const raw = yield readFile(skillMdPath, "utf8");
130
+ const adjusted = prepareSkillMarkdownForCursorInstall(raw);
131
+ if (adjusted !== raw) {
132
+ yield writeFile(skillMdPath, adjusted, "utf8");
133
+ }
134
+ installed.push(skill.leafDir);
135
+ }
136
+ return installed;
137
+ });
138
+ }
139
+ /** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
140
+ export function prepareSkillMarkdownForCursorInstall(content) {
141
+ var _a;
142
+ const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
143
+ if (match === null) {
144
+ return content;
145
+ }
146
+ const frontmatter = stripPathsFromFrontmatter((_a = match[1]) !== null && _a !== void 0 ? _a : "");
147
+ const body = content.slice(match[0].length);
148
+ const adjustedBody = body.replace(/\[`docs\/([^`]+)`\]\(\.\.\/\.\.\/docs\/[^)]+\)/g, "docs/$1 in the @cursor/july package");
149
+ return `---\n${frontmatter.trimEnd()}\n---${adjustedBody}`;
150
+ }
151
+ function stripPathsFromFrontmatter(frontmatter) {
152
+ var _a, _b;
153
+ const lines = frontmatter.split(/\r?\n/);
154
+ const out = [];
155
+ for (let i = 0; i < lines.length; i++) {
156
+ const line = (_a = lines[i]) !== null && _a !== void 0 ? _a : "";
157
+ if (line.trimStart().startsWith("paths:")) {
158
+ i++;
159
+ while (i < lines.length && /^[ \t]*-/.test((_b = lines[i]) !== null && _b !== void 0 ? _b : "")) {
160
+ i++;
161
+ }
162
+ i--;
163
+ continue;
164
+ }
165
+ out.push(line);
166
+ }
167
+ return out.join("\n");
168
+ }
169
+ /**
170
+ * On a TTY, offer to install/update every shipped package skill into
171
+ * ~/.cursor/skills/agentkit (always overwriting). No-op when non-interactive
172
+ * or the package ships no skills.
173
+ */
174
+ export function offerInstallCursorSkills() {
175
+ return __awaiter(this, arguments, void 0, function* (options = {}) {
176
+ var _a, _b, _c, _d;
177
+ const out = (_a = options.out) !== null && _a !== void 0 ? _a : ((text) => process.stdout.write(text));
178
+ const interactive = (_b = options.interactive) !== null && _b !== void 0 ? _b : (process.stdin.isTTY === true && process.stdout.isTTY === true);
179
+ const shipped = yield listShippedPackageSkills(options.packageRoot);
180
+ if (shipped.length === 0) {
181
+ return { installed: [], skipped: true };
182
+ }
183
+ const home = (_c = options.skillsHome) !== null && _c !== void 0 ? _c : cursorSkillsHome();
184
+ const targetDir = agentkitCursorSkillsDir(home);
185
+ const missing = yield findMissingCursorSkills({
186
+ packageRoot: options.packageRoot,
187
+ skillsHome: home,
188
+ });
189
+ const names = shipped.map((skill) => skill.leafDir).join(", ");
190
+ const noun = shipped.length === 1 ? "skill" : "skills";
191
+ const verb = missing.length === shipped.length ? "Install" : "Update";
192
+ const question = `${verb} ${shipped.length} agentkit ${noun} in ${targetDir}?`;
193
+ if (!interactive) {
194
+ return { installed: [], skipped: true };
195
+ }
196
+ const c = stdoutPalette();
197
+ out(`${question}\n`);
198
+ out(c.dim(` ${names}\n`));
199
+ if (missing.length < shipped.length) {
200
+ out(c.dim(" (overwrites existing copies with the package version)\n"));
201
+ }
202
+ const confirm = (_d = options.confirm) !== null && _d !== void 0 ? _d : ((q) => promptYesNo(q, { defaultYes: true, out }));
203
+ const accepted = yield confirm(missing.length === shipped.length ? "Install now?" : "Update now?");
204
+ if (!accepted) {
205
+ out(c.dim("Skipped skill install.\n\n"));
206
+ return { installed: [], skipped: true };
207
+ }
208
+ const installed = yield installCursorSkills(shipped, home);
209
+ out(`${verb === "Install" ? "Installed" : "Updated"} ${installed.length} ${noun} in ${targetDir}\n\n`);
210
+ return { installed, skipped: false };
211
+ });
212
+ }
213
+ function parseSkillName(skillMd) {
214
+ var _a;
215
+ var _b;
216
+ const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(skillMd);
217
+ if (match === null) {
218
+ return undefined;
219
+ }
220
+ const nameLine = /^name:\s*(.+)\s*$/m.exec((_b = match[1]) !== null && _b !== void 0 ? _b : "");
221
+ if (nameLine === null) {
222
+ return undefined;
223
+ }
224
+ const raw = (_a = nameLine[1]) === null || _a === void 0 ? void 0 : _a.trim();
225
+ if (raw === undefined || raw === "") {
226
+ return undefined;
227
+ }
228
+ // Strip optional quotes around the YAML scalar.
229
+ return raw.replace(/^["']|["']$/g, "");
230
+ }
231
+ function promptYesNo(question, options) {
232
+ return __awaiter(this, void 0, void 0, function* () {
233
+ const hint = options.defaultYes ? "Y/n" : "y/N";
234
+ options.out(`${question} [${hint}] `);
235
+ process.stdin.resume();
236
+ const line = yield readOneLine(process.stdin);
237
+ process.stdin.pause();
238
+ if (line === undefined || line.trim() === "") {
239
+ return options.defaultYes;
240
+ }
241
+ const answer = line.trim().toLowerCase();
242
+ if (answer === "y" || answer === "yes") {
243
+ return true;
244
+ }
245
+ if (answer === "n" || answer === "no") {
246
+ return false;
247
+ }
248
+ return options.defaultYes;
249
+ });
250
+ }
251
+ function readOneLine(stream) {
252
+ return new Promise((resolve) => {
253
+ let buffer = "";
254
+ const onData = (chunk) => {
255
+ buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
256
+ const newline = buffer.indexOf("\n");
257
+ if (newline === -1) {
258
+ return;
259
+ }
260
+ cleanup();
261
+ resolve(buffer.slice(0, newline).replace(/\r$/, ""));
262
+ };
263
+ const onEnd = () => {
264
+ cleanup();
265
+ resolve(buffer === "" ? undefined : buffer.replace(/\r$/, ""));
266
+ };
267
+ const cleanup = () => {
268
+ stream.off("data", onData);
269
+ stream.off("end", onEnd);
270
+ };
271
+ stream.on("data", onData);
272
+ stream.on("end", onEnd);
273
+ });
274
+ }
@@ -0,0 +1,60 @@
1
+ /**
2
+ * `agentkit logs` — follow deploy progress (hosted) then runtime `/v1/logs`.
3
+ *
4
+ * Customer-facing output never includes hosting URLs, tokens, or infra jargon.
5
+ */
6
+ import { type DeploymentDetail, type DeploymentProgress } from "./deploy-client.js";
7
+ import { type RequestAuth } from "./request-headers.js";
8
+ export interface LogRingEntry {
9
+ index: number;
10
+ at: string;
11
+ line: string;
12
+ }
13
+ export interface LogsResponse {
14
+ entries: LogRingEntry[];
15
+ nextAfter: number;
16
+ }
17
+ export type LogsProgress = DeploymentProgress | "queued" | "preparing" | "building" | "finalizing" | "running" | "failed" | "stopping" | "stopped" | "degraded";
18
+ export declare function progressMessage(progress: LogsProgress, lastError?: string | null): string;
19
+ /** Strip obvious hosting internals from error text shown to customers. */
20
+ export declare function sanitizeCustomerError(message: string): string;
21
+ export declare function fetchLogs(args: {
22
+ baseUrl: string;
23
+ after?: number;
24
+ auth?: RequestAuth;
25
+ fetchImpl?: typeof fetch;
26
+ signal?: AbortSignal;
27
+ }): Promise<LogsResponse>;
28
+ export interface RunLogsTailOptions {
29
+ /** When true, use hosted deploy progress then runtime logs. */
30
+ prod?: boolean;
31
+ dir: string;
32
+ cwd?: string;
33
+ slug?: string;
34
+ team?: string;
35
+ apiKey?: string;
36
+ url?: string;
37
+ bearerToken?: string;
38
+ once?: boolean;
39
+ json?: boolean;
40
+ fetchImpl?: typeof fetch;
41
+ signal?: AbortSignal;
42
+ intervalMs?: number;
43
+ /** stdout writer (test seam). */
44
+ write?: (text: string) => void;
45
+ /** stderr writer (test seam). */
46
+ err?: (text: string) => void;
47
+ /**
48
+ * Deploy detail fetcher for `--prod` progress (test seam). Defaults to
49
+ * management API via resolveProdTarget's auth path.
50
+ */
51
+ getDeployment?: () => Promise<DeploymentDetail>;
52
+ /** After deploy is running, resolve runtime base URL + headers. */
53
+ resolveRuntime?: () => Promise<{
54
+ agentUrl: string;
55
+ headers?: Record<string, string>;
56
+ }>;
57
+ sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
58
+ }
59
+ export declare function runLogsTail(options: RunLogsTailOptions): Promise<void>;
60
+ //# sourceMappingURL=logs-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logs-client.d.ts","sourceRoot":"","sources":["../../src/internal/logs-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAW7E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAcf,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,CAgBR;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BxB;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChD,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC5E"}