@a1hvdy/cc-openclaw 0.27.6 → 0.27.8

package/dist/src/channels/telegram-mirror/commands.d.ts

@@ -103,6 +103,19 @@ export declare function handleStatus(ctx: CommandContext): CommandResult;
 export declare function handleCompact(ctx: CommandContext): CommandResult;
 export declare function handleCost(ctx: CommandContext): CommandResult;
 export declare function handleRewind(ctx: CommandContext): CommandResult;
+/**
+ * v0.27.7 — /clear claims the command so it stops leaking to the LLM as plain
+ * text (the bug: before this, /clear wasn't in COMMAND_HANDLERS, so the inbound
+ * router forwarded it verbatim to Claude instead of handling it).
+ *
+ * It does NOT fake an in-place context reset. The running session's lifecycle +
+ * resume linkage live in the command-router (activeSessions, meta.claudeSessionId)
+ * and the engine — not this bookkeeping registry — so a pure mirror handler has
+ * no honest lever to wipe context (the same D-6 constraint behind /compact and
+ * /rewind being CLI-only). So /clear points to the paths that actually work: a
+ * fresh session via /new <slug>, or an in-place wipe via /clear in the CLI.
+ */
+export declare function handleClear(ctx: CommandContext): CommandResult;
 /**
  * Open a compose session for the chat. M7 — drafts append until /send.
  * Returns a force_reply prompt so Telegram nudges the user into reply mode.

package/dist/src/channels/telegram-mirror/commands.js

@@ -231,6 +231,30 @@ export function handleRewind(ctx) {
         ],
     };
 }
+// ── /clear ───────────────────────────────────────────────────────────────
+/**
+ * v0.27.7 — /clear claims the command so it stops leaking to the LLM as plain
+ * text (the bug: before this, /clear wasn't in COMMAND_HANDLERS, so the inbound
+ * router forwarded it verbatim to Claude instead of handling it).
+ *
+ * It does NOT fake an in-place context reset. The running session's lifecycle +
+ * resume linkage live in the command-router (activeSessions, meta.claudeSessionId)
+ * and the engine — not this bookkeeping registry — so a pure mirror handler has
+ * no honest lever to wipe context (the same D-6 constraint behind /compact and
+ * /rewind being CLI-only). So /clear points to the paths that actually work: a
+ * fresh session via /new <slug>, or an in-place wipe via /clear in the CLI.
+ */
+export function handleClear(ctx) {
+    return {
+        actions: [
+            {
+                type: 'sendMessage',
+                chat_id: ctx.chatId,
+                text: "⚠️ /clear can't reset a running session from Telegram (no session-control primitive — same as /compact and /rewind). For a fresh start use <b>/new &lt;slug&gt;</b>; for an in-place context wipe run <b>/clear</b> in the Claude Code CLI.",
+            },
+        ],
+    };
+}
 // ── /compose ─────────────────────────────────────────────────────────────
 /**
  * Open a compose session for the chat. M7 — drafts append until /send.
@@ -372,6 +396,7 @@ export const ALL_COMMANDS = [
     { command: 'cost', description: 'Show Max 20x usage + weekly burn' },
     { command: 'compact', description: 'Compact context (CLI-only — see note)' },
     { command: 'rewind', description: 'Rewind a session (CLI-only — see note)' },
+    { command: 'clear', description: 'Fresh start — /new <slug> (in-place reset is CLI-only)' },
     { command: 'compose', description: 'Start a multi-message draft — finish with /send' },
     { command: 'send', description: 'Send the composed draft to Claude' },
     { command: 'cancel', description: 'Cancel the active compose draft' },
@@ -398,6 +423,7 @@ export const COMMAND_HANDLERS = {
     compact: handleCompact,
     cost: handleCost,
     rewind: handleRewind,
+    clear: handleClear,
     compose: handleCompose,
     send: handleSend,
     cancel: handleCancel,

package/dist/src/channels/telegram-mirror/index.js

@@ -17,8 +17,10 @@
  * Risks monitored: R-7 (parallel maintenance burden — re-evaluate at soak start).
  */
 import { defaultRegisterGuard } from '../../lib/register-guard.js';
