@agents-dev/cli 0.7.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.
Files changed (152) hide show
  1. package/AGENTS.md +400 -0
  2. package/CHANGELOG.md +297 -0
  3. package/CONTRIBUTING.md +164 -0
  4. package/LICENSE +21 -0
  5. package/README.md +117 -0
  6. package/bin/agents +24 -0
  7. package/dist/cli.d.ts +1 -0
  8. package/dist/cli.js +282 -0
  9. package/dist/cli.js.map +1 -0
  10. package/dist/commands/connect.d.ts +7 -0
  11. package/dist/commands/connect.js +48 -0
  12. package/dist/commands/connect.js.map +1 -0
  13. package/dist/commands/disconnect.d.ts +7 -0
  14. package/dist/commands/disconnect.js +47 -0
  15. package/dist/commands/disconnect.js.map +1 -0
  16. package/dist/commands/doctor.d.ts +6 -0
  17. package/dist/commands/doctor.js +430 -0
  18. package/dist/commands/doctor.js.map +1 -0
  19. package/dist/commands/init.d.ts +5 -0
  20. package/dist/commands/init.js +24 -0
  21. package/dist/commands/init.js.map +1 -0
  22. package/dist/commands/mcp-add.d.ts +20 -0
  23. package/dist/commands/mcp-add.js +250 -0
  24. package/dist/commands/mcp-add.js.map +1 -0
  25. package/dist/commands/mcp-import.d.ts +13 -0
  26. package/dist/commands/mcp-import.js +207 -0
  27. package/dist/commands/mcp-import.js.map +1 -0
  28. package/dist/commands/mcp-list.d.ts +5 -0
  29. package/dist/commands/mcp-list.js +34 -0
  30. package/dist/commands/mcp-list.js.map +1 -0
  31. package/dist/commands/mcp-remove.d.ts +7 -0
  32. package/dist/commands/mcp-remove.js +34 -0
  33. package/dist/commands/mcp-remove.js.map +1 -0
  34. package/dist/commands/mcp-test.d.ts +8 -0
  35. package/dist/commands/mcp-test.js +402 -0
  36. package/dist/commands/mcp-test.js.map +1 -0
  37. package/dist/commands/reset.d.ts +6 -0
  38. package/dist/commands/reset.js +76 -0
  39. package/dist/commands/reset.js.map +1 -0
  40. package/dist/commands/start.d.ts +6 -0
  41. package/dist/commands/start.js +292 -0
  42. package/dist/commands/start.js.map +1 -0
  43. package/dist/commands/status.d.ts +7 -0
  44. package/dist/commands/status.js +278 -0
  45. package/dist/commands/status.js.map +1 -0
  46. package/dist/commands/sync.d.ts +6 -0
  47. package/dist/commands/sync.js +22 -0
  48. package/dist/commands/sync.js.map +1 -0
  49. package/dist/commands/watch.d.ts +7 -0
  50. package/dist/commands/watch.js +117 -0
  51. package/dist/commands/watch.js.map +1 -0
  52. package/dist/core/claudeCli.d.ts +7 -0
  53. package/dist/core/claudeCli.js +35 -0
  54. package/dist/core/claudeCli.js.map +1 -0
  55. package/dist/core/config.d.ts +17 -0
  56. package/dist/core/config.js +121 -0
  57. package/dist/core/config.js.map +1 -0
  58. package/dist/core/cursorCli.d.ts +9 -0
  59. package/dist/core/cursorCli.js +60 -0
  60. package/dist/core/cursorCli.js.map +1 -0
  61. package/dist/core/fs.d.ts +11 -0
  62. package/dist/core/fs.js +76 -0
  63. package/dist/core/fs.js.map +1 -0
  64. package/dist/core/gitignore.d.ts +3 -0
  65. package/dist/core/gitignore.js +54 -0
  66. package/dist/core/gitignore.js.map +1 -0
  67. package/dist/core/mcp.d.ts +8 -0
  68. package/dist/core/mcp.js +134 -0
  69. package/dist/core/mcp.js.map +1 -0
  70. package/dist/core/mcpCrud.d.ts +34 -0
  71. package/dist/core/mcpCrud.js +105 -0
  72. package/dist/core/mcpCrud.js.map +1 -0
  73. package/dist/core/mcpImport.d.ts +14 -0
  74. package/dist/core/mcpImport.js +507 -0
  75. package/dist/core/mcpImport.js.map +1 -0
  76. package/dist/core/mcpSecrets.d.ts +27 -0
  77. package/dist/core/mcpSecrets.js +144 -0
  78. package/dist/core/mcpSecrets.js.map +1 -0
  79. package/dist/core/mcpValidation.d.ts +19 -0
  80. package/dist/core/mcpValidation.js +78 -0
  81. package/dist/core/mcpValidation.js.map +1 -0
  82. package/dist/core/paths.d.ts +37 -0
  83. package/dist/core/paths.js +43 -0
  84. package/dist/core/paths.js.map +1 -0
  85. package/dist/core/project.d.ts +16 -0
  86. package/dist/core/project.js +34 -0
  87. package/dist/core/project.js.map +1 -0
  88. package/dist/core/renderers.d.ts +14 -0
  89. package/dist/core/renderers.js +113 -0
  90. package/dist/core/renderers.js.map +1 -0
  91. package/dist/core/shell.d.ts +8 -0
  92. package/dist/core/shell.js +21 -0
  93. package/dist/core/shell.js.map +1 -0
  94. package/dist/core/shellWords.d.ts +1 -0
  95. package/dist/core/shellWords.js +84 -0
  96. package/dist/core/shellWords.js.map +1 -0
  97. package/dist/core/skills.d.ts +8 -0
  98. package/dist/core/skills.js +150 -0
  99. package/dist/core/skills.js.map +1 -0
  100. package/dist/core/skillsValidation.d.ts +1 -0
  101. package/dist/core/skillsValidation.js +68 -0
  102. package/dist/core/skillsValidation.js.map +1 -0
  103. package/dist/core/sync.d.ts +2 -0
  104. package/dist/core/sync.js +427 -0
  105. package/dist/core/sync.js.map +1 -0
  106. package/dist/core/syncLock.d.ts +1 -0
  107. package/dist/core/syncLock.js +84 -0
  108. package/dist/core/syncLock.js.map +1 -0
  109. package/dist/core/templates.d.ts +1 -0
  110. package/dist/core/templates.js +38 -0
  111. package/dist/core/templates.js.map +1 -0
  112. package/dist/core/trust.d.ts +7 -0
  113. package/dist/core/trust.js +51 -0
  114. package/dist/core/trust.js.map +1 -0
  115. package/dist/core/vscodeSettings.d.ts +17 -0
  116. package/dist/core/vscodeSettings.js +212 -0
  117. package/dist/core/vscodeSettings.js.map +1 -0
  118. package/dist/core/warnings.d.ts +2 -0
  119. package/dist/core/warnings.js +26 -0
  120. package/dist/core/warnings.js.map +1 -0
  121. package/dist/integrations/antigravity.d.ts +9 -0
  122. package/dist/integrations/antigravity.js +13 -0
  123. package/dist/integrations/antigravity.js.map +1 -0
  124. package/dist/integrations/claude.d.ts +1 -0
  125. package/dist/integrations/claude.js +4 -0
  126. package/dist/integrations/claude.js.map +1 -0
  127. package/dist/integrations/codex.d.ts +5 -0
  128. package/dist/integrations/codex.js +5 -0
  129. package/dist/integrations/codex.js.map +1 -0
  130. package/dist/integrations/copilotVscode.d.ts +7 -0
  131. package/dist/integrations/copilotVscode.js +9 -0
  132. package/dist/integrations/copilotVscode.js.map +1 -0
  133. package/dist/integrations/cursor.d.ts +7 -0
  134. package/dist/integrations/cursor.js +9 -0
  135. package/dist/integrations/cursor.js.map +1 -0
  136. package/dist/integrations/gemini.d.ts +12 -0
  137. package/dist/integrations/gemini.js +15 -0
  138. package/dist/integrations/gemini.js.map +1 -0
  139. package/dist/integrations/registry.d.ts +9 -0
  140. package/dist/integrations/registry.js +21 -0
  141. package/dist/integrations/registry.js.map +1 -0
  142. package/dist/types.d.ts +85 -0
  143. package/dist/types.js +2 -0
  144. package/dist/types.js.map +1 -0
  145. package/docs/EXAMPLES.md +211 -0
  146. package/docs/README.md +26 -0
  147. package/docs/agents-system.md +178 -0
  148. package/package.json +77 -0
  149. package/templates/agents/AGENTS.md +23 -0
  150. package/templates/agents/README.md +25 -0
  151. package/templates/agents/skills/README.md +27 -0
  152. package/templates/agents/skills/skill-guide/SKILL.md +29 -0
