@vicinae/api 0.6.2 → 0.7.0

package/dist/api/utils.js

@@ -18,47 +18,51 @@ exports.trash = trash;
 const open = async (target, app) => {
     let appId;
     if (app) {
-        if (typeof app === 'string') {
+        if (typeof app === "string") {
             appId = app;
         }
         else {
             appId = app.id;
         }
     }
-    await bus_1.bus.turboRequest('app.open', {
+    await bus_1.bus.turboRequest("app.open", {
         target,
-        appId
+        appId,
     });
 };
 exports.open = open;
-const deserializeApp = (app) => ({ id: app.id, name: app.name, icon: { iconName: app.icon } });
+const deserializeApp = (app) => ({
+    id: app.id,
+    name: app.name,
+    icon: { iconName: app.icon },
+});
 const getFrontmostApplication = async () => {
-    const res = await bus_1.bus.request('apps.get-frontmost');
+    const res = await bus_1.bus.request("apps.get-frontmost");
     if (!res.data.app) {
-        throw new Error('couldnt get frontmost app');
+        throw new Error("couldnt get frontmost app");
     }
     return deserializeApp(res.data.app);
 };
 exports.getFrontmostApplication = getFrontmostApplication;
 const getApplications = async (path) => {
-    const res = await bus_1.bus.turboRequest('app.list', {});
+    const res = await bus_1.bus.turboRequest("app.list", {});
     if (!res.ok)
         return [];
-    console.log('got turbo apps', { apps: res.value });
+    console.log("got turbo apps", { apps: res.value });
     return [];
 };
 exports.getApplications = getApplications;
 const getDefaultApplication = async (path) => {
-    const res = await bus_1.bus.request('apps.get-default', {
-        target: path.toString()
+    const res = await bus_1.bus.request("apps.get-default", {
+        target: path.toString(),
     });
     if (!res.data.app) {
-        throw new Error('couldnt get default app');
+        throw new Error("couldnt get default app");
     }
     return deserializeApp(res.data.app);
 };
 exports.getDefaultApplication = getDefaultApplication;
 const showInFinder = async (path) => {
-    await bus_1.bus.request('show-in-finder');
+    await bus_1.bus.request("show-in-finder");
 };
 exports.showInFinder = showInFinder;

package/dist/commands/build/index.js

@@ -75,7 +75,7 @@ class Build extends core_1.Command {
             logger.logError(`No package.json found at ${pkgPath}. Does this location point to a valid extension repository?`);
             process.exit(1);
         }
-        const json = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, 'utf8'));
+        const json = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, "utf8"));
         const e = manifest_js_1.default.safeParse(json);
         if (e.error) {
             logger.logError(`${pkgPath} is not a valid extension manifest: ${e.error}`);
@@ -87,7 +87,22 @@ class Build extends core_1.Command {
             const entryPoints = manifest.commands.map((cmd) => (0, node_path_1.join)("src", `${cmd.name}.tsx`));
             logger.logInfo(`entrypoints [${entryPoints.join(", ")}]`);
             const promises = manifest.commands.map((cmd) => {
-                const source = (0, node_path_1.join)(process.cwd(), "src", `${cmd.name}.tsx`);
+                const base = (0, node_path_1.join)(process.cwd(), "src", `${cmd.name}`);
+                const tsxSource = `${base}.tsx`;
+                const tsSource = `${base}.ts`;
+                let source = tsxSource;
+                if (cmd.mode == "view" && !(0, node_fs_1.existsSync)(tsxSource)) {
+                    throw new Error(`Unable to find view command ${cmd.name} at ${tsxSource}`);
+                }
+                // we allow .ts or .tsx for no-view
+                if (cmd.mode == "no-view") {
+                    if (!(0, node_fs_1.existsSync)(tsxSource)) {
+                        source = tsSource;
+                        if (!(0, node_fs_1.existsSync)(tsSource)) {
+                            throw new Error(`Unable to find no-view command ${cmd.name} at ${base}.{ts,tsx}`);
+                        }
+                    }
+                }
                 return esbuild.build({
                     bundle: true,
                     entryPoints: [source],
@@ -95,6 +110,7 @@ class Build extends core_1.Command {
                     format: "cjs",
                     outfile: (0, node_path_1.join)(outDir, `${cmd.name}.js`),
                     platform: "node",
+                    minify: true,
                 });
             });
             await Promise.all(promises);

package/dist/commands/develop/index.js

@@ -71,7 +71,7 @@ class Develop extends core_1.Command {
             logger.logError(`No package.json found at ${pkgPath}. Does this location point to a valid extension repository?`);
             process.exit(1);
         }
-        const json = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, 'utf8'));
+        const json = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, "utf8"));
         const e = manifest_js_1.default.safeParse(json);
         if (e.error) {
             logger.logError(`${pkgPath} is not a valid extension manifest: ${e.error}`);
@@ -100,7 +100,22 @@ class Develop extends core_1.Command {
             const entryPoints = manifest.commands.map((cmd) => (0, node_path_1.join)("src", `${cmd.name}.tsx`));
             logger.logInfo(`entrypoints [${entryPoints.join(", ")}]`);
             const promises = manifest.commands.map((cmd) => {
-                const source = (0, node_path_1.join)(process.cwd(), "src", `${cmd.name}.tsx`);
+                const base = (0, node_path_1.join)(process.cwd(), "src", `${cmd.name}`);
+                const tsxSource = `${base}.tsx`;
+                const tsSource = `${base}.ts`;
+                let source = tsxSource;
+                if (cmd.mode == "view" && !(0, node_fs_1.existsSync)(tsxSource)) {
+                    throw new Error(`Unable to find view command ${cmd.name} at ${tsxSource}`);
+                }
+                // we allow .ts or .tsx for no-view
+                if (cmd.mode == "no-view") {
+                    if (!(0, node_fs_1.existsSync)(tsxSource)) {
+                        source = tsSource;
+                        if (!(0, node_fs_1.existsSync)(tsSource)) {
+                            throw new Error(`Unable to find no-view command ${cmd.name} at ${base}.{ts,tsx}`);
+                        }
+                    }
+                }
                 return esbuild.build({
                     bundle: true,
                     entryPoints: [source],
@@ -128,7 +143,7 @@ class Develop extends core_1.Command {
         }
         process.chdir(flags.target);
         const dataDir = (0, utils_js_1.extensionDataDir)();
-        const id = `${manifest.name}.dev`;
+        const id = `${manifest.name}`;
         const extensionDir = (0, node_path_1.join)(dataDir, id);
         const logFile = (0, node_path_1.join)(extensionDir, "dev.log");
         const pidFile = (0, node_path_1.join)(extensionDir, "cli.pid");

package/dist/index.d.ts

@@ -1 +1 @@
-export * from './api';
+export * from "./api";

package/dist/schemas/manifest.js

@@ -1,4 +1,228 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const zod_1 = require("zod");
-exports.default = zod_1.z.object({ "icon": zod_1.z.string().regex(new RegExp("^[^\\s]+(?:[ ]*[^\\s]+)*$")).describe("A 512x512 icon representing the extension. It will be displayed in the Store and in Preferences. If any of the extension's commands doesn't have an icon, it will 'inherit' the extension's icon. Please note that light and dark themes are supported; just append '@dark' to the filename for the dark theme and the correct icon will be picked at run-time. For example, set for this property 'icon.png' and put in the assets folder the 'icon.png' and 'icon@dark.png' files."), "name": zod_1.z.string().regex(new RegExp("^(@workaround/)?[a-z0-9-~][a-z0-9-_~]*$")).min(3).max(255).describe("The slugged extension's name used internally as identifier and in the store as part of the URL."), "debug": zod_1.z.object({ "reloadShortcut": zod_1.z.object({ "key": zod_1.z.string().min(1).max(2).describe("The keyboard key pressed with the modifier to trigger an action (e.g. ⌘ + B)"), "modifiers": zod_1.z.array(zod_1.z.enum(["command", "option", "control", "shift"])).min(1).max(4).describe("Such as the command modifier (⌘), option modifier (⌥), control modifier (⌃), or shift modifier (⇧).") }).strict().describe("Keyboard shortcut used to refresh/reload a command while the Vicinae window is focused.").optional() }).describe("Compilation and run-time options to improve development experience.").optional(), "owner": zod_1.z.string().regex(new RegExp("^[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*$")).min(2).max(75).describe("User ultimately responsible for the extension. The extension's store URL is composed of the owner username and the extension's name.").optional(), "title": zod_1.z.string().regex(new RegExp("^[^\\s]+(?: [^\\s]+)*$")).min(2).max(255).describe("The extension title will be displayed in the Store and in Preferences."), "access": zod_1.z.enum(["public", "private"]).describe("Public extensions are downloadable by anybody, while private extensions can only be downloaded by a member of a given organization.").optional(), "author": zod_1.z.string().regex(new RegExp("^[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*$")).min(2).max(75).describe("User currently contributing the most to the extension."), "license": zod_1.z.literal("MIT").describe("Currently only MIT is accepted, although more licenses will probably be available in the future."), "platforms": zod_1.z.array(zod_1.z.enum(["macOS", "Windows"])).min(1).describe("Currently only `macOS` and `Windows` are accepted. If not present, the extension is assumed to be available on all platforms.").optional(), "commands": zod_1.z.array(zod_1.z.object({ "icon": zod_1.z.string().regex(new RegExp("^[^\\s]+(?:[ ]*[^\\s]+)*$")).describe("A 512x512 icon representing the command. It will be displayed in Preferences and Vicinae root search. If a command doesn't have an icon, it will 'inherit' the extension's icon. Please note that light and dark themes are supported; just append '@dark' or '@light' to the icons name and the correct icon will be picked at run-time. For example, write for this property 'icon.png' and have in the assets folder the 'icon@light.png' and 'icon@dark.png' assets.").optional(), "mode": zod_1.z.enum(["view", "no-view", "menu-bar"]).describe("A value of 'view' indicates that the command will show a main view when performed. 'no-view' means that the command does not push a view to the main navigation stack in Vicinae. The latter is handy for directly opening URL or other API functionality that doesn't require a user interface. 'menu-bar' renders an extra item in the macOS system menu bar at the top of the screen."), "name": zod_1.z.string().regex(new RegExp("^[a-z0-9-~][a-zA-Z0-9-._~]*$")).min(2).max(255).describe("The name directly maps to the entry point file for the command. So a command named 'index' would map to 'src/index.ts' (or any other supported TypeScript or JavaScript file extension such as .tsx, .js, .jsx)."), "title": zod_1.z.string().regex(new RegExp("^[^\\s]+(?: [^\\s]+)*$")).min(2).max(255).describe("The command title will be displayed in the Store, Preferences, and in Vicinae's root search."), "keywords": zod_1.z.any().optional(), "subtitle": zod_1.z.string().regex(new RegExp("^[^\\s]+(?: [^\\s]+)*$")).min(2).max(255).describe("The subtitle (if any) will be displayed next to the command name in the root search. It helps user differentiate potentially similar commands. For example, a Google Suite extension may define 2 commands titled 'Create Document'. To differentiate them, one of the subtitle can be 'Google Docs' while the other can be 'Google Sheets'.").optional(), "description": zod_1.z.string().regex(new RegExp("^[^\\s]+(\\s+[^\\s]+)*$")).min(0).max(2048).describe("It helps users understand what the command does. It will be displayed in the Store and in Preferences."), "interval": zod_1.z.string().regex(new RegExp("^(\\d+)(s|m|h|d)$")).describe("The value specifies that a no-view or menu-bar command should be launched in the background every X seconds (s), minutes (m), hours (h) or days (d). Examples: 90s, 1m, 12h, 1d. The minimum value is 10 seconds (10s).").optional(), "preferences": zod_1.z.any().describe("Commands can optionally contribute preferences that are shown in Vicinae Preferences > Extensions when selecting the command. You can use preferences for configuration values and passwords or personal access tokens. Commands automatically \"inherit\" extension preferences and can also override entries with the same `name`.").optional(), "arguments": zod_1.z.any().describe("An optional array of arguments that are requested from user when the command is called").optional(), "disabledByDefault": zod_1.z.boolean().describe("Defaults to `false`").optional() }).catchall(zod_1.z.any())).min(1).max(100).describe("List of all commands vended by this extensions. An extension must contain at least one command."), "tools": zod_1.z.array(zod_1.z.object({ "icon": zod_1.z.string().regex(new RegExp("^[^\\s]+(?:[ ]*[^\\s]+)*$")).describe("A 512x512 icon representing the tool. It will be displayed in various places across Vicinae. If a tool doesn't have an icon, it will 'inherit' the extension's icon. Please note that light and dark themes are supported; just append '@dark' or '@light' to the icons name and the correct icon will be picked at run-time. For example, write for this property 'icon.png' and have in the assets folder the 'icon@light.png' and 'icon@dark.png' assets.").optional(), "name": zod_1.z.string().regex(new RegExp("^[a-z0-9-][a-zA-Z0-9-_]*$")).min(2).max(64).describe("The name directly maps to the entry point file for the tool. So a tool named 'index' would map to 'src/tools/index.ts' (or any other supported TypeScript or JavaScript file extension such as .tsx, .js, .jsx)."), "title": zod_1.z.string().regex(new RegExp("^[^\\s]+(?: [^\\s]+)*$")).min(2).max(255).describe("The tool title will be displayed in the Store, Preferences, and any other places the tool might be referenced in the Vicinae UI."), "keywords": zod_1.z.any().optional(), "description": zod_1.z.string().regex(new RegExp("^[^\\s]+(\\s+[^\\s]+)*$")).min(12).max(2048).describe("It helps users (and other actors like AI) understand what the tool does. It will be displayed in the Store and in Preferences."), "functionalities": zod_1.z.array(zod_1.z.enum(["AI attachment provider", "AI tool"])).describe("Limits the tool to the specified functionalities. If not specified, the tool can be used in any context (if it matches the requirements for each of them).").optional(), "preferences": zod_1.z.any().describe("Tools can optionally contribute preferences that are shown in Vicinae Preferences > Extensions when selecting the AI Extension item. You can use preferences for configuration values and passwords or personal access tokens. Tools automatically \"inherit\" extension preferences and can also override entries with the same `name`.").optional() }).catchall(zod_1.z.any())).min(0).max(100).describe("List of all tools that the AI can use to interact with this extension.").optional(), "ai": zod_1.z.object({ "instructions": zod_1.z.string().describe("Additional system instructions added when the tools are used in AI").optional(), "evals": zod_1.z.array(zod_1.z.object({ "input": zod_1.z.string().describe("The prompt to evaluate"), "usedAsExample": zod_1.z.boolean().describe("Whether the eval can be used as an example in Vicinae (default `true`)").optional() })).describe("List of tests to evaluate the reliability of the tools when used in AI").optional() }).describe("Additional information related to the AI capabilities of the extension").optional(), "keywords": zod_1.z.any().optional(), "description": zod_1.z.string().regex(new RegExp("^[^\\s]+(\\s+[^\\s]+)*$")).min(16).max(2048).describe("It helps users understand what the extension does. It will be displayed in the Store and in Preferences."), "preferences": zod_1.z.any().describe("Extensions can contribute preferences that are shown in Vicinae Preferences > Extensions. You can use preferences for configuration values and passwords or personal access tokens.").optional(), "categories": zod_1.z.array(zod_1.z.string()).optional(), "contributors": zod_1.z.array(zod_1.z.string().regex(new RegExp("^[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*$")).min(2).max(75)).min(0).describe("Users who have meaningfully contributed to the extension's commands.").optional(), "pastContributors": zod_1.z.array(zod_1.z.string().regex(new RegExp("^[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*$")).min(2).max(75)).min(0).describe("Users who have meaningfully contributed to the extension's commands but do not maintain it anymore.").optional(), "dependencies": zod_1.z.object({ "@raycast/api": zod_1.z.string().describe("The Vicinae API version used by this extension.").optional() }).describe("Source dependencies following the npm package.json dependency format."), "external": zod_1.z.array(zod_1.z.string()).describe("An Array of package or file names that should be excluded from the build. The package will not be bundled, but the import is preserved and will be evaluated at runtime.").optional() });
+exports.default = zod_1.z.object({
+    icon: zod_1.z
+        .string()
+        .regex(new RegExp("^[^\\s]+(?:[ ]*[^\\s]+)*$"))
+        .describe("A 512x512 icon representing the extension. It will be displayed in the Store and in Preferences. If any of the extension's commands doesn't have an icon, it will 'inherit' the extension's icon. Please note that light and dark themes are supported; just append '@dark' to the filename for the dark theme and the correct icon will be picked at run-time. For example, set for this property 'icon.png' and put in the assets folder the 'icon.png' and 'icon@dark.png' files."),
+    name: zod_1.z
+        .string()
+        .regex(new RegExp("^(@workaround/)?[a-z0-9-~][a-z0-9-_~]*$"))
+        .min(3)
+        .max(255)
+        .describe("The slugged extension's name used internally as identifier and in the store as part of the URL."),
+    debug: zod_1.z
+        .object({
+        reloadShortcut: zod_1.z
+            .object({
+            key: zod_1.z
+                .string()
+                .min(1)
+                .max(2)
+                .describe("The keyboard key pressed with the modifier to trigger an action (e.g. ⌘ + B)"),
+            modifiers: zod_1.z
+                .array(zod_1.z.enum(["command", "option", "control", "shift"]))
+                .min(1)
+                .max(4)
+                .describe("Such as the command modifier (⌘), option modifier (⌥), control modifier (⌃), or shift modifier (⇧)."),
+        })
+            .strict()
+            .describe("Keyboard shortcut used to refresh/reload a command while the Vicinae window is focused.")
+            .optional(),
+    })
+        .describe("Compilation and run-time options to improve development experience.")
+        .optional(),
+    owner: zod_1.z
+        .string()
+        .regex(new RegExp("^[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*$"))
+        .min(2)
+        .max(75)
+        .describe("User ultimately responsible for the extension. The extension's store URL is composed of the owner username and the extension's name.")
+        .optional(),
+    title: zod_1.z
+        .string()
+        .regex(new RegExp("^[^\\s]+(?: [^\\s]+)*$"))
+        .min(2)
+        .max(255)
+        .describe("The extension title will be displayed in the Store and in Preferences."),
+    access: zod_1.z
+        .enum(["public", "private"])
+        .describe("Public extensions are downloadable by anybody, while private extensions can only be downloaded by a member of a given organization.")
+        .optional(),
+    author: zod_1.z
+        .string()
+        .regex(new RegExp("^[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*$"))
+        .min(2)
+        .max(75)
+        .describe("User currently contributing the most to the extension."),
+    license: zod_1.z
+        .literal("MIT")
+        .describe("Currently only MIT is accepted, although more licenses will probably be available in the future."),
+    platforms: zod_1.z
+        .array(zod_1.z.enum(["macOS", "Windows"]))
+        .min(1)
+        .describe("Currently only `macOS` and `Windows` are accepted. If not present, the extension is assumed to be available on all platforms.")
+        .optional(),
+    commands: zod_1.z
+        .array(zod_1.z
+        .object({
+        icon: zod_1.z
+            .string()
+            .regex(new RegExp("^[^\\s]+(?:[ ]*[^\\s]+)*$"))
+            .describe("A 512x512 icon representing the command. It will be displayed in Preferences and Vicinae root search. If a command doesn't have an icon, it will 'inherit' the extension's icon. Please note that light and dark themes are supported; just append '@dark' or '@light' to the icons name and the correct icon will be picked at run-time. For example, write for this property 'icon.png' and have in the assets folder the 'icon@light.png' and 'icon@dark.png' assets.")
+            .optional(),
+        mode: zod_1.z
+            .enum(["view", "no-view", "menu-bar"])
+            .describe("A value of 'view' indicates that the command will show a main view when performed. 'no-view' means that the command does not push a view to the main navigation stack in Vicinae. The latter is handy for directly opening URL or other API functionality that doesn't require a user interface. 'menu-bar' renders an extra item in the macOS system menu bar at the top of the screen."),
+        name: zod_1.z
+            .string()
+            .regex(new RegExp("^[a-z0-9-~][a-zA-Z0-9-._~]*$"))
+            .min(2)
+            .max(255)
+            .describe("The name directly maps to the entry point file for the command. So a command named 'index' would map to 'src/index.ts' (or any other supported TypeScript or JavaScript file extension such as .tsx, .js, .jsx)."),
+        title: zod_1.z
+            .string()
+            .regex(new RegExp("^[^\\s]+(?: [^\\s]+)*$"))
+            .min(2)
+            .max(255)
+            .describe("The command title will be displayed in the Store, Preferences, and in Vicinae's root search."),
+        keywords: zod_1.z.any().optional(),
+        subtitle: zod_1.z
+            .string()
+            .regex(new RegExp("^[^\\s]+(?: [^\\s]+)*$"))
+            .min(2)
+            .max(255)
+            .describe("The subtitle (if any) will be displayed next to the command name in the root search. It helps user differentiate potentially similar commands. For example, a Google Suite extension may define 2 commands titled 'Create Document'. To differentiate them, one of the subtitle can be 'Google Docs' while the other can be 'Google Sheets'.")
+            .optional(),
+        description: zod_1.z
+            .string()
+            .regex(new RegExp("^[^\\s]+(\\s+[^\\s]+)*$"))
+            .min(0)
+            .max(2048)
+            .describe("It helps users understand what the command does. It will be displayed in the Store and in Preferences."),
+        interval: zod_1.z
+            .string()
+            .regex(new RegExp("^(\\d+)(s|m|h|d)$"))
+            .describe("The value specifies that a no-view or menu-bar command should be launched in the background every X seconds (s), minutes (m), hours (h) or days (d). Examples: 90s, 1m, 12h, 1d. The minimum value is 10 seconds (10s).")
+            .optional(),
+        preferences: zod_1.z
+            .any()
+            .describe('Commands can optionally contribute preferences that are shown in Vicinae Preferences > Extensions when selecting the command. You can use preferences for configuration values and passwords or personal access tokens. Commands automatically "inherit" extension preferences and can also override entries with the same `name`.')
+            .optional(),
+        arguments: zod_1.z
+            .any()
+            .describe("An optional array of arguments that are requested from user when the command is called")
+            .optional(),
+        disabledByDefault: zod_1.z
+            .boolean()
+            .describe("Defaults to `false`")
+            .optional(),
+    })
+        .catchall(zod_1.z.any()))
+        .min(1)
+        .max(100)
+        .describe("List of all commands vended by this extensions. An extension must contain at least one command."),
+    tools: zod_1.z
+        .array(zod_1.z
+        .object({
+        icon: zod_1.z
+            .string()
+            .regex(new RegExp("^[^\\s]+(?:[ ]*[^\\s]+)*$"))
+            .describe("A 512x512 icon representing the tool. It will be displayed in various places across Vicinae. If a tool doesn't have an icon, it will 'inherit' the extension's icon. Please note that light and dark themes are supported; just append '@dark' or '@light' to the icons name and the correct icon will be picked at run-time. For example, write for this property 'icon.png' and have in the assets folder the 'icon@light.png' and 'icon@dark.png' assets.")
+            .optional(),
+        name: zod_1.z
+            .string()
+            .regex(new RegExp("^[a-z0-9-][a-zA-Z0-9-_]*$"))
+            .min(2)
+            .max(64)
+            .describe("The name directly maps to the entry point file for the tool. So a tool named 'index' would map to 'src/tools/index.ts' (or any other supported TypeScript or JavaScript file extension such as .tsx, .js, .jsx)."),
+        title: zod_1.z
+            .string()
+            .regex(new RegExp("^[^\\s]+(?: [^\\s]+)*$"))
+            .min(2)
+            .max(255)
+            .describe("The tool title will be displayed in the Store, Preferences, and any other places the tool might be referenced in the Vicinae UI."),
+        keywords: zod_1.z.any().optional(),
+        description: zod_1.z
+            .string()
+            .regex(new RegExp("^[^\\s]+(\\s+[^\\s]+)*$"))
+            .min(12)
+            .max(2048)
+            .describe("It helps users (and other actors like AI) understand what the tool does. It will be displayed in the Store and in Preferences."),
+        functionalities: zod_1.z
+            .array(zod_1.z.enum(["AI attachment provider", "AI tool"]))
+            .describe("Limits the tool to the specified functionalities. If not specified, the tool can be used in any context (if it matches the requirements for each of them).")
+            .optional(),
+        preferences: zod_1.z
+            .any()
+            .describe('Tools can optionally contribute preferences that are shown in Vicinae Preferences > Extensions when selecting the AI Extension item. You can use preferences for configuration values and passwords or personal access tokens. Tools automatically "inherit" extension preferences and can also override entries with the same `name`.')
+            .optional(),
+    })
+        .catchall(zod_1.z.any()))
+        .min(0)
+        .max(100)
+        .describe("List of all tools that the AI can use to interact with this extension.")
+        .optional(),
+    ai: zod_1.z
+        .object({
+        instructions: zod_1.z
+            .string()
+            .describe("Additional system instructions added when the tools are used in AI")
+            .optional(),
+        evals: zod_1.z
+            .array(zod_1.z.object({
+            input: zod_1.z.string().describe("The prompt to evaluate"),
+            usedAsExample: zod_1.z
+                .boolean()
+                .describe("Whether the eval can be used as an example in Vicinae (default `true`)")
+                .optional(),
+        }))
+            .describe("List of tests to evaluate the reliability of the tools when used in AI")
+            .optional(),
+    })
+        .describe("Additional information related to the AI capabilities of the extension")
+        .optional(),
+    keywords: zod_1.z.any().optional(),
+    description: zod_1.z
+        .string()
+        .regex(new RegExp("^[^\\s]+(\\s+[^\\s]+)*$"))
+        .min(16)
+        .max(2048)
+        .describe("It helps users understand what the extension does. It will be displayed in the Store and in Preferences."),
+    preferences: zod_1.z
+        .any()
+        .describe("Extensions can contribute preferences that are shown in Vicinae Preferences > Extensions. You can use preferences for configuration values and passwords or personal access tokens.")
+        .optional(),
+    categories: zod_1.z.array(zod_1.z.string()).optional(),
+    contributors: zod_1.z
+        .array(zod_1.z
+        .string()
+        .regex(new RegExp("^[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*$"))
+        .min(2)
+        .max(75))
+        .min(0)
+        .describe("Users who have meaningfully contributed to the extension's commands.")
+        .optional(),
+    pastContributors: zod_1.z
+        .array(zod_1.z
+        .string()
+        .regex(new RegExp("^[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*$"))
+        .min(2)
+        .max(75))
+        .min(0)
+        .describe("Users who have meaningfully contributed to the extension's commands but do not maintain it anymore.")
+        .optional(),
+    dependencies: zod_1.z
+        .object({
+        "@raycast/api": zod_1.z
+            .string()
+            .describe("The Vicinae API version used by this extension.")
+            .optional(),
+    })
+        .describe("Source dependencies following the npm package.json dependency format."),
+    external: zod_1.z
+        .array(zod_1.z.string())
+        .describe("An Array of package or file names that should be excluded from the build. The package will not be bundled, but the import is preserved and will be evaluated at runtime.")
+        .optional(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vicinae/api",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "TypeScript SDK to build Vicinae extensions",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",