@matimo/core 0.1.0-alpha.12.1 → 0.1.0-alpha.13
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 +169 -8
- package/dist/approval/approval-handler.d.ts +5 -1
- package/dist/approval/approval-handler.d.ts.map +1 -1
- package/dist/approval/approval-handler.js +6 -0
- package/dist/approval/approval-handler.js.map +1 -1
- package/dist/core/schema.d.ts +29 -8
- package/dist/core/schema.d.ts.map +1 -1
- package/dist/core/schema.js +10 -3
- package/dist/core/schema.js.map +1 -1
- package/dist/core/skill-content-parser.d.ts +91 -0
- package/dist/core/skill-content-parser.d.ts.map +1 -0
- package/dist/core/skill-content-parser.js +248 -0
- package/dist/core/skill-content-parser.js.map +1 -0
- package/dist/core/skill-loader.d.ts +46 -0
- package/dist/core/skill-loader.d.ts.map +1 -0
- package/dist/core/skill-loader.js +310 -0
- package/dist/core/skill-loader.js.map +1 -0
- package/dist/core/skill-registry.d.ts +131 -0
- package/dist/core/skill-registry.d.ts.map +1 -0
- package/dist/core/skill-registry.js +316 -0
- package/dist/core/skill-registry.js.map +1 -0
- package/dist/core/tfidf-embedding.d.ts +45 -0
- package/dist/core/tfidf-embedding.d.ts.map +1 -0
- package/dist/core/tfidf-embedding.js +199 -0
- package/dist/core/tfidf-embedding.js.map +1 -0
- package/dist/core/types.d.ts +155 -6
- package/dist/core/types.d.ts.map +1 -1
- package/dist/errors/matimo-error.d.ts +3 -1
- package/dist/errors/matimo-error.d.ts.map +1 -1
- package/dist/errors/matimo-error.js +2 -0
- package/dist/errors/matimo-error.js.map +1 -1
- package/dist/index.d.ts +20 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +14 -1
- package/dist/index.js.map +1 -1
- package/dist/integrations/langchain.d.ts +55 -0
- package/dist/integrations/langchain.d.ts.map +1 -1
- package/dist/integrations/langchain.js +66 -0
- package/dist/integrations/langchain.js.map +1 -1
- package/dist/logging/winston-logger.d.ts.map +1 -1
- package/dist/logging/winston-logger.js +9 -1
- package/dist/logging/winston-logger.js.map +1 -1
- package/dist/matimo-instance.d.ts +171 -6
- package/dist/matimo-instance.d.ts.map +1 -1
- package/dist/matimo-instance.js +602 -13
- package/dist/matimo-instance.js.map +1 -1
- package/dist/mcp/mcp-server.d.ts +23 -0
- package/dist/mcp/mcp-server.d.ts.map +1 -1
- package/dist/mcp/mcp-server.js +119 -8
- package/dist/mcp/mcp-server.js.map +1 -1
- package/dist/mcp/tool-converter.d.ts.map +1 -1
- package/dist/mcp/tool-converter.js +10 -1
- package/dist/mcp/tool-converter.js.map +1 -1
- package/dist/policy/approval-manifest.d.ts +74 -0
- package/dist/policy/approval-manifest.d.ts.map +1 -0
- package/dist/policy/approval-manifest.js +178 -0
- package/dist/policy/approval-manifest.js.map +1 -0
- package/dist/policy/content-validator.d.ts +19 -0
- package/dist/policy/content-validator.d.ts.map +1 -0
- package/dist/policy/content-validator.js +196 -0
- package/dist/policy/content-validator.js.map +1 -0
- package/dist/policy/default-policy.d.ts +46 -0
- package/dist/policy/default-policy.d.ts.map +1 -0
- package/dist/policy/default-policy.js +241 -0
- package/dist/policy/default-policy.js.map +1 -0
- package/dist/policy/events.d.ts +71 -0
- package/dist/policy/events.d.ts.map +1 -0
- package/dist/policy/events.js +8 -0
- package/dist/policy/events.js.map +1 -0
- package/dist/policy/index.d.ts +13 -0
- package/dist/policy/index.d.ts.map +1 -0
- package/dist/policy/index.js +9 -0
- package/dist/policy/index.js.map +1 -0
- package/dist/policy/integrity-tracker.d.ts +62 -0
- package/dist/policy/integrity-tracker.d.ts.map +1 -0
- package/dist/policy/integrity-tracker.js +79 -0
- package/dist/policy/integrity-tracker.js.map +1 -0
- package/dist/policy/policy-loader.d.ts +58 -0
- package/dist/policy/policy-loader.d.ts.map +1 -0
- package/dist/policy/policy-loader.js +153 -0
- package/dist/policy/policy-loader.js.map +1 -0
- package/dist/policy/risk-classifier.d.ts +18 -0
- package/dist/policy/risk-classifier.d.ts.map +1 -0
- package/dist/policy/risk-classifier.js +43 -0
- package/dist/policy/risk-classifier.js.map +1 -0
- package/dist/policy/types.d.ts +126 -0
- package/dist/policy/types.d.ts.map +1 -0
- package/dist/policy/types.js +8 -0
- package/dist/policy/types.js.map +1 -0
- package/package.json +2 -2
- package/tools/matimo_approve_tool/definition.yaml +36 -0
- package/tools/matimo_approve_tool/matimo_approve_tool.ts +90 -0
- package/tools/matimo_create_skill/definition.yaml +46 -0
- package/tools/matimo_create_skill/matimo_create_skill.ts +75 -0
- package/tools/matimo_create_tool/definition.yaml +48 -0
- package/tools/matimo_create_tool/matimo_create_tool.ts +137 -0
- package/tools/matimo_get_skill/definition.yaml +60 -0
- package/tools/matimo_get_skill/matimo_get_skill.ts +182 -0
- package/tools/matimo_get_tool_status/definition.yaml +42 -0
- package/tools/matimo_get_tool_status/matimo_get_tool_status.ts +101 -0
- package/tools/matimo_list_skills/definition.yaml +52 -0
- package/tools/matimo_list_skills/matimo_list_skills.ts +138 -0
- package/tools/matimo_list_user_tools/definition.yaml +32 -0
- package/tools/matimo_list_user_tools/matimo_list_user_tools.ts +74 -0
- package/tools/matimo_reload_tools/definition.yaml +35 -0
- package/tools/matimo_reload_tools/matimo_reload_tools.ts +29 -0
- package/tools/matimo_validate_skill/definition.yaml +43 -0
- package/tools/matimo_validate_skill/matimo_validate_skill.ts +137 -0
- package/tools/matimo_validate_tool/definition.yaml +34 -0
- package/tools/matimo_validate_tool/matimo_validate_tool.ts +168 -0
- package/tools/shared/skill-validation.ts +335 -0
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* TF-IDF Embedding Provider — zero-dependency semantic search
|
|
3
|
+
* (Term Frequency–Inverse Document Frequency)
|
|
4
|
+
* Provides a lightweight text-to-vector implementation using TF-IDF (Term
|
|
5
|
+
* Frequency–Inverse Document Frequency) for cosine-similarity ranking. This
|
|
6
|
+
* is good enough for 10–200 skills. For production enterprise deployments,
|
|
7
|
+
* plug in an OpenAI/Cohere `EmbeddingProvider` instead.
|
|
8
|
+
*
|
|
9
|
+
* No external dependencies — works out of the box.
|
|
10
|
+
*/
|
|
11
|
+
/**
|
|
12
|
+
* Simple TF-IDF based embedding provider.
|
|
13
|
+
* Builds a vocabulary from the registered corpus and represents each text as
|
|
14
|
+
* a TF-IDF weighted vector.
|
|
15
|
+
*/
|
|
16
|
+
export class TfIdfEmbeddingProvider {
|
|
17
|
+
constructor() {
|
|
18
|
+
this.vocabulary = new Map();
|
|
19
|
+
this.idf = new Float64Array(0);
|
|
20
|
+
this.corpusSize = 0;
|
|
21
|
+
this._dimensions = 0;
|
|
22
|
+
}
|
|
23
|
+
get dimensions() {
|
|
24
|
+
return this._dimensions;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Build the vocabulary and IDF weights from a corpus of documents.
|
|
28
|
+
* Must be called before `embed()` or `embedBatch()`.
|
|
29
|
+
*/
|
|
30
|
+
fit(documents) {
|
|
31
|
+
this.vocabulary.clear();
|
|
32
|
+
this.corpusSize = documents.length;
|
|
33
|
+
// Build vocabulary (unique terms across all documents)
|
|
34
|
+
const docFrequency = new Map();
|
|
35
|
+
for (const doc of documents) {
|
|
36
|
+
const terms = this.tokenize(doc);
|
|
37
|
+
const uniqueTerms = new Set(terms);
|
|
38
|
+
for (const term of uniqueTerms) {
|
|
39
|
+
docFrequency.set(term, (docFrequency.get(term) || 0) + 1);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
// Assign indices and compute IDF
|
|
43
|
+
let idx = 0;
|
|
44
|
+
const idfValues = [];
|
|
45
|
+
for (const [term, df] of docFrequency) {
|
|
46
|
+
this.vocabulary.set(term, idx++);
|
|
47
|
+
// Smooth IDF: log((N + 1) / (df + 1)) + 1
|
|
48
|
+
idfValues.push(Math.log((this.corpusSize + 1) / (df + 1)) + 1);
|
|
49
|
+
}
|
|
50
|
+
this._dimensions = idfValues.length;
|
|
51
|
+
this.idf = new Float64Array(idfValues);
|
|
52
|
+
}
|
|
53
|
+
async embed(text) {
|
|
54
|
+
return this.embedSync(text);
|
|
55
|
+
}
|
|
56
|
+
async embedBatch(texts) {
|
|
57
|
+
return texts.map((t) => this.embedSync(t));
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Synchronous embed for internal use (no async overhead).
|
|
61
|
+
*/
|
|
62
|
+
embedSync(text) {
|
|
63
|
+
if (this._dimensions === 0) {
|
|
64
|
+
return [];
|
|
65
|
+
}
|
|
66
|
+
const terms = this.tokenize(text);
|
|
67
|
+
const tf = new Float64Array(this._dimensions);
|
|
68
|
+
// Count term frequencies
|
|
69
|
+
for (const term of terms) {
|
|
70
|
+
const idx = this.vocabulary.get(term);
|
|
71
|
+
if (idx !== undefined) {
|
|
72
|
+
tf[idx]++;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
// Normalize TF (sublinear: 1 + log(tf) if tf > 0)
|
|
76
|
+
for (let i = 0; i < this._dimensions; i++) {
|
|
77
|
+
if (tf[i] > 0) {
|
|
78
|
+
tf[i] = (1 + Math.log(tf[i])) * this.idf[i];
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
// L2 normalize
|
|
82
|
+
let norm = 0;
|
|
83
|
+
for (let i = 0; i < this._dimensions; i++) {
|
|
84
|
+
norm += tf[i] * tf[i];
|
|
85
|
+
}
|
|
86
|
+
norm = Math.sqrt(norm);
|
|
87
|
+
if (norm > 0) {
|
|
88
|
+
for (let i = 0; i < this._dimensions; i++) {
|
|
89
|
+
tf[i] /= norm;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
return Array.from(tf);
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* Tokenize text into lowercase terms.
|
|
96
|
+
* Splits on non-alphanumeric characters and filters stopwords.
|
|
97
|
+
*/
|
|
98
|
+
tokenize(text) {
|
|
99
|
+
return text
|
|
100
|
+
.toLowerCase()
|
|
101
|
+
.split(/[^a-z0-9]+/)
|
|
102
|
+
.filter((t) => t.length > 1 && !STOPWORDS.has(t));
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Cosine similarity between two vectors.
|
|
107
|
+
* Returns a value between -1 and 1 (1 = identical, 0 = orthogonal).
|
|
108
|
+
*/
|
|
109
|
+
export function cosineSimilarity(a, b) {
|
|
110
|
+
if (a.length !== b.length || a.length === 0)
|
|
111
|
+
return 0;
|
|
112
|
+
let dot = 0;
|
|
113
|
+
let normA = 0;
|
|
114
|
+
let normB = 0;
|
|
115
|
+
for (let i = 0; i < a.length; i++) {
|
|
116
|
+
dot += a[i] * b[i];
|
|
117
|
+
normA += a[i] * a[i];
|
|
118
|
+
normB += b[i] * b[i];
|
|
119
|
+
}
|
|
120
|
+
const denominator = Math.sqrt(normA) * Math.sqrt(normB);
|
|
121
|
+
return denominator === 0 ? 0 : dot / denominator;
|
|
122
|
+
}
|
|
123
|
+
/** Common English stopwords to exclude from TF-IDF */
|
|
124
|
+
const STOPWORDS = new Set([
|
|
125
|
+
'a',
|
|
126
|
+
'an',
|
|
127
|
+
'the',
|
|
128
|
+
'and',
|
|
129
|
+
'or',
|
|
130
|
+
'but',
|
|
131
|
+
'in',
|
|
132
|
+
'on',
|
|
133
|
+
'at',
|
|
134
|
+
'to',
|
|
135
|
+
'for',
|
|
136
|
+
'of',
|
|
137
|
+
'with',
|
|
138
|
+
'by',
|
|
139
|
+
'from',
|
|
140
|
+
'is',
|
|
141
|
+
'it',
|
|
142
|
+
'as',
|
|
143
|
+
'be',
|
|
144
|
+
'was',
|
|
145
|
+
'are',
|
|
146
|
+
'this',
|
|
147
|
+
'that',
|
|
148
|
+
'not',
|
|
149
|
+
'do',
|
|
150
|
+
'if',
|
|
151
|
+
'so',
|
|
152
|
+
'no',
|
|
153
|
+
'up',
|
|
154
|
+
'my',
|
|
155
|
+
'we',
|
|
156
|
+
'he',
|
|
157
|
+
'she',
|
|
158
|
+
'they',
|
|
159
|
+
'you',
|
|
160
|
+
'me',
|
|
161
|
+
'us',
|
|
162
|
+
'all',
|
|
163
|
+
'can',
|
|
164
|
+
'had',
|
|
165
|
+
'has',
|
|
166
|
+
'have',
|
|
167
|
+
'will',
|
|
168
|
+
'would',
|
|
169
|
+
'could',
|
|
170
|
+
'should',
|
|
171
|
+
'may',
|
|
172
|
+
'might',
|
|
173
|
+
'shall',
|
|
174
|
+
'been',
|
|
175
|
+
'being',
|
|
176
|
+
'were',
|
|
177
|
+
'did',
|
|
178
|
+
'does',
|
|
179
|
+
'its',
|
|
180
|
+
'than',
|
|
181
|
+
'then',
|
|
182
|
+
'when',
|
|
183
|
+
'what',
|
|
184
|
+
'which',
|
|
185
|
+
'who',
|
|
186
|
+
'how',
|
|
187
|
+
'there',
|
|
188
|
+
'here',
|
|
189
|
+
'about',
|
|
190
|
+
'into',
|
|
191
|
+
'over',
|
|
192
|
+
'after',
|
|
193
|
+
'also',
|
|
194
|
+
'each',
|
|
195
|
+
'just',
|
|
196
|
+
'only',
|
|
197
|
+
'very',
|
|
198
|
+
]);
|
|
199
|
+
//# sourceMappingURL=tfidf-embedding.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tfidf-embedding.js","sourceRoot":"","sources":["../../src/core/tfidf-embedding.ts"],"names":[],"mappings":"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"}
|
package/dist/core/types.d.ts
CHANGED
|
@@ -18,7 +18,7 @@ export interface Parameter {
|
|
|
18
18
|
* Authentication configuration for a tool
|
|
19
19
|
*/
|
|
20
20
|
export interface AuthConfig {
|
|
21
|
-
type
|
|
21
|
+
type?: 'none' | 'api_key' | 'oauth2' | 'basic' | 'bearer' | 'custom';
|
|
22
22
|
location?: 'header' | 'query' | 'body';
|
|
23
23
|
name?: string;
|
|
24
24
|
scheme?: string;
|
|
@@ -42,7 +42,7 @@ export interface HttpExecution {
|
|
|
42
42
|
method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
|
|
43
43
|
url: string;
|
|
44
44
|
headers?: Record<string, string>;
|
|
45
|
-
body?:
|
|
45
|
+
body?: unknown;
|
|
46
46
|
params?: Record<string, string>;
|
|
47
47
|
query_params?: Record<string, string>;
|
|
48
48
|
parameter_encoding?: ParameterEncodingConfig[];
|
|
@@ -70,12 +70,15 @@ export interface FunctionExecution {
|
|
|
70
70
|
timeout?: number;
|
|
71
71
|
}
|
|
72
72
|
/**
|
|
73
|
-
* Output schema for tool response validation
|
|
73
|
+
* Output schema for tool response validation.
|
|
74
|
+
* TypeScript interface inferred from Zod schema in schema.ts.
|
|
75
|
+
* Properties allows nested output schemas or any unknown structure for flexibility.
|
|
74
76
|
*/
|
|
75
77
|
export interface OutputSchema {
|
|
76
|
-
type
|
|
77
|
-
properties?: Record<string,
|
|
78
|
+
type?: string;
|
|
79
|
+
properties?: Record<string, unknown>;
|
|
78
80
|
items?: OutputSchema;
|
|
81
|
+
required?: string[];
|
|
79
82
|
description?: string;
|
|
80
83
|
}
|
|
81
84
|
/**
|
|
@@ -111,7 +114,7 @@ export interface ToolDefinition {
|
|
|
111
114
|
name: string;
|
|
112
115
|
version: string;
|
|
113
116
|
description: string;
|
|
114
|
-
parameters
|
|
117
|
+
parameters?: Record<string, Parameter>;
|
|
115
118
|
execution: HttpExecution | CommandExecution | FunctionExecution;
|
|
116
119
|
authentication?: AuthConfig;
|
|
117
120
|
output_schema?: OutputSchema;
|
|
@@ -126,6 +129,13 @@ export interface ToolDefinition {
|
|
|
126
129
|
* Set to true for destructive operations (CREATE, DELETE, DROP, etc.)
|
|
127
130
|
*/
|
|
128
131
|
requires_approval?: boolean;
|
|
132
|
+
/**
|
|
133
|
+
* Tool lifecycle status. Tools without a status are treated as 'approved'.
|
|
134
|
+
* - draft: Agent-created, not yet human-reviewed
|
|
135
|
+
* - approved: Human-reviewed and ready for use
|
|
136
|
+
* - deprecated: Scheduled for removal
|
|
137
|
+
*/
|
|
138
|
+
status?: 'draft' | 'approved' | 'deprecated';
|
|
129
139
|
/**
|
|
130
140
|
* Internal: Path to the tool definition file (set by ToolLoader)
|
|
131
141
|
* Used to resolve relative paths for function executors
|
|
@@ -206,5 +216,144 @@ export interface ExecuteOptions {
|
|
|
206
216
|
* duration of the execute() call.
|
|
207
217
|
*/
|
|
208
218
|
credentials?: Record<string, string>;
|
|
219
|
+
/**
|
|
220
|
+
* Policy context for the current execution. When a PolicyEngine is active,
|
|
221
|
+
* this context is checked against the tool's requirements before execution.
|
|
222
|
+
*/
|
|
223
|
+
context?: import('../policy/types').PolicyContext;
|
|
224
|
+
/**
|
|
225
|
+
* Skip approval check for this execution. Use when the caller (e.g., MCP layer)
|
|
226
|
+
* has already confirmed approval out-of-band, to avoid re-prompting the user.
|
|
227
|
+
* Does not override policy-level quarantine checks (pending_approval state).
|
|
228
|
+
* Default: false
|
|
229
|
+
*/
|
|
230
|
+
approved?: boolean;
|
|
231
|
+
}
|
|
232
|
+
/**
|
|
233
|
+
* Bundled resources within a skill directory (scripts, references, assets)
|
|
234
|
+
*/
|
|
235
|
+
export interface BundledResources {
|
|
236
|
+
scripts: string[];
|
|
237
|
+
references: string[];
|
|
238
|
+
assets: string[];
|
|
239
|
+
other: string[];
|
|
240
|
+
}
|
|
241
|
+
/**
|
|
242
|
+
* YAML frontmatter for a SKILL.md file
|
|
243
|
+
* Follows agentskills.io/specification
|
|
244
|
+
*/
|
|
245
|
+
export interface SkillFrontmatter {
|
|
246
|
+
name: string;
|
|
247
|
+
description: string;
|
|
248
|
+
version?: string;
|
|
249
|
+
license?: string;
|
|
250
|
+
compatibility?: string;
|
|
251
|
+
'allowed-tools'?: string | string[];
|
|
252
|
+
metadata?: Record<string, string>;
|
|
253
|
+
}
|
|
254
|
+
/**
|
|
255
|
+
* A single section of a skill body, parsed from Markdown headings.
|
|
256
|
+
*/
|
|
257
|
+
export interface SkillSection {
|
|
258
|
+
heading: string;
|
|
259
|
+
level: number;
|
|
260
|
+
content: string;
|
|
261
|
+
tokenEstimate: number;
|
|
262
|
+
children: SkillSection[];
|
|
263
|
+
path: string;
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* Parsed skill content (frontmatter + body + structured sections)
|
|
267
|
+
*/
|
|
268
|
+
export interface ParsedSkill {
|
|
269
|
+
frontmatter: SkillFrontmatter;
|
|
270
|
+
body: string;
|
|
271
|
+
raw: string;
|
|
272
|
+
sections?: SkillSection[];
|
|
273
|
+
totalTokens?: number;
|
|
274
|
+
}
|
|
275
|
+
/**
|
|
276
|
+
* Catalog metadata for a skill (download count, rating, etc.)
|
|
277
|
+
*/
|
|
278
|
+
export interface SkillCatalogInfo {
|
|
279
|
+
author: string;
|
|
280
|
+
downloads: number;
|
|
281
|
+
rating: number;
|
|
282
|
+
tags: string[];
|
|
283
|
+
publishedAt: string;
|
|
284
|
+
updatedAt: string;
|
|
285
|
+
repository?: string;
|
|
286
|
+
checksum?: string;
|
|
287
|
+
}
|
|
288
|
+
/**
|
|
289
|
+
* Complete skill definition
|
|
290
|
+
* Implements agentskills.io specification with Matimo extensions
|
|
291
|
+
*/
|
|
292
|
+
export interface SkillDefinition {
|
|
293
|
+
name: string;
|
|
294
|
+
description: string;
|
|
295
|
+
version?: string;
|
|
296
|
+
license?: string;
|
|
297
|
+
compatibility?: string;
|
|
298
|
+
allowedTools?: string[];
|
|
299
|
+
metadata?: Record<string, string>;
|
|
300
|
+
body: string;
|
|
301
|
+
/** Structured sections parsed from Markdown headings */
|
|
302
|
+
sections?: SkillSection[];
|
|
303
|
+
/** Approximate total token count for the skill body */
|
|
304
|
+
totalTokens?: number;
|
|
305
|
+
resources: BundledResources;
|
|
306
|
+
source: 'builtin' | 'user' | 'catalog';
|
|
307
|
+
_path?: string;
|
|
308
|
+
catalogInfo?: SkillCatalogInfo;
|
|
309
|
+
dependsOn?: string[];
|
|
310
|
+
}
|
|
311
|
+
/**
|
|
312
|
+
* Skill summary for discovery (Level 1 - minimal context)
|
|
313
|
+
*/
|
|
314
|
+
export interface SkillSummary {
|
|
315
|
+
name: string;
|
|
316
|
+
description: string;
|
|
317
|
+
version?: string;
|
|
318
|
+
license?: string;
|
|
319
|
+
metadata?: Record<string, string>;
|
|
320
|
+
source: 'builtin' | 'user' | 'catalog';
|
|
321
|
+
}
|
|
322
|
+
/**
|
|
323
|
+
* Options for searching skills
|
|
324
|
+
*/
|
|
325
|
+
export interface SearchSkillsOptions {
|
|
326
|
+
query?: string;
|
|
327
|
+
category?: string;
|
|
328
|
+
difficulty?: string;
|
|
329
|
+
tags?: string[];
|
|
330
|
+
author?: string;
|
|
331
|
+
limit?: number;
|
|
332
|
+
offset?: number;
|
|
333
|
+
/** Use semantic search via embeddings (requires an EmbeddingProvider) */
|
|
334
|
+
semantic?: boolean;
|
|
335
|
+
}
|
|
336
|
+
/**
|
|
337
|
+
* Options for selective skill content loading
|
|
338
|
+
*/
|
|
339
|
+
export interface SkillContentOptions {
|
|
340
|
+
/** Only return sections matching these headings (case-insensitive partial match) */
|
|
341
|
+
sections?: string[];
|
|
342
|
+
/** Maximum total tokens to return */
|
|
343
|
+
maxTokens?: number;
|
|
344
|
+
/** Include the preamble (default: true) */
|
|
345
|
+
includePreamble?: boolean;
|
|
346
|
+
/** Depth limit for section inclusion (1 = top-level only) */
|
|
347
|
+
maxDepth?: number;
|
|
348
|
+
}
|
|
349
|
+
/**
|
|
350
|
+
* Pluggable embedding provider for semantic skill search.
|
|
351
|
+
* Implement this interface to connect to OpenAI, Cohere, local models, etc.
|
|
352
|
+
*/
|
|
353
|
+
export interface EmbeddingProvider {
|
|
354
|
+
embed(text: string): Promise<number[]>;
|
|
355
|
+
embedBatch(texts: string[]): Promise<number[][]>;
|
|
356
|
+
/** Embedding dimensionality */
|
|
357
|
+
dimensions: number;
|
|
209
358
|
}
|
|
210
359
|
//# sourceMappingURL=types.d.ts.map
|
package/dist/core/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -12,7 +12,9 @@ export declare enum ErrorCode {
|
|
|
12
12
|
TIMEOUT = "TIMEOUT",
|
|
13
13
|
NETWORK_ERROR = "NETWORK_ERROR",
|
|
14
14
|
INVALID_PARAMETER = "INVALID_PARAMETER",
|
|
15
|
-
UNKNOWN_ERROR = "UNKNOWN_ERROR"
|
|
15
|
+
UNKNOWN_ERROR = "UNKNOWN_ERROR",
|
|
16
|
+
POLICY_DENIED = "POLICY_DENIED",
|
|
17
|
+
POLICY_TIER_BLOCKED = "POLICY_TIER_BLOCKED"
|
|
16
18
|
}
|
|
17
19
|
/**
|
|
18
20
|
* Custom error class for Matimo
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"matimo-error.d.ts","sourceRoot":"","sources":["../../src/errors/matimo-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IACnB,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;
|
|
1
|
+
{"version":3,"file":"matimo-error.d.ts","sourceRoot":"","sources":["../../src/errors/matimo-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IACnB,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,mBAAmB,wBAAwB;IAC3C,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,mBAAmB,wBAAwB;CAC5C;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAK3B,IAAI,EAAE,SAAS;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IALnC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EACxC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO;IAOzB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYlC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,SAAwB,eAW5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW,CAEb"}
|
|
@@ -14,6 +14,8 @@ export var ErrorCode;
|
|
|
14
14
|
ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
|
|
15
15
|
ErrorCode["INVALID_PARAMETER"] = "INVALID_PARAMETER";
|
|
16
16
|
ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
|
|
17
|
+
ErrorCode["POLICY_DENIED"] = "POLICY_DENIED";
|
|
18
|
+
ErrorCode["POLICY_TIER_BLOCKED"] = "POLICY_TIER_BLOCKED";
|
|
17
19
|
})(ErrorCode || (ErrorCode = {}));
|
|
18
20
|
/**
|
|
19
21
|
* Custom error class for Matimo
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"matimo-error.js","sourceRoot":"","sources":["../../src/errors/matimo-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,
|
|
1
|
+
{"version":3,"file":"matimo-error.js","sourceRoot":"","sources":["../../src/errors/matimo-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,SAcX;AAdD,WAAY,SAAS;IACnB,8CAAiC,CAAA;IACjC,kDAAqC,CAAA;IACrC,wCAA2B,CAAA;IAC3B,8CAAiC,CAAA;IACjC,8CAAiC,CAAA;IACjC,oDAAuC,CAAA;IACvC,wDAA2C,CAAA;IAC3C,gCAAmB,CAAA;IACnB,4CAA+B,CAAA;IAC/B,oDAAuC,CAAA;IACvC,4CAA+B,CAAA;IAC/B,4CAA+B,CAAA;IAC/B,wDAA2C,CAAA;AAC7C,CAAC,EAdW,SAAS,KAAT,SAAS,QAcpB;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGpC,YACE,OAAe,EACR,IAAe,EACf,OAAiC,EACxC,KAAuB;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAW;QACf,YAAO,GAAP,OAAO,CAA0B;QAIxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EACH,IAAI,CAAC,KAAK,YAAY,KAAK;gBACzB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;gBACxD,CAAC,CAAC,IAAI,CAAC,KAAK;SACjB,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,OAAO,GAAG,qBAAqB;IAC3E,8CAA8C;IAC9C,MAAM,KAAK,GAAG,KAA4C,CAAC;IAC3D,MAAM,QAAQ,GAAG,KAAK,EAAE,QAA+C,CAAC;IACxE,MAAM,UAAU,GAAI,QAAQ,EAAE,MAA6B,IAAI,GAAG,CAAC;IACnE,MAAM,OAAO,GAAG,QAAQ,EAAE,IAA2C,CAAC;IACtE,MAAM,IAAI,GAA4B,EAAE,UAAU,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAClD,oFAAoF;IACpF,IAAI,CAAC,aAAa,GAAG,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC3D,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,gBAAgB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,OAAiC;IAEjC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,OAAiC;IAEjC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -4,10 +4,17 @@
|
|
|
4
4
|
* Framework-agnostic SDK that enables any developer to integrate 1000+ tools
|
|
5
5
|
* across any AI framework (LangChain, CrewAI, Anthropic SDK, etc.).
|
|
6
6
|
*/
|
|
7
|
-
export type { Parameter, AuthConfig, HttpExecution, CommandExecution, FunctionExecution, OutputSchema, RateLimitConfig, ErrorHandlingConfig, ToolDefinition, ExecuteOptions, } from './core/types';
|
|
7
|
+
export type { Parameter, AuthConfig, HttpExecution, CommandExecution, FunctionExecution, OutputSchema, RateLimitConfig, ErrorHandlingConfig, ToolDefinition, ExecuteOptions, SkillDefinition, SkillFrontmatter, ParsedSkill, SkillSummary, SearchSkillsOptions, BundledResources, SkillCatalogInfo, SkillSection, SkillContentOptions, EmbeddingProvider, } from './core/types';
|
|
8
8
|
export { ParameterSchema, AuthConfigSchema, ExecutionConfigSchema } from './core/schema';
|
|
9
9
|
export { ToolLoader } from './core/tool-loader';
|
|
10
10
|
export { ToolRegistry } from './core/tool-registry';
|
|
11
|
+
export { SkillLoader } from './core/skill-loader';
|
|
12
|
+
export { SkillRegistry } from './core/skill-registry';
|
|
13
|
+
export type { SemanticSearchResult } from './core/skill-registry';
|
|
14
|
+
export { parseSkillSections, extractSkillContent, listSkillSections, } from './core/skill-content-parser';
|
|
15
|
+
export { extractSkillMetadata } from './core/skill-loader';
|
|
16
|
+
export type { ParsedSkillContent } from './core/skill-content-parser';
|
|
17
|
+
export { TfIdfEmbeddingProvider, cosineSimilarity } from './core/tfidf-embedding';
|
|
11
18
|
export { CommandExecutor } from './executors/command-executor';
|
|
12
19
|
export { HttpExecutor } from './executors/http-executor';
|
|
13
20
|
export { FunctionExecutor } from './executors/function-executor';
|
|
@@ -23,8 +30,18 @@ export type { OAuth2Provider, OAuth2Token, OAuth2Config, AuthorizationOptions, T
|
|
|
23
30
|
export type { ProviderDefinition } from './core/schema';
|
|
24
31
|
export { OAuth2ProviderLoader } from './auth/oauth2-provider-loader';
|
|
25
32
|
export { OAuth2Handler } from './auth/oauth2-handler';
|
|
26
|
-
export { convertToolsToLangChain } from './integrations/langchain';
|
|
27
|
-
export type { LangChainTool } from './integrations/langchain';
|
|
33
|
+
export { convertToolsToLangChain, getSkillsMetadata, buildRelevantSkillPrompt, } from './integrations/langchain';
|
|
34
|
+
export type { LangChainTool, SkillContext } from './integrations/langchain';
|
|
35
|
+
export type { PolicyEngine, PolicyContext, PolicyDecision, PolicyConfig, PolicyTier, RiskLevel, Violation, ValidationResult, ValidationContext, HITLCallback, HITLRequest, } from './policy/types';
|
|
36
|
+
export { DefaultPolicyEngine, getTierForTool } from './policy/default-policy';
|
|
37
|
+
export { validateToolContent, isSSRFTarget } from './policy/content-validator';
|
|
38
|
+
export { classifyRisk } from './policy/risk-classifier';
|
|
39
|
+
export { ToolIntegrityTracker } from './policy/integrity-tracker';
|
|
40
|
+
export { ApprovalManifest } from './policy/approval-manifest';
|
|
41
|
+
export { loadPolicyFromFile, parsePolicyFile } from './policy/policy-loader';
|
|
42
|
+
export type { MatimoEvent, MatimoEventHandler } from './policy/events';
|
|
43
|
+
export { ToolDefinitionSchema, validateToolDefinition } from './core/schema';
|
|
44
|
+
export type { ReloadResult } from './matimo-instance';
|
|
28
45
|
export { ApprovalHandler, getGlobalApprovalHandler } from './approval/approval-handler';
|
|
29
46
|
export type { ApprovalRequest, ApprovalCallback } from './approval/approval-handler';
|
|
30
47
|
export { MCPServer, createMCPServer } from './mcp/index';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,cAAc,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -7,6 +7,11 @@
|
|
|
7
7
|
export { ParameterSchema, AuthConfigSchema, ExecutionConfigSchema } from './core/schema';
|
|
8
8
|
export { ToolLoader } from './core/tool-loader';
|
|
9
9
|
export { ToolRegistry } from './core/tool-registry';
|
|
10
|
+
export { SkillLoader } from './core/skill-loader';
|
|
11
|
+
export { SkillRegistry } from './core/skill-registry';
|
|
12
|
+
export { parseSkillSections, extractSkillContent, listSkillSections, } from './core/skill-content-parser';
|
|
13
|
+
export { extractSkillMetadata } from './core/skill-loader';
|
|
14
|
+
export { TfIdfEmbeddingProvider, cosineSimilarity } from './core/tfidf-embedding';
|
|
10
15
|
// Executors
|
|
11
16
|
export { CommandExecutor } from './executors/command-executor';
|
|
12
17
|
export { HttpExecutor } from './executors/http-executor';
|
|
@@ -25,7 +30,15 @@ export { MatimoInstance, matimo } from './matimo-instance';
|
|
|
25
30
|
export { OAuth2ProviderLoader } from './auth/oauth2-provider-loader';
|
|
26
31
|
export { OAuth2Handler } from './auth/oauth2-handler';
|
|
27
32
|
// LangChain integration
|
|
28
|
-
export { convertToolsToLangChain } from './integrations/langchain';
|
|
33
|
+
export { convertToolsToLangChain, getSkillsMetadata, buildRelevantSkillPrompt, } from './integrations/langchain';
|
|
34
|
+
export { DefaultPolicyEngine, getTierForTool } from './policy/default-policy';
|
|
35
|
+
export { validateToolContent, isSSRFTarget } from './policy/content-validator';
|
|
36
|
+
export { classifyRisk } from './policy/risk-classifier';
|
|
37
|
+
export { ToolIntegrityTracker } from './policy/integrity-tracker';
|
|
38
|
+
export { ApprovalManifest } from './policy/approval-manifest';
|
|
39
|
+
export { loadPolicyFromFile, parsePolicyFile } from './policy/policy-loader';
|
|
40
|
+
// Schema validation
|
|
41
|
+
export { ToolDefinitionSchema, validateToolDefinition } from './core/schema';
|
|
29
42
|
// Generic Approval System - Simple, scalable flow for any tool
|
|
30
43
|
// Tools declare requires_approval in YAML, or system detects destructive keywords
|
|
31
44
|
// Single approval callback handles all tools - no per-provider logic needed
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAElF,YAAY;AACZ,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,qBAAqB;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,aAAa;AACb,OAAO,EACL,IAAI,EACJ,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAErC,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,SAAS,EACT,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,UAAU;AACV,OAAO,EAIL,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7E,gCAAgC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAa3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,wBAAwB;AACxB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAqBlC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG7E,oBAAoB;AACpB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAK7E,+DAA+D;AAC/D,kFAAkF;AAClF,4EAA4E;AAC5E,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGxF,kDAAkD;AAClD,oEAAoE;AACpE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKzD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,aAAa,CAAC"}
|
|
@@ -43,4 +43,59 @@ export interface LangChainTool {
|
|
|
43
43
|
* ```
|
|
44
44
|
*/
|
|
45
45
|
export declare function convertToolsToLangChain(tools: ToolDefinition[], matimo: MatimoInstance, secrets?: Record<string, string>, secretParamNames?: Set<string>): Promise<LangChainTool[]>;
|
|
46
|
+
export interface SkillContext {
|
|
47
|
+
name: string;
|
|
48
|
+
description: string;
|
|
49
|
+
content: string;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Return Level 1 metadata (name + description) for all available skills.
|
|
53
|
+
*
|
|
54
|
+
* Token-safe — only a few lines per skill. Include this in the system prompt
|
|
55
|
+
* so the agent knows what skills exist and can request them by name, mirroring
|
|
56
|
+
* what `matimo_list_skills` does in the tool-based flow.
|
|
57
|
+
*
|
|
58
|
+
* @example
|
|
59
|
+
* ```ts
|
|
60
|
+
* const meta = getSkillsMetadata(matimo);
|
|
61
|
+
* // → [{ name: 'code-review', description: 'Code review checklist' }, ...]
|
|
62
|
+
* ```
|
|
63
|
+
*/
|
|
64
|
+
export declare function getSkillsMetadata(matimo: MatimoInstance): Array<{
|
|
65
|
+
name: string;
|
|
66
|
+
description: string;
|
|
67
|
+
}>;
|
|
68
|
+
/**
|
|
69
|
+
* Build a per-request system prompt snippet from semantically relevant skills.
|
|
70
|
+
*
|
|
71
|
+
* Uses TF-IDF semantic search (built-in, zero dependencies) to rank all skills
|
|
72
|
+
* against the user's query and loads full content only for the top matches.
|
|
73
|
+
* This preserves the progressive disclosure model without MCP:
|
|
74
|
+
*
|
|
75
|
+
* Level 1 at startup → Level 2 per-request (only relevant skills)
|
|
76
|
+
*
|
|
77
|
+
* @param matimo - Initialised MatimoInstance
|
|
78
|
+
* @param query - The user's current message/query; drives semantic ranking
|
|
79
|
+
* @param options.topK - Max skills to load (default 3); keeps token cost bounded
|
|
80
|
+
* @param options.minScore - Minimum cosine similarity to include (default 0.3)
|
|
81
|
+
* @param options.header - Custom header text (optional)
|
|
82
|
+
* @returns Formatted string ready to inject as a context block, or empty string
|
|
83
|
+
* when no skills score above `minScore`.
|
|
84
|
+
*
|
|
85
|
+
* @example
|
|
86
|
+
* ```ts
|
|
87
|
+
* // In your ReAct loop, per message:
|
|
88
|
+
* const skillContext = await buildRelevantSkillPrompt(matimo, userMessage, { topK: 2 });
|
|
89
|
+
* const messages = [
|
|
90
|
+
* new SystemMessage(baseSystemPrompt),
|
|
91
|
+
* ...(skillContext ? [new SystemMessage(skillContext)] : []),
|
|
92
|
+
* new HumanMessage(userMessage),
|
|
93
|
+
* ];
|
|
94
|
+
* ```
|
|
95
|
+
*/
|
|
96
|
+
export declare function buildRelevantSkillPrompt(matimo: MatimoInstance, query: string, options?: {
|
|
97
|
+
topK?: number;
|
|
98
|
+
minScore?: number;
|
|
99
|
+
header?: string;
|
|
100
|
+
}): Promise<string>;
|
|
46
101
|
//# sourceMappingURL=langchain.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAiMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB1B"}
|
|
1
|
+
{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAa,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC;IACpB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D;AAiMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,cAAc,EAAE,EACvB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACpC,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC,CAiB1B;AAoBD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,GACrB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAK9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,OAAO,CAAC,MAAM,CAAC,CAwBjB"}
|