openclaw-overlay-plugin 0.8.14 → 0.8.16

package/dist/src/scripts/wallet/setup.js

@@ -1,119 +0,0 @@
-/**
- * Wallet setup commands: setup, identity, address.
- */
-import fs from 'node:fs';
-import { NETWORK, WALLET_DIR, OVERLAY_URL, PATHS } from '../config.js';
-import { ok, fail } from '../output.js';
-import { loadWalletIdentity, deriveWalletAddress } from './identity.js';
-import { BSVAgentWallet } from '../../core/index.js';
-async function getBSVAgentWallet() {
-    return BSVAgentWallet;
-}
-// Dynamic import for @bsv/sdk
-let _sdk = null;
-async function getSdk() {
-    if (_sdk)
-        return _sdk;
-    try {
-        _sdk = await import('@bsv/sdk');
-        return _sdk;
-    }
-    catch {
-        const { fileURLToPath } = await import('node:url');
-        const path = await import('node:path');
-        const os = await import('node:os');
-        const __dirname = path.dirname(fileURLToPath(import.meta.url));
-        const candidates = [
-            path.resolve(__dirname, '..', '..', '..', 'node_modules', '@bsv', 'sdk', 'dist', 'esm', 'mod.js'),
-            path.resolve(__dirname, '..', '..', '..', '..', '..', 'a2a-bsv', 'packages', 'core', 'node_modules', '@bsv', 'sdk', 'dist', 'esm', 'mod.js'),
-            path.resolve(os.homedir(), 'a2a-bsv', 'packages', 'core', 'node_modules', '@bsv', 'sdk', 'dist', 'esm', 'mod.js'),
-        ];
-        for (const p of candidates) {
-            try {
-                _sdk = await import(p);
-                return _sdk;
-            }
-            catch {
-                // Try next
-            }
-        }
-        throw new Error('Cannot find @bsv/sdk. Run setup.sh first.');
-    }
-}
-/**
- * Setup command: create wallet and show identity.
- */
-export async function cmdSetup() {
-    const BSVAgentWallet = await getBSVAgentWallet();
-    if (fs.existsSync(PATHS.walletIdentity)) {
-        const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
-        const identityKey = await wallet.getIdentityKey();
-        await wallet.destroy();
-        return ok({
-            identityKey,
-            walletDir: WALLET_DIR,
-            network: NETWORK,
-            overlayUrl: OVERLAY_URL,
-            alreadyExisted: true,
-        });
-    }
-    fs.mkdirSync(WALLET_DIR, { recursive: true });
-    const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
-    const identityKey = await wallet.getIdentityKey();
-    await wallet.destroy();
-    // Restrict permissions on wallet-identity.json (contains private key)
-    if (fs.existsSync(PATHS.walletIdentity)) {
-        fs.chmodSync(PATHS.walletIdentity, 0o600);
-    }
-    return ok({
-        identityKey,
-        walletDir: WALLET_DIR,
-        network: NETWORK,
-        overlayUrl: OVERLAY_URL,
-        alreadyExisted: false,
-    });
-}
-/**
- * Identity command: show identity public key.
- */
-export async function cmdIdentity() {
-    const BSVAgentWallet = await getBSVAgentWallet();
-    const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
-    const identityKey = await wallet.getIdentityKey();
-    await wallet.destroy();
-    return ok({ identityKey });
-}
-/**
- * Status command: show identity and balance.
- */
-export async function cmdStatus() {
-    const BSVAgentWallet = await getBSVAgentWallet();
-    const wallet = await BSVAgentWallet.load({ network: NETWORK, storageDir: WALLET_DIR });
-    const identityKey = await wallet.getIdentityKey();
-    const total = await wallet.getBalance();
-    await wallet.destroy();
-    return ok({
-        identity: { identityKey, network: NETWORK },
-        balance: { walletBalance: total }
-    });
-}
-/**
- * Address command: show P2PKH receive address.
- */
-export async function cmdAddress() {
-    if (!fs.existsSync(PATHS.walletIdentity)) {
-        return fail('Wallet not initialized. Run: setup');
-    }
-    const sdk = await getSdk();
-    const identity = loadWalletIdentity();
-    const privKey = sdk.PrivateKey.fromHex(identity.rootKeyHex);
-    const { address } = await deriveWalletAddress(privKey);
-    return ok({
-        address,
-        network: NETWORK,
-        identityKey: identity.identityKey,
-        note: NETWORK === 'mainnet'
-            ? `Fund this address at an exchange — Explorer: https://whatsonchain.com/address/${address}`
-            : `Fund via faucet: https://witnessonchain.com/faucet/tbsv — Explorer: https://test.whatsonchain.com/address/${address}`,
-    });
-}