-import { initBotTokenFromConfig } from '../../lib/telegram-bot-api.js';
+import { initBotTokenFromConfig, telegramApi } from '../../lib/telegram-bot-api.js';
 import { registerInboundHandler } from './inbound-handler.js';
+import { syncMyCommands } from './sync-commands.js';
+import { TOP_7_COMMANDS } from './commands.js';
 /**
  * Mirror channel register — idempotent via defaultRegisterGuard.
  *
@@ -82,6 +84,59 @@ export function register(api) {
                     ? fullApi.enqueueNextTurnInjection.bind(api)
                     : undefined,
             });
+            // v0.27.7 — wire the command-menu sync. It was DEAD CODE (defined in
+            // sync-commands.ts but never called from boot), so cc-openclaw's native
+            // commands never reached Telegram's command menu — only OpenClaw's
+            // nativeSkills auto-sync did, which is why /stop /new /status were
+            // invisible in the menu. We MERGE (getMyCommands → union) so the sync
+            // AUGMENTS the menu instead of clobbering the skill commands, and DELAY
+            // it so it lands after OpenClaw's own boot sync (tunable via
+            // CC_OPENCLAW_CMD_SYNC_DELAY_MS; default 8s). Gated out of the test
+            // runner — register() fires repeatedly in unit tests and must not make
+            // real Telegram network calls (eager-work-at-register safety, mirrors
+            // OPENCLAW_PLUGIN_TEST_MODE rationale).
+            const isTestRunner = process.env.VITEST !== undefined ||
+                process.env.NODE_ENV === 'test' ||
+                process.env.OPENCLAW_PLUGIN_TEST_MODE === '1';
+            if (!isTestRunner) {
+                // Boot re-assert series: OpenClaw's nativeSkills auto-sync runs LATE at
+                // boot and full-replaces the menu with skill-only commands, so a single
+                // early sync loses the ordering race. Re-assert at a few boot offsets;
+                // each call re-merges (getMyCommands → union(native, skills)) and
+                // converges once OpenClaw's one-shot clobber has landed (verified: it
+                // clobbers once, not continuously). An env override forces a single
+                // custom delay (testing / tuning).
+                const envDelay = Number(process.env.CC_OPENCLAW_CMD_SYNC_DELAY_MS);
+                const delays = Number.isFinite(envDelay) && envDelay > 0 ? [envDelay] : [10_000, 60_000, 150_000];
+                const runCmdSync = () => {
+                    void syncMyCommands({
+                        force: true,
+                        setMyCommands: (payload) => telegramApi('setMyCommands', { commands: payload.commands }),
+                        getMyCommands: async () => {
+                            const res = await telegramApi('getMyCommands', {});
+                            const result = res.result;
+                            return { commands: result ?? [] };
+                        },
+                        nativeCommands: [
+                            ...TOP_7_COMMANDS,
+                            {
+                                command: 'clear',
+                                description: 'Fresh start — /new <slug> (in-place reset is CLI-only)',
+                            },
+                        ],
+                        logger: {
+                            info: (msg) => process.stderr.write(`${msg}\n`),
+                            warn: (msg) => process.stderr.write(`${msg}\n`),
+                        },
+                    }).catch((err) => process.stderr.write(`[cc-openclaw/telegram-mirror] command-menu sync failed: ${err instanceof Error ? err.message : String(err)}\n`));
+                };
+                for (const d of delays) {
+                    const timer = setTimeout(runCmdSync, d);
+                    // Don't keep the event loop alive solely for these timers.
+                    if (typeof timer.unref === 'function')
+                        timer.unref();
+                }
+            }
             process.stderr.write('[cc-openclaw/telegram-mirror] guard body completed (v0.25.2).\n');
         }
         catch (err) {

package/dist/src/channels/telegram-mirror/sync-commands.d.ts

@@ -39,6 +39,42 @@ export interface SyncOptions {
      * Tests pass the G-3 mock; production wires a fetch-based caller.
      */
     setMyCommands: (payload: SetMyCommandsPayload) => Promise<unknown>;
