rol-websocket-channel 1.5.7 → 1.5.9

package/MQTT-API System.md

@@ -1908,3 +1908,103 @@ MQTT 请求示例：
   }
 }
 ```
+
+---
+
+## apiCoreBot 配置与 Artifact 发布（新增 configSetApiCoreBot；上传链接可返回会话）
+
+### configSetApiCoreBot
+
+作用：前端在需要开启文件上传/下载链接能力时主动调用，写入当前插件的 `apiCoreBot` 配置。这个配置不是配对时写入，只有收到该 MQTT 消息后才会更新 `openclaw.json`。
+
+写入位置：
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "rol-websocket-channel": {
+        "config": {
+          "apiCoreBot": {
+            "baseUrl": "http://192.168.1.23:9092",
+            "authToken": "123"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+默认值：
+
+- `baseUrl`: `http://192.168.1.23:9092`
+- `authToken`: `123`
+
+MQTT 请求示例：
+
+```json
+{
+  "type": "configSetApiCoreBot",
+  "trace_id": "config-api-core-bot-001",
+  "data": {}
+}
+```
+
+如果前端需要覆盖默认值，也可以显式传入：
+
+```json
+{
+  "type": "configSetApiCoreBot",
+  "trace_id": "config-api-core-bot-002",
+  "data": {
+    "baseUrl": "http://192.168.1.23:9092",
+    "authToken": "123"
+  }
+}
+```
+
+成功返回示例：
+
+```json
+{
+  "type": "receiver",
+  "trace_id": "config-api-core-bot-001",
+  "source": "system",
+  "success": true,
+  "data": {
+    "ok": true,
+    "configFile": "/home/woowonjae/.openclaw/openclaw.json",
+    "updated": [
+      "plugins.entries.rol-websocket-channel.config.apiCoreBot.baseUrl",
+      "plugins.entries.rol-websocket-channel.config.apiCoreBot.authToken"
+    ],
+    "apiCoreBot": {
+      "baseUrl": "http://192.168.1.23:9092",
+      "authToken": "********"
+    }
+  }
+}
+```
+
+### Artifact 发布链路
+
+`configSetApiCoreBot` 写入成功后，Artifact 发布方法会从 `openclaw.json` 读取 `apiCoreBot.baseUrl` 和 `apiCoreBot.authToken`，再调用上传接口。小龙虾会话如果调用插件工具 `rol_artifacts_publish`，成功后会拿到可返回给用户的下载链接。
+
+成功返回中的核心字段：
+
+```json
+{
+  "ok": true,
+  "uploaded": true,
+  "artifactId": "art_91f6d03e144c",
+  "objectKey": "uploads/91a78677-5e79-4259-a28d-fa01f24d4848.svg",
+  "downloadUrl": "https://draft-user.s3.us-east-2.amazonaws.com/uploads/91a78677-5e79-4259-a28d-fa01f24d4848.svg"
+}
+```
+
+注意：
+
+- 如果没有先调用 `configSetApiCoreBot`，发布时可能返回 `apiCoreBot.baseUrl is not configured`。
+- `authToken` 在返回值中会脱敏显示，实际写入 `openclaw.json` 的值是 `123` 或前端传入的值。
+- 生成文件本身仍然在 `.openclaw/workspace` 下，上传只在发布/下载链路触发时执行。

package/dist/index.js

@@ -1,9 +1,11 @@
 // extensions/rol-websocket-channel/index.ts
 // WebSocket Channel 插件实现
 // 提供基于 WebSocket 的双向通信能力，支持 AI 回复和主动消息
+import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
 import { messageHandler } from "./message-handler.js";
 import { GlobalMqttClient } from "./src/mqtt/mqtt-client.js";
 import * as ConnectionManager from "./src/mqtt/connection-manager.js";
+import { registerArtifactsTools } from "./src/admin/tools/artifacts-tools.js";
 // ============================================
 // 3. 全局状态
 // ============================================