package/dist/src/scripts/x-verification/commands.d.ts

@@ -1,27 +0,0 @@
-/**
- * X (Twitter) verification commands.
- */
-/**
- * Start X verification: generate a tweet with identity key and signature.
- */
-export declare function cmdXVerifyStart(handleArg: string | undefined): Promise<any>;
-/**
- * Complete X verification by checking the posted tweet.
- */
-export declare function cmdXVerifyComplete(tweetUrl: string | undefined): Promise<any>;
-/**
- * List verified X accounts (local cache).
- */
-export declare function cmdXVerifications(): Promise<any>;
-/**
- * Lookup X verifications from the overlay network.
- */
-export declare function cmdXLookup(query: string | undefined): Promise<any>;
-/**
- * List pending X engagement requests.
- */
-export declare function cmdXEngagementQueue(): Promise<any>;
-/**
- * Mark an X engagement request as fulfilled.
- */
-export declare function cmdXEngagementFulfill(requestId: string | undefined, proofUrl?: string): Promise<any>;

package/dist/src/scripts/x-verification/commands.js

@@ -1,222 +0,0 @@
-/**
- * X (Twitter) verification commands.
- */
-import fs from 'node:fs';
-import { PROTOCOL_ID, TOPICS, LOOKUP_SERVICES, PATHS } from '../config.js';
-import { ok, fail } from '../output.js';
-import { loadIdentity } from '../wallet/identity.js';
-import { loadXVerifications, saveXVerifications, readJsonl, ensureStateDir } from '../utils/storage.js';
-import { buildRealOverlayTransaction, lookupOverlay } from '../overlay/transaction.js';
-// Dynamic import for @bsv/sdk
-let _sdk = null;
-async function getSdk() {
-    if (_sdk)
-        return _sdk;
-    try {
-        _sdk = await import('@bsv/sdk');
-        return _sdk;
-    }
-    catch {
-        const { fileURLToPath } = await import('node:url');
-        const path = await import('node:path');
-        const os = await import('node:os');
-        const __dirname = path.dirname(fileURLToPath(import.meta.url));
-        const candidates = [
-            path.resolve(__dirname, '..', '..', '..', 'node_modules', '@bsv', 'sdk', 'dist', 'esm', 'mod.js'),
-            path.resolve(__dirname, '..', '..', '..', '..', '..', 'a2a-bsv', 'packages', 'core', 'node_modules', '@bsv', 'sdk', 'dist', 'esm', 'mod.js'),
-            path.resolve(os.homedir(), 'a2a-bsv', 'packages', 'core', 'node_modules', '@bsv', 'sdk', 'dist', 'esm', 'mod.js'),
-        ];
-        for (const p of candidates) {
-            try {
-                _sdk = await import(p);
-                return _sdk;
-            }
-            catch {
-                // Try next
-            }
-        }
-        throw new Error('Cannot find @bsv/sdk. Run setup.sh first.');
-    }
-}
-/**
- * Start X verification: generate a tweet with identity key and signature.
- */
-export async function cmdXVerifyStart(handleArg) {
-    if (!handleArg) {
-        return fail('Usage: x-verify-start <@handle>');
-    }
-    const sdk = await getSdk();
-    const handle = handleArg.startsWith('@') ? handleArg : `@${handleArg}`;
-    const { identityKey, privKey } = await loadIdentity();
-    // Sign the verification message
-    const message = `Verify ${identityKey}`;
-    const msgHash = sdk.Hash.sha256(Array.from(new TextEncoder().encode(message)));
-    const sig = privKey.sign(msgHash);
-    const signatureHex = Array.from(sig.toDER()).map((b) => b.toString(16).padStart(2, '0')).join('');
-    // Save pending verification
-    const pending = {
-        identityKey,
-        handle,
-        signature: signatureHex,
-        message,
-        createdAt: new Date().toISOString(),
-    };
-    ensureStateDir();
-    fs.writeFileSync(PATHS.pendingXVerification, JSON.stringify(pending, null, 2));
-    // Build tweet text (under 280 chars)
-    // Use shortened signature (first 40 chars) to fit in tweet
-    const tweetText = `BSV Agent Verify: ${identityKey.slice(0, 10)}...${identityKey.slice(-10)} sig:${signatureHex.slice(0, 40)}`;
-    return ok({
-        tweetText,
-        handle,
-        identityKey,
-        signature: signatureHex,
-        note: `Post the tweet above from ${handle}, then run: x-verify-complete <tweet_url>`,
-    });
-}
-/**
- * Complete X verification by checking the posted tweet.
- */
-export async function cmdXVerifyComplete(tweetUrl) {
-    if (!tweetUrl)
-        return fail('Usage: x-verify-complete <tweet-url>');
-    // Load pending verification
-    if (!fs.existsSync(PATHS.pendingXVerification)) {
-        return fail('No pending X verification. Run x-verify-start first.');
-    }
-    const pending = JSON.parse(fs.readFileSync(PATHS.pendingXVerification, 'utf-8'));
-    // Extract tweet ID from URL
-    const tweetIdMatch = tweetUrl.match(/status\/(\d+)/);
-    if (!tweetIdMatch)
-        return fail('Invalid tweet URL. Expected format: https://x.com/user/status/123456789');
-    const tweetId = tweetIdMatch[1];
-    // Fetch the tweet using bird CLI
-    let tweetData;
-    try {
-        const { execSync } = await import('child' + '_' + 'process');
-        const birdOutput = execSync(`bird read ${tweetUrl} --json 2>/dev/null`, {
-            encoding: 'utf-8',
-            timeout: 30000,
-        });
-        tweetData = JSON.parse(birdOutput);
-    }
-    catch (err) {
-        return fail(`Failed to fetch tweet: ${err.message}. Make sure bird CLI is configured.`);
-    }
-    // Verify the tweet contains our identity key and partial signature
-    const tweetText = tweetData.text || tweetData.full_text || '';
-    if (!tweetText.includes(pending.identityKey.slice(0, 10))) {
-        return fail('Tweet does not contain the expected identity key.');
-    }
-    // Check for partial signature (first 40 chars)
-    if (!tweetText.includes(pending.signature.slice(0, 40))) {
-        return fail('Tweet does not contain the expected verification signature prefix.');
-    }
-    // Get the X user info from the tweet
-    const xUserId = tweetData.user?.id_str || tweetData.authorId || tweetData.author?.id || tweetData.user_id;
-    const xHandle = tweetData.user?.screen_name || tweetData.author?.username || tweetData.author?.name || pending.handle.replace('@', '');
-    if (!xUserId) {
-        return fail('Could not extract X user ID from tweet data.');
-    }
-    // Build on-chain verification record
-    const verificationPayload = {
-        protocol: PROTOCOL_ID,
-        type: 'x-verification',
-        identityKey: pending.identityKey,
-        xHandle: `@${xHandle}`,
-        xUserId,
-        tweetId,
-        tweetUrl,
-        signature: pending.signature,
-        verifiedAt: new Date().toISOString(),
-    };
-    // Submit to overlay (may fail if topic manager not deployed yet)
-    let result = { txid: null, funded: 'pending-server-support' };
-    let onChainStored = false;
-    try {
-        result = await buildRealOverlayTransaction(verificationPayload, TOPICS.X_VERIFICATION);
-        onChainStored = true;
-    }
-    catch (err) {
-        console.error(`[x-verify] On-chain storage failed: ${err.message}`);
-        console.error('[x-verify] Storing verification locally.');
-    }
-    // Save verification locally
-    const verifications = loadXVerifications();
-    verifications.push({
-        ...verificationPayload,
-        txid: result.txid,
-    });
-    saveXVerifications(verifications);
-    // Clean up pending
-    fs.unlinkSync(PATHS.pendingXVerification);
-    return ok({
-        verified: true,
-        identityKey: pending.identityKey,
-        xHandle: `@${xHandle}`,
-        xUserId,
-        tweetId,
-        txid: result.txid,
-        funded: result.funded,
-        onChainStored,
-        note: onChainStored ? undefined : 'Stored locally. On-chain anchoring pending server topic manager deployment.',
-    });
-}
-/**
- * List verified X accounts (local cache).
- */
-export async function cmdXVerifications() {
-    const verifications = loadXVerifications();
-    return ok({ verifications, count: verifications.length });
-}
-/**
- * Lookup X verifications from the overlay network.
- */
-export async function cmdXLookup(query) {
-    try {
-        const lookupQuery = query
-            ? (query.startsWith('@') ? { xHandle: query } : { identityKey: query })
-            : { type: 'list' };
-        const response = await lookupOverlay(LOOKUP_SERVICES.X_VERIFICATIONS, lookupQuery);
-        return ok({ verifications: response.outputs || response || [], query: lookupQuery });
-    }
-    catch {
-        return ok({ verifications: [], query, note: 'X verification lookup service may not be deployed yet.' });
-    }
-}
-/**
- * List pending X engagement requests.
- */
-export async function cmdXEngagementQueue() {
-    if (!fs.existsSync(PATHS.xEngagementQueue)) {
-        return ok({ queue: [], count: 0 });
-    }
-    const queue = readJsonl(PATHS.xEngagementQueue).filter(e => e.status === 'pending');
-    return ok({ queue, count: queue.length });
-}
-/**
- * Mark an X engagement request as fulfilled.
- */
-export async function cmdXEngagementFulfill(requestId, proofUrl) {
-    if (!requestId)
-        return fail('Usage: x-engagement-fulfill <requestId> [proofUrl]');
-    if (!fs.existsSync(PATHS.xEngagementQueue)) {
-        return fail('No engagement queue found.');
-    }
-    const queue = readJsonl(PATHS.xEngagementQueue);
-    const entryIndex = queue.findIndex(e => e.requestId === requestId);
-    if (entryIndex === -1) {
-        return fail(`Request ${requestId} not found in queue.`);
-    }
-    // Mark as fulfilled
-    queue[entryIndex].status = 'fulfilled';
-    queue[entryIndex].fulfilledAt = new Date().toISOString();
-    queue[entryIndex].proofUrl = proofUrl || null;
-    // Rewrite queue file
-    fs.writeFileSync(PATHS.xEngagementQueue, queue.map(e => JSON.stringify(e)).join('\n') + '\n');
-    return ok({
-        fulfilled: true,
-        requestId,
-        entry: queue[entryIndex],
-    });
-}

