@keyueclaw/web-sdk 0.1.84 → 0.1.85

package/dist/src/cron/types.d.ts

@@ -0,0 +1,142 @@
+import type { FailoverReason } from "../agents/pi-embedded-helpers.js";
+import type { ChannelId } from "../channels/plugins/types.js";
+import type { CronJobBase } from "./types-shared.js";
+export type CronSchedule = {
+    kind: "at";
+    at: string;
+} | {
+    kind: "every";
+    everyMs: number;
+    anchorMs?: number;
+} | {
+    kind: "cron";
+    expr: string;
+    tz?: string;
+    /** Optional deterministic stagger window in milliseconds (0 keeps exact schedule). */
+    staggerMs?: number;
+};
+export type CronSessionTarget = "main" | "isolated" | "current" | `session:${string}`;
+export type CronWakeMode = "next-heartbeat" | "now";
+export type CronMessageChannel = ChannelId | "last";
+export type CronDeliveryMode = "none" | "announce" | "webhook";
+export type CronDelivery = {
+    mode: CronDeliveryMode;
+    channel?: CronMessageChannel;
+    to?: string;
+    /** Explicit channel account id for multi-account setups (e.g. multiple Telegram bots). */
+    accountId?: string;
+    bestEffort?: boolean;
+    /** Separate destination for failure notifications. */
+    failureDestination?: CronFailureDestination;
+};
+export type CronFailureDestination = {
+    channel?: CronMessageChannel;
+    to?: string;
+    accountId?: string;
+    mode?: "announce" | "webhook";
+};
+export type CronDeliveryPatch = Partial<CronDelivery>;
+export type CronRunStatus = "ok" | "error" | "skipped";
+export type CronDeliveryStatus = "delivered" | "not-delivered" | "unknown" | "not-requested";
+export type CronUsageSummary = {
+    input_tokens?: number;
+    output_tokens?: number;
+    total_tokens?: number;
+    cache_read_tokens?: number;
+    cache_write_tokens?: number;
+};
+export type CronRunTelemetry = {
+    model?: string;
+    provider?: string;
+    usage?: CronUsageSummary;
+};
+export type CronRunOutcome = {
+    status: CronRunStatus;
+    error?: string;
+    /** Optional classifier for execution errors to guide fallback behavior. */
+    errorKind?: "delivery-target";
+    summary?: string;
+    sessionId?: string;
+    sessionKey?: string;
+};
+export type CronFailureAlert = {
+    after?: number;
+    channel?: CronMessageChannel;
+    to?: string;
+    cooldownMs?: number;
+    /** Delivery mode: announce (via messaging channels) or webhook (HTTP POST). */
+    mode?: "announce" | "webhook";
+    /** Account ID for multi-account channel configurations. */
+    accountId?: string;
+};
+export type CronPayload = {
+    kind: "systemEvent";
+    text: string;
+} | CronAgentTurnPayload;
+export type CronPayloadPatch = {
+    kind: "systemEvent";
+    text?: string;
+} | CronAgentTurnPayloadPatch;
+type CronAgentTurnPayloadFields = {
+    message: string;
+    /** Optional model override (provider/model or alias). */
+    model?: string;
+    /** Optional per-job fallback models; overrides agent/global fallbacks when defined. */
+    fallbacks?: string[];
+    thinking?: string;
+    timeoutSeconds?: number;
+    allowUnsafeExternalContent?: boolean;
+    /** If true, run with lightweight bootstrap context. */
+    lightContext?: boolean;
+    deliver?: boolean;
+    channel?: CronMessageChannel;
+    to?: string;
+    bestEffortDeliver?: boolean;
+};
+type CronAgentTurnPayload = {
+    kind: "agentTurn";
+} & CronAgentTurnPayloadFields;
+type CronAgentTurnPayloadPatch = {
+    kind: "agentTurn";
+} & Partial<CronAgentTurnPayloadFields>;
+export type CronJobState = {
+    nextRunAtMs?: number;
+    runningAtMs?: number;
+    lastRunAtMs?: number;
+    /** Preferred execution outcome field. */
+    lastRunStatus?: CronRunStatus;
+    /** Back-compat alias for lastRunStatus. */
+    lastStatus?: "ok" | "error" | "skipped";
+    lastError?: string;
+    /** Classified reason for the last error (when available). */
+    lastErrorReason?: FailoverReason;
+    lastDurationMs?: number;
+    /** Number of consecutive execution errors (reset on success). Used for backoff. */
+    consecutiveErrors?: number;
+    /** Last failure alert timestamp (ms since epoch) for cooldown gating. */
+    lastFailureAlertAtMs?: number;
+    /** Number of consecutive schedule computation errors. Auto-disables job after threshold. */
+    scheduleErrorCount?: number;
+    /** Explicit delivery outcome, separate from execution outcome. */
+    lastDeliveryStatus?: CronDeliveryStatus;
+    /** Delivery-specific error text when available. */
+    lastDeliveryError?: string;
+    /** Whether the last run's output was delivered to the target channel. */
+    lastDelivered?: boolean;
+};
+export type CronJob = CronJobBase<CronSchedule, CronSessionTarget, CronWakeMode, CronPayload, CronDelivery, CronFailureAlert | false> & {
+    state: CronJobState;
+};
+export type CronStoreFile = {
+    version: 1;
+    jobs: CronJob[];
+};
+export type CronJobCreate = Omit<CronJob, "id" | "createdAtMs" | "updatedAtMs" | "state"> & {
+    state?: Partial<CronJobState>;
+};
+export type CronJobPatch = Partial<Omit<CronJob, "id" | "createdAtMs" | "state" | "payload">> & {
+    payload?: CronPayloadPatch;
+    delivery?: CronDeliveryPatch;
+    state?: Partial<CronJobState>;
+};
+export {};

