@almyty/skills 1.0.12 → 1.0.14
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/dist/client.js +32 -2
- package/package.json +3 -3
- package/dist/__tests__/client.test.d.ts +0 -1
- package/dist/__tests__/client.test.js +0 -145
package/dist/client.js
CHANGED
|
@@ -148,18 +148,48 @@ export class AlmytyClient {
|
|
|
148
148
|
i++;
|
|
149
149
|
return t.slice(i).join('-');
|
|
150
150
|
};
|
|
151
|
+
// Mirror the server's skill-generator truncation when
|
|
152
|
+
// `${gateway}-${suffix}` exceeds 64 chars: drop kebab
|
|
153
|
+
// segments off the *head* of the suffix until the whole
|
|
154
|
+
// thing fits, falling back to a tail substring if a single
|
|
155
|
+
// segment is itself longer than the remaining budget. Cutting
|
|
156
|
+
// from the head keeps the unique tail of long method names
|
|
157
|
+
// (e.g. ~40 google-translate gRPC methods that all share a
|
|
158
|
+
// long prefix) addressable from the CLI.
|
|
159
|
+
const composeAndTruncate = (gw, suffix) => {
|
|
160
|
+
if (!gw)
|
|
161
|
+
return suffix;
|
|
162
|
+
const combined = `${gw}-${suffix}`;
|
|
163
|
+
if (combined.length <= 64)
|
|
164
|
+
return combined;
|
|
165
|
+
const room = 64 - gw.length - 1;
|
|
166
|
+
if (room <= 0)
|
|
167
|
+
return gw.slice(0, 64);
|
|
168
|
+
const segments = suffix.split('-').filter(Boolean);
|
|
169
|
+
let trimmed = segments.join('-');
|
|
170
|
+
while (trimmed.length > room && segments.length > 1) {
|
|
171
|
+
segments.shift();
|
|
172
|
+
trimmed = segments.join('-');
|
|
173
|
+
}
|
|
174
|
+
if (trimmed.length > room)
|
|
175
|
+
trimmed = trimmed.slice(-room);
|
|
176
|
+
return `${gw}-${trimmed.replace(/^-+|-+$/g, '')}`;
|
|
177
|
+
};
|
|
151
178
|
const match = allTools.find((gt) => {
|
|
152
179
|
const t = gt.tool || gt;
|
|
153
180
|
if (!t)
|
|
154
181
|
return false;
|
|
155
182
|
const rawName = t.name || '';
|
|
156
183
|
const slug = slugify(rawName);
|
|
184
|
+
const dedupedSuffix = dedupeShared(gatewaySlug, slug);
|
|
157
185
|
const composed = gatewaySlug
|
|
158
|
-
? `${gatewaySlug}-${
|
|
186
|
+
? `${gatewaySlug}-${dedupedSuffix}`
|
|
159
187
|
: slug;
|
|
188
|
+
const truncated = composeAndTruncate(gatewaySlug, dedupedSuffix);
|
|
160
189
|
return (rawName === toolId ||
|
|
161
190
|
slug === toolId ||
|
|
162
|
-
composed === toolId
|
|
191
|
+
composed === toolId ||
|
|
192
|
+
truncated === toolId);
|
|
163
193
|
});
|
|
164
194
|
if (!match) {
|
|
165
195
|
throw new Error(`Tool "${toolId}" not found in gateway ${gatewayId}`);
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@almyty/skills",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "Install API skills into AI coding agents
|
|
3
|
+
"version": "1.0.14",
|
|
4
|
+
"description": "Install API skills into AI coding agents — Claude Code, Cursor, Windsurf, Copilot, Codex",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"bin": {
|
|
@@ -41,4 +41,4 @@
|
|
|
41
41
|
"typescript": "^5.3.0",
|
|
42
42
|
"vitest": "^4.1.0"
|
|
43
43
|
}
|
|
44
|
-
}
|
|
44
|
+
}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export {};
|
|
@@ -1,145 +0,0 @@
|
|
|
1
|
-
import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
|
|
2
|
-
import { parseRef } from '../client.js';
|
|
3
|
-
import { generateMetaSkill } from '../meta-skill.js';
|
|
4
|
-
import { loadConfig } from '../config.js';
|
|
5
|
-
// ---------------------------------------------------------------------------
|
|
6
|
-
// parseRef()
|
|
7
|
-
// ---------------------------------------------------------------------------
|
|
8
|
-
describe('parseRef', () => {
|
|
9
|
-
it('parses @org/gateway as a gateway ref', () => {
|
|
10
|
-
const result = parseRef('@org/gateway');
|
|
11
|
-
expect(result).toEqual({
|
|
12
|
-
type: 'gateway',
|
|
13
|
-
orgSlug: 'org',
|
|
14
|
-
gatewaySlug: 'gateway',
|
|
15
|
-
raw: '@org/gateway',
|
|
16
|
-
});
|
|
17
|
-
});
|
|
18
|
-
it('parses @org/gateway/skill as a skill ref', () => {
|
|
19
|
-
const result = parseRef('@org/gateway/skill');
|
|
20
|
-
expect(result).toEqual({
|
|
21
|
-
type: 'skill',
|
|
22
|
-
orgSlug: 'org',
|
|
23
|
-
gatewaySlug: 'gateway',
|
|
24
|
-
skillName: 'skill',
|
|
25
|
-
raw: '@org/gateway/skill',
|
|
26
|
-
});
|
|
27
|
-
});
|
|
28
|
-
it('parses a UUID string as a uuid ref', () => {
|
|
29
|
-
const uuid = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
|
|
30
|
-
const result = parseRef(uuid);
|
|
31
|
-
expect(result).toEqual({
|
|
32
|
-
type: 'uuid',
|
|
33
|
-
uuid,
|
|
34
|
-
raw: uuid,
|
|
35
|
-
});
|
|
36
|
-
});
|
|
37
|
-
it('parses uppercase UUID correctly', () => {
|
|
38
|
-
const uuid = 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890';
|
|
39
|
-
const result = parseRef(uuid);
|
|
40
|
-
expect(result.type).toBe('uuid');
|
|
41
|
-
expect(result.uuid).toBe(uuid);
|
|
42
|
-
});
|
|
43
|
-
it('returns search for a random string', () => {
|
|
44
|
-
const result = parseRef('some-random-query');
|
|
45
|
-
expect(result).toEqual({
|
|
46
|
-
type: 'search',
|
|
47
|
-
raw: 'some-random-query',
|
|
48
|
-
});
|
|
49
|
-
});
|
|
50
|
-
it('returns search for an empty string', () => {
|
|
51
|
-
const result = parseRef('');
|
|
52
|
-
expect(result).toEqual({
|
|
53
|
-
type: 'search',
|
|
54
|
-
raw: '',
|
|
55
|
-
});
|
|
56
|
-
});
|
|
57
|
-
it('returns search for @ with only one segment', () => {
|
|
58
|
-
const result = parseRef('@org');
|
|
59
|
-
expect(result).toEqual({
|
|
60
|
-
type: 'search',
|
|
61
|
-
raw: '@org',
|
|
62
|
-
});
|
|
63
|
-
});
|
|
64
|
-
it('returns search for @ with more than three segments', () => {
|
|
65
|
-
const result = parseRef('@org/gw/skill/extra');
|
|
66
|
-
expect(result).toEqual({
|
|
67
|
-
type: 'search',
|
|
68
|
-
raw: '@org/gw/skill/extra',
|
|
69
|
-
});
|
|
70
|
-
});
|
|
71
|
-
});
|
|
72
|
-
// ---------------------------------------------------------------------------
|
|
73
|
-
// generateMetaSkill()
|
|
74
|
-
// ---------------------------------------------------------------------------
|
|
75
|
-
describe('generateMetaSkill', () => {
|
|
76
|
-
it('returns a SkillFile with name "skills" and fileName "almyty-skills"', () => {
|
|
77
|
-
const skill = generateMetaSkill();
|
|
78
|
-
expect(skill.name).toBe('skills');
|
|
79
|
-
expect(skill.fileName).toBe('almyty-skills');
|
|
80
|
-
});
|
|
81
|
-
it('content includes npx @almyty/skills commands', () => {
|
|
82
|
-
const { content } = generateMetaSkill();
|
|
83
|
-
expect(content).toContain('npx @almyty/skills');
|
|
84
|
-
});
|
|
85
|
-
it('content references daemon command', () => {
|
|
86
|
-
const { content } = generateMetaSkill();
|
|
87
|
-
expect(content).toContain('daemon');
|
|
88
|
-
});
|
|
89
|
-
it('content references search command', () => {
|
|
90
|
-
const { content } = generateMetaSkill();
|
|
91
|
-
expect(content).toContain('search');
|
|
92
|
-
});
|
|
93
|
-
it('content references install command', () => {
|
|
94
|
-
const { content } = generateMetaSkill();
|
|
95
|
-
expect(content).toContain('install');
|
|
96
|
-
});
|
|
97
|
-
it('content references run command', () => {
|
|
98
|
-
const { content } = generateMetaSkill();
|
|
99
|
-
expect(content).toContain('run');
|
|
100
|
-
});
|
|
101
|
-
it('content includes SKILL.md front-matter', () => {
|
|
102
|
-
const { content } = generateMetaSkill();
|
|
103
|
-
expect(content).toContain('---');
|
|
104
|
-
expect(content).toContain('name: almyty-skills');
|
|
105
|
-
expect(content).toContain('description:');
|
|
106
|
-
});
|
|
107
|
-
});
|
|
108
|
-
// ---------------------------------------------------------------------------
|
|
109
|
-
// loadConfig()
|
|
110
|
-
// ---------------------------------------------------------------------------
|
|
111
|
-
describe('loadConfig', () => {
|
|
112
|
-
const originalEnv = process.env;
|
|
113
|
-
beforeEach(() => {
|
|
114
|
-
// Reset env between tests
|
|
115
|
-
process.env = { ...originalEnv };
|
|
116
|
-
delete process.env.APIFAI_SKILLS_DIR;
|
|
117
|
-
});
|
|
118
|
-
afterEach(() => {
|
|
119
|
-
process.env = originalEnv;
|
|
120
|
-
vi.restoreAllMocks();
|
|
121
|
-
});
|
|
122
|
-
it('returns empty config when no .almytyrc exists and no env var', () => {
|
|
123
|
-
// Use a temp directory that definitely has no .almytyrc
|
|
124
|
-
const config = loadConfig('/tmp/nonexistent-dir-' + Date.now());
|
|
125
|
-
expect(config).toEqual({});
|
|
126
|
-
});
|
|
127
|
-
it('uses APIFAI_SKILLS_DIR env var when set', () => {
|
|
128
|
-
process.env.APIFAI_SKILLS_DIR = '/custom/skills/dir';
|
|
129
|
-
const config = loadConfig();
|
|
130
|
-
expect(config).toEqual({ skillsDir: '/custom/skills/dir' });
|
|
131
|
-
});
|
|
132
|
-
it('env var takes precedence over .almytyrc files', () => {
|
|
133
|
-
process.env.APIFAI_SKILLS_DIR = '/env/override';
|
|
134
|
-
// Even if we pass a projectDir, env should take priority
|
|
135
|
-
const config = loadConfig('/some/project');
|
|
136
|
-
expect(config.skillsDir).toBe('/env/override');
|
|
137
|
-
});
|
|
138
|
-
it('returns empty config for a directory with no rc file and no home rc', () => {
|
|
139
|
-
// Use a deeply nested temp path that certainly has no .almytyrc anywhere
|
|
140
|
-
// and also won't match ~/.almytyrc (already handled by the missing file)
|
|
141
|
-
const fakePath = `/tmp/almyty-test-${Date.now()}/deeply/nested/project`;
|
|
142
|
-
const config = loadConfig(fakePath);
|
|
143
|
-
expect(config).toEqual({});
|
|
144
|
-
});
|
|
145
|
-
});
|