package/dist/src/scripts/x-verification/index.d.ts

@@ -1,4 +0,0 @@
-/**
- * X verification module exports.
- */
-export * from './commands.js';

package/dist/src/scripts/x-verification/index.js

@@ -1,4 +0,0 @@
-/**
- * X verification module exports.
- */
-export * from './commands.js';

package/dist/src/services/built-in/api-proxy/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * API Proxy service definition.
- */
-import { ServiceDefinition } from '../../types.js';
-declare const apiProxyService: ServiceDefinition;
-export default apiProxyService;

package/dist/src/services/built-in/api-proxy/index.js

@@ -1,23 +0,0 @@
-/**
- * API Proxy service definition.
- */
-import { ServiceCategory } from '../../types.js';
-const apiProxyService = {
-    id: 'api-proxy',
-    name: 'API Proxy',
-    description: 'Proxy HTTP requests to external APIs. Input: {url, method, headers, body}.',
-    defaultPrice: 15,
-    category: ServiceCategory.UTILITY,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            url: { type: 'string', description: 'Target API URL' },
-            method: { type: 'string', enum: ['GET', 'POST', 'PUT', 'DELETE'], description: 'HTTP method' },
-            headers: { type: 'object', description: 'Request headers' },
-            body: { description: 'Request body' },
-            timeout: { type: 'number', description: 'Request timeout in ms' }
-        },
-        required: ['url']
-    }
-};
-export default apiProxyService;

