@exellix/ai-skills 6.5.0 → 6.7.0
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 +15 -0
- package/dist/catalog-manager/createAiSkillsCatalogApi.d.ts +8 -0
- package/dist/catalog-manager/createAiSkillsCatalogApi.d.ts.map +1 -0
- package/dist/catalog-manager/createAiSkillsCatalogApi.js +144 -0
- package/dist/catalog-manager/createAiSkillsCatalogApi.js.map +1 -0
- package/dist/catalog-manager/index.d.ts +3 -0
- package/dist/catalog-manager/index.d.ts.map +1 -0
- package/dist/catalog-manager/index.js +2 -0
- package/dist/catalog-manager/index.js.map +1 -0
- package/dist/catalog-manager/types.d.ts +71 -0
- package/dist/catalog-manager/types.d.ts.map +1 -0
- package/dist/catalog-manager/types.js +2 -0
- package/dist/catalog-manager/types.js.map +1 -0
- package/dist/catalox/ai-skills-catalog.d.ts +12 -15
- package/dist/catalox/ai-skills-catalog.d.ts.map +1 -1
- package/dist/catalox/ai-skills-catalog.js +23 -143
- package/dist/catalox/ai-skills-catalog.js.map +1 -1
- package/dist/catalox/ai-sub-skills-catalog.d.ts +7 -0
- package/dist/catalox/ai-sub-skills-catalog.d.ts.map +1 -0
- package/dist/catalox/ai-sub-skills-catalog.js +72 -0
- package/dist/catalox/ai-sub-skills-catalog.js.map +1 -0
- package/dist/catalox/catalog-guards.d.ts +14 -0
- package/dist/catalox/catalog-guards.d.ts.map +1 -0
- package/dist/catalox/catalog-guards.js +86 -0
- package/dist/catalox/catalog-guards.js.map +1 -0
- package/dist/catalox/catalog-native-store.d.ts +21 -0
- package/dist/catalox/catalog-native-store.d.ts.map +1 -0
- package/dist/catalox/catalog-native-store.js +101 -0
- package/dist/catalox/catalog-native-store.js.map +1 -0
- package/dist/catalox/catalog-normalization.d.ts +70 -0
- package/dist/catalox/catalog-normalization.d.ts.map +1 -0
- package/dist/catalox/catalog-normalization.js +281 -0
- package/dist/catalox/catalog-normalization.js.map +1 -0
- package/dist/catalox/index.d.ts +5 -4
- package/dist/catalox/index.d.ts.map +1 -1
- package/dist/catalox/index.js +5 -4
- package/dist/catalox/index.js.map +1 -1
- package/dist/catalox/list-ai-skills-catalog.d.ts +12 -6
- package/dist/catalox/list-ai-skills-catalog.d.ts.map +1 -1
- package/dist/catalox/list-ai-skills-catalog.js +72 -19
- package/dist/catalox/list-ai-skills-catalog.js.map +1 -1
- package/dist/catalox/skill-optimixer-catalog.d.ts +16 -15
- package/dist/catalox/skill-optimixer-catalog.d.ts.map +1 -1
- package/dist/catalox/skill-optimixer-catalog.js +67 -70
- package/dist/catalox/skill-optimixer-catalog.js.map +1 -1
- package/dist/catalox/skill-template-catalog-mutations.d.ts +12 -52
- package/dist/catalox/skill-template-catalog-mutations.d.ts.map +1 -1
- package/dist/catalox/skill-template-catalog-mutations.js +288 -329
- package/dist/catalox/skill-template-catalog-mutations.js.map +1 -1
- package/dist/catalox/skill-templates.d.ts +32 -43
- package/dist/catalox/skill-templates.d.ts.map +1 -1
- package/dist/catalox/skill-templates.js +66 -50
- package/dist/catalox/skill-templates.js.map +1 -1
- package/dist/client/registry-manager.d.ts +2 -2
- package/dist/client/registry-manager.d.ts.map +1 -1
- package/dist/client/registry-manager.js +5 -5
- package/dist/client/registry-manager.js.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/invocation/defaultAiProfilesResolveOptions.d.ts +1 -1
- package/dist/invocation/defaultAiProfilesResolveOptions.d.ts.map +1 -1
- package/dist/invocation/defaultAiProfilesResolveOptions.js +2 -2
- package/dist/invocation/defaultAiProfilesResolveOptions.js.map +1 -1
- package/dist/invocation/normalizeModelConfigForGatewayInvoke.js +2 -2
- package/dist/invocation/normalizeModelConfigForGatewayInvoke.js.map +1 -1
- package/dist/invocation/preferOpenRouterPolicy.d.ts +2 -3
- package/dist/invocation/preferOpenRouterPolicy.d.ts.map +1 -1
- package/dist/invocation/preferOpenRouterPolicy.js +6 -11
- package/dist/invocation/preferOpenRouterPolicy.js.map +1 -1
- package/dist/invocation/resolveSkillProfileToWireModel.js +3 -3
- package/dist/invocation/resolveSkillProfileToWireModel.js.map +1 -1
- package/dist/types.d.ts +1 -1
- package/package.json +8 -5
|
@@ -11,72 +11,87 @@ function readPositiveInt(v) {
|
|
|
11
11
|
function readOptionalString(v) {
|
|
12
12
|
return typeof v === "string" && v.trim().length > 0 ? v.trim() : undefined;
|
|
13
13
|
}
|
|
14
|
-
|
|
15
|
-
|
|
14
|
+
function parseAcceptableRisk(raw) {
|
|
15
|
+
if (!raw)
|
|
16
|
+
return undefined;
|
|
17
|
+
if (raw === "very-low" || raw === "low" || raw === "medium" || raw === "high")
|
|
18
|
+
return raw;
|
|
19
|
+
const n = Number(raw);
|
|
20
|
+
return Number.isFinite(n) ? n : undefined;
|
|
21
|
+
}
|
|
22
|
+
function parseOutputIntentFromNested(raw) {
|
|
23
|
+
if (raw == null || typeof raw !== "object" || Array.isArray(raw))
|
|
24
|
+
return undefined;
|
|
25
|
+
const obj = raw;
|
|
26
|
+
const mode = readOptionalString(obj.mode);
|
|
27
|
+
const expectedVisibleTokens = readPositiveInt(obj.expectedVisibleTokens);
|
|
28
|
+
if (!mode || (mode !== "fixed" && mode !== "relative") || expectedVisibleTokens === undefined) {
|
|
29
|
+
return undefined;
|
|
30
|
+
}
|
|
31
|
+
if (mode === "fixed")
|
|
32
|
+
return { mode: "fixed", expectedVisibleTokens };
|
|
33
|
+
return {
|
|
34
|
+
mode: "relative",
|
|
35
|
+
expectedVisibleTokens,
|
|
36
|
+
...(readPositiveInt(obj.outputToInputRatio) !== undefined
|
|
37
|
+
? { outputToInputRatio: readPositiveInt(obj.outputToInputRatio) }
|
|
38
|
+
: {}),
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
function parseSpecFromNestedOptimixer(nested) {
|
|
42
|
+
const reasoningRaw = readOptionalString(nested.reasoningEffort);
|
|
43
|
+
if (!reasoningRaw || !REASONING_EFFORTS.has(reasoningRaw))
|
|
44
|
+
return undefined;
|
|
45
|
+
const outputIntent = parseOutputIntentFromNested(nested.outputIntent);
|
|
46
|
+
if (!outputIntent)
|
|
47
|
+
return undefined;
|
|
48
|
+
const acceptableRisk = parseAcceptableRisk(readOptionalString(nested.acceptableRisk));
|
|
49
|
+
const taskType = readOptionalString(nested.taskType);
|
|
50
|
+
const outputMode = readOptionalString(nested.outputMode);
|
|
51
|
+
const schemaComplexity = readOptionalString(nested.schemaComplexity);
|
|
52
|
+
return {
|
|
53
|
+
reasoningEffort: reasoningRaw,
|
|
54
|
+
outputIntent,
|
|
55
|
+
...(acceptableRisk !== undefined ? { acceptableRisk } : {}),
|
|
56
|
+
...(taskType !== undefined ? { taskType } : {}),
|
|
57
|
+
...(outputMode !== undefined ? { outputMode } : {}),
|
|
58
|
+
...(schemaComplexity !== undefined ? { schemaComplexity } : {}),
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
/** Converts {@link SkillOptimixerCatalogSpec} to nested `data.optimixer` for normalized catalog rows. */
|
|
62
|
+
export function optimixerSpecToNestedData(spec) {
|
|
16
63
|
const out = {
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
64
|
+
reasoningEffort: spec.reasoningEffort,
|
|
65
|
+
outputIntent: {
|
|
66
|
+
mode: spec.outputIntent.mode,
|
|
67
|
+
expectedVisibleTokens: spec.outputIntent.expectedVisibleTokens,
|
|
68
|
+
},
|
|
20
69
|
};
|
|
21
70
|
if (spec.outputIntent.mode === "relative" && spec.outputIntent.outputToInputRatio !== undefined) {
|
|
22
|
-
out.
|
|
71
|
+
out.outputIntent.outputToInputRatio = spec.outputIntent.outputToInputRatio;
|
|
23
72
|
}
|
|
24
73
|
if (spec.acceptableRisk !== undefined)
|
|
25
|
-
out.
|
|
74
|
+
out.acceptableRisk = String(spec.acceptableRisk);
|
|
26
75
|
if (spec.taskType !== undefined)
|
|
27
|
-
out.
|
|
76
|
+
out.taskType = spec.taskType;
|
|
28
77
|
if (spec.outputMode !== undefined)
|
|
29
|
-
out.
|
|
78
|
+
out.outputMode = spec.outputMode;
|
|
30
79
|
if (spec.schemaComplexity !== undefined)
|
|
31
|
-
out.
|
|
80
|
+
out.schemaComplexity = spec.schemaComplexity;
|
|
32
81
|
return out;
|
|
33
82
|
}
|
|
34
83
|
/**
|
|
35
|
-
* Parses
|
|
84
|
+
* Parses Optimixer from normalized `data.optimixer` (or nested override objects).
|
|
36
85
|
* @throws Error when required fields are missing or invalid.
|
|
37
86
|
*/
|
|
38
|
-
export function
|
|
39
|
-
const
|
|
40
|
-
if (
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
const expectedVisibleTokens = readPositiveInt(data.optimixerExpectedVisibleTokens);
|
|
45
|
-
if (!mode || (mode !== "fixed" && mode !== "relative") || expectedVisibleTokens === undefined) {
|
|
46
|
-
throw new Error(`[AI-SKILLS] Skill "${skillKeyForErrors}" is missing valid optimixerOutputIntentMode / optimixerExpectedVisibleTokens in Catalox (required for @x12i/optimixer v3).`);
|
|
47
|
-
}
|
|
48
|
-
const outputIntent = mode === "fixed"
|
|
49
|
-
? { mode: "fixed", expectedVisibleTokens }
|
|
50
|
-
: {
|
|
51
|
-
mode: "relative",
|
|
52
|
-
expectedVisibleTokens,
|
|
53
|
-
...(readPositiveInt(data.optimixerOutputToInputRatio) !== undefined
|
|
54
|
-
? { outputToInputRatio: readPositiveInt(data.optimixerOutputToInputRatio) }
|
|
55
|
-
: {}),
|
|
56
|
-
};
|
|
57
|
-
const acceptableRiskRaw = readOptionalString(data.optimixerAcceptableRisk);
|
|
58
|
-
const taskType = readOptionalString(data.optimixerTaskType);
|
|
59
|
-
const outputMode = readOptionalString(data.optimixerOutputMode);
|
|
60
|
-
const schemaComplexity = readOptionalString(data.optimixerSchemaComplexity);
|
|
61
|
-
let acceptableRisk;
|
|
62
|
-
if (acceptableRiskRaw) {
|
|
63
|
-
if (acceptableRiskRaw === "very-low" || acceptableRiskRaw === "low" || acceptableRiskRaw === "medium" || acceptableRiskRaw === "high") {
|
|
64
|
-
acceptableRisk = acceptableRiskRaw;
|
|
65
|
-
}
|
|
66
|
-
else {
|
|
67
|
-
const n = Number(acceptableRiskRaw);
|
|
68
|
-
if (Number.isFinite(n))
|
|
69
|
-
acceptableRisk = n;
|
|
70
|
-
}
|
|
87
|
+
export function parseOptimixerFromRecordData(skillKeyForErrors, data) {
|
|
88
|
+
const nested = data.optimixer;
|
|
89
|
+
if (nested != null && typeof nested === "object" && !Array.isArray(nested)) {
|
|
90
|
+
const parsed = parseSpecFromNestedOptimixer(nested);
|
|
91
|
+
if (parsed)
|
|
92
|
+
return parsed;
|
|
71
93
|
}
|
|
72
|
-
|
|
73
|
-
reasoningEffort: reasoningRaw,
|
|
74
|
-
outputIntent,
|
|
75
|
-
...(acceptableRisk !== undefined ? { acceptableRisk } : {}),
|
|
76
|
-
...(taskType !== undefined ? { taskType } : {}),
|
|
77
|
-
...(outputMode !== undefined ? { outputMode } : {}),
|
|
78
|
-
...(schemaComplexity !== undefined ? { schemaComplexity } : {}),
|
|
79
|
-
};
|
|
94
|
+
throw new Error(`[AI-SKILLS] Skill "${skillKeyForErrors}" is missing valid data.optimixer in Catalox (required for @x12i/optimixer v3).`);
|
|
80
95
|
}
|
|
81
96
|
/** Default Optimixer row used by unit-test Catalox stubs when not overridden. */
|
|
82
97
|
export function defaultSkillOptimixerCatalogSpecForTests() {
|
|
@@ -88,22 +103,4 @@ export function defaultSkillOptimixerCatalogSpecForTests() {
|
|
|
88
103
|
outputMode: "markdown",
|
|
89
104
|
};
|
|
90
105
|
}
|
|
91
|
-
const OPTIMIXER_CATALOG_DATA_KEYS = [
|
|
92
|
-
"optimixerReasoningEffort",
|
|
93
|
-
"optimixerOutputIntentMode",
|
|
94
|
-
"optimixerExpectedVisibleTokens",
|
|
95
|
-
"optimixerOutputToInputRatio",
|
|
96
|
-
"optimixerAcceptableRisk",
|
|
97
|
-
"optimixerTaskType",
|
|
98
|
-
"optimixerOutputMode",
|
|
99
|
-
"optimixerSchemaComplexity",
|
|
100
|
-
];
|
|
101
|
-
/** Copies Optimixer flat fields from an existing Catalox row (sub-skill duplicate, upsert merge). */
|
|
102
|
-
export function copySkillOptimixerCatalogDataFields(from, to) {
|
|
103
|
-
for (const key of OPTIMIXER_CATALOG_DATA_KEYS) {
|
|
104
|
-
if (from[key] !== undefined) {
|
|
105
|
-
to[key] = from[key];
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
}
|
|
109
106
|
//# sourceMappingURL=skill-optimixer-catalog.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-optimixer-catalog.js","sourceRoot":"","sources":["../../src/catalox/skill-optimixer-catalog.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"skill-optimixer-catalog.js","sourceRoot":"","sources":["../../src/catalox/skill-optimixer-catalog.ts"],"names":[],"mappings":"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"}
|
|
@@ -5,18 +5,17 @@ import type { SkillCatalogStatus } from "./skill-templates.js";
|
|
|
5
5
|
import { type ExtractedTemplateInputs } from "./skill-template-markdown.js";
|
|
6
6
|
export type { ExtractedTemplateInputs } from "./skill-template-markdown.js";
|
|
7
7
|
export type SkillTemplatesPresentation = {
|
|
8
|
-
/** Short catalog key (e.g. `professional-answer`). */
|
|
9
8
|
skillKey: string;
|
|
10
9
|
catalogItemId: string;
|
|
11
10
|
status: SkillCatalogStatus;
|
|
12
11
|
title: string;
|
|
13
12
|
description: string;
|
|
14
13
|
isLocal: boolean;
|
|
15
|
-
/** Always strings; empty when not stored. */
|
|
16
14
|
instructionsMarkdown: string;
|
|
17
15
|
promptMarkdown: string;
|
|
18
16
|
auditInstructionsMarkdown?: string;
|
|
19
17
|
auditPromptMarkdown?: string;
|
|
18
|
+
parentSkillKey?: string;
|
|
20
19
|
};
|
|
21
20
|
export type SkillTemplatePresentationPatch = {
|
|
22
21
|
instructionsMarkdown?: string;
|
|
@@ -34,23 +33,14 @@ export type UpsertSkillCatalogItemInput = {
|
|
|
34
33
|
auditInstructionsMarkdown?: string;
|
|
35
34
|
auditPromptMarkdown?: string;
|
|
36
35
|
catalogReleaseStatus?: CatalogReleaseStatus;
|
|
37
|
-
/** Required when creating a new catalog row; optional on update (preserves existing Optimixer fields). */
|
|
38
36
|
optimixer?: SkillOptimixerCatalogSpec;
|
|
39
37
|
};
|
|
40
38
|
export type UpsertSkillCatalogItemOptions = {
|
|
41
|
-
/**
|
|
42
|
-
* When true, throws {@link CataloxSkillAlreadyExistsError} if the catalog row already exists.
|
|
43
|
-
*/
|
|
44
39
|
ifNotExists?: boolean;
|
|
45
40
|
};
|
|
46
41
|
export type UpdateSkillTemplatesFromPresentationOptions = {
|
|
47
|
-
/**
|
|
48
|
-
* When set, drives `published` vs `draft` together with body completeness (see {@link computeSkillRowStatus}).
|
|
49
|
-
* When omitted: if the item was already `published`, it stays publishable (`published`); otherwise treated as `draft` path.
|
|
50
|
-
*/
|
|
51
42
|
catalogReleaseStatus?: CatalogReleaseStatus;
|
|
52
43
|
};
|
|
53
|
-
/** Stable role ids for template bodies (matches Catalox `*Text` fields). */
|
|
54
44
|
export declare const SKILL_TEMPLATE_ROLES_ORDER: readonly ["instructions", "prompt", "auditInstructions", "auditPrompt"];
|
|
55
45
|
export type SkillTemplateRole = (typeof SKILL_TEMPLATE_ROLES_ORDER)[number];
|
|
56
46
|
export type SkillContentPart = {
|
|
@@ -72,6 +62,7 @@ export type CreateSubSkillOverrides = {
|
|
|
72
62
|
auditInstructionsMarkdown?: string;
|
|
73
63
|
auditPromptMarkdown?: string;
|
|
74
64
|
catalogReleaseStatus?: CatalogReleaseStatus;
|
|
65
|
+
optimixer?: SkillOptimixerCatalogSpec;
|
|
75
66
|
};
|
|
76
67
|
export type CreateSubSkillInput = {
|
|
77
68
|
sourceSkillKey: string;
|
|
@@ -90,57 +81,26 @@ export type DeleteSubSkillResult = {
|
|
|
90
81
|
success: false;
|
|
91
82
|
error: string;
|
|
92
83
|
};
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
84
|
+
export type UpdateSkillMetadataInput = {
|
|
85
|
+
skillKey: string;
|
|
86
|
+
title?: string;
|
|
87
|
+
description?: string;
|
|
88
|
+
optimixer?: SkillOptimixerCatalogSpec;
|
|
89
|
+
catalogReleaseStatus?: CatalogReleaseStatus;
|
|
90
|
+
};
|
|
97
91
|
export declare function getSkillTemplatesForPresentation(catalox: Catalox, context: CataloxContext, skillKey: string, options?: {
|
|
98
92
|
includeAudit?: boolean;
|
|
99
93
|
}): Promise<SkillTemplatesPresentation>;
|
|
100
|
-
/**
|
|
101
|
-
|
|
102
|
-
*/
|
|
94
|
+
/** Whether a catalog item id resolves to an ai-sub-skills row. */
|
|
95
|
+
export declare function isSubSkillCatalogItem(itemId: string): Promise<boolean>;
|
|
103
96
|
export declare function getSkillContent(catalox: Catalox, context: CataloxContext, skillKey: string): Promise<SkillContentPart[]>;
|
|
104
|
-
/**
|
|
105
|
-
* Unique `{{token}}` names across all template bodies (same presentation strings as {@link getSkillContent}).
|
|
106
|
-
*/
|
|
107
97
|
export declare function getSkillTokens(catalox: Catalox, context: CataloxContext, skillKey: string): Promise<string[]>;
|
|
108
|
-
/**
|
|
109
|
-
* Partial template update by role. Returns structured success/failure (including Catalox/not-found errors).
|
|
110
|
-
*/
|
|
111
98
|
export declare function modifySkillContent(catalox: Catalox, context: CataloxContext, skillKey: string, parts: SkillContentPart[], options?: UpdateSkillTemplatesFromPresentationOptions): Promise<ModifySkillContentResult>;
|
|
112
|
-
/**
|
|
113
|
-
* Merges edited markdown into the native catalog item and upserts the full row.
|
|
114
|
-
* Requires Catalox **write** access (e.g. god-mode or app binding with write).
|
|
115
|
-
*
|
|
116
|
-
* @throws CataloxSkillNotFoundError when the item does not exist.
|
|
117
|
-
*/
|
|
118
99
|
export declare function updateSkillTemplatesFromPresentation(catalox: Catalox, context: CataloxContext, skillKey: string, patch: SkillTemplatePresentationPatch, options?: UpdateSkillTemplatesFromPresentationOptions): Promise<void>;
|
|
119
|
-
/**
|
|
120
|
-
* Creates or updates a full skill catalog row (metadata + optional template markdown).
|
|
121
|
-
* Uses read–merge–write when the item exists; otherwise writes a new row.
|
|
122
|
-
* Requires Catalox **write** access.
|
|
123
|
-
*
|
|
124
|
-
* @throws CataloxSkillAlreadyExistsError when `options.ifNotExists` is true and the item exists.
|
|
125
|
-
*/
|
|
126
100
|
export declare function upsertSkillCatalogItem(catalox: Catalox, context: CataloxContext, input: UpsertSkillCatalogItemInput, options?: UpsertSkillCatalogItemOptions): Promise<void>;
|
|
127
|
-
|
|
128
|
-
* Soft-deletes a skill: clears template bodies and audit fields and sets status to `planned`.
|
|
129
|
-
* Requires Catalox **write** access.
|
|
130
|
-
*
|
|
131
|
-
* @throws CataloxSkillNotFoundError when the item does not exist.
|
|
132
|
-
*/
|
|
101
|
+
export declare function updateSkillMetadata(catalox: Catalox, context: CataloxContext, input: UpdateSkillMetadataInput): Promise<void>;
|
|
133
102
|
export declare function softDeleteSkillCatalogItem(catalox: Catalox, context: CataloxContext, skillKey: string): Promise<void>;
|
|
134
|
-
/**
|
|
135
|
-
* Duplicates a catalog skill into a new key, marking it with `parentSkillKey`. Structured success/failure.
|
|
136
|
-
*/
|
|
137
103
|
export declare function createSubSkill(catalox: Catalox, context: CataloxContext, input: CreateSubSkillInput): Promise<CreateSubSkillResult>;
|
|
138
|
-
/**
|
|
139
|
-
* Deletes a native catalog row only when it is a sub-skill (`parentSkillKey` set).
|
|
140
|
-
*/
|
|
141
104
|
export declare function deleteSubSkill(catalox: Catalox, context: CataloxContext, subSkillKey: string): Promise<DeleteSubSkillResult>;
|
|
142
|
-
/**
|
|
143
|
-
* Returns unique `{{token}}` names from raw Catalox template strings (before presentation transforms).
|
|
144
|
-
*/
|
|
145
105
|
export declare function getSkillTemplateInputs(catalox: Catalox, context: CataloxContext, skillKey: string): Promise<ExtractedTemplateInputs>;
|
|
146
106
|
//# sourceMappingURL=skill-template-catalog-mutations.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-template-catalog-mutations.d.ts","sourceRoot":"","sources":["../../src/catalox/skill-template-catalog-mutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"skill-template-catalog-mutations.d.ts","sourceRoot":"","sources":["../../src/catalox/skill-template-catalog-mutations.ts"],"names":[],"mappings":"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"}
|