@vertesia/tools-sdk 1.6.0-dev.20261014.015055Z → 1.6.0-dev.20261022.120426Z

package/src/server/skills.ts

@@ -4,7 +4,7 @@ import { type Context, Hono } from 'hono';
 import { HTTPException } from 'hono/http-exception';
 import type { SkillCollection } from '../SkillCollection.js';
 import type { SkillDefinition, ToolCollectionDefinition, ToolDefinition } from '../types.js';
-import { makeScriptUrl } from '../utils.js';
+import { makeScriptUrl, makeSkillFileUrl } from '../utils.js';
 import type { ToolContext, ToolServerConfig } from './types.js';
 
 export function createSkillsRoute(app: Hono, basePath: string, config: ToolServerConfig) {
@@ -116,6 +116,32 @@ function createSkillEndpoints(coll: SkillCollection): Hono {
         });
     });
 
+    // Get the Agent Skills resource files (scripts/, references/, assets/) for a specific skill.
+    // Separate from /scripts so existing clients keep receiving only the flat scripts.
+    endpoint.get('/:name/files', (c: Context) => {
+        const name = c.req.param('name');
+        if (!name) {
+            throw new HTTPException(400, {
+                message: 'Skill name is required',
+            });
+        }
+        const skillName = name.startsWith('learn_') ? name.slice(6) : name;
+        const skill = coll.getSkill(skillName);
+        if (!skill) {
+            throw new HTTPException(404, {
+                message: `Skill not found: ${skillName}`,
+            });
+        }
+        const url = new URL(c.req.url);
+        return c.json({
+            skill_name: skill.name,
+            files: (skill.files ?? []).map((path) => ({
+                path,
+                url: makeSkillFileUrl(url.origin, skill.files_namespace ?? skill.name, path),
+            })),
+        });
+    });
+
     // Get a specific skill by name
     endpoint.get('/:name', (c: Context) => {
         const name = c.req.param('name');

package/src/server/types.ts

@@ -50,6 +50,8 @@ export interface MCPProviderConfig {
 export interface ToolServerConfig {
     /** OAuth scopes requested by the app; project permissions must be explicitly declared. */
     oauth_scopes?: string[];
+    /** Declare exact standalone callbacks; installation provisions the public PKCE client. */
+    oauth_client?: { redirect_uris: string[] };
     /**
      * Server title for HTML pages (default: 'Tools Server')
      */

package/src/types.ts

@@ -379,6 +379,32 @@ export interface SkillDefinition {
      * Scripts bundled with this skill (synced to sandbox when skill is used)
      */
     scripts?: string[];
+    /**
+     * Agent Skills resource files from the skill's `scripts/`, `references/` and `assets/` directories, as
+     * paths relative to the skill directory (e.g. `scripts/extract.py`). They are synced to the sandbox
+     * under the skill's directory with these relative paths.
+     */
+    files?: string[];
+    /** Build-time directory under `skill-files/`, independent of a runtime name override. Defaults to `name`. */
+    files_namespace?: string;
+    /**
+     * License from the Agent Skills `license` frontmatter field.
+     */
+    license?: string;
+    /**
+     * Environment requirements from the Agent Skills `compatibility` frontmatter field.
+     */
+    compatibility?: string;
+    /**
+     * Arbitrary key-value metadata from the Agent Skills `metadata` frontmatter field.
+     */
+    metadata?: Record<string, string>;
+    /**
+     * Tools named by the Agent Skills `allowed-tools` frontmatter field, which is experimental in the
+     * spec and not supported by Vertesia. Informational only: unlike `tools`, these names are not
+     * resolved and never unlock a tool.
+     */
+    allowed_tools?: string[];
     /**
      * The name of the widgets provided by this skill (if any)
      * The name will be used to load the widget dynamically from the agent chat

package/src/utils.ts

@@ -25,6 +25,14 @@ export function makeScriptUrl(origin: string, script: string) {
     return join(origin, join('/scripts', script));
 }
 
+/**
+ * URL of an Agent Skills resource file, which the build copies to `skill-files/<skill>/<path>`.
+ */
+export function makeSkillFileUrl(origin: string, skillName: string, filePath: string) {
+    const encodedPath = filePath.split('/').map(encodeURIComponent).join('/');
+    return join(origin, `/skill-files/${encodeURIComponent(skillName)}/${encodedPath}`);
+}
+
 export function join(left: string, right: string) {
     if (left.endsWith('/')) {
         if (right.startsWith('/')) {