package/dist/src/services/built-in/code-develop/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Code Development service definition.
- */
-import { ServiceDefinition } from '../../types.js';
-declare const codeDevelopService: ServiceDefinition;
-export default codeDevelopService;

package/dist/src/services/built-in/code-develop/index.js

@@ -1,23 +0,0 @@
-/**
- * Code Development service definition.
- */
-import { ServiceCategory } from '../../types.js';
-const codeDevelopService = {
-    id: 'code-develop',
-    name: 'Code Development',
-    description: 'Generate code from requirements. Specify language, task description, and constraints.',
-    defaultPrice: 100,
-    category: ServiceCategory.DEVELOPMENT,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            requirements: { type: 'string', description: 'Detailed description of what code to generate' },
-            language: { type: 'string', description: 'Programming language (e.g., JavaScript, Python, Java)' },
-            constraints: { type: 'string', description: 'Any specific constraints or requirements' },
-            style: { type: 'string', description: 'Code style preferences' },
-            includeTests: { type: 'boolean', description: 'Whether to include unit tests' }
-        },
-        required: ['requirements', 'language']
-    }
-};
-export default codeDevelopService;

package/dist/src/services/built-in/code-review/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * Code Review service definition.
- *
- * Provides thorough code review covering bugs, security issues, style,
- * performance, and improvement suggestions. This is an agent-mode service
- * that leverages the LLM's capabilities.
- */
-import { ServiceDefinition } from '../../types.js';
-declare const codeReviewService: ServiceDefinition;
-export default codeReviewService;