@@ -558,14 +560,30 @@ async function handleCustomMessageType(msgType, innerData, traceId, accountId, m
 // ============================================
 // 6. 插件注册入口
 // ============================================
-let isPluginRegistered = false;
-export default function register(api) {
+export default defineChannelPluginEntry({
+    id: "rol-websocket-channel",
+    name: "WebSocket Channel",
+    description: "Unified plugin providing MQTT Channel and Admin Bridge capabilities for OpenClaw management",
+    plugin: WebSocketChannel,
+    setRuntime(runtime) {
+        pluginRuntime = runtime;
+        initializeContext();
+    },
+    registerCliMetadata(api) {
+        registerAdminBridgeCli(api);
+    },
+    registerFull(api) {
+        registerArtifactsTools(api);
+    },
+});
+let legacyIsPluginRegistered = false;
+function legacyRegister(api) {
     console.log("[mqtt] Register rol-websocket-channel");
-    if (isPluginRegistered) {
+    if (legacyIsPluginRegistered) {
         return;
     }
     console.log("[mqtt] Register rol-websocket-channel real");
-    isPluginRegistered = true;
+    legacyIsPluginRegistered = true;
     pluginRuntime = api.runtime;
     // 初始化共享 context
     initializeContext();

package/dist/message-handler.js

@@ -4,7 +4,7 @@
  */
 import { getContext } from './src/shared/context.js';
 import { wrapAdminCall } from './src/shared/wrapper.js';
-import { getAgents, getConfig } from './src/admin/methods/admin.js';
+import { getAgents, getConfig, setApiCoreBotConfig } from './src/admin/methods/admin.js';
 import { createAgent, deleteAgent, listAgents, updateAgent } from './src/admin/methods/agents-extended.js';
 import { createArtifactRecord, ensureArtifactUploaded, getArtifactContent, getArtifactPresignedPost, listArtifacts, markArtifactUploaded, refreshArtifacts } from './src/admin/methods/artifacts.js';
 import { addCron, disableCron, enableCron, getCronStatus, listCron, listCronRuns, renameCron, removeCron, rescheduleCron, runCron, setCronContent, updateCronMessage, updateCronSystemEvent } from './src/admin/methods/cron.js';
@@ -77,6 +77,12 @@ export class MessageHandler {
             return await getConfig(data, context);
         });
     }
+    async configSetApiCoreBot(data) {
+        return wrapAdminCall(async () => {
+            const context = getContext();
+            return await setApiCoreBotConfig(data, context);
+        });
+    }
     async cronList(data) {
         return wrapAdminCall(async () => {
             const context = getContext();

package/dist/src/admin/cli-manifest.test.js

@@ -1,19 +1,37 @@
 import assert from 'node:assert/strict';
 import { readFileSync } from 'node:fs';
 import test from 'node:test';
-import register, { formatCliErrorPayload } from '../../index.js';
+import entry, { formatCliErrorPayload } from '../../index.js';
 const manifest = JSON.parse(readFileSync(new URL('../../openclaw.plugin.json', import.meta.url), 'utf8'));
+const packageJson = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
 test('manifest declares OpenClaw 2026 command ownership for admin bridge CLI', () => {
     assert.deepEqual(manifest.activation?.onCommands, ['admin-bridge', 'rol-websocket-channel']);
     assert.deepEqual(manifest.commandAliases, [
         { name: 'admin-bridge' },
         { name: 'rol-websocket-channel' }
     ]);
+    assert.deepEqual(manifest.contracts?.tools, [
+        'rol_artifacts_find_latest',
+        'rol_artifacts_publish'
+    ]);
+});
+test('package.json declares official OpenClaw runtime metadata', () => {
+    assert.deepEqual(packageJson.openclaw?.extensions, ['./index.ts']);
+    assert.deepEqual(packageJson.openclaw?.runtimeExtensions, ['./dist/index.js']);
+    assert.deepEqual(packageJson.openclaw?.compat, {
+        pluginApi: '>=2026.5.7',
+        minGatewayVersion: '2026.5.7'
+    });
+    assert.deepEqual(packageJson.openclaw?.build, {
+        openclawVersion: '2026.5.7',
+        pluginSdkVersion: '2026.5.7'
+    });
 });
-test('runtime CLI registrar exposes admin-bridge and rol-websocket-channel command roots', () => {
+test('runtime entry exposes admin-bridge CLI roots and registers artifacts tools in full mode', () => {
     const descriptors = [];
     const commands = [];
     const aliases = [];
+    const registeredTools = [];
     const commandNode = {
         alias(name) {
             aliases.push(name);
@@ -37,14 +55,18 @@ test('runtime CLI registrar exposes admin-bridge and rol-websocket-channel comma
         }
     };
     const api = {
+        registrationMode: 'full',
         runtime: {},
         registerChannel() { },
+        registerTool(tool) {
+            registeredTools.push(tool);
+        },
         registerCli(callback, options) {
             descriptors.push(...options.descriptors);
             callback({ program: commandNode });
         }
     };
-    register(api);
+    entry.register(api);
     assert.deepEqual(descriptors, [
         {
             name: 'admin-bridge',
@@ -59,6 +81,21 @@ test('runtime CLI registrar exposes admin-bridge and rol-websocket-channel comma
     ]);
     assert.equal(commands[0], 'admin-bridge');
     assert.equal(aliases[0], 'rol-websocket-channel');
+    assert.equal(registeredTools.length, 1);
+});
+test('CLI metadata mode skips full-only tool registration', () => {
+    let registerToolCalled = false;
+    const api = {
+        registrationMode: 'cli-metadata',
+        runtime: {},
+        registerChannel() { },
+        registerTool() {
+            registerToolCalled = true;
+        },
+        registerCli() { }
+    };
+    entry.register(api);
+    assert.equal(registerToolCalled, false);
 });
 test('CLI error formatter preserves diagnostic data for pairing failures', () => {
     const error = new Error('mqttUrl is missing from pairing payload');

package/dist/src/admin/methods/admin.js

@@ -1,5 +1,9 @@
 import path from 'node:path';
-import { readJsonFile } from '../lib/fs.js';
+import { readJsonFile, writeJsonFile } from '../lib/fs.js';
+import { JsonRpcException, JSON_RPC_ERRORS } from '../jsonrpc.js';
+const DEFAULT_PLUGIN_ID = 'rol-websocket-channel';
+const DEFAULT_API_CORE_BOT_BASE_URL = 'http://192.168.1.23:9092';
+const DEFAULT_API_CORE_BOT_AUTH_TOKEN = '123';
 export const getAgents = async (_params, context) => {
     const configPath = path.join(context.openclawRoot, 'openclaw.json');
     const config = await readJsonFile(configPath);
@@ -28,6 +32,57 @@ export const getConfig = async (params, context) => {
         sectionValue: value === undefined ? null : redactSecrets(value)
     };
 };
+export const setApiCoreBotConfig = async (params, context) => {
+    const objectParams = isObject(params) ? params : {};
+    const baseUrl = typeof objectParams.baseUrl === 'string'
+        ? objectParams.baseUrl.trim().replace(/\/+$/, '')
+        : DEFAULT_API_CORE_BOT_BASE_URL;
+    const authToken = typeof objectParams.authToken === 'string' && objectParams.authToken.trim()
+        ? objectParams.authToken.trim()
+        : DEFAULT_API_CORE_BOT_AUTH_TOKEN;
+    if (!baseUrl) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'apiCoreBot.baseUrl is required');
+    }
+    const configPath = path.join(context.openclawRoot, 'openclaw.json');
+    const config = await readJsonFile(configPath);
+    if (!config.plugins)
+        config.plugins = {};
+    if (!config.plugins.entries || typeof config.plugins.entries !== 'object') {
+        config.plugins.entries = {};
+    }
+    const existingEntry = isObject(config.plugins.entries[DEFAULT_PLUGIN_ID])
+        ? config.plugins.entries[DEFAULT_PLUGIN_ID]
+        : {};
+    const existingPluginConfig = isObject(existingEntry.config) ? existingEntry.config : {};
+    const existingApiCoreBot = isObject(existingPluginConfig.apiCoreBot)
+        ? existingPluginConfig.apiCoreBot
+        : {};
+    const nextApiCoreBot = {
+        ...existingApiCoreBot,
+        baseUrl
+    };
+    if (authToken) {
+        nextApiCoreBot.authToken = authToken;
+    }
+    config.plugins.entries[DEFAULT_PLUGIN_ID] = {
+        ...existingEntry,
+        enabled: existingEntry.enabled === false ? false : true,
+        config: {
+            ...existingPluginConfig,
+            apiCoreBot: nextApiCoreBot
+        }
+    };
+    await writeJsonFile(configPath, config);
+    return {
+        ok: true,
+        configFile: configPath,
+        updated: [
+            `plugins.entries.${DEFAULT_PLUGIN_ID}.config.apiCoreBot.baseUrl`,
+            ...(authToken ? [`plugins.entries.${DEFAULT_PLUGIN_ID}.config.apiCoreBot.authToken`] : [])
+        ],
+        apiCoreBot: redactSecrets(nextApiCoreBot)
+    };
+};
 function isObject(value) {
     return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 }

package/dist/src/admin/methods/admin.test.js

@@ -0,0 +1,64 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { setApiCoreBotConfig } from './admin.js';
+test('setApiCoreBotConfig writes apiCoreBot endpoint without changing pairing or channel config', async () => {
+    const context = await createMethodContext();
+    const configPath = path.join(context.openclawRoot, 'openclaw.json');
+    await fs.writeFile(configPath, JSON.stringify({
+        plugins: {
+            entries: {
+                'rol-websocket-channel': {
+                    enabled: true,
+                    config: {
+                        pairing: {
+                            paired: true,
+                            pairingKeyLast4: '7a46'
+                        }
+                    }
+                }
+            }
+        },
+        channels: {
+            'rol-websocket-channel': {
+                enabled: true,
+                config: {
+                    mqttUrl: 'ws://mqtt.example.test:8083/mqtt'
+                }
+            }
+        }
+    }, null, 2));
+    const result = await setApiCoreBotConfig({
+        baseUrl: 'https://api.example.test/',
+        authToken: 'secret-token'
+    }, context);
+    const savedConfig = JSON.parse(await fs.readFile(configPath, 'utf8'));
+    assert.equal(result.ok, true);
+    assert.equal(result.apiCoreBot.baseUrl, 'https://api.example.test');
+    assert.equal(result.apiCoreBot.authToken, 'secr***oken');
+    assert.equal(savedConfig.plugins.entries['rol-websocket-channel'].config.apiCoreBot.baseUrl, 'https://api.example.test');
+    assert.equal(savedConfig.plugins.entries['rol-websocket-channel'].config.apiCoreBot.authToken, 'secret-token');
+    assert.equal(savedConfig.plugins.entries['rol-websocket-channel'].config.pairing.pairingKeyLast4, '7a46');
+    assert.equal(savedConfig.channels['rol-websocket-channel'].config.mqttUrl, 'ws://mqtt.example.test:8083/mqtt');
+});
+test('setApiCoreBotConfig uses default apiCoreBot values when omitted', async () => {
+    const context = await createMethodContext();
+    await fs.writeFile(path.join(context.openclawRoot, 'openclaw.json'), '{}');
+    const result = await setApiCoreBotConfig({}, context);
+    const savedConfig = JSON.parse(await fs.readFile(path.join(context.openclawRoot, 'openclaw.json'), 'utf8'));
+    assert.equal(result.apiCoreBot.baseUrl, 'http://192.168.1.23:9092');
+    assert.equal(result.apiCoreBot.authToken, '********');
+    assert.equal(savedConfig.plugins.entries['rol-websocket-channel'].config.apiCoreBot.baseUrl, 'http://192.168.1.23:9092');
+    assert.equal(savedConfig.plugins.entries['rol-websocket-channel'].config.apiCoreBot.authToken, '123');
+});
+async function createMethodContext() {
+    const projectRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'api-core-bot-config-test-'));
+    const openclawRoot = path.join(projectRoot, '.openclaw');
+    await fs.mkdir(openclawRoot, { recursive: true });
+    return {
+        projectRoot,
+        openclawRoot
+    };
+}

package/dist/src/admin/methods/artifacts.js

@@ -169,6 +169,45 @@ export const ensureArtifactUploaded = async (params, context) => {
         item: artifactToJsonValue(updated)
     };
 };
+export const publishArtifact = async (params, context) => {
+    const objectParams = expectObject(params);
+    const refresh = objectParams.refresh !== false;
+    const artifact = await resolveArtifact(objectParams, context, {
+        refreshManifest: refresh
+    });
+    const uploadParams = {
+        artifactId: artifact.id
+    };
+    if (objectParams.presignedPostBody !== undefined) {
+        uploadParams.presignedPostBody = objectParams.presignedPostBody;
+    }
+    if (objectParams.baseUrl !== undefined) {
+        uploadParams.baseUrl = objectParams.baseUrl;
+    }
+    if (objectParams.authToken !== undefined) {
+        uploadParams.authToken = objectParams.authToken;
+    }
+    return await ensureArtifactUploaded(uploadParams, context);
+};
+export const findLatestArtifacts = async (params, context) => {
+    const objectParams = expectOptionalObject(params);
+    const refresh = objectParams.refresh !== false;
+    const manifest = refresh
+        ? await refreshArtifactManifest(context)
+        : await readOrRefreshArtifactManifest(context);
+    const filters = normalizeArtifactFindFilters(objectParams);
+    const items = manifest.items
+        .filter((item) => matchesArtifactFindFilters(item, filters))
+        .sort(compareArtifactsByRecency)
+        .slice(0, filters.limit)
+        .map(artifactToJsonValue);
+    return {
+        ok: true,
+        scope: 'workspace',
+        count: items.length,
+        items
+    };
+};
 export const getArtifactPresignedPost = async (params, context) => {
     const objectParams = expectObject(params);
     const body = isObject(objectParams.body) ? objectParams.body : null;
@@ -403,8 +442,10 @@ async function collectArtifactFiles(rootDir) {
     }
     return files;
 }
-async function resolveArtifact(params, context) {
-    const manifest = await readOrRefreshArtifactManifest(context);
+async function resolveArtifact(params, context, options) {
+    const manifest = options?.refreshManifest
+        ? await refreshArtifactManifest(context)
+        : await readOrRefreshArtifactManifest(context);
     const artifact = findArtifact(manifest.items, params);
     if (!artifact) {
         throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'Artifact not found', {
@@ -590,6 +631,84 @@ function expectString(value, fieldName) {
 function optionalTrimmedString(value) {
     return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null;
 }
+function normalizeArtifactFindFilters(params) {
+    return {
+        category: normalizeArtifactCategory(optionalTrimmedString(params.category)),
+        mimeType: normalizeOptionalLowercaseString(params.mimeType),
+        fileName: normalizeOptionalLowercaseString(params.fileName),
+        relativePathPrefix: normalizeRelativePath(optionalTrimmedString(params.relativePathPrefix)),
+        createdAfterMs: normalizeOptionalTimestamp(params.createdAfter),
+        limit: normalizeArtifactLimit(params.limit)
+    };
+}
+function normalizeArtifactCategory(value) {
+    if (!value) {
+        return null;
+    }
+    if (value === 'image' ||
+        value === 'video' ||
+        value === 'document' ||
+        value === 'archive' ||
+        value === 'other') {
+        return value;
+    }
+    throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, `Unsupported artifact category: ${value}`);
+}
+function normalizeOptionalLowercaseString(value) {
+    const normalized = optionalTrimmedString(value);
+    return normalized ? normalized.toLowerCase() : null;
+}
+function normalizeOptionalTimestamp(value) {
+    if (value === undefined) {
+        return null;
+    }
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'createdAfter must be a non-empty ISO timestamp');
+    }
+    const timestamp = Date.parse(value);
+    if (Number.isNaN(timestamp)) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'createdAfter must be a valid ISO timestamp');
+    }
+    return timestamp;
+}
+function normalizeArtifactLimit(value) {
+    if (value === undefined) {
+        return 5;
+    }
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new JsonRpcException(JSON_RPC_ERRORS.invalidParams, 'limit must be a positive number');
+    }
+    return Math.min(50, Math.floor(value));
+}
+function matchesArtifactFindFilters(item, filters) {
+    if (filters.category && item.category !== filters.category) {
+        return false;
+    }
+    if (filters.mimeType && item.mimeType.toLowerCase() !== filters.mimeType) {
+        return false;
+    }
+    if (filters.fileName && item.fileName.toLowerCase() !== filters.fileName) {
+        return false;
+    }
+    if (filters.relativePathPrefix && !item.relativePath.startsWith(filters.relativePathPrefix)) {
+        return false;
+    }
+    if (filters.createdAfterMs !== null && Date.parse(item.createdAt) <= filters.createdAfterMs) {
+        return false;
+    }
+    return true;
+}
+function compareArtifactsByRecency(left, right) {
+    const createdDelta = Date.parse(right.createdAt) - Date.parse(left.createdAt);
+    if (createdDelta !== 0) {
+        return createdDelta;
+    }
+    const updatedDelta = Date.parse(right.updatedAt) - Date.parse(left.updatedAt);
+    if (updatedDelta !== 0) {
+        return updatedDelta;
+    }
+    return left.fileName.localeCompare(right.fileName);
+}
 function isObject(value) {
     return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 }

package/dist/src/admin/methods/artifacts.test.js

@@ -3,7 +3,7 @@ import assert from 'node:assert/strict';
 import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
-import { ensureArtifactUploaded, listArtifacts, markArtifactUploaded, refreshArtifacts } from './artifacts.js';
+import { ensureArtifactUploaded, findLatestArtifacts, listArtifacts, markArtifactUploaded, publishArtifact, refreshArtifacts } from './artifacts.js';
 const tempDirs = [];
 const originalFetch = globalThis.fetch;
 afterEach(async () => {
@@ -181,6 +181,90 @@ describe('artifacts workspace scope', () => {
         assert.equal(ensured.item.storageStatus, 'uploaded');
         assert.equal(ensured.item.fileUrl, 'https://cdn.example.com/artifacts/me.pdf');
     });
+    test('findLatest returns newest matching artifacts with filters', async () => {
+        const context = await createMethodContext();
+        const workspaceRoot = path.join(context.openclawRoot, 'workspace');
+        await fs.mkdir(path.join(workspaceRoot, 'exports'), { recursive: true });
+        await fs.writeFile(path.join(workspaceRoot, 'exports', 'first.pdf'), 'pdf-data', 'utf8');
+        await new Promise((resolve) => setTimeout(resolve, 20));
+        await fs.writeFile(path.join(workspaceRoot, 'exports', 'second.png'), 'png-data', 'utf8');
+        await new Promise((resolve) => setTimeout(resolve, 20));
+        await fs.writeFile(path.join(workspaceRoot, 'exports', 'third.docx'), 'docx-data', 'utf8');
+        const latest = await findLatestArtifacts({
+            category: 'document',
+            relativePathPrefix: 'exports/',
+            limit: 2
+        }, context);
+        assert.equal(latest.ok, true);
+        assert.equal(latest.count, 2);
+        assert.deepEqual(latest.items.map((item) => item.fileName), ['third.docx', 'first.pdf']);
+        assert.deepEqual(latest.items.map((item) => item.category), ['document', 'document']);
+        assert.deepEqual(latest.items.map((item) => item.relativePath), ['exports/third.docx', 'exports/first.pdf']);
+    });
+    test('publish refreshes manifest for a new file and uploads it by relativePath', async () => {
+        const context = await createMethodContext();
+        const workspaceRoot = path.join(context.openclawRoot, 'workspace');
+        const artifactPath = path.join(workspaceRoot, 'generated', 'result.pdf');
+        await writeApiCoreBotConfig(context.openclawRoot, 'https://api.example.com');
+        await fs.mkdir(path.dirname(artifactPath), { recursive: true });
+        await fs.writeFile(artifactPath, 'pdf-data', 'utf8');
+        const calls = [];
+        globalThis.fetch = (async (input, init) => {
+            const url = typeof input === 'string'
+                ? input
+                : input instanceof URL
+                    ? input.toString()
+                    : input.url;
+            const method = init?.method ?? (input instanceof Request ? input.method : 'GET');
+            calls.push({ url, method });
+            if (url === 'https://api.example.com/api-core-bot/front/s3/get-presigned-post') {
+                const parsedBody = JSON.parse(String(init?.body));
+                assert.equal(parsedBody.filename, 'result.pdf');
+                assert.equal(parsedBody.dir, 'generated/');
+                return new Response(JSON.stringify({
+                    success: true,
+                    data: {
+                        url: 'https://upload.example.com',
+                        fields: {
+                            key: 'generated/result.pdf',
+                            policy: 'policy-token'
+                        },
+                        file_url: 'https://cdn.example.com/generated/result.pdf'
+                    }
+                }), {
+                    status: 200,
+                    headers: { 'Content-Type': 'application/json' }
+                });
+            }
+            if (url === 'https://upload.example.com') {
+                assert.ok(init?.body instanceof FormData);
+                return new Response(null, { status: 204 });
+            }
+            throw new Error(`Unexpected fetch call: ${url}`);
+        });
+        const published = await publishArtifact({
+            relativePath: 'generated/result.pdf',
+            presignedPostBody: {
+                dir: 'generated/'
+            }
+        }, context);
+        assert.equal(published.ok, true);
+        assert.equal(published.uploaded, true);
+        assert.equal(published.downloadUrl, 'https://cdn.example.com/generated/result.pdf');
+        assert.equal(published.item.relativePath, 'generated/result.pdf');
+        assert.equal(published.item.storageStatus, 'uploaded');
+        assert.match(published.artifactId, /^art_/);
+        assert.deepEqual(calls, [
+            {
+                url: 'https://api.example.com/api-core-bot/front/s3/get-presigned-post',
+                method: 'POST'
+            },
+            {
+                url: 'https://upload.example.com',
+                method: 'POST'
+            }
+        ]);
+    });
 });
 async function createMethodContext() {
     const rootDir = await fs.mkdtemp(path.join(os.tmpdir(), 'artifacts-task-scope-'));

package/dist/src/admin/methods/index.js

@@ -1,7 +1,7 @@
 import { JsonRpcException, JSON_RPC_ERRORS } from '../jsonrpc.js';
-import { getAgents, getConfig } from './admin.js';
+import { getAgents, getConfig, setApiCoreBotConfig } from './admin.js';
 import { createAgent, deleteAgent, listAgents, updateAgent } from './agents-extended.js';
-import { createArtifactRecord, ensureArtifactUploaded, getArtifactContent, getArtifactPresignedPost, listArtifacts, markArtifactUploaded, refreshArtifacts } from './artifacts.js';
+import { createArtifactRecord, ensureArtifactUploaded, findLatestArtifacts, getArtifactContent, getArtifactPresignedPost, listArtifacts, markArtifactUploaded, publishArtifact, refreshArtifacts } from './artifacts.js';
 import { addCron, disableCron, enableCron, getCronStatus, listCron, listCronRuns, renameCron, removeCron, rescheduleCron, runCron, setCronContent, updateCronMessage, updateCronSystemEvent } from './cron.js';
 import { backupMemory, createMemoryBackupRecord, exportMemoryZip, getMemoryPresignedPost, getMemoryFile, importMemoryZip, listMemoryFiles } from './memory.js';
 import { getMem9Config, installMem9, reconnectMem9 } from './mem9.js';
@@ -30,6 +30,7 @@ const methods = new Map([
     ['agents.update', updateAgent],
     // Config
     ['config.get', getConfig],
+    ['config.setApiCoreBot', setApiCoreBotConfig],
     // Cron
     ['cron.list', listCron],
     ['cron.status', getCronStatus],
@@ -82,6 +83,8 @@ const methods = new Map([
     ['artifacts.refresh', refreshArtifacts],
     ['artifacts.getContent', getArtifactContent],
     ['artifacts.ensureUploaded', ensureArtifactUploaded],
+    ['artifacts.findLatest', findLatestArtifacts],
+    ['artifacts.publish', publishArtifact],
     ['artifacts.getPresignedPost', getArtifactPresignedPost],
     ['artifacts.createRecord', createArtifactRecord],
     ['artifacts.markUploaded', markArtifactUploaded],

package/dist/src/admin/methods/index.test.js

@@ -0,0 +1,15 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { findLatestArtifacts, publishArtifact } from './artifacts.js';
+import { setApiCoreBotConfig } from './admin.js';
+import { getMethod, listMethods } from './index.js';
+test('methods registry exposes local artifact discovery and publish methods', () => {
+    assert.equal(getMethod('artifacts.findLatest'), findLatestArtifacts);
+    assert.equal(getMethod('artifacts.publish'), publishArtifact);
+    assert.ok(listMethods().includes('artifacts.findLatest'));
+    assert.ok(listMethods().includes('artifacts.publish'));
+});
+test('methods registry exposes apiCoreBot config writer', () => {
+    assert.equal(getMethod('config.setApiCoreBot'), setApiCoreBotConfig);
+    assert.ok(listMethods().includes('config.setApiCoreBot'));
+});