+    /**
+     * v0.27.7 — optional getMyCommands dispatcher. When supplied, the CURRENTLY
+     * registered commands (e.g. OpenClaw's nativeSkills auto-synced /search,
+     * /plan, …) are fetched and MERGED with the native list so the sync augments
+     * the Telegram menu instead of replacing it. setMyCommands is a full-replace
+     * API, so without this merge a native-only sync would wipe the skill
+     * commands (and vice-versa — which is the bug that left native commands
+     * invisible: the dead sync never ran, and OpenClaw's skill-sync owned the
+     * menu alone). Omit it for the legacy native-only replace.
+     */
+    getMyCommands?: () => Promise<{
+        commands?: ReadonlyArray<{
+            command: string;
+            description: string;
+        }>;
+    }>;
+    /**
+     * v0.27.7 — native command set to advertise. Defaults to TOP_7_COMMANDS so
+     * the legacy callers (and the M5 boot-only test) keep the exact top-7 list.
+     * The boot wiring passes top-7 + /clear so the menu reflects the full native
+     * surface.
+     */
+    nativeCommands?: ReadonlyArray<{
+        command: string;
+        description: string;
+    }>;
+    /**
+     * v0.27.8 — bypass the boot-once idempotency guard. The boot wiring fires a
+     * short re-assert series (10s/60s/150s) because OpenClaw's nativeSkills
+     * auto-sync runs LATE at boot and full-replaces the menu with skill-only
+     * commands; a single early sync loses the ordering race. Each forced call
+     * re-merges (getMyCommands → union) so it converges on the full menu once
+     * OpenClaw's one-shot clobber has landed. ADR-009's "no per-session re-sync"
+     * still holds — this is boot-scoped retry, not per-message.
+     */
+    force?: boolean;
     logger?: SyncLogger;
 }
 export interface SyncResult {

package/dist/src/channels/telegram-mirror/sync-commands.js

@@ -24,11 +24,28 @@ let synced = false;
  * catches it and emits the warn log so register() never blocks on it.
  */
 export async function syncMyCommands(opts) {
-    if (synced) {
+    if (synced && !opts.force) {
         return { alreadySynced: true, commandCount: 0 };
     }
     synced = true;
-    const payload = { commands: TOP_7_COMMANDS.slice() };
+    const native = opts.nativeCommands ?? TOP_7_COMMANDS;
+    let commands = native.map((c) => ({ ...c }));
+    // v0.27.7 — merge in existing (skill) commands so the sync augments rather
+    // than replaces the menu. Native wins on a name collision. If the fetch
+    // fails, fall back to native-only (never wipe the menu on a transient error).
+    if (opts.getMyCommands) {
+        try {
+            const existing = await opts.getMyCommands();
+            const nativeNames = new Set(native.map((c) => c.command));
+            const preserved = (existing?.commands ?? []).filter((c) => !nativeNames.has(c.command));
+            commands = [...commands, ...preserved.map((c) => ({ ...c }))];
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            opts.logger?.warn(`[cc-openclaw/telegram-mirror] getMyCommands failed — syncing native-only: ${msg}`);
+        }
+    }
+    const payload = { commands };
     try {
         await opts.setMyCommands(payload);
         opts.logger?.info(`[cc-openclaw/telegram-mirror] setMyCommands synced — ${payload.commands.length} commands.`);

package/dist/src/lib/config.d.ts

@@ -45,11 +45,6 @@ export declare function getPerfCacheTelemetryEnabled(): boolean;
  * confirms the perf win (plan: "default ON for safe ideas once measured-good").
  */
 export declare function getPerfKeepaliveEnabled(): boolean;
-/**
- * M3 (perf overhaul idea #3) — tiered edit cadence. Default OFF; opt-in via
- * CC_OPENCLAW_PERF_EDIT_CADENCE=1.
- */
-export declare function getPerfEditCadenceEnabled(): boolean;
 /** M9 (perf overhaul idea #9) — speculative thinking bubble. Default OFF. */
 export declare function getPerfSpecBubbleEnabled(): boolean;
 /** M4 — skill-list-on-demand. Default OFF. */
@@ -64,8 +59,6 @@ export declare function getPerfHaikuRouteEnabled(): boolean;
 export declare function getPerfAsyncCompactEnabled(): boolean;
 /** M7 — Read([paths]) batching. Default OFF (medium risk). */
 export declare function getPerfReadBatchEnabled(): boolean;
-/** M1 — resident CLI pool. Default OFF (medium risk). */
-export declare function getPerfResidentCliEnabled(): boolean;
 /** M12 — direct claude-code SDK in-process. Default OFF (HIGH RISK, hard-gated). */
 export declare function getPerfDirectSdkEnabled(): boolean;
 export declare function getMaxConcurrentSessions(): number;
@@ -106,7 +99,6 @@ export declare function isTokenTelemetryWriterEnabled(): boolean;
 /** Strict opt-in — register-guard event logging via OPENCLAW_REGISTER_DEBUG=1. */
 export declare function isRegisterDebugEnabled(): boolean;
 export declare function isHeartbeatWorkaroundDisabled(): boolean;
-export declare function getQuotaPausePct(): number;
 /**
  * Raw value for `isToolsPerMessageModeEnabled()` parsing.
  * NOT delegated — the consumer parses the raw string itself; the typed
@@ -116,9 +108,7 @@ export declare function getOpenaiCompatToolsPerMessage(): string | undefined;
 /** Strict opt-in — legacy new-conversation heuristic via env=1. */
 export declare function isOpenaiCompatNewConvoHeuristic(): boolean;
 export declare function getOpenaiCompatStatusUrl(): string | undefined;
-export declare function getUxBridgeAllSessions(): string | undefined;
 export declare function getAnthropicBaseUrlEnv(): string | undefined;
-export declare function isSavvyLiveCardEnabled(): boolean;
 export declare function getHomeOrTmp(): string;
 export declare function getHealthPortEnv(): string | undefined;
 export declare function isDriftAlertsEnabled(): boolean;

package/dist/src/lib/config.js

@@ -119,16 +119,6 @@ export function getPerfKeepaliveEnabled() {
         return cfg.config.perfKeepaliveEnabled;
     return process.env.CC_OPENCLAW_PERF_KEEPALIVE === '1';
 }
-/**
- * M3 (perf overhaul idea #3) — tiered edit cadence. Default OFF; opt-in via
- * CC_OPENCLAW_PERF_EDIT_CADENCE=1.
- */
-export function getPerfEditCadenceEnabled() {
-    const cfg = getConfigService();
-    if (cfg)
-        return cfg.config.perfEditCadenceEnabled;
-    return process.env.CC_OPENCLAW_PERF_EDIT_CADENCE === '1';
-}
 /** M9 (perf overhaul idea #9) — speculative thinking bubble. Default OFF. */
 export function getPerfSpecBubbleEnabled() {
     const cfg = getConfigService();
@@ -178,13 +168,6 @@ export function getPerfReadBatchEnabled() {
         return cfg.config.perfReadBatchEnabled;
     return process.env.CC_OPENCLAW_PERF_READ_BATCH === '1';
 }
-/** M1 — resident CLI pool. Default OFF (medium risk). */
-export function getPerfResidentCliEnabled() {
-    const cfg = getConfigService();
-    if (cfg)
-        return cfg.config.perfResidentCliEnabled;
-    return process.env.CC_OPENCLAW_PERF_RESIDENT_CLI === '1';
-}
 /** M12 — direct claude-code SDK in-process. Default OFF (HIGH RISK, hard-gated). */
 export function getPerfDirectSdkEnabled() {
     const cfg = getConfigService();
@@ -386,15 +369,6 @@ export function isHeartbeatWorkaroundDisabled() {
         return cfg.config.heartbeatWorkaroundDisabled;
     return process.env.CC_OPENCLAW_DISABLE_HEARTBEAT_WORKAROUND === '1';
 }
-// ── Telegram quota auto-pause (src/channels/telegram/live-card.ts) ───────
-// Returns parsed percent threshold (0-100). Default 95.
-export function getQuotaPausePct() {
-    const cfg = getConfigService();
-    if (cfg)
-        return cfg.config.quotaPausePct;
-    const n = Number(process.env.OPENCLAW_QUOTA_PAUSE_PCT);
-    return Number.isFinite(n) ? n : 95;
-}
 // ── OpenAI-compat shim (src/openai-compat/openai-compat.ts) ──────────────
 /**
  * Raw value for `isToolsPerMessageModeEnabled()` parsing.
@@ -419,16 +393,6 @@ export function getOpenaiCompatStatusUrl() {
     const v = process.env.OPENAI_COMPAT_STATUS_URL;
     return v === undefined || v === '' ? undefined : v;
 }
-// ── UX bridge sessions read-only check (src/channels/telegram/event-reducer.ts) ──
-// Read-only counterpart to `ensureUxBridgeAllSessionsDefault()` — used in
-// hot-path event handlers where the value is treated as a truthy gate.
-//
-// NOT in RuntimeConfig — its peer `ensureUxBridgeAllSessionsDefault` mutates
-// env, so both must read live env to stay coherent.
-export function getUxBridgeAllSessions() {
-    const v = process.env.UX_BRIDGE_ALL_SESSIONS;
-    return v === undefined || v === '' ? undefined : v;
-}
 // ── Anthropic base URL (src/proxy/handler.ts layer 1) ────────────────────
 // proxy/handler.ts owns the higher-level resolver
 // (env → openclaw.json → default); this getter only exposes the raw env.
@@ -439,14 +403,6 @@ export function getAnthropicBaseUrlEnv() {
     const v = process.env.ANTHROPIC_BASE_URL;
     return v === undefined || v === '' ? undefined : v;
 }
-// ── Savvy live card gate (src/channels/telegram/tool-tracker.ts) ─────────
-export function isSavvyLiveCardEnabled() {
-    const cfg = getConfigService();
-    if (cfg)
-        return cfg.config.savvyLiveCardEnabled;
-    const v = process.env.SAVVY_LIVE_CARD;
-    return !!(v && v !== '');
-}
 // ── Council transcript dir base (src/council/council.ts) ─────────────────
 // Preserves bit-for-bit the original `process.env.HOME || '/tmp'` fallback.
 // Note: differs from os.homedir() which never returns '/tmp' as fallback.

package/dist/src/types.d.ts

@@ -1,10 +1,8 @@
 /**
  * Shared types for openclaw-claude-code plugin
  */
-import type { ModelPricing, ProviderName, ModelDef } from './models.js';
-export type { ModelPricing, ProviderName, ModelDef };
-export { getModelPricing, overrideModelPricing, _resetPricingOverrides, getModelList, resolveAlias, resolveEngineAndModel, resolveProvider, getContextWindow, isGeminiModel, isClaudeModel, estimateTokens, lookupModelStrict, getAliases, } from './models.js';
-export declare const MODEL_ALIASES: Record<string, string>;
+import type { ModelPricing } from './models.js';
+export { getModelPricing, overrideModelPricing } from './models.js';
 export type PermissionMode = 'acceptEdits' | 'bypassPermissions' | 'default' | 'delegate' | 'dontAsk' | 'plan' | 'auto';
 export type EffortLevel = 'low' | 'medium' | 'high' | 'max' | 'auto';
 export type EngineType = 'claude' | 'codex' | 'gemini' | 'cursor' | 'custom';

package/dist/src/types.js

@@ -1,7 +1,4 @@
 /**
  * Shared types for openclaw-claude-code plugin
  */
-import { getAliases } from './models.js';
-export { getModelPricing, overrideModelPricing, _resetPricingOverrides, getModelList, resolveAlias, resolveEngineAndModel, resolveProvider, getContextWindow, isGeminiModel, isClaudeModel, estimateTokens, lookupModelStrict, getAliases, } from './models.js';
-// Backward compat: MODEL_ALIASES as a static object
-export const MODEL_ALIASES = getAliases();
+export { getModelPricing, overrideModelPricing } from './models.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a1hvdy/cc-openclaw",
-  "version": "0.27.6",
+  "version": "0.27.8",
   "description": "A1xAI's Anthropic CLI bridge plugin for OpenClaw",
   "author": "@a1cy",
   "license": "MIT",