package/dist/src/services/built-in/code-review/index.js

@@ -1,51 +0,0 @@
-/**
- * Code Review service definition.
- *
- * Provides thorough code review covering bugs, security issues, style,
- * performance, and improvement suggestions. This is an agent-mode service
- * that leverages the LLM's capabilities.
- */
-import { ServiceCategory } from '../../types.js';
-const codeReviewService = {
-    id: 'code-review',
-    name: 'Code Review',
-    description: 'Thorough code review covering bugs, security issues, style, performance, and improvement suggestions.',
-    defaultPrice: 50,
-    category: ServiceCategory.DEVELOPMENT,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            code: {
-                type: 'string',
-                description: 'Code to review'
-            },
-            language: {
-                type: 'string',
-                description: 'Programming language (auto-detected if not provided)'
-            },
-            prUrl: {
-                type: 'string',
-                description: 'GitHub/GitLab PR URL to review instead of direct code'
-            },
-            focusAreas: {
-                type: 'array',
-                items: {
-                    type: 'string',
-                    enum: ['security', 'performance', 'style', 'bugs', 'maintainability', 'testing']
-                },
-                description: 'Specific areas to focus the review on'
-            },
-            severity: {
-                type: 'string',
-                enum: ['basic', 'detailed', 'comprehensive'],
-                description: 'Depth of review (default: detailed)'
-            }
-        },
-        anyOf: [
-            { required: ['code'] },
-            { required: ['prUrl'] }
-        ]
-    }
-    // No handler - this service uses agent mode for full LLM capabilities
-};
-export default codeReviewService;

package/dist/src/services/built-in/image-analysis/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Image Analysis service definition.
- */
-import { ServiceDefinition } from '../../types.js';
-declare const imageAnalysisService: ServiceDefinition;
-export default imageAnalysisService;

package/dist/src/services/built-in/image-analysis/index.js