package/dist/src/cron/webhook-url.d.ts

@@ -0,0 +1 @@
+export declare function normalizeHttpWebhookUrl(value: unknown): string | null;

package/dist/src/daemon/arg-split.d.ts

@@ -0,0 +1,4 @@
+export type ArgSplitEscapeMode = "none" | "backslash" | "backslash-quote-only";
+export declare function splitArgsPreservingQuotes(value: string, options?: {
+    escapeMode?: ArgSplitEscapeMode;
+}): string[];

package/dist/src/daemon/cmd-argv.d.ts

@@ -0,0 +1,3 @@
+export declare function quoteCmdScriptArg(value: string): string;
+export declare function unescapeCmdScriptArg(value: string): string;
+export declare function parseCmdScriptCommandLine(value: string): string[];

package/dist/src/daemon/cmd-set.d.ts

@@ -0,0 +1,7 @@
+export type CmdSetAssignment = {
+    key: string;
+    value: string;
+};
+export declare function assertNoCmdLineBreak(value: string, field: string): void;
+export declare function parseCmdSetAssignment(line: string): CmdSetAssignment | null;
+export declare function renderCmdSetAssignment(key: string, value: string): string;

package/dist/src/daemon/constants.d.ts

@@ -0,0 +1,35 @@
+export declare const GATEWAY_LAUNCH_AGENT_LABEL = "ai.openclaw.gateway";
+export declare const GATEWAY_SYSTEMD_SERVICE_NAME = "openclaw-gateway";
+export declare const GATEWAY_WINDOWS_TASK_NAME = "OpenClaw Gateway";
+export declare const GATEWAY_SERVICE_MARKER = "openclaw";
+export declare const GATEWAY_SERVICE_KIND = "gateway";
+export declare const NODE_LAUNCH_AGENT_LABEL = "ai.openclaw.node";
+export declare const NODE_SYSTEMD_SERVICE_NAME = "openclaw-node";
+export declare const NODE_WINDOWS_TASK_NAME = "OpenClaw Node";
+export declare const NODE_SERVICE_MARKER = "openclaw";
+export declare const NODE_SERVICE_KIND = "node";
+export declare const NODE_WINDOWS_TASK_SCRIPT_NAME = "node.cmd";
+export declare const LEGACY_GATEWAY_LAUNCH_AGENT_LABELS: string[];
+export declare const LEGACY_GATEWAY_SYSTEMD_SERVICE_NAMES: string[];
+export declare const LEGACY_GATEWAY_WINDOWS_TASK_NAMES: string[];
+export declare function normalizeGatewayProfile(profile?: string): string | null;
+export declare function resolveGatewayProfileSuffix(profile?: string): string;
+export declare function resolveGatewayLaunchAgentLabel(profile?: string): string;
+export declare function resolveLegacyGatewayLaunchAgentLabels(profile?: string): string[];
+export declare function resolveGatewaySystemdServiceName(profile?: string): string;
+export declare function resolveGatewayWindowsTaskName(profile?: string): string;
+export declare function formatGatewayServiceDescription(params?: {
+    profile?: string;
+    version?: string;
+}): string;
+export declare function resolveGatewayServiceDescription(params: {
+    env: Record<string, string | undefined>;
+    environment?: Record<string, string | undefined>;
+    description?: string;
+}): string;
+export declare function resolveNodeLaunchAgentLabel(): string;
+export declare function resolveNodeSystemdServiceName(): string;
+export declare function resolveNodeWindowsTaskName(): string;
+export declare function formatNodeServiceDescription(params?: {
+    version?: string;
+}): string;

