@aalis/plugin-webui-server 0.14.1 → 0.16.0

package/dist/locales/en.d.ts

@@ -0,0 +1,191 @@
+declare const _default: {
+    readonly displayName: "WebUI server";
+    readonly portLabel: "Port";
+    readonly portDescription: "HTTP port of the web admin interface";
+    readonly hostLabel: "Listen address";
+    readonly hostDescription: "IP address to bind; 0.0.0.0 makes it reachable from other machines";
+    readonly allowedHostsLabel: "Host allowlist";
+    readonly allowedHostsDescription: "Host names in the browser address bar when the WebUI is reached through a reverse proxy or a domain name, without scheme or port. IP addresses, localhost and the listen address are always accepted; requests for any other host name get 421, which keeps out DNS rebinding pages";
+    readonly badAllowedHost: "{entry} is not a host name: write only the host name, without a scheme, user name or path";
+    readonly autoOpenLabel: "Open the browser on startup";
+    readonly autoOpenDescription: "Opens the default browser the first time the app starts listening; reloading the plugin with the same token does not open it again, while a newly generated token opens it again so you can sign in. Turn this off over SSH or in headless environments";
+    readonly tokenModeLabel: "Token policy";
+    readonly tokenEphemeral: "Generate a random token at each start (rotates on restart)";
+    readonly tokenPersist: "Persist after the first generation (stays signed in across restarts)";
+    readonly tokenFixed: "Use the fixed token below";
+    readonly tokenModeDescription: "ephemeral = random at each start; persist = token written to data:/webui/token and reused; fixed = use the fixedToken field. Every mode writes the convenience file data:/webui/access.txt with the access URL.";
+    readonly fixedTokenLabel: "Fixed token (only with tokenMode=fixed)";
+    readonly fixedTokenDescription: "A random string of at least {min} characters (after trimming whitespace); a shorter one keeps the plugin from starting; empty means persist. Stored in secrets.yaml and never shown in the WebUI.";
+    readonly registryLabel: "Plugin market npm registry";
+    readonly registryDescription: "Base URL of the npm registry the plugin market searches. Not every mirror supports the npm search API (Taobao and other mainland mirrors do not), so the official registry is the default; in mainland China use a mirror or proxy that supports search. Installation goes through package-manager (following the local npm config), and the latest versions and updates on the cards are checked against the registry used for installing.";
+    readonly registryInvalid: "marketplaceRegistry is not a valid URL";
+    readonly tokenTooShort: "fixedToken needs at least {min} characters (currently {length})";
+    readonly accessTitle: "# Aalis WebUI access credentials (generated)";
+    readonly accessGenerated: "# Generated at: {time}";
+    readonly accessMode: "# Token mode: {mode}";
+    readonly accessLogin: "One-click sign-in: {url}";
+    readonly accessHint: "# Tip: paste the one-click sign-in link into a browser and the cookie is set for you";
+    readonly pageLanguage: "en";
+    readonly loginTitle: "Aalis WebUI sign-in";
+    readonly loginHint: "The access token is in state/webui/access.txt under the home directory; the startup log line “Access credentials written” gives its full path. With tokenMode set to fixed it is the config item fixedToken, whose value is stored in secrets.yaml under the home directory after startup (the config file holds a reference).";
+    readonly tokenPlaceholder: "Access token";
+    readonly loginButton: "Sign in";
+    readonly tokenWrong: "Incorrect token";
+    readonly networkError: "Network error";
+    readonly urlTokenWrong: "The token in the URL is incorrect; please enter it by hand.";
+    readonly tooManyFailures: "Too many failed sign-ins; try again in {minutes, plural, one {# minute} other {# minutes}}.";
+    readonly crossOrigin: "The request comes from a different origin than this service (behind a reverse proxy, the proxy must forward the original Host)";
+    readonly hostNotAllowed: "The host name of the request is not one this service accepts (when accessing through a reverse proxy or a domain name, add it to the Host allowlist in the WebUI server settings)";
+    readonly ownerRequired: "Owner permission required";
+    readonly unauthenticated: "Not signed in";
+    readonly switchTitle: "Switch frontend · Aalis";
+    readonly switchHeading: "Switch frontend";
+    readonly switchIntro: "This is the frontend recovery page of Aalis, served directly by webui-server and independent of the current frontend, so you can switch back here even when the current frontend has no switcher.";
+    readonly switchLabel: "Available frontends (webui-client)";
+    readonly switchLoading: "Loading…";
+    readonly switchButton: "Switch and reload";
+    readonly switchBack: "To switch back to the previous frontend, select it above and click “Switch and reload”.";
+    readonly switchListFailed: "Failed to read the service list (HTTP {status})";
+    readonly switchNoClients: "No frontend found (webui-client provider). Install an aalis.client package first.";
+    readonly switchCurrent: "{name} (current)";
+    readonly switching: "Switching…";
+    readonly switched: "Switched; redirecting…";
+    readonly switchOwnerHint: " (owner permission required: open the WebUI with the one-click sign-in link and try again)";
+    readonly switchFailed: "Switch failed: {detail}{hint}";
+    readonly switchError: "Switch request failed: {error}";
+    readonly unknownApi: "Unknown API: {method} {path}";
+    readonly noClient: "The frontend is not ready: install a frontend package marked aalis.client";
+    readonly serverError: "Something went wrong handling this request; see the logs for the reason";
+    readonly badRequest: "The request is malformed";
+    readonly bodyTooLarge: "The request body is too large";
+    readonly bodyNotJson: "The request body must be a valid JSON object or array";
+    readonly bodyEncoding: "The charset or content encoding of the request body is not supported";
+    readonly logFilterInvalid: "Invalid log filter: level accepts only debug, info, warn and error, and each parameter may be given at most once";
+    readonly noHostLogs: "The host provides no log service (host-logs), so the logs cannot be read";
+    readonly logBeforeRequired: "Paging back through the logs needs the numeric parameter before (entries with a smaller seq)";
+    readonly host: "Host";
+    readonly noProvider: "Service {service} has no provider with id {id}";
+    readonly noHostConfigPreference: "The host provides no config document (host-config), so the preference cannot be saved";
+    readonly contextIdRequired: "The request body needs contextId: the id of the preferred provider";
+    readonly refreshUnsupported: "Provider {provider} does not support refreshing its model list at runtime (for example, model discovery is off)";
+    readonly refreshNoModels: "Provider {provider} has no registered models right now and cannot be refreshed";
+    readonly dependencyInvalid: "dependency must be an entry id <provider instance id>/<model id>";
+    readonly allGroups: "* (all groups)";
+    readonly ungroupedTools: "Tools outside any group";
+    readonly pluginMissing: "Plugin {instance} does not exist";
+    readonly refused: "Plugin {instance} {action, select, config {can’t take config updates} enable {can’t be enabled} disable {can’t be disabled} other {can’t be reloaded}} right now (shutting down or being unloaded); the config was not changed";
+    readonly noHostConfig: "The host provides no config document (host-config), so the config cannot be read or written";
+    readonly selfDisable: "Plugin {name} provides this interface and cannot be disabled from it";
+    readonly bodyNotObject: "The request body must be an object";
+    readonly foreignKeys: "Only the core keys ({allowed, list}) can be changed; not accepted: {foreign, list}";
+    readonly configNotSaved: "Not written to the config file ({error}); this change was rolled back";
+    readonly savedRestart: "Global config saved; it takes effect after a restart";
+    readonly saved: "Global config updated and saved";
+    readonly noApp: "The app is unavailable";
+    readonly restartFailed: "Restart failed ({error}); the changes take effect at the next start";
+    readonly restarting: "Restarting the app";
+    readonly configNotObject: "The config field must be an object";
+    readonly noPluginManager: "The plugin manager service is unavailable";
+    readonly configInvalid: "Config validation failed: {issues}";
+    readonly issue: "{path}: {reason}";
+    readonly inputInvalid: "Input failed validation: {issues}";
+    readonly inputIssue: "{path}: {reason}";
+    readonly stillActivating: "still activating (past the slow-activation threshold, moved to the background); see the plugin list for the result";
+    readonly waitingOld: "waiting for the old instance of {instance} to stop";
+    readonly notYetActive: "not yet active; see the plugin list for the result";
+    readonly notYetActiveBecause: "not yet active: {why}";
+    readonly seeLog: "see the logs for details";
+    readonly ignoredNote: " (ignored undeclared config fields: {fields})";
+    readonly removedNote: " (removed undeclared fields from the config file: {fields})";
+    readonly unchanged: "Plugin {name} config unchanged; written back to the config file{ignored}{removed}";
+    readonly reactivateFailed: "Plugin {name} failed to reactivate with the new config and is now in the error state ({reason})";
+    readonly disabledNewConfig: "the plugin is disabled; it activates with the new config once enabled";
+    readonly configWritten: "the config was written to the config file{ignored}{removed}";
+    readonly configUpdated: "Plugin {name} config updated{ignored}{removed}";
+    readonly activateFailed: "Plugin {name} failed to activate and is now in the error state ({reason})";
+    readonly markedEnabled: "marked as enabled in the config file";
+    readonly enabled: "Plugin {name} enabled";
+    readonly disabledStuck: "Plugin {name} is disabled but has not stopped after the grace period; see the logs for details";
+    readonly markedDisabled: "marked as disabled in the config file";
+    readonly disabled: "Plugin {name} disabled";
+    readonly reloadDisabled: "Plugin {name} is disabled; enable it before reloading";
+    readonly reloadFailed: "Plugin {name} failed to reactivate and is now in the error state ({reason})";
+    readonly reloaded: "Plugin {name} reloaded";
+    readonly noPluginSource: "The host provides no plugin source, so plugins cannot be scanned";
+    readonly scanned: "{count, plural, =0 {No new plugins} one {Loaded # new plugin} other {Loaded # new plugins}}";
+    readonly suffixRequired: "suffix must be a non-empty string";
+    readonly suffixInvalid: "suffix may contain only letters, digits, underscores and hyphens";
+    readonly moduleMissing: "Cannot create the instance: module “{module}” not found";
+    readonly moduleNotReusable: "Cannot create the instance: module “{module}” does not declare reusable";
+    readonly instanceExists: "Cannot create the instance: “{instance}” already exists";
+    readonly instanceRefused: "Instance {instance} was not registered (shutting down or refused; see the logs); the config was not written";
+    readonly instanceFailed: "Created instance {instance}, but it failed to activate and is now in the error state ({reason})";
+    readonly instanceDisabled: "it is listed in disabledPlugins in the config file, so it was registered as disabled and activates once enabled";
+    readonly instanceCreated: "Created instance {instance}{ignored}";
+    readonly cannotDelete: "Cannot delete (the instance does not exist, or it is the main instance, which cannot be deleted)";
+    readonly deleteNotSaved: "Instance {instance} was not deleted: not written to the config file ({error})";
+    readonly unloadFailed: "Deleted instance {instance} from the config file, but unloading failed ({error}); it is no longer registered after a restart";
+    readonly deletedShuttingDown: "Deleted instance {instance} from the config file; shutting down, so the running instance was not unloaded";
+    readonly deleted: "Deleted instance {instance}";
+    readonly noAppDir: "The host provides no install directory (host-paths), so installed packages cannot be determined";
+    readonly noInstallSource: "Cannot determine the install registry ({error}); latest versions and updates are not shown for now";
+    readonly registryStatus: "npm registry returned {status}";
+    readonly searchOffline: "Cannot reach the npm registry ({error}); only locally installed plugins can be managed for now";
+    readonly packageNameInvalid: "name must be a valid npm package name";
+    readonly nameNotString: "The name field must be a string";
+    readonly removeConfigNotBoolean: "The removeConfig field must be a boolean";
+    readonly targetsRequired: "targets must be a non-empty array";
+    readonly noPackageManagerInstall: "No running plugin provides the package-manager service, so the market cannot install plugins: enable it in the plugin area, or run npm install <package> in the project directory and restart";
+    readonly noPackageManagerUninstall: "No running plugin provides the package-manager service, so the market cannot uninstall plugins: enable it in the plugin area, or run npm uninstall <package> in the project directory and restart";
+    readonly noPackageManagerUpdate: "No running plugin provides the package-manager service, so the market cannot update: enable it in the plugin area";
+    readonly urlRequired: "The url parameter is missing";
+    readonly upstreamStatus: "Upstream returned {status}";
+    readonly notImage: "Upstream did not return a displayable image";
+    readonly imageTooLarge: "Image too large ({size} > {max})";
+    readonly noUpstreamBody: "Upstream sent no response body";
+    readonly proxyFailed: "Proxy failed: {error}";
+    readonly invalidHandle: "Invalid file handle";
+    readonly fileGone: "The file is gone";
+    readonly readFailed: "Failed to read the file";
+    readonly notStorageUri: "Not a storage address";
+    readonly notMedia: "Only images, video and audio are served";
+    readonly fileMissing: "The file does not exist";
+    readonly noStorageLayout: "The storage service is absent, so layout records cannot be read or written";
+    readonly layoutReadFailed: "Failed to read the layout records";
+    readonly layoutOpInvalid: "The operation must be '{ op, page }' or '{ op, tab }': pin, unpin, move-up and move-down take page ('{ instance, pageKey }'); open-tab, close-tab, tab-up and tab-down take tab ('{ host }' or '{ instance, pageKey }'); remove-tab takes only a plugin tab ('{ instance, pageKey }'); host tabs can only be closed, not removed";
+    readonly pinPluginOnly: "Only pages placed in plugin details can be pinned";
+    readonly openSessionOnly: "Only session panel pages can be opened in the panel";
+    readonly layoutSaveFailed: "Failed to save the layout records; they are unchanged";
+    readonly pinnedFull: "At most {max} entries; unpin some first";
+    readonly tabsFull: "The session panel keeps at most {max} tabs";
+    readonly pageMissing: "Page {page} ({instance}) does not exist";
+    readonly extraParams: "Unexpected parameters: {keys, list}";
+    readonly nameRequired: "{name} must be a non-empty string";
+    readonly noSessionManager: "The session manager service is absent, so session panels are unavailable";
+    readonly archiveAbsent: "The message archive service is absent, so this message was not saved to the WebUI session history";
+    readonly sessionMissing: "Session {session} does not exist";
+    readonly inputNotObject: "input must be an object";
+    readonly inputExtraKeys: "Unexpected keys in input: {keys, list}";
+    readonly inputNotJsonString: "input must be a JSON string";
+    readonly inputBadJson: "input is not valid JSON";
+    readonly breach: "Data source {source} returned bad data: {problem}";
+    readonly notJson: "cannot be converted to JSON: {error}";
+    readonly notJsonValue: "cannot be converted to JSON";
+    readonly wantRows: "must return an array of rows";
+    readonly rowNotObject: "row {row} is not an object";
+    readonly rowKeyInvalid: "{key} in row {row} must be a unique non-empty string";
+    readonly rowFlagInvalid: "{key} in row {row} must be a boolean";
+    readonly rowUriInvalid: "{key} in row {row} must be a storage address";
+    readonly wantText: "must return a string or a text object";
+    readonly wantInfo: "must return an array of '{ label, value }'";
+    readonly wantGraph: "must return '{ nodes, edges }'";
+    readonly nodeInvalid: "nodes need a unique id and a label";
+    readonly edgeInvalid: "both ends of an edge must be node ids";
+    readonly noSource: "Page {page} has no data source {source}";
+    readonly noComponent: "Page {page} has no component {component}";
+    readonly noAction: "Page {page} has no action {action}";
+    readonly requestNotObject: "The request body must be an object";
+    readonly notASentence: "Action {action} did not return a sentence";
+};
+export default _default;
+//# sourceMappingURL=en.d.ts.map