@@ -1,33 +0,0 @@
-/**
- * Image Analysis service definition.
- */
-import { ServiceCategory } from '../../types.js';
-const imageAnalysisService = {
-    id: 'image-analysis',
-    name: 'Image Analysis',
-    description: 'Analyze and describe images. Identify objects, text, scenes, and more.',
-    defaultPrice: 30,
-    category: ServiceCategory.AI,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            imageUrl: { type: 'string', description: 'URL of the image to analyze' },
-            imageData: { type: 'string', description: 'Base64 encoded image data' },
-            analysisType: {
-                type: 'string',
-                enum: ['general', 'objects', 'text', 'faces', 'scenes'],
-                description: 'Type of analysis to perform'
-            },
-            detailLevel: {
-                type: 'string',
-                enum: ['brief', 'detailed', 'comprehensive'],
-                description: 'Level of detail in analysis'
-            }
-        },
-        oneOf: [
-            { required: ['imageUrl'] },
-            { required: ['imageData'] }
-        ]
-    }
-};
-export default imageAnalysisService;

package/dist/src/services/built-in/memory-store/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Memory Store service definition.
- */
-import { ServiceDefinition } from '../../types.js';
-declare const memoryStoreService: ServiceDefinition;
-export default memoryStoreService;

package/dist/src/services/built-in/memory-store/index.js

@@ -1,22 +0,0 @@
-/**
- * Memory Store service definition.
- */
-import { ServiceCategory } from '../../types.js';
-const memoryStoreService = {
-    id: 'memory-store',
-    name: 'Memory Store',
-    description: 'Persistent key-value storage for agents. Operations: set, get, delete, list.',
-    defaultPrice: 10,
-    category: ServiceCategory.UTILITY,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            operation: { type: 'string', enum: ['set', 'get', 'delete', 'list'], description: 'Storage operation' },
-            key: { type: 'string', description: 'Storage key (required for set, get, delete)' },
-            value: { description: 'Value to store (required for set operation)' },
-            namespace: { type: 'string', description: 'Optional namespace for keys' }
-        },
-        required: ['operation']
-    }
-};
-export default memoryStoreService;

package/dist/src/services/built-in/roulette/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Roulette service definition.
- */
-import { ServiceDefinition } from '../../types.js';
-declare const rouletteService: ServiceDefinition;
-export default rouletteService;

package/dist/src/services/built-in/roulette/index.js

@@ -1,27 +0,0 @@
-/**
- * Roulette service definition.
- */
-import { ServiceCategory } from '../../types.js';
-const rouletteService = {
-    id: 'roulette',
-    name: 'Roulette',
-    description: 'European roulette (single zero). Bet on: number 0-36, red/black, odd/even, high/low.',
-    defaultPrice: 10,
-    category: ServiceCategory.ENTERTAINMENT,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            bet: {
-                type: 'string',
-                description: 'Bet type: specific number (0-36), red, black, odd, even, high (19-36), low (1-18), or dozen (1st, 2nd, 3rd)'
-            },
-            amount: {
-                type: 'number',
-                description: 'Bet amount (optional, for display purposes)',
-                minimum: 1
-            }
-        },
-        required: ['bet']
-    }
-};
-export default rouletteService;

package/dist/src/services/built-in/summarize/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Summarize service definition.
- */
-import { ServiceDefinition } from '../../types.js';
-declare const summarizeService: ServiceDefinition;
-export default summarizeService;

package/dist/src/services/built-in/summarize/index.js

@@ -1,21 +0,0 @@
-/**
- * Summarize service definition.
- */
-import { ServiceCategory } from '../../types.js';
-const summarizeService = {
-    id: 'summarize',
-    name: 'Summarize',
-    description: 'Summarize long text, articles, or documents into concise bullet points.',
-    defaultPrice: 20,
-    category: ServiceCategory.AI,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            text: { type: 'string', description: 'Text to summarize' },
-            maxLength: { type: 'number', description: 'Maximum length of summary' },
-            format: { type: 'string', enum: ['bullets', 'paragraph'], description: 'Output format' }
-        },
-        required: ['text']
-    }
-};
-export default summarizeService;

package/dist/src/services/built-in/tell-joke/handler.d.ts

@@ -1,7 +0,0 @@
-/**
- * Tell Joke service handler.
- *
- * Provides a simple legacy handler for joke telling when not in agent mode.
- */
-import { ServiceHandler } from '../../types.js';
-export declare const tellJokeHandler: ServiceHandler;