package/dist/src/daemon/runtime-binary.d.ts

@@ -0,0 +1,2 @@
+export declare function isNodeRuntime(execPath: string): boolean;
+export declare function isBunRuntime(execPath: string): boolean;

package/dist/src/elements/api-management-element.d.ts

@@ -0,0 +1,47 @@
+import { type ApiDefinition, type ApiDefinitionForm, type ApiDefinitionType } from "@ui/ui/controllers/api-definitions.ts";
+import { EmbeddedGatewayElementBase } from "../shared/embedded-gateway-element.ts";
+export declare class KeyueClawApiManagementElement extends EmbeddedGatewayElementBase {
+    serviceUrl: string;
+    sessionKey: string;
+    tab: "apiManagement";
+    toolStreamById: Map<string, unknown>;
+    toolStreamOrder: string[];
+    toolStreamSyncTimer: number | null;
+    chatToolMessages: unknown[];
+    chatStreamSegments: unknown[];
+    chatStream: string | null;
+    chatStreamStartedAt: number | null;
+    apiDefinitionsLoading: boolean;
+    apiDefinitionsSaving: boolean;
+    apiDefinitionsExporting: boolean;
+    apiDefinitionsImporting: boolean;
+    apiDefinitionsError: string | null;
+    apiDefinitionsSaveAttempted: boolean;
+    apiDefinitionsItems: ApiDefinition[];
+    apiDefinitionsPath: string | null;
+    apiDefinitionsQuery: string;
+    apiDefinitionsHash: string | null;
+    apiDefinitionsMode: "list" | "edit";
+    apiDefinitionsEditingId: string | null;
+    apiDefinitionsForm: ApiDefinitionForm;
+    apiDefinitionsToast: string | null;
+    apiDefinitionsToastKind: "success" | "error";
+    apiDefinitionsDeleteConfirmItem: ApiDefinition | null;
+    apiDefinitionsSelectedIds: string[];
+    apiDefinitionsDeleteConfirmItems: ApiDefinition[] | null;
+    apiDefinitionsType: ApiDefinitionType;
+    apiDefinitionsPage: number;
+    apiDefinitionsPageSize: number;
+    apiDefinitionsTotal: number;
+    protected startEmbeddedGatewayConnection(): void;
+    protected handleEmbeddedGatewayUpdates(changed: Map<PropertyKey, unknown>): void;
+    render(): import("lit").TemplateResult<1>;
+    private renderDeleteConfirm;
+    private renderDeleteSelectedConfirm;
+    private renderToast;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "keyueclaw-api-management": KeyueClawApiManagementElement;
+    }
+}