package/dist/locales/en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/locales/en.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,wBAiNG"}

package/dist/locales/en.js

@@ -0,0 +1,191 @@
+import { defineLocale } from '@aalis/schema-i18n';
+export default defineLocale()({
+    displayName: 'WebUI server',
+    portLabel: 'Port',
+    portDescription: 'HTTP port of the web admin interface',
+    hostLabel: 'Listen address',
+    hostDescription: 'IP address to bind; 0.0.0.0 makes it reachable from other machines',
+    allowedHostsLabel: 'Host allowlist',
+    allowedHostsDescription: 'Host names in the browser address bar when the WebUI is reached through a reverse proxy or a domain name, without scheme or port. IP addresses, localhost and the listen address are always accepted; requests for any other host name get 421, which keeps out DNS rebinding pages',
+    badAllowedHost: '{entry} is not a host name: write only the host name, without a scheme, user name or path',
+    autoOpenLabel: 'Open the browser on startup',
+    autoOpenDescription: 'Opens the default browser the first time the app starts listening; reloading the plugin with the same token does not open it again, while a newly generated token opens it again so you can sign in. Turn this off over SSH or in headless environments',
+    tokenModeLabel: 'Token policy',
+    tokenEphemeral: 'Generate a random token at each start (rotates on restart)',
+    tokenPersist: 'Persist after the first generation (stays signed in across restarts)',
+    tokenFixed: 'Use the fixed token below',
+    tokenModeDescription: 'ephemeral = random at each start; persist = token written to data:/webui/token and reused; fixed = use the fixedToken field. Every mode writes the convenience file data:/webui/access.txt with the access URL.',
+    fixedTokenLabel: 'Fixed token (only with tokenMode=fixed)',
+    fixedTokenDescription: 'A random string of at least {min} characters (after trimming whitespace); a shorter one keeps the plugin from starting; empty means persist. Stored in secrets.yaml and never shown in the WebUI.',
+    registryLabel: 'Plugin market npm registry',
+    registryDescription: 'Base URL of the npm registry the plugin market searches. Not every mirror supports the npm search API (Taobao and other mainland mirrors do not), so the official registry is the default; in mainland China use a mirror or proxy that supports search. Installation goes through package-manager (following the local npm config), and the latest versions and updates on the cards are checked against the registry used for installing.',
+    registryInvalid: 'marketplaceRegistry is not a valid URL',
+    tokenTooShort: 'fixedToken needs at least {min} characters (currently {length})',
+    accessTitle: '# Aalis WebUI access credentials (generated)',
+    accessGenerated: '# Generated at: {time}',
+    accessMode: '# Token mode: {mode}',
+    accessLogin: 'One-click sign-in: {url}',
+    accessHint: '# Tip: paste the one-click sign-in link into a browser and the cookie is set for you',
+    pageLanguage: 'en',
+    loginTitle: 'Aalis WebUI sign-in',
+    loginHint: 'The access token is in state/webui/access.txt under the home directory; the startup log line “Access credentials written” gives its full path. With tokenMode set to fixed it is the config item fixedToken, whose value is stored in secrets.yaml under the home directory after startup (the config file holds a reference).',
+    tokenPlaceholder: 'Access token',
+    loginButton: 'Sign in',
+    tokenWrong: 'Incorrect token',
+    networkError: 'Network error',
+    urlTokenWrong: 'The token in the URL is incorrect; please enter it by hand.',
+    tooManyFailures: 'Too many failed sign-ins; try again in {minutes, plural, one {# minute} other {# minutes}}.',
+    crossOrigin: 'The request comes from a different origin than this service (behind a reverse proxy, the proxy must forward the original Host)',
+    hostNotAllowed: 'The host name of the request is not one this service accepts (when accessing through a reverse proxy or a domain name, add it to the Host allowlist in the WebUI server settings)',
+    ownerRequired: 'Owner permission required',
+    unauthenticated: 'Not signed in',
+    switchTitle: 'Switch frontend · Aalis',
+    switchHeading: 'Switch frontend',
+    switchIntro: 'This is the frontend recovery page of Aalis, served directly by webui-server and independent of the current frontend, so you can switch back here even when the current frontend has no switcher.',
+    switchLabel: 'Available frontends (webui-client)',
+    switchLoading: 'Loading…',
+    switchButton: 'Switch and reload',
+    switchBack: 'To switch back to the previous frontend, select it above and click “Switch and reload”.',
+    switchListFailed: 'Failed to read the service list (HTTP {status})',
+    switchNoClients: 'No frontend found (webui-client provider). Install an aalis.client package first.',
+    switchCurrent: '{name} (current)',
+    switching: 'Switching…',
+    switched: 'Switched; redirecting…',
+    switchOwnerHint: ' (owner permission required: open the WebUI with the one-click sign-in link and try again)',
+    switchFailed: 'Switch failed: {detail}{hint}',
+    switchError: 'Switch request failed: {error}',
+    unknownApi: 'Unknown API: {method} {path}',
+    noClient: 'The frontend is not ready: install a frontend package marked aalis.client',
+    serverError: 'Something went wrong handling this request; see the logs for the reason',
+    badRequest: 'The request is malformed',
+    bodyTooLarge: 'The request body is too large',
+    bodyNotJson: 'The request body must be a valid JSON object or array',
+    bodyEncoding: 'The charset or content encoding of the request body is not supported',
+    logFilterInvalid: 'Invalid log filter: level accepts only debug, info, warn and error, and each parameter may be given at most once',
+    noHostLogs: 'The host provides no log service (host-logs), so the logs cannot be read',
+    logBeforeRequired: 'Paging back through the logs needs the numeric parameter before (entries with a smaller seq)',
+    host: 'Host',
+    noProvider: 'Service {service} has no provider with id {id}',
+    noHostConfigPreference: 'The host provides no config document (host-config), so the preference cannot be saved',
+    contextIdRequired: 'The request body needs contextId: the id of the preferred provider',
+    refreshUnsupported: 'Provider {provider} does not support refreshing its model list at runtime (for example, model discovery is off)',
+    refreshNoModels: 'Provider {provider} has no registered models right now and cannot be refreshed',
+    dependencyInvalid: 'dependency must be an entry id <provider instance id>/<model id>',
+    allGroups: '* (all groups)',
+    ungroupedTools: 'Tools outside any group',
+    pluginMissing: 'Plugin {instance} does not exist',
+    refused: 'Plugin {instance} {action, select, config {can’t take config updates} enable {can’t be enabled} disable {can’t be disabled} other {can’t be reloaded}} right now (shutting down or being unloaded); the config was not changed',
+    noHostConfig: 'The host provides no config document (host-config), so the config cannot be read or written',
+    selfDisable: 'Plugin {name} provides this interface and cannot be disabled from it',
+    bodyNotObject: 'The request body must be an object',
+    foreignKeys: 'Only the core keys ({allowed, list}) can be changed; not accepted: {foreign, list}',
+    configNotSaved: 'Not written to the config file ({error}); this change was rolled back',
+    savedRestart: 'Global config saved; it takes effect after a restart',
+    saved: 'Global config updated and saved',
+    noApp: 'The app is unavailable',
+    restartFailed: 'Restart failed ({error}); the changes take effect at the next start',
+    restarting: 'Restarting the app',
+    configNotObject: 'The config field must be an object',
+    noPluginManager: 'The plugin manager service is unavailable',
+    configInvalid: 'Config validation failed: {issues}',
+    issue: '{path}: {reason}',
+    inputInvalid: 'Input failed validation: {issues}',
+    inputIssue: '{path}: {reason}',
+    stillActivating: 'still activating (past the slow-activation threshold, moved to the background); see the plugin list for the result',
+    waitingOld: 'waiting for the old instance of {instance} to stop',
+    notYetActive: 'not yet active; see the plugin list for the result',
+    notYetActiveBecause: 'not yet active: {why}',
+    seeLog: 'see the logs for details',
+    ignoredNote: ' (ignored undeclared config fields: {fields})',
+    removedNote: ' (removed undeclared fields from the config file: {fields})',
+    unchanged: 'Plugin {name} config unchanged; written back to the config file{ignored}{removed}',
+    reactivateFailed: 'Plugin {name} failed to reactivate with the new config and is now in the error state ({reason})',
+    disabledNewConfig: 'the plugin is disabled; it activates with the new config once enabled',
+    configWritten: 'the config was written to the config file{ignored}{removed}',
+    configUpdated: 'Plugin {name} config updated{ignored}{removed}',
+    activateFailed: 'Plugin {name} failed to activate and is now in the error state ({reason})',
+    markedEnabled: 'marked as enabled in the config file',
+    enabled: 'Plugin {name} enabled',
+    disabledStuck: 'Plugin {name} is disabled but has not stopped after the grace period; see the logs for details',
+    markedDisabled: 'marked as disabled in the config file',
+    disabled: 'Plugin {name} disabled',
+    reloadDisabled: 'Plugin {name} is disabled; enable it before reloading',
+    reloadFailed: 'Plugin {name} failed to reactivate and is now in the error state ({reason})',
+    reloaded: 'Plugin {name} reloaded',
+    noPluginSource: 'The host provides no plugin source, so plugins cannot be scanned',
+    scanned: '{count, plural, =0 {No new plugins} one {Loaded # new plugin} other {Loaded # new plugins}}',
+    suffixRequired: 'suffix must be a non-empty string',
+    suffixInvalid: 'suffix may contain only letters, digits, underscores and hyphens',
+    moduleMissing: 'Cannot create the instance: module “{module}” not found',
+    moduleNotReusable: 'Cannot create the instance: module “{module}” does not declare reusable',
+    instanceExists: 'Cannot create the instance: “{instance}” already exists',
+    instanceRefused: 'Instance {instance} was not registered (shutting down or refused; see the logs); the config was not written',
+    instanceFailed: 'Created instance {instance}, but it failed to activate and is now in the error state ({reason})',
+    instanceDisabled: 'it is listed in disabledPlugins in the config file, so it was registered as disabled and activates once enabled',
+    instanceCreated: 'Created instance {instance}{ignored}',
+    cannotDelete: 'Cannot delete (the instance does not exist, or it is the main instance, which cannot be deleted)',
+    deleteNotSaved: 'Instance {instance} was not deleted: not written to the config file ({error})',
+    unloadFailed: 'Deleted instance {instance} from the config file, but unloading failed ({error}); it is no longer registered after a restart',
+    deletedShuttingDown: 'Deleted instance {instance} from the config file; shutting down, so the running instance was not unloaded',
+    deleted: 'Deleted instance {instance}',
+    noAppDir: 'The host provides no install directory (host-paths), so installed packages cannot be determined',
+    noInstallSource: 'Cannot determine the install registry ({error}); latest versions and updates are not shown for now',
+    registryStatus: 'npm registry returned {status}',
+    searchOffline: 'Cannot reach the npm registry ({error}); only locally installed plugins can be managed for now',
+    packageNameInvalid: 'name must be a valid npm package name',
+    nameNotString: 'The name field must be a string',
+    removeConfigNotBoolean: 'The removeConfig field must be a boolean',
+    targetsRequired: 'targets must be a non-empty array',
+    noPackageManagerInstall: 'No running plugin provides the package-manager service, so the market cannot install plugins: enable it in the plugin area, or run npm install <package> in the project directory and restart',
+    noPackageManagerUninstall: 'No running plugin provides the package-manager service, so the market cannot uninstall plugins: enable it in the plugin area, or run npm uninstall <package> in the project directory and restart',
+    noPackageManagerUpdate: 'No running plugin provides the package-manager service, so the market cannot update: enable it in the plugin area',
+    urlRequired: 'The url parameter is missing',
+    upstreamStatus: 'Upstream returned {status}',
+    notImage: 'Upstream did not return a displayable image',
+    imageTooLarge: 'Image too large ({size} > {max})',
+    noUpstreamBody: 'Upstream sent no response body',
+    proxyFailed: 'Proxy failed: {error}',
+    invalidHandle: 'Invalid file handle',
+    fileGone: 'The file is gone',
+    readFailed: 'Failed to read the file',
+    notStorageUri: 'Not a storage address',
+    notMedia: 'Only images, video and audio are served',
+    fileMissing: 'The file does not exist',
+    noStorageLayout: 'The storage service is absent, so layout records cannot be read or written',
+    layoutReadFailed: 'Failed to read the layout records',
+    layoutOpInvalid: "The operation must be '{ op, page }' or '{ op, tab }': pin, unpin, move-up and move-down take page ('{ instance, pageKey }'); open-tab, close-tab, tab-up and tab-down take tab ('{ host }' or '{ instance, pageKey }'); remove-tab takes only a plugin tab ('{ instance, pageKey }'); host tabs can only be closed, not removed",
+    pinPluginOnly: 'Only pages placed in plugin details can be pinned',
+    openSessionOnly: 'Only session panel pages can be opened in the panel',
+    layoutSaveFailed: 'Failed to save the layout records; they are unchanged',
+    pinnedFull: 'At most {max} entries; unpin some first',
+    tabsFull: 'The session panel keeps at most {max} tabs',
+    pageMissing: 'Page {page} ({instance}) does not exist',
+    extraParams: 'Unexpected parameters: {keys, list}',
+    nameRequired: '{name} must be a non-empty string',
+    noSessionManager: 'The session manager service is absent, so session panels are unavailable',
+    archiveAbsent: 'The message archive service is absent, so this message was not saved to the WebUI session history',
+    sessionMissing: 'Session {session} does not exist',
+    inputNotObject: 'input must be an object',
+    inputExtraKeys: 'Unexpected keys in input: {keys, list}',
+    inputNotJsonString: 'input must be a JSON string',
+    inputBadJson: 'input is not valid JSON',
+    breach: 'Data source {source} returned bad data: {problem}',
+    notJson: 'cannot be converted to JSON: {error}',
+    notJsonValue: 'cannot be converted to JSON',
+    wantRows: 'must return an array of rows',
+    rowNotObject: 'row {row} is not an object',
+    rowKeyInvalid: '{key} in row {row} must be a unique non-empty string',
+    rowFlagInvalid: '{key} in row {row} must be a boolean',
+    rowUriInvalid: '{key} in row {row} must be a storage address',
+    wantText: 'must return a string or a text object',
+    wantInfo: "must return an array of '{ label, value }'",
+    wantGraph: "must return '{ nodes, edges }'",
+    nodeInvalid: 'nodes need a unique id and a label',
+    edgeInvalid: 'both ends of an edge must be node ids',
+    noSource: 'Page {page} has no data source {source}',
+    noComponent: 'Page {page} has no component {component}',
+    noAction: 'Page {page} has no action {action}',
+    requestNotObject: 'The request body must be an object',
+    notASentence: 'Action {action} did not return a sentence',
+});
+//# sourceMappingURL=en.js.map

