@okrlinkhub/agent-factory 2.0.3 → 3.0.1

package/README.md

@@ -614,6 +614,7 @@ Fork this repository to maintain your own image with your custom skills/assets.
 
 For `globalSkills` managed by this component, the recommended runtime pattern is different:
 - store the source of truth in component tables `globalSkills`, `globalSkillVersions`, `globalSkillReleases`
+- treat each skill as a mini filesystem bundle (`files[]`), not as a single `sourceJs` blob
 - expose them through `getWorkerGlobalSkillsManifest`
 - let the worker image materialize them into `OPENCLAW_SKILLS_DIR` during prestart, before the OpenClaw gateway boots
 
@@ -622,6 +623,107 @@ The manifest now carries an explicit on-disk layout contract for OpenClaw worksp
 - `skillDirName`
 - `files[]` with `path`, `content`, `sha256`
 
+Breaking change in `3.0.0`:
+- `sourceJs` has been removed from the global skill model
+- existing legacy global skill rows must be deleted before moving to `3.0.0`
+- existing legacy skills must be republished as full bundles
+
+Bundle contract for `3.0.0`:
+- required user files:
+  - `SKILL.md`
+  - `scripts/index.mjs` or `scripts/index.cjs` (must match `moduleFormat`)
+- optional user files:
+  - any extra script or asset needed by the skill, for example `scripts/agent-bridge-cli.mjs`
+- system-generated file:
+  - `.af-global-skill.json` must not be provided by clients; it is injected by `agent-factory` during materialization
+
+Extract a `Bundle files JSON` payload from an existing OpenClaw skill directory:
+
+Use this when you already have a correctly materialized skill inside an OpenClaw workspace and want to republish it as a `3.0.0` global skill bundle.
+
+Important:
+- run the command against the skill directory itself (for example `/path/to/workspace/skills/agent-bridge`)
+- the command automatically excludes `.af-global-skill.json`
+- hidden files other than `.af-global-skill.json` are excluded by default
+- the output is the JSON array to paste into the `Bundle files JSON` field in the admin UI
+
+```sh
+node - <<'EOF' "/absolute/path/to/workspace/skills/agent-bridge"
+const fs = require('fs')
+const path = require('path')
+
+const skillDir = process.argv[2]
+if (!skillDir) {
+  console.error('Usage: node extract-skill-bundle.mjs /absolute/path/to/skill-dir')
+  process.exit(1)
+}
+
+function walk(dir, baseDir) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true })
+  const files = []
+
+  for (const entry of entries) {
+    if (entry.name === '.af-global-skill.json') continue
+    if (entry.name.startsWith('.')) continue
+
+    const absolutePath = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      files.push(...walk(absolutePath, baseDir))
+      continue
+    }
+
+    const relativePath = path.relative(baseDir, absolutePath).replaceAll(path.sep, '/')
+    files.push({
+      path: relativePath,
+      content: fs.readFileSync(absolutePath, 'utf8'),
+    })
+  }
+
+  return files
+}
+
+const bundle = walk(skillDir, skillDir).sort((left, right) => left.path.localeCompare(right.path))
+console.log(JSON.stringify(bundle, null, 2))
+EOF
+```
+
+Example:
+
+```sh
+node - <<'EOF' "/Users/me/openclaw/workspace/skills/agent-bridge"
+const fs = require('fs')
+const path = require('path')
+
+const skillDir = process.argv[2]
+
+function walk(dir, baseDir) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true })
+  const files = []
+  for (const entry of entries) {
+    if (entry.name === '.af-global-skill.json') continue
+    if (entry.name.startsWith('.')) continue
+    const absolutePath = path.join(dir, entry.name)
+    if (entry.isDirectory()) {
+      files.push(...walk(absolutePath, baseDir))
+      continue
+    }
+    files.push({
+      path: path.relative(baseDir, absolutePath).replaceAll(path.sep, '/'),
+      content: fs.readFileSync(absolutePath, 'utf8'),
+    })
+  }
+  return files
+}
+
+console.log(JSON.stringify(walk(skillDir, skillDir).sort((a, b) => a.path.localeCompare(b.path)), null, 2))
+EOF
+```
+
+The resulting JSON should contain files like:
+- `SKILL.md`
+- `scripts/index.mjs`
+- any extra files such as `scripts/agent-bridge-cli.mjs`
+
 Recommended worker bootstrap order:
 1. restore snapshot into `/data`
 2. fetch `workerGlobalSkillsManifest`