@@ -0,0 +1,84 @@
1
+ export function parseShellWords(input) {
2
+ const tokens = [];
3
+ let current = '';
4
+ let hasToken = false;
5
+ let inSingle = false;
6
+ let inDouble = false;
7
+ let escaping = false;
8
+ const flush = () => {
9
+ if (!hasToken)
10
+ return;
11
+ tokens.push(current);
12
+ current = '';
13
+ hasToken = false;
14
+ };
15
+ for (let i = 0; i < input.length; i += 1) {
16
+ const char = input[i];
17
+ if (escaping) {
18
+ current += char;
19
+ hasToken = true;
20
+ escaping = false;
21
+ continue;
22
+ }
23
+ if (inSingle) {
24
+ if (char === '\'') {
25
+ inSingle = false;
26
+ }
27
+ else {
28
+ current += char;
29
+ }
30
+ hasToken = true;
31
+ continue;
32
+ }
33
+ if (inDouble) {
34
+ if (char === '"') {
35
+ inDouble = false;
36
+ }
37
+ else if (char === '\\') {
38
+ const next = input[i + 1];
39
+ if (next && ['\\', '"', '$', '`'].includes(next)) {
40
+ current += next;
41
+ i += 1;
42
+ }
43
+ else {
44
+ current += char;
45
+ }
46
+ }
47
+ else {
48
+ current += char;
49
+ }
50
+ hasToken = true;
51
+ continue;
52
+ }
53
+ if (/\s/.test(char)) {
54
+ flush();
55
+ continue;
56
+ }
57
+ if (char === '\'') {
58
+ inSingle = true;
59
+ hasToken = true;
60
+ continue;
61
+ }
62
+ if (char === '"') {
63
+ inDouble = true;
64
+ hasToken = true;
65
+ continue;
66
+ }
67
+ if (char === '\\') {
68
+ escaping = true;
69
+ hasToken = true;
70
+ continue;
71
+ }
72
+ current += char;
73
+ hasToken = true;
74
+ }
75
+ if (escaping) {
76
+ throw new Error('Invalid args: trailing escape character.');
77
+ }
78
+ if (inSingle || inDouble) {
79
+ throw new Error('Invalid args: unclosed quote.');
80
+ }
81
+ flush();
82
+ return tokens;
83
+ }
84
+ //# sourceMappingURL=shellWords.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shellWords.js","sourceRoot":"","sources":["../../src/core/shellWords.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { IntegrationName } from '../types.js';
2
+ export declare function syncSkills(args: {
3
+ projectRoot: string;
4
+ enabledIntegrations: IntegrationName[];
5
+ check: boolean;
6
+ changed: string[];
7
+ warnings: string[];
8
+ }): Promise<void>;
@@ -0,0 +1,150 @@
1
+ import path from 'node:path';
2
+ import { lstat, readdir, readlink, symlink } from 'node:fs/promises';
3
+ import { copyDir, ensureDir, pathExists, removeIfExists, writeTextAtomic } from './fs.js';
4
+ import { getProjectPaths } from './paths.js';
5
+ export async function syncSkills(args) {
6
+ const { projectRoot, enabledIntegrations, check, changed, warnings } = args;
7
+ const paths = getProjectPaths(projectRoot);
8
+ await ensureDir(paths.agentsSkillsDir);
9
+ const hasSkills = await hasSkillDirectories(paths.agentsSkillsDir);
10
+ await syncToolSkillsBridge({
11
+ enabled: enabledIntegrations.includes('claude') && hasSkills,
12
+ projectRoot,
13
+ parentDir: paths.claudeDir,
14
+ bridgePath: paths.claudeSkillsBridge,
15
+ sourcePath: paths.agentsSkillsDir,
16
+ label: '.claude/skills',
17
+ check,
18
+ changed,
19
+ warnings
20
+ });
21
+ await syncToolSkillsBridge({
22
+ enabled: enabledIntegrations.includes('cursor') && hasSkills,
23
+ projectRoot,
24
+ parentDir: paths.cursorDir,
25
+ bridgePath: paths.cursorSkillsBridge,
26
+ sourcePath: paths.agentsSkillsDir,
27
+ label: '.cursor/skills',
28
+ check,
29
+ changed,
30
+ warnings
31
+ });
32
+ await syncToolSkillsBridge({
33
+ enabled: enabledIntegrations.includes('gemini') && hasSkills,
34
+ projectRoot,
35
+ parentDir: paths.geminiDir,
36
+ bridgePath: paths.geminiSkillsBridge,
37
+ sourcePath: paths.agentsSkillsDir,
38
+ label: '.gemini/skills',
39
+ check,
40
+ changed,
41
+ warnings
42
+ });
43
+ await cleanupLegacyAntigravityBridge({
44
+ projectRoot,
45
+ check,
46
+ changed
47
+ });
48
+ }
49
+ async function hasSkillDirectories(skillsDir) {
50
+ if (!(await pathExists(skillsDir)))
51
+ return false;
52
+ const entries = await readdir(skillsDir, { withFileTypes: true });
53
+ for (const entry of entries) {
54
+ if (!entry.isDirectory())
55
+ continue;
56
+ const skillFile = path.join(skillsDir, entry.name, 'SKILL.md');
57
+ if (await pathExists(skillFile)) {
58
+ return true;
59
+ }
60
+ }
61
+ return false;
62
+ }
63
+ async function syncToolSkillsBridge(args) {
64
+ const { enabled, projectRoot, parentDir, bridgePath, sourcePath, label, check, changed, warnings } = args;
65
+ const expectedRelative = path.relative(path.dirname(bridgePath), sourcePath) || '.';
66
+ if (!enabled) {
67
+ const removed = await cleanupManagedBridge(bridgePath, expectedRelative, sourcePath);
68
+ if (removed) {
69
+ changed.push(path.relative(projectRoot, bridgePath) || bridgePath);
70
+ if (!check) {
71
+ await removeIfExists(bridgePath);
72
+ }
73
+ }
74
+ return;
75
+ }
76
+ await ensureDir(parentDir);
77
+ const exists = await pathExists(bridgePath);
78
+ if (exists) {
79
+ const linkInfo = await lstat(bridgePath);
80
+ if (linkInfo.isSymbolicLink()) {
81
+ const current = await readlink(bridgePath);
82
+ if (current === expectedRelative || path.resolve(path.dirname(bridgePath), current) === sourcePath) {
83
+ return;
84
+ }
85
+ changed.push(path.relative(projectRoot, bridgePath) || bridgePath);
86
+ if (!check) {
87
+ await removeIfExists(bridgePath);
88
+ }
89
+ }
90
+ else {
91
+ const marker = path.join(bridgePath, '.agents_bridge');
92
+ if (await pathExists(marker)) {
93
+ if (!check) {
94
+ await copyDir(sourcePath, bridgePath);
95
+ }
96
+ return;
97
+ }
98
+ else {
99
+ warnings.push(`Found existing ${label} that is not managed by agents: ${bridgePath}`);
100
+ return;
101
+ }
102
+ }
103
+ }
104
+ changed.push(path.relative(projectRoot, bridgePath) || bridgePath);
105
+ if (check)
106
+ return;
107
+ try {
108
+ await symlink(expectedRelative, bridgePath);
109
+ }
110
+ catch (error) {
111
+ await copyDir(sourcePath, bridgePath);
112
+ await writeTextAtomic(path.join(bridgePath, '.agents_bridge'), 'managed-by-agents\n');
113
+ const message = error instanceof Error ? error.message : String(error);
114
+ warnings.push(`${label} bridge fallback to copy mode: ${message}`);
115
+ }
116
+ }
117
+ async function cleanupManagedBridge(bridgePath, expectedRelative, expectedAbsolute) {
118
+ if (!(await pathExists(bridgePath))) {
119
+ return false;
120
+ }
121
+ const info = await lstat(bridgePath);
122
+ if (info.isSymbolicLink()) {
123
+ const current = await readlink(bridgePath);
124
+ return current === expectedRelative || path.resolve(path.dirname(bridgePath), current) === expectedAbsolute;
125
+ }
126
+ const marker = path.join(bridgePath, '.agents_bridge');
127
+ return pathExists(marker);
128
+ }
129
+ async function cleanupLegacyAntigravityBridge(args) {
130
+ const { projectRoot, check, changed } = args;
131
+ const paths = getProjectPaths(projectRoot);
132
+ const legacyDir = path.join(projectRoot, '.agent');
133
+ const legacyBridgePath = path.join(legacyDir, 'skills');
134
+ const expectedRelative = path.relative(path.dirname(legacyBridgePath), paths.agentsSkillsDir) || '.';
135
+ const removable = await cleanupManagedBridge(legacyBridgePath, expectedRelative, paths.agentsSkillsDir);
136
+ if (!removable)
137
+ return;
138
+ changed.push(path.relative(projectRoot, legacyBridgePath) || legacyBridgePath);
139
+ if (check)
140
+ return;
141
+ await removeIfExists(legacyBridgePath);
142
+ if (await pathExists(legacyDir)) {
143
+ const entries = await readdir(legacyDir);
144
+ if (entries.length === 0) {
145
+ await removeIfExists(legacyDir);
146
+ changed.push(path.relative(projectRoot, legacyDir) || legacyDir);
147
+ }
148
+ }
149
+ }
150
+ //# sourceMappingURL=skills.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export declare function validateSkillsDirectory(skillsDir: string): Promise<string[]>;
@@ -0,0 +1,68 @@
1
+ import path from 'node:path';
2
+ import { readdir, readFile } from 'node:fs/promises';
3
+ import { pathExists } from './fs.js';
4
+ const SKILL_NAME_RE = /^[\p{Ll}\p{Nd}]+(?:-[\p{Ll}\p{Nd}]+)*$/u;
5
+ export async function validateSkillsDirectory(skillsDir) {
6
+ if (!(await pathExists(skillsDir)))
7
+ return [];
8
+ const entries = await readdir(skillsDir, { withFileTypes: true });
9
+ const warnings = [];
10
+ for (const entry of entries) {
11
+ if (!entry.isDirectory())
12
+ continue;
13
+ const dirName = entry.name;
14
+ const skillPath = path.join(skillsDir, dirName, 'SKILL.md');
15
+ if (!(await pathExists(skillPath))) {
16
+ warnings.push(`Skill "${dirName}" is missing SKILL.md.`);
17
+ continue;
18
+ }
19
+ const raw = await readFile(skillPath, 'utf8');
20
+ const frontmatter = extractFrontmatter(raw);
21
+ if (!frontmatter) {
22
+ warnings.push(`Skill "${dirName}" has no YAML frontmatter.`);
23
+ continue;
24
+ }
25
+ const name = frontmatter.name?.trim();
26
+ const description = frontmatter.description?.trim();
27
+ if (!name) {
28
+ warnings.push(`Skill "${dirName}" is missing required frontmatter field "name".`);
29
+ }
30
+ else {
31
+ if (name !== dirName) {
32
+ warnings.push(`Skill "${dirName}" must match frontmatter name "${name}".`);
33
+ }
34
+ if (name.length > 64 || !SKILL_NAME_RE.test(name)) {
35
+ warnings.push(`Skill "${dirName}" has invalid name format.`);
36
+ }
37
+ }
38
+ if (!description) {
39
+ warnings.push(`Skill "${dirName}" is missing required frontmatter field "description".`);
40
+ }
41
+ else if (description.length > 300) {
42
+ warnings.push(`Skill "${dirName}" description is longer than 300 characters.`);
43
+ }
44
+ }
45
+ return warnings;
46
+ }
47
+ function extractFrontmatter(raw) {
48
+ const match = raw.match(/^---\s*\n([\s\S]*?)\n---\s*\n?/u);
49
+ if (!match)
50
+ return null;
51
+ const body = match[1];
52
+ if (!body)
53
+ return {};
54
+ const out = {};
55
+ for (const line of body.split('\n')) {
56
+ const trimmed = line.trim();
57
+ if (!trimmed || trimmed.startsWith('#'))
58
+ continue;
59
+ const idx = trimmed.indexOf(':');
60
+ if (idx <= 0)
61
+ continue;
62
+ const key = trimmed.slice(0, idx).trim();
63
+ const value = trimmed.slice(idx + 1).trim();
64
+ out[key] = value.replace(/^["']|["']$/g, '');
65
+ }
66
+ return out;
67
+ }
68
+ //# sourceMappingURL=skillsValidation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skillsValidation.js","sourceRoot":"","sources":["../../src/core/skillsValidation.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEpC,MAAM,aAAa,GAAG,yCAAyC,CAAA;AAE/D,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,SAAiB;IAC7D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IAE7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IACjE,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAQ;QAClC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAA;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;QAC3D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,wBAAwB,CAAC,CAAA;YACxD,SAAQ;QACV,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QAC7C,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;QAC3C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,4BAA4B,CAAC,CAAA;YAC5D,SAAQ;QACV,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,CAAA;QACrC,MAAM,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,IAAI,EAAE,CAAA;QAEnD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,iDAAiD,CAAC,CAAA;QACnF,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,kCAAkC,IAAI,IAAI,CAAC,CAAA;YAC5E,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,4BAA4B,CAAC,CAAA;YAC9D,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,wDAAwD,CAAC,CAAA;QAC1F,CAAC;aAAM,IAAI,WAAW,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,UAAU,OAAO,8CAA8C,CAAC,CAAA;QAChF,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACrB,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IAEpB,MAAM,GAAG,GAA2B,EAAE,CAAA;IACtC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAQ;QACjD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,GAAG,IAAI,CAAC;YAAE,SAAQ;QACtB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC3C,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { SyncOptions, SyncResult } from '../types.js';
2
+ export declare function performSync(options: SyncOptions): Promise<SyncResult>;