package/dist/locales/en.js.map

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

package/dist/localize.d.ts

@@ -0,0 +1,24 @@
+import { type I18nService, type RenderOptions } from '@aalis/api-i18n';
+import type { Logger, ServiceSelection } from '@aalis/core';
+import type { Localized, LocalizeSkip } from '@aalis/schema-i18n';
+import type express from 'express';
+/** 交代这次回应的渲染选项：要跳过的原样数据、Markdown 正文的转义。在 res.json 之前调 */
+export declare function renderWith(res: express.Response, options: RenderOptions): void;
+/**
+ * schema（插件配置、核心配置、动作的输入字段）里的 default 是取值，不是文字：跳过它们，形如文字对象的默认值原样交出，表单读回
+ * 再保存时不被改写成字符串。字段、分组、数组与元素字段按对象身份认，不按键名（配置里可能有名叫 default 的字段）
+ */
+export declare function skipSchemaDefaults(schemas: Iterable<unknown>): LocalizeSkip;
+export interface Localizer {
+    /** 最早挂上：包住 res.json，渲染后再发 */
+    middleware: express.RequestHandler;
+    /** 把值里的文字对象按全局层的语言渲染 */
+    render<T>(value: T, options?: RenderOptions): Localized<T>;
+    /**
+     * 全局层的语言链（i18n 的 chainOf），/api/i18n/messages 与页面的 lang 用它。i18n 缺席时为空，取链出错时告警
+     * （与渲染共用一次）并为空
+     */
+    languages(): readonly string[];
+}
+export declare function createLocalizer(i18n: Pick<ServiceSelection<I18nService>, 'present' | 'use'>, logger: Logger): Localizer;
+//# sourceMappingURL=localize.d.ts.map