package/dist/src/elements/chat-element.d.ts

@@ -0,0 +1,134 @@
+import { handleSendChat } from "@ui/ui/app-chat.ts";
+import { type CompactionStatus, type FallbackStatus } from "@ui/ui/app-tool-stream.ts";
+import type { AppViewState } from "@ui/ui/app-view-state.ts";
+import type { DevicePairingList } from "@ui/ui/controllers/devices.ts";
+import type { ExecApprovalRequest } from "@ui/ui/controllers/exec-approval.ts";
+import type { Tab } from "@ui/ui/navigation.ts";
+import type { UiSettings } from "@ui/ui/storage.ts";
+import type { AgentsListResult, ChatModelOverride, ModelCatalogEntry, SessionsListResult, SkillStatusReport } from "@ui/ui/types.ts";
+import type { ChatAttachment, ChatQueueItem, ChatRouteSkill } from "@ui/ui/ui-types.ts";
+import { EmbeddedGatewayElementBase } from "../shared/embedded-gateway-element.ts";
+export declare class KeyueClawChatElement extends EmbeddedGatewayElementBase implements AppViewState {
+    private i18nController;
+    phone: string;
+    serviceUrl: string;
+    tenantId: string;
+    tenantName: string;
+    botId: string;
+    password: string;
+    loginShowGatewayToken: boolean;
+    loginShowGatewayPassword: boolean;
+    tab: Tab;
+    onboarding: boolean;
+    private toolStreamSyncTimer;
+    private sidebarCloseTimer;
+    applySessionKey: string;
+    logsAtBottom: boolean;
+    userPhone: string | null;
+    sessionKey: string;
+    phoneInput: string;
+    phoneError: string | null;
+    chatLoading: boolean;
+    chatSending: boolean;
+    chatMessage: string;
+    chatRouteSkills: ChatRouteSkill[];
+    chatRouteSkillCatalog: ChatRouteSkill[];
+    chatMessages: unknown[];
+    chatToolMessages: unknown[];
+    chatStreamSegments: Array<{
+        text: string;
+        ts: number;
+    }>;
+    chatStream: string | null;
+    chatStreamStartedAt: number | null;
+    chatRunId: string | null;
+    compactionStatus: CompactionStatus | null;
+    fallbackStatus: FallbackStatus | null;
+    chatAvatarUrl: string | null;
+    chatThinkingLevel: string | null;
+    chatModelOverrides: Record<string, ChatModelOverride | null>;
+    chatModelsLoading: boolean;
+    chatModelCatalog: ModelCatalogEntry[];
+    chatQueue: ChatQueueItem[];
+    chatAttachments: ChatAttachment[];
+    chatManualRefreshInFlight: boolean;
+    navDrawerOpen: boolean;
+    keyueSelectedTenantId: string | null;
+    keyueSelectedBotId: string | null;
+    keyueActivePhone: string | null;
+    keyueInitLoading: boolean;
+    keyueInitError: string | null;
+    sidebarOpen: boolean;
+    sidebarContent: string | null;
+    sidebarError: string | null;
+    splitRatio: number;
+    sessionsResult: SessionsListResult | null;
+    attentionItems: unknown[];
+    skillsReport: SkillStatusReport | null;
+    presenceEntries: unknown[];
+    agentsList: AgentsListResult | null;
+    agentsSelectedId: string | null;
+    agentsPanel: "overview" | "files" | "tools" | "skills" | "channels" | "cron";
+    devicesList: DevicePairingList | null;
+    execApprovalQueue: ExecApprovalRequest[];
+    execApprovalBusy: boolean;
+    execApprovalError: string | null;
+    cronJobs: unknown[];
+    cronStatus: unknown;
+    overviewLogLines: string[];
+    overviewLogCursor: number;
+    paletteOpen: boolean;
+    paletteQuery: string;
+    paletteActiveIndex: number;
+    chatNewMessagesBelow: boolean;
+    private chatScrollFrame;
+    private chatScrollTimeout;
+    chatHasAutoScrolled: boolean;
+    private chatUserNearBottom;
+    private nodesPollInterval;
+    private logsPollInterval;
+    private debugPollInterval;
+    private logsScrollFrame;
+    private toolStreamById;
+    private toolStreamOrder;
+    private topbarObserver;
+    private popStateHandler;
+    onSlashAction?: (action: string) => void;
+    assistantName: string;
+    assistantAvatar: string | null;
+    assistantAgentId: string | null;
+    protected beforeGatewayConnectSetup(): void;
+    protected shouldReconnectOnPropChange(): boolean;
+    protected startEmbeddedGatewayConnection(): void;
+    protected afterGatewayConnected(): void;
+    protected updated(changed: Map<PropertyKey, unknown>): void;
+    connect(): void;
+    private resolveEffectiveUserPhone;
+    private ensureKeyueWorkspace;
+    private loadRouteSkillCatalog;
+    private startAfterKeyueWorkspaceReady;
+    private syncPhoneState;
+    submitPhone(phone: string): void;
+    logout(): void;
+    applySettings(next: UiSettings): void;
+    setTab(_next: Tab): void;
+    loadAssistantIdentity(): Promise<void>;
+    handleAbortChat(): Promise<void>;
+    removeQueuedMessage(id: string): void;
+    handleSendChat(messageOverride?: string, opts?: Parameters<typeof handleSendChat>[2]): Promise<void>;
+    resetToolStream(): void;
+    resetChatScroll(): void;
+    handleChatScroll(event: Event): void;
+    scrollToBottom(opts?: {
+        smooth?: boolean;
+    }): void;
+    handleOpenSidebar(content: string): void;
+    handleCloseSidebar(): void;
+    handleSplitRatioChange(ratio: number): void;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "keyueclaw-chat": KeyueClawChatElement;
+    }
+}

