@moorline/core 0.0.1

package/dist/core/extension/plugins/pluginHost.js

@@ -0,0 +1,303 @@
+import { validatePluginManifest } from './pluginManifest.js';
+const DEFAULT_PLUGIN_HOOK_TIMEOUT_MS = 120_000;
+class PluginHookTimeoutError extends Error {
+    pluginId;
+    hook;
+    timeoutMs;
+    constructor(pluginId, hook, timeoutMs) {
+        super(`Plugin hook timed out after ${timeoutMs}ms.`);
+        this.pluginId = pluginId;
+        this.hook = hook;
+        this.timeoutMs = timeoutMs;
+        this.name = 'PluginHookTimeoutError';
+    }
+}
+function normalizeDispatchResult(result) {
+    if (typeof result === 'boolean') {
+        return { handled: result };
+    }
+    return result ?? { handled: false };
+}
+function mergeDispatchResult(left, right) {
+    return {
+        handled: left.handled || right.handled,
+        ...(right.reply ?? left.reply ? { reply: right.reply ?? left.reply } : {}),
+        ...(right.audit ?? left.audit ? { audit: right.audit ?? left.audit } : {}),
+        ...(right.continueDispatch ?? left.continueDispatch
+            ? { continueDispatch: right.continueDispatch ?? left.continueDispatch }
+            : {})
+    };
+}
+export class PluginHost {
+    plugins;
+    hookTimeoutMs;
+    onHookFailure;
+    constructor(plugins, options = {}) {
+        this.plugins = [...plugins].sort((left, right) => {
+            const leftPriority = left.manifest.priority ?? 100;
+            const rightPriority = right.manifest.priority ?? 100;
+            if (leftPriority !== rightPriority) {
+                return leftPriority - rightPriority;
+            }
+            return left.id.localeCompare(right.id);
+        });
+        for (const plugin of this.plugins) {
+            validatePluginManifest(plugin.manifest);
+        }
+        const configuredTimeoutMs = options.hookTimeoutMs;
+        this.hookTimeoutMs =
+            typeof configuredTimeoutMs === 'number' && Number.isFinite(configuredTimeoutMs) && configuredTimeoutMs > 0
+                ? configuredTimeoutMs
+                : DEFAULT_PLUGIN_HOOK_TIMEOUT_MS;
+        this.onHookFailure =
+            options.onHookFailure ??
+                ((failure) => {
+                    console.error(`[plugin.hook.failed] pluginId=${failure.pluginId} hook=${failure.hook} timeout=${failure.timeout} ` +
+                        `durationMs=${failure.durationMs} error=${failure.error}`);
+                });
+    }
+    listActions(contextFactory) {
+        const seen = new Set();
+        return this.plugins.flatMap((plugin) => {
+            const declaredCapabilities = new Set(plugin.manifest.capabilities);
+            return (plugin.actions?.(contextFactory(plugin.id)) ?? []).map((action) => {
+                if (seen.has(action.id)) {
+                    throw new Error(`Duplicate runtime action id: ${action.id}`);
+                }
+                seen.add(action.id);
+                if (action.requiredCapability && !declaredCapabilities.has(action.requiredCapability)) {
+                    throw new Error(`Plugin ${plugin.id} exposes action ${action.id} requiring undeclared capability ${action.requiredCapability}`);
+                }
+                return {
+                    ...action,
+                    metadata: {
+                        ...(action.metadata ?? {}),
+                        pluginId: plugin.id
+                    }
+                };
+            });
+        });
+    }
+    listManagementContributions(contextFactory) {
+        return this.plugins.flatMap((plugin) => {
+            const context = contextFactory(plugin.id);
+            const actionIds = new Set((plugin.actions?.(context) ?? []).map((action) => action.id));
+            return (plugin.managementContributions?.(context) ?? []).map((contribution) => {
+                if (contribution.packageId !== plugin.manifest.id) {
+                    throw new Error(`Plugin ${plugin.id} returned management contribution ${contribution.id} for ${contribution.packageId}`);
+                }
+                if (contribution.requiredCapability && !plugin.manifest.capabilities.includes(contribution.requiredCapability)) {
+                    throw new Error(`Plugin ${plugin.id} returned management contribution ${contribution.id} requiring undeclared capability ${contribution.requiredCapability}`);
+                }
+                if (contribution.executeActionId && !actionIds.has(contribution.executeActionId)) {
+                    throw new Error(`Plugin ${plugin.id} returned management contribution ${contribution.id} for undeclared action ${contribution.executeActionId}`);
+                }
+                return contribution;
+            });
+        });
+    }
+    listTools(contextFactory) {
+        return this.plugins.flatMap((plugin) => {
+            const declaredCapabilities = new Set(plugin.manifest.capabilities);
+            return (plugin.tools?.(contextFactory(plugin.id)) ?? []).map((tool) => {
+                if (tool.requiredCapability && !declaredCapabilities.has(tool.requiredCapability)) {
+                    throw new Error(`Plugin ${plugin.id} exposes tool ${tool.name} requiring undeclared capability ${tool.requiredCapability}`);
+                }
+                return {
+                    ...tool,
+                    pluginId: plugin.id
+                };
+            });
+        });
+    }
+    async onRuntimeStarted(contextFactory) {
+        for (const plugin of this.plugins) {
+            if ((plugin.manifest.hooks ?? []).includes('onRuntimeStarted')) {
+                await this.runHook(plugin, 'onRuntimeStarted', async () => {
+                    await plugin.onRuntimeStarted?.(contextFactory(plugin.id));
+                });
+            }
+        }
+    }
+    async handleTransportEvent(event, contextFactory) {
+        let result = { handled: false };
+        for (const plugin of this.plugins) {
+            if (!(plugin.manifest.hooks ?? []).includes('onTransportEvent')) {
+                continue;
+            }
+            const next = await this.runRequiredHook(plugin, 'onTransportEvent', async () => normalizeDispatchResult(await plugin.onTransportEvent?.(event, contextFactory(plugin.id))));
+            if (!next.handled) {
+                continue;
+            }
+            result = mergeDispatchResult(result, next);
+            if (!next.continueDispatch) {
+                return result;
+            }
+        }
+        if (event.type === 'action.invoked') {
+            result = mergeDispatchResult(result, await this.handleAction(event, contextFactory));
+        }
+        return result;
+    }
+    async handleAction(event, contextFactory) {
+        let result = { handled: false };
+        for (const plugin of this.plugins) {
+            if (!(plugin.manifest.hooks ?? []).includes('onAction')) {
+                continue;
+            }
+            const next = await this.runRequiredHook(plugin, 'onAction', async () => normalizeDispatchResult(await plugin.onAction?.(event, contextFactory(plugin.id))));
+            if (!next.handled) {
+                continue;
+            }
+            result = mergeDispatchResult(result, next);
+            if (!next.continueDispatch) {
+                return result;
+            }
+        }
+        return result;
+    }
+    async executeAction(actionId, input, actor, contextFactory) {
+        return await this.handleAction({
+            type: 'action.invoked',
+            scopeId: actor.scopeId,
+            ...(actor.spaceId ? { spaceId: actor.spaceId } : {}),
+            actor: {
+                actorId: actor.actorId,
+                ...(actor.displayName ? { displayName: actor.displayName } : {})
+            },
+            actionId,
+            input
+        }, contextFactory);
+    }
+    async beforeAgentPrompt(input, contextFactory) {
+        const sections = [];
+        for (const plugin of this.plugins) {
+            if ((plugin.manifest.hooks ?? []).includes('beforeAgentPrompt')) {
+                const pluginSections = await this.runHook(plugin, 'beforeAgentPrompt', async () => (await plugin.beforeAgentPrompt?.(input, contextFactory(plugin.id))) ?? [], []);
+                sections.push(...pluginSections);
+            }
+        }
+        return sections;
+    }
+    async afterAgentResponse(input, contextFactory) {
+        for (const plugin of this.plugins) {
+            if ((plugin.manifest.hooks ?? []).includes('afterAgentResponse')) {
+                await this.runHook(plugin, 'afterAgentResponse', async () => {
+                    await plugin.afterAgentResponse?.(input, contextFactory(plugin.id));
+                });
+            }
+        }
+    }
+    async onRuntimeEvent(event, contextFactory) {
+        for (const plugin of this.plugins) {
+            if ((plugin.manifest.hooks ?? []).includes('onRuntimeEvent')) {
+                await this.runHook(plugin, 'onRuntimeEvent', async () => {
+                    await plugin.onRuntimeEvent?.(event, contextFactory(plugin.id));
+                });
+            }
+        }
+    }
+    async onDomainEvent(event, contextFactory) {
+        for (const plugin of this.plugins) {
+            if ((plugin.manifest.hooks ?? []).includes('onDomainEvent')) {
+                await this.runHook(plugin, 'onDomainEvent', async () => {
+                    await plugin.onDomainEvent?.(event, contextFactory(plugin.id));
+                });
+            }
+        }
+    }
+    async onRuntimeReceipt(receipt, contextFactory) {
+        for (const plugin of this.plugins) {
+            if ((plugin.manifest.hooks ?? []).includes('onRuntimeReceipt')) {
+                await this.runHook(plugin, 'onRuntimeReceipt', async () => {
+                    await plugin.onRuntimeReceipt?.(receipt, contextFactory(plugin.id));
+                });
+            }
+        }
+    }
+    async onRuntimeActivity(activity, contextFactory) {
+        for (const plugin of this.plugins) {
+            if ((plugin.manifest.hooks ?? []).includes('onRuntimeActivity')) {
+                await this.runHook(plugin, 'onRuntimeActivity', async () => {
+                    await plugin.onRuntimeActivity?.(activity, contextFactory(plugin.id));
+                });
+            }
+        }
+    }
+    async runHook(plugin, hook, invoke, fallback) {
+        const started = Date.now();
+        try {
+            return await this.runWithTimeout(plugin.id, hook, invoke());
+        }
+        catch (error) {
+            const timeout = error instanceof PluginHookTimeoutError;
+            this.reportHookFailure({
+                pluginId: plugin.id,
+                hook,
+                error: error instanceof Error ? error.message : String(error),
+                timeout,
+                timeoutMs: this.hookTimeoutMs,
+                durationMs: Math.max(0, Date.now() - started)
+            });
+            if (fallback !== undefined) {
+                return fallback;
+            }
+            return undefined;
+        }
+    }
+    async runRequiredHook(plugin, hook, invoke) {
+        const started = Date.now();
+        try {
+            return await this.runWithTimeout(plugin.id, hook, invoke());
+        }
+        catch (error) {
+            const timeout = error instanceof PluginHookTimeoutError;
+            this.reportHookFailure({
+                pluginId: plugin.id,
+                hook,
+                error: error instanceof Error ? error.message : String(error),
+                timeout,
+                timeoutMs: this.hookTimeoutMs,
+                durationMs: Math.max(0, Date.now() - started)
+            });
+            throw error;
+        }
+    }
+    async runWithTimeout(pluginId, hook, promise) {
+        return await new Promise((resolve, reject) => {
+            let settled = false;
+            const timeout = globalThis.setTimeout(() => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                reject(new PluginHookTimeoutError(pluginId, hook, this.hookTimeoutMs));
+            }, this.hookTimeoutMs);
+            void promise.then((value) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                globalThis.clearTimeout(timeout);
+                resolve(value);
+            }, (error) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                globalThis.clearTimeout(timeout);
+                reject(error);
+            });
+        });
+    }
+    reportHookFailure(failure) {
+        try {
+            this.onHookFailure(failure);
+        }
+        catch (error) {
+            console.error(`[plugin.hook.failure-handler.error] pluginId=${failure.pluginId} hook=${failure.hook} ` +
+                `error=${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=pluginHost.js.map

package/dist/core/extension/plugins/pluginHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginHost.js","sourceRoot":"","sources":["../../../../../../../src/core/extension/plugins/pluginHost.ts"],"names":[],"mappings":"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"}

package/dist/core/extension/plugins/pluginId.d.ts

@@ -0,0 +1,2 @@
+export declare function toPluginPackageId(value: string): string;
+export declare function isOfficialPluginId(value: string): boolean;

package/dist/core/extension/plugins/pluginId.js

@@ -0,0 +1,8 @@
+export function toPluginPackageId(value) {
+    const normalized = value.trim();
+    return normalized.startsWith('plugin:') ? normalized.slice('plugin:'.length) : normalized;
+}
+export function isOfficialPluginId(value) {
+    return toPluginPackageId(value).startsWith('official/');
+}
+//# sourceMappingURL=pluginId.js.map

package/dist/core/extension/plugins/pluginId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginId.js","sourceRoot":"","sources":["../../../../../../../src/core/extension/plugins/pluginId.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAC1D,CAAC"}

package/dist/core/extension/plugins/pluginManifest.d.ts

@@ -0,0 +1,3 @@
+export { type PluginManifest, validatePluginManifest } from '@moorline/contracts';
+import type { RuntimePlugin } from '../../../types/plugin.js';
+export declare function validatePluginRuntimeContract(plugin: RuntimePlugin): void;

package/dist/core/extension/plugins/pluginManifest.js

@@ -0,0 +1,17 @@
+export { validatePluginManifest } from '@moorline/contracts';
+import { KNOWN_PLUGIN_HOOKS } from '@moorline/contracts';
+export function validatePluginRuntimeContract(plugin) {
+    const declaredHooks = new Set(plugin.manifest.hooks ?? []);
+    const implementedHooks = KNOWN_PLUGIN_HOOKS.filter((hook) => typeof plugin[hook] === 'function');
+    for (const hook of implementedHooks) {
+        if (!declaredHooks.has(hook)) {
+            throw new Error(`Plugin ${plugin.id} implements undeclared hook ${hook}`);
+        }
+    }
+    for (const hook of declaredHooks) {
+        if (!KNOWN_PLUGIN_HOOKS.includes(hook) || typeof plugin[hook] !== 'function') {
+            throw new Error(`Plugin ${plugin.id} declares hook ${hook} but does not implement it`);
+        }
+    }
+}
+//# sourceMappingURL=pluginManifest.js.map

package/dist/core/extension/plugins/pluginManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginManifest.js","sourceRoot":"","sources":["../../../../../../../src/core/extension/plugins/pluginManifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAKzD,MAAM,UAAU,6BAA6B,CAAC,MAAqB;IACjE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC;IAEjG,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,EAAE,+BAA+B,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,IAAuB,CAAC,IAAI,OAAO,MAAM,CAAC,IAAuB,CAAC,KAAK,UAAU,EAAE,CAAC;YACnH,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,EAAE,kBAAkB,IAAI,4BAA4B,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/extension/plugins/runtimePluginLoader.d.ts

@@ -0,0 +1,7 @@
+import type { RuntimePlugin } from '../../../types/plugin.js';
+import type { RuntimePackageLoadFailure } from '../../../types/release.js';
+export declare function loadRuntimePlugins(runtimeRoot: string): Promise<RuntimePlugin[]>;
+export declare function loadRuntimePluginsWithDiagnostics(runtimeRoot: string, phase?: RuntimePackageLoadFailure['phase'], now?: () => string): Promise<{
+    plugins: RuntimePlugin[];
+    failures: RuntimePackageLoadFailure[];
+}>;

package/dist/core/extension/plugins/runtimePluginLoader.js

@@ -0,0 +1,160 @@
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { validatePluginManifest, validatePluginRuntimeContract } from './pluginManifest.js';
+import { PackageInventoryStore } from '../packages/packageInventoryStore.js';
+import { appliedPackageRefs } from '../packages/packageActivation.js';
+function canonicalizeJson(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => canonicalizeJson(entry));
+    }
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, entry]) => [key, canonicalizeJson(entry)]));
+    }
+    return value;
+}
+function manifestsMatch(left, right) {
+    return JSON.stringify(canonicalizeJson(left)) === JSON.stringify(canonicalizeJson(right));
+}
+function hasManifest(dir) {
+    try {
+        return statSync(join(dir, 'manifest.json')).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function readManifestId(raw, fallbackPath) {
+    if (raw && typeof raw === 'object' && typeof raw.id === 'string') {
+        return raw.id;
+    }
+    const normalized = fallbackPath.replaceAll('\\', '/');
+    return `invalid:${normalized.split('/').filter(Boolean).at(-1) ?? 'plugin'}`;
+}
+function listPluginRecords(rootDir, enabledPackageIds) {
+    const records = [];
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!current) {
+            continue;
+        }
+        const stat = statSync(current, { throwIfNoEntry: false });
+        if (!stat?.isDirectory()) {
+            continue;
+        }
+        if (hasManifest(current)) {
+            const manifestPath = join(current, 'manifest.json');
+            let manifestRaw = null;
+            try {
+                manifestRaw = JSON.parse(readFileSync(manifestPath, 'utf8'));
+                const manifest = validatePluginManifest(manifestRaw);
+                if (enabledPackageIds.has(manifest.id)) {
+                    records.push({
+                        kind: 'valid',
+                        packageId: manifest.id,
+                        manifest,
+                        pluginDir: current
+                    });
+                }
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                const packageId = readManifestId(manifestRaw, current);
+                if (enabledPackageIds.has(packageId) || packageId.startsWith('invalid:')) {
+                    records.push({
+                        kind: 'invalid',
+                        packageId,
+                        pluginDir: current,
+                        detail
+                    });
+                }
+            }
+            continue;
+        }
+        let entries = [];
+        try {
+            entries = readdirSync(current).sort();
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries.reverse()) {
+            stack.push(join(current, entry));
+        }
+    }
+    return records.sort((left, right) => left.packageId.localeCompare(right.packageId));
+}
+async function importPlugin(record) {
+    const entrypoint = join(record.pluginDir, record.manifest.entrypoint ?? 'index.mjs');
+    const module = await import(pathToFileURL(entrypoint).href);
+    const loaded = module.default ?? (typeof module.createPlugin === 'function' ? module.createPlugin() : null);
+    if (!loaded || typeof loaded !== 'object') {
+        throw new Error(`Plugin ${record.manifest.id} did not export a runtime plugin object`);
+    }
+    const plugin = loaded;
+    if (plugin.id !== record.manifest.id) {
+        throw new Error(`Plugin ${record.manifest.id} exported mismatched id ${plugin.id}`);
+    }
+    const exportedManifest = validatePluginManifest(plugin.manifest);
+    if (!manifestsMatch(exportedManifest, record.manifest)) {
+        throw new Error(`Plugin ${record.manifest.id} exported manifest drift relative to manifest.json`);
+    }
+    validatePluginRuntimeContract({
+        ...plugin,
+        manifest: record.manifest
+    });
+    return {
+        ...plugin,
+        manifest: record.manifest
+    };
+}
+export async function loadRuntimePlugins(runtimeRoot) {
+    const result = await loadRuntimePluginsWithDiagnostics(runtimeRoot);
+    if (result.failures.length > 0) {
+        throw new Error(result.failures.map((entry) => `${entry.packageId}: ${entry.detail}`).join('; '));
+    }
+    return result.plugins;
+}
+export async function loadRuntimePluginsWithDiagnostics(runtimeRoot, phase = 'startup', now = () => new Date().toISOString()) {
+    const inventory = new PackageInventoryStore(runtimeRoot).load();
+    const enabledPluginPackageIds = appliedPackageRefs(inventory.applied)
+        .filter((entry) => entry.surface === 'plugin')
+        .map((entry) => entry.packageId);
+    const records = listPluginRecords(join(runtimeRoot, 'packages', 'plugins'), new Set(enabledPluginPackageIds));
+    const plugins = [];
+    const failures = [];
+    for (const record of records) {
+        if (record.kind === 'invalid') {
+            failures.push({
+                surface: 'plugin',
+                packageId: record.packageId,
+                phase,
+                detail: record.detail ?? `Malformed plugin manifest in ${record.pluginDir}`,
+                recordedAt: now(),
+                required: false
+            });
+            continue;
+        }
+        try {
+            plugins.push(await importPlugin({ manifest: record.manifest, pluginDir: record.pluginDir }));
+        }
+        catch (error) {
+            failures.push({
+                surface: 'plugin',
+                packageId: record.packageId,
+                phase,
+                detail: error instanceof Error ? error.message : String(error),
+                recordedAt: now(),
+                required: false
+            });
+        }
+    }
+    return {
+        plugins,
+        failures
+    };
+}
+//# sourceMappingURL=runtimePluginLoader.js.map

package/dist/core/extension/plugins/runtimePluginLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimePluginLoader.js","sourceRoot":"","sources":["../../../../../../../src/core/extension/plugins/runtimePluginLoader.ts"],"names":[],"mappings":"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"}

package/dist/core/extension/skills/skillRegistry.d.ts

@@ -0,0 +1,21 @@
+export interface SkillCatalogEntry {
+    name: string;
+    description: string;
+    path: string;
+    tags: string[];
+    metadata: Record<string, string | string[]>;
+}
+export interface LoadedSkill extends SkillCatalogEntry {
+    content: string;
+    resourcePaths: string[];
+}
+export declare class SkillRegistry {
+    private readonly roots;
+    private cache;
+    constructor(roots: string[]);
+    invalidateCache(): void;
+    list(): SkillCatalogEntry[];
+    load(name: string): LoadedSkill | null;
+    private cacheToken;
+    private scan;
+}