package/dist/localize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize.d.ts","sourceRoot":"","sources":["../src/localize.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,WAAW,EAAe,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAE9E;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,YAAY,CAa3E;AAED,MAAM,WAAW,SAAS;IACxB,6BAA6B;IAC7B,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC;IACnC,wBAAwB;IACxB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3D;;;OAGG;IACH,SAAS,IAAI,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,EAC5D,MAAM,EAAE,MAAM,GACb,SAAS,CA0BX"}

package/dist/localize.js

@@ -0,0 +1,68 @@
+// ============================================================
+// localize.ts — 回应里的文字按全局层的语言渲染
+//
+// WebUI 的读者是 owner 自己：一律按全局层的语言（i18n 的 { host: true } 读者），日期与时间按服务进程的时区，不看浏览器的
+// 语言与时区（会话与场所的语言设置管的是聊天平台上的读者）。
+// 最早挂的中间件包住 res.json：值里的文字对象渲染后再发，i18n 缺席或渲染抛错时按原文（抛错只告警一次）。路由里外的 JSON 回应
+// （认证的 401 与 403、闸门、未知 API、错误处理）都经过它；不经 res.json 的文字（纯文本的错误、登录页与恢复页、access.txt）
+// 用 render。原样数据（插件配置值、schema 的默认值、插件前端的数据）要跳过、Markdown 正文要转义时，路由在 res.json 之前经
+// renderWith 交代。
+// ============================================================
+import { localizeFor } from '@aalis/api-i18n';
+const optionsOf = new WeakMap();
+/** 交代这次回应的渲染选项：要跳过的原样数据、Markdown 正文的转义。在 res.json 之前调 */
+export function renderWith(res, options) {
+    optionsOf.set(res, options);
+}
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * schema（插件配置、核心配置、动作的输入字段）里的 default 是取值，不是文字：跳过它们，形如文字对象的默认值原样交出，表单读回
+ * 再保存时不被改写成字符串。字段、分组、数组与元素字段按对象身份认，不按键名（配置里可能有名叫 default 的字段）
+ */
+export function skipSchemaDefaults(schemas) {
+    const entries = new Set();
+    const collect = (schema) => {
+        if (!isRecord(schema))
+            return;
+        for (const entry of Object.values(schema)) {
+            if (!isRecord(entry) || entries.has(entry))
+                continue;
+            entries.add(entry);
+            collect(entry.fields);
+            collect(entry.items);
+        }
+    };
+    for (const schema of schemas)
+        collect(schema);
+    return (key, parent) => key === 'default' && entries.has(parent);
+}
+export function createLocalizer(i18n, logger) {
+    let warned = false;
+    const onError = (err) => {
+        if (warned)
+            return;
+        warned = true;
+        logger.warn('按全局层的语言渲染出错，按原文发出（之后再出错不再告警）:', err);
+    };
+    const render = (value, options) => localizeFor(i18n, value, { host: true }, { ...options, onError });
+    return {
+        middleware: (_req, res, next) => {
+            const send = res.json.bind(res);
+            res.json = body => send(render(body, optionsOf.get(res)));
+            next();
+        },
+        render,
+        languages: () => {
+            if (!i18n.present)
+                return [];
+            try {
+                return i18n.use.chainOf({ host: true });
+            }
+            catch (err) {
+                onError(err);
+                return [];
+            }
+        },
+    };
+}
+//# sourceMappingURL=localize.js.map