package/dist/src/elements/chat-render.d.ts

@@ -0,0 +1,2 @@
+import type { AppViewState } from "@ui/ui/app-view-state.ts";
+export declare function renderEmbedChat(state: AppViewState): import("lit").TemplateResult<1>;

package/dist/src/elements/skills-element.d.ts

@@ -0,0 +1,195 @@
+import { type KeyueBot, type KeyueBotSkillBindingDetail, type KeyueDialogMode, type KeyueFileMap, type KeyuePublishTask, type KeyueSkill, type KeyueTenant } from "@ui/keyueclaw/shared/actions.ts";
+import type { ApiDefinition, ApiDefinitionForm } from "@ui/ui/controllers/api-definitions.ts";
+import { type TeamSkillEntry } from "@ui/ui/controllers/skills.ts";
+import { type SkillAiReferenceToken } from "@ui/ui/skills-props-factory.ts";
+import type { SkillStatusReport } from "@ui/ui/types.ts";
+import { EmbeddedGatewayElementBase } from "../shared/embedded-gateway-element.ts";
+export declare class KeyueClawSkillsElement extends EmbeddedGatewayElementBase {
+    serviceUrl: string;
+    tenantId: string;
+    tenantName: string;
+    botId: string;
+    private _sessionKey;
+    get sessionKey(): string;
+    set sessionKey(_value: string);
+    tab: "skills";
+    toolStreamById: Map<string, unknown>;
+    toolStreamOrder: string[];
+    toolStreamSyncTimer: number | null;
+    chatToolMessages: unknown[];
+    chatStreamSegments: unknown[];
+    applySessionKey: string;
+    skillsLoading: boolean;
+    skillsReport: SkillStatusReport | null;
+    skillsError: string | null;
+    skillsFilter: string;
+    skillsViewMode: "card" | "list";
+    skillEdits: Record<string, string>;
+    skillsBusyKey: string | null;
+    skillMessages: Record<string, import("@ui/ui/controllers/skills.ts").SkillMessage>;
+    skillsTab: "personal" | "team";
+    skillMenuOpenKey: string | null;
+    teamSkillsLoading: boolean;
+    teamSkillsReport: TeamSkillEntry[] | null;
+    teamSkillsError: string | null;
+    teamSkillsSyncBusyKey: string | null;
+    teamSkillsSyncedKeys: string[];
+    teamOrganizationId: string | null;
+    teamApiToken: string | null;
+    skillFilesLists: Record<string, import("@ui/ui/controllers/skill-files.ts").SkillFilesListResult>;
+    skillFilesContents: Record<string, string>;
+    skillFilesDrafts: Record<string, string>;
+    skillFilesActiveKey: string | null;
+    skillFilesActiveName: string | null;
+    skillFilesActiveDir: string | null;
+    skillFilesLoading: boolean;
+    skillFilesSaving: boolean;
+    skillFilesError: string | null;
+    skillFilesFullscreen: boolean;
+    skillFilesBackConfirm: boolean;
+    skillFileTreeExpandedByKey: Record<string, string[]>;
+    skillFileTreeMenuFolder: string | null;
+    skillFileTreeInlineMode: "createFolder" | "createFile" | "renameFolder" | null;
+    skillFileTreeInlineFolder: string | null;
+    skillFileTreeInlineValue: string;
+    skillRefComponentsLoading: boolean;
+    skillRefComponentsMap: Record<string, {
+        name: string;
+        status: 0 | 1;
+    } | "deleted">;
+    componentPickerItems: import("@ui/keyueclaw/shared/types.ts").KeyueComponent[];
+    componentPickerLoading: boolean;
+    componentPickerTenantId: string | null;
+    skillVersionHistoryByKey: Record<string, import("@ui/keyueclaw/shared/types.ts").KeyuePlatformSkillVersion[]>;
+    skillVersionHistoryLoading: boolean;
+    skillVersionPublishDialogKey: string | null;
+    skillVersionPublishBy: string;
+    skillVersionPublishNote: string;
+    skillVersionPublishBusy: boolean;
+    skillPlatformPublishDialogKey: string | null;
+    skillPlatformPublishVersion: string;
+    skillPlatformPublishBy: string;
+    skillPlatformPublishNote: string;
+    skillPlatformPublishBusy: boolean;
+    skillCreateMode: boolean;
+    skillCreateName: string;
+    skillCreateDesc: string;
+    skillCreateBusy: boolean;
+    skillCreateError: string | null;
+    skillAiDialogOpen: boolean;
+    skillAiFormName: string;
+    skillAiFormDesc: string;
+    skillAiFormTrigger: string;
+    skillAiFormInstruction: string;
+    skillAiFormExample: string;
+    skillAiInstructionReferences: SkillAiReferenceToken[];
+    skillAiDialogFullscreenField: null | "desc" | "trigger" | "instruction" | "example";
+    skillAiFormError: string | null;
+    skillAiBuilderMode: boolean;
+    skillAiBuilderSkillKey: string | null;
+    skillAiBuilderSkillId: string | null;
+    skillAiBuilderSkillName: string | null;
+    skillAiBuilderBuilding: boolean;
+    skillAiBuilderActiveTab: string;
+    skillAiBuilderOpenTabs: string[];
+    skillAiChatMessages: unknown[];
+    skillAiChatStream: string | null;
+    skillAiChatSending: boolean;
+    skillAiChatRunId: string | null;
+    skillAiChatMessage: string;
+    skillAiChatReferences: SkillAiReferenceToken[];
+    skillAiReferenceMode: "hidden" | "apis" | "params";
+    skillAiReferenceTargetField: "chat" | "instruction";
+    skillAiReferenceActiveApiId: string | null;
+    skillAiReferenceSelectedIndex: number;
+    skillAiReferenceMatchFrom: number | null;
+    skillAiReferenceMatchTo: number | null;
+    skillAiReferenceQuery: string;
+    skillAiChatStreamStartedAt: number | null;
+    skillAiToolCalls: Array<{
+        toolCallId: string;
+        name: string;
+        phase: "pending" | "done";
+    }>;
+    skillAiBuilderExitConfirm: boolean;
+    skillUploadBusy: boolean;
+    skillUploadError: string | null;
+    skillUploadOverwriteKey: string | null;
+    skillUploadPendingFile: File | null;
+    skillDeleteConfirmKey: string | null;
+    skillExportBusyKey: string | null;
+    apiDefinitionsItems: ApiDefinition[];
+    apiDefinitionsPath: string | null;
+    apiDefinitionsLoading: boolean;
+    apiDefinitionsSaving: boolean;
+    apiDefinitionsExporting: boolean;
+    apiDefinitionsImporting: boolean;
+    apiDefinitionsError: string | null;
+    apiDefinitionsHash: string | null;
+    apiDefinitionsMode: "list" | "edit";
+    apiDefinitionsEditingId: string | null;
+    apiDefinitionsForm: ApiDefinitionForm;
+    apiDefinitionsType: import("@ui/ui/controllers/api-definitions.ts").ApiDefinitionType;
+    apiDefinitionsPage: number;
+    apiDefinitionsPageSize: number;
+    apiDefinitionsSaveAttempted: boolean;
+    apiDefinitionsDeleteConfirmItem: ApiDefinition | null;
+    apiDefinitionsSelectedIds: string[];
+    apiDefinitionsDeleteConfirmItems: ApiDefinition[] | null;
+    apiDefinitionsToast: string | null;
+    apiDefinitionsToastKind: "error" | "success";
+    apiDefinitionsQuery: string;
+    keyueLoading: boolean;
+    keyueLoaded: boolean;
+    keyueSaving: boolean;
+    keyueError: string | null;
+    keyueDialogMode: KeyueDialogMode;
+    keyueTenants: KeyueTenant[];
+    keyueSelectedTenantId: string | null;
+    keyueTenantName: string;
+    keyueTenantDescription: string;
+    keyueTenantType: number;
+    keyueTenantPanel: "bots" | "skills";
+    keyueBots: KeyueBot[];
+    keyueSelectedBotId: string | null;
+    keyueBotName: string;
+    keyueBotDescription: string;
+    keyueBotPanel: "detail" | "json-config";
+    keyueBotFiles: KeyueFileMap;
+    keyueBotFileDrafts: KeyueFileMap;
+    keyueBotFileActive: string;
+    keyueBotSkillBindings: KeyueBotSkillBindingDetail[];
+    keyueBotBindingVersionDrafts: Record<string, string>;
+    keyuePublishBy: string;
+    keyuePublishDescription: string;
+    keyuePublishTask: KeyuePublishTask | null;
+    keyueBotSkills: string[];
+    keyueSkills: KeyueSkill[];
+    keyueSkillName: string;
+    keyueSkillDescription: string;
+    keyueSkillContent: string;
+    keyueUploadBusy: boolean;
+    keyueUploadError: string | null;
+    keyuePhoneInput: string;
+    keyueActivePhone: string | null;
+    keyueInitLoading: boolean;
+    keyueInitError: string | null;
+    keyueInitReady: boolean;
+    navigateKeyueRoute: () => void;
+    private tenantSkillsLoadKey;
+    private tenantSkillsLoadPromise;
+    connectedCallback(): void;
+    protected afterGatewayConnected(): void;
+    protected updated(changed: Map<PropertyKey, unknown>): void;
+    private loadTenantSkills;
+    private loadTenantSkillsForKey;
+    private syncTenant;
+    private ensureKeyueBot;
+    render(): import("lit").TemplateResult<1>;
+    private _renderToast;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "keyueclaw-skills": KeyueClawSkillsElement;
+    }
+}