package/dist/client/index.d.ts

@@ -24,9 +24,9 @@ export declare function exposeApi(component: ComponentApi, options: {
         providerConfig: {
             appName: string;
             kind: "fly" | "runpod" | "ecs";
-            region: string;
             organizationSlug: string;
             image: string;
+            region: string;
             volumeName: string;
             volumePath: string;
             volumeSizeGb: number;
@@ -39,14 +39,36 @@ export declare function exposeApi(component: ComponentApi, options: {
             telegramAttachmentRetentionMs?: number | undefined;
         };
     }, Promise<null>>;
+    createMessageTemplate: import("convex/server").RegisteredMutation<"public", {
+        enabled?: boolean | undefined;
+        actorUserId: string;
+        tags: string[];
+        text: string;
+        title: string;
+    }, Promise<any>>;
+    updateMessageTemplate: import("convex/server").RegisteredMutation<"public", {
+        enabled?: boolean | undefined;
+        tags?: string[] | undefined;
+        text?: string | undefined;
+        title?: string | undefined;
+        actorUserId: string;
+        templateId: string;
+    }, Promise<any>>;
+    deleteMessageTemplate: import("convex/server").RegisteredMutation<"public", {
+        templateId: string;
+    }, Promise<any>>;
+    listMessageTemplatesByCompany: import("convex/server").RegisteredQuery<"public", {
+        includeDisabled?: boolean | undefined;
+        limit?: number | undefined;
+    }, Promise<any>>;
     enqueue: import("convex/server").RegisteredMutation<"public", {
         metadata?: Record<string, string> | undefined;
         providerConfig?: {
             appName: string;
             kind: "fly" | "runpod" | "ecs";
-            region: string;
             organizationSlug: string;
             image: string;
+            region: string;
             volumeName: string;
             volumePath: string;
             volumeSizeGb: number;
@@ -56,8 +78,8 @@ export declare function exposeApi(component: ComponentApi, options: {
             sizeBytes?: number | undefined;
             fileName?: string | undefined;
             mimeType?: string | undefined;
-            storageId: string;
             status: "expired" | "ready";
+            storageId: string;
             kind: "photo" | "video" | "audio" | "voice" | "document";
             telegramFileId: string;
             expiresAt: number;
@@ -217,8 +239,8 @@ export declare function exposeApi(component: ComponentApi, options: {
         sizeBytes: number;
     }, Promise<any>>;
     workerFailSnapshotUpload: import("convex/server").RegisteredMutation<"public", {
-        workerId: string;
         error: string;
+        workerId: string;
         snapshotId: string;
     }, Promise<any>>;
     workerLatestSnapshotForRestore: import("convex/server").RegisteredQuery<"public", {
@@ -243,17 +265,21 @@ export declare function exposeApi(component: ComponentApi, options: {
         releaseChannel?: "stable" | "canary" | undefined;
         version: string;
         slug: string;
-        sourceJs: string;
+        files: {
+            content: string;
+            sha256: string;
+            path: string;
+        }[];
     }, Promise<any>>;
     globalSkillsList: import("convex/server").RegisteredQuery<"public", {
+        status?: "active" | "disabled" | undefined;
         limit?: number | undefined;
         releaseChannel?: "stable" | "canary" | undefined;
-        status?: "active" | "disabled" | undefined;
     }, Promise<any>>;
     globalSkillsSetStatus: import("convex/server").RegisteredMutation<"public", {
         actor?: string | undefined;
-        slug: string;
         status: "active" | "disabled";
+        slug: string;
     }, Promise<any>>;
     globalSkillsDelete: import("convex/server").RegisteredMutation<"public", {
         slug: string;
@@ -479,11 +505,11 @@ export declare function exposeApi(component: ComponentApi, options: {
     }, Promise<any>>;
     createPushTemplate: import("convex/server").RegisteredMutation<"public", {
         enabled?: boolean | undefined;
-        companyId: string;
-        periodicity: "manual" | "daily" | "weekly" | "monthly";
+        actorUserId: string;
         text: string;
         title: string;
-        actorUserId: string;
+        companyId: string;
+        periodicity: "manual" | "daily" | "weekly" | "monthly";
         suggestedTimes: ({
             kind: "daily";
             time: string;
@@ -500,9 +526,9 @@ export declare function exposeApi(component: ComponentApi, options: {
     }, Promise<any>>;
     updatePushTemplate: import("convex/server").RegisteredMutation<"public", {
         enabled?: boolean | undefined;
-        periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
         text?: string | undefined;
         title?: string | undefined;
+        periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
         suggestedTimes?: ({
             kind: "daily";
             time: string;
@@ -515,8 +541,8 @@ export declare function exposeApi(component: ComponentApi, options: {
             time: string;
             dayOfMonth: number | "last";
         })[] | undefined;
-        templateId: string;
         actorUserId: string;
+        templateId: string;
     }, Promise<any>>;
     deletePushTemplate: import("convex/server").RegisteredMutation<"public", {
         templateId: string;
@@ -549,6 +575,8 @@ export declare function exposeApi(component: ComponentApi, options: {
     createPushJobCustom: import("convex/server").RegisteredMutation<"public", {
         enabled?: boolean | undefined;
         consumerUserId: string;
+        text: string;
+        title: string;
         companyId: string;
         periodicity: "manual" | "daily" | "weekly" | "monthly";
         schedule: {
@@ -565,12 +593,12 @@ export declare function exposeApi(component: ComponentApi, options: {
             time: string;
             dayOfMonth: number | "last";
         };
-        text: string;
         timezone: string;
-        title: string;
     }, Promise<any>>;
     updatePushJob: import("convex/server").RegisteredMutation<"public", {
         enabled?: boolean | undefined;
+        text?: string | undefined;
+        title?: string | undefined;
         periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
         schedule?: {
             kind: "manual";
@@ -586,9 +614,7 @@ export declare function exposeApi(component: ComponentApi, options: {
             time: string;
             dayOfMonth: number | "last";
         } | undefined;
-        text?: string | undefined;
         timezone?: string | undefined;
-        title?: string | undefined;
         jobId: string;
     }, Promise<any>>;
     deletePushJob: import("convex/server").RegisteredMutation<"public", {
@@ -623,6 +649,12 @@ export declare function exposeApi(component: ComponentApi, options: {
         consumerUserId: string;
         content: string;
     }, Promise<any>>;
+    sendMessageTemplateToUserAgent: import("convex/server").RegisteredMutation<"public", {
+        metadata?: Record<string, string> | undefined;
+        agentKey: string;
+        consumerUserId: string;
+        templateId: string;
+    }, Promise<any>>;
     listSnapshotsForConversation: import("convex/server").RegisteredQuery<"public", {
         limit?: number | undefined;
         conversationId: string;
@@ -670,6 +702,8 @@ export declare function exposeApi(component: ComponentApi, options: {
         enabled?: boolean | undefined;
         agentKey: string;
         consumerUserId: string;
+        text: string;
+        title: string;
         companyId: string;
         periodicity: "manual" | "daily" | "weekly" | "monthly";
         schedule: {
@@ -686,12 +720,12 @@ export declare function exposeApi(component: ComponentApi, options: {
             time: string;
             dayOfMonth: number | "last";
         };
-        text: string;
         timezone: string;
-        title: string;
     }, Promise<any>>;
     updatePushJobForAgent: import("convex/server").RegisteredMutation<"public", {
         enabled?: boolean | undefined;
+        text?: string | undefined;
+        title?: string | undefined;
         periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
         schedule?: {
             kind: "manual";
@@ -707,9 +741,7 @@ export declare function exposeApi(component: ComponentApi, options: {
             time: string;
             dayOfMonth: number | "last";
         } | undefined;
-        text?: string | undefined;
         timezone?: string | undefined;
-        title?: string | undefined;
         agentKey: string;
         consumerUserId: string;
         jobId: string;
@@ -741,9 +773,9 @@ export declare function exposeApi(component: ComponentApi, options: {
         limit?: number | undefined;
     }, Promise<any>>;
     sendBroadcastToAllActiveAgents: import("convex/server").RegisteredMutation<"public", {
-        companyId: string;
         text: string;
         title: string;
+        companyId: string;
         requestedBy: string;
     }, Promise<any>>;
     listPushDispatchesByJob: import("convex/server").RegisteredQuery<"public", {

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAqEhC,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,aAAa,CAAC;AAErB,wBAAgB,SAAS,CACvB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE;IACP,IAAI,EAAE,CACJ,GAAG,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,EACnB,SAAS,EACL;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChB;QACE,IAAI,EAAE,OAAO,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KACF,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAyzC2poB,CAAC;2BAAmC,CAAC;;wBAAiE,CAAC;;wBAAwG,CAAC;yBAAiC,CAAC;;;;;6BAAyK,CAAC;;oBAA+D,CAAC;;;yBAAqH,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAA45N,CAAC;2BAAmC,CAAC;;wBAAiE,CAAC;;wBAAwG,CAAC;yBAAiC,CAAC;;;;;6BAAyK,CAAC;;oBAA+D,CAAC;;;yBAAqH,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA5T7t4B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,YAAY,EACvB,EACE,UAA6B,EAC7B,eAAe,EACf,0BAAiC,EACjC,gBAA4B,EAC5B,yBAAiC,EACjC,cAAc,GACf,GAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IAC9C,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC5B,QAkLP"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAmFhC,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,aAAa,CAAC;AAErB,wBAAgB,SAAS,CACvB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE;IACP,IAAI,EAAE,CACJ,GAAG,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,EACnB,SAAS,EACL;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChB;QACE,IAAI,EAAE,OAAO,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KACF,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAo3CulqB,CAAC;2BAAmC,CAAC;;wBAAiE,CAAC;;wBAAwG,CAAC;yBAAiC,CAAC;;;;;6BAAyK,CAAC;;oBAA+D,CAAC;;;yBAAqH,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAA28N,CAAC;2BAAmC,CAAC;;wBAAiE,CAAC;;wBAAwG,CAAC;yBAAiC,CAAC;;;;;6BAAyK,CAAC;;oBAA+D,CAAC;;;yBAAqH,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA7Txs6B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,YAAY,EACvB,EACE,UAA6B,EAC7B,eAAe,EACf,0BAAiC,EACjC,gBAA4B,EAC5B,yBAAiC,EACjC,cAAc,GACf,GAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IAC9C,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC5B,QAmLP"}

package/dist/client/index.js

@@ -43,6 +43,18 @@ const messageRuntimeConfigValidator = v.object({
     systemPrompt: v.optional(v.string()),
     telegramAttachmentRetentionMs: v.optional(v.number()),
 });
+const messageTemplateValidator = v.object({
+    title: v.string(),
+    text: v.string(),
+    tags: v.array(v.string()),
+    enabled: v.optional(v.boolean()),
+    actorUserId: v.string(),
+});
+const globalSkillManifestFileValidator = v.object({
+    path: v.string(),
+    content: v.string(),
+    sha256: v.string(),
+});
 export { bridgeFunctionKeyFromToolName, executeBridgeFunction, isBridgeToolName, maybeExecuteBridgeToolCall, resolveBridgeRuntimeConfig, } from "./bridge.js";
 export function exposeApi(component, options) {
     return {
@@ -87,6 +99,46 @@ export function exposeApi(component, options) {
                 return null;
             },
         }),
+        createMessageTemplate: mutationGeneric({
+            args: messageTemplateValidator,
+            handler: async (ctx, args) => {
+                await options.auth(ctx, { type: "write" });
+                return await ctx.runMutation(component.lib.createMessageTemplate, args);
+            },
+        }),
+        updateMessageTemplate: mutationGeneric({
+            args: {
+                templateId: v.string(),
+                title: v.optional(v.string()),
+                text: v.optional(v.string()),
+                tags: v.optional(v.array(v.string())),
+                enabled: v.optional(v.boolean()),
+                actorUserId: v.string(),
+            },
+            handler: async (ctx, args) => {
+                await options.auth(ctx, { type: "write" });
+                return await ctx.runMutation(component.lib.updateMessageTemplate, args);
+            },
+        }),
+        deleteMessageTemplate: mutationGeneric({
+            args: {
+                templateId: v.string(),
+            },
+            handler: async (ctx, args) => {
+                await options.auth(ctx, { type: "write" });
+                return await ctx.runMutation(component.lib.deleteMessageTemplate, args);
+            },
+        }),
+        listMessageTemplatesByCompany: queryGeneric({
+            args: {
+                includeDisabled: v.optional(v.boolean()),
+                limit: v.optional(v.number()),
+            },
+            handler: async (ctx, args) => {
+                await options.auth(ctx, { type: "read" });
+                return await ctx.runQuery(component.lib.listMessageTemplatesByCompany, args);
+            },
+        }),
         enqueue: mutationGeneric({
             args: {
                 conversationId: v.string(),
@@ -315,7 +367,7 @@ export function exposeApi(component, options) {
                 displayName: v.optional(v.string()),
                 description: v.optional(v.string()),
                 version: v.string(),
-                sourceJs: v.string(),
+                files: v.array(globalSkillManifestFileValidator),
                 entryPoint: v.optional(v.string()),
                 moduleFormat: v.optional(v.union(v.literal("esm"), v.literal("cjs"))),
                 releaseChannel: v.optional(v.union(v.literal("stable"), v.literal("canary"))),
@@ -852,6 +904,24 @@ export function exposeApi(component, options) {
                 });
             },
         }),
+        sendMessageTemplateToUserAgent: mutationGeneric({
+            args: {
+                consumerUserId: v.string(),
+                agentKey: v.string(),
+                templateId: v.string(),
+                metadata: v.optional(v.record(v.string(), v.string())),
+            },
+            handler: async (ctx, args) => {
+                await options.auth(ctx, {
+                    type: "write",
+                    agentKey: args.agentKey,
+                });
+                return await ctx.runMutation(component.lib.sendMessageTemplateToUserAgent, {
+                    ...args,
+                    providerConfig: options.providerConfig,
+                });
+            },
+        }),
         listSnapshotsForConversation: queryGeneric({
             args: {
                 conversationId: v.string(),
@@ -1151,7 +1221,8 @@ export function registerRoutes(http, component, { pathPrefix = "/agent-factory",
             if (attachmentCandidates.length > 0) {
                 metadata.telegramMediaType = Array.from(new Set(attachmentCandidates.map((attachment) => attachment.kind))).join("+");
                 for (const attachment of attachmentCandidates) {
-                    const metadataKey = `telegram${attachment.kind[0].toUpperCase()}${attachment.kind.slice(1)}FileId`;
+                    const [firstLetter = ""] = attachment.kind;
+                    const metadataKey = `telegram${firstLetter.toUpperCase()}${attachment.kind.slice(1)}FileId`;
                     metadata[metadataKey] = attachment.telegramFileId;
                 }
             }
@@ -1184,7 +1255,7 @@ export function registerRoutes(http, component, { pathPrefix = "/agent-factory",
 }
 function parseStartCommandCode(messageText) {
     const match = messageText.match(/^\/start(?:@\w+)?\s+([A-Za-z0-9_-]{4,128})\s*$/);
-    return match ? match[1] : null;
+    return match?.[1] ?? null;
 }
 function collectTelegramAttachmentCandidates(message) {
     const attachments = [];