package/dist/localize.js.map

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

package/dist/logs.d.ts

@@ -0,0 +1,10 @@
+import type { LogFilter } from '@aalis/api-webui';
+import type { LogEntry } from '@aalis/core';
+/** 读出筛选：三项都只收字符串，级别要是四种之一，空字符串当没给；写法不对回 undefined */
+export declare function parseLogFilter(value: unknown): LogFilter | undefined;
+/**
+ * 按筛选判定日志的函数。registered 是此刻登记着的插件实例：按插件筛时用它分开后缀实例与子作用域；筛的那个实例本身
+ * 总认得，卸掉了的插件照样能按名字筛它留下的日志
+ */
+export declare function logMatcher(registered: (instance: string) => boolean): (filter: LogFilter) => (entry: LogEntry) => boolean;
+//# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,aAAa,CAAC;AAItD,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAQpE;AAeD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,IAC1D,QAAQ,SAAS,MAKf,OAAO,QAAQ,KAAG,OAAO,CAKpC"}

package/dist/logs.js

@@ -0,0 +1,50 @@
+// ============================================================
+// logs.ts — 日志的筛选
+//
+// 历史与实时都由宿主的 host-logs 服务给（@aalis/api-host-logs）。筛选（api-webui 的 LogFilter）在这里一处定，
+// 历史（/api/logs/*）与 /admin 的实时推送用同一个判定。
+// ============================================================
+const LEVELS = ['debug', 'info', 'warn', 'error'];
+/** 读出筛选：三项都只收字符串，级别要是四种之一，空字符串当没给；写法不对回 undefined */
+export function parseLogFilter(value) {
+    if (value === undefined)
+        return {};
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    const { level, plugin, text } = value;
+    const fields = { level, plugin, text };
+    if (Object.values(fields).some(field => field !== undefined && typeof field !== 'string'))
+        return undefined;
+    if (level && !LEVELS.includes(level))
+        return undefined;
+    return Object.fromEntries(Object.entries(fields).filter(([, field]) => field));
+}
+/**
+ * 一条日志所属的插件实例：作用域是根作用域、实例 id、插件自己分出的子作用域依次用「:」接起来（core 给每个激活的 logger
+ * 是根 logger 的 child）。后缀实例（name:suffix）与主实例的子作用域同形，取 known 认得的最长的那个
+ */
+function ownerOf(scope, known) {
+    const segments = scope.split(':').slice(1);
+    for (let n = segments.length; n > 0; n--) {
+        const instance = segments.slice(0, n).join(':');
+        if (known(instance))
+            return instance;
+    }
+    return undefined;
+}
+/**
+ * 按筛选判定日志的函数。registered 是此刻登记着的插件实例：按插件筛时用它分开后缀实例与子作用域；筛的那个实例本身
+ * 总认得，卸掉了的插件照样能按名字筛它留下的日志
+ */
+export function logMatcher(registered) {
+    return (filter) => {
+        const floor = filter.level === undefined ? 0 : LEVELS.indexOf(filter.level);
+        const text = filter.text?.toLowerCase();
+        const { plugin } = filter;
+        const known = (instance) => instance === plugin || registered(instance);
+        return (entry) => LEVELS.indexOf(entry.level) >= floor &&
+            (text === undefined || entry.message.toLowerCase().includes(text)) &&
+            (plugin === undefined || ownerOf(entry.scope, known) === plugin);
+    };
+}
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kBAAkB;AAClB,EAAE;AACF,kFAAkF;AAClF,uCAAuC;AACvC,+DAA+D;AAK/D,MAAM,MAAM,GAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvE,qDAAqD;AACrD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAgC,CAAC;IACjE,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5G,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAiB,CAAC;QAAE,OAAO,SAAS,CAAC;IACnE,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAc,CAAC;AAC9F,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,KAAa,EAAE,KAAoC;IAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;IACvC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,UAAyC;IAClE,OAAO,CAAC,MAAiB,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;QACxC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,MAAM,KAAK,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,QAAQ,KAAK,MAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC;QAChF,OAAO,CAAC,KAAe,EAAW,EAAE,CAClC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK;YACpC,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAClE,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC"}