package/dist/src/gateway/auth-mode-policy.d.ts

@@ -0,0 +1,4 @@
+import type { OpenClawConfig } from "../config/config.js";
+export declare const EXPLICIT_GATEWAY_AUTH_MODE_REQUIRED_ERROR = "Invalid config: gateway.auth.token and gateway.auth.password are both configured, but gateway.auth.mode is unset. Set gateway.auth.mode to token or password.";
+export declare function hasAmbiguousGatewayAuthModeConfig(cfg: OpenClawConfig): boolean;
+export declare function assertExplicitGatewayAuthModeWhenBothConfigured(cfg: OpenClawConfig): void;

package/dist/src/gateway/auth-rate-limit.d.ts

@@ -0,0 +1,67 @@
+/**
+ * In-memory sliding-window rate limiter for gateway authentication attempts.
+ *
+ * Tracks failed auth attempts by {scope, clientIp}. A scope lets callers keep
+ * independent counters for different credential classes (for example, shared
+ * gateway token/password vs device-token auth) while still sharing one
+ * limiter instance.
+ *
+ * Design decisions:
+ * - Pure in-memory Map – no external dependencies; suitable for a single
+ *   gateway process.  The Map is periodically pruned to avoid unbounded
+ *   growth.
+ * - Loopback addresses (127.0.0.1 / ::1) are exempt by default so that local
+ *   CLI sessions are never locked out.
+ * - The module is side-effect-free: callers create an instance via
+ *   {@link createAuthRateLimiter} and pass it where needed.
+ */
+export interface RateLimitConfig {
+    /** Maximum failed attempts before blocking.  @default 10 */
+    maxAttempts?: number;
+    /** Sliding window duration in milliseconds.     @default 60_000 (1 min) */
+    windowMs?: number;
+    /** Lockout duration in milliseconds after the limit is exceeded.  @default 300_000 (5 min) */
+    lockoutMs?: number;
+    /** Exempt loopback (localhost) addresses from rate limiting.  @default true */
+    exemptLoopback?: boolean;
+    /** Background prune interval in milliseconds; set <= 0 to disable auto-prune.  @default 60_000 */
+    pruneIntervalMs?: number;
+}
+export declare const AUTH_RATE_LIMIT_SCOPE_DEFAULT = "default";
+export declare const AUTH_RATE_LIMIT_SCOPE_SHARED_SECRET = "shared-secret";
+export declare const AUTH_RATE_LIMIT_SCOPE_DEVICE_TOKEN = "device-token";
+export declare const AUTH_RATE_LIMIT_SCOPE_HOOK_AUTH = "hook-auth";
+export interface RateLimitEntry {
+    /** Timestamps (epoch ms) of recent failed attempts inside the window. */
+    attempts: number[];
+    /** If set, requests from this IP are blocked until this epoch-ms instant. */
+    lockedUntil?: number;
+}
+export interface RateLimitCheckResult {
+    /** Whether the request is allowed to proceed. */
+    allowed: boolean;
+    /** Number of remaining attempts before the limit is reached. */
+    remaining: number;
+    /** Milliseconds until the lockout expires (0 when not locked). */
+    retryAfterMs: number;
+}
+export interface AuthRateLimiter {
+    /** Check whether `ip` is currently allowed to attempt authentication. */
+    check(ip: string | undefined, scope?: string): RateLimitCheckResult;
+    /** Record a failed authentication attempt for `ip`. */
+    recordFailure(ip: string | undefined, scope?: string): void;
+    /** Reset the rate-limit state for `ip` (e.g. after a successful login). */
+    reset(ip: string | undefined, scope?: string): void;
+    /** Return the current number of tracked IPs (useful for diagnostics). */
+    size(): number;
+    /** Remove expired entries and release memory. */
+    prune(): void;
+    /** Dispose the limiter and cancel periodic cleanup timers. */
+    dispose(): void;
+}
+/**
+ * Canonicalize client IPs used for auth throttling so all call sites
+ * share one representation (including IPv4-mapped IPv6 forms).
+ */
+export declare function normalizeRateLimitClientIp(ip: string | undefined): string;
+export declare function createAuthRateLimiter(config?: RateLimitConfig): AuthRateLimiter;